前言¶
DeepSeek Harness (DSH) 采用插件化架构，强调“一切皆插件”。在智能体开发或长期对话过程中，频繁在主窗口和浏览器其他标签页之间切换会影响效率。本插件旨在解决这一问题，为 Web GUI 提供一个悬浮的 Picture-in-Picture 聊天窗口，使开发者可以在不离开当前上下文的情况下查看流式回复、切换会话或发送指令。
这是什么¶
这是由 syncended 维护的一个浏览器插件，为 DeepSeek Harness Web GUI 增加了一个紧凑的聊天界面。该界面支持原生悬浮、会话切换、流式传输跟随以及即时回复，同时保持与主窗口的会话状态同步。
核心功能¶
插件提供了一套针对多任务处理的控制与展示能力：
-
会话管理与状态
- 提供会话切换器，显示当前会话的实时状态（工作/等待/完成）。
- 支持按工作区分组的人类聊天切换（排除内部子代理会话）。
- 提供“新聊天”操作，用于打开或创建当前工作区的空白会话。
-
聊天交互与控制
- 支持 Markdown 紧凑型转录，包含流式推理、工具活动日志、结果展示、历史图片以及复制、分支和加载更旧历史的功能。
- 提供停止生成功能，以及队列消息的编辑、移除和“立即发送”控制。
- 支持内联审批、计划审查和结构化用户问题面板。
-
输入与展示
- 支持图片附件预览，并通过公共会话 API 提交图片+文本。
- 在紧凑编辑器内提供访问模式、计划模式、模型选择、推理努力和上下文控制。
- 显示紧凑的上下文信息、轮次/步骤数、吞吐量、缓存命中率和输入/输出令牌统计。
-
兼容性与辅助功能
- 多语言支持：响应式同步 Harness 设置中的语言选择（英语、中文），并在兼容主机上提供俄语回退文本。
- 多主题与无障碍：支持深色主题同步，包含完整的键盘快捷键（Enter 发送，Shift+Enter 换行）和屏幕阅读器标签。
- 降级方案：原生 Document Picture-in-Picture API 仅在支持的 Chromium 浏览器上可用。当 API 不可用或被拒绝时，会自动回退到页面内浮动面板。
安装与启用¶
插件通过 npm 包发布，使用 DSH 的 Web profile 进行加载。
- 确保已安装 DeepSeek Harness 0.1.0-rc.6 或兼容版本，并运行 Web profile (
dsh web)。 - 执行安装命令：
dsh plugin --profile web add @syncended/dsh-pip
- 安装完成后，重启
dsh web并刷新现有的 GUI 界面。右下角将出现一个聊天气泡按钮，点击即可打开悬浮窗口。
典型用法¶
- 点击右下角的聊天气泡按钮打开悬浮窗口。
- 在悬浮窗口中切换会话、编辑队列消息或发送即时回复。
- 使用键盘快捷键：
Shift+Enter插入新行，Enter发送消息。
适用场景与注意¶
- 环境要求：需要 Node.js 18 或更新版本。
- 浏览器限制：原生 PiP 窗口仅在支持的 Chromium 浏览器上可用，其他浏览器会使用页面内的备用面板。操作系统和浏览器将控制原生 PiP 窗口的帧、外角形状和最终位置。
- 功能取舍：通用工具行设计为紧凑，主 Harness 窗口更适合深入检查大型工具负载。
- 安全提示：插件以当前 DSH 进程的权限运行。在安装前，建议检查源码与许可证（MIT）。
结语¶
该插件通过将聊天界面从主窗口剥离并悬浮，降低了多任务处理的视觉干扰。它通过会话同步、即时控制和流式转录等功能，使开发者能够更专注于当前的工作流。更多细节与源码请访问 GitHub。
