dsh-whale-pet

<h1 align="center">🐋 DeepSeek 鲸鱼娘桌宠</h1>

<b>DeepSeek Harness 桌面宠物</b> — 蓝发女仆 + 鲸鱼尾动画 · 晓伊神经网络语音 · 撒娇互动 · 任务完成提醒

⚠️ 免责声明

这是一个非官方同人项目，与 DeepSeek 官方（深度求索）无隶属或背书关系。 本项目不用于商业用途。角色素材版权归原作者所有（见文末致谢）， 使用 DeepSeek 品牌名称仅为指明所适配的工具，不构成任何官方授权或关联。

---

✨ 功能

功能	说明
🐋 同人形象	DeepSeek 鲸鱼娘同人动画（透明背景，已去绿幕/品红残留）
🎞️ 状态动画	待机 / 工作 / 完成 / 出错 / 撒娇 / 跳跃，待机变体轮换
🗣️ 晓伊语音	神经网络人声，49 条台词预合成，完全离线播放
🥰 互动	戳一戳随机反应 · 长按摸头 · 双击静音 · 右键菜单 · 三击诊断
📢 提醒	任务完成（跳跃+纸屑+琶音+语音）· 出错安慰 · 审批提示 · 进度播报
🎛️ 音量	总音量 + 语音/音效/庆祝分动作音量（持久保存）
🖱️ 拖动	桌面版全身拖动 · Web 版按住鲸鱼娘拖动

支持 两种形态：

• 🖥️ 桌面版：DSH Desktop（Electron）右下角独立透明置顶小窗
• 🌐 Web 版：浏览器访问 dsh --profile web 时，页面右下角悬浮层

💰 附带功能：余额徽章 + 充值入口

插件还包含一个会话头部余额徽章（/api/balance 代理官方接口）：

功能	说明
💰 余额显示	会话头部显示 DeepSeek 账户余额（如 余额 ¥12.34），每分钟自动刷新
🔄 点击刷新	点击徽章立即刷新余额
⚡ 充值入口	徽章旁的 "充值" 链接，一键跳转 DeepSeek 开放平台充值页
🔒 安全	API Key 只在服务端使用，不会传到浏览器（通过 credentialRef 解析）
🛡️ 容错	网络失败时保留上次余额并标记 stale，不闪断

余额徽章默认随插件一起启用；不需要的话可在 cordis.patch.yml 中移除 client.js 的注入，或保持插件但忽略徽章（不影响桌宠功能）。

📦 安装

要求

• Windows
• 已安装 DeepSeek Harness 桌面客户端 和/或 npx 版 dsh

方式一：DSH 插件命令（推荐，自动激活）

dsh plugin --profile web add github:aceice01/dsh-whale-pet

无 dsh 命令时用：npx @deepseek-ai/dsh plugin --profile web add github:aceice01/dsh-whale-pet

插件自带 dsh.bundle 声明，安装后自动挂载（余额徽章 + Web 悬浮桌宠），无需手动编辑 cordis.patch.yml。 安装后重启 DSH 桌面应用 / dsh web 服务生效。

方式二：一键安装脚本

powershell -ExecutionPolicy Bypass -File install.ps1

脚本自动安装到两个 profile 并启用插件（自动备份原文件）：

版本	Profile 路径
桌面版	%APPDATA%\dsh-desktop-client\dsh\profiles\web
Web 版	%USERPROFILE%\.dsh\profiles\web

安装后重启 DSH 桌面应用 / dsh web 服务生效。

其他选项

install.ps1 -Target desktop   # 只装桌面版
install.ps1 -Target web       # 只装 Web 版
install.ps1 -Uninstall        # 卸载
install.ps1 -DryRun           # 预览，不实际改动

（可选）应用 main.js 补丁 —— 修复"关闭客户端桌宠不消失"

DSH Desktop 原版 main.js 有一个小问题：关闭主窗口时桌宠窗口不会同步关闭， 桌宠会残留在屏幕上。apply-main-patch.ps1 提供修复（让桌宠随主窗口一起关闭）：

powershell -ExecutionPolicy Bypass -File apply-main-patch.ps1          # 应用补丁
powershell -ExecutionPolicy Bypass -File apply-main-patch.ps1 -Revert # 还原
powershell -ExecutionPolicy Bypass -File apply-main-patch.ps1 -DryRun # 预览

如果 DSH Desktop 装在 C:\Program Files，需要以管理员身份运行 PowerShell。 补丁会备份原 main.js（patch/main.js.original），可随时还原。 应用后重启 DSH Desktop 生效。

🎮 使用

桌面版

操作	效果
按住角色任意位置	拖动窗口
单击帽子	戳一戳（65% 撒娇 / 20% 蹦跳 / 15% 委屈）
长按帽子 0.7s	摸头（开心蹦跳 + "被主人摸头啦"）
双击帽子	静音 / 恢复
右键帽子	功能菜单（总音量 / 语音 / 音效 / 庆祝音量 · 测试语音 · 诊断 · 版本 · 刷新）
三击帽子	TTS 诊断面板

Web 版

操作	效果
按住鲸鱼娘	拖动悬浮面板
右上角 ✕	隐藏（变 🐋 按钮）
点击 🐋	恢复

🏗️ 架构

dsh-balance-widget/          # Cordis 插件（服务端 + 客户端）
└── lib/
    ├── index.js             # 服务端：/pet.html /api/status /api/balance
    │                        #   - 从 session firehose 监听 turn/tool/todo/goal/approval
    │                        #   - /api/status 输出工作状态供桌宠轮询
    ├── client.js            # 客户端：会话头部余额徽章 + Web 版悬浮桌宠
    └── pet.html             # 桌宠页面（动画 + 语音 + 交互，1.5MB 内嵌资源）

工作流：

…