Agent 模式悬浮窗 deepseekharness-dsh/agent-mode-change

Agent 模式切换

DeepSeek Harness 的 Agent 模式悬浮窗。 一个可自由拖动的 Web UI 面板，把当前会话的系统提示词在「本机提示词」与 13 个主流编码 Agent CLI 的归档提示词之间一键切换。

CI
npm
npm downloads
license
node

语言 / Language： 中文 ｜ English：GitHub · Gitee

状态： ✅ 已发布 npm agent-mode-change@1.0.0 · CI 通过 · Node ≥ 20 · MIT

关键词： DeepSeek Harness · dsh · dsh-plugin · Cordis · AI Agent · Coding Agent · System Prompt · Prompt Engineering

仓库： GitHub ｜ 镜像 Gitee ｜ npm agent-mode-change

为什么需要它

同一套模型，在不同的编码 Agent 里被框定成完全不同的助手。想看清这件事，你得先能方便地来回切。

- 对照不同 Agent 的框法 —— Claude Code、Codex CLI、Antigravity、Grok、Kimi、MiniMax、opencode、Pi…… 逐个切换，同一个问题看它们各自怎么答。
- 提示词考古与复现 —— 归档提示词是定稿文本，可以长期复现某次采集下的行为，而不是随着上游逐版漂移。
- 不打断心流 —— 悬浮窗随时在侧，点一下即切，不必记住 /agent 的参数；收起后只剩一枚显示当前模式的小胶囊。

功能亮点

| 能力 | 说明 |
| 🪟 可自由摆放的悬浮窗 | shell.overlay 帧级浮动层；按住窗口任意位置即可拖动，收起后的胶囊也能拖 |
| 💾 位置与开合状态自动记忆 | 存在浏览器 localStorage，刷新、重开会话都还在原处；视图尺寸变化时自动夹回可视区 |
| 🎯 一键回到默认位置 | 标题栏 ⊙ 控件；Escape 直接收起 |
| 🔄 实时状态 | 当前模式来自 Host 侧会话投影，切换后即时更新，不轮询、不折叠会话事件 |
| 🧾 会话日志安全 | 切换走的是官方 /agent 命令本身，日志里留下的还是那张 /agent 卡片，可追溯、可复现 |
| 🌏 中英双语 | 两种界面语言随 dsh 语言设置切换 |
| ⚡ 热更新友好 | 开发时改 client.js，dsh 的 client-modules 会在浏览器里热重载 |
| 🔒 零网络、零文件写入 | 不联网、不注册工具、不注入提示词、不修改任何已有日志内容（详见权限与副作用） |

可切换的 13 个 Agent 模式

除默认模式外，窗口列出下列归档提示词（版本随 @deepseek-ai/dsh-agent-emulation 更新）：

| 模式 | 目录 id | 归档版本 |
| Claude Code | claude-code | 2.1.283 |
| Codex CLI | codex | 0.157.1 |
| Antigravity CLI | antigravity | 1.2.12 |
| Grok Build | grok | 1.0.41 |
| MiniMax Code | minimax-code | 3.0.74 |
| Kimi Code | kimi-code | 2.1.1 |
| MiMo Code | mimo | 0.1.13 |
| OpenClaw | openclaw | 2026.9.6 |
| Hermes Agent | hermes | v2026.9.24 |
| Kimi CLI | kimi | 1.51.0 |
| opencode | opencode | 1.18.32 |
| Pi | pi | 0.87.1 |
| Oh My Pi | omp | 18.3.5 |

以及第一行 DeepSeek Harness —— 本 harness 自己实时组装的系统提示词（默认模式，等价于 /agent off）。

说明：@deepseek-ai/dsh-agent-emulation 随包提供 14 份归档提示词，其中 dsh 那份与默认模式同名，因此不在列表中；需要那份定稿文本时用 /agent dsh 手动选择。

安装

1) 从 npm 安装（插件市场收录后也用这条命令）
dsh plugin --profile add agent-mode-change

2) 或从本地仓库安装
dsh plugin --profile add /absolute/path/agent-mode-change

安装完成后刷新一次 Web 页面即可看到悬浮窗（默认出现在右上角）。

使用

| 操作 | 效果 |
| 点任意一行 | 切换当前会话的模式 |
| 按住窗口任意位置拖动 | 移动悬浮窗（列表滚动条除外） |
| 点标题栏 – | 收起为一枚显示当前模式的小胶囊 |
| 点胶囊 | 展开 |
| 点标题栏 ⊙ | 回到默认位置（右上角） |
| 按 Escape | 收起 |

切换从下一步生效：会话正在跑的回合结束后即用新模式；如果此刻有回合在跑，命令结果里会写明「applies from the next step」。

工作原理

┌──────────────────────── DeepSeek Harness (Host) ────────────────────────┐
│ │
会话日志 │ agent-emulation/select ──▶ @deepseek-ai/dsh-agent-emulation │ (唯一真源)│ （自带 host-only 投影 agentEmulation） │ │ │ │ │ 本插件 Host 半边 ───────┘ 折叠同一事件 │ │ index.js → 投影 agentModeChange │ │ （客户端可见：当前选择 + 提示词目录） │ └───────────────────────────────────┬──────────────────────────────────────┘ │ 会话投影（拉/推都由框架负责） ┌───────────────────────────────────▼──────────────────────────────────────┐ │ 本插件 Client 半边 client.js │ │ shell.overlay 悬浮窗 ── 读投影 ──▶ 渲染当前模式与 13+1 行列表 │ │ │ │ │ └── 点选 ──▶ ctx.remote.commands.execute('/agent ') ───────────┼──▶ 官方 │ │ 命令 └───────────────────────────────────────────────────────────────────────────┘

- Host 半边（index.js）只注册一个客户端可见的会话投影 agentModeChange：折叠 agent-emulation/select，并把已安装的 dsh-agent-emulation 包里的 prompts/sources.json 目录一并投给浏览器。官方投影 agentEmulation 是 host-only（没有 client view），浏览器读不到当前选择；一个只有读视图的投影是最弱的补法 —— 它不写任何事件。
- Client 半边（client.js）在 shell.overlay 注册窗口：用 useSessions 找主视图会话，用会话绑定的 projections.faceOf() 读投影，用 ctx.remote.commands.execute() 执行 /agent 。localStorage 只存窗口自己的位置与开合状态。
- 因此会话日志始终是唯一真源：插件不新增事件类型、不改写历史，fork / resume 之后选择自然还在。

更细的数据流、不变量与能力对照表见 docs/ARCHITECTURE.md。

权限与副作用

| 类别 | 具体内容 |
| 执行 | 一条 host 命令（/agent off 或 /agent ，等价于用户在输入框手打）：产生普通的 command/run + command/done，选择变化时再产生一条 agent-emulation/select |
| 读取 | 一个会话投影（键 agentModeChange） |
| 写入 | 两个浏览器 localStorage 键：agent-mode-change/anchor、agent-mode-change/open |
| 不做 | ❌ 不联网　❌ 不读写文件　❌ 不注册工具　❌ 不注入提示词　❌ 不修改已有日志内容 |

兼容性

| 项 | 要求 |
| DeepSeek Harness | 开发版本 0.1.7-rc.2 |
| @deepseek-ai/dsh-agent-emulation | 必须已安装并启用 —— /agent 命令、emulate_agent 工具与提示词目录都由它提供。没有它时窗口仍会出现，但会提示命令不存在 |
| 客户端 | Web（dsh.client.platform: web） |
| Node | ≥ 20 |

常见问题

切换后为什么没立刻变？
选择从下一步生效。正在跑的回合会先跑完；命令结果会明确写「applies from the next step」。

会影响当前对话或历史记录吗？
不会。只替换系统提示词；工具、沙箱、会话日志都是本 harness 自己的，历史一条不动。

装完要重启 dsh 吗？
不用，插件行是热加载的；刷新一次浏览器页面即可看到窗口。

数据会上传到别处吗？
不会。插件不发起任何网络请求；它只是把已有的会话投影显示出来，并把你的点选翻译成一条本地命令。

为什么只有 13 个模式？
以 @deepseek-ai/dsh-agent-emulation 随包目录为准，与它保持同步；该包更新后列表自动跟随。

能加自己的提示词吗？
目前不行（见路线图）；上游包加上新目录条目后，这里会自动出现。

它和 /agent 命令冲突吗？
不冲突，它就是那条命令的图形化外壳：你手打 /agent 和点悬浮窗走的是同一条路径。

开发

git clone https://github.com/deepseekharness-dsh/agent-mode-change.git
cd agent-mode-change
npm test # node:test：投影折叠 + bundle 清单 + client 包静态检查

目录结构：

index.js Host 半边：会话投影 agentModeChange client.js Client 半边：shell.overlay 悬浮窗（纯浏览器模块，无构建步骤） cordis.patch.yml bundle 层：插入本插件的 Host 行
locale/{zh,en}.json 插件卡片的中英文标题与描述
test/*.test.mjs node:test 测试 docs/ARCHITECTURE.md 数据流、不变量、能力对照、测试覆盖 docs/RELEASING.md 发布流程（npm / GitHub / Gitee / 收录 PR）

本地联调：dsh plugin add /path/to/repo 装进任意 profile，或用 plugin_manager 的 install_bundle 指向该目录；client.js 的改动会被 client-modules 监听并热重载。

路线图

- [ ] 模式搜索 / 过滤框（列表变长后的检索）
- [ ] 键盘快捷键（不点鼠标即可切换）
- [ ] 自定义提示词目录（在随包目录之外挂自己的归档）
- [ ] 每个会话记忆展开/收起状态
- [ ] 更多客户端形态（非 Web）

语言 / Language： 中文 ｜ English：GitHub · Gitee

许可与致谢

MIT © deepseekharness。归档提示词文本的版权归各自厂商所有，采集自 phistory，由 @deepseek-ai/dsh-agent-emulation 随包提供；本插件只显示目录里的 id / 名称 / 版本，不复制、不转发任何提示词正文。

相关链接：DeepSeek Harness · dsh-agent-emulation ·
dsh 插件精选列表 ·
dshmarket · phistory