鲸宝语音桌宠windfind-02/jingbao-voice-pet

🐳 鲸宝语音桌宠（DSH 插件版） / Jingbao Voice Pet (DSH Plugin)

📝 本文档由鲸宝（AI 助手）亲手编写 🐳
📝 Written by Jingbao (AI assistant) 🐳

一个可爱的 Q 版海洋系萌娘女仆桌宠，会一直陪着你的 DSH 对话页面。
基于 MiniMax H3 图生视频 生成的真·流畅动画（首尾帧无缝、无残影），不是普通 GIF 桌宠可比哒～

A cute chibi ocean-style maid girl desktop pet that stays with you on the DSH chat page.
Powered by MiniMax H3 image-to-video real smooth animations (seamless first/last frames, no ghosting) — far beyond a plain GIF pet!

鲸宝待机 / Jingbao idle

⭐ 鲸宝的杀手锏（Killer Features）

🔔 1. 需求确认 & 提问回答 · 语音播报提醒 — 人不在对话页也能听到！

当页面弹出「需要确认」的请求框，或 agent 向你提问（比如"接下来怎么做？"）时，鲸宝不仅会冒气泡提醒，还会用她软萌的专属声线语音播报！这意味着：

- 你不在对话页也能知道有需求在等你确认/回答 —— 挂机跑任务、切到别的窗口，都绝不会错过关键确认
- 处理完弹窗，气泡和语音立即安静下来，不会一直吵你
- 智能防重复播报：同一个弹窗只提醒一次，你处理完绝不会再重复播一遍——连 DSH 弹窗关闭时的 React 重渲染残留、自动审批都能精准识别
- 多弹窗也不慌：连续弹出多个需求时，每个都独立提醒、互不吞没
- 智能识别各种确认框（同意 / 允许 / 批准 / 取消…）和提问框，自动判断你已处理

💡 这是很多"动图桌宠"做不到的——鲸宝是真正会主动提醒你的小女仆！

🎉 2. 任务完成 · 语音播报 — 跑完任务第一时间告诉你！

当你的 AI 任务（对话回答 / 生成 / 分析…）结束的那一刻，鲸宝立刻用软萌声线播报「主人，任务完成啦！」：

- 自动感知任务结束：任务结束后页面上会出现"用时 X秒 · 首 token X秒 · X tok/s"的数据栏，鲸宝检测到就播报
- 第一时间提醒：不用一直盯着页面等结果，鲸宝会用声音告诉你"搞定了！"
- 三种完成台词：随机播报（"主人，任务完成啦！" / "主人，任务已经完成了哦~" / "主人，快来看看任务完成的怎么样吧~"）
- 精准不误报：只认「回合结束页脚」（data-turn-tail，DSH 每个对话回合真正结束的标志），会话统计栏/后台任务卡片/子代理卡/轨迹面板的"耗时/tok/s"都不会误触发——任务没结束，鲸宝绝不乱报

💡 挂机等结果的时候，鲸宝就是你的"任务完成闹钟"——听到声音再回来看，效率翻倍！

📊 3. 三参数实时性能监测 — 你的任务到底还在不在跑，一眼就知道！

右键菜单一键开启性能监测，鲸宝随身显示 CPU / 内存 / GPU 三个实时占用率（1 秒刷新）：

- GPU 占用率是跑生成任务（ComfyUI 等）的"心跳"——数值在动 = 任务还在跑，静止了 = 卡住或完成了
- 不用切窗口、不用开任务管理器，瞄一眼鲸宝就知道任务状态
- 监测服务内置在插件里，随 DSH 自动启停，无需任何手动配置

💡 跑长任务时再也不用焦虑"到底还在不在跑"了——鲸宝就是你的任务心跳监视器！

🇨🇳 中文介绍

🐳 鲸宝能做什么？

鲸宝是一个有温度的小女仆，不只是个动图：

- 会真的动起来：挥手、微笑合十、眨眼、幸福摇头、双手比心、打哈欠、歪头瞌睡、醒来、被抓住——全部是 H3 生成的高清动画，动作流畅自然
- 会说话：点击 / 确认需求 / 回答提问时用专属声线说话，气泡与语音同一句，软萌贴心
- 会察言观色：你离开 3 分钟它就开始犯困打哈欠、头顶飘💤打瞌睡；你鼠标一动它立刻醒来迎接
- 会关心你：整点报时（每小时台词都不同）、节日祝福、连续忙 50 分钟劝你休息、深夜 22 点后提醒别熬夜
- 会回应你：点击它摇头/比心 + 冒出爱心、按住它挣扎着被拖走、准备打字时它好奇地问你要说什么
- 能帮你把关：页面弹出「需要确认」或 agent 提问时，它冒泡 + 语音播报提醒你；你处理完它立刻安静下来
- 还能当性能监测：右键菜单开启后，实时显示 CPU / 内存 / 显卡占用率（1 秒刷新，内置服务随 DSH 自动启停）
- 随你心意：滚轮缩放大小（128~512）、拖到屏幕任意位置（都会记住）、右键菜单里调音量

✨ 功能特性

| 类别 | 功能 |
|---|---|
| 🔔 语音提醒 | 确认弹窗 / agent 提问出现时语音播报 + 气泡提醒，人不在对话页也能听到，处理完自动安静，智能防重复播报 |
| 🎉 任务完成播报 | 任务结束自动语音播报「主人，任务完成啦！」，不用盯着页面等结果 |
| 📊 性能监测 | CPU / 内存 / GPU 三参数实时显示（1 秒刷新），GPU 占用即任务"心跳"，内置服务自动启停 |
| 🎬 真动画 | 挥手 / 微笑合十 / 眨眼 / 幸福摇头 / 双手比心 / 打哈欠 / 歪头瞌睡 / 醒来 / 被抓——全部 H3 生成、首尾帧无缝循环 |
| 🗣️ 语音 | 点击 4 句 + 确认 4 句 + 提问 3 句 + 任务完成 3 句，专属声线（Qwen3-TTS），气泡与语音同句、瞬时出声不叠加 |
| 🎚️ 音量控制 | 右键菜单音量条（默认 70，可调 0~100）+ 小喇叭一键静音（暂停/继续），语音总开关 + 分项开关 |
| 🔄 自动更新 | 启动自动检查 GitHub 新版，鲸宝提醒 + 一键「立即更新」下载替换，重启即升级 |
| 💰 余额显示 | 实时显示 DeepSeek API 余额（并入性能监测第二行），支持定时/手动/对话后刷新，自动读取本地 API Key |
| 🖱️ 交互 | 点击摇头/比心+爱心特效、按住拖拽（被抓动画）、滚轮缩放（128~512）、右键菜单（悬停展开子菜单） |
| 💬 情感陪伴 | 整点报时（每小时不同台词）、节日祝福、劝休息、深夜关怀、待机卖萌 |
| 💤 瞌睡状态机 | 3 分钟无操作 → 打哈欠 → 头顶💤 → 歪头瞌睡循环 → 鼠标一动醒来迎接 |

📦 安装（两种方式）

方式一：一键安装脚本
以管理员身份运行 PowerShell，执行：

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

脚本会自动完成插件复制、素材（含语音）部署、配置注册，并按提示重启 dsh web。

方式二：手动安装

1. 复制插件

把 plugin 目录复制为：
C:\Users\\.dsh\profiles\node_modules\@local\dsh-pet\

2. 部署素材

把 assets 目录里的 pet_.webp / pet_.png / voice_.mp3 复制到 DSH 前端静态目录：
C:\Users\\AppData\Roaming\npm\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-web-frontend\dist\

3. 注册插件

编辑 C:\Users\\.dsh\profiles\web\cordis.patch.yml，追加：

鲸宝桌宠
- insert:
- id: pet
name: '@local/dsh-pet'

4. 重启生效

$conn = Get-NetTCPConnection -LocalPort 3080 -State Listen -ErrorAction SilentlyContinue
if ($conn) { Stop-Process -Id $conn.OwningProcess -Force; Start-Sleep -Seconds 2 }
Set-Location "C:\Users\\AppData\Roaming\npm\node_modules\@deepseek-ai\dsh"
dsh web

然后浏览器打开 http://127.0.0.1:3080 按 Ctrl+F5 强刷。

📊 性能监测

桌宠右键菜单 → 开启「性能监测」即可，无需额外启动服务——监测已内置到插件，随 DSH 启动/停止自动启停，实时显示 CPU / 内存 / 显卡占用率（1 秒刷新，GPU 需 NVIDIA 显卡）。

🎮 操作说明

| 操作 | 效果 |
|---|---|
| 左键点击 | 幸福摇头 / 双手比心 + 红色爱心飞走 + 卖萌语音 |
| 按住拖动 | 被抓动画 + 移动位置（位置会记住） |
| 滚轮 | 缩放鲸宝（128~512，大小会记住） |
| 右键 | 设置菜单（性能监测 / 语音开关 / 音量 / 如何与鲸宝相处，子菜单悬停展开） |

🐳 鲸宝会说什么

- 待机卖萌：随机冒泡（"主人辛苦啦，摸摸鲸宝吧～"等）
- 点击语音："呀！主人戳到鲸宝啦～"、"主人最喜欢鲸宝了对吧？"等 4 句
- 确认语音："主人主人，这里需要你确认一下哦～"等 4 句
- 提问语音："主人主人，有几个方案需要您确认一下哦~"、"主人主人，有一个问题想听听您的意见呢~"、"主人主人，有一个关键问题需要您的决策哦~"
- 任务完成语音："主人，任务完成啦！"、"主人，任务已经完成了哦~"、"主人，快来看看任务完成的怎么样吧~" 3 句
- 整点报时：每小时不同台词，贴合国内作息（9-12 上班 / 12-14 午休 / 14-18 下午班）
- 节日祝福：新年、情人节、儿童节、中秋、国庆、平安夜、圣诞、跨年
- 关怀：连续活跃 50 分钟劝休息、深夜 22 点后提醒睡觉

🎬 动画素材清单

| 动画 | 触发 |
|---|---|
| 挥手 | 整点报时 |
| 微笑合十 / 眨眼 | 待机随机 |
| 幸福摇头 / 双手比心 | 点击（随机） |
| 被抓 | 按住拖拽 |
| 哈欠 → 瞌睡循环 → 醒来 | 3 分钟无操作 / 主人回来 |

🇬🇧 英文介绍

⭐ 杀手锏功能 1：确认与提问的语音提醒——即使你不在页面上也能听到！

当"请确认"对话框弹出，或者智能体向你提问时，鲸宝不只是显示气泡——她还会用可爱的声音说出来！这意味着：

- 即使你没在看页面，也能知道有确认/提问在等待——当你的任务在后台运行或你在另一个窗口时，你绝不会错过关键确认
- 你一处理完，气泡和语音立刻安静下来
- 智能防重复提醒：每个对话框只播报一次——即使 DSH 的 React 重新渲染其关闭的对话框或自动批准，你处理完后也绝不会再次播报
- 多个对话框都能处理：每个堆叠的请求都会独立播报——不会有任何遗漏
- 她能智能识别各种确认对话框（Agree / Allow / Approve / Cancel……）和提问框，并检测你是否已处理

💡 大多数"动态贴纸"桌宠做不到这一点——鲸宝是一位会主动提醒你的女仆！
⭐ 杀手级功能 2：任务完成语音提醒——任务一结束，她立刻告诉你！

你的 AI 任务（聊天回复 / 生成 / 分析……）完成的那一刻，Jingbao 会用她可爱的声音说出 “主人，任务完成啦！”：

- 自动检测任务完成：当任务结束后出现“用时 · 首 token · tok/s”指标栏时，Jingbao 会检测到并播报
- 无需盯着页面——你做其他事情时，Jingbao 的声音会告诉你“完成啦！”
- 3 条随机完成台词：“主人，任务完成啦！” / “主人，任务已经完成了哦~” / “主人，快来看看任务完成的怎么样吧~”
- 精准，不误报：仅在真实任务结束标记时触发——页面刷新和旧消息绝不会导致误报

💡 在等待长任务？Jingbao 就是你的“任务完成闹钟”——听到她的声音就回来吧！

⭐ 杀手级功能 3：实时 CPU / 内存 / GPU 性能监控——立刻知道任务是否还在运行！

从右键菜单启用性能监控，Jingbao 会在她旁边显示 CPU / 内存 / GPU 使用率（每秒刷新）：

- GPU 使用率是生成任务（ComfyUI 等）的“心跳”——数字在动，任务就还活着；如果冻住了，就是卡住或已结束
- 无需切换窗口，无需任务管理器——看一眼 Jingbao 就知道任务状态
- 监控内置于插件中，随 DSH 自动管理——零手动设置

💡 在跑长时间生成？不用再焦虑它是否还在继续——Jingbao 就是你的任务心跳监控器！

🐳 Jingbao 能做什么？

- 真的会动：挥手、双手合十微笑、眨眼、开心摇头、比心手势、打哈欠、打瞌睡、醒来、被抓住——全部为高质量 MiniMax H3 动画
- 会和你说话：点击 / 确认提示 / 提问 / 任务完成时用自己的声音（Qwen3-TTS）说话——气泡文字和语音始终一致
- 会察言观色：如果你离开 3 分钟，她会开始打哈欠并带着 💤 打瞌睡；你的鼠标一动，她就会醒来向你打招呼
- 关心你：整点报时、节日问候、休息提醒、深夜关怀
- 回应你：点击可触发摇头 / 比心手势并飘出爱心，拖动可看她挣扎
- 守护你的确认和提问：对确认对话框和 agent 提问进行语音 + 气泡提醒；处理完后自动安静
- 充当性能监控器：实时 CPU / 内存 / GPU 使用率（1 秒刷新），内置服务自动管理
- 听从你的意愿：滚动调整大小（128–512），任意位置拖动（会被记住），在菜单中调整语音音量

✨ 功能

| 类别 | 功能 |
|---|---|
| 🔔 语音提醒 | 对确认对话框和 agent 提问进行语音提醒 + 气泡——即使离开页面也能听到，处理完后自动安静，防重复，多对话框安全 |
| 🎉 任务完成播报 | 任务完成的那一刻进行语音播报——无需盯着页面 |
| 📊 性能监视器 | 实时 CPU / 内存 / GPU（1 秒刷新）—— GPU 使用率是你的任务“心跳”，内置且自动管理 |
| 🎬 真实动画 | 挥手 / 微笑 / 眨眼 / 摇头 / 比心 / 打哈欠 / 困倦循环 / 醒来 / 被抓起 —— 全部由 H3 生成，无缝衔接 |
| 🗣️ 语音 | 4 句点击台词 + 4 句确认台词 + 3 句提问台词 + 3 句任务完成台词，专属语音（Qwen3-TTS），与气泡文字同步 |
| 🎚️ 音量控制 | 菜单中的音量滑块（默认 70，0–100）+ 静音按钮（暂停/恢复），语音总开关 + 分类开关 |
| 🔄 自动更新 | 启动时自动检查 GitHub 上的新版本 —— 京宝提醒你 + 一键“立即更新”下载并替换，重启即可升级 |
| 💰 余额显示 | 实时 DeepSeek API 余额（合并到性能监视器的第二行），支持定时 / 手动 / 对话后刷新，自动读取本地 API Key |
| 🖱️ 交互 | 点击 → 摇头 / 比心 + 飘浮爱心，拖拽 → 被抓起，滚动 → 调整大小（128–512），右键菜单（悬停子菜单） |
| 💬 陪伴 | 每小时问候、节日祝福、休息提醒、深夜关怀、闲聊 |
| 💤 睡眠状态机 | 空闲 3 分钟 → 打哈欠 → 💤 → 困倦循环 → 你一移动鼠标就醒来 |

📦 安装

方式一：一键脚本（以管理员身份运行 PowerShell）：

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

方式二：手动安装

1. 将 plugin 文件夹复制到：
C:\Users\\.dsh\profiles\node_modules\@local\dsh-pet\

2. 将 assets 中的 pet_.webp、pet_.png、voice_.mp3 复制到 DSH Web 静态目录：
C:\Users\\AppData\Roaming\npm\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-web-frontend\dist\

3. 追加到 C:\Users\\.dsh\profiles\web\cordis.patch.yml：
Jingbao pet
- insert:
- id: pet
name: '@local/dsh-pet'

4. 重启 dsh web，然后打开 http://127.0.0.1:3080 并按 Ctrl+F5。

📊 系统监视器

右键点击宠物 → 启用“系统监视器”。无需额外服务 —— 内置于插件中（CPU / 内存 / GPU；GPU 需要 NVIDIA 显卡）。

🎮 控制

| 操作 | 效果 |
|---|---|
| 左键点击 | 摇头 / 比心 + 飞舞爱心 + 可爱语音 |
| 拖拽 | 被抓起动画 + 移动位置（会记住） |
| 滚动 | 调整京宝大小（128–512，会记住） |
| 右键点击 | 设置菜单（系统监视器开关等） |

🎬 动画列表

| 动画 | 触发条件 |
|---|---|
| 挥手 | 每小时播报 |
| 微笑 / 眨眼 | 随机空闲 |
| 摇头 / 比心 | 点击（随机） |
| 被抓起 | 按住并拖拽 |
| 打哈欠 → 困倦循环 → 醒来 | 空闲 3 分钟 / 你回来时 |

📄 许可证 / License

- 代码 / Code：MIT License（见 LICENSE）
- 形象素材 / Character art：AI 生成（Krea 2 + MiniMax H3），随插件开源，请保留署名 @jingbao-voice-pet

🙏 致谢 / Credits

- 动画生成 / Animations：MiniMax H3 (ComfyUI)
- 形象设计 / Design：由她的师父选定的“鲸宝”造型
- 语音 / Voice：Qwen3-TTS
- 图标 / Icon：由鲸宝自己绘制 🐳