前言¶
在 DeepSeek Harness（DSH）里写代码、跑智能体时，界面往往被对话和工具占满。若还想在本地做专注计时、记待办、定时喝水或久坐提醒，通常要另开浏览器标签或独立小工具，和 DSH 窗口割裂。讲解、作业辅导若走云端对话，又会多占一轮模型调用与注意力。
小鲸鲸陪伴（dsh-pet-companion）是社区维护者 cshengyi023-collab 为 DSH 桌面版 / 网页版写的纯浏览器 UI 插件：左下角常驻一条只显示番茄倒计时的小胶囊，点开即完整陪伴面板。计时、待办、本地提醒不消耗 token；讲解与辅导通过本机已安装的桌宠插件接口调用模型，花费约一次调用。桌宠形象与语音来自第三方插件（如 dsh-pet、dsh-xiaomi-tts），本仓库只包含陪伴面板及配套工具、补丁脚本。
这是什么¶
- 定位：DSH 插件，低干扰陪伴面板（番茄钟、待办、喝水/久坐提醒、课程讲解、作业辅导）。
- 维护者：cshengyi023-collab。
- 当前版本：v0.5.0（
package.json）；引擎要求 DSH>=0.2.0-rc.2 <0.3.0-0。 - 许可：本仓库自有代码为 MIT；桌宠形象与第三方插件素材版权归各自作者。
面板数据存浏览器 localStorage，重启不丢；纯前端、无遥测；除讲解/辅导走本机桌宠接口外，无外部请求。
核心功能（v0.5）¶
下面按 README 功能表归纳，花费与依赖与仓库说明一致。
专注（0 token）¶
三模式：
- 番茄钟：25/45/60 预设，或可自定义专注/休息分钟。
- 正计时：自由计时，可记入今日统计。
- 自定义倒计时：任意分钟。
带进度环、今日统计、结束提示音；若桌宠在运行，可联动冒泡。
待办（0 token）¶
本地清单：勾选完成、设为当前专注任务、清理已完成。
提醒（0 token）¶
喝水、久坐本地定时提醒；间隔可调。
讲解（约 1 次模型调用）¶
输入主题 → 定义、要点、比喻、自测题；支持历史与复制。依赖：桌宠在运行（借用其聊天模型）。
辅导（约 1 次模型调用）¶
贴题目 → 考点、分步思路、答案与卡点提醒。依赖：桌宠在运行。
面板形态与快捷键¶
- 形态：完整 / 小胶囊（默认） / 小圆点。
Alt+P：快速隐藏或展开面板。
在 DSH 设置 →「小鲸鲸陪伴」（与插件页同款）可独立开关各功能、切换面板形态、清零今日统计。
规划中（当前仅记住开关）¶
游戏陪伴、语音聊天在 README 中标注为后续版本，尚未接前台窗口检测或麦克风。
安装与启用¶
安装命令须使用仓库原文（DSH 0.2.x，desktop profile）：
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，左下角应出现小胶囊。若讲解/辅导要用，需另行安装并运行桌宠相关插件；本插件 v0.5.0 起不再内置桌宠显示控制，桌宠显隐由桌宠插件自己的设置页管理。
典型用法¶
- 低调专注：保持默认小胶囊，看倒计时；需要时点击展开，选番茄钟或正计时，结束听提示音并查看今日统计。
- 待办与专注联动：在待办里勾选任务，将某项设为当前专注任务，再开计时。
- 本地健康提醒：在提醒标签调整喝水/久坐间隔，到点本地提示（可先试间隔是否合适）。
- 讲解 / 辅导：确认桌宠已运行后，在对应标签输入主题或题目，结果可从历史复制；每次大约一次模型调用。
仓库 tools/ 下还有 Tkinter 桌宠控制台、朗读台、本地陪伴服务等 Windows 向脚本（含作者本机路径，使用前需按自己环境修改）；patches/ 为第三方插件本地增强，升级第三方插件后需重跑，并自行确认许可与风险。正文不展开补丁细节，见 GitHub README。
开发侧冒烟测试（挂载面板、点各标签、切换专注模式）：
cd tests
npm i jsdom
node smoke.mjs
退出码非 0 表示运行时错误。
适用场景与注意¶
适合：已在 DSH 0.2.x 桌面 profile 下工作，希望计时、待办、提醒留在同一窗口；愿意配合本机桌宠做讲解/辅导；偏好本地存储、少打扰 UI 的开发者或学习者。
注意：
- 插件随当前 DSH 进程在浏览器环境中运行，安装前建议阅读 源码 与 MIT 许可；讲解/辅导权限与花费取决于桌宠插件配置。
- 社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。
- 不足与限制见仓库 LIMITATIONS.md。
结尾¶
dsh-pet-companion 把常见陪伴能力收进 DSH 左下角：本地功能 0 token，模型能力只用在讲解与辅导，并与桌宠联动。需要安装或 issue 时，可打开目录页与仓库：
- 目录页：https://www.skillhub.cn/plugins/cshengyi023-collab/dsh-pet-companion
- GitHub：https://github.com/cshengyi023-collab/dsh-pet-companion
