前言¶
在 DeepSeek Harness（DSH）里写提示词、跑对话、切面板是常态。番茄钟若放在浏览器标签或独立 App，切回 DSH 时既容易忘记当前轮次，也很难和「这一轮要完成什么」对齐。社区插件 dsh-pomodoro 把计时器挂进 DSH Web 侧边栏：大圆环倒计时、专注/短休/长休三种模式，切换对话或其它面板时倒计时继续走，轮次结束还会在整窗 Toast 提醒。下面按定位、功能、安装与用法说明如何接入。
这是什么¶
dsh-pomodoro（GitHub：ChenYichener/dsh-pomodoro）是由维护者 ChenYichener 发布的 客户端（Web） 类 DSH 插件。简介为：在侧边栏提供无干扰的 Pomodoro 专注计时——专注、短休、长休轮次，每轮可填目标，带当日统计与完成记录；在其他面板工作时倒计时仍运行。
依赖 DSH 的 Web UI 与 Client 插件 API；package.json 标明许可证 MIT、Node.js >= 20，插件版本 0.1.0。README 注明在 DSH 0.2.2-rc.1 上测试；无额外运行时依赖，无需构建步骤。
核心功能¶
侧边栏入口与状态¶
插件通过 Client API 注册 sidebar.panellist 行（id pomodoro，order 21）。若已安装 dsh-book，入口排在 写作 下方，否则排在 shell 自有入口之后。点击后 shell 选中 main.pomodoro 全页计时界面。一轮运行中时，侧边栏图标带绿色角标。
无干扰计时页¶
页面以大块进度环（最大约 560px）和 112px 等宽数字倒计时为主；专注 / 短休 / 长休三个模式 Tab、一行目标输入与控制按钮次之，无卡片边框。当日统计与完成记录在两个可折叠面板里。
三种模式与设置¶
默认：专注 25 分钟、短休 5 分钟、长休 15 分钟；每完成 N 个番茄（默认 4）进入长休。时长与 N 均在 Settings 中可调（见下文设置表）。
每轮目标与操作¶
目标最多 120 字符，随下一次完成的专注轮写入完成日志。主按钮随状态显示 Start / Pause / Resume；Reset 恢复当前模式满时长且不改动当日统计；Skip 在专注→短休、休息→专注间跳转，被跳过的专注轮不计入番茄数。
当日统计与日志¶
页脚显示当日番茄数与专注总分钟；Completed 面板按时间倒序列出每条：时间、目标（空则显示如 “Writing focus”）、分钟数。两次点击 Clear 可清空当日记录（含进度计数）。
切换面板不掉钟¶
倒计时由模块级 store 持有，而非仅挂在当前 React 页面上；切到对话或其它面板不暂停，再打开 Pomodoro 面板可恢复显示。store 将可持久化状态写入 localStorage；页面关闭期间到点的轮次会在下次打开时补记完成；本地零点切换日期时滚动当日统计。
全窗完成提示¶
轮次结束时向 shell.overlay 注册 Toast（约 6 秒），任意面板可见（如 “Pomodoro complete — take a 5-minute break”）。可选两声调 Completion chime（WebAudio）；可在设置中关闭。
主题与语言¶
颜色使用宿主 --dsw-alias-* 主题令牌；中英文文案通过 Client locale 服务注册。
安装与启用¶
前提：本机已安装带 Web UI 的 DeepSeek Harness（dsh），且运行环境 Node.js >= 20。
从 GitHub 安装（推荐）¶
将 <profile> 换成实际配置名；不确定时 README 建议默认多为 web（dsh web 所用），可用 dsh plugin --profile web list 核对。
dsh plugin --profile <profile> add github:ChenYichener/dsh-pomodoro
DSH 桌面应用¶
在应用的 Plugins 页面从本地目录安装。该插件为常规 profile bundle，随 dsh 重启与升级保留。
安装后重启 dsh web 或重载 DSH 窗口，侧边栏会出现 Pomodoro 入口。
典型用法¶
- 打开侧边栏 Pomodoro，进入全页计时器。
- 在环下方输入本 round 目标（可选）。
- 用上方 Tab 选专注 / 短休 / 长休（切换会停表并载入该模式满时长）。
- 点主按钮开始或暂停；用 ⟲ 重置、⏭ 跳过阶段。
- 页脚 Settings 调时长与长休间隔、提示音；Completed 查看或清空当日记录。
文档明确：无全局快捷键，交互以点击为主。在其他面板工作时倒计时继续；侧边栏图标绿标表示进行中。
设置项默认值（摘自 README）¶
| 设置 | 默认 | 范围 | 步进 |
|---|---|---|---|
| Focus length | 25 min | 5–90 min | 5 min |
| Short break | 5 min | 1–30 min | 1 min |
| Long break | 15 min | 5–60 min | 5 min |
| Long break every | 4 pomodoros | 2–8 | 1 |
| Completion chime | On | On / Off | — |
当前模式闲置时改对应时长会立即更新可见倒计时；改长休间隔会按新间隔约束当前周期进度。
适用场景与注意¶
适合谁： 长期在 DSH Web UI 内迭代码、写提示词或处理对话，希望番茄钟与工作环境同屏、且不因切面板而停表的用户。
权限与安全： 插件随当前 dsh 进程与用户配置加载，行为以仓库源码为准。安装前建议浏览 GitHub 仓库 与 MIT 许可证；插件数据主要存于浏览器 localStorage，不含 README 所述的外部服务依赖。
生态说明： DSH 采用「一切皆插件」思路；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
经过上面的步骤，你可以在 DSH 侧边栏获得一个与主题一致、可双语、切换面板仍计时的 Pomodoro 面板。目录与源码：
- 目录页：https://www.skillhub.cn/plugins/ChenYichener/dsh-pomodoro
- GitHub：https://github.com/ChenYichener/dsh-pomodoro
