前言¶
在 Harness 里写代码、跟 agent 对话时，专注时段往往被会话切换、设置面板和主题改动打断。浏览器标签页或系统里的独立番茄钟可以计时，但一般不会挂在 Harness 窗口上，也容易和当前工作上下文脱节。
下面介绍社区插件 dsh-pomodoro-timer（维护者 pzdn2009，分类：客户端）。它在窗口级浮层 shell.overlay 里注册计时 UI，切换会话、打开设置、换主题时不会被卸载，适合需要在 Harness 界面内做番茄工作法的开发者。
这是什么¶
dsh-pomodoro-timer 是 DeepSeek Harness 的悬浮番茄专注计时器插件。简介为：A floating Pomodoro focus timer plugin for DeepSeek Harness。
- 目录页：https://www.skillhub.cn/plugins/pzdn2009/dsh-pomodoro-timer
- 源码：https://github.com/pzdn2009/dsh-pomodoro-timer
- 许可：MIT（见仓库 LICENSE）
- 包版本（package.json）：
1.1.0
计时逻辑完全在浏览器端运行；Host 侧 index.js 为空 apply，不引入额外运行时依赖。
核心功能¶
默认节奏（时长可在设置里改）：
- 专注 25 分钟 → 短休息 5 分钟
- 每完成 4 个专注 → 长休息 15 分钟
界面与反馈：
- 圆环进度、今日完成数、阶段提示
- 窗口右上角胶囊显示剩余时间；点击展开计时卡片（向下展开，不遮挡胶囊）
- 样式仅用宿主主题 token（
--dsw-alias-*），随浅色/深色主题切换；文案随界面语言在中英文间切换（locale/en.json、locale/zh.json）
阶段结束：
- 弹出提示条
- 自动播放约 2 分钟轻音乐（WebAudio 实时合成，仓库无音频文件、不依赖外部音源），可随时停止
- 「自动开始下一段」打开时，阶段结束后直接进入下一段
可调项（卡片头部设置）：
- 专注 5–120 分钟，休息 1–60 分钟
- 开关「自动开始下一段」与阶段结束轻音乐
计时与状态：
- 基于绝对截止时间；后台标签节流、刷新页面、重启应用不影响准确性（以 README 说明为准）
- 状态保存在
localStorage
安装与启用¶
插件面向 dsh 0.2.x 的插件 manifest 与 slot API；需已安装 DeepSeek Harness。
README 给出的获取与安装步骤如下。先将仓库克隆到本机目录（示例路径可按环境修改）：
git clone https://github.com/pzdn2009/dsh-pomodoro-timer.git ~/dsh-pomodoro-timer
在 Harness 对话里让 agent 用 绝对路径 安装该目录，例如：
用 plugin_manager 安装
/Users/<you>/dsh-pomodoro-timer
安装成功后窗口右下角会出现番茄色胶囊；若未出现，刷新一次页面。
插件以当前 dsh 进程及浏览器环境运行；安装前建议自行查看 client.js 等源码并确认 MIT 许可是否符合你的使用场景。
典型用法¶
- 看窗口右上角胶囊上的剩余时间；点击展开卡片。
- 使用卡片按钮：开始 / 暂停 / 继续、重置当前阶段、跳到下一阶段。
- 阶段结束时会有提示条与可选轻音乐；胶囊下方可能出现「轻音乐播放中 · 停止」横条。
- 在卡片头部进入设置，调整专注与休息时长，以及自动开始、轻音乐开关。
- 按
Esc收起卡片。
本地改 client.js 后，让 agent 对同一目录重新执行 plugin_manager 的 install_bundle；界面无变化时再刷新页面。
结构与实现要点¶
| 文件 | 作用 |
|---|---|
package.json |
清单：dsh.bundle.patch 与 dsh.client（platform: web, immediately: true） |
cordis.patch.yml |
插入 pomodoro-timer 插件行 |
index.js |
Host 半边（空 apply） |
client.js |
状态机、shell.overlay 槽、React 组件与样式、WebAudio 轻音乐 |
locale/*.json |
插件管理器标题与描述 |
icon.svg |
图标 |
适用场景与注意¶
适合：长时间在 Harness Web 窗口里工作、希望在同一界面内用番茄法切段、又不想计时器随会话切换被卸掉的开发者。
注意：
- 社区目录 SkillHub 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装方式以 README 为准，勿假设存在未文档化的
dsh plugin add一键命令。 - 插件在浏览器中读写
localStorage并合成音频，权限边界与宿主页面一致；敏感环境请先审阅源码。
结尾¶
dsh-pomodoro-timer 把经典番茄节奏接到 Harness 的 shell.overlay 上，并在阶段结束时用内置 WebAudio 提供可选轻音乐，状态与主题、语言跟宿主对齐。需要详情或提 issue 时，可打开 目录页 与 GitHub 仓库。
