DeepSeek Harness (DSH) 的 Agent 模式悬浮窗。这是一个可自由拖动的 Web-UI 面板，用于在「本机提示词」与 13 个归档的编码 Agent CLI 提示词之间切换当前会话的系统提示词。
在调试或对比不同 Agent 的行为时，频繁修改系统提示词会打断工作流。这个插件提供了悬浮窗，将切换过程图形化，同时确保会话日志的完整性与安全性。
插件简介¶
这是一个为 DeepSeek Harness (dsh) 插件生态设计的组件，由 deepseekharness 维护。它通过一个悬浮面板，允许用户在 DeepSeek Harness 的默认提示词与 13 个主流编码 Agent 的归档提示词之间快速切换。
核心功能¶
- 可自由拖动的悬浮窗：支持按住窗口任意位置拖动，收起后的胶囊状态也可拖动。
- 位置与状态记忆：窗口的位置和开合状态会自动保存在浏览器本地存储中，刷新页面或重开会话后自动恢复。
- 一键回到默认位置：提供标题栏控件，可一键将窗口复位到默认右上角位置。
- 实时状态：当前模式与 Host 侧会话投影实时同步，不依赖轮询，切换后即时生效。
- 会话日志安全：通过官方
/agent命令执行切换，日志中记录的是标准的 Agent 选择卡片，可追溯、可复现。 - 中英双语：界面语言随 DSH 的语言设置自动切换。
- 热更新友好：在开发模式下，修改
client.js后会自动热重载，无需重启。 - 零网络、零文件写入：不联网、不注册工具、不注入提示词正文、不修改已有日志内容。
安装与启用¶
使用 DSH 的插件命令安装此包：
dsh plugin --profile <profile> add agent-mode-change
安装完成后，刷新 Web 页面即可看到悬浮窗（默认位于右上角）。
典型用法¶
| 操作 | 效果 |
|---|---|
| 点任意一行 | 切换当前会话的模式（从下一步生效） |
| 按住窗口任意位置拖动 | 移动悬浮窗（列表滚动条除外） |
点标题栏 – |
收起为一枚显示当前模式的小胶囊 |
| 点胶囊 | 展开 |
点标题栏 ⊙ |
回到默认位置（右上角） |
按 Escape |
收起 |
适用场景与注意¶
此插件适合需要频繁对比或复现不同 Agent 行为的开发者。
前置依赖：
* 需要已安装并启用 @deepseek-ai/dsh-agent-emulation 包，这是提供 13 个归档提示词的来源。
* 仅支持 Web 平台。
* Node 版本要求 ≥ 20。
权限与副作用：
* 插件仅执行 /agent 命令，不复制、不转发任何提示词正文到网络或文件系统。
* 不修改已有的会话日志内容，日志始终作为唯一真源。
* 不做任何网络请求。
总结¶
该插件通过一个轻量级的悬浮窗，解决了 DeepSeek Harness 中切换 Agent 模式的操作成本问题，同时严格遵守了「零副作用」原则，确保了会话日志的纯净与安全。
