前言¶
在 DeepSeek Harness（DSH）里长时间写提示词、看 Agent 输出时，浏览器标签页往往只有对话区和工具栏，缺少一个「放在桌角、不抢焦点」的时间参考。系统任务栏可以看时间，但和 DSH 工作区不在同一视觉层级；单独开系统时钟窗口又会多占一块屏幕。DSH 生态里有一类 Client 侧插件，只往 Web GUI 的 overlay 槽位挂小组件，不替换宿主界面。下面介绍维护者 skyline66 发布的 dsh-desktop-clock：在 DSH Web 右上角（安装后）提供可拖动的浮动时钟，带表盘样式、专注计时和主题，位置与偏好保存在浏览器本地。
这是什么¶
dsh-desktop-clock 是面向 DSH Web GUI 的纯 Client 插件（Host 半部分为空，无 Host 服务、无工具、无 Host 配置项）。一句话定位：可拖动的浮动桌面时钟，提供指针/数字/组合表盘、专注计时、四套主题，并记住窗口位置。
- 维护者：skyline66
- 社区分类：趣味换装
- 许可证：MIT
- 当前 package 版本（资料来源
package.json）：1.0.2 - 目录页：https://www.skillhub.cn/plugins/skyline66/dsh-desktop-clock
- 源码与说明：https://github.com/skyline66/dsh-desktop-clock
插件不发起网络请求、不收集遥测；设置与计时状态只写入当前浏览器的 localStorage（键名见下文「隐私与数据」）。
核心功能¶
以下能力均来自项目 README，安装前可对照 GitHub 文档核对。
表盘与时间显示¶
- 三种表盘：数字、指针、组合；指针模式支持平滑走秒。
- 细节设置：12/24 小时制、是否显示秒与日期、时区、三档尺寸、不透明度、字体大小。
- 界面语言跟随 DSH 当前 locale，支持中文与英文。
专注计时¶
- 预设时长：5 / 15 / 25 / 45 分钟。
- 支持开始、暂停、继续、重置；到点播放 Web Audio 合成的轻提示音（无外部音频文件）。
- 刷新页面后，进行中的计时会按真实截止时间继续（状态持久化在本地）。
桌面化交互¶
- 拖动标题栏移动时钟，松开后记住位置；可锁定位置。
- 双击标题栏折叠为「时间胶囊」，点击胶囊再展开。
- 快捷键
Alt + Shift + D显示或隐藏时钟。 - 齿轮按钮打开设置；眼睛按钮隐藏时钟（右侧保留圆形入口）。
- 面板底部可在「时钟 / 专注」之间切换。
主题¶
四套主题：极光、余烬、亚麻、石墨；README 说明均带明暗对比与玻璃质感。
架构与兼容¶
- 已在 DSH Web 0.2.1-rc.3 上安装并验证 Slot 注册。
- 只使用公开的 Client
slots/locale与shell.overlay增量槽位，不覆盖root、main等宿主槽位，不读取其他插件 DOM。 - 不引入
@deepseek-ai/*运行时依赖；React 由宿主模块表提供。 - 位置和尺寸限制在当前视口内，窗口缩放后会收回到可见区域。
安装与启用¶
从 GitHub 安装（README 推荐方式）：
dsh plugin add github:skyline66/dsh-desktop-clock
安装完成后，在 DSH Web 界面右上角应出现时钟组件。若未立即出现，刷新一次页面或重启 DSH 后再看。
说明：插件仓库已提交构建产物 client.js，从 GitHub 或压缩包安装时无需本地 npm run build。若你要改源码再安装，README 另有本地开发流程（含 git clone 与 dsh plugin add .），本文不展开。
典型用法¶
日常操作可对照 README 中的对照表：
| 操作 | 结果 |
|---|---|
| 拖动标题栏 | 移动时钟，松开后记住位置 |
| 双击标题栏 | 折叠为时间胶囊 |
| 点击胶囊 | 重新展开 |
Alt + Shift + D |
显示 / 隐藏时钟 |
| 齿轮按钮 | 打开设置 |
| 眼睛按钮 | 隐藏时钟（右侧出现圆形入口） |
| 底部「时钟 / 专注」 | 切换表盘与专注计时 |
需要番茄钟式短专注时：切到「专注」，选 25 分钟（或其他预设），开始计时；到点听提示音即可。需要少占界面时：双击标题栏折叠，或 Alt + Shift + D 临时隐藏。
适用场景与注意¶
适合谁
- 长期在 DSH Web 里调试 Agent、写 Skill 或盯日志，希望时间始终落在工作区一角、又不改宿主布局的开发者。
- 需要轻量专注计时、且不希望插件联网或写 Host 配置的 DSH 用户。
- 喜欢通过「趣味换装」类 Client 插件给界面加一点桌面感、又接受纯 overlay 交互的人。
使用前请知悉
- 插件随当前 DSH 进程与 Web 会话运行；安装前建议浏览 GitHub 源码与 MIT 许可证，确认符合你的环境策略。
- 纯 Client 插件：没有 Host 工具、没有 Host 配置项；偏好只存在本机浏览器，换浏览器或清站点数据会丢失设置与计时状态（除非同源下另有备份）。
- 兼容性以 README 记载的 DSH Web 0.2.1-rc.3 验证为准；升级 DSH 后若 Slot 行为变化，以新版本文档与 issue 为准。
- SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；安装命令以插件 README 为准，不要凭插件名自行拼接未在文档出现的命令。
隐私与数据（localStorage）
dsh-desktop-clock:settings:v1：界面与显示偏好dsh-desktop-clock:timer:v1：专注计时状态
结尾¶
dsh-desktop-clock 把「桌角时钟 + 短专注计时」收进 DSH Web 的一个 overlay 入口：可拖、可藏、可换主题，本地存偏好，不碰 Host。若要在 Harness 里试装，先用 README 给出的 dsh plugin add github:skyline66/dsh-desktop-clock，再到社区目录页或 GitHub 查更新与 issue。
- 目录页：https://www.skillhub.cn/plugins/skyline66/dsh-desktop-clock
- GitHub：https://github.com/skyline66/dsh-desktop-clock
