前言¶
用 DeepSeek Harness(下文简称 DSH)做智能体开发时,常有这样的需求:主会话正在推进任务,中途想单独问 DeepSeek 一个问题——确认一个 API 细节、换个角度讨论一段实现——又不希望这些问题混进主会话、占用上下文。常见的替代做法是另开一个网页聊天窗口,但要在工作界面和聊天页之间来回复制粘贴,想引用主会话里的一段文字也很绕。
下面介绍的 dsh-deepseek-chat 是针对这个场景的 DSH 插件:在 Web UI 里添加一个独立的「问 DeepSeek」聊天窗口,主会话选中文字可直接引用提问,插件对话与主 Agent 会话互不干扰。
这是什么¶
dsh-deepseek-chat 由 lhenlihai-hub 维护,MIT 许可证,当前版本 0.2.2。一句话定位:为 DeepSeek Harness Web UI 添加一个独立的「问 DeepSeek」聊天窗口。
DSH 的理念是「一切皆插件」,界面扩展通过插件机制挂进 Web UI 即可。这个插件的特点是复用你已经在 dsh 里配置好的 DeepSeek 模型:所有请求通过 dsh 的 ctx.llm,使用用户已配置的 DeepSeek 路由和模型,不需要单独输入 API Key。
核心功能¶
插件已实现的能力如下:
- 点击页面右侧,打开独立「问 DeepSeek」聊天窗口;
- 从窗口顶部切换用户已配置的 DeepSeek 模型;
- 主会话中选中文字,可直接「引用并问 DeepSeek」;
- 支持流式输出、思考过程、停止生成和新对话;
- 自动适配中文/英文界面与明暗主题。
插件对话与主 Agent 会话相互独立,关闭或新建插件对话不会修改主会话。
API 与隐私方面:插件没有 API Key 输入框,不会读取、保存或向浏览器发送 API Key。如果尚未配置 DeepSeek,插件只会提示前往 dsh 的「设置 → 模型」。
安装与启用¶
已有 dsh 命令的,先安装插件:
dsh plugin --profile web add github:lhenlihai-hub/dsh-deepseek-chat
再启动 Web UI:
dsh web
使用官方 npx 启动方式、没有全局 dsh 命令的,改用:
npx --yes --package @deepseek-ai/dsh --package pnpm dsh plugin --profile web add github:lhenlihai-hub/dsh-deepseek-chat
然后启动:
npx @deepseek-ai/dsh web
如果 Web UI 正在运行,安装后需先停止再重新启动,重启后生效。整个安装过程不需要下载压缩包、克隆仓库或在本地构建。
典型用法¶
1、安装并重启 Web UI 后,点击页面右侧的「问 DeepSeek」,打开独立聊天窗口。
2、配置了多个 DeepSeek 模型时,从窗口顶部切换。
3、在主会话中选中一段文字,可直接「引用并问 DeepSeek」,选中的内容作为引用进入插件窗口,补充你的问题即可。
4、生成过程中可随时停止;想换话题就新建一个插件对话,主会话不会受影响。
开发¶
想在源码层面检查或修改时,仓库提供标准脚本:
npm install
npm run typecheck
npm run build
lib/ 目录是预构建产物,供 GitHub 直接安装使用,正常安装不需要在本地执行构建。
适用场景与注意¶
适合已经在 DeepSeek Harness 中正常使用 DeepSeek、希望有一个不干扰主会话的独立提问窗口的开发者。已经配置好 DeepSeek 的话,安装并重启 Web UI 后即可直接使用,不会再次要求输入 API Key。
安装前注意两点:
1、插件以当前 dsh 进程的权限运行,安装前建议先查看仓库源码与许可证(MIT),确认可以接受再安装。
2、插件声明 peerDependencies 要求 react ^18.2.0。
卸载¶
在插件窗口打开「设置 → 卸载插件 → 确认」,或执行:
dsh plugin --profile web remove dsh-deepseek-chat
没有全局 dsh 命令时:
npx --yes --package @deepseek-ai/dsh --package pnpm dsh plugin --profile web remove dsh-deepseek-chat
重启 Web UI 后生效。
小结¶
经过上面的步骤,你可以在 DeepSeek Harness Web UI 里得到一个独立、可引用主会话文字、复用已有模型配置的「问 DeepSeek」窗口,且不影响主 Agent 会话。插件很小,装上重启就能用。
- 社区插件目录页(独立站点):https://www.skillhub.cn/plugins/lhenlihai-hub/dsh-deepseek-chat
- GitHub 仓库:https://github.com/lhenlihai-hub/dsh-deepseek-chat