前言¶
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，比看截圖更說明問題。
