小鲸鲸陪伴 · dsh-pet-companion

给 DeepSeek Harness 桌面版 / 网页版做的桌宠陪伴插件，以及配套的本地工具与补丁脚本。

一个纯浏览器 UI 的 DSH 插件：左下角常驻一条不惹眼的小胶囊（只显示番茄倒计时），点一下展开完整面板。

桌宠形象与语音来自第三方插件（dsh-pet / dsh-xiaomi-tts），本仓库只包含我们自己写的插件、工具与补丁脚本。

📖 插件介绍：INTRO.md · ⚠️ 现在还不足的地方：LIMITATIONS.md · English

---

一、插件：dsh-pet-companion

功能（v0.5）

标签	功能	花费	依赖
🍅 专注	三模式：番茄钟（25/45/60 预设 + 自定义专注/休息分钟）、正计时（自由计时，可记入统计）、自定义倒计时（任意分钟）；进度环 + 今日统计 + 结束提示音 + 桌宠冒泡	0 token	无（有桌宠时联动冒泡）
🗒 待办	本地待办清单：勾选完成、设为当前专注任务、清理已完成	0 token	无
💧 提醒	喝水 / 久坐本地定时提醒（间隔可调，可试一下）	0 token	无
📚 讲解	输入主题 → 定义 + 要点 + 比喻 + 自测题；历史与复制	≈1 次模型调用	桌宠在运行（借其聊天模型）
✏️ 辅导	贴题目 → 考点 → 分步思路 → 答案 + 卡点提醒	≈1 次模型调用	桌宠在运行
🎮 游戏陪伴	开关先记住（后续接前台窗口检测）	—	后续版本
🎤 语音聊天	开关先记住（后续接麦克风与语音识别）	—	后续版本

• 面板形态：完整 / 小胶囊（默认，最不惹眼）/ 小圆点；Alt+P 快速隐藏/展开
• 设置 →「小鲸鲸陪伴」（插件页同款）里可独立开关每个功能、切面板形态、清零今日统计
• 所有数据存本地 localStorage，重启不丢；纯前端、无遥测、无外部请求（讲解/辅导只调本机桌宠接口）

安装

# 从 GitHub 安装（DSH 0.2.x）
dsh plugin --profile desktop add https://github.com/cshengyi023-collab/dsh-pet-companion

或本地路径：

dsh plugin --profile desktop add D:\path\to\dsh-pet-companion

装完重启 DSH，左下角出现小胶囊。

---

二、配套工具（tools/）

目录	说明
tools/桌宠控制台/	Tkinter 小窗口：说话 / 动作 / 试音（8 个预设音色 + 自定义音色设计预设，点谁听谁）/ 显示位置 / 读书入口。桌宠控制台.cmd 双击启动
tools/朗读台/	用桌宠音色读书 / 念讲义 / 朗读剪贴板（朗读剪贴板.cmd）。长文按段合成、自动拼接
tools/陪伴服务/	本地定时陪伴：番茄钟 / 久坐 / 喝水 / 整点问候 → 桌宠气泡（0 token）。陪伴服务.cmd 启动、开机自启.cmd 登记开机启动

工具是给自己电脑写的：脚本里有作者本机的绝对路径（C:\Users\...）和运行时路径，用之前按自己的环境改一下。

---

三、补丁脚本（patches/）

对第三方插件的本地增强（只改本地已安装文件，插件升级后需重跑）：

目录	作用
patches/persona/	把桌宠人设改成「小鲸鲸」（小孩心性、会发脾气、爱吃白饭）；给语音插件加「小鲸鲸」音色设计预设（前后端两份清单 + 头像）；修非流式播报
patches/desktop-sound/	桌面宠物按压 Q 弹动画 + 小黄鸭音效 + 修复 hover 标签偏移
patches/key-reveal/	语音插件 API Key 输入框加「显示/隐藏」按钮
patches/voice-fix/	本地兜底语音、稳定音色组合、关闭自动朗读等修复
patches/balance-patch/	桌宠余额按「赠送+充值」合计显示
patches/plugin-icon/	用她的立绘合成插件图标
patches/petctl.py	桌宠命令行控制：state / say / whisper / chat / anim / display
patches/ROADMAP-陪伴能力.md	陪伴能力路线图与已完成清单

这些脚本会修改 node_modules 里的第三方插件文件，请自行确认许可与风险；升级插件后补丁会丢失。

---

四、版本 / 标签

• v0.5.0 — 移除插件里的桌宠显示控制：桌宠显示改回由桌宠插件自己的设置页管理（本插件只做陪伴面板）
• v0.4.4 — 单实例约束：移除「两处都显示」选项，历史 both 配置启动时自动收敛为「仅桌面」，不会再出现第二个她
• v0.4.3 — 桌宠显示选项加上数量说明：仅桌面（1 个）/ 仅界面（1 个）/ 两处都显示（2 个）/ 都隐藏（0 个），避免「怎么有两个」的误会
• v0.4.2 — 修复桌面版（dsh-app:// 页面）里桌宠接口全部调不通：改用同源相对路径（相对地址由宿主协议代理），桌宠显示/隐藏、讲解、辅导、提醒冒泡恢复正常
• v0.4.1 — 修复：切换「待办 / 提醒 / 讲解 / 辅导 / 桌宠」标签时面板空白（渲染函数不支持文本子节点）；新增 jsdom 冒烟测试
• v0.4.0 — 桌宠显示控制：显示位置四选一（都显示/仅桌面/仅页面/隐藏）+ DSH 最小化时自动隐藏，面板新增「🐟 桌宠」标签
• v0.3.0 — 专注计时升级：番茄钟 + 正计时 + 自定义倒计时三模式；可自定义专注/休息分钟；结束记入统计
• v0.2.0 — 陪伴面板 v0.2：进度环番茄钟、今日统计、待办便签、喝水/久坐提醒、讲解/辅导历史与复制、低调模式（小胶囊默认）

五、开发 / 测试

面板是手写 DOM 逻辑，仓库里带了一个 jsdom 冒烟测试（挂载面板 → 点开每个标签 → 切换三种专注模式）：

cd tests
npm i jsdom
node smoke.mjs

退出码非 0 表示有运行时错误。

六、许可

MIT（本仓库自有代码）。桌宠形象、第三方插件与素材版权归各自作者所有。