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 所有，仅作个人非商业用途示例；二次分发前请替换为你自己的素材（见上文换图教程）。