# 设计提案与 PRD

> 仍在评估中的 OINK PRD 与设计草案的唯一双语归档位置。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

> [!WARNING] 非规范性材料
> 提案描述的行为可能尚不存在。当前行为由契约、已接受决策、实现与归属检查器定义。不能把提案
> 当作配置参考。

本栏目是 OINK 产品需求文档、RFC 风格设计与未决维护者提案的唯一正本位置。不要在主题仓库或
文档仓库中另建本地 `plan/`、`plans/`、`proposal/` 或其它并行设计树。

## 当前提案 {#active-proposals}

| 提案                                                             | 当前边界                                                               |
| ---------------------------------------------------------------- | ---------------------------------------------------------------------- |
| [反向链接与知识图谱](/zh/docs/design/proposals/knowledge-graph/) | 草案；当前没有 graph 或 backlink 实现                                  |
| [媒体收敛](/zh/docs/design/proposals/media-convergence/)         | 草案；共享正文 resolver 与 Zoom marker 已落地，只记录剩余跨表面收敛    |
| [Agent 批量索引](/zh/docs/design/proposals/agent-indexes/)       | 草案；每页 Markdown 与 `llms.txt` 已存在，全文合集与导航 JSON 尚不存在 |

## 新 PRD 放在哪里 {#where-a-new-prd-goes}

创建一份英文主页面及其简体中文对页：

```text
content/docs/design/proposals/<slug>.md
content/docs/design/proposals/<slug>.zh.md
```

两份文件都使用显式、稳定的英文标题 ID。中文页面中的代码、键、路径、版本与 API 名称保持原样。
提案开头要有可见的草案状态，并包含：

1. 状态、负责人、日期和受影响契约面；
2. 背景与证据；
3. 目标与明确非目标；
4. 提议行为，以及输出、无障碍、安全边界；
5. 兼容与迁移影响；
6. 实现与归属检查器计划；
7. 验收标准与待决问题；
8. 记录提案自身变化的决策日志。

大型实验可以在 [`../research/`](/zh/docs/design/research/) 下增加带日期的页面；临时日志与生成
产物不进入 Hugo 内容，也不进入 Git。

## 生命周期 {#lifecycle}

```text
草案提案
    ├── 拒绝或被替代 → 从活动树移除，由 Git 历史保存
    └── 接受
          ├── 实现与归属检查器
          ├── 受影响的中英文契约
          ├── 理由具有长期价值时新增已接受 Design 决策
          └── 相关受众需要时更新变更记录、迁移与用户文档
```

提案被接受后不会自动成为第二份契约。稳定行为进入归属契约，稳定理由进入 Decisions，用户步骤进入
相关指南，然后把提案退出活动导航。本地构建、提交、tag、公开模块、消费站 pin 与部署仍是相互独立
的完成状态。

## 评审门禁 {#review-gate}

实施前，评审者确认提案没有重复已有外壳、resolver、组件族或数据权威。实施期间，如果设计改变，
先更新这份双语提案，不能让代码悄悄漂移。验收至少覆盖主题的最窄归属检查、真实文档站、渲染后的
中英文、相关输出、无障碍与响应式检查。

---

本节页面：

- [反向链接与知识图谱](/zh/docs/design/proposals/knowledge-graph/): 从普通 Hugo 链接推导反向链接、局部与全站图谱的三阶段设计草案。
- [媒体收敛](/zh/docs/design/proposals/media-convergence/): 正文图片、编号图、Landing 媒体与代表图片选择之间剩余收敛工作的设计草案。
- [Agent 批量索引](/zh/docs/design/proposals/agent-indexes/): 基于 OINK 既有 Markdown 输出与导航权威，可选生成 llms-full 全文包和稳定导航 JSON 的设计草案。