前言¶

在 DSH Web 界面里工作时，有时需要把专注计时和当前工作窗口放在同一处。DSH 的理念是「一切皆插件」，因此可以把番茄钟作为一个 web 插件挂到 DeepSeek Harness Web UI 上。下面介绍 causebefore/dsh-pomodoro。

这是什么¶

dsh-pomodoro 是一个 DeepSeek Harness Web 插件，给 DSH Web 界面加入专注和休息循环。它提供侧边栏入口、可拖拽浮层面板、可配置时长、阶段控制，以及阶段结束时的应用内提醒和可选通知。维护者为 causebefore，许可证为 MIT。

核心功能¶

下面列出已核实的能力：

• 在 DSH Web UI 中加入专注和休息循环。
• 从侧边栏打开面板，并在 DSH 插件设置页管理配置。
• 支持开始、暂停、重置、跳过当前阶段。
• 显示圆形进度指示、阶段状态和已完成专注次数。
• 重新加载 DSH，或关闭标签页、重启浏览器后再打开，可以从原截止时间继续；若关闭期间当前阶段已过期，会在恢复时结算一次。
• 支持 mini 模式，把面板收起为阶段、倒计时和主要控制，同时保留拖动、展开、关闭操作。
• 可分别设置专注时长和休息时长。
• 可选择休息或下一次专注会话是否自动开始。
• 阶段结束时提供 DSH 应用内提醒，并可选择声音和后台系统通知。
• 跟随 DSH 全局语言，支持中文和英文；切换语言时更新已挂载的插件界面，不重置计时器或未保存的设置草稿。
• 适配 DSH 浅色和深色主题、键盘操作，以及减少动画偏好。

安装与启用¶

先确认环境：

• DeepSeek Harness >=0.1.0-rc.7，资料显示其验证于 0.1.1-rc.2。
• Node.js ^22.19.0 或 >=24.0.0。
• DSH profile 为 web；headless profile 不提供 UI。
• 命令行可访问 pnpm。

先做安装：

dsh plugin --profile web add dsh-pomodoro

再做启动或重启：

dsh web

经过上面的步骤，如果侧边栏底部出现 dsh-pomodoro 按钮，说明插件已加载。

典型用法¶

在 Web 界面中：

1、点击侧边栏底部的 dsh-pomodoro 按钮，打开或关闭面板。
2、拖动标题栏调整面板位置。
3、在面板中开始、暂停、重置或跳过当前阶段。
4、使用面板的 Mini / Expand 切换紧凑布局和完整控制。
5、打开 DSH 设置页：

Settings → Plugins → Plugin configuration → Pomodoro

配置专注时长、休息时长、自动开始、声音和系统通知。

如果你更习惯在 Web UI 内安装，资料里还给出两条可选社区路径。

先安装 dsh-market：

dsh plugin --profile web add dshmarket

再重启 DSH Web：

dsh web

打开：

Settings → Plugin Market

搜索 dsh-pomodoro，再安装它。

另一条路径是安装 dsh-find-plugin：

dsh plugin --profile web add dsh-find-plugin

重启 DSH Web：

dsh web

然后让代理安装 dsh-pomodoro。这里属于社区路径，不应理解为官方应用商店。

适用场景与注意¶

适合希望把番茄钟放在 DSH Web 界面旁边的开发者。

注意以下限制：

• DSH 仍处于 developer preview，升级 DSH 后需要重新检查插件兼容性。
• 插件只适用于 web profile；headless profile 无法提供该 UI。
• 系统通知要求 DSH 从 localhost、127.0.0.1 或 HTTPS 提供服务，并且 DSH 页面保持打开。
• 当所有 DSH 页面都关闭时，浏览器无法在准确截止时间播放声音或发送通知；下次启动 DSH 会恢复计时器，并结算和报告一次过期阶段。
• 插件以当前 dsh 进程权限运行。安装前建议检查源码、依赖和 MIT 许可证，确认符合你的使用要求。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/causebefore/dsh-pomodoro
• GitHub：https://github.com/causebefore/dsh-pomodoro