内容
# 史诗牧场演示农场
<!-- 社交预览 -->
<picture>
<source media="(prefers-color-scheme: dark)" srcset=".github/social-preview-dark.svg">
<source media="(prefers-color-scheme: light)" srcset=".github/social-preview.svg">
<img alt="史诗牧场演示农场 — 绿色田野中的快乐农场动物" src=".github/social-preview.svg" width="100%">
</picture>
[](LICENSE)
[](https://github.com/zircote/nsip-example/issues)
[](https://nsip.org)
[](https://github.com/zircote/nsip-example/actions)
[](https://savory.global/eov/)
欢迎来到史诗牧场农场仓库 — 您的数字畜牧场，记录所有农场信息。
此仓库执行三个功能：
1. **组织农场记录** 到易于浏览的文件夹（作物，牲畜，设备，合规性，EOV）
2. **跟踪绵羊繁殖** 通过 [国家绵羊改进计划（NSIP）](https://nsip.org) 遗传数据库支持的记录保存系统
3. **监测生态健康** 使用 [Savory Institute 的生态结果验证（EOV）](https://savory.global/eov/) 框架，跟踪土地是否再生
当您创建繁殖记录（交配，产仔，健康，断奶）时，系统会自动查找动物的遗传信息，并添加有用的信息，如生长潜力，近亲繁殖风险和特征比较。 当您创建生态监测记录（现场评估，土壤样本，水测试）时，它会将您的观察结果与以前的访问进行比较，并跟踪随时间变化的趋势。
---
## 快速链接
| 章节 | 您将找到的内容 |
|---------|-----------------|
| [作物](./crops/) | 种植计划，作物轮作，土壤测试 |
| [牲畜](./livestock/) | 健康记录，喂养计划，兽医日志 |
| [设备](./equipment/) | 维护日志，安全检查，库存 |
| [合规性](./compliance/) | 资助跟踪，认证 |
| [EOV](./eov/) | 生态监测计划，现场地图，基线数据，结果目标 |
### 指南
| 指南 | 描述 |
|-------|-------------|
| [用户指南](./docs/USER-GUIDE.md) | 从这里开始 — 如何使用此系统（为非技术用户编写） |
| [运行手册](./docs/runbooks/) | 常见任务的逐步说明 |
| [繁殖事件日志](./docs/BREEDING-EVENT-LOG.md) | NSIP 繁殖记录系统的工作原理 |
### 创建记录
点击上面的 **问题** 标签，然后点击 **新问题** 以创建记录。 可用表单：
- **交配记录** — 记录繁殖配对（自动检查近亲繁殖风险）
- **产仔记录** — 记录出生事件
- **健康记录** — 记录健康观察或治疗
- **断奶记录** — 记录断奶体重
- **羊群行动** — 请求自动羊群分析（比较，排名，交配建议）
- **EOV 现场评估** — 在监测现场评分生态健康指标
- **EOV 土壤样本** — 记录土壤实验室结果
- **EOV 水测试** — 记录水渗透测试
- **EOV 照片点** — 记录照片监测点
- **EOV 行动** — 请求自动生态分析（季节性总结，现场比较，趋势报告，注册准备）
- **作物问题报告** — 报告田间问题
- **设备维护** — 报告设备问题
---
## 工作原理
<picture>
<img alt="史诗牧场工作原理 — 创建记录，获取自动遗传丰富，搜索历史记录" src=".github/readme-infographic.svg" width="100%">
</picture>
---
## 自动化
此仓库使用 [GitHub Actions](https://github.com/zircote/nsip-example/actions) 工作流程和 [NSIP MCP 服务器](https://github.com/zircote/nsip) 来自动化农场运营。
### 工作流程
| 工作流程 | 触发器 | 它执行的操作 |
|----------|---------|--------------|
| **羊群行动** | 问题开启并带有 `flock-action` 标签 | 自动分配 [Copilot 编码代理](https://docs.github.com/en/copilot) 运行请求的羊群分析并生成报告 |
| **每周农场提醒** | 每个星期一 UTC 时间 8:00 AM | 创建一个包含设备，牲畜，作物和行政任务的检查清单问题 |
| **Copilot 设置** | 手动（按需） | 安装 `nsip` CLI 二进制文件并拉取 Copilot 代理环境的 NSIP Docker 镜像 |
| **EOV 丰富** | 问题开启并带有 `record:eov-*` 或 `eov-action` 标签 | 自动分配 Copilot 以丰富具有趋势分析的生态记录 |
| **EOV 季节提醒** | 每季度（3 月 1 日，6 月 1 日，9 月 1 日，12 月 1 日） | 创建一个包含所有站点和季节特定提示的监测检查清单问题 |
| **Dependabot 自动合并** | Dependabot PR 开启 | 在 CI 通过后自动批准和合并依赖项更新 PR |
### NSIP MCP 服务器
`.mcp.json` 文件配置了一个基于 Docker 的 [MCP](https://modelcontextprotocol.io) 服务器，该服务器连接到国家绵羊改进计划数据库（400,000+ 绵羊）。 当创建繁殖记录问题时，Copilot 代理调用 NSIP 工具来丰富记录遗传数据：
| 工具 | 目的 |
|------|---------|
| `search` | 按名称，ID 或羊群查找动物 |
| `details` / `profile` | 检索单个动物 EBV 和索引 |
| `lineage` / `progeny` | 家谱和后代查找 |
| `compare` / `rank` | 并排比较或加权排名 |
| `inbreeding_check` | 计算配对的近亲繁殖系数 |
| `mating_recommendations` | 为给定母羊找到最佳种公羊 |
| `trait_ranges` / `flock_summary` | 品种百分位和综合羊群统计 |
请参阅 [`.github/instructions/nsip-mcp.instructions.md`](.github/instructions/nsip-mcp.instructions.md) 以获取完整的工具参考。
---
## 生态结果验证（EOV）
该农场使用 [Savory Institute 的 EOV 框架](https://savory.global/eov/) 跟踪生态健康 — 一个基于结果的监测协议，已在全球超过 600 万英亩土地上使用。 EOV 不仅仅跟踪您所做的事情（实践），还测量土地上实际发生的事情（结果）。
### 我们监测的内容
| 组件 | 方法 | 频率 |
|-----------|--------|-----------|
| **15 个生态健康指标** | 12 个监测站点的视觉评估 | 季节性（每年 4 次） |
| **土壤健康** | 实验室分析（Haney/CASH 测试）3 个站点 | 每 3-5 年 |
| **水渗透** | 3 个站点的现场环形测试 | 每 3-5 年 |
| **照片点** | 所有站点的重复摄影 | 季节性（每年 4 次） |
15 个指标涵盖植物群落健康（树冠覆盖，物种组成，草类，杂草），生物活性（活体生物，粪便分解，凋落物分解）和土壤稳定性（裸地，覆盖，风/水侵蚀）。
### 工作原理
1. **行走监测站点** 并创建 **EOV 现场评估** 问题 — 评分您看到的内容
2. 系统 **将分数转换为数字** 并计算生态健康指数（EHI）
3. **跟踪趋势** — 系统将每次访问与以前的访问进行比较，并标记变化
4. 请求 **季节总结** 或 **年度趋势报告** 以查看大局
请参阅 [eov/monitoring-plan.md](./eov/monitoring-plan.md) 以获取完整的监测计划和 [eov/site-map.md](./eov/site-map.md) 以获取站点位置。
### 了解更多关于 EOV 的信息
- [Savory Institute — EOV 概述](https://savory.global/eov/)
- [EOV 手册（公开）](https://savory-institute.gitbook.io/eov-manual-public)
- [土地到市场计划](https://www.landtomarket.com/eov)
- [Savory Institute](https://savory.global/)
---
## 关于这座农场
史诗牧场是位于弗吉尼亚州 Farmville 的一片 45 英亩的农场。 我们养殖 Katahdin 毛羊，鸡，鸭和火鸡，并季节性地出售市场园艺产品和鸡蛋。
**联系方式：** hello@epicpastures.com
---
*这是 [GitHub4Farms](https://github.com) 培训的演示仓库。 所有数据均为虚构。*
