前言¶
在 DeepSeek Harness 里写提示、跟对话，时间常常被一段段长任务吃掉，却又不值得单独开系统计时器或手机 App。DSH 的插件机制允许把常用工具嵌进壳层界面；dsh-pomodoro-clock 就是在客户端右侧挂一个番茄钟：可拖动的右边缘把手、浮动卡片或停靠侧栏页签，单次倒计时或经典番茄循环，结束时用浏览器内合成的提示音（含可选「机场播报」语音）。全程在本地运行，不依赖构建步骤与外部音频文件。
这是什么¶
dsh-pomodoro-clock 由维护者 new2023start 发布，归类为客户端插件。它在 Harness 右侧边栏及相关壳层席位上注册计时界面：右缘把手显示 mm:ss 与运行指示点，点开即浮动卡片；同一套状态也可固定在右侧栏页签，并在页签标题上显示实时倒计时。中英文界面跟随 Harness 语言设置。
核心功能¶
界面入口¶
插件通过以下席位挂载（资料摘自项目 README）：
| 表面 | 席位 | 作用 |
|---|---|---|
| 右缘把手 + 弹出层 | shell.overlay（id dsh-pomodoro） |
贴右缘的可拖动把手，展开浮动计时卡片；⌄ 可收起 |
| 右侧栏页签 | sidebar.right.pane.tab（key dsh-pomodoro-clock） |
与把手相同的计时器，以页签形式停靠 |
| 页签标题 | sidebar.right.pane.tab.title |
页签上显示 mm:ss |
| 右侧栏引导 | guide pomodoro |
引导页中的「Pomodoro timer」卡片，可打开页签 |
把手可上下拖动停靠；位置写入 localStorage 键 dsh.pomodoro.anchor，刷新后仍保留且限制在视口内。卡片相对把手在窗口上半区向下、下半区向上展开。把手、弹出层与页签共用同一状态存储，折叠或关闭界面不会重置正在进行的倒计时。
计时模式¶
- 单次（默认）：设置分钟数后启动，到零响铃一次并停止，然后以相同时长重新待命；无休息段、无自动下一轮。
- 番茄循环：专注（默认 25 分钟）/ 短休（5 分钟）/ 长休（15 分钟），可配置每轮循环次数（1–12）；可选 Auto-start 自动进入下一阶段。
切换模式会重新待命并清空当前运行阶段。进度保存在 localStorage 键 dsh.pomodoro.v1；日历日变更时每日计数器会重置。
声音与通知¶
提示音全部用 WebAudio 在浏览器合成（基频加弱泛音，动机重复约 3–8 秒），不随包分发音频文件。可选：清脆三声、机场播报、钟声、木鱼、静音；下拉旁有 ▶ 预览。
「机场播报」在五音下行提示后通过 speechSynthesis 朗读（中文：「本次专注时间已结束，请稍作休息。」；英文随界面语言）。无可用语音引擎时仍播放音调，仅无语音播报。另可开启桌面通知。
单次模式可调倒计时时长（1–120 分钟）。循环模式可调各阶段时长、轮数与自动开始。客户端仅使用 --dsw-alias-* 主题令牌以适配当前主题；可见文案在 dshPomodoro 语言包（zh / en，其他语言回退到 en）。
安装与启用¶
市场安装：Plugins → Market → dsh-pomodoro-clock → Install。
命令行任选其一（与 README 一致）：
dsh plugin add dsh-pomodoro-clock
或安装发布包（当前资料中的版本为 v1.0.0）：
dsh plugin --profile web add "https://github.com/new2023start/dsh-pomodoro-clock/releases/download/v1.0.0/dsh-pomodoro-clock-1.0.0.tgz"
安装会向 profile 增加席位，不替换已有发货内容。package.json 标明客户端面向 web 平台，immediately: true，并注入右侧栏、对话与 locale 相关客户端模块；无额外运行时依赖，提示音亦在浏览器合成。
典型用法¶
- 最快：点右缘把手，在浮动卡片里设时长或切到循环模式，启动计时；拖动把手到顺手高度。
- 停靠侧栏：在右侧栏引导页打开 Pomodoro timer 卡片，进入同名页签；页签标题会持续显示剩余时间。
- 配置：在设置里选模式、时长、轮数、声音（可先预览）、是否桌面通知；循环模式按需打开 Auto-start。
开发侧可用仓库内烟雾测试（无需浏览器）：
node test/smoke.cjs
适用场景与注意¶
适合希望在 DSH Web 客户端里就地做专注分段、又不想离开对话界面的开发者。插件在当前 dsh 进程权限下作为客户端代码运行；安装前建议阅读仓库源码与 MIT 许可证，确认席位注入范围符合你的环境。
DSH 生态强调「一切皆插件」；社区目录站 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店条目理解。
「机场播报」依赖系统 TTS；静音或无声环境请选其他音色或静音。所有计时与锚点数据留在本机 localStorage，不外传。
参考链接¶
- 目录页：https://www.skillhub.cn/plugins/new2023start/dsh-pomodoro-clock
- 源码与说明：https://github.com/new2023start/dsh-pomodoro-clock
