前言¶
在 DeepSeek Harness（DSH）里长时间对话或写代码时，很多人会在浏览器里再开系统时钟、番茄钟应用，或单独开一个任务看板页。这些工具与 DSH 界面分离，切换成本高，番茄钟也常因换标签页而停在前端计时逻辑上。
下面介绍维护者 Twi-ster 的客户端插件 dsh-clock-radar（仓库 Twi-ster/dsh-clock-radar）。它在 DSH Web 侧栏增加一个「时钟事务」入口，把秒级时钟、番茄钟和 Campus Radar 的 DDL 看板收进同一处；需要聊天时仍可回到对话行。插件由 dsh-wallpaper-clock 与 campus-radar-dsh 能力合并而来，并单独实现了番茄钟页。
插件定位¶
- 名称：dsh-clock-radar（README 标题：时钟事务）
- 分类：客户端（DSH 插件目录归类为客户端）
- 维护者：Twi-ster
- 许可：MIT（© 2026 Twi-ster）
- package.json 版本：1.0.0；
engines.dsh为^0.2.0-rc.1，README 写明在 DSH0.2.0-rc.2上验证过
一句话：一个侧栏 bundle，三个标签页——透明壁纸友好时钟、可后台运行的番茄钟、以及可选的本地 Campus Radar 事务雷达。
核心功能¶
时钟¶
秒级大字 HH:MM:SS，并带指针表盘。页面背景透明；若已安装壁纸类插件，壁纸可从钟面后方透出。右上角齿轮可配置：
- 24 / 12 小时制
- 显示日期
- 数字时间、指针表盘
- 秒针平滑（扫秒）
- 玻璃底衬
设置写入 localStorage 键 dsh-clock-radar/settings/v1。若该键不存在且本机曾使用老版 dsh-wallpaper-clock，会回读其 settings/v1，开关无需重设。
番茄钟¶
支持预设 15 / 25 / 45 / 60 分钟，也可填 1–180 的任意分钟数；提供开始、暂停、继续、重置。到点会发系统通知并在页面内横幅提示，不响铃。
计时逻辑在插件层而非单页内：切换到对话或其他浏览器标签时倒计时仍继续。状态按绝对结束时间保存在 dsh-clock-radar/pomodoro/v1，刷新页面可续计。页面关闭期间若已到点，重开显示「已结束」，不补发过期通知。首次点「开始」会申请通知权限；拒绝则仅在页面内提示。
事务（Campus Radar DDL）¶
展示今日 / 明日 / 逾期 / 7 天内 / 7 天外 / 未定等分组看板。依赖本机运行的 Campus Radar；未连接时显示「没连上」，不影响时钟与番茄钟两页。Campus Radar 为另一本地项目，不开源、不随本插件分发；不需要该页时可不使用。
Host 侧注册只读代理，浏览器侧仅 GET，避免直连 CORS：
/clock-radar-api/tasks -> http://127.0.0.1:3000/api/tasks
/clock-radar-api/categories -> http://127.0.0.1:3000/api/categories
/clock-radar-api/sources -> http://127.0.0.1:3000/api/sources
/clock-radar-api/wechat/overview -> http://127.0.0.1:3000/api/wechat/overview
端口非 3000 时，在 Host 环境设置 CAMPUS_RADAR_URL。
安装与启用¶
环境要求：DeepSeek Harness 0.2 内核、Node.js >= 22.12.0。
Web 端可在 DSH 插件页点「添加插件」，输入本仓库的绝对路径；或在命令行按 README 原文：
git clone https://github.com/Twi-ster/dsh-clock-radar.git
dsh plugin --profile web add ./dsh-clock-radar
装好后刷新页面。侧栏未出现「时钟事务」时，重启一次 dsh web 或 DSH Desktop。
桌面端：应用内 设置 → 插件，安装本地 bundle 目录，无需上述命令行步骤。
DSH 生态上插件以当前 dsh 进程权限运行；安装前建议浏览仓库源码与 LICENSE，确认只读代理与本地 API 行为符合你的环境策略。
典型用法¶
- 左侧导航点「时钟事务」，顶部在「时钟 / 番茄钟 / 事务」三个标签间切换；旁边对话入口仍可回到聊天。
- 时钟：按需打开齿轮项，与壁纸插件联用时保持透明底即可。
- 番茄钟：选预设或输入分钟 → 开始；允许通知以便到点收到系统提示。
- 事务：先确保 Campus Radar 在本地监听（默认
127.0.0.1:3000），再在事务页查看 DDL；代理失败时仅该页提示未连接。
开发与自检（维护者文档）：
node --check index.js
node --check client.js
本地调试可将仓库目录交给插件管理器的 install_bundle，或通过应用内插件页的本地安装。
兼容与实现要点¶
| 项 | 说明 |
|---|---|
| 壁纸插件 | 时钟页透明，壁纸正常显示；无壁纸时使用主题底色。 |
| 深浅主题 | 只读 --dsw-alias-* 主题令牌，跟随宿主。 |
| 其他插件 | 不读写第三方 DOM / 样式，不改写他人节点。 |
| 权限与网络 | Host 仅注册一条只读代理；无 npm 依赖；除上述四个 GET 代理外不联网。 |
主要文件：client.js（三标签 UI 与番茄钟引擎等）、index.js（/clock-radar-api 代理）、cordis.patch.yml（组合树插入）、locale/*.json（管理器中中英文标题与简介）。
结尾¶
dsh-clock-radar 把 DSH 侧栏当成一块固定的工作区：要看时间就留在透明时钟页，要专注就用后台番茄钟，要看 DDL 再在本地 Campus Radar 就绪时打开事务页。社区插件目录与 DeepSeek / 幻方无官方从属关系，安装来源以维护者仓库为准。
- 目录页：https://www.skillhub.cn/plugins/Twi-ster/dsh-clock-radar
- GitHub：https://github.com/Twi-ster/dsh-clock-radar
