dsh-plugin-dev-kb

Name: Pasumao/dsh-plugin-dev-kb
Author: Pasumao

npm version npm downloads License kb sync

194 页官方镜像 · 554 篇独占补充文档 · 每周自动同步上游 · 0 运行时依赖

写 dsh 插件时的随身辅助：① 把 DeepSeek Harness 官方文档站点 https://deepseek-harness.github.io/deepseek-harness/ 的全部内容整理为 dsh 原生可用的形态—— 装了这个插件，agent 写插件时自动加载知识库，按任务场景定位文档，不用再翻网页； ② 附带 dsh-dev-sandbox 技能：自建独立沙箱 profile 开发沙箱工作流（沙箱名由 agent 按任务自定），开发中的插件隔离运行，agent 自主启动 / 重启 / 冒烟验证，插件崩了不影响主力 dsh； ③ dsh_kb_search 工具（1.6.0 起）：知识库本地打分检索，一次调用返回命中文件 + 行号 + 上下文片段； ④ dsh-upgrade-assistant 技能（1.7.0 起）：升级 dsh 版本时，agent 自动读官方升级指南与持久化变更记录，生成迁移检查清单、预判插件兼容闸门与回滚方案； ⑤ 版本感知横幅 + dsh_kb_read 工具（1.8.0 起）：工具输出自动标注「知识库快照 vs 宿主 dsh 版本」差异并给出对应升级指南；按路径 + 行号窗口局部阅读原文，防大文件整读、自动提示中英对照； ⑥ dsh-plugin-starter 技能（1.8.0 起）：从零新建合规 dsh 插件的脚手架指南（骨架清单 / 收录门槛 / 验证闭环）。

这是什么

站点完整镜像：官方文档（VitePress）由仓库 deepseek-ai/deepseek-harness 的 docs/ 原始 Markdown 投影生成（链接已按站点路由重写，与线上逐字一致）。中英双语共 194 页。
补充文档：仓库 docs/ 中未发布到站点的 554 篇开发参考（术语表、防御模式、模块图、测试策略、事故复盘、i18n 规范、升级指南、持久化变更等）——这部分是官方仓库独占内容，线上站点看不到。
agent 友好：skills/dsh-plugin-dev-kb.md 技能让 dsh 在插件开发任务中自动加载，获知知识库位置、主题导航与检索策略；kb/meta/topics.md 按任务场景映射要读的文件；kb/meta/search-index.json 提供全量检索。
开发沙箱：skills/dsh-dev-sandbox.md 技能提供自建独立沙箱 profile 工作流（沙箱名 agent 按任务自定，不与主力 profile 重名）——初始化（兼容闸门 / link: 挂载）、后台启动（自选空闲端口）、自主重启、headless 冒烟验证，全程 agent 闭环，不要求用户重启。
本地检索工具：dsh_kb_search 工具在知识库上做打分检索（标题 / 路径 / 正文多词加权），一次调用返回命中文件路径、行号与上下文片段；支持 scope: api（只搜 API 签名/目录类文档）、 lang: en、空 query 返回主题导航。索引惰性构建于内存（约 60ms / 314 文件），只读不写。
版本感知（1.8.0 起）：工具输出自带横幅——宿主 dsh 版本 vs 知识库 master 快照可能存在的 API 差异，并给出对应的 extra/upgrade-guide/<vX.Y.Z> 指南路径；探测失败自动降级（无横幅不报错）。
局部阅读工具（1.8.0 起）：dsh_kb_read 按 path/offset/limit 行号窗口读原文，带行号输出、防大文件整读、拒绝越界路径，自动提示中英对照路径与续读位置。

功能

官方文档完整镜像：deepseek-ai/deepseek-harness 官方文档站全部内容整理为 dsh 原生可用的形态，中英双语共 194 页，链接按站点路由重写，与线上逐字一致；
仓库补充文档：未发布到站点的 554 篇开发参考（术语表、防御模式、模块图、测试策略、事故复盘、i18n 规范、升级指南、持久化变更等）；
每周自动同步：GitHub Action 定时从上游 master 刷新（见顶部「kb sync」badge 可查同步日期与 commit）；
agent 友好：dsh-plugin-dev-kb 技能让 dsh 在插件开发任务中自动加载知识库； dsh_kb_search 工具一次调用完成检索定位；kb/meta/topics.md 按任务场景映射要读的文件，kb/meta/search-index.json 提供全量检索；
人侧可用：直接浏览 kb/ 目录，或打开 kb/INDEX.md 按 URL 对照查阅；
零运行时依赖；两个工具（dsh_kb_search / dsh_kb_read）为纯 Node 本地实现（不联网、不写文件）。

30 秒验证装好了

安装挂载后，随便开个会话问 agent：

dsh 0.2.0 的设置子系统（SettingsForms）和以前有什么不一样？

agent 用 dsh_kb_search 检索并答出 SettingsForms / .volatile() / 修订号冲突检测等细节 = 装好了；
答不上来或检索工具不存在 = 挂载没生效，回看「安装 / 挂载」一步。

配置

默认零配置，安装即用：

不读取环境变量，不需要 API Key / token，不写配置文件；
挂载后 skills/dsh-plugin-dev-kb.md 技能在会话启动时进入可用技能列表，自动生效；
dsh_kb_search 工具随宿主启动注册，首次调用时构建索引（毫秒级）；如需关闭，在 profile 的插件配置里设 searchTool: false（只保留技能，不注册工具）；
知识库更新走 npm run rebuild-index（见「更新知识库」）。

安装 / 挂载

# npm（推荐）
dsh plugin --profile web add dsh-plugin-dev-kb
# 或 GitHub
dsh plugin --profile web add github:Pasumao/dsh-plugin-dev-kb

源码安装（本地开发 / 调试）：

git clone https://github.com/Pasumao/dsh-plugin-dev-kb.git
cd dsh-plugin-dev-kb
npm install
# 以 link: 方式挂载进 profile

本插件是「纯数据 + 技能」插件，不自带 bundle 自动挂载，装完后在 profile 的 cordis.patch.yml 末尾加一行手动挂载（唯一的一次性步骤，复制即用；挂载为 profile 根层插件行，其 skills/ 技能进入全局层）：

- insert:
    - id: dsh-plugin-dev-kb
      name: dsh-plugin-dev-kb

重新启动 / 新建 dsh 会话后，dsh-plugin-dev-kb 技能才会出现在可用技能列表中（技能清单在会话启动时快照）。

5 分钟验证

重启后开一个新会话，直接问：

帮我写一个最小的 dsh 插件

agent 会自动加载 dsh-plugin-dev-kb 技能（技能清单里可见），调用 dsh_kb_search （或读 kb/meta/topics.md）定位文档后再动手——看到它引用 kb/site/... 路径即验证通过。

目录结构

dsh-plugin-dev-kb/
├── cordis.patch.yml   挂载声明
├── package.json       插件元数据
├── skills/
│   └── dsh-plugin-dev-kb.md   ★ 知识库使用指南（agent 加载此技能）
├── kb/
│   ├── site/          站点镜像：guide/ develop/ reference/（+ en/ 英文站）
│   ├── extra/         仓库补充文档：glossary、defensive-patterns、module-graph、upgrade-guide/、persistence-changes/、postmortem/、i18n/ …
│   ├── meta/
│   │   ├── topics.md         ★ 主题导航：任务场景 → 文件
│   │   ├── search-index.json 全量索引（751 文件）
│   │   ├── source.json       来源 commit / 时间 / 统计
│   │   └── site-pages.txt    线上页面清单
│   ├── INDEX.md        站点 URL ↔ 本地文件 对照
│   └── README.md       知识库总览与更新方法
└── LICENSE

使用

agent 侧：写插件 / Tool / 配置 / 服务 / 事件 / 打包 / LLM 适配器时，加载 dsh-plugin-dev-kb 技能 → 首选调 dsh_kb_search 工具检索（一次拿命中文件 + 行号 + 片段， scope: api 查 ctx.* API 签名）→ 用 read 按行号局部读原文；工具不可用时退回 grep kb/ 兜底。
人侧：直接浏览 kb/ 目录，或打开 kb/INDEX.md 按 URL 对照查阅。

自检

发布前跑结构自检（离线、零依赖）：

npm run selfcheck   # 结构完整 + 入口 / bundle patch 存在性

更新知识库

见 kb/README.md：重新克隆 deepseek-ai/deepseek-harness（master 分支），安装投影依赖后在仓库内调用 scripts/project-doc-site.ts 的 projectDocs() 生成 website/.generated/，覆盖本插件的 kb/site/（并按发布清单同步 kb/extra/），再在本插件根目录运行 node scripts/rebuild-index.mjs 重建索引与 INDEX.md。

AI 生成声明

知识库内容为官方文档的镜像整理（来源标注于 kb/meta/source.json），索引与导航由 AI 辅助生成（DeepSeek Harness），均经人工核对。

License

MIT

dsh-plugin-dev-kb

npm version npm downloads License kb sync

中文 | English

194 页官方镜像 · 554 篇独占补充文档 · 每周自动同步上游 · 0 运行时依赖

这是什么

站点完整镜像：官方文档（VitePress）由仓库 deepseek-ai/deepseek-harness 的 docs/ 原始 Markdown 投影生成（链接已按站点路由重写，与线上逐字一致）。中英双语共 194 页。
补充文档：仓库 docs/ 中未发布到站点的 554 篇开发参考（术语表、防御模式、模块图、测试策略、事故复盘、i18n 规范、升级指南、持久化变更等）——这部分是官方仓库独占内容，线上站点看不到。
agent 友好：skills/dsh-plugin-dev-kb.md 技能让 dsh 在插件开发任务中自动加载，获知知识库位置、主题导航与检索策略；kb/meta/topics.md 按任务场景映射要读的文件；kb/meta/search-index.json 提供全量检索。
开发沙箱：skills/dsh-dev-sandbox.md 技能提供自建独立沙箱 profile 工作流（沙箱名 agent 按任务自定，不与主力 profile 重名）——初始化（兼容闸门 / link: 挂载）、后台启动（自选空闲端口）、自主重启、headless 冒烟验证，全程 agent 闭环，不要求用户重启。
本地检索工具：dsh_kb_search 工具在知识库上做打分检索（标题 / 路径 / 正文多词加权），一次调用返回命中文件路径、行号与上下文片段；支持 scope: api（只搜 API 签名/目录类文档）、 lang: en、空 query 返回主题导航。索引惰性构建于内存（约 60ms / 314 文件），只读不写。
版本感知（1.8.0 起）：工具输出自带横幅——宿主 dsh 版本 vs 知识库 master 快照可能存在的 API 差异，并给出对应的 extra/upgrade-guide/<vX.Y.Z> 指南路径；探测失败自动降级（无横幅不报错）。
局部阅读工具（1.8.0 起）：dsh_kb_read 按 path/offset/limit 行号窗口读原文，带行号输出、防大文件整读、拒绝越界路径，自动提示中英对照路径与续读位置。

功能

官方文档完整镜像：deepseek-ai/deepseek-harness 官方文档站全部内容整理为 dsh 原生可用的形态，中英双语共 194 页，链接按站点路由重写，与线上逐字一致；
仓库补充文档：未发布到站点的 554 篇开发参考（术语表、防御模式、模块图、测试策略、事故复盘、i18n 规范、升级指南、持久化变更等）；
每周自动同步：GitHub Action 定时从上游 master 刷新（见顶部「kb sync」badge 可查同步日期与 commit）；
agent 友好：dsh-plugin-dev-kb 技能让 dsh 在插件开发任务中自动加载知识库； dsh_kb_search 工具一次调用完成检索定位；kb/meta/topics.md 按任务场景映射要读的文件，kb/meta/search-index.json 提供全量检索；
人侧可用：直接浏览 kb/ 目录，或打开 kb/INDEX.md 按 URL 对照查阅；
零运行时依赖；两个工具（dsh_kb_search / dsh_kb_read）为纯 Node 本地实现（不联网、不写文件）。

30 秒验证装好了

安装挂载后，随便开个会话问 agent：

dsh 0.2.0 的设置子系统（SettingsForms）和以前有什么不一样？

agent 用 dsh_kb_search 检索并答出 SettingsForms / .volatile() / 修订号冲突检测等细节 = 装好了；
答不上来或检索工具不存在 = 挂载没生效，回看「安装 / 挂载」一步。

配置

默认零配置，安装即用：

不读取环境变量，不需要 API Key / token，不写配置文件；
挂载后 skills/dsh-plugin-dev-kb.md 技能在会话启动时进入可用技能列表，自动生效；
dsh_kb_search 工具随宿主启动注册，首次调用时构建索引（毫秒级）；如需关闭，在 profile 的插件配置里设 searchTool: false（只保留技能，不注册工具）；
知识库更新走 npm run rebuild-index（见「更新知识库」）。

安装 / 挂载

# npm（推荐）
dsh plugin --profile web add dsh-plugin-dev-kb
# 或 GitHub
dsh plugin --profile web add github:Pasumao/dsh-plugin-dev-kb

源码安装（本地开发 / 调试）：

git clone https://github.com/Pasumao/dsh-plugin-dev-kb.git
cd dsh-plugin-dev-kb
npm install
# 以 link: 方式挂载进 profile

- insert:
    - id: dsh-plugin-dev-kb
      name: dsh-plugin-dev-kb

重新启动 / 新建 dsh 会话后，dsh-plugin-dev-kb 技能才会出现在可用技能列表中（技能清单在会话启动时快照）。

5 分钟验证

重启后开一个新会话，直接问：

帮我写一个最小的 dsh 插件

目录结构

dsh-plugin-dev-kb/
├── cordis.patch.yml   挂载声明
├── package.json       插件元数据
├── skills/
│   └── dsh-plugin-dev-kb.md   ★ 知识库使用指南（agent 加载此技能）
├── kb/
│   ├── site/          站点镜像：guide/ develop/ reference/（+ en/ 英文站）
│   ├── extra/         仓库补充文档：glossary、defensive-patterns、module-graph、upgrade-guide/、persistence-changes/、postmortem/、i18n/ …
│   ├── meta/
│   │   ├── topics.md         ★ 主题导航：任务场景 → 文件
│   │   ├── search-index.json 全量索引（751 文件）
│   │   ├── source.json       来源 commit / 时间 / 统计
│   │   └── site-pages.txt    线上页面清单
│   ├── INDEX.md        站点 URL ↔ 本地文件 对照
│   └── README.md       知识库总览与更新方法
└── LICENSE

使用

agent 侧：写插件 / Tool / 配置 / 服务 / 事件 / 打包 / LLM 适配器时，加载 dsh-plugin-dev-kb 技能 → 首选调 dsh_kb_search 工具检索（一次拿命中文件 + 行号 + 片段， scope: api 查 ctx.* API 签名）→ 用 read 按行号局部读原文；工具不可用时退回 grep kb/ 兜底。
人侧：直接浏览 kb/ 目录，或打开 kb/INDEX.md 按 URL 对照查阅。

自检

发布前跑结构自检（离线、零依赖）：

npm run selfcheck   # 结构完整 + 入口 / bundle patch 存在性

更新知识库

AI 生成声明

知识库内容为官方文档的镜像整理（来源标注于 kb/meta/source.json），索引与导航由 AI 辅助生成（DeepSeek Harness），均经人工核对。

License

MIT

插件（npm）	GitHub	说明
dsh-notify	GitHub 仓库	Windows 原生通知
dsh-plugin-choice-refresh	GitHub 仓库	选择增强：重新生成选项 / 更多选项
dsh-plugin-image-tools	GitHub 仓库	图片选择卡 + 回复内嵌图片 + 盲模型收图
dsh-plugin-table-zoom	GitHub 仓库	聊天长表格浮窗查看 + 一键复制 Markdown
dsh-plugin-windows-guard	GitHub 仓库	Windows 环境防坑：守则技能 + 乱码检测 / 危险写拦截 / 编码诊断修复
dsh-plugin-context-trim	GitHub 仓库	会话注入门控：skill / tool / 提示词段落按会话裁剪
dsh-plugin-future-session	GitHub 仓库	现实/未来会话：工具调用由继承全部上下文的未来会话代执行，主上下文只保留「一次调用+一份结论」

插件（npm）	GitHub	说明
dsh-notify	GitHub 仓库	Windows 原生通知
dsh-plugin-choice-refresh	GitHub 仓库	选择增强：重新生成选项 / 更多选项
dsh-plugin-image-tools	GitHub 仓库	图片选择卡 + 回复内嵌图片 + 盲模型收图
dsh-plugin-table-zoom	GitHub 仓库	聊天长表格浮窗查看 + 一键复制 Markdown
dsh-plugin-windows-guard	GitHub 仓库	Windows 环境防坑：守则技能 + 乱码检测 / 危险写拦截 / 编码诊断修复
dsh-plugin-context-trim	GitHub 仓库	会话注入门控：skill / tool / 提示词段落按会话裁剪
dsh-plugin-future-session	GitHub 仓库	现实/未来会话：工具调用由继承全部上下文的未来会话代执行，主上下文只保留「一次调用+一份结论」

Pasumao/dsh-plugin-dev-kb

dsh-plugin-dev-kb

这是什么

功能

30 秒验证装好了

配置

安装 / 挂载

5 分钟验证

目录结构

使用

自检

更新知识库

相关插件

AI 生成声明

License

Community comments

Pasumao/dsh-plugin-dev-kb

dsh-plugin-dev-kb

这是什么

功能

30 秒验证装好了

配置

安装 / 挂载

5 分钟验证

目录结构

使用

自检

更新知识库

相关插件

AI 生成声明

License

Community comments