前言¶

在 DeepSeek Harness（DSH）里長時間跑任務時，賬戶餘額或 Token 用量往往藏在設置或遠端接口裏，需要切界面才能確認。社區插件 dsh-corner-gauge 在客戶端 Web 界面角落掛一塊可拖動的懸浮面板，默認展示 DSH 賬戶餘額；邊框（skin）與面板內容（elements）分開配置，換外觀或增減顯示項不必改另一層。維護者爲 kkppshuai-svg，倉庫 kkppshuai-svg/dsh-corner-gauge 在 SkillHub 目錄中歸類爲「趣味換裝」，GitHub 星標爲 3。本文介紹其定位、能力與安裝方式，事實以倉庫 README 與 package.json 爲準。

這是什麼¶

dsh-corner-gauge 是給 DSH 用的角落懸浮徽章：外形爲斜切底板，右側爲金屬質感數字區。README 將其概括爲「邊框是模板（skin），面板裏顯示什麼由元素（elements）決定」——換殼、加減元素互不牽連。插件通過 Cordis patch 掛載，客戶端平臺爲 web，不注入額外 UI 包，餘額默認走 ctx.remote.account。

當前 package 版本爲 2.1.0；代碼許可爲 MIT，assets/ 下第三方素材另見倉庫 NOTICE.md。

核心功能¶

邊框與元素¶

• 邊框可換：內置 mclaren（斜切 + 品牌標誌）與 minimal（極簡圓角）。
• 元素可插：貨幣符號、金額、進度條等按 config.elements 順序裝配；默認 ['currency','amount','progress']。
• 車輛 ↔ 品牌聯動：例如 M4 對應寶馬 M 標誌與紅色飾條，邁凱倫對應 speedmark 與 papaya 橙 #ff8000（詳見 README「車輛 ↔ 品牌」）。

數據與穩定性¶

• 零外部請求（面板本體）：字體與標誌 base64 內嵌，離線可用；CI 會校驗。
• 可拖動：位置寫入 localStorage，窗口縮放時鉗制回視口。
• 取數失敗：指數退避重試；未登錄或不可用時顯示 --，不會靜默消失。
• 輪詢：默認 pollMs: 60000。

多數據源（需本地橋接）¶

除 DSH 餘額（provider: 'dsh'，默認）外，README 說明可通過 本地橋接 讀取 Codex / Claude Code 會話 JSONL、豆包用量等；瀏覽器內面板無法直接讀本機文件，需運行：

npm run bridge

橋接默認監聽 http://127.0.0.1:7317；面板按 pollMs 請求 /usage?provider=...&period=...。period 可選 today / week / month / all。橋接未啓動時顯示 --。

彩蛋¶

單擊面板可觸發跑車從右向左穿過動畫（期間僅顯示跑車）；配 M4 直六聲浪（內嵌錄音，WebAudio 合成兜底）。可通過配置關閉或調整（drive.* 字段，見下節）。

安裝與啓用¶

官方 README 未提供 dsh plugin add 一類命令；安裝分三步：複製包進 profile、登記依賴與 bundle、重啓 App。

1. 放進 profile¶

將倉庫內容複製到 profile 的 node_modules（Windows 示例來自 README）：

# 把倉庫複製進 profile 的 node_modules
# Windows 示例
xcopy /E /I dsh-corner-gauge "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-corner-gauge"

Linux/macOS 用戶需自行用等價方式把插件目錄放到 ~/.dsh/profiles/<profile>/node_modules/dsh-corner-gauge。

2. 登記到 profile¶

編輯 ~/.dsh/profiles/<profile>/package.json：

{
  "dependencies": {
    "dsh-corner-gauge": "^2.0.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "...",
        "dsh-corner-gauge"
      ]
    }
  }
}

3. 重啓 App¶

客戶端 bundle 在啓動時構建，改完必須重啓 App；僅刷新頁面不夠。若啓動後插件未出現，先檢查 dsh.profile.bundles 是否仍包含該插件——README 提到 profile 組合失敗時 DSH 可能重置配置。

兼容性（package.json）¶

倉庫提供 npm run verify:install 在臨時目錄驗證安裝/掛載流程；細節見 docs/dsh-store-evidence.md。

典型用法¶

運行時配置¶

在插件加載前設置全局對象（README 示例）：

window.__DSH_BADGE_CONFIG__ = {
  skin: 'mclaren',
  elements: ['currency', 'amount', 'progress'],
  position: { right: 22, bottom: 96 },
  size: { width: 322, height: 70 },
  currency: 'auto',          // 'auto' | 'CNY' | 'USD'
  pollMs: 60000,
};

常用鍵說明（摘自 README 配置表）：

Codex 周用量示例¶

{
  "provider": "codex",
  "period": "week",
  "bridgePort": 7317,
  "pollMs": 120000
}

先在本機項目目錄執行 npm run bridge，再在瀏覽器中使用 DSH；面板 ⚙ 菜單在 README 中說明只負責換車，數據源僅在配置裏選 provider。

自定義素材（開發者）¶

車輛與聲浪在 assets/manifest.json 聲明，構建時內嵌。入庫流程：assets/incoming/ 放圖後 npm run import，再 npm run build。側視圖、白/透明背景等要求見 README「素材庫」——偏離要求會在橫向跑動動畫裏明顯錯位。

適用場景與注意¶

適合誰：希望在 DSH Web 客戶端一眼看到餘額或（配合橋接）本機 Codex/Claude/豆包用量，並願意手動維護 profile 裏 node_modules 與 bundles 的用戶；喜歡換 skin、跑車彩蛋的也可當作「趣味換裝」類插件玩。

務必注意：

1. 插件隨 當前 DSH 進程與用戶 profile 加載；安裝前應自行審閱 源碼與 MIT 許可證，以及 NOTICE.md 中的素材授權。
2. 僅支持 DSH 0.2.x 候選段（<0.3）；升級 DSH 大版本前需覈對 engines.dsh。
3. Codex/Claude/豆包等數據涉及讀本機路徑或密鑰（如火山 VOLC_ACCESSKEY），橋接進程權限與你在終端裏的環境變量一致，勿在不可信環境暴露 AK/SK。
4. SkillHub 目錄（plugins/kkppshuai-svg/dsh-corner-gauge）爲社區索引，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文不將其描述爲官方應用商店條目。

結尾¶

dsh-corner-gauge 把賬戶餘額（及可選的多源用量）做成可換殼、可組合的角落 HUD，並內嵌字體與標誌以減少運行時外連。安裝依賴 profile 手工拷貝與 bundle 登記，改配置後需重啓 App；擴展 Codex 等數據源時需另起本地 bridge。

• 目錄頁：https://www.skillhub.cn/plugins/kkppshuai-svg/dsh-corner-gauge
• GitHub：https://github.com/kkppshuai-svg/dsh-corner-gauge