dsh-mascot-xiadie：DeepSeek Harness 悬浮小人余额小管家

在 DeepSeek Harness（DSH）的开发与使用流程中，监控 API 余额与 Token 消耗是常见需求。dsh-mascot-xiadie 提供了一个网页插件，在屏幕上悬浮一个可交互的 Q 版小人（遐蝶），用于实时播报账户余额与用量。

安装与启用¶

该插件隶属于 DSH 生态的“趣味换装”类别，由维护者 Edison-q 开发，采用 MIT 协议开源。

安装过程需要通过 DSH 的命令行工具完成：

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

使用前需在 DSH 设置的模型配置中添加 DEEPSEEK_API_KEY，否则无法查询余额。此外，插件的“今日/全机 tokens”数据来源为本地 dsh-usage-plugin 的记录。

核心功能¶

该插件在 DSH 网页界面中提供一个悬浮的小人，具备以下核心能力：

1. 实时播报：悬浮小人会实时播报账户余额与 Token 用量。
2. 交互操作：支持单击、双击、连点等交互，小人会根据状态切换表情与台词。
3. 右键菜单：右键点击可唤出菜单，包含“统计 / 进度 / 总账”选项，以及调节小人大小（120–360px）的滑块。
4. 拖拽与吸附：小人可拖动至任意位置，靠近屏幕边缘松手会自动吸附，位置记忆功能会记住上次的位置。
5. 里程碑庆祝：当全机累计 Token 跨越 100 万的倍数时，会触发庆祝状态（图1 + 庆祝气泡）。
6. 数据存储：所有数据存储在本地（%LOCALAPPDATA%），不上传服务器。

交互操作¶

小人的状态与反应基于特定的操作触发，具体如下：

每次点击均有摸头 Q 弹效果。播报气泡与反应气泡（持续 2 秒）会叠放共存，各自计时。

自定义配置¶

换图¶

默认素材来源于《崩坏：星穹铁道》，如需更换，可按状态命名图片文件（推荐 PNG 透明底）：

• state1.png：伤心（里程碑）
• state2.png：待机
• state3.png：害羞
• state4.png：无语
• state5.png：严谨 · 播报

放置方式二选一（修改后需重启 dsh web）：
1. 替换插件目录 assets/ 下的同名文件。
2. 设置环境变量 DSH_MASCOT_DIR 指向包含这些图片的目录。

换台词 / 换配色¶

1. 复制默认 JSON 配置文件（见下文）。
2. 修改 name（角色名）、accent（主题色）、lines（台词）等字段。
3. 设置环境变量 DSH_MASCOT_CONFIG 指向该 JSON 文件。

示例配置（仅展示部分关键字段）：

{
  "name": "遐蝶",
  "accent": "#c4a8f5",
  "lines": {
    "report": "余额还剩 ¥{balance}。今日消耗 {tokens}。",
    "shy": "不要再摸我啦",
    "milestone1": "累计已使用 {tokens} Tokens……",
    "milestone2": "项目会越来越成功的哦！"
  }
}

数据口径与存储¶

• 余额：来源于 DeepSeek 官方 GET /user/balance 接口，实时。
• 今日 / 全机 tokens：读取本地 dsh-usage-plugin 记录，口径为北京时间。
• 本项目 tokens：本插件按会话工作区（文件夹）实时记账，新项目从零开始。

所有数据均存储在本地，不上传任何服务器。

版权说明¶

插件代码以 MIT 协议开源。assets/ 目录中的角色立绘（state1–5.png）为《崩坏：星穹铁道》官方素材，版权归 © miHoYo 所有，仅作个人非商业用途示例；二次分发前请替换为你自己的素材。

插件目录： https://github.com/Edison-q/dsh-mascot-xiadie