Foreword¶

By default, DSH’s streaming output only manifests as text appearing word by word in chat bubbles. When performing long tasks or running multi-round agents, it is difficult to visually determine “whether the model is running or stuck at this moment,” and you cannot see the rhythm of token consumption. Token Combo connects this stream of tokens to an arcade-style combo HUD: +1 for every chunk of visible tokens, leveling up when the combo bar is filled, with score and multiplier changing in real-time. The plugin is maintained by coolchengSAMA, the repository is coolchengSAMA/dsh-token-combo, it is categorized as a Fun Overlay, currently in public beta, and only supports Windows.

What Is It¶

One-sentence positioning: A DSH plugin that converts the model’s streaming output tokens into a combo bar, level, and score HUD similar to a combo game, complete with seven model characters and synthesized sound effects. It is positioned as a fun/aesthetic tool, not a monitoring metrics panel, and does not replace DSH’s built-in token statistics. It solves the aesthetic problem of “lack of process feedback in streaming output”: while waiting for the model’s long output, users can directly see changes in rhythm and multiplier, rather than staring at a stationary bubble.

Core Features¶

The features listed below all come from the repository README; no inferences are made for features not appearing in the materials.

• Real-time Combo: +1 for every hit of visible tokens, estimated token count by characters, cumulative score.
• Level & Multiplier: Level up when the combo bar fills, retreat/drop level when idle, only drops to the lowest level does it break the combo.
• Seven Characters: DeepSeek / ChatGPT / Claude / Gemini / GLM / Grok / Qwen.
• Three display positions, independently toggleable:
• In-Window Floating Window
• Compact Badge in Chat Bar
• Transparent Desktop Floating Window
• Desktop Floating Window: Always on top, transparent, draggable, dashed lines on hover/drag, remembers position, supports mouse pass-through.
• Multi-Agent Aggregation: subagents/teammates in the same conversation share one combo.
• Extras/Auxiliary: Sound effects, low motion, trial preview, content alignment, 80%–240% scaling.

Installation and Enablement¶

Confirm environment requirements first: Windows 10 / 11 (x64), DeepSeek Harness Desktop. The desktop floating window additionally requires WebView2 Runtime, which is usually included in Windows 11.

The installation method provided by the repository is to bundle a local directory, not to pull from a remote repository:

plugin_manager install_bundle
  target: <本仓库路径>

3. Restart DSH and open “Token Combo” from the sidebar.

There is no remote installation command like dsh plugin add github:owner/repo here, nor is it provided in the materials. To install, you must first get the directory locally.

Typical Usage¶

After installation, daily operations focus on toggling display and adjusting the desktop window.

1. Toggle the in-window floating window, chat bar badge, and desktop floating window in the console respectively; the three are not bound to each other.

2. Default hotkeys for the desktop floating window:

Ctrl+Alt+T   切换鼠标穿透
Ctrl+Alt+X   关闭桌面悬浮窗

Mouse pass-through prevents accidentally triggering the HUD when clicking other windows on the desktop; after pass-through is disabled, the HUD can be dragged and clicked normally.

3. Double-clicking the in-window floating window collapses it into a small badge; clicking the badge expands it again. This way, it won’t constantly occupy the visible area in long conversations.

Preferences and window positions are saved locally in the browser, not written to other locations. They need to be readjusted after switching machines or clearing browser data.

Building from Source¶

The repository is under the MIT license and source code is modifiable. The build entry consists of four commands:

node scripts/build-client.mjs        # 生成 client.js 并做语法检查
node scripts/build-client.mjs --check
node host-test.mjs
node src/fx-test.mjs

The version in package.json is 2.7.5, the release badge in the README points to v2.7.5-beta.1, and the README is marked as public beta. The package name is @local/dsh-token-combo with private: true, so installing via a local bundle is the reasonable path.

Suitable Scenarios and Notes¶

Suitable for people running long output tasks and multi-agent conversations on Windows using DSH Desktop who want some feedback during the wait. If you only need precise token counting or cost statistics, this plugin is not the right fit; it provides rhythm and multiplier, not precise measurement.

A few points you must know:

• The plugin runs locally with the permissions of the current DSH process. The README states it runs only locally, does not send network requests, and does not save conversation content, but you should still open the source code to verify before installing third-party plugins, confirming there is no additional network or file access.
• Regarding the license: The code is MIT, but character images in art/ are not covered by MIT; see the repository’s NOTICE for details. You must separately confirm image authorization before commercial use or redistribution.
• The desktop floating window is an independent WebView2 window, consuming about 120MB of RAM. If you don’t use the desktop HUD, you can turn it off in the console.
• Currently in beta, there is no automatic update. Upgrading requires replacing the local directory and restarting DSH; it does not take effect automatically after overwriting.
• Only for Windows; macOS / Linux users need not try.
• For error feedback, use GitHub Issues, attaching the DSH version, Windows version, scaling ratio, reproduction steps, and screenshots; for desktop floating window issues, you can attach %APPDATA%\token-combo-webview2.log. Do not paste conversation content or API keys in the Issue.

Conclusion¶

The value of Token Combo is limited and clear: it does not change DSH’s behavior, it only converts the existing streaming token output into a rhythmic HUD. If you want to try it, the directory page is at https://www.skillhub.cn/plugins/coolchengSAMA/dsh-token-combo, and the source code is at https://github.com/coolchengSAMA/dsh-token-combo . Before installing, spend two minutes reading the host code and cordis.patch.yml, which explains things better than screenshots do.