前言¶
DSH 的流式输出默认只表现为对话气泡里逐字吐出的文字。做长任务、跑多轮 agent 时，你很难从视觉上判断”这一刻模型到底在跑还是在卡”，也看不到 token 消耗的节奏。Token Combo 就是把这段 Token 流接到一个街机风格的连击 HUD 上：每来一段可见 Token 就 +1，连击槽攒满升阶，分数和倍率实时变化。插件由 coolchengSAMA 维护，仓库为 coolchengSAMA/dsh-token-combo，分类是趣味换装，目前公开测试版、仅支持 Windows。
这是什么¶
一句话定位：DSH 插件，把模型流式输出的 Token 变成连击游戏里的连击槽、等级和分数 HUD，附带七位模型角色和合成音效。定位是趣味/观感类工具，不是监控指标面板，也不替代 DSH 自带的 token 统计。
它解决的是”流式输出缺少过程反馈”这个观感问题：在等待模型长输出时，用户能直接看到节奏和倍率变化，而不是盯着不动的气泡。
核心功能¶
下面列出的功能均来自仓库 README，未在资料中出现的不做推断。
- 实时连击：每段可见 Token 命中 +1，按字符估算词元数，累计分数
- 等级与倍率：连击槽攒满升阶，空闲会回退/掉级，最低级才会断连
- 七位角色：DeepSeek / ChatGPT / Claude / Gemini / GLM / Grok / Qwen
- 三个显示位置，各自独立开关：
- 窗口悬浮窗
- 聊天栏紧凑徽章
- 桌面透明悬浮窗
- 桌面悬浮窗：置顶、透明、可拖动，悬停/拖动时显示虚线，位置记忆，支持鼠标穿透
- 多智能体汇总：同一对话里的 subagent / teammate 共享一条连击
- 辅助项：音效、低动态、试炼预览、内容对齐、80%–240% 缩放
安装与启用¶
环境要求先确认：Windows 10 / 11（x64），DeepSeek Harness Desktop。桌面悬浮窗另需 WebView2 Runtime，Windows 11 通常自带。
仓库给的安装方式是把本地目录装成 bundle，不是远程仓库拉取：
- 下载或克隆本仓库到本地目录
- 在 DeepSeek Harness 中安装本地插件包，
target指向本仓库目录：
plugin_manager install_bundle
target: <本仓库路径>
- 重启 DSH，从侧边栏打开「词元连击」
这里没有 dsh plugin add github:owner/repo 之类的远程安装命令，资料里也未提供。要装就得先把目录拿到本地。
典型用法¶
装好之后，日常操作集中在开关显示和调整桌面窗口。
1、在控制台里分别开关窗口悬浮窗、聊天栏和桌面悬浮窗，三者互不绑定。
2、桌面悬浮窗的默认快捷键：
Ctrl+Alt+T 切换鼠标穿透
Ctrl+Alt+X 关闭桌面悬浮窗
鼠标穿透让你点桌面其他窗口时不会误触 HUD；穿透关闭后 HUD 可正常拖动和点击。
3、双击窗口悬浮窗可收起为小徽章，点击徽章再展开。这样在长对话里不会一直占着可视区域。
偏好和悬浮窗位置保存在浏览器本地，不写其他位置，换机器或清浏览器数据后需要重新调。
从源码构建¶
仓库是 MIT 许可证，源码可改。构建入口四条命令：
node scripts/build-client.mjs # 生成 client.js 并做语法检查
node scripts/build-client.mjs --check
node host-test.mjs
node src/fx-test.mjs
package.json 里 version 是 2.7.5，README 的 release 徽标指向 v2.7.5-beta.1，README 标为 public beta。包名 @local/dsh-token-combo，private: true，因此走本地 bundle 安装是合理路径。
适用场景与注意事项¶
适合在 Windows 上用 DSH Desktop 跑长输出任务、多 agent 对话、想让等待过程有点反馈的人。如果你只需要精确的 token 计数或成本统计，这个插件的定位不对口，它给的是节奏和倍率，不是精确计量。
几个必须知道的点：
- 插件以当前 dsh 进程权限在本机运行。README 写明只在本机运行、不发送网络请求、不保存对话内容，但安装第三方插件前仍应打开源码核对，确认没有额外的网络或文件访问。
- 许可证部分：代码是 MIT，
art/中的角色图片不在 MIT 范围内，细节见仓库NOTICE。商用或二次分发前要单独确认图片授权。 - 桌面悬浮窗是独立 WebView2 窗口，常驻内存约 120MB。不用桌面 HUD 的话，在控制台关掉它即可。
- 当前为测试版，暂无自动更新。升级需要替换本地目录并重启 DSH，不是覆盖安装后自动生效。
- 只能用于 Windows，macOS / Linux 用户无需尝试。
- 报错反馈走 GitHub Issues，附上 DSH 版本、Windows 版本、缩放比例、复现步骤和截图；桌面悬浮窗问题可以附
%APPDATA%\token-combo-webview2.log。不要在 Issue 里贴对话内容或 API Key。
结尾¶
Token Combo 的价值有限且明确：它不改 DSH 的行为，只把已经存在的流式 Token 输出换算成一个有节奏感的 HUD。想试的话，目录页在 https://www.skillhub.cn/plugins/coolchengSAMA/dsh-token-combo，源码在 https://github.com/coolchengSAMA/dsh-token-combo 。装之前花两分钟读一遍宿主代码和 cordis.patch.yml，比看截图更说明问题。
