前言¶
在 DeepSeek Harness（DSH）里，省 Token 往往靠多个独立 bundle 配合：文档先转 Markdown、网页只读正文、MCP 按需加载等。这些能力需要在插件管理里分别安装和开关，会话中临时调整时路径较长。下面介绍维护者 cypher-yht 发布的 dsh-plugins-token-toggle（社区分类：工作流）：在对话输入框「模型选择」左侧增加「省 Token」按钮，用面板一次性查看并切换三个相关插件的启用状态，状态通过 pluginManager 读写当前 profile，并给出是否需要重启等明确反馈。
这是什么¶
dsh-plugins-token-toggle 是标准 DSH bundle 插件，本身不实现转文档、读网页或 MCP 懒加载逻辑，而是作为三个已有省 Token 插件的快捷开关。前端 UI 集中在 client.js，宿主侧 index.js 为空实现；装完并刷新页面后，按钮注册在 conversation.input.left。
受控的三个 bundle 名称固定在插件代码的 BUNDLES 常量中：
| 面板名称 | Bundle 名 | 作用（来自 README） |
|---|---|---|
| 文档转 Markdown | dsh-plugin-office-markdown |
Office/PDF 先转 .md，只把路径交给模型 |
| 网页正文读取 | dsh-read-url |
抓正文、限长、缓存，减少 HTML 噪声 |
| MCP 按需加载 | dsh-mcp-lazy |
只暴露一个代理工具，工具 schema 用到才加载 |
前提：上述三个 bundle 需已在当前 profile 的 plugin_manager 中安装（例如从插件市场安装）；未安装项在面板里显示「未安装」，开关禁用。
核心功能¶
输入框旁按钮与计数¶
按钮文案为「省 Token」，并显示当前已启用数量，例如 2/3；状态尚未从远端读到时显示 ·。点击后弹出开关面板。
面板内三个开关¶
每个开关对应上表中的一个 bundle。切换时调用 remote.pluginManager.setBundleEnabled(name, enabled)，不直接改配置文件；写入的是当前 profile，因此可能出现需重启 DSH 才生效的情况。
实时状态与节流¶
通过 remote.pluginManager.listBundles() 读取各 bundle 的安装与启用状态。面板打开时会刷新；15 秒内不重复拉取列表。切换过程中显示「切换中…」。插件监听 plugin-manager/changed 事件，在其他入口修改插件状态时面板会自动同步。
切换结果反馈¶
setBundleEnabled() 之后会根据结果区分提示，包括但不限于：已切换并生效、状态未变化、已保存需重启 DSH 生效、已保存但被更高优先级配置覆盖、切换失败、操作已取消。失败或被覆盖时用红色提示，避免误以为已生效。面板底部说明：切换会写入当前 profile，需要重启时请重启 DSH。
交互与国际化¶
面板挂在 shell.overlay（order: 950），相对按钮向上弹出并按视口收敛。Esc、点击面板外、右上角 × 均可关闭。文案通过 locale.register 注册 zh / en，随界面语言切换。
安装与启用¶
官方安装命令如下（PowerShell 示例，与 README 一致）：
dsh plugin add github:cypher-yht/dsh-plugins-token-toggle
本地开发可使用软链：
dsh plugin add link:D:\path\to\token-toggle
说明：桌面客户端（Electron）使用 desktop profile，请在桌面端会话对应的 plugin_manager 中安装本插件。
装完后重启宿主；浏览器端使用 Ctrl+F5 硬刷新。README 写明：标准 bundle 插件，装完刷新页面即生效（若 profile 或宿主要求重启，以面板反馈为准）。
典型用法¶
- 在当前 profile 安装
dsh-plugin-office-markdown、dsh-read-url、dsh-mcp-lazy（若尚未安装）。 - 执行上述
dsh plugin add github:cypher-yht/dsh-plugins-token-toggle，重启宿主并刷新页面。 - 在对话输入框左侧找到「省 Token」按钮，查看
n/3或·。 - 点击按钮打开面板，按需打开或关闭三个开关；若提示需重启，则重启 DSH 后再继续会话。
- 若仅在插件管理里改了相关 bundle 状态，可重新打开面板或等待事件同步，无需手动改配置文件。
适用场景与注意¶
适合谁：经常在同一 DSH 环境里切换「是否省 Token」策略的开发者；希望少进插件管理、在输入框旁集中控制上述三个 bundle 的用户。
权限与信任：插件以当前 DSH 进程权限运行，通过官方 API 启停 bundle。安装前建议阅读仓库源码与 MIT 许可证。
边界：本插件不替代三个子插件的安装与配置；增减受控 bundle 需修改仓库内 client.js 的 BUNDLES 常量。社区目录页与 GitHub 仓库由维护者发布，与 DeepSeek / 幻方无官方从属关系。
