# @defra/lis-species-cattle 中文文档 规范地址：https://npmcn.com/package/%40defra/lis-species-cattle/ 版本：0\.10\.7 npm 元数据更新时间：2026-11-10T10:05:00.848Z 中文译文更新时间：2026-11-11T21:13:11.600Z 软件包许可：OGL-UK-3\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40defra/lis-species-cattle 原文对照：https://npmcn.com/package/%40defra/lis-species-cattle/?lang=original 项目主页：https://github.com/DEFRA/lis-species-cattle#readme 源码仓库：https://github.com/DEFRA/lis-species-cattle ## 关键信息（来自 npm 元数据） - 包体积（解压后）：14.1 kB，4 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24 - 运行依赖：0 个 - 首次发布：2026-08-06T13:51:34.523Z - 最新版本发布：2026-11-10T10:04:59.958Z - 近 30 天下载量：5658（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：35（近 12 个月 35 个） ## 中文简介 牲畜分类流动共享套餐. ## 安装 ```sh npm install @defra/lis-species-cattle ``` 也可以使用：`pnpm add @defra/lis-species-cattle`、`yarn add @defra/lis-species-cattle`、`bun add @defra/lis-species-cattle` ## README # 丽斯-物种-牲畜 畜牧信息服务(LIS)的一部分,它允许牲畜饲养者、所有者、代理商和牲畜饲养者使用 代表们记录和管理他们的动物. `@defra/lis-species-cattle` 是一个共享 npm 包, 持有牛种定义 牛的微站点:物种特征和牛的品种和品种代码列表. 这是一个物种包。 分类学套件( E)`lis-taxonomy-*`例如家、搬家、搬家 (d) 说明旅行的作用。 这个包裹说它是为了哪个物种 一头牛 微站点将两者结合起来,例如从 `taxonomy.id` 财务报告和审定财务报表 `species.id`编辑 软件包不导入任何分类软件包。 哥哥们 [丽丝-羊](https://github.com/DEFRA/lis-species-sheep) 套件对绵羊遵循相同的模式. 用于: - 发言: [丽丝-苹果-牛-家](https://github.com/DEFRA/lis-apps-cattle-home), (中文(简体) ), [lis -apps - crattle - register (英语)](https://github.com/DEFRA/lis-apps-cattle-register), (中文(简体) ), [百花齐放](https://github.com/DEFRA/lis-apps-cattle-move), (中文(简体) ), [鼠类动物死亡](https://github.com/DEFRA/lis-apps-cattle-death) - 假服务 : [假服务](https://github.com/DEFRA/lis-fake-service) (企业代码验证和品种名称) ## 安装 ```bash npm install @defra/lis-species-cattle ``` 软件包没有对等依赖性 . ## 使用量 包裹有一个入口, `@defra/lis-species-cattle`它输出四样东西. ### `species` 该物种的特征: `{ id: 'cattle', label: 'Cattle', summary: '...' }`启用 `species.id` 改为 构建微站路径. ```js import { species } from '@defra/lis-species-cattle' export const ROOT_PATH = buildMicrositePath(taxonomy.id, species.id) ``` ### `breeds` 牛品种犬目列表 以大案品种代码为关键对象. 举个例子 `breeds.AA` 实值 `'Aberdeen Angus'`. 十字军有自己的代码,例如: `AAX` 实值 `'Aberdeen Angus Cross'`。 。 。 . ```js import { breeds } from '@defra/lis-species-cattle' const items = Object.entries(breeds).map(([value, text]) => ({ value, text })) ``` ### `getBreedName(code)` 返回品种代码的品种名称 。 代码是忽略大小写。 回返 `undefined` 用于 未知代码 . ```js import { getBreedName } from '@defra/lis-species-cattle' getBreedName('aa') // 'Aberdeen Angus' getBreedName('nope') // undefined ``` ### `getBreedCode(name)` 返回品种名称的品种代码。 名字是小写小写和小写, 卷曲或缺失)被忽略. 回返 `undefined` 一个未知的名字. ```js import { getBreedCode } from '@defra/lis-species-cattle' getBreedCode('aberdeen angus') // 'AA' getBreedCode("Blonde D'Aquitaine") // 'BA' ``` ## 先决条件 - 节点.js 24(见 `.nvmrc`,使用时 `nvm use`(中文(简体) ) - 对照一个消费的应用程序检查更改: [净值](https://github.com/DEFRA/lis-dev) 一次性设置完成 ## 设置 ### 发展 ```bash nvm use npm install ``` ### 测试 无法安装工具 `npm install`测试 [维特](https://vitest.dev/)。 。 。 . ## 正在发展中 这是一个库,所以它没有自己的服务器. 尝试改变一个消费应用 没有 发布, 将本地副本链接到 lis- dev 堆栈 : ```bash cd lis-dev .bin/sideload link species/cattle # every installed copy now points at this repo .bin/sideload up cattle-home # optional: run a consumer locally with hot reload .bin/sideload unlink species/cattle # when done ``` ## 正在测试 ```bash npm test # unit tests npm run test:coverage # with coverage npm run lint # ESLint npm run format:check # Prettier ``` 在释放出一个变化之前,还要对连接包进行每个消耗回波的测试. ## 管道 GitHub 动作中运行的构建、版本和出版(`.github/workflows`)使用蛋糕脚本(`*.cake`: - **将请求拉到 `main`**: 校验(格式、林特、测试),声纳分析,版本检查 - **推到一个 `feature/` 或者说 `hotfix/` 分支**: 预发版本和标签 - **合并到 `main`**: 释放标签,然后发布到 [无](https://www.npmjs.com/package/@defra/lis-species-cattle) 版本来自git标签 (SemVer). 合并后, 等待出版工作完成后, 才将套件撞入消耗回购中 . ### 本地运行建筑 蛋糕是建造引擎并管弦乐节点包生命周期. 运行默认构建 (安装、审计、格式、插图、测试和包)当地: ```bash dotnet cake ./build.cake --target=Default --package_version=0.1.0 ``` ### 本地测试 GitHub 动作工作流程 安装 [`act`](https://github.com/nektos/act) (例如 `brew install act`),然后运行: ```bash act -W .github/workflows/prerelease.yml ``` ## 分支政策 Repo采用干线开发. 分行从 `main` 并命名分支: - `feature/LREG--` - `hotfix/LREG--` `LREG` 必须是大写,因为 GitHub 规则拒绝其他分支名称。 重置为 `main` 而不是合并 `main` 进去. ## 协助这一项目 - 跟着 [Defra软件开发标准](https://github.com/DEFRA/software-development-standards)。 。 。 . - `npm install` 设置一个承诺前钩子(Husky),运行安全审计,格式检查和lint. - 打开拉动请求 `main` 使用 PR 模板。 CI必须通过而声纳质量门在合并前必须是绿色. ## 许可证 本资料系根据下列公开政府规定公布: [http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3 互联网档案馆的存檔,存档日期2013-12-21](http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3) 在使用此信息时, 您的产品和应用程序中引用以下的归属声明 MUST . > 载有根据开放政府许可证颁发的公共部门信息v3 ### 关于许可证 开放政府许可证(OGL)由陛下文具办公室(HMSO)的主计长制定,使公共部门的信息提供者能够根据共同开放许可证许可其信息的使用和再使用. 它旨在鼓励自由和灵活地使用和再使用信息,仅附带一些条件. ## 常见问题 ### @defra/lis-species-cattle 是什么？ 牲畜分类流动共享套餐\. ### 如何安装 @defra/lis-species-cattle？ 在项目目录运行 npm install @defra/lis-species-cattle，或使用 pnpm add / yarn add / bun add。 ### @defra/lis-species-cattle 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/defra\_\_lis-species-cattle 是否存在。 ### @defra/lis-species-cattle 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @defra/lis-species-cattle 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @defra/lis-species-cattle 可以商用吗？ @defra/lis-species-cattle 使用 OGL-UK-3\.0 许可。声明的许可为 OGL-UK-3\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @defra/lis-species-cattle 的下载量有多少？ 根据 npm 官方下载统计，@defra/lis-species-cattle 在 2026/10/12 – 2026/11/10 这 30 天内被下载 5,658 次，日均约 189 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @defra/lis-species-cattle 还在维护吗？ 最新版本 0\.10\.7 发布于 2026/11/10（1 天前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/08/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。