前言¶
在 DSH 里長時間對話時，餘額和每輪消耗往往要切到別處查看；峯谷時段又影響實際扣費，單靠記憶容易誤判「現在算不算高峯」。常見做法是開瀏覽器查賬戶頁，或依賴宿主自帶的零散提示，但和對話界面脫節，也缺少「今天累計花了多少」這種按日歸零的視角。
下面介紹社區插件 dsh-kon-fee-widget（維護者 xiao2236）：用《輕音少女》原版大茶桌和五人坐姿做桌面掛件，平時只顯示場景，點茶桌才彈出部費賬本；宿主側拉 DeepSeek 餘額、按官方價目算峯谷與每輪消耗，並支持雙擊臺詞彩蛋。它不是桌寵、也不做提示音轟炸，定位就是「看餘額、看今天花費、看是否高峯」三件事。
這是什麼¶
dsh-kon-fee-widget 是 DeepSeek Harness（DSH）上的前端掛件插件，分類爲「趣味換裝」。倉庫：github.com/xiao2236/dsh-kon-fee-widget；社區目錄頁：skillhub.cn/plugins/xiao2236/dsh-kon-fee-widget。
底座使用原版 desk00 背景、五人坐姿與 desk01 前景三層切分（中間三人有坐姿動畫）。賬本與消耗信息通過宿主 lib/index.js 提供 HTTP 接口與 session 訂閱，API Key 不下發到前端。
核心功能¶
茶桌與賬本¶
單擊茶桌開/關「部費賬本」：右上角高峯/谷價標籤（高峯橙紅、谷價綠）、餘額、今天花費、計價進度條、左下角更新時間；約 8 秒自動收起（可通過 panelDurationMs 調整）。點茶桌外任意處也會收起賬本。
週末與法定節假日按 README 說明全天谷價；進度條表示當前時段進度。
今天花費與每輪消耗¶
「今天花費」由宿主在 turn/end 時累計當日金額，跨天自動歸零。
每輪對話結束後，若開啓 turnBubble，會用與賬本同一套卡面樣式的信息窗彈出：右上角「本輪」、金額、今天累計、更新時間。
高峯/谷價與餘額來源¶
餘額請求路徑（README 摘要）：
瀏覽器 GET /dsh-kon-fee-widget/balance
→ 宿主 lib/index.js
├─ ctx.credentials.get("DEEPSEEK_API_KEY") → GET api.deepseek.com/user/balance
├─ 沒 key 時退到 DSH 賬號服務 deepseekAccount.getBalance()（充值錢包 + 贈金相加）
├─ 45 秒緩存 + 併發合併
└─ 失敗沿用上次餘額（前端標註）
每輪消耗：宿主訂閱 session/event，在 assistant/message 帶真實 usage 時按 (session, turn) 聚合，turn/end 時用官方價目表（Flash / Pro，谷價/高峯兩檔）算錢。
右鍵茶桌可刷新余額並打開賬本；配置項 refreshSeconds 默認 60 秒控制刷新節奏，warnBelow 默認 5 用於低餘額提醒閾值。
雙擊彩蛋與臺詞¶
雙擊茶桌按「在場角色」彈臺詞：僅一人在場時只出該角色臺詞；多人時組合臺詞按概率與順序規則播放（eggComboChance 等見配置）。臺詞結構爲 {zh, ja}，配置裏 lang 可切換顯示語言；可選 voice 播放 assets/voices/ 下音頻，齒輪菜單可關配音。
當律與澪同時在桌時，雙擊可進入「陽臺相會」劇本：點一次播一句，共 17 句順序播放（內置在代碼中，配置留空即可）。
佈局與設置¶
- 設置頁五個角色開關：關閉某角色會連同對應桌段收起；全關則整桌不顯示。
- 拖動挪位，邊緣 24px 內自動貼邊（
snap）；齒輪菜單可調整體scale、聲音開關、一鍵回到右下角。 - 氣泡背景兩種：
bubbleStyle爲cassette（卡帶）或動物樣式；面積隨(桌子+人物面積) × bubbleAreaRatio（默認 1.3），人少時自動變小。
安裝與啓用¶
DSH 生態是「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝前建議瀏覽倉庫源碼與 LICENSE、THIRD_PARTY_NOTICES.md：代碼 MIT，茶桌與角色立繪來自第三方桌寵素材，氣泡美術版權歸相關權利方，插件爲非官方同人作品。
DSH Web¶
先做 profile 爲 web 的插件安裝，再重啓或刷新 DSH Web 使 bundle 生效：
dsh plugin --profile web add github:xiao2236/dsh-kon-fee-widget
package.json 中聲明與 DSH 0.2.0-rc.1 及以上若干 rc 版本兼容，並標記 0.1.7-rc.2 爲不兼容；具體以倉庫內 dsh.compatibility 爲準。
桌面客戶端（Electron）¶
- 將倉庫複製到
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-kon-fee-widget（Linux/macOS 對應用戶目錄下的.dsh/profiles/desktop/node_modules/...）。 - 在該 profile 的
package.json增加依賴"dsh-kon-fee-widget": "file:<倉庫路徑>"，並寫入dsh.profile.bundles。 - 重啓 DSH（客戶端在啓動時加載包）。
README 提醒：DSH 運行中勿用市場命令重裝本插件，否則 Windows 上可能出現 EPERM，留下缺少 assets/table/ 的半成品（茶桌空白、人物消失）。若異常，應退出 DSH 後使用倉庫提供的 npm run deploy 或請求 curl http://127.0.0.1:<端口>/dsh-kon-fee-widget/health 檢查 missing 列表。
配置¶
配置文件路徑：~/.dsh/kon-fee-widget.json（帶註釋 JSON），也可在設置頁「編輯配置」彈窗修改；手改後刷新頁面生效。完整字段見倉庫 docs/config.md。
概要示例：
{
"visible": true,
"characters": { "mio": true, "ritsu": true, "yui": true, "tsumugi": true, "azusa": true },
"scale": 1,
"snap": true,
"refreshSeconds": 60,
"warnBelow": 5,
"turnBubble": true,
"panelDurationMs": 8000,
"bubbleStyle": "cassette",
"bubbleAreaRatio": 1.3,
"easterEgg": true,
"eggLines": {},
"eggComboChance": 0.5,
"lang": "zh",
"voice": true,
"easterEggLines": []
}
典型用法¶
經過上面的安裝與配置，可按 README「交互一覽」操作：
| 操作 | 效果 |
|---|---|
| 單擊茶桌 | 開/關賬本 |
| 雙擊茶桌 | 彩蛋臺詞；律+澪劇本下再次單擊茶桌播下一句 |
| 點茶桌外 | 收起賬本或臺詞 |
| 拖動 | 挪位置，鬆手吸附 |
| 右鍵 | 刷新余額並開賬本 |
| 齒輪 | 大小、聲音、回到右下角 |
適合希望在 DSH 界面內一眼看到 DeepSeek 餘額、當日累計消耗與峯谷標籤的開發者；若只需要純數字面板、不需要《輕音》場景，可關閉角色或整桌 visible。
適用場景與注意¶
- 適合：Web 或桌面 DSH 用戶，已配置 DeepSeek API Key 或 DSH 賬號餘額路徑，且接受掛件以當前 DSH 進程權限訪問憑證與賬戶接口。
- 注意：插件在宿主內運行，安裝前應自行審閱源碼與許可；第三方角色與桌寵素材不得視爲 MIT 一併商用。當前倉庫版本號爲 0.29.2（以
package.json爲準）。
結尾¶
dsh-kon-fee-widget 把 DeepSeek 部費賬本收進輕音茶桌交互：平時不佔視覺，點桌即查餘額、今日花費與峯谷，輪次結束再彈本輪消耗；彩蛋與中日臺詞屬於趣味換裝層的附加能力。
- 目錄頁：https://www.skillhub.cn/plugins/xiao2236/dsh-kon-fee-widget
- GitHub：https://github.com/xiao2236/dsh-kon-fee-widget
