消息与规则
第4章 · 笔记 4
笔记 4
version: "v0.19.0" # P0必填/P1推荐 — 文档适用的系统版本
### freshness / freshness_days 字段（C1 页面分级，2026-08-23）
- 🔴 受控值域 = 仅 live（2026-10-14 t_2b083652 收口）：freshness 只定义 live 一个合法值（元数据矩阵 §1 L2 行「live / 无」），未列出的值不属词表、消费侧不得识别。判定顺序：先问「这页过时会误导决策吗」——会 → 标 live（并按更新频率定 freshness_days）；不会 → 不标（普通页）。历史上唯一的规范外取值 daily（concepts/模型选型台账.md）已改回 live：其「每日更新」前提随该页 cron 2026-10-12 降频为每周日刷新而失效，live + 缺省 30 天阈值已覆盖其过时检测需求。
- freshness: live 标记实时权威页（live 页）——需求池、配置体系、播客流水线、重大维护事件、关键配置参考等。这些页过时会误导决策，参与过时检测（check_kb_staleness.py）。
- freshness_days: N 可选，该 live 页的过时阈值（天）。缺省用脚本默认值 30 天。
- 不标记 freshness 的页 = 普通页，不参与过时检测（但 status: active 的页参与检测，见上文「页面状态机」三态表；T3 检测扩展后 check_kb_staleness.py 扫 active+live 并集）。
- archive 页（踩坑历史、审计存档）在 archive/ 目录，可滞后，不标记 freshness，脚本也排除 archive 目录。
- 新增 live 页时：加 freshness: live + 按更新频率定 freshness_days（高频更新页用短阈值如 14 天，低频稳定页用 30 天）。
- 🔴 防噪音铁律（C3）：updated 超阈值 ≠ 内容已过时。检测脚本只生成「校验」任务，由泡影结合事实（环境是否已变）判定：已变则重写，未变则仅刷新 updated 日期，不再适用则归档。
### related_skills 字段（B3 互挂，2026-08-23 试点）
- 可选字段，用于「技能 ↔ wiki 页」双向导航：wiki 页 frontmatter 填 related_skills，技能 SKILL.md 正文反向挂 > 📚 知识库背景：~/wiki/<路径>.md 指针
- 值格式：技能目录名（= frontmatter name），YAML 内联 list，与 tags 一致
- 试点页：知识库守护工作总览 ↔ daily-inspection-handling/wiki-maintenance；播客全链路流水线 ↔ podcast-orchestration-core/podcast-production-workflow
P0（必填） · 文档内容与系统版本强关联 · 配置参考、部署指南、CLI参考、架构文档、运维流程 · "v0.19.1"、"v0.18+"
P1（推荐） · 文档内容不绑定特定版本 · 播客流程、角色小传、佛学资料、日志、报告 · "N/A"（不适用）
- P0 文档：填当前适用的 Hermes 系统版本号，格式 v主.次.修订（如 "v0.19.1"）
- 如果文档适用于某个版本及以上，用 "v0.18+" 格式
- 如果文档描述多个模块的各版本，用逗号分隔（如 "Hermes v0.19.1, Fish Audio v2.1"）
- 系统升级后，P0 文档需审查 version 是否需要更新
约定（2026-09-11 固化）——写条目时不动此字段：
- 写踩坑条目 / 日常维护页面时不动 frontmatter version（即不手工填改 version 字段），只写正文；该字段由 check_kb_staleness.py 每日按 hermes --version 实测值统一维护。
- 根因背景：同类超前误写已 5 次（8/27 v0.20.6、8/31 v0.20.7、9/2 v0.20.6、9/11 v0.20.6、9/26 v0.21.5 实测 v0.21.4），均为「凭印象填版本号」。此约定 2026-09-11 已固化进本页与 wiki-maintenance，但 9/26 仍复发——证明规范页 / 运维技能不是写入方（建卡分派的写条目 worker）的可见面；2026-09-26 t_59f86a63 因此把约定补落到 kanban-category-constraints 通用约束 #12 + tabular-doc-editing 核心纪律。
- 例外：升级联动机制（wiki-maintenance「升级类变更主动触发知识库同步」）按流程批量审查更新 version，不受本约定限制；major 版本差异（如 v1.0 / v2.1.0）语义不同，脚本不自动修回，需人工判断。
来源：《知识库元数据操作化计划》（projects/知识库元数据操作化计划.md）§3。目标：让知识库元数据从「描述性」进化为「操作性」——页面声明「自己该怎么被维护」（维护频率/来源渠道），巡检/检测/工作流脚本消费这些元数据，实现按频率分层检查 + 元数据一致性机器校验。
本矩阵是 check_frontmatter 校验脚本和建页模板的唯一词表权威源。 后续任务（P0-3 模板升级 / P0-4 校验脚本 / P0-5/P0-6 存量迁移 / P1 巡检分层 / P2 工作流融合）全部以本矩阵词表为准。
L1 强制字段（建页模板强制写入，校验脚本逐页检查）：
status · active / draft / superseded / archived · active · 页面状态机（见「信息生命周期治理」§1），已有保持；draft（进行中/未定稿）为 2026-09-26 t_4a5d146f 乾婆裁决纳入
type · entity / concept / comparison / query / summary / project / report / meta · 按路由 · 词表补齐（现状很多页缺失/随意）
maintenance · daily / weekly / monthly / quarterly · weekly · 新增。页面声明的维护频率；active 内容页/指针页必填；词表不含 none（防逃检）
freshness · live / 无 · live 权威页 · 已有保持（见下方「freshness / freshness_days 字段」）
freshness_days · 数字 · live 页 · 已有；默认值由 maintenance 推断，可显式覆盖（见第 3 节映射）
source · podcast / kanban / cron / inspection / script / manual · 工作流相关页 · 新增，P2 起强制，P0 先行定义词表（见第 5 节）
version · P0/P1 · 按规范 · 已有保持（见「version 字段」）
tags · 受控白名单 17 词（见第 2 节），P1 起强制
aliases / sources / related_skills · 已有保持（related_skills 见「B3 互挂」）
原则：tag 只做「目录和 type 表达不了的横切维度」——纵向按文档类型已由目录承担，tag 承担跨目录的主题聚合。
守护、播客、佛学、看板、cron、配置、巡检、审计、脚本、踩坑、报告、需求、工作流、运维、监控、索引、知识库
🔴 重点三词语义边界（2026-08-26 正生拍板）：
守护 · 知识库守护工作体系（守护者角色/周计划/守护工作总览等体系性内容） · 知识库守护工作总览、知识库守护周计划