前言¶
给 DeepSeek Harness（DSH）的 Web UI 做开发时，一个常见的问题是：工作区里缺一个顺手的小工具。番茄钟、下班倒计时、专注统计这些日常要不停看的东西，要么切到别的 App，要么就得自己写一个挂在页面上的浮层。focus-alarm 就是这个方向上的一件社区插件，把几件事合成一张卡片。下面介绍它的定位、功能和安装方式。
这是什么¶
renbooc/focus-alarm（包名 @local/offwork-countdown）是 DeepSeek Harness Web UI 的悬浮卡片插件，维护者是 renbooc。卡片把番茄钟、下班倒计时和专注统计合成一处，可拖动、可收起。它属于客户端插件，界面和计时逻辑都跑在浏览器半，index.js 的 Host 半是空实现。
它解决的问题是：在 Harness 里长时间工作时，番茄钟时长、还剩多久下班、今天完成了几个番茄这些信息不用离开工作区就能看到。
核心功能¶
按 README 列出的能力，分三组看。
番茄钟部分，专注 / 短休 / 长休三段循环，轮次可配，默认 4 轮一次长休；支持开始、暂停、跳过、重置、+5 分钟。启动即回到满时长的专注时段，正在运行且未到点的计时按时间戳续上。阶段自然结束时有提示音、卡片抖动、彩色粒子和文字气泡，并尊重系统「减少动态效果」设置。
统计与倒计时部分，今日完成番茄数、累计专注分钟、打断次数、连续天数、近 7 天柱状图，跨天自动归零但保留历史。下班倒计时给出距下班 / 距上班 / 加班时长、今日工作进度条和周末提示。
提醒与同步部分，距下班 30 分钟提醒收尾、下班点提醒、专注结束提醒护眼、加班时段提醒早点收工，同一天内只提醒一次。可选通过 Notification API 推送系统通知，权限未授予时静默降级。计时运行时剩余时间写进浏览器标签页标题，暂停或卸载时还原原标题。界面中英文跟随 Harness 语言设置，配色全部使用主题 token，浅色 / 深色自适应。偏好开关共 7 个，即时生效。
安装与启用¶
README 给出的安装方式有两种。在 Harness Web 里打开 设置 → 插件 → 插件市场 / 插件广场，搜索「专注闹钟」一键安装；或者命令行：
dsh plugin --profile web add github:<owner>/focus-alarm#<commit-sha>
注意命令里的 <owner> 和 <commit-sha> 需要替换为实际值，README 没有给出这两者固定占位之外的写法。安装后刷新页面即可，不需要重启，客户端插件由 HMR 加载。
本地开发时用本地路径安装：
dsh plugin --profile web add /absolute/path/to/focus-alarm
插件目录遵循 Cordis bundle 约定：package.json 声明 dsh.bundle.patch 和 dsh.client，cordis.patch.yml 插入一行插件注册，index.js 是 Host 半，client.js 是浏览器半（React 组件、样式、状态、计时逻辑），locale/*.json 是中英文文案，icon.svg 是图标。数据保存在浏览器 localStorage，键名前缀 dsh.offwork-countdown.*，保留了旧前缀以兼容既有安装。
典型用法¶
装好并刷新页面后，卡片会通过客户端插件加载出来，可以拖动位置，也可以收起只留个入口。README 里描述了几个可复现的行为：打开「自动开始下一阶段」后，阶段自然结束会自动进入下一段；四个番茄结束进入长休。打开「标题同步」后，计时运行时浏览器标签页标题显示剩余时间，暂停或卸载插件时精确还原原标题。把「系统通知」打开并授予权限后，阶段结束时可以收到系统通知，权限没授时不打扰。结束一天前看一眼卡片上的下班倒计时和今日工作进度条。
适用场景与注意事项¶
适合在 Harness Web 里做长时间开发、希望番茄钟和下班倒计时就近可见的开发者，也适合想在自己的客户端插件里参考「悬浮卡片 + 计时 + 本地统计」这套实现方式的同学。
有几点需要注意。插件兼容 DeepSeek Harness Web，README 标注已验证 0.2.1-rc.5，package.json 的 engines.dsh 也是 >=0.2.1-rc.5；客户端模块通过 window.__ModuleLoader__ 注册，注入 shell.overlay 槽位，React 由浏览器模块表提供，插件自己不重复安装依赖。插件以当前 Harness 进程的权限运行，安装前应先看一遍源码和许可证（README 标注为 MIT）。计时和统计数据都写在浏览器 localStorage 里，清理浏览器数据前要留意。
结尾¶
卡片把番茄钟、下班倒计时、专注统计这三类工作时长管理能力收敛到一处，配置项够用，实现路径清晰。目录页在 https://www.skillhub.cn/plugins/renbooc/focus-alarm，源码在 https://github.com/renbooc/focus-alarm。
