dsh-mascot-xiadie：DeepSeek Harness 懸浮小人餘額小管家

在 DeepSeek Harness（DSH）的開發與使用流程中，監控 API 餘額與 Token 消耗是常見需求。dsh-mascot-xiadie 提供了一個網頁插件，在屏幕上懸浮一個可交互的 Q 版小人（遐蝶），用於實時播報賬戶餘額與用量。

安裝與啓用¶

該插件隸屬於 DSH 生態的“趣味換裝”類別，由維護者 Edison-q 開發，採用 MIT 協議開源。

安裝過程需要通過 DSH 的命令行工具完成：

dsh plugin --profile web add dsh-mascot-xiadie
dsh web   # 重啓後刷新頁面

使用前需在 DSH 設置的模型配置中添加 DEEPSEEK_API_KEY，否則無法查詢餘額。此外，插件的“今日/全機 tokens”數據來源爲本地 dsh-usage-plugin 的記錄。

核心功能¶

該插件在 DSH 網頁界面中提供一個懸浮的小人，具備以下核心能力：

1. 實時播報：懸浮小人會實時播報賬戶餘額與 Token 用量。
2. 交互操作：支持單擊、雙擊、連點等交互，小人會根據狀態切換表情與臺詞。
3. 右鍵菜單：右鍵點擊可喚出菜單，包含“統計 / 進度 / 總賬”選項，以及調節小人大小（120–360px）的滑塊。
4. 拖拽與吸附：小人可拖動至任意位置，靠近屏幕邊緣鬆手會自動吸附，位置記憶功能會記住上次的位置。
5. 里程碑慶祝：當全機累計 Token 跨越 100 萬的倍數時，會觸發慶祝狀態（圖1 + 慶祝氣泡）。
6. 數據存儲：所有數據存儲在本地（%LOCALAPPDATA%），不上傳服務器。

交互操作¶

小人的狀態與反應基於特定的操作觸發，具體如下：

每次點擊均有摸頭 Q 彈效果。播報氣泡與反應氣泡（持續 2 秒）會疊放共存，各自計時。

自定義配置¶

換圖¶

默認素材來源於《崩壞：星穹鐵道》，如需更換，可按狀態命名圖片文件（推薦 PNG 透明底）：

• state1.png：傷心（里程碑）
• state2.png：待機
• state3.png：害羞
• state4.png：無語
• state5.png：嚴謹 · 播報

放置方式二選一（修改後需重啓 dsh web）：
1. 替換插件目錄 assets/ 下的同名文件。
2. 設置環境變量 DSH_MASCOT_DIR 指向包含這些圖片的目錄。

換臺詞 / 換配色¶

1. 複製默認 JSON 配置文件（見下文）。
2. 修改 name（角色名）、accent（主題色）、lines（臺詞）等字段。
3. 設置環境變量 DSH_MASCOT_CONFIG 指向該 JSON 文件。

示例配置（僅展示部分關鍵字段）：

{
  "name": "遐蝶",
  "accent": "#c4a8f5",
  "lines": {
    "report": "餘額還剩 ¥{balance}。今日消耗 {tokens}。",
    "shy": "不要再摸我啦",
    "milestone1": "累計已使用 {tokens} Tokens……",
    "milestone2": "項目會越來越成功的哦！"
  }
}

數據口徑與存儲¶

• 餘額：來源於 DeepSeek 官方 GET /user/balance 接口，實時。
• 今日 / 全機 tokens：讀取本地 dsh-usage-plugin 記錄，口徑爲北京時間。
• 本項目 tokens：本插件按會話工作區（文件夾）實時記賬，新項目從零開始。

所有數據均存儲在本地，不上傳任何服務器。

版權說明¶

插件代碼以 MIT 協議開源。assets/ 目錄中的角色立繪（state1–5.png）爲《崩壞：星穹鐵道》官方素材，版權歸 © miHoYo 所有，僅作個人非商業用途示例；二次分發前請替換爲你自己的素材。

插件目錄： https://github.com/Edison-q/dsh-mascot-xiadie