前言¶
用 DSH 做项目时，智能体会在多轮会话里反复碰到同一类问题：上次已经摸清楚的坑，换一条对话又从头踩；某次对话里总结出的做法，也没有稳定地方可查、可引用。靠聊天记录检索既不精确，编号也无法长期对齐。
下面介绍社区插件 @moyu-cn/dsh-knowledge（维护者 MoYu-CN，分类：记忆）。它在每个项目下维护一套 Markdown 分册知识库，让智能体把「避错」与「方法」写进固定结构，并在后续会话里通过工具与界面检索、注入使用约定。
这是什么¶
dsh-knowledge 是 DeepSeek Harness（DSH）的插件：Host 半注册 8 个智能体工具与同源 HTTP 路由，Client 半提供设置项、会话头按钮和右栏知识库面板；库文件默认落在项目根目录的 知识库/ 下。
一句话原理：可复用做法进 方法/，踩过的坑进 避错/；条目编号 M-0XX / P-0XX 只增不改，分册与索引由工具自动维护。
英文简介原文为：Project knowledge base for DSH agents: capture pitfalls and reusable methods into paged volumes and surface them while you work.
核心功能¶
智能体工具（8 个）¶
| 工具 | 作用 |
|---|---|
kb_guide |
按当前工序返回该照做的条目，动手前先查 |
kb_search |
关键词检索 |
kb_add |
新增避错或方法条目 |
kb_list |
列出全部条目摘要 |
kb_get |
按编号读取全文 |
kb_remove |
删除一条（不可撤销） |
kb_prune |
清理到不超过 N 条，只删最旧的 |
kb_init |
建立知识库骨架，也可为全新项目建库 |
避错类条目写入时，README 要求四段必填：触发条件、先做、为什么、违规症状。
界面与 HTTP¶
- 设置 →「启用知识库沉淀」：沉淀状态、存储位置（留空则各项目在自身根目录下建
知识库/）、每册容量与总量上限。 - 会话头部「查看 / 沉淀」：
查看打开右栏面板；沉淀把当前对话交给智能体提炼后写库。 - 同源 HTTP 路由包括
/__kb/list、/__kb/get、/__kb/search、/__kb/distill等，供 Client 与浏览器面板使用。
设置 UI 随宿主语言在中英文间切换；面向模型的提示词按设计保持中文。可在设置中关闭「注入使用约定」或「本项目必读」以控制上下文注入量。
库目录结构¶
<项目根>/知识库/
├── 00-开始这里-总纲.md
├── 方法/
│ ├── 00-方法主体.md
│ └── 方法-01-【领域】.md
└── 避错/
├── 00-避错主体.md
└── 避错-01-【领域】.md
按领域分册，每册 10 条，装满开新册。插件数据目录默认为 <DSH 安装根>/.dsh-knowledge-data/（含 config.json）；若在设置里填写「知识库父目录」，新项目会集中到该目录下，不会自动搬运已有条目。
安装与启用¶
推荐从 npm 安装（资料原文命令，勿手改包名）：
dsh plugin add @moyu-cn/dsh-knowledge
装完后按提示重启 DSH（Host 半）；客户端半刷新页面后设置行与右栏面板才会出现。
备选： tarball 安装 dsh plugin add https://registry.npmjs.org/@moyu-cn/dsh-knowledge/-/dsh-knowledge-0.1.0.tgz；或 clone 后 dsh plugin add "link:<你的目录>/dsh-knowledge" 做本地软链开发。package.json 中版本为 0.1.0，许可证 MIT。
兼容性说明：README 记载 DSH Desktop 2.0.17（@deepseek-ai/* 0.2.0-rc.2）实测可用；需宿主提供 webServer 及若干官方 client 注入包（见仓库 package.json 的 dsh.client.inject）。
典型用法¶
1. 首次为项目建库¶
项目下尚无 知识库/ 时，工具会报错并给出可照抄的 kb_init(...) 建议，不会静默创建。由智能体或你在对话中触发初始化即可。
2. 动手前查工序¶
做具体任务前调用 kb_guide，按触发条件匹配该照做的条目；与 kb_search 的关键词包含匹配可能结果不同，这是有意设计。
3. 写入避错或方法¶
用 kb_add 追加条目；总量达到设置上限时会拒绝写入，需人工决定删哪条（kb_remove 或 kb_prune）。
4. 从对话沉淀¶
在会话头点击「沉淀」，由智能体从当前对话提炼类别与领域后写库；也可在右栏浏览、搜索已有条目。
适用场景与注意¶
适合：长期维护的代码仓库、需要跨会话保留「项目特有坑与套路」的团队或个人；希望编号稳定、可引用（如「见 P-012」）的场景。
边界（README 明确）：
- 不自动建库；无库时报错是预期行为。
kb_remove/kb_prune不可撤销，删前需确认。- 插件以当前 DSH 进程权限读写磁盘；安装前应阅读 GitHub 源码 与 MIT 许可证，自行评估是否纳入工作流。
DSH 生态是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-knowledge 把智能体会话里的避错与方法落成项目内分册 Markdown，用单调编号和自动索引支撑后续检索与引用。若你在 DSH 里做重复性工程任务，可先安装插件、为项目 kb_init，再在设置里配好容量与注入策略。
- 目录页：https://www.skillhub.cn/plugins/MoYu-CN/dsh-knowledge
- 源码与完整说明：https://github.com/MoYu-CN/dsh-knowledge
