番茄钟 cuznmop/dsh-pomodoro-timer

dsh-pomodoro-timer

DeepSeek Harness Web 界面的番茄钟：侧栏整页（专注 / 短休息 / 长休息循环）+ 输入框旁倒计时胶囊。

仓库：<https://github.com/cuznmop/dsh-pomodoro-timer> · 问题反馈：<https://github.com/cuznmop/dsh-pomodoro-timer/issues> · npm：<https://www.npmjs.com/package/dsh-pomodoro-timer>

功能

- 侧栏整页 —— 左栏面板列表里的时钟图标，打开带环形进度、控制按钮和统计的完整页面。
- 输入框胶囊 —— 消息框旁的紧凑倒计时，点一下跳到页面；你在对话里工作时它照常走。
- 循环控制 —— 默认专注 25 / 短休息 5 / 长休息 15 分钟，每 4 个番茄进长休息，可开启自动进入下一阶段。
- 操作 —— 开始、暂停、继续、重置当前阶段、跳过当前阶段。
- 统计 —— 本轮第几个番茄、今天完成多少个，跨天自动清零。
- 提示音 —— 阶段自然结束时三声短音（可关闭；浏览器需要一次交互后才允许出声）。
- 刷新不丢 —— 结束时刻写入 localStorage，刷新页面后接着倒计时。
- 明暗主题 —— 配色全部用 --dsw-alias- 主题 token；不 import 任何 Harness 客户端包，不会因为内部改动而被打断。
- 中英双语 —— 跟随 GUI 语言设置。

环境要求

| 组件 | 要求 |
| DeepSeek Harness | 已在 0.2.0-rc.2 实测（Web / 桌面版 profile）；只使用公开的客户端 slots 与 locale 服务，不声明 DSH peer 依赖 |
| DSH profile | 有 Web 界面（web 或桌面版）；headless profile 没有 UI |
| Node.js | ^22.19.0 或 >=24.0.0（仅本地自检需要） |

安装

普通 dsh web profile
dsh plugin --profile web add dsh-pomodoro-timer

桌面版可以在插件市场页面里装，或走「设置 → 插件」。装完重启 Harness（或刷新页面），左栏面板列表里会出现时钟图标。

使用

| 控件 | 行为 |
| 开始 / 暂停 | 开始或暂停当前阶段 |
| 重置 | 把当前阶段恢复成完整时长并暂停 |
| 跳过 | 进入下一阶段，不计入番茄数 |
| 设置 | 专注时长、短休息、长休息、几个番茄后长休息、自动接续、提示音 |

暂停状态下改时长会立刻生效；运行中改则从下一阶段开始生效。

状态存在 localStorage 的 dsh.plugin.pomodoro-timer.v1 键下。

卸载

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

开发

没有构建步骤：client.js 就是发布出去的浏览器 bundle。包里自带离线自检。

npm run check # 对两个半边做语法检查 + 跑离线 bundle 测试
pnpm run check 等价。如果机器上只有 DSH 自带的那份运行时，
先把工作区的 shim 加进 PATH： $env:PATH = "<工作区>\bin;$env:PATH"

test/client.test.mjs 用模块加载器桩和假的客户端 context 载入 bundle，覆盖注册 id、阶段机、持久化、组件渲染。它证明的是逻辑，不是观感——观感要在跑起来的 GUI 里看。

目录结构

| 路径 | 作用 |
| package.json | 清单：bundle patch、client 声明、导出表、图标、发布文件白名单 |
| cordis.patch.yml | 插入让浏览器 bundle 进入模块图的 Host 行 |
| index.js | Host 半边，故意为空实现 |
| client.js | 计时 store、侧栏页面、输入框胶囊、中英字典 |
| locale/.json | 插件卡片标题与描述 |
| icon.svg | 插件卡片图标 |
| test/client.test.mjs | 离线自检 |

说明

- 除了自己那个 localStorage 键，这个插件不读写任何东西：没有 Host 服务、没有工具、没有网络访问。
- 它注册进 sidebar.panellist、main 和 conversation.composer.dock；不会替换应用根节点，也不会往 document.body 追加内容。

许可证

MIT