非高峰时钟 timacek/DEEPSEEK-HARNESS-PLUGINS

Tim 的 DeepSeek Harness 小工具

dsh 标志旁边的时钟：一个绿点和当前时间

这个仓库里第一个、也是最小的工具只做一件事：它把当前时间放到侧边栏 dsh 标志旁边，颜色跟着正在生效的 DeepSeek API 价格档位走——非高峰时段显示绿色，高峰时段显示红色。功能就这么多；下面讲的是它的原理和安装方法。

给 DeepSeek Harness（dsh）用的小巧、有主见的附加组件——每一个都是正经的 dsh 插件包：装一次，重启、会话、harness 更新都不会丢，而且每个都能在设置 > 插件里重新关掉。

目前只有一个工具，就是这个仓库当初为之而建的那个。

非高峰时钟 ⏱️（DeepSeek API 价格档位，侧边栏实时显示）

左侧边栏 Harness 标志旁边有个小钟，告诉你现在跑的是哪个 DeepSeek API 价格档位：

| 颜色 | 状态 | 含义 |
| 🟢 绿色 | 非高峰 | DeepSeek 收半价 |
| 🔴 红色 | 高峰 | 全价——而且控件会在时间旁边显示 PEAK |

把鼠标悬停上去，它会告诉你档位什么时候切换，用 UTC 表示——定价规则就是按这个时区写的。本页顶部的截图就是真实控件在 UTC 06:33 的绿色状态。

为什么规则和你印象里的不一样

DeepSeek 改过不止一次这个时间表，现行政策（2026-10-02 对照 Models & Pricing 脚注 2 核对过）和 2025 年那版正好相反：

非高峰费率是高峰费率的一半。高峰时段为 UTC 周一至周五 01:00 - 04:00 和 06:00 - 10:00，不含中国法定节假日。 其余所有时间都是非高峰，包括周末和中国法定节假日，全天都算。

所以非高峰才是默认状态，绿色是常态；红色只标出工作日的那两个窗口。时钟知道中国法定节假日，这点比听起来更重要：节假日那一周全天都是非高峰，而只按工作日判断的粗糙做法，恰恰会在一年里最忙的那几周显示红色。

要换到下一年，把新的节假日加到 packages/suite/src/features/offpeak.ts 和 packages/suite/client/offpeak.client.js（两份副本——原因见 packages/suite/README.md），然后重新构建。

安装

你需要 DeepSeek Harness Desktop 0.2.0-rc.2（锁定的运行时）、Node.js >= 20.10 和 pnpm 9+：

git clone https://github.com/timacek/DEEPSEEK-HARNESS-PLUGINS.git
cd DEEPSEEK-HARNESS-PLUGINS
pnpm install
pnpm build
node scripts/dsh.mjs plugin --profile desktop add ./packages/suite

或者不用命令行：在应用里打开设置 > 插件 > 添加插件，粘贴 packages/suite 目录的绝对路径。然后重启应用——插件包启动时加载——侧边栏展开时，时钟会出现在 logo 旁边。

在 Settings > Plugins 里把 dsh-offpeak 那一行关掉，只会停掉 Host 侧的配置；组件本身由 bundle 的 Client anchor 行提供，所以要关掉那一行（或者移除 bundle）才能让时钟消失。移除 bundle 会恢复默认的 DeepSeek Harness 字标：

node scripts/dsh.mjs plugin --profile desktop remove dsh-plugin-suite

一个有意为之的取舍：组件占了 logo 旁边的位置，所以它启用时会替换掉字标，而且点击那一行仍然会启动新会话（它就是 shell 的 New-session 按钮）。另外，它只在侧边栏展开时存在。

盒子里还有什么

bundle 里还带了一个 hello 行——一个单行工具，留作冒烟测试，用来验证某一行处于启用状态、它的工具可以调用。它无害，也是你写自己第一个小玩意的良好参考。

写你自己的小玩意

这个仓库里的所有东西都是一个 bundle（packages/suite），每个功能一行，外加用来添加更多内容的脚手架：

| 任务 | 命令 |
| 添加功能（行 + 模块） | pnpm new-feature suite weather |
| 添加 bundle | pnpm new-bundle tools |
| 构建 / 类型检查所有 bundle | pnpm build / pnpm typecheck |
| 对照已安装的 dsh 检查运行时版本锁定 | pnpm check |
| 任意启动器命令 | node scripts/dsh.mjs <args> |

| 文档 | 内容 |
| docs/architecture.md | 行、bundle、层顺序、模块解析、何时拆分 |
| docs/plugin-development.md | 写一个功能：工具、schema、Config、客户端 UI、坑 |
| docs/install-and-reload.md | 安装到配置档、重载语义、验证、故障排查 |

UI 小玩意是客户端那一半：在 client/ 里手写的纯 JavaScript，通过 ./client 导出对外提供。这部分最容易出问题——一个 bundle 如果带了它，就必须有且只有一个以包名命名的行，而且那一行的模块必须导出 apply，否则浏览器那一半会被从页面里丢掉，而且哪里都不会报错。这两种失败模式，以及用来区分它们的诊断方法，都写在 docs/plugin-development.md 第 7 节。可以从这些模板起步：templates/bundle/ 和 templates/client/decoration.client.js。

锁定的运行时：dsh 0.2.0-rc.2、@deepseek-ai/cordis 4.0.4、@deepseek-ai/dsh-tools 0.2.0-rc.2。更新 harness 之后运行 pnpm check：它会拿每个 bundle 的 manifest 和已安装的运行时做对比，并打印出需要改的确切内容。

目录结构

.
├── packages/
│ ├── suite/ bundle dsh-plugin-suite - 安装这个 │ │ ├── cordis.patch.yml 每个功能一行（id + module + config） │ │ ├── src/index.ts bundle 根模块 - Client anchor │ │ ├── src/features/.ts 一个模块 = 一行 │ │ └── client/.client.js 手写的浏览器端，通过 "./client" 提供 │ └── README.md packages/ 的组织方式 ├── templates/ 脚本复制的脚手架（bundle、feature、client） ├── scripts/ 脚手架、启动器包装、运行时检查 ├── docs/ 架构、编写、安装与重载 └── tsconfig.base.json

生成的 lib/ 目录是构建产物，已被 git 忽略——永远不要编辑它们。

一屏看懂模型

| 层 | 是什么 | 单位 |
| Row | Cordis 树中的一条条目：id、name、config | 激活：在 Settings > Plugins 中开关并配置 |
| Bundle | 一个包，其 package.json 声明了 dsh.bundle.patch | 安装、版本管理、发布 |
| Feature | 本仓库中的一行，由 src/features/ 下的一个模块实现 | 让一项能力改动时不影响其他能力 |

一个 bundle 承载多个 feature 行。只有当某项 feature 需要自己的依赖、自己的发布节奏，或者要分享给别人时，才新增第二个 bundle。详情见：docs/architecture.md。

环境要求

| 工具 | 版本 | 说明 |
| Node.js | >= 20.10 | 本仓库中的工具链 |
| pnpm | 9 或更新 | 工作区安装与构建 |
| DeepSeek Harness | 0.2.0-rc.2 | Desktop 应用；bundle 的版本锁定必须与它一致 |

日常操作

| 任务 | 命令 |
| 安装到应用配置档 | node scripts/dsh.mjs plugin --profile desktop add ./packages/suite |
| 从应用配置档移除 | node scripts/dsh.mjs plugin --profile desktop remove dsh-plugin-suite |
| 查看组合后的行 | Settings > Plugins > Plugin list，或用一个临时配置档 |
| 运行时版本锁定检查 | pnpm check |

scripts/dsh.mjs 会找到 Desktop 安装的启动器（可用 DSH_CLI 覆盖），并把相对 bundle 路径转成绝对路径，pnpm 和 GUI 都需要绝对路径。

约定

| 项目 | 约定 | 示例 |
| Bundle 目录 | kebab-case | packages/suite |
| Bundle 包名 | dsh-plugin-<bundle> | dsh-plugin-suite |
| Feature 模块 | src/features/<feature>.ts | src/features/hello.ts |
| 行 id | dsh-<feature>，在配置档中唯一 | dsh-hello |
| 行模块 | <package>/features/<feature> | dsh-plugin-suite/features/hello |
| 客户端部分 | client/<feature>.client.js，纯 JS，导出为 ./client | client/offpeak.client.js |
| 工具名 | snake_case | hello |
| 运行时版本锁定 | 精确版本，绝不用 ^ | 0.2.0-rc.2 |

行 id 在配置档中全局唯一：脚手架脚本会拒绝创建重复 id。

保持可维护的规则

1. 一项 feature 一行。 绝不要用一个 bundle 级别的行加 mode 字段来切换能力——那正是行和 config 的用途。唯一的例外是 客户端锚点：一个带浏览器半端的 bundle，必须恰好有一行，其 name 是裸包名，并且它的模块必须导出 apply。两行都解析到同一个包，或者锚点没有 apply，浏览器半端就会从页面上悄悄消失。细节和诊断信息见 docs/plugin-development.md 第 7 节。
2. 可调参数写进 Config，绝不写进代码。这样用户就能在 cordis.patch.yml（或「设置 > 插件」）里改行为，而且下次升级后依然有效。
3. 绝不手改配置档文件（%USERPROFILE%\.dsh\profiles\desktop\...）。安装、开关、配置都走 Plugin Manager 或 dsh plugin。
4. @deepseek-ai/ 放进 peerDependencies + devDependencies，绝不放进 dependencies。 宿主会把 peer 指向安装副本；打包一份副本会跟运行时逐渐脱节。
5. 精确锁定运行时版本。 每个 dsh- peer 都会跟正在运行的运行时比对；版本不匹配会以 incompatible-version 阻止激活。
6. 先构建再重载。 改了模块，先 pnpm build，再切换那一行或重启。替换 bundle 版本一律需要重启。
7. 客户端（浏览器）半端是手写的纯 JS，放在 client/ 下，通过 ./client 导出发布。它们不受 pnpm build 覆盖，页面只在刷新时重新拉取。复制 templates/client/decoration.client.js 就能起一个。

License

MIT - see LICENSE。