dsh-kon-fee-widget
DSH 上的《轻音少女》部费挂件：用原版茶桌当底座，五个人坐满；点一下才弹账本——DeepSeek 余额 + 峰谷时段 + 更新时间。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiao2236/dsh-kon-fee-widget#1e2e429df0d005dd42e9f08ce13300a588ad5e0f
Kon Fee Widget 以 dsh-kon-fee-widget 发布，当前版本为 0.29.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 上的《轻音少女》部费挂件：原版大茶桌当底座，五人坐成一排；平时不显示数字，点一下茶桌才弹「部费账本」。
不是桌宠、不做提示音轰炸：只干三件事——看余额、看今天花了多少、看现在是不是高峰。
| 功能 | 说明 | 截图 |
|---|---|---|
| 茶桌底座 | 原版 desk00 背景 + 五人坐姿 + desk01 前景三层切分，中间三人有坐姿动画 | 见下 |
| 点开账本 | 点茶桌弹出：右上角高峰/谷价标签、余额、今天花费、计价进度条、左下角更新时间；8 秒自动收起 | 卡带｜动物 |
| 高峰/谷价 | 标签配色区分（高峰橙红、谷价绿），进度条显示当前时段进度；周末与法定节假日全天谷价 | 同上 |
| 今天花费 | 宿主按 turn/end 累计当日金额，跨天自动归零 | 同上 |
| 每轮消耗 | 一轮对话结束用信息窗弹出：右上角「本轮」、金额、今天累计、更新时间（和余额账本同一套卡面） | 截图 |
| 双击彩蛋 | 按在场的人弹台词：单人在场只出本人台词；组合按概率触发 | 截图 |
| 中日对照 | 每条台词 {zh, ja}，配置里 lang 切换 | — |
| 语音 | 台词可带 voice 文件名，播放 assets/voices/ 下的音频；齿轮菜单可关 | — |
| 剧本连播 | 律+澪同时在桌时，双击进入「阳台相会」剧本：点一次播一句（共 17 句，按顺序、不随机，带配音），播完循环；17 句内置在代码里，配置留空即可用 | — |
| 人物可勾选 | 设置页五个按钮，关掉谁就连它那段桌子一起收起；全关则整桌不显示 | 截图 |
| 拖拽 / 吸附 / Q 弹 | 拖动挪位置，边缘 24px 内自动贴边，按下有回弹 | — |
| 齿轮菜单 | 右上角齿轮：大小滑杆 + 声音开关 + 回到右下角 | 截图 |
| 气泡比例 | 气泡面积 =（桌子+人物面积）× bubbleAreaRatio（默认 1.3），人少时自动变小 | 0.7× 示例 |
| 配置 | ~/.dsh/kon-fee-widget.json（带注释 JSON）或设置页「编辑配置」弹窗 | — |
| 卡带 | 动物 |
|---|---|
| 卡带 | 动物 |
| 单人在场（桌子收短、气泡变小） | 双击彩蛋 |
|---|---|
| 单人 | 彩蛋 |
| 每轮消耗 | 齿轮菜单 |
|---|---|
| 消耗 | 齿轮 |
| 设置页 | 整张卡带原图 |
|---|---|
| 设置 | 整图 |
| 操作 | 效果 |
|---|---|
| 单击茶桌 | 开/关账本 |
| 双击茶桌 | 弹彩蛋台词：单人在场只出本人一句；组合台词按「上一句 → 下一句」依次播放 |
| 点茶桌外任意处 | 收起账本 / 收起台词 |
| 台词显示时单击茶桌 | 剧本站下一句（律+澪场景） |
| 拖动 | 挪位置，松手吸附 |
| 右键 | 刷新余额并开账本 |
| 齿轮 | 开/关小菜单（会先收起账本） |
| 齿轮 → 大小 | 缩放整张桌子（气泡按面积比例跟随） |
| 齿轮 → 声音 | 开/关配音 |
| 齿轮 → 回到右下角 | 一键贴右下角 |
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-kon-fee-widget；package.json 里加依赖 "dsh-kon-fee-widget": "file:<仓库路径>"，并加进 dsh.profile.bundles；dsh plugin --profile web add github:xiao2236/dsh-kon-fee-widget
完整字段、默认值、范围、示例：docs/config.md。
概要（文件在 ~/.dsh/kon-fee-widget.json，带注释，手改后刷新页面生效）：
{
"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": []
}
浏览器 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，谷价/高峰两档）算钱，写进当天累计与 last-turn。
API key 不会下发到前端。
node scripts/build-client.mjs # src/core.cjs + src/client.js → lib/client.js
node scripts/check.mjs # 清单/素材/常量自检
node --test test/core.test.mjs test/host.test.mjs
npm run deploy # 原子部署到桌面 profile（拷贝 → 校验 → 整体替换）
npm run deploy:dry # 只拷贝+校验，不替换
npm run pack:dist # 打 dist/dsh-kon-fee-widget-<版本>.tgz（可挂 Release / 给 npm 装）
npm run release # build + check + test + pack + deploy 一条龙
node scripts/verify-install.mjs <安装目录> # 单独校验某个安装副本是否漏文件
curl http://127.0.0.1:<端口>/dsh-kon-fee-widget/health # 安装完整性：{ ok, missing[], version }
部署为什么要「原子」：直接删目录再拷到运行中的插件目录，Windows 文件占用或杀软扫描会让部分文件复制失败， 结果是一个缺
assets/table/的半成品——canvas 拿不到贴图，表现就是「挂件完全不显示」，而宿主接口照常返回 200。deploy.mjs先拷到同级隐藏目录、逐个文件比对通过后才整体改名替换，失败会回滚到旧目录。
⚠️ 别在 DSH 运行时用市场/
dsh plugin add重装本插件：pnpm 会把包导入到node_modules/dsh-kon-fee-widget_tmp_*再改名替换， DSH 占着目录时这一步会EPERM，留下一个缺assets/table/的半成品（现象：茶桌位置是空白、人物消失）。 遇到这种情况：退出 DSH →npm run deploy→ 再启动；或直接curl /dsh-kon-fee-widget/health看missing。
目录：
src/core.cjs 纯逻辑（几何、峰谷、金额、吸附、彩蛋选择）
src/client.js React 挂件 + 设置页（h() 创建元素，无打包器）
lib/index.js 宿主（静态素材、余额、配置、每轮消耗）
lib/client.js 构建产物
assets/table/ 茶桌与五人坐姿
assets/ui/ 气泡背景（卡带、动物、Logo）
assets/voices/ 语音文件（放这里）
docs/ 配置文档与截图
test/ 单元测试 + 本地夹具
MascotTable.exe（经 dsh-k-on-pet 项目整理），
不属于 MIT，详见 THIRD_PARTY_NOTICES.md。dsh-whale-widget 只有交互思路上的参考，未复制其代码或素材，见 NOTICE。