前言¶

在 DSH Desktop 里启用 ds-bot 后，同一套插件会提供两套界面：面向 Bot 的工作面，以及经典的 ADE（Agent Development Environment）界面。ds-bot 本身可以在两套界面之间切换，但没有常驻入口——从 Bot 面只能经账户菜单返回，从经典界面则要找 DS Bot 返回按钮。若你经常在两种界面间来回，这条路径会显得绕。dsh-bot-toggle 是 JackWoods-code 维护的 DSH 客户端插件，在 Web UI 右侧提供悬浮的双段胶囊开关，单击即可在 Bot 与 ADE 之间切换，且 不会卸载 ds-bot；它只是在 ds-bot 之上加一层 UI，不是替代品。

这是什么¶

dsh-bot-toggle（GitHub：JackWoods-code/dsh-bot-toggle）分类为客户端插件，面向已安装并启用 ds-bot 的 DSH Desktop 用户。社区目录页：skillhub.cn/plugins/JackWoods-code/dsh-bot-toggle。插件以 MIT 许可证发布，与 DeepSeek、ds-bot 无官方从属关系；DeepSeek Harness 生态遵循「一切皆插件」，社区目录为独立站点，并非官方应用商店。

核心功能¶

以下能力均来自项目 README 与 package.json 说明：

• 一键在 Bot 与 ADE 之间切换，当前所在侧高亮显示。
• 两套界面下均显示固定悬浮层，尽量避开主内容区；可拖拽到任意位置，贴边吸附；右键恢复默认位置（位置会记住）。
• 全局快捷键 Alt+Shift+B。
• 约 4 秒无操作后淡出，悬停恢复；遵循 prefers-reduced-motion。
• 界面文案随页面或浏览器语言在中英文间切换。
• ds-bot 兼容探测：报告 ds-bot 是否已加载及可获取时的版本；若 ds-bot 控件缺失，胶囊变为琥珀色并给出说明，而不是静默消失。

环境与依赖¶

README 写明已测试组合：

• DSH Desktop 0.2.1-rc.2 / 0.2.1-rc.3
• ds-bot 已安装并启用（测试版本 0.2.2）

package.json 中 dsh.engines.dsh 为 >=0.2.1-rc.2。

安装与启用¶

在 DSH 内：Settings → Plugins → add plugin，任选其一：

• GitHub 源：github:JackWoods-code/dsh-bot-toggle
• Releases 中的 dsh-bot-toggle-<version>.tgz（也可自行 npm pack）

命令行等价写法：

dsh plugin --profile desktop add github:JackWoods-code/dsh-bot-toggle

若插件页提示需下次启动生效，请重启 DSH。安装前建议自行查看仓库源码与许可证；插件在 当前 DSH 进程权限 下运行，与所装插件同属信任边界。

典型用法¶

1. 点击胶囊上的 Bot 进入 ds-bot 的 Bot 工作面，点击 ADE 回到经典 DSH 界面。
2. 拖拽胶囊移动位置；右键胶囊将位置重置到右侧居中默认位。
3. 在任意界面按 Alt+Shift+B 切换。

调试与兼容探测¶

在 Settings → Account → developer tools 打开 DevTools，于控制台执行：

__botToggle.status()
// { version, mode, painted, lang, busy, mounted, lastError,
//   dsBot: { loaded, version, compatible } }
__botToggle.probe()          // 仅 ds-bot 探测结果
__botToggle.switchTo("bot")  // 另一方向用 "classic"
__botToggle.toggle()
__botToggle.reset()          // 重置位置

日志前缀为 [bot-toggle]。

ds-bot 未公开版本 API；探测顺序为 window.__DSH_BOOT__.entries 中 id/name/package 为 ds-bot 的项、其次 window.dshBot.version、document.body.dataset.dsBotVersion。若 ds-bot 看似已加载但两套界面的控件都不存在，status().dsBot.compatible 为 false，胶囊呈琥珀色。切换逻辑依赖 ds-bot DOM（如 .bt-return、.bt-account 等）；ds-bot 升级可能改动这些节点。

适用场景与限制¶

适合：已在 DSH 中启用 ds-bot，且需要在 Bot 面与经典 ADE 之间频繁切换、又不想每次走账户菜单或返回按钮的用户。

务必知晓：

• 本插件只做 界面切换，ds-bot 始终处于加载状态，普通会话仍可能看到 ds-bot 提供的工具（如 list_bots、message_bot 等）。若要卸载 ds-bot，应在 Plugins 页禁用 ds-bot，而非指望本插件卸载它。
• 若两套界面均无法探测，胶囊约 1.6 秒后隐藏。

结尾¶

dsh-bot-toggle 用右侧悬浮胶囊和快捷键补上了 ds-bot 双界面之间缺少的常驻开关，并在兼容异常时用可见提示代替静默失败。目录与源码：

• 目录页：https://www.skillhub.cn/plugins/JackWoods-code/dsh-bot-toggle
• GitHub：https://github.com/JackWoods-code/dsh-bot-toggle