设计提案与 PRD

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

设计契约

非规范性材料

提案描述的行为可能尚不存在。当前行为由契约、已接受决策、实现与归属检查器定义。不能把提案当作配置参考。

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

当前提案

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

新 PRD 放在哪里

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

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

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

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

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

生命周期

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

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

评审门禁

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

加载评论需要启用 JavaScript。在 GitHub 上查看讨论。