用途:在 deepseek-harness 中管理 Agent Notes 的归档与生命周期。目标是在不抹除仍可指导工作的历史的前提下,减少活跃决策语料;每条笔记都需按语义判断,字数与时间只作发现线索,不作为归档标准。
主要能力:
- 新增笔记时触发同决策、机制或被拒方案的活跃笔记审计,识别完整或部分取代关系。
- 按未来价值分类:已实现但仅属小 UI 调整或纯机械改动的完整三元组删除;仍可能指导未来变更的理由、替代方案、负向保证、持久/线缆语义、归属边界、安全规则或重新引入条件保持活跃;实质性历史决策完整且不太可能指导未来工作时归档。
- 提议类不归档,不值得推进则按拒绝格式处理;被拒绝类仅在仍是诱人错误时保留为护栏,过时或不再可能时连同三元组删除并修复或移除入链。
- 归档操作:将 foo.md、foo.zh.md、foo.i18n.yaml 三元组从 implemented/<kind>/ 移至 archived/<kind>/,正文不改,仅在两个语言文件的 Status: implemented 下插入 Archived: YYYY-MM-DD,重算 sidecar 哈希,并处理活跃正文中的入链。
使用方式:先阅读 Agent Note 规则、归档说明与活跃生命周期说明;归档后运行 pnpm run verify-archived-agent-notes --write,再运行普通校验器;随后执行该归档校验器的聚焦测试、pnpm run verify-archived-agent-notes、pnpm run doc-sync、pnpm run lint 与 git diff --check,并用 dsh-pre-push-checks 选择额外证据。封存后的三元组不得再编辑、移动、翻译、重排或删除。
适用场景:新增或审计 Agent Notes、精简活跃决策语料、归档已实现历史决策、审查被拒方案护栏。
限制:不按配额归档;归档笔记是历史快照,不是当前行为权威;归档校验器有意不检查归档笔记的外链,不应声称其有效。部分分类边界判断依赖资料,需按既有示例校准。