前言¶
用 DeepSeek Harness(DSH)做智能体或插件开发时,经常要对照官网聊天页查文档、试提示词,或随手问一句。切到系统浏览器再切回来,窗口和当前 Harness 会话是两套上下文,容易打断节奏。也有人会在侧边开第二个浏览器标签,但那样仍然和 DSH 里的任务编排、插件面板分离。
下面介绍社区插件 dsh-chat-in-harness(维护者 qcann,分类:客户端):在 DSH 桌面端里放一个与会话无关的浮窗,直接加载 chat.deepseek.com。页面由官网自己在 <webview> 里跑;插件通过 DSH 自带的浏览器桥拿租约并做顶层导航,不替官网代劳接口与登录逻辑。
这是什么¶
dsh-chat-in-harness 的定位可以概括成一句话:把 chat.deepseek.com 装进一个与会话无关的浮窗,用 DSH Desktop 的 webview 能力打开官网,而不是在 Harness 里再实现一套 Chat API 客户端。
- 仓库:qcann/dsh-chat-in-harness
- 社区目录:skillhub.cn 插件页
- 许可证:MIT(见仓库
package.json) - 当前资料中的版本号:1.0.1
插件以当前 DSH 进程的权限运行;安装前建议自行浏览源码与许可证。本项目为非官方社区作品,与 DeepSeek 无关联。
它不做什么¶
README 用表格说明边界,比功能列表更值得先读一遍:
| 不做 | 说明 |
|---|---|
| 不调接口 | 不碰 /api/v0/*,不构造请求,不解析响应 |
| 不存凭据 | 不读网页 cookie / localStorage,不做快照;仅在 DSH 自己的 localStorage 记窗口布局(位置、尺寸、缩放、透明度) |
| 不注入脚本 | 不注入、不执行额外脚本 |
| 不改指纹 | 仅从 UA 去掉 Electron/x.y.z,其余原样(避免官网误判「环境异常」) |
| 不批量操作 | 无并发队列、无重试风暴 |
理念上是「在用户和官网之间不加一层」:能做到很多事,只保留浮窗与导航必需的部分。
核心功能¶
经资料核实,插件提供的能力包括:
浮窗与布局
- 两行头部:标题区(鲸鱼图标 + Chat / 缩放 / 不透明度 / 铺满 / 收起)、导航区(后退 / 前进 / 刷新 / 地址栏 / 在系统浏览器打开)
- 拖动、缩放、位置记忆;边缘吸附;双击标题栏或点「铺满」在铺满与还原间切换
×收起:若设置里启用悬浮球则收成球,否则直接隐藏- 左下角 Chat 胶囊入口
设置
- 设置页两个开关:左侧栏入口、启用悬浮球
- 状态卡展示尺寸 / 缩放 / 不透明度;支持重置窗口
- 界面语言跟随 DSH:中文以外显示英文
导航与安全
- 链接白名单:仅放行
deepseek.com及子域,其余链交给系统浏览器
安装与启用¶
环境要求(来自 package.json 与 README):DSH ≥ 0.2.1-rc.1、Node ≥ 20。仅桌面端;Web 版 DSH 没有 <webview> 宿主,无法使用本插件。
方式一:从仓库安装(跟随默认分支)
dsh plugin --profile desktop add https://github.com/qcann/dsh-chat-in-harness
方式二:使用 Release 预构建包(latest 指向最新版本)
dsh plugin --profile desktop add https://github.com/qcann/dsh-chat-in-harness/releases/latest/download/dsh-chat-in-harness.tgz
装完后重启 DSH 使插件生效。
典型用法¶
- 按上文命令为 desktop profile 安装插件并重启 DSH。
- 在左下角点 Chat 胶囊,或从设置里打开左侧栏入口,唤出浮窗。
- 在浮窗地址栏内使用
chat.deepseek.com(及允许的子域);需要完整桌面浏览器体验时,点「系统浏览器」。 - 按需调整缩放、不透明度、是否启用悬浮球;关闭窗口时布局会写入 DSH localStorage,下次打开仍记得位置与尺寸。
- 要在网页内切换账号:使用官网自己的退出入口,或重启 DSH(浏览器租约为进程内分区,cookie 不落盘,重启后为干净分区——这是 DSH 行为,插件不绕过)。
复制内容时:网页内「复制」按钮可能不可用(DSH 拒绝 guest 的 navigator.clipboard);选中文字后用 Ctrl+C(macOS 为 Cmd+C)可走原生复制路径。
适用场景与注意¶
适合谁
- 主要在 DSH Desktop 上开发、调试,希望旁边常驻官网 Chat,且不希望插件代为调用 API 或保管登录态的开发者。
已知边界(摘自 README)
- 平台:Windows 已实测;macOS / Linux 未实机验证,不承诺与 Windows 完全一致。
- 重启 DSH 需重新登录官网 Chat:租约分区在内存,cookie 不落盘。
- 焦点在网页内时,DSH 全局快捷键不生效。
- 层级:浮窗
z-index: 60,会被菜单(100)与模态框(1000)盖住。 - 插件没有单独的「退出登录」按钮,依赖官网或重启 DSH。
风险声明(维护者在 README 中的表述)
- 不代理、不转发、不存储用户数据;在第三方容器访问站点是否符合服务条款,需自行确认。
- 限流、官网改版、DSH 升级都可能影响可用性;使用风险自负。
DeepSeek Harness 生态以「一切皆插件」为方向;skillhub.cn 等目录为社区站点,与 DeepSeek / 幻方无官方从属关系。本插件同样为社区维护,安装前审阅源码是合理做法。
结尾¶
dsh-chat-in-harness 解决的是「在 Harness 桌面工作流里并排打开官网 Chat」这一件事:浮窗、布局记忆、白名单导航,并把接口、凭据、脚本注入一律留在插件外。若你需要的是 API 级集成或会话绑定的 Chat,应选其他类型的 DSH 插件;若只需要官方页面、且接受桌面端与上述边界,可按 README 中的安装命令试用。
- 目录页:https://www.skillhub.cn/plugins/qcann/dsh-chat-in-harness
- GitHub:https://github.com/qcann/dsh-chat-in-harness