前言¶
在 DeepSeek Harness（DSH）里做智能体或长期项目，常见两种做法：要么把对话里的事实抽成「记忆」条目常驻注入，要么把事实写在文档里、注入层只留索引。记忆路线能缓解「记不住」，但条目只增不减、占注入预算，且与文档容易双源漂移；文档路线把 git 当治理层，注入层恒定小，代价是模型需要时再读文件。
文档路线也有静默失效：索引指向的文件改名或删除、注入层被塞入事实或决策史措辞、治理文件未进 git——这些不会报错，只会慢慢烂掉。社区插件 dsh-doc-kit（维护者 rezon-aki，分类 admin-security）针对的就是「文档体系有没有烂」：提供只读工具 doc_lint 做体检，并随包分发 doc-governance 技能，给分层写入与体检节奏一套可执行规则。检查给事实，技能给规则。
这是什么¶
dsh-doc-kit 不管理任何数据：无存储、无注入、无定时器、无 LLM 调用。它只做两件事——注册 doc_lint 对当前工作区做四项只读检查，以及附带文档治理技能。理念是：事实的唯一真源在 docs/、CONTEXT.md、项目 handoff 等文档；全局或工作区 AGENTS.md 里只放「哪里有什么、何时去读」，不放事实本身。
| 对比项 | 记忆插件路线 | 文档路线 + dsh-doc-kit |
|---|---|---|
| 事实存放 | 条目常驻注入 | 文档本身，按需 read/grep |
| 常驻成本 | 随记忆积累增长 | 仅索引，体量稳定 |
| 真源 | 文档与条目易漂移 | 单一（文档） |
| 版本与审计 | 常需自造备份与日志 | git 原生 |
| 工具形态 | 存储、注入、循环、UI 等 | 只读、零依赖、无 UI |
插件当前版本 0.1.0（MIT），要求 Node.js >=20，DSH >=0.1.5-rc.1。社区目录页：skillhub.cn/plugins/rezon-aki/dsh-doc-kit；源码：github.com/rezon-aki/dsh-doc-kit。DSH 生态是「一切皆插件」；SkillHub 为社区独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能：doc_lint 四项检查¶
调用一次 doc_lint，把文档体系的常见漂移变成可读报告（全程只读，不改任何文件）：
- quota（FAIL）：L0 / L1 注入层超出自律配额（默认 2 KB / 4 KB）——说明有人把事实写进了注入层。
- banned（FAIL）：注入层出现「曾用 / 已废弃 / 已被推翻 / 别再试」等措辞——过程凭证混进常驻上下文。
- index（WARN）：索引点名的文档路径不存在——索引已漂移。
- git（WARN）：治理相关文件未跟踪——无历史则漂移难以发现。
规则实现见仓库 lib/lint.js，工具参数见 lib/index.js；README 侧重设计动机，细则以代码与 doc-governance 技能为准。
随包的 doc-governance 技能说明：该写进哪一层、写前先查什么、多久体检查一次、对外发布前看什么。卸载插件后，技能库里的 doc-governance 文件不会随插件自动删除，需自行管理。
安装与启用¶
任选其一：
- DSH 侧栏 Plugins → Add plugin，填写
github:rezon-aki/dsh-doc-kit。 - 命令行（与 README 一致）：
dsh plugin --profile web add github:rezon-aki/dsh-doc-kit
安装后重启 dsh web 生效。
卸载：
dsh plugin --profile web remove dsh-doc-kit
典型用法¶
装好后让模型执行工具名（无参数时默认体检当前会话工作区）：
doc_lint
本机实测通过时，输出形态类似：
doc_lint：通过
[PASS] quota：L0 599 B / 配额 2048；L1 652 B / 配额 4096
[PASS] banned：无决策史措辞
[PASS] index：6 条路径全部存在
[PASS] git：已跟踪（3 个）
需要在其他目录体检时，传入参数 workspaceRoot 指向目标根路径。
适用场景与边界¶
适合谁：已经或打算走「文档为真源、注入层只放索引」的团队；希望定期确认配额、措辞、索引与 git 跟踪是否正常，又不想再养一套记忆库与审批 UI 的 DSH 用户。
插件明确不做的事（README 原文）：
- 不注入任何 prompt（
AGENTS.md分层 / 优先级 / 预算由平台原生机制负责）。 - 不自动改写文件；往注入层加内容仍需你确认。
- 不替你做业务判断：WARN 类项只提示，是否处理由你决定。
安全与权限：插件以当前 dsh 进程权限运行，会读取工作区内的注入层与文档路径。安装前请自行查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全策略。社区目录分类为 admin-security，体现的是治理与注入层卫生，而非替代平台级安全产品。
结尾¶
dsh-doc-kit 把文档路线的失效模式从「看不见」变成一次 doc_lint 报告，再用 doc-governance 约束日常写法——轻量、只读，避免再长成一个要维护的数据系统。进一步了解可打开 SkillHub 目录页 与 GitHub README。
