前言¶
DeepSeek Harness (DSH) 在运行智能体时，页面弹出的确认请求或任务完成状态常被用户忽略，尤其是在挂机或切换窗口时。此外，手动监控 GPU/CPU 占用率通常需要打开任务管理器。鲸宝语音桌宠是一个 DSH 插件，它通过语音播报确认与提问、任务完成提醒，以及实时显示系统资源占用，解决了上述问题。它基于 MiniMax H3 图生视频技术，提供流畅的动画效果，是一个兼具工具属性与陪伴功能的桌面组件。
核心功能¶
插件主要包含以下能力：
-
语音提醒与播报
- 确认与提问：当页面弹出“需要确认”的请求框或 Agent 提问时，鲸宝会通过气泡和语音播报提醒。语音使用专属声线（Qwen3-TTS），处理完弹窗后会自动安静，且能智能识别弹窗关闭和自动审批，防止重复播报。
- 任务完成：检测到对话回合结束页脚（
data-turn-tail）时，自动播报“任务完成啦”。这是基于真实任务结束标志触发的，不会误报会话统计或后台任务卡片。
-
实时性能监测
- 通过右键菜单开启“性能监测”功能，鲸宝会显示 CPU、内存、GPU 的实时占用率（1秒刷新）。
- GPU 占用率被用作任务“心跳”指标：数值波动表示任务进行中，数值静止通常表示任务完成或卡死。监测服务内置在插件内，随 DSH 自动启停。
-
H3 真动画与交互
- 使用 MiniMax H3 图生视频技术，生成首尾帧无缝、无残影的流畅动画。包含挥手、眨眼、比心、打哈欠、瞌睡等动作。
- 支持点击/拖拽/缩放交互：左键点击触发卖萌语音与爱心特效；按住拖拽触发被抓动画；滚轮缩放大小（128~512）。
-
情感陪伴与状态机
- 瞌睡状态机：3分钟无操作后，鲸宝会打哈欠、头顶飘💤、歪头瞌睡；鼠标移动后会醒来。
- 报时与关怀：支持整点报时、节日祝福、连续工作50分钟提醒休息、深夜22点后提醒睡觉。
安装与配置¶
注意：v1.8.0 版本起，插件改为官方组合包结构，无需手工复制目录或配置文件。素材存放位置由前端 dist 改为包内 assets，以支持桌面端只读文件系统。
安装命令¶
使用官方 CLI 进行安装：
# 网页版安装
dsh plugin --profile web add github:windfind-02/jingbao-voice-pet
# 桌面端安装（必须使用桌面端专属 CLI）
& 'C:\...\DeepSeek harness桌面端\resources\runtime\cli\bin\dsh.cmd' `
plugin --profile desktop add github:windfind-02/jingbao-voice-pet
安装后需要重启对应宿主（网页版按 Ctrl+F5，桌面端需从托盘退出后重启）。
升级说明¶
如果你是从 v1.7.0 或更早版本升级，必须先卸载旧版再安装新版。v1.8.0 做了破坏性结构调整（改为官方组合包），旧版代码无法直接更新。删除旧安装的路径通常为：
Remove-Item "$env:USERPROFILE\.dsh\profiles\node_modules\@local\dsh-pet" -Recurse -Force
并从各 profile 的 cordis.patch.yml 中移除相关插件 ID。
使用方法¶
安装完成后，鲸宝会出现在对话页面中。
- 开启监测：在桌宠上点击右键，选择“开启性能监测”，即可查看 CPU、内存、GPU 占用。
- 交互操作：
- 点击：触发卖萌语音和爱心特效。
- 拖拽：按住移动位置，位置会被记住。
- 缩放：使用鼠标滚轮调整大小（128~512）。
- 音量控制：通过右键菜单的音量条调节，支持静音和语音总开关。
注意事项¶
- 桌面端限制：桌面端没有刷新快捷键（Ctrl+R/F5 被拦截）。修改配置后，必须通过托盘图标右键 → 退出，然后重新打开程序。临时刷新可在开发者工具 Console 中执行
location.reload()。 - 硬件依赖：GPU 监测功能需要 NVIDIA 显卡。
- 旧版兼容性：旧版本与新版结构不兼容，无法直接通过右键菜单“立即更新”升级，必须卸载重装。
