dsh-session-superagent 0.8.16 → 0.8.20

package/CHANGELOG.md

@@ -2,6 +2,67 @@
 
 格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.20] - 2026-11-02 —— 冷启动演练：工具返回要能证明「选项生效了」
+
+照 HANDOFF + README 走一遍「加 watcher → 观察 → 确认」（不看代码，只看文档），暴露的摩擦点：
+
+### 修复
+- **`watch_start` 的返回看不出生效项**：只说 `watching … every 3600s`，`observe` / 过滤 / 时段 / 限流
+  到底有没有落上，只能再开面板或读状态文件。现在返回会带回显：
+  `[observe-only（只记录不唤醒） labels=ai-fix batch=5 perHour=6 goal="…"]`，更新已有 watcher 时标 `(updated existing watcher)`。
+- **`watch_status` 同样不回显**：现在每行带 `observe / isolated / paused / hours= / labels= / onlyAssigned / deferred=`，
+  一眼能看出「为什么没动静」。
+- HANDOFF 补「在会话里自查」小表：首选工具（`watch_status` / `watch_doctor`），其次直接读状态文件，
+  HTTP 只在面板/调试时用 —— 并写清端口每次重启都会变、怎么找（会话上下文里的 GUI URL 或按 PID 查 netstat）。
+  冷启动演练时就是卡在「端口找不到」这一步。
+
+### 测试
+- 合计 **85 例**。
+
+## [0.8.19] - 2026-11-02 —— `pnpm run preflight`：把「发版必跑」变成一条命令
+
+### 新增
+- `scripts/preflight.mjs`：七项检查一次跑完并以退出码给结论 ——
+  单测、语法、profile 一致性（`--check`）、版本五处一致、路由面（6 条）、`npm pack` 内容、冒烟（gh 未登录自动 SKIP）。
+  HANDOFF 的验证清单从散文改成这一条命令（散文会过期，脚本不会）。
+- 自测时抓到并修掉一个真问题：preflight 自己的 `DSH_SUPERAGENT_NO_POLL=1` 会**泄漏给子进程**，
+  导致冒烟「3 项 OK / 9 项 FAIL」。现在子进程环境会剔掉这三个开关。
+
+### 变更
+- **包内容精简**：`files` 去掉 `scripts/`，只发运行时需要的 6 项（`lib`、`client.js`、
+  `cordis.patch.yml`、README、CHANGELOG、LICENSE）。`npm pack` 从 14 个文件降到 10 个。
+  开发脚本仍在仓库里（`pnpm run preview` / `smoke:observe` / `preflight` 照旧可用）。
+
+### 测试
+- 合计 **85 例**（本轮无新增用例，改动是工具与打包）。
+
+## [0.8.18] - 2026-11-02 —— watch_start 工具补齐参数（面板能配的，工具也要能配）
+
+### 修复
+- **`watch_start` 之前只接受 `repo` / `intervalSec`**：面板上能设的过滤、仅观察、隔离、时段、
+  限流、每 watcher 目标，用工具都设不了 —— 而 README 把它们都写成能力。现在工具参数补齐
+  （`labels` / `ignoreLabels` / `onlyAssigned` / `assignee` / `observe` / `isolated` / `workdir` /
+  `activeHours` / `batchLimit` / `maxWakesPerHour` / `goal`）。
+- **`intervalSec` 没夹紧**：工具里只判断 `> 0`，能把 5 秒写进状态文件（调度时按 30 秒跑，
+  状态与实际不一致，面板也会显示「每 5s」）。现在夹到 30–3600。
+- `workdir` 走工具时也要求绝对路径且存在。
+
+### 测试
+- 新增 2 例：工具参数落盘与夹紧（5→30、99→20、0→1）、相对 `workdir` 被拒。合计 **84 例**。
+
+## [0.8.17] - 2026-11-02 —— README 声明与面板能力对齐（限流可改）
+
+对着 README 逐条核代码时发现的落差：`batchLimit` / `maxWakesPerHour` 在服务端和工具里都支持，
+**面板却没法设** —— 用户按 README 找这两个开关会找不到。
+
+### 修复
+- 「触发」页新增两个字段：**单次最多唤醒条数**（默认 5，夹到 1-20）、**每小时最多唤醒次数**（默认 6，夹到 1-60）。
+- 行内编辑器同样能改这两项，保存走同一个 `POST /watch`。
+- README 的限流一行补上「面板可改」并标注默认值与范围。
+
+### 测试
+- 新增用例：面板设置 `maxWakesPerHour: 99` 会被夹成 60 并回传。合计 **82 例**。
+
 ## [0.8.16] - 2026-11-02 —— 第一次在真浏览器里看面板，抓到一个对比度问题
 
 宿主的 web 界面有鉴权（`dsh web authentication required`），ego 浏览器过不去，所以搭了个

package/README.md

@@ -1,7 +1,7 @@
 # dsh-session-superagent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.8.16-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
+[![Version](https://img.shields.io/badge/version-0.8.20-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
 [![npm](https://img.shields.io/npm/v/dsh-session-superagent.svg)](https://www.npmjs.com/package/dsh-session-superagent)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-plugin-orange.svg)](https://github.com/topics/dsh-plugin)
 
@@ -21,7 +21,7 @@
 | 盯仓库 | `watch_start` / `watch_status` / `watch_stop` | 30–3600 秒轮询；有变化时用 `Agent.followup()` 唤醒**本会话** |
 | 传递规则 | 仓库里的 `AGENTS.md` | 唤醒消息只说“有新动态”，怎么处理由项目规则决定 |
 | 收窄范围 | `filters` | 只处理带指定标签、或已指派给人的条目；默认跳过机器人、草稿 PR、已关闭条目 |
-| 限流 | `batchLimit` / `maxWakesPerHour` | 单次最多铺开 N 条，每小时最多唤醒 N 次，超了攒着 |
+| 限流 | `batchLimit` / `maxWakesPerHour` | 单次最多铺开 N 条（默认 5，1-20），每小时最多唤醒 N 次（默认 6，1-60），超了攒着；**面板「触发」页可改** |
 | 幂等 | `watch_ack` 工具 | 处理完给条目打「主理鱼:已处理」标签（标签不存在会自动建），轮询直接跳过（换机器也不重报）；支持 `numbers: "12,13"` 批量 |
 | 时段 | `activeHours` | 只在 `09:00-23:00` 这类时段唤醒，夜里攒着；支持跨夜 `22:00-06:00` |
 | 隔离 | `isolated` | 每次唤醒前开一次性 `git worktree`，改副本、推 `zhuli/*` 分支，不动主工作区；超过 3 天的旧副本自动回收 |
@@ -88,7 +88,7 @@ dsh plugin add https://github.com/MYCF711/dsh-session-superagent
 ## 开发
 
 ```sh
-node --test          # 77 项单测
+node --test          # 85 项单测
 ```
 
 版本与发布流程见 [UPDATING.md](UPDATING.md)，交付门见 [CHECKLIST.md](CHECKLIST.md)，接手台账见 [MAINTENANCE.md](MAINTENANCE.md)。

package/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     const { useCallback, useEffect, useRef, useState } = React
 
     // 客户端版本探针：每次模块加载写一次，用来确认浏览器里跑的是哪一版
-    const CLIENT_VERSION = '0.8.16'
+    const CLIENT_VERSION = '0.8.20'
     const BASE = '/session-superagent'
     const ENDPOINT = BASE + '/state'
     const POLL_MS = 5000
@@ -699,6 +699,8 @@ window.__ModuleLoader__.load({
             isolated: !!draft.isolated,
             workdir: draft.workdir || '',
             observe: !!draft.observe,
+            batchLimit: Number(draft.batchLimit) || undefined,
+            maxWakesPerHour: Number(draft.maxWakesPerHour) || undefined,
           }),
         })
         setEditing(null)
@@ -732,6 +734,8 @@ window.__ModuleLoader__.load({
             isolated: !!form.isolated,
             workdir: form.workdir || '',
             observe: !!form.observe,
+            batchLimit: Number(form.batchLimit) || undefined,
+            maxWakesPerHour: Number(form.maxWakesPerHour) || undefined,
           }),
         })
         setForm({ repo: '', intervalSec: form.intervalSec, goal: '', labels: '', onlyAssigned: false, activeHours: form.activeHours, isolated: form.isolated, workdir: form.workdir, observe: form.observe })
@@ -798,6 +802,8 @@ window.__ModuleLoader__.load({
                 isolated: !!watcher.isolated,
                 workdir: watcher.workdir || '',
                 observe: !!watcher.observe,
+                batchLimit: String(watcher.batchLimit ?? 5),
+                maxWakesPerHour: String(watcher.maxWakesPerHour ?? 6),
               })
             },
           }, editing === key ? '收起' : '编辑'),
@@ -818,6 +824,8 @@ window.__ModuleLoader__.load({
             field('活跃时段', h(Input, { value: draft.activeHours, placeholder: '09:00-23:00，留空 = 全天', onChange: (e) => setDraft({ ...draft, activeHours: e.target.value }) })),
             field('目标/规则', h(Input, { value: draft.goal || '', placeholder: '可选，会附在唤醒消息里', onChange: (e) => setDraft({ ...draft, goal: e.target.value }) })),
             h('label', { className: 'dt-switch-row' }, h(Toggle, { checked: !!draft.onlyAssigned, onChange: (v) => setDraft({ ...draft, onlyAssigned: v }), label: '只看已指派' }), '只处理已指派给人的条目'),
+            field('单次最多唤醒条数', h(Input, { value: draft.batchLimit || '', placeholder: '5（1-20）', onChange: (e) => setDraft({ ...draft, batchLimit: e.target.value }) })),
+            field('每小时最多唤醒次数', h(Input, { value: draft.maxWakesPerHour || '', placeholder: '6（1-60）', onChange: (e) => setDraft({ ...draft, maxWakesPerHour: e.target.value }) })),
             h('label', { className: 'dt-switch-row' }, h(Toggle, { checked: !!draft.observe, onChange: (v) => setDraft({ ...draft, observe: v }), label: '仅观察' }), '仅观察（只记录不唤醒）'),
             h('label', { className: 'dt-switch-row' }, h(Toggle, { checked: !!draft.isolated, onChange: (v) => setDraft({ ...draft, isolated: v }), label: '隔离执行' }), '隔离执行（每次唤醒开一次性 worktree）'),
             draft.isolated ? field('隔离工作目录', h(Input, { value: draft.workdir || '', placeholder: '绝对路径，留空 = 当前工作目录', onChange: (e) => setDraft({ ...draft, workdir: e.target.value }) })) : null,
@@ -888,6 +896,8 @@ window.__ModuleLoader__.load({
         h('div', { className: 'dt-form' },
           field('仓库', h(Input, { value: form.repo, placeholder: 'owner/name', onChange: (e) => setForm({ ...form, repo: e.target.value }) })),
           field('间隔（秒）', h(Input, { value: form.intervalSec, onChange: (e) => setForm({ ...form, intervalSec: e.target.value }) })),
+          field('单次最多唤醒条数', h(Input, { value: form.batchLimit || '', placeholder: '5（1-20）', onChange: (e) => setForm({ ...form, batchLimit: e.target.value }) })),
+          field('每小时最多唤醒次数', h(Input, { value: form.maxWakesPerHour || '', placeholder: '6（1-60）', onChange: (e) => setForm({ ...form, maxWakesPerHour: e.target.value }) })),
           field('只处理这些标签', h(Input, { value: form.labels, placeholder: '逗号分隔，留空 = 全部', onChange: (e) => setForm({ ...form, labels: e.target.value }) })),
           field('活跃时段', h(Input, { value: form.activeHours, placeholder: '09:00-23:00，留空 = 全天', onChange: (e) => setForm({ ...form, activeHours: e.target.value }) })),
           field('目标/规则', h(Input, { value: form.goal || '', placeholder: '可选，会附在唤醒消息里', onChange: (e) => setForm({ ...form, goal: e.target.value }) })),

package/lib/index.js

@@ -1018,7 +1018,18 @@ export function apply(ctx) {
     description: 'Watch a GitHub repository and wake THIS session when its issues or pull requests change. Idempotent per (repo, session). Default interval 60 s, minimum 30 s.',
     parameters: {
       repo: { type: 'string', description: 'owner/name. Omit to infer from the current working directory.' },
-      intervalSec: { type: 'number', description: 'Polling interval in seconds, default 60.' },
+      intervalSec: { type: 'number', description: 'Polling interval in seconds, clamped to 30-3600, default 60.' },
+      labels: { type: 'array', items: { type: 'string' }, description: 'Only handle items carrying one of these labels (whitelist).' },
+      ignoreLabels: { type: 'array', items: { type: 'string' }, description: 'Skip items carrying any of these labels.' },
+      onlyAssigned: { type: 'boolean', description: 'Only handle items assigned to someone (or to `assignee`).' },
+      assignee: { type: 'string', description: 'With onlyAssigned: require this login.' },
+      observe: { type: 'boolean', description: 'Observe only: record what WOULD be woken, never wake.' },
+      isolated: { type: 'boolean', description: 'Run each wake in a throwaway git worktree.' },
+      workdir: { type: 'string', description: 'Repository used for isolation worktrees (absolute path).' },
+      activeHours: { type: 'string', description: 'Wake only inside this window, e.g. "09:00-23:00" (supports overnight).' },
+      batchLimit: { type: 'number', description: 'Max items listed per wake (1-20, default 5).' },
+      maxWakesPerHour: { type: 'number', description: 'Max wakes per hour (1-60, default 6).' },
+      goal: { type: 'string', description: 'Optional per-watcher goal appended to the wake message.' },
     },
     async execute(args) {
       const agent = ctx.agents && typeof ctx.agents.currentInitiator === 'function' ? ctx.agents.currentInitiator() : undefined
@@ -1044,14 +1055,46 @@ export function apply(ctx) {
         enabled: true,
         createdAt: new Date().toISOString(),
       }
-      if (typeof args.intervalSec === 'number' && args.intervalSec > 0) entry.intervalSec = args.intervalSec
+      if (typeof args.intervalSec === 'number' && args.intervalSec > 0) {
+        // 之前只判断 >0，能把 5 秒存进状态文件（调度时会按 30 秒跑，但状态与实际不一致）
+        entry.intervalSec = Math.max(30, Math.min(3600, Math.round(args.intervalSec)))
+      }
+      const patch = {}
+      if (args.labels !== undefined) patch.labels = args.labels
+      if (args.ignoreLabels !== undefined) patch.ignoreLabels = args.ignoreLabels
+      if (args.onlyAssigned !== undefined) patch.onlyAssigned = args.onlyAssigned
+      if (args.assignee !== undefined) patch.assignee = args.assignee
+      if (Object.keys(patch).length > 0) entry.filters = mergeFilters(entry.filters, patch)
+      if (typeof args.goal === 'string') entry.goal = args.goal.slice(0, 500)
+      if (typeof args.observe === 'boolean') entry.observe = args.observe
+      if (typeof args.isolated === 'boolean') entry.isolated = args.isolated
+      if (typeof args.workdir === 'string' && args.workdir.trim()) {
+        const workdir = args.workdir.trim()
+        if (!isAbsolute(workdir)) return '[error: workdir must be an absolute path]'
+        if (!existsSync(workdir)) return '[error: workdir does not exist: ' + workdir + ']'
+        entry.workdir = workdir
+      }
+      if (typeof args.activeHours === 'string') entry.activeHours = args.activeHours.trim() || null
+      if (typeof args.batchLimit === 'number') entry.batchLimit = Math.max(1, Math.min(20, Math.round(args.batchLimit)))
+      if (typeof args.maxWakesPerHour === 'number') entry.maxWakesPerHour = Math.max(1, Math.min(60, Math.round(args.maxWakesPerHour)))
       entry.enabled = true
       state.watchers = state.watchers || {}
       state.watchers[id] = entry
       writeState(state)
       stopWatcher(id)
       startWatcher(entry)
-      return `watching ${repo} → session ${sessionId} every ${entry.intervalSec}s${existing ? ' (already existed)' : ''}`
+      const flags = []
+      if (entry.observe === true) flags.push('observe-only（只记录不唤醒）')
+      if (entry.isolated === true) flags.push('isolated')
+      if (entry.activeHours) flags.push('activeHours=' + entry.activeHours)
+      if (entry.filters && entry.filters.labels && entry.filters.labels.length) flags.push('labels=' + entry.filters.labels.join(','))
+      if (entry.filters && entry.filters.onlyAssigned) flags.push('onlyAssigned' + (entry.filters.assignee ? '(' + entry.filters.assignee + ')' : ''))
+      if (entry.batchLimit) flags.push('batch=' + entry.batchLimit)
+      if (entry.maxWakesPerHour) flags.push('perHour=' + entry.maxWakesPerHour)
+      if (entry.goal) flags.push('goal=' + JSON.stringify(entry.goal.slice(0, 40)))
+      return `watching ${repo} → session ${sessionId} every ${entry.intervalSec}s` +
+        (flags.length ? ' [' + flags.join(' ') + ']' : '') +
+        (existing ? ' (updated existing watcher)' : '')
     },
   }))
 
@@ -1064,14 +1107,25 @@ export function apply(ctx) {
       const list = Object.values(state.watchers || {})
       if (!list.length) return '(no watchers)'
       return list
-        .map((w) => [
-          w.repo, '→', w.sessionId,
-          '| every ' + w.intervalSec + 's',
-          '| cursor=' + (w.cursor || '-'),
-          '| lastPoll=' + (w.lastPoll || '-'),
-          '| lastWake=' + (w.lastWake || '-'),
-          '| err=' + (w.lastError || '-'),
-        ].join(' '))
+        .map((w) => {
+          const flags = []
+          if (w.observe === true) flags.push('observe')
+          if (w.isolated === true) flags.push('isolated')
+          if (w.enabled === false) flags.push('paused')
+          if (w.activeHours) flags.push('hours=' + w.activeHours)
+          if (w.filters && w.filters.labels && w.filters.labels.length) flags.push('labels=' + w.filters.labels.join(','))
+          if (w.filters && w.filters.onlyAssigned) flags.push('onlyAssigned')
+          if (w.lastDeferred) flags.push('deferred=' + JSON.stringify(String(w.lastDeferred).slice(0, 40)))
+          return [
+            w.repo, '→', w.sessionId,
+            '| every ' + w.intervalSec + 's',
+            flags.length ? '| ' + flags.join(' ') : '',
+            '| cursor=' + (w.cursor || '-'),
+            '| lastPoll=' + (w.lastPoll || '-'),
+            '| lastWake=' + (w.lastWake || '-'),
+            '| err=' + (w.lastError || '-'),
+          ].filter(Boolean).join(' ')
+        })
         .join('\n')
     },
   }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-superagent",
-  "version": "0.8.16",
+  "version": "0.8.20",
   "description": "Session-level superagent for DeepSeek Harness: watch a GitHub repository and wake a session when something needs doing. Credentials never reach the model.",
   "type": "module",
   "main": "lib/index.js",
@@ -17,11 +17,7 @@
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
-    "client.js",
-    "scripts/preview-orbit.mjs",
-    "scripts/port-official-ui.mjs",
-    "scripts/sync-profile.mjs",
-    "scripts/render-preview.mjs"
+    "client.js"
   ],
   "engines": {
     "node": ">=22.19.0",
@@ -35,7 +31,8 @@
     "smoke:observe": "node scripts/smoke-observe.mjs",
     "sync:profile:check": "node scripts/sync-profile.mjs --check",
     "sync:profile:repair": "node scripts/sync-profile.mjs --repair",
-    "preview": "node scripts/render-preview.mjs"
+    "preview": "node scripts/render-preview.mjs",
+    "preflight": "node scripts/preflight.mjs"
   },
   "keywords": [
     "dsh",

package/scripts/port-official-ui.mjs

@@ -1,40 +0,0 @@
-// 把官方 dsh-superagent 的 GUI 样式表移植进 client.js（可重复执行，幂等）。
-//
-// 官方包的 CSS 在编译产物里是 `var client_default = "<JSON 转义的 CSS>";`，
-// 这里用 JSONDecoder 的等价物（JSON.parse 的 raw 扫描）取出来，再以 JSON 字符串
-// 塞进本仓库 client.js 的 `const PORTED_CSS = "…";` 行。
-//
-// 用法： node scripts/port-official-ui.mjs [官方包路径]
-import { readFileSync, writeFileSync } from 'node:fs'
-
-const OFFICIAL = process.argv[2] ?? 'D:/主工作区/projects/dsh-superagent-prototype/lib/client.js'
-const TARGET = new URL('../client.js', import.meta.url)
-
-const official = readFileSync(OFFICIAL, 'utf8')
-const marker = 'var client_default = '
-const at = official.indexOf(marker)
-if (at < 0) throw new Error('官方产物里找不到 client_default（CSS）常量，路径对吗？' + OFFICIAL)
-
-// 从引号开始扫到匹配的收尾引号（处理反斜杠转义），再 JSON.parse 还原
-let i = at + marker.length
-if (official[i] !== '"') throw new Error('CSS 常量不是字符串字面量')
-let j = i + 1
-while (j < official.length) {
-  if (official[j] === '\\') j += 2
-  else if (official[j] === '"') break
-  else j += 1
-}
-const css = JSON.parse(official.slice(i, j + 1))
-
-const client = readFileSync(TARGET, 'utf8')
-const linePrefix = '    const PORTED_CSS = '
-const start = client.indexOf(linePrefix)
-if (start < 0) throw new Error('client.js 里没有 PORTED_CSS 占位行')
-const end = client.indexOf('\n', start)
-if (end < 0) throw new Error('PORTED_CSS 行没有换行结尾')
-
-const next = client.slice(0, start) + linePrefix + JSON.stringify(css) + ';' + client.slice(end)
-writeFileSync(TARGET, next)
-
-console.log(`官方 CSS: ${css.length} 字符 / ${css.split('\n').length} 行`)
-console.log(`client.js: ${client.length} -> ${next.length} 字节`)

package/scripts/preview-orbit.mjs

@@ -1,136 +0,0 @@
-// 用【真实的 client.js】渲染出 SVG，再拼成 standalone 预览页 —— 预览与线上同一份代码
-import { readFileSync, writeFileSync } from 'node:fs'
-import vm from 'node:vm'
-
-const SRC = readFileSync(new URL('../client.js', import.meta.url), 'utf8')
-
-let mod = null
-const sandbox = {
-  window: {
-    __ModuleLoader__: { load(m) { mod = m } },
-    innerWidth: 1440, innerHeight: 900,
-    addEventListener() {}, removeEventListener() {},
-  },
-  document: {
-    getElementById: () => null,
-    createElement: () => ({ id: '', textContent: '' }),
-    head: { appendChild() {} },
-    addEventListener() {}, removeEventListener() {},
-  },
-  fetch: () => Promise.resolve({ ok: true, status: 200, text: () => Promise.resolve('{}') }),
-  setInterval: () => 0, clearInterval: () => {},
-  console,
-}
-vm.createContext(sandbox)
-vm.runInContext(SRC, sandbox)
-
-let queue = [], index = 0
-const React = {
-  Fragment: Symbol('Fragment'),
-  createElement(type, props, ...children) {
-    return { type, props: { ...(props || {}), children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false) } }
-  },
-  memo: (fn) => fn,
-  useState(init) {
-    const v = index < queue.length ? queue[index] : (typeof init === 'function' ? init() : init)
-    index += 1
-    return [v, () => {}]
-  },
-  useEffect() {},
-  useCallback: (fn) => fn,
-  useRef: (v) => ({ current: v }),
-}
-const regs = []
-mod.factory((n) => { if (n === 'react') return React; throw new Error(n) }).apply({
-  effect: (fn) => fn(),
-  slots: { inject: (_n, fn) => fn(), register: (o, C) => { regs.push({ o, C }); return () => {} } },
-})
-const orbit = regs.find((r) => r.o.id === 'session-superagent-orbit')
-
-const render = (watchers) => { queue = [watchers]; index = 0; return orbit.C({}) }
-
-function renderNode(node) {
-  if (node === null || node === undefined || node === false) return ''
-  if (typeof node === 'string' || typeof node === 'number') return String(node)
-  if (typeof node.type === 'function') return renderNode(node.type(node.props || {}))
-  const attrs = []
-  for (const [k, v] of Object.entries(node.props || {})) {
-    if (k === 'children' || v === null || v === undefined || v === false) continue
-    if (k === 'key' || k === 'ref') continue
-    if (k === 'style') {
-      const css = Object.entries(v).map(([sk, sv]) => sk.replace(/[A-Z]/g, (m) => '-' + m.toLowerCase()) + ':' + sv).join(';')
-      attrs.push(`style="${css}"`)
-      continue
-    }
-    const KEEP = new Set(['viewBox', 'attributeName', 'attributeType', 'repeatCount', 'repeatDur', 'preserveAspectRatio', 'gradientUnits', 'patternUnits', 'spreadMethod', 'startOffset', 'markerWidth', 'markerHeight', 'refX', 'refY', 'baseFrequency', 'numOctaves', 'stdDeviation', 'textLength', 'lengthAdjust'])
-    const name = KEEP.has(k) ? k : k.replace(/[A-Z]/g, (m) => '-' + m.toLowerCase())
-    attrs.push(`${name}="${String(v).replace(/"/g, '&quot;')}"`)
-  }
-  const kids = (node.props?.children || []).map(renderNode).join('')
-  return `<${node.type}${attrs.length ? ' ' + attrs.join(' ') : ''}>${kids}</${node.type}>`
-}
-
-const svgOf = (watchers) => {
-  const tree = render(watchers)
-  if (!tree) return ''
-  // 找到 svg 节点（button 的唯一子元素）
-  const find = (n) => {
-    if (!n || typeof n !== 'object') return null
-    if (typeof n.type === 'function') return find(n.type(n.props || {}))
-    if (n.type === 'svg') return n
-    for (const c of n.props?.children || []) { const hit = find(c); if (hit) return hit }
-    return null
-  }
-  return renderNode(find(tree))
-}
-
-const w = (repo, extra = {}) => ({ repo, sessionId: 'session-' + repo, intervalSec: 30, enabled: true, lastPoll: null, lastWake: null, lastError: null, title: repo, ...extra })
-const cases = [
-  ['0 个 · 空态（灰环占位，无卫星）', []],
-  ['1 个 · 值守中', [w('MYCF711/dsh-GOkifu-compact')]],
-  ['3 个 · 全部值守中', [w('a/b'), w('c/d'), w('e/f')]],
-  ['3 个 · 混合（绿=值守中 / 琥珀=已暂停 / 红=轮询失败）', [w('a/b'), w('c/d', { enabled: false }), w('e/f', { lastError: 'boom' })]],
-  ['2 个 · 全部已暂停', [w('a/b', { enabled: false }), w('c/d', { enabled: false })]],
-  ['6 个 · 上限', [w('a/b'), w('c/d'), w('e/f'), w('g/h'), w('i/j'), w('k/l')]],
-]
-
-const rows = cases.map(([label, list]) => {
-  const svg = svgOf(list)
-  return `<tr><td class="lb">${label}</td>
-      <td class="big">${svg}</td>
-      <td class="real">${svg}</td></tr>`
-}).join('\n')
-
-const OUT = process.argv[2] || 'E:/Documents/deepseek-harness/default-workspace/orbit-preview.html'
-writeFileSync(OUT, `<!doctype html>
-<html lang="zh-CN"><head><meta charset="utf-8"><title>轨道环预览 · dsh-session-superagent</title>
-<style>
-  :root { color-scheme: dark }
-  body { margin:0; padding:28px 34px; background:#1b1b1f; color:#e6e6e6;
-         font:13px/1.6 system-ui,-apple-system,"Segoe UI",sans-serif }
-  h1 { font-size:15px; font-weight:600; margin:0 0 4px }
-  p.sub { margin:0 0 22px; opacity:.55 }
-  table { border-collapse:collapse }
-  td { padding:10px 22px 10px 0; vertical-align:middle; border-bottom:1px solid #ffffff14 }
-  td.lb { opacity:.8; white-space:nowrap; padding-right:34px }
-  td.big svg { width:44px; height:44px }   /* 放大看形状 */
-  td.real svg { width:16px; height:16px }  /* 线上就是这个大小 */
-  th { text-align:left; font-weight:500; opacity:.45; font-size:12px; padding-bottom:6px }
-  .note { margin-top:22px; opacity:.5; font-size:12px }
-  code { background:#ffffff12; padding:1px 5px; border-radius:4px }
-</style></head>
-<body>
-  <h1>轨道环 · 真实组件渲染预览</h1>
-  <p class="sub">这份 HTML 由 <code>client.js</code> 本身渲染生成（不是另画一份），所以线上长什么样这里就是什么样。</p>
-  <table>
-    <tr><th>状态</th><th>放大 44px</th><th>实际 16px</th></tr>
-    ${rows}
-  </table>
-  <div class="note">
-    值守中 = 卫星沿环公转（6s/圈）＋ 环本身呼吸（2.6s）；已暂停 = 虚线环、不转；轮询失败 = 红点呼吸（1.6s）。<br>
-    已验证动画走 SVG 自带的 SMIL，不依赖外部样式表 —— 上一版引用了不存在的 <code>.sa-sat-spin</code> 规则，所以是死的。
-  </div>
-</body></html>
-`, 'utf8')
-console.log('wrote', OUT)
-console.log('SMIL in preview:', (readFileSync(OUT, 'utf8').match(/animateTransform/g) || []).length, 'animateTransform tags')

package/scripts/render-preview.mjs

@@ -1,213 +0,0 @@
-// 把「主理鱼」面板渲染成静态 HTML，用于在真浏览器里看布局（不需要宿主、不需要 React）。
-//
-// 为什么：client.js 是给宿主用的模块（`window.__ModuleLoader__.load` + `require('react')`），
-// 组件树用 h() 构造。这里提供一个极简的假 React，把组件渲染成虚拟节点树，
-// 再序列化成 HTML，并内联移植来的官方 CSS —— 于是可以在浏览器里真实地看布局。
-//
-// 用法： node scripts/render-preview.mjs [输出文件]
-//   node scripts/render-preview.mjs preview-panel.html
-import { readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import vm from 'node:vm'
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
-const OUT = process.argv[2] || join(ROOT, 'preview-panel.html')
-
-// ── 假 React：只需要 createElement/useState/useEffect/useCallback/useRef/memo/Fragment ──
-let hookQueue = []
-let hookIndex = 0
-const React = {
-  Fragment: Symbol('Fragment'),
-  createElement(type, props, ...children) {
-    return { type, props: { ...(props || {}), children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false) } }
-  },
-  memo: (fn) => fn,
-  useState(init) {
-    const value = hookIndex < hookQueue.length ? hookQueue[hookIndex] : (typeof init === 'function' ? init() : init)
-    hookIndex += 1
-    return [value, () => {}]
-  },
-  useEffect() {},
-  useCallback: (fn) => fn,
-  useRef: (value) => ({ current: value }),
-}
-
-// 假宿主：只收集注册，不真的挂任何东西
-const registrations = []
-const sandbox = {
-  window: {
-    __ModuleLoader__: { load: (mod) => registrations.push(mod) },
-    innerWidth: 1280, innerHeight: 900,
-    addEventListener() {}, removeEventListener() {},
-  },
-  document: {
-    getElementById: () => null,
-    createElement: () => ({ id: '', textContent: '' }),
-    head: { appendChild() {} },
-    addEventListener() {}, removeEventListener() {},
-  },
-  fetch: () => Promise.resolve({ ok: true, status: 200, text: () => Promise.resolve('{}') }),
-  setInterval: () => 0, clearInterval: () => {}, setTimeout: () => 0, clearTimeout: () => {},
-  console,
-}
-vm.createContext(sandbox)
-vm.runInContext(readFileSync(join(ROOT, 'client.js'), 'utf8'), sandbox)
-
-const mod = registrations[0]
-if (!mod) throw new Error('client.js 没有注册任何模块')
-const slots = new Map()
-const ctx = {
-  slots: {
-    inject: (_name, fn) => fn(),
-    register: (opts, Component) => { slots.set(opts.id, Component); return () => {} },
-  },
-  effect: (fn) => fn(),
-}
-mod.factory((name) => {
-  if (name === 'react') return React
-  throw new Error('unexpected require: ' + name)
-}).apply(ctx)
-
-const Desk = slots.get('session-superagent-desk')
-if (!Desk) throw new Error('没有注册 session-superagent-desk，已注册：' + [...slots.keys()].join(','))
-
-// ── 样本快照：覆盖各种状态（正常/暂停/异常/仅观察/隔离/退避/过滤记录/历史）──
-const now = Date.now()
-const iso = (ms) => new Date(now - ms).toISOString()
-const snapshot = {
-  loading: false, error: null,
-  body: {
-    sessionTitle: 'README 收尾与发布',
-    sessionGoal: null,
-    gh: { ok: true, version: 'gh version 2.101.0' },
-    credentials: { token: 'configured', sshKeyPath: 'none' },
-    watchers: [
-      {
-        id: 'MYCF711/dsh-session-superagent#s1', repo: 'MYCF711/dsh-session-superagent', sessionId: 's1',
-        intervalSec: 60, enabled: true, observe: false, title: 'README 收尾与发布', note: '把 0.8.x 的文档补齐',
-        lastPoll: iso(15000), lastWake: iso(300000), lastWakeCount: 3, lastAbsorbed: 1,
-        filters: { labels: ['ai-fix'], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
-        activeHours: '09:00-23:00', isolated: true, workdir: 'E:/temp/iso', lastWorktree: 'E:/temp/iso/.dsh-zhuli/a-b',
-        history: [
-          { at: iso(300000), numbers: [12], ok: true, reason: null },
-          { at: iso(600000), numbers: [11], ok: false, reason: 'observe' },
-        ],
-        filteredLog: [{ number: 7, title: '机器人提的依赖升级', reason: '机器人', at: iso(120000) }],
-      },
-      {
-        id: 'MYCF711/dsh-GOkifu-compact#s2', repo: 'MYCF711/dsh-GOkifu-compact', sessionId: 's2',
-        intervalSec: 120, enabled: false, observe: true, title: '联调会话',
-        lastPoll: iso(900000), lastDeferred: '仅观察：本轮本会唤醒 2 条（#4 #3）',
-        filters: { labels: [], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
-        history: [], filteredLog: [],
-      },
-      {
-        id: 'a/b#s3', repo: 'someone/broken-repo', sessionId: 's3', intervalSec: 30, enabled: true,
-        title: '出错示例', lastPoll: iso(5000), lastError: 'gh: Not Found (HTTP 404)（仓库不存在或没权限：检查 owner/name）',
-        consecutiveFailures: 2, nextAt: new Date(now + 180000).toISOString(),
-        filters: { labels: [], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
-        history: [], filteredLog: [],
-      },
-    ],
-  },
-}
-
-// ── 渲染：把元素树序列化成 HTML ───────────────────────────────────────────────
-function escapeHtml(text) {
-  return String(text).replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[c]))
-}
-function styleToCss(style) {
-  if (!style) return ''
-  return Object.entries(style).map(([k, v]) => {
-    const prop = k.startsWith('--') ? k : k.replace(/[A-Z]/g, (m) => '-' + m.toLowerCase())
-    return prop + ':' + v
-  }).join(';')
-}
-function attr(name, value) {
-  if (value === undefined || value === null || value === false || value === true) {
-    return value === true ? ' ' + name : ''
-  }
-  return ' ' + name + '="' + escapeHtml(value) + '"'
-}
-function render(node) {
-  if (node === null || node === undefined || node === false) return ''
-  if (typeof node === 'string' || typeof node === 'number') return escapeHtml(node)
-  if (Array.isArray(node)) return node.map(render).join('')
-  if (typeof node !== 'object') return ''
-  const { type, props = {} } = node
-  if (typeof type === 'function') return render(type(props))
-  if (type === React.Fragment) return (props.children || []).map(render).join('')
-  const voidTags = new Set(['input', 'img', 'br', 'hr', 'meta', 'link'])
-  const tag = String(type)
-  const parts = []
-  if (props.className) parts.push(attr('class', props.className))
-  if (props.style) parts.push(attr('style', styleToCss(props.style)))
-  for (const key of ['data-tone', 'data-state', 'data-open', 'role', 'title', 'aria-label', 'aria-selected', 'aria-pressed', 'aria-modal', 'type', 'placeholder', 'value', 'disabled']) {
-    if (props[key] !== undefined && props[key] !== false) parts.push(attr(key, props[key]))
-  }
-  if (keyIsVoid(tag)) return '<' + tag + parts.join('') + '>'
-  return '<' + tag + parts.join('') + '>' + (props.children || []).map(render).join('') + '</' + tag + '>'
-}
-function keyIsVoid(tag) {
-  return ['input', 'img', 'br', 'hr', 'meta', 'link'].includes(tag)
-}
-
-// 取移植来的 CSS
-const clientSrc = readFileSync(join(ROOT, 'client.js'), 'utf8')
-const marker = 'const PORTED_CSS = "'
-const head = clientSrc.indexOf(marker) + marker.length
-let i = head
-while (i < clientSrc.length && clientSrc[i] !== '"') i += clientSrc[i] === '\\' ? 2 : 1
-const PORTED_CSS = JSON.parse('"' + clientSrc.slice(head, i) + '"')
-
-const scenarios = [
-  { name: '总览', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
-  { name: '判定', hooks: [snapshot, 'judge', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
-  { name: '触发', hooks: [snapshot, 'trigger', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
-  { name: '设置', hooks: [snapshot, 'settings', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
-  { name: 'Toast（保存成功）', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, { id: 't1', text: '已保存：MYCF711/dsh-session-superagent', tone: 'info' }, null, {}, '', false] },
-  { name: 'Toast（错误）', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, { id: 't2', text: '保存失败：gh: Not Found (HTTP 404)', tone: 'error' }, null, {}, '', false] },
-  { name: '术语表', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', true] },
-]
-
-const sections = scenarios.map((scenario) => {
-  hookQueue = scenario.hooks
-  hookIndex = 0
-  const tree = Desk({ sessionId: 'preview-session' })
-  return '<h2 class="preview-title">' + scenario.name + '</h2>\n<div class="preview-frame">' + render(tree) + '</div>'
-}).join('\n')
-
-// 极简 token 兜底：宿主里这些由 --dsw-alias-* 提供，预览里给一组浅色近似值
-const tokens = `:root{
-  --dsw-alias-label-primary:#1f2328; --dsw-alias-label-secondary:#59636e; --dsw-alias-label-tertiary:#818b98;
-  --dsw-alias-bg-layer-1:#ffffff; --dsw-alias-bg-layer-2:#f6f8fa; --dsw-alias-bg-layer-3:#eef1f4;
-  --dsw-alias-border-default:#d8dee4; --dsw-alias-border-muted:#e6eaef;
-  --dsw-alias-accent-primary:#0969da; --dsw-alias-success-500:#1a7f37; --dsw-alias-warning-500:#9a6700;
-  --dsw-alias-error-500:#cf222e; --dsw-static-neutral-bluish-00:#ffffff;
-  --dsw-shadow-lv3:0 8px 24px rgba(31,35,40,.12);
-  /* tag / 状态点真正引用的 token（官方 CSS 用 --dsw-alias-state-*） */
-  --dsw-alias-state-success-primary:#1a7f37; --dsw-alias-state-warn-primary:#9a6700;
-  --dsw-alias-state-error-primary:#cf222e; --dsw-alias-state-info-primary:#0969da;
-  --dsw-alias-toast-bg:#24292f;
-}`
-
-const html = `<!doctype html>
-<meta charset="utf-8">
-<title>主理鱼面板预览</title>
-<style>
-${tokens}
-body{font:14px/1.45 -apple-system,"Segoe UI",system-ui,sans-serif;background:#eef1f4;margin:0;padding:24px;color:#1f2328}
-.preview-title{margin:28px 0 8px;font-size:15px;color:#57606a}
-.preview-frame{width:900px;background:#fff;border:1px solid #d8dee4;border-radius:12px;min-height:120px;max-height:820px;overflow:auto}
-.dt-page{height:auto!important;max-height:none!important}
-${PORTED_CSS}
-</style>
-<div style="font:13px/1.5 system-ui;color:#57606a">
-  主理鱼面板静态预览 —— 真实 client.js 渲染出的 DOM + 移植的官方 CSS（宽度 900px，token 为浅色近似值）
-</div>
-${sections}
-`
-writeFileSync(OUT, html)
-console.log('已写出：' + OUT)
-console.log('字节：' + html.length)

package/scripts/sync-profile.mjs

@@ -1,129 +0,0 @@
-// 把插件源码目录同步到 profile 的安装副本。
-//
-// 为什么需要：profile 里是 `file:` 安装 —— pnpm 为**已存在的文件**建了硬链接，
-// 改内容会自动生效；但**新增文件不会**自动出现，而**被原子写入替换的文件会断链**。
-//
-// 真实事故 1（2026-11-01 23:59 重启）：新增的 lib/body.js 没进 profile，
-//   宿主 import './body.js' 失败 → 整个插件不挂载 → 工具和 HTTP 路由全消失，
-//   客户端 bundle 却照常加载，表面看起来"插件还在"。
-// 真实事故 2（潜伏）：某些工具用「写临时文件再 rename」保存，profile 里那份仍是旧 inode，
-//   于是宿主跑的是旧代码，而仓库里看着已经是新代码。
-//
-// 用法：
-//   node scripts/sync-profile.mjs            补齐缺失文件（不动断链，只警告）
-//   node scripts/sync-profile.mjs --repair   断链也重建硬链接，并清理 profile 里的陈旧文件
-//   node scripts/sync-profile.mjs --check    只检查：有缺失/断链/陈旧就 exit 1（给 CI 用）
-//   node scripts/sync-profile.mjs --dir <path>  指定 profile 安装目录
-import { existsSync, linkSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
-const args = process.argv.slice(2)
-const REPAIR = args.includes('--repair')
-const CHECK = args.includes('--check')
-const dirFlag = args.indexOf('--dir')
-const DEFAULT_PROFILE = join(
-  process.env.DSH_HOME || join(process.env.USERPROFILE || '', '.dsh'),
-  'profiles',
-  'desktop',
-  'node_modules',
-  'dsh-session-superagent',
-)
-const DEST = dirFlag >= 0 ? args[dirFlag + 1] : DEFAULT_PROFILE
-
-/** 运行时要用的文件（不含 docs / test / scripts 这些开发件）。 */
-const TARGETS = [
-  'client.js', 'package.json', 'cordis.patch.yml', 'README.md', 'CHANGELOG.md', 'LICENSE',
-  'lib/index.js', 'lib/watch.js', 'lib/redact.js', 'lib/body.js',
-]
-
-if (!existsSync(DEST)) {
-  console.error('找不到 profile 安装目录：' + DEST)
-  process.exit(1)
-}
-
-const drift = { missing: [], broken: [], stale: [] }
-let linked = 0
-
-for (const rel of TARGETS) {
-  const src = join(ROOT, rel)
-  const dst = join(DEST, rel)
-  if (!existsSync(src)) continue
-  if (!existsSync(dst)) {
-    drift.missing.push(rel)
-    if (!CHECK) {
-      mkdirSync(dirname(dst), { recursive: true })
-      try { linkSync(src, dst); linked += 1; console.log('linked   ' + rel) } catch (error) {
-        console.log('link 失败：' + rel + ' — ' + (error && error.message))
-      }
-    }
-    continue
-  }
-  const same = statSync(src).ino === statSync(dst).ino
-  if (same) continue
-  drift.broken.push(rel)
-  if (REPAIR && !CHECK) {
-    try {
-      unlinkSync(dst)
-      linkSync(src, dst)
-      linked += 1
-      console.log('relinked ' + rel + '（原来断了）')
-    } catch (error) {
-      console.log('重建失败：' + rel + ' — ' + (error && error.message))
-    }
-  } else {
-    console.log('注意     ' + rel + '（inode 不同：内容改动不会同步到 profile，用 --repair 重建）')
-  }
-}
-
-// 陈旧文件：profile 里有、仓库里已经没有（例如删掉的模块）
-for (const name of readdirSync(join(DEST, 'lib')).filter((f) => f.endsWith('.js'))) {
-  if (!existsSync(join(ROOT, 'lib', name))) {
-    drift.stale.push('lib/' + name)
-    if (REPAIR && !CHECK) {
-      try { unlinkSync(join(DEST, 'lib', name)); console.log('pruned   lib/' + name) } catch {}
-    } else {
-      console.log('陈旧     lib/' + name + '（仓库已删除，profile 里还在）')
-    }
-  }
-}
-
-// lib/ 里每个相对 import 都必须能解析（这正是事故 1 的直接原因）
-const libDir = join(ROOT, 'lib')
-const missingImports = []
-for (const name of readdirSync(libDir)) {
-  if (!name.endsWith('.js')) continue
-  const code = readFileSync(join(libDir, name), 'utf8')
-  for (const line of code.split(String.fromCharCode(10))) {
-    const trimmed = line.trim()
-    if (!trimmed.startsWith('import ')) continue
-    const at = trimmed.lastIndexOf("from '")
-    let spec = null
-    if (at >= 0) {
-      spec = trimmed.slice(at + 6).split("'")[0]
-    } else if (trimmed.slice('import '.length).startsWith("'")) {
-      spec = trimmed.slice('import '.length + 1).split("'")[0]
-    }
-    if (spec && spec.startsWith('.') && !existsSync(join(libDir, spec))) {
-      missingImports.push(name + ' -> ' + spec)
-    }
-  }
-}
-
-const drifted = drift.missing.length + drift.broken.length + drift.stale.length
-console.log('---')
-console.log(`目标：${DEST}`)
-console.log(`缺失 ${drift.missing.length} / 断链 ${drift.broken.length} / 陈旧 ${drift.stale.length}` +
-  (linked ? `，本次处理 ${linked} 个` : ''))
-
-if (missingImports.length > 0) {
-  console.error('相对 import 解析失败：' + missingImports.join(', '))
-  process.exit(2)
-}
-console.log('相对 import 全部可解析 ✓')
-
-if (CHECK && drifted > 0) {
-  console.error('profile 与仓库不一致（跑 --repair 修）')
-  process.exit(1)
-}