Edison-q/dsh-mascot-xiadie

dsh-mascot-xiadie · Q版遐蝶余额小管家

DeepSeek Harness（DSH）网页插件：一个悬浮在页面上的 Q 版小人，用遐蝶的口吻替你查余额、报账。

玩法

| 操作 | 反应 |
|---|---|
| 单击（待机时） | 查最新数据 → 图5 严谨表情 + 播报"余额还剩 ¥X。今日消耗 Y tokens。"（12 秒） |
| 单击（播报时） | 刷新数据再报一次 |
| 双击 / 三连击（播报时） | 切图3 害羞 + "不要再摸我啦" |
| 连点 8 次（图3 时） | 切图4 无语 + "……" |
| 5 秒不碰 | 回图2 待机（看蝴蝶） |
| 拖动 | 移到任意位置；靠近屏幕边松手自动吸附；位置记住 |
| 右键 | 菜单「统计 / 进度 / 总账」+ 大小滑块（120–360px，位置大小均记住） |

- 每次点击都有摸头 Q 弹效果；
- 播报气泡 = 两团小圆 → 云朵气泡的三段动画，淡紫边白底；
- 反应气泡（2 秒）与播报气泡（12 秒）叠放共存，各自计时；
- 里程碑：全机累计每跨 100 万 tokens，触发图1 + 两条庆祝气泡（"累计已使用 X Tokens……" / "项目会越来越成功的哦！"）。

状态图

| 图 | 状态 |
|---|---|
| state1 | 伤心（里程碑庆祝） |
| state2 | 待机 · 看蝴蝶 |
| state3 | 害羞 |
| state4 | 无语 |
| state5 | 严谨 · 播报 |

安装

dsh plugin --profile web add dsh-mascot-xiadie
dsh web   # 重启后刷新页面

余额查询需要 API Key：在 设置 → 模型 中配置 DEEPSEEK_API_KEY。
"今日消耗 tokens" 来自 dsh-usage-plugin 的本地记录（北京时间口径）。

数据口径（重要）

| 数据 | 来源 | 说明 |
|---|---|---|
| 余额 | DeepSeek 官方 GET /user/balance | 实时 |
| 今日 / 全机 tokens | 读取 @feiyang666/dsh-usage-plugin 的本地记录 | 本机、从安装该插件起算；官网网页 / App 的用量拿不到 |
| 本项目 tokens | 本插件按会话工作区（文件夹）实时记账 | 每个项目文件夹独立账本，新项目从零 |

所有数据均存储在本机（%LOCALAPPDATA%），不上传任何服务器。

换成你的角色（不用改代码）

换图

把图按状态命名（PNG 透明底最佳）：

| 文件 | 状态 |
|---|---|
| state1.png | 伤心（里程碑） |
| state2.png | 待机 |
| state3.png | 害羞 |
| state4.png | 无语 |
| state5.png | 播报 |

放法二选一（改完重启）：
1. 替换插件目录 assets/ 下的同名文件；
2. 设置环境变量 DSH_MASCOT_DIR 指向你自己的图目录。

换台词 / 换配色 / 换角色名

1. 复制下面的默认配置，存成一个 JSON 文件（比如 my-mascot.json）：
2. 改成你喜欢的人设；
3. 设置环境变量 DSH_MASCOT_CONFIG 指向该文件（Windows 可开 PowerShell 执行 setx DSH_MASCOT_CONFIG "D:\path\to\my-mascot.json"，或系统属性 → 环境变量）;
4. 重启 dsh web。

默认配置：

{
"name": "遐蝶",
"accent": "#c4a8f5",
"lines": {
"report": "余额还剩 ¥{balance}。今日消耗 {tokens}。",
"error": "未能读取账目。",
"shy": "不要再摸我啦",
"speechless": "……",
"milestone1": "累计已使用 {tokens} Tokens……",
"milestone2": "项目会越来越成功的哦！",
"project": "本项目累计 {tokens} Tokens……",
"total": "全机累计 {tokens} Tokens。",
"noUsage": "暂无用量记录。",
"noProject": "暂无项目用量记录。",
"noTotal": "暂无全机记录。",
"noStats": "暂无统计"
}
}

- 配置文件不需要写全：只写想改的字段即可，其余自动沿用默认值；
- {balance}、{tokens} 是占位符，播报时自动替换成真实数字；
- accent 是主题色（描边、气泡、菜单、滑块都会跟随），支持 #rgb 和 #rrggbb 格式；
- name 用于图片的替代文本，也建议和台词口吻一致。

License

代码以 MIT 协议开源。

assets/ 中的角色立绘（state1–5.png）为《崩坏：星穹铁道》官方素材，版权归 © miHoYo 所有，仅作个人非商业用途示例；二次分发前请替换为你自己的素材（见上文换图教程）。