dsh-Dfy：DeepSeek Harness 里的余额挂件与桌宠一体化插件

它是做什么的？

Dfy 是 DeepSeek Harness（DSH）的桌宠与挂件套件插件，把余额监控、桌面宠物和 QQ 消息卡整合进同一个 DSH 插件。它解决余额与用量看不清、桌宠和挂件要分别安装多个包的麻烦，用一个插件同时提供小鲸鱼余额挂件、106 段透明动画桌宠与 QQ 消息卡。QQ、B站与双向脱敏记忆由包内自带的 SurfCore 后端提供，数据只存本机。

核心功能

• 余额与用量：每 60 秒刷新，按余额差与会话事件记账，每轮真实 usage 换算金额，并给出近 7 天与按日明细。
• 峰谷提示：峰谷状态与倒计时常驻角色左下角，节假日按谷价计算。
• 小鲸鱼挂件：5 套表情共 133 张，支持情绪、眨眼、卖萌、泡泡编辑器与音效。
• 桌宠动画：106 段透明动画、13 个动作分类，支持 Q 弹、弹簧拖拽、甩抛、屏幕漫游、分身与双击弹弓。
• 双形态共存：小鲸鱼与桌宠可同时显示，各自独立位置与大小。
• QQ 与 B站：QQ 提供信封角标与消息、记录、写消息三视图，桥接走 SnowLuma；B站支持扫码登录、动态评论互动与鱼群保护。

怎么使用这个插件？

在 DSH 中启用后，先配置余额来源：填写 API Key，或在 DSH「设置 → 账号与余额」登录，鲸鱼旁出现数字即成功。接 QQ 时在设置页点「一键开始」，拉起桥接后在 SnowLuma 窗口扫码登录，20 秒后回设置页点「重新检测」，桌宠旁出现信封角标即可收发消息。点小鲸鱼打开菜单，可切换小鲸鱼、桌宠、共存三种形态，调整大小、动作、表情与音效；控制台改动需点「保存配置」才生效。B站与记忆卡为可选模块，不接则不会请求对应接口。

报错怎么排查？

挂件不出现时，确认安装方式不是 github 规格，并按手动流程走完后完全退出 DSH 再重开。提示找不到模块说明依赖未安装，按官方说明补齐依赖。余额提示未配置时，补上 API Key 或登录 DSH 账号；今日已用显示 -- 是因为还没有一次成功的余额观测。保存报 403 说明只允许本机用 127.0.0.1 操作。信封不出现多为桥接未运行或 SnowLuma 未登录，扫码后点「重新检测」；卡片没声音则依次检查卡片静音、全局音量与系统静音。