dsh-session-superagent 0.8.16 → 0.8.27

package/lib/index.js

@@ -182,6 +182,22 @@ function ghEnv() {
   return { ...process.env, GH_TOKEN: String(s.token) }
 }
 
+/**
+ * 安全地取 agents 服务。
+ * 定时器回调跑在「非活跃上下文」里，直接读 `ctx.agents` 会抛
+ * `cannot get required service "agents" in inactive context`（2026-11-02 真机复验踩到）；
+ * `ctx.get(name)` 不抛，取不到就返回 undefined。
+ */
+function agentsService(ctx) {
+  try {
+    if (typeof ctx.get === 'function') {
+      const viaGet = ctx.get('agents')
+      if (viaGet) return viaGet
+    }
+  } catch {}
+  try { return ctx.agents } catch { return undefined }
+}
+
 /** gh CLI 可用性探针：5 分钟缓存，别让面板每 5 秒都 spawn 一次 gh。 */
 const ghHealthCache = { at: 0, value: null }
 async function ghHealth() {
@@ -339,7 +355,8 @@ function defineTool(options) {
  * inbox alone only parks the message (the client shows it as a pending draft).
  */
 function wake(ctx, sessionId, text) {
-  const agent = ctx.agents && typeof ctx.agents.get === 'function' ? ctx.agents.get(sessionId) : undefined
+  const agents = agentsService(ctx)
+  const agent = agents && typeof agents.get === 'function' ? agents.get(sessionId) : undefined
   if (!agent) return { ok: false, reason: 'session not live' }
 
   const allowed = decideWake(agent.status)
@@ -468,7 +485,8 @@ async function pollOnce(ctx, entry, baseMs) {
     return
   }
   // 会话忙就别开隔离区了：白建一个没人用的 worktree
-  const liveAgent = ctx.agents && typeof ctx.agents.get === 'function' ? ctx.agents.get(entry.sessionId) : undefined
+  const liveAgents = agentsService(ctx)
+  const liveAgent = liveAgents && typeof liveAgents.get === 'function' ? liveAgents.get(entry.sessionId) : undefined
   if (!liveAgent) {
     // 会话已经不在了（被删/换机器）：别开隔离区，也别假装在盯。
     // 必须走 bumpFailure —— 否则这条会每 intervalSec 打一次 GitHub，永不退避（第四轮审核指出）。
@@ -540,7 +558,10 @@ export function apply(ctx) {
       try {
         await pollOnce(ctx, entry, every)
       } catch (error) {
+        // 未预期的异常（比如宿主上下文/服务不可用）也必须退避：
+        // 之前只写 lastError，于是坏掉的 watcher 会按 intervalSec 无限重试（真机踩到过）。
         entry.lastError = String((error && error.message) || error)
+        bumpFailure(entry, every)
       } finally {
         inFlight.delete(entry.id)
         persistEntry(entry)
@@ -569,6 +590,17 @@ export function apply(ctx) {
   const registerRoutes = (httpServer) => {
     if (!httpServer || typeof httpServer.register !== 'function') return
     const routes = []
+    // 宿主热重载时旧实例的路由可能还没 dispose；一条重复会让整个 try 崩掉，
+    // 面板和所有接口一起 404（2026-11-02 真机踩到 webserver: duplicate exact route）。
+    // 改成每条路由单独容错：重复的那条记下来，其余照常注册。
+    const failedRoutes = []
+    const addRoute = (options) => {
+      try {
+        routes.push(httpServer['register'](options))
+      } catch (error) {
+        failedRoutes.push(String((error && error.message) || error).slice(0, 120))
+      }
+    }
     const record = (kind, detail) => {
       const state = readState()
       state.client = state.client || {}
@@ -576,7 +608,7 @@ export function apply(ctx) {
       writeState(state)
     }
     try {
-      routes.push(httpServer.register({
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/state',
         handler: async (req, res) => {
@@ -627,8 +659,8 @@ export function apply(ctx) {
             watchers: watchers.map((w) => ({ ...w, goal: goalView(ctx, w.sessionId) })),
           }))
         },
-      }))
-      routes.push(httpServer.register({
+      })
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/client-note',
         handler: (req, res) => {
@@ -640,12 +672,12 @@ export function apply(ctx) {
           }
           res.statusCode = 204; res.end()
         },
-      }))
-      routes.push(httpServer.register({
+      })
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/client-error',
         handler: (req, res) => { record('error', String(req.url).slice(0, 400)); res.statusCode = 204; res.end() },
-      }))
+      })
       const readBody = (req) => new Promise((resolve) => {
         const chunks = []
         req.on('data', (chunk) => chunks.push(chunk))
@@ -666,7 +698,7 @@ export function apply(ctx) {
 
       // Create or update a watcher from the panel. The panel is session-scoped,
       // so it must send the session id it is bound to.
-      routes.push(httpServer.register({
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/watch',
         handler: async (req, res) => {
@@ -747,11 +779,11 @@ export function apply(ctx) {
           }
           json(res, 200, { ok: true, id, repo, intervalSec, enabled: entry.enabled })
         },
-      }))
+      })
 
       // Credentials typed by the operator. Stored 0600 under the state dir and
       // never echoed back; the answer carries only a masked summary.
-      routes.push(httpServer.register({
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/credentials',
         handler: async (req, res) => {
@@ -775,12 +807,12 @@ export function apply(ctx) {
           writeSecrets(next)
           json(res, 200, { credentials: secretsSummary() })
         },
-      }))
+      })
 
       // Set / edit / clear the session's REAL goal through ctx.goals — the same
       // service the /goal command drives, so the panel and the conversation are
       // one source of truth (polling reads it back).
-      routes.push(httpServer.register({
+      addRoute({
         kind: 'exact',
         path: '/session-superagent/goal',
         handler: async (req, res) => {
@@ -812,23 +844,29 @@ export function apply(ctx) {
             return json(res, 400, { error: String((error && error.message) || error) })
           }
         },
-      }))
+      })
 
       const state = readState()
-      state.server = { at: new Date().toISOString(), routes: routes.length }
+      state.server = { at: new Date().toISOString(), routes: routes.length, failed: failedRoutes }
       writeState(state)
     } catch (error) {
       const state = readState()
-      state.server = { at: new Date().toISOString(), error: String((error && error.message) || error).slice(0, 300) }
+      state.server = { at: new Date().toISOString(), routes: routes.length, failed: failedRoutes, error: String((error && error.message) || error).slice(0, 300) }
       writeState(state)
     }
-    ctx.on('dispose', () => {
+    const teardown = () => {
       for (const dispose of routes) { try { dispose() } catch {} }
+      routes.length = 0
       // 插件卸载/热重载后旧定时器不能继续跑：它们还持有已 dispose 的 ctx
       for (const handle of timers.values()) { try { clearInterval(handle) } catch {} }
       timers.clear()
       try { clearInterval(sweepHandle) } catch {}
-    })
+    }
+    // 两条路都挂上：ctx.effect 的清理函数在 effect 作用域销毁时一定被调用；
+    // ctx.on('dispose') 覆盖宿主走事件广播的卸载方式。真机踩过「路由没 dispose →
+    // 重载后重复路由 → 六条接口全灭」，多挂一条成本很低。
+    try { ctx.effect(() => teardown) } catch {}
+    ctx.on('dispose', teardown)
   }
 
   // Routes for the panel. `webServer` is the host's route registry (the same
@@ -1018,10 +1056,22 @@ 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
+      const toolAgents = agentsService(ctx)
+      const agent = toolAgents && typeof toolAgents.currentInitiator === 'function' ? toolAgents.currentInitiator() : undefined
       const sessionId = agent && agent.id
       if (!sessionId) return '[error: no live session — watch_start must be called from a session turn]'
 
@@ -1044,14 +1094,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 +1146,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')
     },
   }))
@@ -1081,7 +1174,8 @@ export function apply(ctx) {
     description: 'Stop watching a repository for the current session.',
     parameters: { repo: { type: 'string', required: true, description: 'owner/name' } },
     async execute(args) {
-      const agent = ctx.agents && typeof ctx.agents.currentInitiator === 'function' ? ctx.agents.currentInitiator() : undefined
+      const toolAgents = agentsService(ctx)
+      const agent = toolAgents && typeof toolAgents.currentInitiator === 'function' ? toolAgents.currentInitiator() : undefined
       const sessionId = agent && agent.id
       const id = `${args.repo}#${sessionId}`
       const state = readState()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-superagent",
-  "version": "0.8.16",
+  "version": "0.8.27",
   "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",
@@ -18,10 +18,9 @@
     "CHANGELOG.md",
     "LICENSE",
     "client.js",
-    "scripts/preview-orbit.mjs",
-    "scripts/port-official-ui.mjs",
-    "scripts/sync-profile.mjs",
-    "scripts/render-preview.mjs"
+    "UPDATING.md",
+    "CHECKLIST.md",
+    "MAINTENANCE.md"
   ],
   "engines": {
     "node": ">=22.19.0",
@@ -35,7 +34,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')