消息与规则
第2章 · 笔记 2
笔记 2
- 拆分模式：近期流水留主页面 + 历史记录进 archive/ + 待处理建议独立页面（首例：每日巡检页拆为 reports/知识库守护每日巡检.md + reports/知识库守护优化建议.md + 历史进 archive）
来源：《知识库有效信息改造计划》定稿 v1.0（~/.hermes/reports/知识库有效信息改造计划.md）。目标：当前有效内容不被历史叙述干扰；历史不删、可检索、待在指定位置。 本规范是 P0.5 试点、P1 工具、P2 存量、P3 长期机制的执行依据。
每个页面 frontmatter 必须携带 status 字段，四态之一：
active · 当前有效 · 正文描述的是当前系统/流程/事实，可被引用执行 · 参与「当前有效」检测与检索
draft · 进行中/未定稿 · 内容仍在演进、尚未定稿（探索记录、草稿方案）；读者可参考，但不得当作定稿判据引用 · 与 active 同等参与检测与检索（防逃检；2026-09-26 t_4a5d146f 乾婆裁决纳入）
superseded · 已被取代 · 页面描述的对象已被新页/新机制取代，但历史有参考价值，暂不归档 · 不参与「当前有效」检测；顶部挂横幅；索引标注
archived · 已归档 · 内容已无当前价值，仅历史参考 · 物理移入 archive/，不参与检测；archive 索引可检索
- 建页默认值：新页默认 status: active。T2 工具升级后由 wiki-new-page.py 模板强制写入；工具升级前手工建页必须手动带字段。
- 状态迁移：draft → active（定稿）；active → superseded（被取代，仍留原位置并挂横幅）→ archived（物理挪 archive/）。不允许 archived 直接回到 active——如有需要，重建新页并链回 archive 旧页。
- draft 的 maintenance 义务（2026-09-26 t_4a5d146f 乾婆裁决）：draft 页不豁免 maintenance —— 进行中的页照样该被检查（豁免表见「元数据矩阵 v1」§4）。draft 与 active 同属「有效内容」家族，区别只在「是否定稿」。
superseded 页顶部横幅约定（正文第一行，H1 标题之后）：
⚠️ 已被取代：本页已被 新页面名 取代，仅作历史参考。当前有效内容见新页。
- 正文主体 = 当前有效内容。页面正文描述的是「现在是什么」：当前状态、当前流程、当前配置。
- 历史叙述集中到文末「📜 历史沿革」区，或挪入 archive/。正文中禁止夹杂「曾用」「原机制」「旧版」「已废弃（未标状态）」这类历史叙述。
- 活文档守则：状态只写最新，变更进 log.md / 页面「变更记录」区。正文不保留「之前是 X，现在改成 Y」的双态并存写法——要查历史去 log / 历史沿革区。
- 2026-08-10：原机制为 X，因 Y 改为当前做法（详见 log.md）
高频页（长期大量被读、被引用的页）在正文分区约定之上更严格：
- 正文最前段必须有一个「现在是什么」摘要区（3-10 行），让读者 5 秒内拿到当前状态。
- 摘要区格式：二级标题 ## 现在是什么 或引用块 > 现在是什么：…。
- 高频页清单（P0.5 试点/存量清理按此清单优先）：
- 配置体系、关键配置参考、Cron 作业全览、脚本系统、看板系统、知识库索引、需求池、播客流水线、重大维护事件
- C1 的 freshness: live 实时权威页（需求池、配置体系、播客流水线、重大维护事件、关键配置参考）必须满足「当前有效前置」。
重大维护事件 / A2A 决策记录 = 半历史性文档：记录「发生过什么、当时为何决策」，影响当前认知，但不是「当前状态页」。
- 定位：保留、可回溯、不参与「当前有效」检测，不按「当前有效」标准清理。
- 其内容天然是历史叙述，不适用正文分区约定——历史就是它的正文，不用拆走。
- 代表页：concepts/重大维护事件.md、A2A 决策记录类页面。
需求池 / 踩坑记录 / log / 巡检报告 = append-only 流水型文档，天然累积历史，且历史就是其价值。
- 豁免：不参与「有效信息 vs 历史信息」治理，不按历史叙述清理。删除/归档只按各自既有规则（月度归档、体积阈值）。
- 防误清理：任何清理动作（人工或脚本）不得把流水页的历史条目当噪音处理。流水页顶部可加「当前状态摘要区」（高频维度），但历史条目本身不动。
环境事实（端口/路径/脚本名/cron 配置/代理归属等）只在核心页维护一份，其他页一律链接引用，不复制内容。
- 核心页 = 各事实的「唯一家」：配置体系（配置/端口/路径）、Cron 作业全览（cron 清单）、脚本系统（脚本名）、看板系统（看板机制）、关键配置参考（速查）等。
- 其他页需要引用时用 显示名 链接，不把事实抄过来。抄过来 = 双份维护 + 改一处漏多处 + 漂移风险。
- 这是文档同步原则（改一处扫全网）的预防性升级：源头只有一处，改一处 = 全网一致。
- 例外：历史叙述中引用的旧事实（log / 历史沿革区）保留原文，不改写。
检测脚本只初筛「可能过时」，不判死。泡影（知识库负责人）结合事实判定三选一：
已变重写 · 环境/系统已变化，页面内容与当前事实不符 · 重写正文为当前状态，历史沉底或入 archive
未变刷日期 · 核实环境未变化，内容仍准确 · 仅刷新 updated 日期，内容不动
失效归档 · 页面描述的对象已不存在/不再使用，无当前价值 · 标 superseded 挂横幅，或物理挪 archive/
铁律：可能过时 ≠ 已过时。 脚本报出的每条疑似项必须人工核实后判定，不得凭特征词直接删改。判定结果记录在 log.md 或任务评论。
### 8. 技能侧历史处理原则（T5 承接 B2，2026-08-25 固化）