前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构。在智能体开发与协作中，会话内的临时文件与知识往往随着会话结束而失效，导致团队知识碎片化。dsh-kb 插件旨在解决跨会话、跨人的知识共享与沉淀问题。它提供了一个固定的、可搜索的团队知识库，通过侧栏入口即可访问。与仅管理会话工作区的 dsh-file-share 不同，dsh-kb 管理的是长期沉淀的固定知识库。
核心设计¶
dsh-kb 基于 Karpathy LLM Wiki 模式构建，包含三个核心层级：
- raw（不可变素材）：由用户上传的原始文件（如日志、截图），服务端强制只进
raw/目录，拒绝覆盖。 - wiki（成文知识）：由 Agent 按照约定加工后的结构化文章。
- schema（约定）：定义当前知识库的加工规则，每库独立。
默认存储路径为 ~/.dsh/kb/，包含 raw/、wiki/、index.md（目录）、log.md（操作流水）以及 schema.md（加工约定）。
主要功能¶
- 全页知识库：侧栏进入，左侧目录树（支持 wiki/raw 懒加载），右侧阅读或搜索。
- 多知识库：支持创建多个知识库（素材库或产出库），可在界面中切换或移除。
- 库约定可编辑：每个库可拥有独立的
schema.md，用于规定页面规范、目录用途和加工流程。保存后即刻生效。 - 自动蒸馏：上传素材后，素材入队，由 kb-bot 会话按 schema 串行加工成文，也可手动指定。
- 全文搜索：内置零依赖扫描，支持大小写不敏感的全文检索与高亮。
- 问 AI：在搜索框输入问题并点击「问 AI」，系统自动检索并引用命中页面，让 Agent 带着依据作答。
- 版本历史：wiki 页面自动快照，保留最近 50 个版本，支持查看与回滚。
- 页面反馈闭环：阅读页提供反馈入口，提交后 Agent 可根据反馈自动修正页面内容。
- 陈旧提示：自动标记超过 90 天未更新的页面。
- 下载导出：支持将任意文档下载为 markdown 或文本格式。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add @weibaohui/dsh-kb -w
安装完成后，重启 dsh web 进程使配置生效。
配套 Agent 技能¶
Agent 的加工沉淀能力依赖于配套技能。请在技能市场安装 skill/dsh-kb/。安装后，Agent 才具备查询、两步加工、矛盾标注及日志纪律等功能。
使用流程¶
- 浏览与检索：侧栏点击「📚 知识库」。在顶部搜索框输入关键词并回车进行全文检索，或在左侧树中浏览目录。
- 阅读与跳转：点击文件名阅读，支持
[[链接]]内部链接跳转。点击「@ 给 agent」可将当前条目注入对话框。 - 上传素材：在
raw/目录树中打开任意页面，点击右上角「上传素材」。 - 加工沉淀：在对话中输入
@raw/xxx.log并指令 Agent「按 schema 加工入库」。Agent 完成两步加工后，会在 wiki 中生成成文并更新索引。 - 定制约定：在知识库页面点击顶栏「📐 约定」，编辑当前库的
schema.md。例如，指定某个库只收录「解决方案」形态的文档，保存后生效。
环境依赖¶
- DeepSeek Harness 版本：需大于等于
0.1.7-rc.2。 - Node 版本：需大于等于
20。 - 定时任务建议：建议在
dsh-tasks中添加每月的 lint 定时项，用于检查死链、孤儿页和陈旧条目。
与 dsh-file-share 的区别¶
dsh-file-share 管理会话工作区的文件（跟随会话 cwd），随会话结束可能失效或被清理。dsh-kb 管理跨会话、跨人的固定知识库，侧重于只读浏览、搜索和 raw 素材上传，二者互不依赖。
