前言¶
在 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
