前言¶
在 DeepSeek Harness（DSH）里长时间跑对话，余额和每轮 token 消耗往往要切回客户端或另开工具才能看清。若你已经在 Windows 上使用第三方桌宠 WuwaTappo，可以把账算在本地，再通过桌宠气泡展示，而不必改 DSH 主界面。下面介绍社区插件 dsh-wuwa-pet：它不替换桌宠、也不改 Harness 界面，只负责读取账号余额、按官方价目估算用量，并用 CDP 把信息画在桌宠头顶。
这是什么¶
dsh-wuwa-pet 由维护者 OolongBlackCoffee 发布，分类为客户端插件，许可证 MIT，当前 package 版本为 1.4.1。插件通过 DSH 的 Cordis 机制注册，入口为 lib/index.js。DeepSeek 与 WuwaTappo 均为非官方关联的第三方组合；插件会在 WuwaTappo 安装目录的可执行文件启动参数里注入远程调试端口，使用前需自行评估风险并保留备份。
核心功能¶
README 中列出的能力如下，金额均在本地估算，官方账单为准；插件不向第三方服务器上报数据。
| 能力 | 说明 |
|---|---|
| 余额胶囊 | 桌宠头顶常驻「余额 · 今日已用」，随对话刷新，默认 60 秒缓存（balanceTtlMs） |
| 每轮消耗弹泡 | 一轮对话结束显示如 -¥0.0432 · 12,345 tok，默认停留 5 秒（toastMs） |
| 提问 / 授权常驻提醒 | ask_user_question 或权限确认挂起时，琥珀色「等你回答」气泡保持到处理完成 |
| 峰谷倒计时 | 高峰 / 谷时切换前提醒，计价口径与 README 中官方时段规则一致 |
| 自带账本 | 本地文件 %USERPROFILE%\.dsh\.wuwa-pet-usage.json；可选对接 dsh-whale-widget 历史基线，不装也能用 |
| 静音子智能体 | 子智能体轮次默认不弹泡（muteSubagent: true） |
| 碎碎念（1.4.1） | 可配置周期与台词池，间歇冒泡后自动消失 |
环境要求：Windows、已安装并能登录的 DSH、Node.js ≥ 20.11（DSH 自带运行时即可）、已安装的 WuwaTappo（本仓库不包含桌宠本体）。
安装与启用¶
装完后需重启一次 DSH，并在 插件 → 已安装 中确认开关打开。三种方式以 README 为准，按省事程度排序。
A. 预构建包（推荐）
- 到 Releases 下载
dsh-wuwa-pet-1.3.0.tgz（README 示例文件名；也可选更新 Release 中的包，与本地 DSH 版本匹配即可）。 - 执行：
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），同意即可；README 说明本插件无编译步骤，仅为安装依赖。
C. 源码目录链接
面向改代码的场景：克隆仓库后在 desktop profile 用 pnpm add "link:…" 并手动把 dsh-wuwa-pet 写入 dsh.profile.bundles，细节见仓库 README「安装 → C」。
首次加载且 autoDeploy: true 时，插件会自动运行 CDP 补丁脚本；若 WuwaTappo 正在运行，会先关闭再修改启动参数后重新拉起。
CDP 补丁（使用前必读）¶
气泡通过 Chromium 远程调试协议（CDP）注入 WuwaTappo 页面；桌宠默认不开放调试端口。插件附带 tools/deploy-cdp.ps1，在启动参数中写入与下列等价的选项（并保持参数区长度与原来一致，逐字节写入并尾部补空格）：
--remote-allow-origins=* --remote-debugging-port=9222 --autoplay-policy=no-user-gesture-required
WuwaTappo 官方更新可能覆盖补丁，因此默认在每次 DSH 加载插件时重新检测并补全。手动等价命令：
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\dsh-wuwa-pet\tools\deploy-cdp.ps1" -Quiet
将路径换成你本机插件目录。若不想自动改 exe，在配置中设 "autoDeploy": false，需要时再手动执行；还原可用 tools\还原CDP.bat（从 *.orig 备份写回）。不做 CDP 步骤时插件无法绘制气泡，但不影响 DSH 本身运行。
配置¶
在 profile 的 cordis.patch.yml 插件条目下设置 config，示例：
- insert:
- id: dsh-wuwa-pet
name: dsh-wuwa-pet
config:
autoDeploy: true
cdpPort: 9222
soundOn: true
volume: 0.55
常用键包括：tickMs / idleTickMs（轮询间隔）、notifyOnTurnEnd、notifyOnWait、waitTtlMs、questionTool（默认 ask_user_question）等，默认值与含义见 README 配置表。
典型用法与排错¶
正常使用流程：安装插件 → 重启 DSH → 启动 WuwaTappo（经补丁带 9222 端口）→ 在 DSH 中对话。头顶应出现余额胶囊；每轮结束可看到消耗泡；挂起提问或授权时出现常驻提醒。
README 排错摘要：
- 无气泡：查看
runtime-diag.json中link.connected是否为true；为false时检查 CDP 端口与deploy-cdp.ps1。 - 余额显示「—」：确认 DSH 已登录且账号接口可达。
- 金额与自算略有偏差：缓存命中价与跨高峰边界会导致估算尾差。
- 端口占用：同步修改
cdpPort与deploy-cdp.ps1 -Port。
本地自检可运行：
node tools\selftest-selfcost.mjs
node tools\selftest-ledger.mjs
node tools\test-smoke.mjs
适用场景与注意¶
适合在 Windows 上同时使用 DSH 与 WuwaTappo、希望用桌宠气泡盯余额与单轮消耗、并愿意接受对桌宠 exe 启动参数补丁的开发者。插件以当前 DSH 进程权限运行，安装前应在 GitHub 阅读源码与 MIT 许可证，并理解修改第三方程序安装目录的风险。
DSH 生态采用「一切皆插件」思路；社区目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的客户端插件，而非官方应用。
结尾¶
dsh-wuwa-pet 把 DeepSeek 余额、今日用量、峰谷提醒和每轮消耗集中到 WuwaTappo 头顶，本地记账、无遥测。目录页：https://www.skillhub.cn/plugins/OolongBlackCoffee/dsh-wuwa-pet；源码与完整说明：https://github.com/OolongBlackCoffee/dsh-wuwa-pet。
