dsh-docs-reader
DSH 开发文档阅读器与知识图谱插件：在 DSH Web 左侧边栏提供「开发文档」入口——目录树 + 文档阅读 + 检索 + 知识图谱。
数据动态读取运行环境中 dsh 仓库的 docs/ 目录与 packages/preset/agent-preset/skills/ 技能库（不随插件打包），仓库文档更新后重启 dsh web 即生效。
功能预览
文档界面 1
文档界面 2
知识图谱 1
知识图谱 2
功能
- 左侧边栏入口「开发文档」（底部，
sidebar.panellist 槽位）
- 文档目录树（分组折叠、层级缩进、中英文标题按文档语言显示）
- Markdown 渲染阅读（代码块 / 表格 / 标题层级 / 中英切换）
- 全文搜索（标题 / 路径）
- 知识图谱（ECharts 5.5.1 内联、离线可用）：总览力导向 → 点击节点高亮节点与边 → 右侧预览摘要 → 引用关系浏览
- 右侧栏：本页目录 / 路径 / 引用文档 / 被以下文档引用（点击即跳转定位）
文件结构
dsh-docs-reader/
├── package.json # dsh.bundle.patch + dsh.client(注入 @deepseek-ai/dsh-api-gateway)
├── cordis.patch.yml # 插件行: id=dsh-docs-reader / name=dsh-docs-reader
├── index.js # Host: DocsReader 服务类(default export), 扫描/读取/搜索 docs
├── client.js # Client: __ModuleLoader__ 懒工厂, 侧边栏入口 + 主面板 + 图谱(内联 ECharts)
├── icon.svg # 插件卡片图标
├── img/ # 项目截图(功能预览)
├── LICENSE # MIT
└── locale/
├── zh.json
└── en.json
安装
说明:当前仅支持 GitHub / 本地路径安装。插件尚未发布到 npm registry,因此 dsh plugin add dsh-docs-reader(npm 包名方式)暂不可用;待后续发布 npm 后开放。
方式 A：从 GitHub 安装（推荐）
dsh plugin --profile web add github:als3453/dsh-docs-reader
插件为纯 JavaScript、无构建脚本，git 安装即用，无需 pnpm 构建授权。安装后重启 dsh web。
方式 B：本地路径安装（适合离线 / 手动安装）
dsh plugin --profile web add link:<解压路径>
从 GitHub 下载 ZIP 解压后，将解压后的文件夹路径填入 <解压路径>（例如 D:\Downloads\dsh-docs-reader）；开发调试本地插件也走此方式。
方式 C：DSH 内 install_bundle
在 DSH 中调用插件管理工具：
plugin_manager → action: install_bundle → target: <插件包绝对路径>
安装后确认行激活（application: applied），侧边栏底部出现「开发文档」入口。
备注：以上命令中的 web 是 DSH 最常用的 profile 名。如果你的环境 profile 名不是 web（可用 dsh profile list 查看），把命令中的 web 换成你自己的 profile 名即可。
数据源与配置
插件默认读取插件包所在仓库的两个数据源：
| 数据源 | 默认路径 | 说明 |
|---|
| 开发文档 | ../../docs/ | 仓库 docs 目录（相对插件包） |
| 技能库 | ../../packages/preset/agent-preset/skills/ | 内置 Skill 文档（SKILL.md + references） |
通过 config.root / config.skillsRoot 可覆盖数据源路径（相对/绝对均可），在插件行的 patch 层或 profile 的 cordis.patch.yml 中配置：
- override:
- id: dsh-docs-reader
config:
root: /path/to/deepseek-harness/docs
skillsRoot: /path/to/deepseek-harness/packages/preset/agent-preset/skills
兼容性说明
- 依赖的
@deepseek-ai/dsh-typert-protocol、@deepseek-ai/dsh-api-gateway 均为 dsh 内置包，从 dsh 安装解析，插件包不声明依赖（符合官方 bundle 范式）。
- 样式使用
--dsw-alias-* 主题 token + 深色兜底，适配宿主明暗主题；未引入任何 Harness Client 包。
卸载
dsh plugin --profile <name> remove dsh-docs-reader
或 DSH 内 plugin_manager → remove_bundle。
