桌宠余额气泡 OolongBlackCoffee/dsh-wuwa-pet

dsh-wuwa-pet

把 DeepSeek 的余额 / 今日消耗 / 每轮花费，直接弹在 WuwaTappo 桌宠的头顶上。

一个 DeepSeek Harness（DSH）插件。它不替换桌宠，也不改 DSH 的界面——只是把账算清楚，然后借桌宠的气泡说出来。

气泡效果

它做什么

| 能力 | 说明 |
| 余额胶囊 | 桌宠头顶常驻一条：余额 · 今日已用，随对话自动刷新（默认 60 秒缓存） |
| 每轮消耗弹泡 | 一轮对话结束弹 -¥0.0432 · 12,345 tok，够用 5 秒自动收 |
| 提问 / 授权常驻提醒 | ask_user_question 或权限确认挂起时，琥珀色「等你回答」气泡不会消失，直到你处理完 |
| 峰谷倒计时 | 高峰/谷时切换前提醒，配合官方计价时段 |
| 自带账本 | 不装 dsh-whale-widget 也能算钱：按官方价目表在本地记账（~/.dsh/.wuwa-pet-usage.json） |
| 静音子智能体 | 子智能体的轮次默认不弹泡，避免刷屏 |

金额全部在本地算，不向任何第三方服务器发送数据。

环境要求

- Windows（脚本与桌宠都依赖 Windows）
- DeepSeek Harness（DSH）已安装并能正常登录账号
- WuwaTappo 桌宠（第三方桌宠，本仓库不包含、也不分发它）已安装
- Node.js ≥ 20.11（DSH 自带运行时即可）
- 想算钱还可选装 dsh-whale-widget——不装也能用，只是首次记账没有历史基线

安装

三种方式，按省事程度排序。装完都要重启一次 DSH，之后到 插件 → 已安装 里确认开关是打开的。

A. 预构建包（推荐，免构建授权）

1. 到 Releases 下载 dsh-wuwa-pet-1.3.0.tgz
2. 一条命令装上：

dsh plugin add "C:\Users\你的用户名\Downloads\dsh-wuwa-pet-1.3.0.tgz"

也可以在 插件 → 添加插件 里直接选那个 .tgz 文件。

B. 直接装 GitHub 仓库

dsh plugin add https://github.com/OolongBlackCoffee/dsh-wuwa-pet

如果弹出「需要批准构建（allowBuilds）」，同意即可 —— 本插件没有任何编译步骤，这个批准只是让 pnpm 把依赖装完。

C. 源码 + 目录链接（要改代码时用这种）

1. 拿到代码

git clone https://github.com/OolongBlackCoffee/dsh-wuwa-pet.git D:\dsh-wuwa-pet

2. 挂进 DSH 的配置档

cd $env:USERPROFILE\.dsh\profiles\desktop

以「目录链接」方式加入依赖（改动代码即时生效，不必重装）
node "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\pnpm\bin\pnpm.mjs" add "link:D:\dsh-wuwa-pet"

没有全局 pnpm 时，用上面这种「直接跑 pnpm 的 mjs」写法最稳。装在别处就把路径换成你的 pnpm。

3. 在配置档的 package.json 里登记

编辑 %USERPROFILE%\.dsh\profiles\desktop\package.json，在 dsh.profile.bundles 数组末尾加上包名：

"bundles": [
"……原有条目……", "dsh-wuwa-pet" ]

同时确认 dependencies 里有 "dsh-wuwa-pet": "link:D:/dsh-wuwa-pet"（上一步的 pnpm add 会自动写入）。

4. 重启 DSH

用 A/B 装的话，dsh plugin add 会自动写好依赖和 bundles，不需要手动改 package.json。

第一次加载时插件会自动跑一次 CDP 补丁（见下一节）。如果 WuwaTappo 正在运行，脚本会先关掉它再改、改完再拉起来。

关于「CDP 补丁」（重要）

桌宠的气泡是用 Chromium 远程调试协议（CDP）注入到 WuwaTappo 的页面里的，而 WuwaTappo 默认不开放调试端口。所以插件带了一个小脚本 tools/deploy-cdp.ps1，它在 WuwaTappo 的启动参数里补上：

--remote-allow-origins=* --remote-debugging-port=9222 --autoplay-policy=no-user-gesture-required

并保证参数区长度与原来完全一致（逐字节写入 + 尾部补空格），所以不会破坏程序签名校验以外的任何结构。

- 官方更新会覆盖掉这个补丁 —— 这正是插件默认 autoDeploy: true 的原因：每次 DSH 启动加载插件时，脚本会重新检测，没补就补。等价的命令行是：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\dsh-wuwa-pet\tools\deploy-cdp.ps1" -Quiet

- 不想让它动你的程序？在插件配置里设 "autoDeploy": false，改为需要时手动跑上面的命令。
- 想彻底还原：tools\还原CDP.bat（脚本会从 .orig 备份写回）。

⚠️ 这一步会修改 WuwaTappo 安装目录里的 exe。脚本自身会留 .orig 备份，但请自行确认你接受这一行为；不做这一步，插件只是没有气泡可画，不会影响 DSH。

配置

配置写在 profile 的 cordis.patch.yml（插件条目下的 config）：

- insert:
- id: dsh-wuwa-pet
name: dsh-wuwa-pet
config:
autoDeploy: true # 加载时自动补 CDP 补丁 cdpPort: 9222 # 与 deploy-cdp.ps1 注入的端口保持一致 soundOn: true volume: 0.55

| 键 | 默认 | 作用 |
| autoDeploy | true | 插件加载时自动跑一次 CDP 补丁（WuwaTappo 更新后免手动） |
| cdpPort | 9222 | CDP 端口，必须与启动参数一致 |
| tickMs | 2500 | 忙时轮询间隔（毫秒） |
| idleTickMs | 8000 | 空闲时轮询间隔 |
| balanceTtlMs | 60000 | 余额缓存有效期 |
| notifyOnTurnEnd | true | 每轮结束弹消耗泡 |
| muteSubagent | true | 子智能体轮次不弹泡 |
| notifyOnWait | true | 提问/授权挂起时常驻提醒 |
| waitTtlMs | 180000 | 常驻提醒最长存活时间 |
| questionTool | ask_user_question | 视为「提问」的工具名 |
| soundOn / volume | true / 0.55 | 提示音开关与音量 |
| toastMs | 5000 | 普通气泡停留时长 |

数据与隐私

- 余额：通过 DSH 自己的账号通道读取，只在内存里。
- 用量：优先读 dsh-whale-widget 的本地账本（若安装）；否则用自带账本按官方价目表计算。
- 自带账本落盘在 %USERPROFILE%\.dsh\.wuwa-pet-usage.json，纯本地 JSON，删掉即重置。
- 插件不联网上报、不收集任何遥测。

计价口径（与官方高峰/谷时规则一致）：

- 工作日 09:00–12:00、14:00–18:00 为高峰，其余时段、周末与法定节假日为谷时
- 谷时单价（南向价，元 / 百万 token）：Flash 输入 0.02、缓存命中 1、输出 4；Pro 为上列三倍
- 金额以官方账单为准，这里是估算

排错

| 现象 | 处理 |
| 桌宠头顶没有气泡 | 看 runtime-diag.json 里 link.connected 是否为 true；为 false 说明 CDP 没连上——先确认 WuwaTappo 是用带调试端口的快捷方式启动的，再跑一次 deploy-cdp.ps1 |
| 余额一直是「—」 | DSH 未登录账号，或账号接口暂时不可达 |
| 金额和我自己算的差一点 | 缓存命中价与时间边界（跨高峰）会导致尾差；以官方账单为准 |
| 端口被占用 | 把 cdpPort 和 deploy-cdp.ps1 -Port 改成同一个空闲端口 |
| 改完代码没生效 | 这是 link: 安装，重启 DSH 即可 |

目录结构

dsh-wuwa-pet/
├── lib/
│ ├── index.js 插件入口：事件、账本、气泡调度、自动部署 │ ├── balance.js 余额读取与缓存 │ ├── pricing.js 价目表与单轮计价 │ ├── ledger.js 与 dsh-whale-widget 账本对账（装了才用） │ ├── selfledger.js 自带本地账本（聚合 / 对账 / seed） │ ├── cdp.js CDP 连接与页面发现 │ ├── inject.js 注入/重注入气泡脚本 │ ├── widget.js 注入到桌宠页面里的渲染层 │ └── wait.js 提问/授权挂起检测 ├── tools/ │ ├── deploy-cdp.ps1 CDP 补丁（幂等，带 .orig 备份） │ ├── 一键部署CDP.bat / 还原CDP.bat │ ├── autostart-launch.ps1 开机自启（自动定位桌宠与 DSH 路径） │ └── selftest-.mjs 自检脚本 ├── cordis.patch.yml 插件注册 └── screenshots.json 截图清单

自检：

node tools\selftest-selfcost.mjs
node tools\selftest-ledger.mjs
node tools\test-smoke.mjs

变更记录

- 1.3.0 —— 插件加载时自动补 CDP 补丁（autoDeploy）；脚本去个人化（不再写死安装路径）；补截图与图标
- 1.2.0 —— 自带计价账本，不再依赖 dsh-whale-widget
- 1.1.0 —— 提问/授权挂起时常驻提醒
- 1.0.0 —— 初版：余额胶囊、每轮消耗泡、提示音

免责声明

本项目是非官方第三方插件，与 DeepSeek、WuwaTappo 的开发者均无关联。它会修改 WuwaTappo 安装目录下的可执行文件启动参数，请自行评估风险并做好备份；因使用本项目造成的任何问题由使用者自行承担。请遵守相关软件的服务条款。

License

MIT © 2026 OolongBlackCoffee

dsh-wuwa-pet (English)

一个 DeepSeek Harness 插件，在 WuwaTappo 桌面宠物头顶用气泡显示你的 DeepSeek 余额和每轮花费。

功能

- 宠物头顶常驻余额胶囊（余额 + 今日花费）
- 每轮花费气泡：-¥0.04 · 12,345 tok（带音效，可选）
- ask_user_question 或审批挂起时，显示琥珀色「等你回复」气泡并保持不消失
- 感知高峰/低谷价格
- 内置本地花费账本 —— 不需要其他插件（%USERPROFILE%\.dsh\.wuwa-pet-usage.json）

环境要求：Windows、DeepSeek Harness、Node.js ≥ 20.11，以及 WuwaTappo 桌面宠物（不随插件附带）。

安装（还没上 npm —— 支持两种方式）：

A. prebuilt tarball from Releases (no build step, no build approval)
dsh plugin add "%USERPROFILE%\Downloads\dsh-wuwa-pet-1.3.0.tgz"

B. straight from GitHub
dsh plugin add https://github.com/OolongBlackCoffee/dsh-wuwa-pet

C. from source, for hacking on it
git clone https://github.com/OolongBlackCoffee/dsh-wuwa-pet.git D:\dsh-wuwa-pet
cd $env:USERPROFILE\.dsh\profiles\desktop
node "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\pnpm\bin\pnpm.mjs" add "link:D:\dsh-wuwa-pet"
then add "dsh-wuwa-pet" to dsh.profile.bundles in package.json

装完重启一次 DSH；插件会出现在 Plugins → Installed 下。

气泡层通过 CDP 注入，所以 WuwaTappo 必须以 --remote-debugging-port=9222 启动。tools/deploy-cdp.ps1 会逐字节改写启动器参数（幂等，保留 .orig 备份），并在插件加载时自动运行（autoDeploy: true）。设 "autoDeploy": false 可关闭。

隐私：一切都在本地；无遥测，无第三方请求。花费为估算值 —— 以官方账单为准。

License：MIT。与 DeepSeek 和 WuwaTappo 无隶属关系。