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

中文 | English

       

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

<strong>DeepSeek Harness（DSH）Web GUI 的插件全家桶</strong><br> <em>环境变量 · MCP 服务器 · Prompt · Profile · RSS · 全局搜索 · Codegraph 集成 · 终端面板 · 插件脚手架</em>

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

是什么

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

能力	原生 dsh web	dsh-plugin-kit 全家桶
环境变量管理	命令行 / 手改配置	Web GUI 卡片，保存即写入 process.env
MCP 服务器	手改 patch / 命令行	可视化卡片 + 连接测试 + 保存后热加载
Prompt 管理	手改配置	可视化编辑 + 版本管理 / A/B 测试 / 导出分享
Profile 管理	命令行	可视化创建 / 复制 / 重命名 / 删除
RSS 聚合	无	多源订阅 + 每日「今日值得读」自动摘要
全局搜索	仅会话标题/内容	侧边栏统一全文搜索历史会话、Prompt、MCP 工具与设置面板
Codegraph 集成	无	代码图谱卡片：索引状态 / 符号搜索 / 调用链 / 影响面 / 一键 sync-index
终端面板	无	侧边栏「终端」入口 + xterm.js 大弹窗：真实 PTY 交互终端（vim/htop/dev server）
插件开发	手写样板	pnpm create-plugin 脚手架 + @hyzyn/dsh-kit 类型助手

功能插件

环境变量 / 密钥管理（@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 侧边栏加一个「全局搜索」入口，输入关键词即可全文搜索历史会话与设置面板。
• 怎么用：安装后在侧边栏「新建会话」下方点击 / 聚焦全局搜索框 → 输入关键词 → 点击会话会打开并尝试定位到匹配文字；点击面板条目会直接跳转到对应设置卡片。
• 支持：历史会话全文搜索（走 DSH 自带 sessionQuery 索引）；设置面板搜索（官方面板恒可搜，插件面板按已安装动态过滤）；结果数量可配置；结果关键词高亮。
• 存哪里：无独立配置。
• 注意：需要宿主已安装 sessionQuery 服务；缺失时会话搜索返回空列表。若 session-query 全文索引配置为 openAt: "never"，历史会话会自动降级为逐会话扫描；会话结果会过滤为当前可跳转的可见会话。

Codegraph 集成（@hyzyn/dsh-codegraph）

…