前言¶
在 DeepSeek Harness（DSH）里做长时间对话或智能体开发，容易缺少一个始终可见、又不占满工作区的专注计时器。系统自带的时钟或独立 Pomodoro 应用往往与 DSH 割裂，要么锁在浏览器标签里，要么要单独切窗口。Pixel Clock 是运行在 DSH 里的客户端插件：默认以真实置顶窗口停在桌面上，也可在设置里切回应用内模式；围绕一颗可交互的像素风格星球，提供专注 / 休息循环、待办与提醒，并可选 ASMR 氛围音。下面介绍它的定位、能力与安装用法。
这是什么¶
Pixel Clock（包名 @local/pixel-clock，当前版本 1.9.0）由维护者 aa0330 发布在 GitHub，许可证为 MIT，在 SkillHub 上归类为「客户端」插件。它解决的是：在 DSH 工作区内（或桌面上）集成像素风番茄钟，而不必再开第三方计时软件。
核心功能¶
视觉与主题¶
- 四套星球主题：绿屿、冰世界、极光、赤秋；片元着色器实时渲染。
- 球体大小可在设置中调节；滑块下方提供 80 / 100 / 124 / 148 / 180px 等预设点。
番茄钟与统计¶
- 专注 / 休息循环，并记录今日完成轮次。
- 三栏弹窗：时钟、待办、提醒。
背景音乐与音量¶
- 内置四段 ASMR 氛围音（雨声溪流、雨夜白噪、室内雨声、夜晚环境）；专注阶段无缝循环，休息自动停止，可切换轨道，音量可调（滑块预设 0 / 25 / 50 / 75 / 100%）。
- 在 macOS 上会读取系统输出音量：系统音量大于 70% 时应用音量上限压到 70%，大于 85% 时压到 55%。
形态与交互¶
- 应用内 / 桌面两种形态：桌面形态由独立 Electron helper 承载，透明置顶；找不到 Electron 时仍可在 DSH 窗口内使用。
- 单击加速自转；按住拖动位置；右键打开设置；星球两侧箭头或
←→切换氛围音轨；空格开始 / 暂停；R重置；S跳过当前阶段。
环境要求¶
- DeepSeek Harness 桌面版。
- 桌面模式需要 Electron 运行时：默认在
$DSH_HOME/electron/下查找（macOS 为Electron.app/Contents/MacOS/Electron，Linux 为electron，Windows 为electron.exe）；也可用环境变量PIXEL_CLOCK_ELECTRON指定路径。
安装与启用¶
官方 README 未提供 dsh plugin add 一类命令，安装步骤如下。
- 将本仓库放到 DSH 工作区的
.dsh-plugins/pixel-clock目录。 - 重启 DSH 或重新加载工作区，插件会通过
cordis.patch.yml注入。 - 在设置里选择「应用内」或「桌面」模式。
本地插件命名空间为 @local/；发布到 npm 需同步修改 package.json、cordis.patch.yml、template.js 和 client.js 中的名称并重新构建。
可选环境变量（摘自 README）：
| 环境变量 | 默认值 | 说明 |
|---|---|---|
DSH_HOME |
~/.dsh |
数据目录与 Electron 运行时目录 |
PIXEL_CLOCK_PORT |
17890 |
本地桥接端口 |
PIXEL_CLOCK_ELECTRON |
空 | 自定义 Electron 可执行文件路径 |
PIXEL_CLOCK_DEBUG |
空 | 设为 1 时开启 9223 调试端口 |
典型用法¶
经过上面的步骤启用插件后，可先选桌面或应用内模式，再按习惯操作星球：
- 需要开始一轮专注：
空格开始；休息阶段同样可用空格暂停。 - 需要换一首氛围音：点击两侧箭头或使用
←→。 - 需要调整位置或查看待办：拖动星球移动；右键打开设置与三栏弹窗。
开发或二次构建时，在插件源码目录执行：
npm install
npm run build # template.js + src/planetShaders.ts + 像素字体 -> client.js
npm test # 渲染冒烟测试
client.js 为构建产物，DSH 直接加载；修改 template.js 或 src/planetShaders.ts 后须重新 npm run build，CI 会检查产物是否与源码同步。
适用场景与注意¶
适合已在用 DSH 桌面版、希望计时器与工作环境同屏、又偏好像素风视觉的开发者。插件在 DSH 进程权限下运行，安装前应自行查阅仓库源码与 MIT 许可证及 THIRD_PARTY_NOTICES.md。
安全相关（README 原文要点）：
- 桌面 helper 为独立 Electron 进程，仅在
127.0.0.1:17890提供本地 HTTP 桥，无鉴权，勿将端口暴露到局域网或公网。 - 计时状态、日志与窗口位置保存在
$DSH_HOME/pixel-clock。 - 插件不收集、不上传任何数据。
路线图（规划能力，以仓库后续更新为准）包括：自定义着色器主题热加载、专注进度驱动的星球生长、完成星球的收藏与回看。
SkillHub 上的社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；本插件 GitHub 星标数为 0（以目录页所示为准）。
链接¶
- 目录页：https://www.skillhub.cn/plugins/aa0330/Pixel-Clock
- 仓库：https://github.com/aa0330/Pixel-Clock
