知识库规范
目录职责
文件按 Type 保存；领域、专题、任务作为 Map 和 domains 表达。一个判断对应一个 Concept，一个完整处置对应一个 Runbook，一次真实事件对应一个 Incident。长篇资料不需要机械拆短。
内容来源类型
| source_kind | 含义 |
|---|---|
| source-snapshot | 不随后续认识修改的来源快照 |
| source-excerpt | 原图资料摘录 |
| editorial-synthesis | 基于原图的提炼卡，待独立校验 |
| diagnostic-outline | 诊断提纲，待补具体证据分支 |
| procedure-draft | 未验证的操作骨架 |
| project-outline | 建设或演练目标，未实际执行 |
| template | 写作模板，非真实内容 |
| navigation / planning / governance | 导航、组织方案或库内规范 |
质量状态
当前全库为 draft，不以自动导入推定可用。将内容改为 usable 前，应写明来源与适用边界；Runbook 还需要环境、命令参数、审批、停止条件、回退或补偿与演练证据。过时内容可标 deprecated，并提供替代去向。
写作最小单元
Concept 用完整问题或判断命名；Reference 可围绕一个查阅目的收纳一组命令；Troubleshooting 必须区分现象、事实、假设与判定；HowTo 围绕建设目标；Incident 保持事实完整。94 个深度模块先保留为 Reference，不将模块名冒充原子知识。
链接规范
链接要说明用途、前提或对比关系，不能只堆“相关”。物理路径用 Type，domains 可包含多个方向。公开网页即使允许直接进入 Runbook，页首也要保留条件；链接、勾选框和 frontmatter 不是权限控制。
来源与版本
每条重要结论可追溯到官方资料、实验或事件；本次仅建立原图来源，不等于完成独立核实。版本敏感内容必须补适用版本和查阅日期。保留疑点，不悄悄将猜测改写为结论。
敏感内容与发布
不在正文保存口令、令牌、私钥或完整客户数据。00-Inbox 是待审输入，不应该自动加入公开 Git 仓库。publish:false 只表达本库默认意图，不替代构建器筛选或访问控制。图片和文本必须分别审查。
维护闭环
先保存现场 → 完整记录真实事件 → 提炼或修订知识卡 → 改进诊断 → 演练操作 → 记录预防措施。没有真实事件不生成 Incident；没有执行与验收不填“已验证”。