前言¶

在 DeepSeek Harness（DSH）里长时间对话或写代码时，很容易失去对时间的感知。系统闹钟、浏览器标签页或独立番茄钟应用可以计时，但往往和当前工作界面脱节，切出去看一眼又打断思路。下面介绍社区插件 dsh-pomodoro-timer（维护者 cuznmop）：它把专注 / 短休息 / 长休息周期嵌进 DSH Web UI，侧栏有整页控制，输入框旁还有可点击的倒计时胶囊，聊天时也能看到剩余时间。

这是什么¶

dsh-pomodoro-timer 是面向 DSH Web 客户端的番茄钟插件：左侧栏时钟图标打开完整计时页（进度环、控制按钮、统计）；消息输入框旁显示紧凑倒计时，点击可跳到该页。状态只写在浏览器 localStorage，无 Host 侧服务、无工具、无网络访问。包版本 1.0.1，许可证 MIT；npm 包名与仓库一致，见 GitHub 与 SkillHub 目录页。

核心功能¶

界面与入口¶

• 侧栏整页：左侧面板列表中的时钟图标打开番茄钟页，含进度环、控制与统计。
• Composer 胶囊：消息框旁显示倒计时；点击跳转侧栏页。在聊天中工作时计时仍继续。

周期与控制¶

默认周期为专注 25 分钟、短休息 5 分钟、长休息 15 分钟；每完成 4 个番茄后进入长休息。可选「下一阶段自动开始」。

阶段自然结束时播放三声短提示音（可关闭；页面需先有一次用户交互，浏览器才允许播放音频）。若在暂停时改时长，当前阶段立即按新时长调整；若正在运行，新时长从下一阶段生效。

统计与持久化¶

页面上显示当前轮次番茄序号与今日完成数；今日计数在午夜归零。运行中的截止时间写入 localStorage 键 dsh.plugin.pomodoro-timer.v1，刷新页面后从同一倒计时继续。

主题与语言¶

颜色均使用 --dsw-alias-* 主题令牌；插件不 import Harness 客户端包，以降低内部 API 变动带来的影响。界面随 GUI 语言在简体中文与英文间切换。

环境与要求¶

插件注册到 sidebar.panellist、main、conversation.composer.dock，不替换应用根节点，不向 document.body 追加节点。

安装与启用¶

Web profile 下，在资料给出的命令安装：

# plain dsh web profile
dsh plugin --profile web add dsh-pomodoro-timer

Desktop 应用可从插件市场页安装，或在 Settings → Plugins 中安装 dsh-pomodoro-timer。安装后重启 Harness 或刷新页面，在侧栏面板列表中查找时钟图标。

卸载 Web profile 插件：

dsh plugin --profile web remove dsh-pomodoro-timer

典型用法¶

1. 安装并 reload 后，点侧栏时钟图标打开番茄钟页，或先看输入框旁的胶囊。
2. 在设置里按需调整专注 / 休息时长、长休息间隔、自动开始与提示音。
3. 点 Start 开始专注；暂停、重置、跳过按上表含义使用。
4. 在聊天中继续工作时，依赖 Composer 胶囊查看剩余时间；需要完整控制时再点胶囊或侧栏图标。

适用场景与注意¶

适合在 DSH Web 或 Desktop 界面里做长时间对话、审阅或编码、又希望用标准番茄节奏分段休息的开发者。插件以当前 DSH 进程及浏览器上下文运行；安装前建议阅读 仓库源码 与 MIT 许可证，确认符合你的环境与安全预期。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

问题与反馈可走 GitHub Issues。

结尾¶

dsh-pomodoro-timer 把番茄钟周期、侧栏页与输入框旁倒计时收进 DSH 客户端插件，数据留在本机 localStorage，不额外占 Host 能力。若你已在用 DSH Web 或 Desktop，可按上文命令安装并在侧栏时钟入口试用。

• 目录页：https://www.skillhub.cn/plugins/cuznmop/dsh-pomodoro-timer
• 仓库：https://github.com/cuznmop/dsh-pomodoro-timer
• npm：https://www.npmjs.com/package/dsh-pomodoro-timer