前言¶
在 DSH Web 或 Desktop 里写代码、跟智能体协作时，计时器、待办和会话提醒往往分散在不同窗口。系统番茄钟很少和当前工作区、会话状态绑在一起；待办列表也鲜少按「紧急 / 重要」和专注轮次对齐。Pomodoro Pet（仓库名 dsh-pomodoro-pet）是 gitByteFree 维护的 客户端 DSH 插件：侧边栏入口、聊天页右下角可拖拽宠物胶囊、本地统计与备份，并通过 pomodoro_pet 工具让智能体在你确认后再改任务或计时——数据默认留在本机。
这是什么¶
一句话：在 DSH 侧边栏打开番茄入口，开始一轮专注；结束后宠物获得 EXP，统计写入本地。插件还提供四象限任务、专注热力图与周报，并在其它会话需要你批准或回答时，在宠物胶囊上给出只读提醒（不会代你操作会话）。
- 维护者：gitByteFree
- 当前版本：0.10.0（资料：
package.json/ README） - 运行环境：DSH Web 或 DSH Desktop 0.2.1-rc.2 及以上；零 npm 依赖，无需构建
- 许可证：MIT
- 社区目录：SkillHub 插件页
- 源码：github.com/gitByteFree/dsh-pomodoro-pet
安装后你会得到：侧边栏 Pomodoro Pet 入口；聊天页右下角可拖拽的宠物胶囊（剩余时间常显）；Focus / Stats / Settings 等标签；主题与语言跟随 DSH。
核心功能¶
专注计时¶
三种预设：Standard 25 分钟、Deep 50 分钟、Sprint 15 分钟；也可在 5–120 分钟之间自定义。支持开始、暂停、继续、停止；专注轮次结束后自动进入短休与长休。DSH 重启后按 deadline 恢复进行中的轮次，并 reconcile 错过的结算。支持铃声与桌面通知（标签页在后台时仍能收到）。
| 模式 | 默认时长 | 适用 |
|---|---|---|
| Standard | 25 min | 日常与常规工作 |
| Deep | 50 min | 编码、写作等需要沉浸的任务 |
| Sprint | 15 min | 起步或清空小项 |
四象限任务¶
任务分为 A 紧急且重要 / B 重要不紧急 / C 紧急不重要 / D 其它。可为任务估算番茄数并将专注轮绑定到任务；EXP 与象限相关。支持象限间拖拽、完成或重新打开、按象限筛选，以及任务分组。
养成宠物¶
每完成一轮专注获得 EXP，进化路径：Sprout → Red fruit → Glowing fruit → Rainbow king。情绪随专注、休息、放弃与升级变化；可喂食、打招呼。18 项成就奖励装扮碎片，10 个碎片可兑换 4 套装扮之一。宠物可缩放、任意拖拽，或收进紧凑胶囊（倒计时与暂停、停止仍可用）。
统计与导出¶
近六个月或全年 专注热力图；周专注时长、时段分布（早 / 午 / 晚 / 深夜）、象限分布；按 session 与 workspace 归因；周报、月报；竖版 / 横版分享卡（PNG）与 JSON 备份。另展示 Agent 活动（DSH 是否在跑、今日工具使用、步数等，以 README 描述为准）。
与智能体协作（pomodoro_pet 工具）¶
插件向智能体暴露 pomodoro_pet 工具，可：
- 开始、暂停、停止计时，或查询当前专注状态
- 读取近期统计、列出任务
- 提议新建或修改任务——仅在你在 UI 中确认后才会写入
- 基于当前 session、任务与可用 skills 生成只读专注计划
在对话中可以直接说（README 示例）：
- 「Start a 25-minute focus round」
- 「Show me today’s focus stats」
- 「Add ‘write weekly report’ to quadrant B with an estimate of 2 pomodoros」
当其它 DSH 会话处于等待 approval 或 answer 时，宠物胶囊上方会出现闪烁气泡（带 ❗ 徽章），另有面板 chip、「needs you」卡片与可选桌面通知；点击可跳转到对应会话。插件只做本地观察，不会替你回复、不会改 agent 的 prompt / 工具 / 工作流，也不会写入 session。
数据本地存储¶
不上传、无遥测、无远程调用。Session 名、工作区路径、任务标题仅在本地展示；任务标题默认隐藏。Agent 上下文不会出现在导出文件中。等待提醒来自 DSH 本地 session / approval 事件，仅在本浏览器渲染，不会发给模型。
数据目录：
$DSH_HOME/storages/pomodoro_pet/
每条记录一个 JSON 文档；复制该目录即可迁移。从 0.9.4 及更早版本升级时，首次启动会自动迁移旧版单一文件 pomodoro_pet.json 并保留备份。
安装与启用¶
前提：DSH Web 或 Desktop ≥ 0.2.1-rc.2。Web 与 Desktop 使用不同 profile（Web：~/.dsh/profiles/web；Desktop 独占 ~/.dsh/profiles/desktop），在一侧安装不会出现在另一侧；专注数据目录 $DSH_HOME/storages/pomodoro_pet/ 是共享的。
方式一：插件页 / npm 包名¶
npm 包名：dsh-pomodoro-pet。
Web：Plugins → Installed → Add plugin，输入 dsh-pomodoro-pet 并 Install；重启 dsh web 并刷新浏览器。
Desktop：桌面应用 Plugins → Add plugin，输入 dsh-pomodoro-pet → Install → Enable now；若提示重启，需完全退出后重开。
Shell（勿混用 profile）：
# Web profile
dsh plugin add dsh-pomodoro-pet
# Desktop profile（使用桌面应用自带的 dsh 命令，运行前完全退出应用）
dsh plugin --profile desktop add dsh-pomodoro-pet
通过 npm 安装的 dsh 不能改 Desktop profile；Desktop 也不会加载装进 profiles/web 的插件。
方式二：插件市场索引¶
- 在 DSH Plugins 中启用实验性 Custom plugin indexes，进入 Discover
- Add index source，粘贴：
https://cdn.jsdelivr.net/gh/gitByteFree/dsh-pomodoro-pet@main/market/index.json
- 找到 Pomodoro Pet 并安装
- Web：重启
dsh web并刷新；Desktop：启用实验性插件市场、添加同一索引，安装后 Enable now
索引经 jsDelivr 提供；新版本可能因边缘缓存最多约 12 小时才出现在市场。GitHub 可达时也可使用：
https://raw.githubusercontent.com/gitByteFree/dsh-pomodoro-pet/main/market/index.json
方式三：一键脚本（仅 Web profile）¶
tar -xzf dsh-pomodoro-pet-0.10.0.tar.gz
cd dsh-pomodoro-pet
./install.sh # 安装到 ~/dsh-plugins，profile "web"
脚本拒绝 desktop profile；Desktop 请用方式一。安装后重启：
# 在运行 dsh web 的终端 Ctrl+C 后重新启动
dsh web
自定义路径或 profile：
./install.sh --dest ~/my-plugins --profile web
./install.sh --home /path/to/.dsh --profile web
典型用法¶
- 侧边栏打开 🍅 Pomodoro Pet，在 Focus 选 Standard / Deep / Sprint 或自定义时长，绑定四象限任务后开始专注。
- 忙时把宠物收进聊天页右下角胶囊，仍可见倒计时并暂停或停止。
- 在 Stats 查看热力图、周报，按需导出 PNG 或 JSON 备份。
- 在 DSH 对话里用自然语言让 agent 开计时、查统计或提议加任务，并在 UI 确认变更。
- 其它会话需要你处理时，留意宠物胶囊上的提醒，点击跳转——无需离开当前聊天页盲目切 tab。
适用场景与注意¶
适合：长期在 DSH Web / Desktop 里开发或与 agent 协作、希望番茄钟、艾森豪威尔矩阵和本地统计在同一客户端内完成的人；需要 agent 辅助开计时、读统计、提议任务但仍由人拍板的情况。
注意：
- 插件以当前 DSH 进程的权限运行；安装前请阅读源码与 MIT 许可证，自行评估是否满足环境要求。
- Web 与 Desktop 安装路径分离，按实际使用的客户端选择对应命令或 UI 流程。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的客户端插件，而非官方应用商店条目。
结尾¶
Pomodoro Pet 把番茄计时、四象限任务、本地统计与养成反馈收进 DSH 客户端，并通过只读会话提醒和需确认的 agent 工具，减少在计时器、待办和多个会话 tab 之间来回切换。进一步了解功能与安装细节，见 SkillHub 目录页 与 GitHub 仓库 README。
