dsh-plugin-kit · DSH 插件全家桶

中文 | English

仓库门禁：pnpm typecheck / pnpm build / pnpm aggregate。

DeepSeek Harness（DSH）Web GUI 的插件全家桶
环境变量 · MCP 服务器 · Prompt · Profile · RSS · 全局搜索 · Codegraph 集成 · 插件脚手架

是什么 · 功能插件 · 快速开始 · 开发新插件 · 常见问题 · 已知限制 · 参与贡献

是什么

dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合：环境变量 / 密钥管理、MCP 服务器配置、Prompt 管理、Profile 管理、RSS / 新闻聚合、全局搜索、Codegraph 集成，外加一条命令生成新插件的开发脚手架。所有插件都走官方 profile 机制挂载到 dsh web，不改 DSH 源码；可以逐个安装，也可以用聚合包一次装齐。

功能插件

环境变量 / 密钥管理（@hyzyn/dsh-env）

• 做什么：在 Web GUI 里增删改环境变量和密钥，保存后立即写入当前进程的 process.env，宿主和之后启动的子进程都能读到，无需重启。
• 怎么用：打开 设置 → 插件 →「环境变量 / 密钥管理」→ 添加键值 →（敏感条目勾选「密钥」，以密码框显示）→ 保存。
• 支持：普通字符串；js: 前缀表达式（如 js:process.env.API_KEY）；密钥标记。
• 存哪里：~/.dsh/env.yml 的托管区块（自动生成，请勿手改）。
• 注意：键名只允许字母 / 数字 / 下划线，且不能重复。

MCP 服务器配置（@hyzyn/dsh-mcp）

• 做什么：给 DSH 添加 MCP 服务器，保存后 1~2 秒内热加载为 mcp__<服务器名>__<工具名> 工具，模型即可直接调用，无需重启。
• 怎么用：打开 设置 → 插件 →「MCP 服务器配置」→ 添加服务器（选传输方式）→（建议先点「连接测试」）→ 保存。
• 支持：两种传输——stdio（本地子进程，如 npx -y @modelcontextprotocol/server-filesystem）与 streamable-http（远程服务）；js: 前缀表达式（如 js:process.env.GITHUB_TOKEN）；启用 / 停用、编辑、删除；状态徽章。
• 存哪里：~/.dsh/cordis.patch.yml 的托管区块。
• 注意：不要手工往该文件里追加插件行，否则启动时报 duplicate loader entry id 直接退出。

Prompt 管理（@hyzyn/dsh-prompt）

• 做什么：可视化编辑 systemPrompt，启用后其内容作为 systemPrompt section 注入，保存即生效。
• 怎么用：打开 设置 → 插件 →「Prompt 管理」→ 新建 / 编辑 Prompt（可保存多个版本）→ 启用。
• 支持：版本切换 / 回滚；A/B 测试（为同一 Prompt 选 A/B 两版并按权重随机命中）；导出 JSON / Markdown、一键复制分享、从 JSON 导入。
• 存哪里：~/.dsh/prompts.yml 的托管区块。
• 注意：每个 Prompt 至少一个版本，单版本内容 ≤ 500KB。

Profile 管理（@hyzyn/dsh-profile）

• 做什么：可视化查看 ~/.dsh/profiles 下的全部 DSH profile，支持创建、复制、重命名、删除，方便维护多套 DSH 环境。
• 怎么用：打开 设置 → 插件 →「Profile 管理」→ 查看 profile 列表 → 新建 / 复制 / 重命名 / 删除；可为每个 profile 设置端口并复制带 --port 的启动命令。
• 支持：初始化状态、bundle 层与依赖展示；基础模板 / web / headless 模板新建；复制排除 node_modules 与锁文件并自动安装依赖；重命名；端口配置与复制启动命令。
• 存哪里：直接管理 ~/.dsh/profiles/<name> 目录。
• 注意：删除为递归删除，操作前请二次确认；内置的 web 默认 profile 不允许删除，headless 可以删除；新建后首次使用 dsh plugin --profile <name> add ... 时按需安装依赖。

全局搜索（@hyzyn/dsh-search）

• 做什么：在 Web GUI 侧边栏加一个「全局搜索」入口，输入关键词后同时搜索历史会话、Prompt 管理里的提示词和当前已加载的 MCP 工具。
• 怎么用：安装后在侧边栏「新建会话」下方点击 / 聚焦全局搜索框 → 输入关键词 → 点击会话会打开并尝试定位到匹配文字；点击 Prompt / MCP 工具会尝试跳转到对应设置卡片，跳转失败时自动复制内容 / 工具名。
• 支持：历史会话全文搜索（走 DSH 自带 sessionQuery 索引）；Prompt 名称 / 描述 / 版本内容；mcp__ 前缀 MCP 工具；单类结果数量可配置；结果关键词高亮。
• 存哪里：无独立配置；Prompt 读取 ~/.dsh/prompts.yml 的托管区块。
• 注意：需要宿主已安装 sessionQuery / tools 服务；缺失时对应类别返回空列表，不影响其它类别。若 session-query 全文索引配置为 openAt: "never"，历史会话会自动降级为逐会话扫描；会话结果会过滤为当前可跳转的可见会话。

Codegraph 集成（@hyzyn/dsh-codegraph）

• 做什么：代码图谱集成——设置 → 插件 里的「Codegraph」卡片提供索引状态、符号搜索、callers / callees / impact 查看和一键 sync / index；安装后自动向 systemPrompt 注入 CodeGraph 使用指引，模型在已索引项目里优先用 codegraph_explore / codegraph explore 查询代码而不是 grep / read。
• 怎么用：打开 设置 → 插件 →「Codegraph」→ 查看索引状态、搜索符号、点击结果查看源码与调用链 / 影响面、手动 Sync / 重建索引。
• 支持：索引状态（版本、文件 / 符号 / 边数量、最后索引时间、待同步变更）；符号搜索与 node / callers / callees / impact 详情；默认路径跟随当前活动会话的工作目录（切换项目会话自动切换，手动输入可临时覆盖）；一键增量 sync 与全量重建。
• 存哪里：索引在项目 .codegraph/ 目录（由 codegraph index 生成）；插件无独立配置文件。
• 注意：查询目标项目需要先有 Codegraph 索引；未索引项目会返回指引改用常规工具。索引 / 重建为本地 CLI 操作，消耗真实磁盘与 CPU。

RSS / 新闻聚合（@hyzyn/dsh-rss）

• 做什么：订阅多个 RSS / Atom 源，每天自动汇总成一篇「今日值得读」Markdown，并注入 systemPrompt 供模型直接引用。
• 怎么用：安装后可在侧边栏「新建会话」下方点击「今日值得读」直接查看新闻；也可打开 设置 → 插件 →「RSS / 新闻聚合」勾选内置渠道、添加自定义渠道（保存时即时校验地址）、维护新闻分类与聚合设置，保存后自动刷新。
• 内置渠道：阮一峰、少数派、Solidot、Hacker News、掘金、IT之家、36氪（36氪官方 feed 被反爬拦截，内置为第三方 RSSHub 镜像），勾选即展示、取消勾选即不抓取。
• 自定义渠道：填写任意 RSS / Atom 地址，保存时真实抓取校验——官网首页、非 feed、抓不到内容的地址会报错且不保存。
• 新闻分类：渠道的分类从「新闻分类」列表里选择；digest（Markdown、systemPrompt、弹窗）按分类分组展示，保存时自动把使用中的分类合并进列表。
• 支持：RSS 2.0 / Atom 解析、按来源去重、每源条数限制、每日定时生成、启动补生成、自定义输出目录、内置渠道库。
• 存哪里：~/.dsh/rss-digest/YYYY-MM-DD.md（可用 DSH_RSS_DIGEST_DIR 覆盖）。
• 注意：首次安装启动时会联网抓取一次；某个源不可达时会在 digest 的「抓取失败」里列出，不影响其它源。

快速开始

系统要求

• 已安装 DeepSeek Harness，dsh web 可正常启动。
• npm 安装方式无额外要求；从仓库安装需要 Node.js >= 22.19 与 pnpm 10。

三步上手

1. 安装聚合包：dsh plugin --profile web add @hyzyn/dsh-all
2. 重启 dsh web，设置 → 插件 里出现全部管理卡片
3. 打开「设置 > 插件」按需使用各卡片，保存后即时生效

从 npm 安装（推荐）

插件已发布到 npm（@hyzyn scope），一条命令装齐：

dsh plugin --profile web add @hyzyn/dsh-all

装完重启 dsh web，打开 设置 → 插件 即可看到全部卡片。只想用某一个插件，见下文「单独安装某个插件」。

从 GitHub 仓库安装（开发调试）

插件包已在 npm 发布，仓库安装仅供开发调试（需要 Node.js >= 22.19 与 pnpm 10）：

# 1. 克隆仓库
git clone https://github.com/hyzyn/dsh-plugin-kit.git
cd dsh-plugin-kit

# 2. 安装依赖并构建
pnpm install
pnpm build

# 3. 把全家桶链接进 web profile
dsh plugin --profile web add link:$(pwd)/packages/all

# 4. 重启 dsh web
dsh web

只想用某个子包：第 3 步改为 dsh plugin --profile web add link:$(pwd)/packages/<name> 即可，例如 packages/mcp。

单独安装某个插件

不想装全家桶时，可单独安装任意插件（npm 已发布，直接用包名）：

dsh plugin --profile web add @hyzyn/dsh-env     # 环境变量 / 密钥管理
dsh plugin --profile web add @hyzyn/dsh-mcp     # MCP 服务器配置
dsh plugin --profile web add @hyzyn/dsh-prompt  # Prompt 管理
dsh plugin --profile web add @hyzyn/dsh-profile # Profile 管理
dsh plugin --profile web add @hyzyn/dsh-rss     # RSS / 新闻聚合
dsh plugin --profile web add @hyzyn/dsh-search  # 全局搜索
dsh plugin --profile web add @hyzyn/dsh-codegraph # Codegraph 集成

验证与卸载

装好重启 dsh web，打开 设置 → 插件 出现对应卡片就是生效了；也可以用 dsh --profile web --dump-config 确认插件配置层已挂载。卡片没出现，多半是装完没重启 dsh web。

卸载：dsh plugin --profile web remove @hyzyn/dsh-all（或对应的 @hyzyn/dsh-<包名>），然后重启 dsh web。

安装排障

开发新插件

pnpm create-plugin <name> [id]
# 例：pnpm create-plugin timer          → packages/timer（@hyzyn/dsh-timer，插件 id: timer）
# 例：pnpm create-plugin pet-tracker pt → packages/pet-tracker（插件 id: pt）

脚本会复制 packages/hello 模板、替换包名与插件 id，并自动更新聚合包。然后：

1. 编辑 packages/<name>/src/index.ts 写插件逻辑；
2. 构建并本地安装调试：

pnpm --filter @hyzyn/dsh-<name> build
dsh plugin --profile web add link:$(pwd)/packages/<name>

插件包长什么样（以 hello 为例）

服务注入两种写法：inject: ['tools', 'webServer'] 后直接 ctx.tools；或运行时 ctx.get('tools') 判空。配置用 schemastery 导出同名 Config schema。

常见问题

已知限制

• MCP 的 ~/.dsh/cordis.patch.yml 里托管区块只应放服务器配置；手工追加插件行会导致 duplicate loader entry id 启动失败。
• Profile 删除为递归删除，面板内会二次确认，但一旦执行不可撤销；内置 web profile 受保护，headless 可删。
• RSS 首次启动需要联网抓取；某个源不可达不会阻塞其它源，但当天 digest 可能缺少该源内容。
• 浏览器半体依赖官方 dsh-web-app 的设置面板 slots 服务，非官方 Web GUI 可能不显示管理卡片。
• 仓库安装需要 Node.js >= 22.19 与 pnpm 10，仅供开发调试；npm 安装不受影响。

参与贡献

• 新插件用脚手架生成：pnpm create-plugin <name> [id]，避免手写样板。
• 提交信息遵循 Conventional Commits（如 fix(mcp): 修复连接测试超时），用户可见变更请附截图或验证证据。
• 提交前过门禁：pnpm typecheck && pnpm build && pnpm aggregate。
• 增删插件后记得跑 pnpm aggregate 重新生成 packages/all 聚合清单。

许可证

本仓库以 MIT 授权。

贡献者