设计与开发
在唯一的双语专栏中管理 OINK 维护者契约、已接受决策、带日期的研究记录与候选提案。
OINK 1.3.1 契约
本契约描述 OINK v1.3.1。主题开发使用同级 checkout；发布验收在关闭替换与 工作区后验证公开模块。消费站升级与部署分别检查。
本专栏是 OINK 可长期维护的设计记录。站内其它专栏按任务讲解如何搭建站点； 这里集中说明现行不变量、这些选择背后的理由、用于比较方案的证据，以及仍处于 候选阶段的工作。
如何阅读本专栏
| 层次 | 含义 |
|---|---|
| 契约 | 兼容实现必须保留的规范性行为 |
| 决策 | 用于解释现行行为的已接受理由与边界 |
| 研究 | 带日期且不具规范性的证据，必要时应重新验证 |
| 提案 | PRD 与 RFC 草案；公开在这里不代表已经实现 |
契约目录
| 契约 | 权威范围 |
|---|---|
| 架构契约 | 构建、配置、诊断、本地化、特色图片、输出、安全、无障碍与性能 |
| 组件契约 | 组件 API、Book 与发布原语、校验和输出降级 |
| 外壳与导航契约 | 导航、搜索、博客展示、操作、分类法与页尾组合 |
| 落地页契约 | 落地页数据、22 种区块注册表、运行时、无障碍与输出 |
| 迁移边界 | 从 0.4 到当前版本所支持的内容与配置迁移 |
设计记录
| 集合 | 内容 |
|---|---|
| 设计决策 | 已接受的诊断、配置、创作模型、Expo 与 CLI 设计理由 |
| 设计研究 | Goldmark 探针、消费站证据、CLI 验收与 10 月主题评审 |
| 候选提案 | 知识图谱、媒体收敛、视觉预设与 CLI 路线图等活跃 PRD |
以后所有 OINK PRD 或 RFC 都必须以中英文页面对的形式放入
content/docs/design/proposals/，不得再在仓库中创建 plan/、plans/ 或
proposal/ 目录。提案被接受后，应同步更新实现、对应检查器与相关契约，把稳定
理由沉淀到“设计决策”，并通过 Git 历史与变更日志退出草案。
Expo 契约
Expo 契约 描述 OINK 1.3.0 新增的图片相册布局， 已接受决策 记录内容模型和对早期 Muse 实验的修订。 创作指南说明相册创建与查看器操作。 契约、已接受决策与创作指南说明同一套已发布的内容模型与控件。
权威来源与维护
本目录同时管理英文与中文维护者设计文档。主题仓库管理可执行事实：hugo.yaml
管理公开默认值；对应的解析器与检查器定义可选结构；layouts/ 与 assets/
管理渲染行为；检查脚本与 tests/goldens/ 管理验收；VENDOR.json 管理内置
依赖的版本、许可证、文件与校验和。
公共行为发生变化时，必须在同一次交付中更新实现、对应检查器以及本目录下相关 契约的中英文版本。测试应验证行为和输出，不应只固定某段文字。