Linux-System-0/peaklow

高峰/低峰自动调度插件（Cordis / DeepSeek Harness）

@pi/peaklow 是一个运行在 DeepSeek Harness 宿主根作用域的 Cordis 插件，为 web
profile 提供「高峰自动停止、低峰自动开始」的会话级自动调度，并在浏览器端会话页
头部显示一张可交互的 peaklow 状态卡。

本包是一个【宿主 + client】双面包：宿主负责判定与调度，client 负责在浏览器里展示
和控制。

行为

自动启动（无弹窗）：新会话开始时，插件不再询问任何是/否，直接用配置自动启用：

- 若该 workspace 已保存过配置（$DSH_HOME/peaklow/.json），用保存的
script / intervalMs / notes 启用。
- 若从未配置过，使用默认脚本 bash -c 'exit 101' 兜底（始终判定为低峰/放行），
保证插件先能跑、任务不会被误挂起，并提示在配置里改脚本。

高峰/低峰判定：按轮询间隔运行用户脚本。

- 退出码 100 = 高峰 → agent/pre-step 返回 { kind: 'reject' } 挂起用户步骤。
- 退出码 101 = 低峰 → 放行；若脚本有输出，一并注入上下文。
- 其它退出码 = 错误 → 记录 lastError 并放行（避免误挂起，保证低峰期能正常进行）。

挂起判定：仅当明确判为高峰（mode === 'peak'）且自动调度开启时才挂起；低峰、
未知、错误一律放行——确保「低峰自动开始」不被误挂。

全程自动（无需手动）：高峰挂起的步骤会暂存，一旦判定转回低峰，插件自动把
被挂起的消息重新入队并唤醒该 agent 恢复执行（agent/steer + inject）。整个
「高峰自动停止 → 低峰自动开始」闭环无需你手动干预。

状态刷新与开关解耦：无论「自动调度」开/关，轮询都会持续运行并刷新状态
（mode / 上次判定 / 输出）。开关只影响「高峰是否挂起」：关掉后高峰不再挂起，但
状态卡仍会定时刷新。

配置热更新：每个轮询周期都会重新载入 $DSH_HOME/peaklow/.json。即使直接
改了磁盘上的配置文件，下一个周期就会用上新脚本/间隔，避免「脚本是高峰但 mode
仍为低峰、挂起失效」。

启用后，插件向系统提示注入「已启用调度、执行阶段不要向用户提问」及当前判定/脚本/
输出等上下文。

浏览器端状态卡（可交互）

client 插件把一张状态卡注册进会话 slot conversation.session.header.actions，通过
sessionId（宿主侧 agent.id === session.id，dsh-agent 强制相等）访问对应会话。

卡片包含：

- 状态点：高峰橙、低峰绿、错误红、判定中灰。
- 开关按钮：自动调度·开（绿色）/ 自动调度·关（灰色）——点击即启用/停用
自动调度（高峰挂起、低峰运行）。
- 「编辑」按钮：展开统一表单，可一次改 判峰脚本、轮询间隔（秒，数字
填写而非下拉选择）、注释/备注，点「保存」即时生效并持久化。
- 每 1.5 秒自动轮询刷新；默认折叠为一行，点击卡头展开详情（模式/间隔/上次判定/
脚本/备注/输出/错误）。

宿主 → 浏览器通道

宿主自己注册两个同源 HTTP 端点（最简单，不动框架与前端产物）：

| 端点 | 方法 | 用途 |
|---|---|---|
| /peaklow/state?session= | GET | 读取当前会话的快照（mode/script/intervalMs/notes/lastStdout/lastError/lastCheckedAt/attempts/enabled），供前端轮询 |
| /peaklow/control | POST | 接收 { session, enabled?, intervalMs?, script?, notes? }，开/关、改间隔、改脚本/注释，并即时生效 + 持久化到 $DSH_HOME/peaklow/.json |

说明：@deepseek-ai/dsh-host-plugin-inventory 只暴露「插件是否加载」这类通用 Loader
状态，不含 peaklow 的逐 agent 运行状态，故需自行用上述端点作为通道。若需授权围栏，
可改用 ctx.connection.rpc.handle + client 侧 client-request/client-response。

文件

| 文件 | 说明 |
|---|---|
| peaklow.mjs | 宿主插件源码（根作用域，inject: ['timer','webServer']），含 /peaklow/state 与 /peaklow/control 端点、自动启动与判峰逻辑 |
| client.js | 浏览器端 client bundle（手写 window.__ModuleLoader__.load(...)，零构建，用 React.createElement） |
| client/index.tsx | 同功能的 TSX 源码（可选，供 esbuild 构建） |
| build-client.mjs | 用 esbuild 把 TSX 打成 load({id,factory}) 格式的脚本 |
| package.json | @pi/peaklow 包元信息 + dsh.host / dsh.client 声明 |
| install.sh | 安装宿主 + client 插件进 web profile，并以包名注册 |
| verify.sh | 语法 + 配置树校验 |

安装

./install.sh

它会：

1. 把 @pi/peaklow 软链进 $DSH_HOME/profiles/web/node_modules/@pi/peaklow。
2. 把 cordis.patch.yml 里 peaklow 的入口由相对路径改为包名 @pi/peaklow。
——这很关键：dsh-client-modules 只扫描已加载的加载器入口并按
entry.options.name 解析 dsh.client。若仍写 ./peaklow.mjs，则无法解析到
dsh.client，client 插件不会被下发到浏览器。
安装后重启 dsh web（无需重建前端）即可：宿主侧会把 @pi/peaklow 加入
window.__DSH_BOOT__ 并从 /plugins/@pi/peaklow/client.js 提供 bundle，打开任一会话页
头部即可看到并操作状态卡。

前端产物不需要重建。但请注意 client bundle 与宿主的加载方式不同：
/plugins/@pi/peaklow/client.js 是从磁盘实时读取的（改动即生效），而宿主
peaklow.mjs 仅在 dsh web 启动时加载一次。因此改动宿主逻辑（如新增端点）后
必须重启 dsh web 才生效。

改用 esbuild 从 TSX 构建（可选）

pnpm add -D esbuild     # 或 npm i -D esbuild（一次性）
node build-client.mjs   # 生成 client.js