前言¶

在 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 写明在 DSH 0.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 行为符合你的环境策略。

典型用法¶

1. 左侧导航点「时钟事务」，顶部在「时钟 / 番茄钟 / 事务」三个标签间切换；旁边对话入口仍可回到聊天。
2. 时钟：按需打开齿轮项，与壁纸插件联用时保持透明底即可。
3. 番茄钟：选预设或输入分钟 → 开始；允许通知以便到点收到系统提示。
4. 事务：先确保 Campus Radar 在本地监听（默认 127.0.0.1:3000），再在事务页查看 DDL；代理失败时仅该页提示未连接。

开发与自检（维护者文档）：

node --check index.js
node --check client.js

本地调试可将仓库目录交给插件管理器的 install_bundle，或通过应用内插件页的本地安装。

兼容与实现要点¶

主要文件：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