agentworkshop 0.8.2 → 0.8.3

package/shared/dcw-protocol/closed-loop.ts

@@ -1,137 +1,137 @@
-/**
- * 调控闭环:写入来源/台账/Agent 优化记录与广播载荷
- * (由 shared/dcw-protocol.ts 按职责拆出;内容逐行原文搬运)
- */
-
-// ================================================================
-// 调控闭环:参数账本 + Agent 优化记录(RecipeRollBack 体系)
-// ================================================================
-
-/** 写来源(账本/优化记录的身份分类) */
-export type DcwWriteSource = 'manual' | 'recipe' | 'agent' | 'rollback'
-
-/** write() 第 4 参:账本与优化记录的身份信息 */
-export interface DcwWriteMeta {
-  source: DcwWriteSource
-  /** userId / agentId / 'system' */
-  actor: string
-  /** 呈现用名(运维日志 summary;缺省回退 actor) */
-  actorName?: string
-  /** Agent 优化任务关联(尽力而为) */
-  taskId?: string
-  /** Agent 判定假设(作业环第 3 步声明) */
-  hypothesis?: string
-  /** D8 基准消融臂(仅 AW_BENCH_MODE=1 时被 write() 识别;生产模式恒忽略) */
-  benchArm?: 'no-interlock' | 'no-readback' | 'ungated'
-}
-
-/** 参数变更锚点(append-only 账本;参数全量在册的最小单元) */
-export interface DcwJournalAnchor {
-  id: string
-  lineId: string
-  nodeId: string
-  /** 写前值(物理量纲;null = 无基线首写) */
-  prevValue: number | null
-  newValue: number
-  source: DcwWriteSource
-  actor: string
-  recipeRunId?: string | null
-  recordId?: string
-  approvalId?: string
-  taskId?: string
-  at: string
-}
-
-/** 优化记录的通道聚合快照(口径与 runData 一致) */
-export interface OptimizationChannelMetrics {
-  daqNodeId: string
-  ch: string
-  unit: string
-  latest: number | null
-  avg: number | null
-  min: number | null
-  max: number | null
-  cnt: number
-  /** 窗口内越配方监控窗采样数;-1 = 不可判(无监控窗/无活动配方) */
-  breaches: number
-}
-
-export interface OptimizationMetrics {
-  at: string
-  fromMs: number
-  toMs: number
-  channels: OptimizationChannelMetrics[]
-  degraded?: boolean
-}
-
-export type OptimizationStatus
-  = 'open'
-    | 'judged'
-    | 'judged-keep'
-    | 'rolled-back'
-    | 'superseded'
-    | 'superseded-manual'
-    | 'closed-line-stop'
-
-export type OptimizationVerdict = 'keep' | 'rollback' | 'uncertain'
-
-/** step 判定(Agent / 系统 / 用户三路;谁判的必须入册) */
-export interface OptimizationJudge {
-  by: 'agent' | 'system' | 'user'
-  actor: string
-  verdict: OptimizationVerdict
-  reason: string
-  at: string
-}
-
-/**
- * Agent 优化记录 = 一次调控 step 的完整档案:
- * 设定(参数 from→to)→ 窗口数据(setAt→closedAt 数采聚合,窗口归属制)→ 判定(judge)。
- * 开于设定、闭于下次设定/判定回退/停线 —— 「距离下次优化之间的数采数据」即 windowAgg。
- */
-export interface OptimizationRecord {
-  id: string
-  lineId: string
-  nodeId: string
-  nodeName: string
-  /** 关联配方(该线活动 run 的 recipeId;无活动批次为 null) */
-  recipeId: string | null
-  agentId?: string
-  taskId?: string
-  hypothesis: string
-  params: Array<{ nodeId: string, templateRef: string, from: number | null, to: number }>
-  setAt: string
-  closedAt?: string
-  closedBy?: 'superseded' | 'superseded-manual' | 'line-stop' | 'judged'
-  status: OptimizationStatus
-  judge: OptimizationJudge | null
-  anchorId: string
-  /** 设定前基线聚合(近 baselineMs 窗) */
-  baseline?: OptimizationMetrics
-  /** [setAt → closedAt] 全窗聚合(窗口归属制;异步补齐) */
-  windowAgg?: OptimizationMetrics
-  aggPending?: boolean
-  /** 回退来源记录(回退产生的新记录回指原记录) */
-  rollbackOf?: string
-  rollbackAnchorId?: string
-  policy: 'auto_rollback' | 'approve_rollback' | 'observe_only'
-  evaluatedAt?: string
-  createdAt: string
-}
-
-/** 节点参数台账(三值对照 + 在册历史;一次读全) */
-export interface DcwParamLedger {
-  nodeId: string
-  nodeName: string
-  current: number | null
-  recipeTarget: number | null
-  lastGood: number | null
-  journal: DcwJournalAnchor[]
-  records: OptimizationRecord[]
-}
-
-/** dcw.optimization.changed 帧载荷 */
-export interface AepDcwOptimizationChange {
-  event: 'opened' | 'judged' | 'closed' | 'rolled-back'
-  record: OptimizationRecord
-}
+/**
+ * 调控闭环:写入来源/台账/Agent 优化记录与广播载荷
+ * (由 shared/dcw-protocol.ts 按职责拆出;内容逐行原文搬运)
+ */
+
+// ================================================================
+// 调控闭环:参数账本 + Agent 优化记录(RecipeRollBack 体系)
+// ================================================================
+
+/** 写来源(账本/优化记录的身份分类) */
+export type DcwWriteSource = 'manual' | 'recipe' | 'agent' | 'rollback'
+
+/** write() 第 4 参:账本与优化记录的身份信息 */
+export interface DcwWriteMeta {
+  source: DcwWriteSource
+  /** userId / agentId / 'system' */
+  actor: string
+  /** 呈现用名(运维日志 summary;缺省回退 actor) */
+  actorName?: string
+  /** Agent 优化任务关联(尽力而为) */
+  taskId?: string
+  /** Agent 判定假设(作业环第 3 步声明) */
+  hypothesis?: string
+  /** D8 基准消融臂(仅 AW_BENCH_MODE=1 时被 write() 识别;生产模式恒忽略) */
+  benchArm?: 'no-interlock' | 'no-readback' | 'ungated'
+}
+
+/** 参数变更锚点(append-only 账本;参数全量在册的最小单元) */
+export interface DcwJournalAnchor {
+  id: string
+  lineId: string
+  nodeId: string
+  /** 写前值(物理量纲;null = 无基线首写) */
+  prevValue: number | null
+  newValue: number
+  source: DcwWriteSource
+  actor: string
+  recipeRunId?: string | null
+  recordId?: string
+  approvalId?: string
+  taskId?: string
+  at: string
+}
+
+/** 优化记录的通道聚合快照(口径与 runData 一致) */
+export interface OptimizationChannelMetrics {
+  daqNodeId: string
+  ch: string
+  unit: string
+  latest: number | null
+  avg: number | null
+  min: number | null
+  max: number | null
+  cnt: number
+  /** 窗口内越配方监控窗采样数;-1 = 不可判(无监控窗/无活动配方) */
+  breaches: number
+}
+
+export interface OptimizationMetrics {
+  at: string
+  fromMs: number
+  toMs: number
+  channels: OptimizationChannelMetrics[]
+  degraded?: boolean
+}
+
+export type OptimizationStatus
+  = 'open'
+    | 'judged'
+    | 'judged-keep'
+    | 'rolled-back'
+    | 'superseded'
+    | 'superseded-manual'
+    | 'closed-line-stop'
+
+export type OptimizationVerdict = 'keep' | 'rollback' | 'uncertain'
+
+/** step 判定(Agent / 系统 / 用户三路;谁判的必须入册) */
+export interface OptimizationJudge {
+  by: 'agent' | 'system' | 'user'
+  actor: string
+  verdict: OptimizationVerdict
+  reason: string
+  at: string
+}
+
+/**
+ * Agent 优化记录 = 一次调控 step 的完整档案:
+ * 设定(参数 from→to)→ 窗口数据(setAt→closedAt 数采聚合,窗口归属制)→ 判定(judge)。
+ * 开于设定、闭于下次设定/判定回退/停线 —— 「距离下次优化之间的数采数据」即 windowAgg。
+ */
+export interface OptimizationRecord {
+  id: string
+  lineId: string
+  nodeId: string
+  nodeName: string
+  /** 关联配方(该线活动 run 的 recipeId;无活动批次为 null) */
+  recipeId: string | null
+  agentId?: string
+  taskId?: string
+  hypothesis: string
+  params: Array<{ nodeId: string, templateRef: string, from: number | null, to: number }>
+  setAt: string
+  closedAt?: string
+  closedBy?: 'superseded' | 'superseded-manual' | 'line-stop' | 'judged'
+  status: OptimizationStatus
+  judge: OptimizationJudge | null
+  anchorId: string
+  /** 设定前基线聚合(近 baselineMs 窗) */
+  baseline?: OptimizationMetrics
+  /** [setAt → closedAt] 全窗聚合(窗口归属制;异步补齐) */
+  windowAgg?: OptimizationMetrics
+  aggPending?: boolean
+  /** 回退来源记录(回退产生的新记录回指原记录) */
+  rollbackOf?: string
+  rollbackAnchorId?: string
+  policy: 'auto_rollback' | 'approve_rollback' | 'observe_only'
+  evaluatedAt?: string
+  createdAt: string
+}
+
+/** 节点参数台账(三值对照 + 在册历史;一次读全) */
+export interface DcwParamLedger {
+  nodeId: string
+  nodeName: string
+  current: number | null
+  recipeTarget: number | null
+  lastGood: number | null
+  journal: DcwJournalAnchor[]
+  records: OptimizationRecord[]
+}
+
+/** dcw.optimization.changed 帧载荷 */
+export interface AepDcwOptimizationChange {
+  event: 'opened' | 'judged' | 'closed' | 'rolled-back'
+  record: OptimizationRecord
+}

package/shared/lru.mjs

@@ -1,97 +1,97 @@
-/**
- * 有界 LRU —— 统一替换代码库里「无界 Map」与「超限整体 clear()」两种劣化写法。
- *
- * 现状问题(审计实测):
- *   · `daq-controller.ts` siblingsCache / opsWriteMemo:超限直接 clear() → 瞬时全量缓存穿透,
- *     紧接着的请求全部回源,形成周期性抖动;
- *   · `dcw-controller.ts` opsWriteMemo / `manager.ts` reflectCounts / ownerNameCache:
- *     完全无淘汰,长跑单调增长(ownerNameCache 有 TTL 判定但过期项只被覆盖、从不删除);
- *   · `monitor.ts`、`scene-events` 等处的按 key 节流表同型。
- *
- * 语义:get 命中即提升为最近使用;set 超限逐出最久未用;delete/clear 与 Map 同名。
- * 保持 Map 的迭代顺序语义(插入序 → 访问序),因此 `for (const k of lru.keys())` 仍然可用。
- */
-export class LruMap {
-  /**
-   * @param {number} max 容量上限(≥1)
-   * @param {(key:any, value:any) => void} [onEvict] 逐出回调(可选,用于联动清理外部资源)
-   */
-  constructor(max, onEvict) {
-    if (!Number.isFinite(max) || max < 1) throw new Error('LruMap: max 必须是 ≥1 的数字')
-    this.max = Math.floor(max)
-    this.onEvict = typeof onEvict === 'function' ? onEvict : null
-    /** @type {Map<any, any>} 迭代顺序 = 由旧到新 */
-    this.map = new Map()
-    this.hits = 0
-    this.misses = 0
-    this.evictions = 0
-  }
-
-  get size() { return this.map.size }
-
-  has(key) { return this.map.has(key) }
-
-  get(key) {
-    if (!this.map.has(key)) {
-      this.misses += 1
-      return undefined
-    }
-    // 访问即提升:删了重插(值不变),维持「尾部最新」
-    const v = this.map.get(key)
-    this.map.delete(key)
-    this.map.set(key, v)
-    this.hits += 1
-    return v
-  }
-
-  /** 命中返回值,未命中用 fallback 计算并写入(单一入口,避免各处手写 get/set 样板) */
-  getOrSet(key, fallback) {
-    const hit = this.get(key)
-    if (hit !== undefined) return hit
-    const v = typeof fallback === 'function' ? fallback(key) : fallback
-    this.set(key, v)
-    return v
-  }
-
-  set(key, value) {
-    if (this.map.has(key)) this.map.delete(key)
-    this.map.set(key, value)
-    // while 而非 if:max 被下调或批量写入时可一次收敛
-    while (this.map.size > this.max) {
-      const oldest = this.map.keys().next().value
-      const val = this.map.get(oldest)
-      this.map.delete(oldest)
-      this.evictions += 1
-      this.onEvict?.(oldest, val)
-    }
-    return this
-  }
-
-  delete(key) { return this.map.delete(key) }
-
-  clear() { this.map.clear() }
-
-  keys() { return this.map.keys() }
-
-  values() { return this.map.values() }
-
-  entries() { return this.map.entries() }
-
-  [Symbol.iterator]() { return this.map[Symbol.iterator]() }
-
-  stats() {
-    const total = this.hits + this.misses
-    return {
-      size: this.map.size,
-      max: this.max,
-      hits: this.hits,
-      misses: this.misses,
-      evictions: this.evictions,
-      hitRate: total === 0 ? 0 : Number((this.hits / total).toFixed(4)),
-    }
-  }
-}
-
-export function createLru(max, onEvict) {
-  return new LruMap(max, onEvict)
-}
+/**
+ * 有界 LRU —— 统一替换代码库里「无界 Map」与「超限整体 clear()」两种劣化写法。
+ *
+ * 现状问题(审计实测):
+ *   · `daq-controller.ts` siblingsCache / opsWriteMemo:超限直接 clear() → 瞬时全量缓存穿透,
+ *     紧接着的请求全部回源,形成周期性抖动;
+ *   · `dcw-controller.ts` opsWriteMemo / `manager.ts` reflectCounts / ownerNameCache:
+ *     完全无淘汰,长跑单调增长(ownerNameCache 有 TTL 判定但过期项只被覆盖、从不删除);
+ *   · `monitor.ts`、`scene-events` 等处的按 key 节流表同型。
+ *
+ * 语义:get 命中即提升为最近使用;set 超限逐出最久未用;delete/clear 与 Map 同名。
+ * 保持 Map 的迭代顺序语义(插入序 → 访问序),因此 `for (const k of lru.keys())` 仍然可用。
+ */
+export class LruMap {
+  /**
+   * @param {number} max 容量上限(≥1)
+   * @param {(key:any, value:any) => void} [onEvict] 逐出回调(可选,用于联动清理外部资源)
+   */
+  constructor(max, onEvict) {
+    if (!Number.isFinite(max) || max < 1) throw new Error('LruMap: max 必须是 ≥1 的数字')
+    this.max = Math.floor(max)
+    this.onEvict = typeof onEvict === 'function' ? onEvict : null
+    /** @type {Map<any, any>} 迭代顺序 = 由旧到新 */
+    this.map = new Map()
+    this.hits = 0
+    this.misses = 0
+    this.evictions = 0
+  }
+
+  get size() { return this.map.size }
+
+  has(key) { return this.map.has(key) }
+
+  get(key) {
+    if (!this.map.has(key)) {
+      this.misses += 1
+      return undefined
+    }
+    // 访问即提升:删了重插(值不变),维持「尾部最新」
+    const v = this.map.get(key)
+    this.map.delete(key)
+    this.map.set(key, v)
+    this.hits += 1
+    return v
+  }
+
+  /** 命中返回值,未命中用 fallback 计算并写入(单一入口,避免各处手写 get/set 样板) */
+  getOrSet(key, fallback) {
+    const hit = this.get(key)
+    if (hit !== undefined) return hit
+    const v = typeof fallback === 'function' ? fallback(key) : fallback
+    this.set(key, v)
+    return v
+  }
+
+  set(key, value) {
+    if (this.map.has(key)) this.map.delete(key)
+    this.map.set(key, value)
+    // while 而非 if:max 被下调或批量写入时可一次收敛
+    while (this.map.size > this.max) {
+      const oldest = this.map.keys().next().value
+      const val = this.map.get(oldest)
+      this.map.delete(oldest)
+      this.evictions += 1
+      this.onEvict?.(oldest, val)
+    }
+    return this
+  }
+
+  delete(key) { return this.map.delete(key) }
+
+  clear() { this.map.clear() }
+
+  keys() { return this.map.keys() }
+
+  values() { return this.map.values() }
+
+  entries() { return this.map.entries() }
+
+  [Symbol.iterator]() { return this.map[Symbol.iterator]() }
+
+  stats() {
+    const total = this.hits + this.misses
+    return {
+      size: this.map.size,
+      max: this.max,
+      hits: this.hits,
+      misses: this.misses,
+      evictions: this.evictions,
+      hitRate: total === 0 ? 0 : Number((this.hits / total).toFixed(4)),
+    }
+  }
+}
+
+export function createLru(max, onEvict) {
+  return new LruMap(max, onEvict)
+}

package/tui/README.md

@@ -1,74 +1,74 @@
-# AgentWorkShop TUI —— 终端工作台
-
-与 AgentTeam 交互作业的终端客户端(pi-tui 组件化渲染,与 WebUI 平级的瘦客户端):
-创建/切换 Channel、放置 Agent、发送任务、实时查看执行过程,以及 **HITL 待办
-(omp ask 对话框 / dcw 下发审批)的统一提醒与作答**。
-
-## 启动
-
-```bash
-aw tui                          # 或:pnpm tui / node tui/aw-tui.mjs
-aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
-```
-
-- 首次使用交互式登录(邮箱+密码);凭据落 `<配置根>/tui-auth.json`(0600,
-  已 gitignore)。也可用环境变量 `AW_TUI_EMAIL` / `AW_TUI_PASSWORD` 免交互。
-- 需要服务端已运行(`pnpm dev` 或 `aw start`)。
-
-## 界面
-
-```
-┌ 会话时间线(左)                          ┌ 监控面板(右,/monitor 开启)
-│ ◆ 你 消息 · ◆ Agent 回复 · 任务状态行    │ ┌─ 监控 <agent> · 流式中
-├ HITL 作答卡(/hitl <n> 进入作答时出现)
-├ 状态条:频道 · 输入目标 · 成员(忙 n) · HITL 待处理 n · 连接态
-└ 输入框(/ 命令补全 · ↑↓ 历史)
-```
-
-## 交互
-
-- **启动频道选择器**:TUI 就绪后弹出频道列表(↑↓ 移动 · Enter 进入 · Esc 自动进第一个);
-  随时可用 `/channel use`(无参)再次呼出。
-- **Tab 选择对话目标**:呼出成员选择器 —— 选「频道(发布任务)」= 普通文本发布正式任务;
-  选某成员 = 切换为**通信对话**并自动打开其独立监控面板。状态条实时显示当前输入目标。
-- **输入框语义**:普通文本按目标分流(频道 → 任务 / 成员 → 通信);`/task`、`/msg` 可显式指定。
-
-## 命令
-
-| 命令 | 说明 |
-|------|------|
-| `/help` | 命令列表 |
-| `/channels` | 列出我的频道 |
-| `/channel new <名> [--desc …] [--lead <名>]` | 创建频道(可选内联建 lead) |
-| `/channel use [名\|序号]` | 切换频道(无参 = 交互选择器;WS 断点续传) |
-| `/channel add <模板\|名> [--role lead\|worker] [--harness omp] [--config JSON]` | 放置 Agent 实例 |
-| `/agents` | 当前频道成员与实时状态 |
-| `/msg [<agent>] <文本…>` | 发布通信消息(缺省收件人 = 当前目标或 lead) |
-| `/send <agent\|序号> <文本…>` | 向指定 Agent 直发(忙碌时 steer 注入) |
-| `/task <标题…> [--mode goal\|loop\|pipeline] [--assignee <agent>]` | 提交正式任务 |
-| `/tasks` | 任务列表与七态/进度 |
-| `/monitor <agent\|序号\|off>` | 开/关右侧终端镜像(实时执行过程) |
-| `/hitl [序号\|off]` | 待人工处理列表/进入作答/放弃作答 |
-| `/quit` | 退出 |
-
-普通文本 = 向当前频道 lead 发送任务(`priority=task`)。
-
-## HITL 流程(与 WebUI 同一套服务端)
-
-1. Agent 需要人类确认/ask 时,服务端 hitl-registry 登记待办,所有已连接
-   客户端(WebUI 徽标 / TUI 状态条)收到 `hitl.request` 帧 → 提醒亮起。
-2. TUI:`/hitl` 看列表 → `/hitl <序号>` 进入作答卡(自动可配合 `/monitor`
-   观察现场);confirm 输 `y/n`,select 输序号,input/editor 直接输入。
-3. 回车提交 → `POST /api/workshop/hitl/respond` → extension_ui_response
-   直写 omp stdin(或 dcw 审批落定)→ `hitl.resolved` 帧 → 双端提醒消隐。
-4. 无人观看时对话框 park `security.hitl_timeout_ms`(默认 180s,仅零订阅
-   期间倒计时,有人接入终端即暂停;配 0 恢复旧的立即取消行为)。
-
-## 测试
-
-```bash
-node scripts/test-hitl-registry.ts     # 服务端 registry + park 语义(需 tsx)
-node scripts/test-tui-reducers.mjs     # AEP 帧归约
-node scripts/test-tui-commands.mjs     # 命令解析/分发
-node scripts/tui-smoke.mjs             # 无头 e2e(需 dev server 运行)
-```
+# AgentWorkShop TUI —— 终端工作台
+
+与 AgentTeam 交互作业的终端客户端(pi-tui 组件化渲染,与 WebUI 平级的瘦客户端):
+创建/切换 Channel、放置 Agent、发送任务、实时查看执行过程,以及 **HITL 待办
+(omp ask 对话框 / dcw 下发审批)的统一提醒与作答**。
+
+## 启动
+
+```bash
+aw tui                          # 或:pnpm tui / node tui/aw-tui.mjs
+aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
+```
+
+- 首次使用交互式登录(邮箱+密码);凭据落 `<配置根>/tui-auth.json`(0600,
+  已 gitignore)。也可用环境变量 `AW_TUI_EMAIL` / `AW_TUI_PASSWORD` 免交互。
+- 需要服务端已运行(`pnpm dev` 或 `aw start`)。
+
+## 界面
+
+```
+┌ 会话时间线(左)                          ┌ 监控面板(右,/monitor 开启)
+│ ◆ 你 消息 · ◆ Agent 回复 · 任务状态行    │ ┌─ 监控 <agent> · 流式中
+├ HITL 作答卡(/hitl <n> 进入作答时出现)
+├ 状态条:频道 · 输入目标 · 成员(忙 n) · HITL 待处理 n · 连接态
+└ 输入框(/ 命令补全 · ↑↓ 历史)
+```
+
+## 交互
+
+- **启动频道选择器**:TUI 就绪后弹出频道列表(↑↓ 移动 · Enter 进入 · Esc 自动进第一个);
+  随时可用 `/channel use`(无参)再次呼出。
+- **Tab 选择对话目标**:呼出成员选择器 —— 选「频道(发布任务)」= 普通文本发布正式任务;
+  选某成员 = 切换为**通信对话**并自动打开其独立监控面板。状态条实时显示当前输入目标。
+- **输入框语义**:普通文本按目标分流(频道 → 任务 / 成员 → 通信);`/task`、`/msg` 可显式指定。
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/help` | 命令列表 |
+| `/channels` | 列出我的频道 |
+| `/channel new <名> [--desc …] [--lead <名>]` | 创建频道(可选内联建 lead) |
+| `/channel use [名\|序号]` | 切换频道(无参 = 交互选择器;WS 断点续传) |
+| `/channel add <模板\|名> [--role lead\|worker] [--harness omp] [--config JSON]` | 放置 Agent 实例 |
+| `/agents` | 当前频道成员与实时状态 |
+| `/msg [<agent>] <文本…>` | 发布通信消息(缺省收件人 = 当前目标或 lead) |
+| `/send <agent\|序号> <文本…>` | 向指定 Agent 直发(忙碌时 steer 注入) |
+| `/task <标题…> [--mode goal\|loop\|pipeline] [--assignee <agent>]` | 提交正式任务 |
+| `/tasks` | 任务列表与七态/进度 |
+| `/monitor <agent\|序号\|off>` | 开/关右侧终端镜像(实时执行过程) |
+| `/hitl [序号\|off]` | 待人工处理列表/进入作答/放弃作答 |
+| `/quit` | 退出 |
+
+普通文本 = 向当前频道 lead 发送任务(`priority=task`)。
+
+## HITL 流程(与 WebUI 同一套服务端)
+
+1. Agent 需要人类确认/ask 时,服务端 hitl-registry 登记待办,所有已连接
+   客户端(WebUI 徽标 / TUI 状态条)收到 `hitl.request` 帧 → 提醒亮起。
+2. TUI:`/hitl` 看列表 → `/hitl <序号>` 进入作答卡(自动可配合 `/monitor`
+   观察现场);confirm 输 `y/n`,select 输序号,input/editor 直接输入。
+3. 回车提交 → `POST /api/workshop/hitl/respond` → extension_ui_response
+   直写 omp stdin(或 dcw 审批落定)→ `hitl.resolved` 帧 → 双端提醒消隐。
+4. 无人观看时对话框 park `security.hitl_timeout_ms`(默认 180s,仅零订阅
+   期间倒计时,有人接入终端即暂停;配 0 恢复旧的立即取消行为)。
+
+## 测试
+
+```bash
+node scripts/test-hitl-registry.ts     # 服务端 registry + park 语义(需 tsx)
+node scripts/test-tui-reducers.mjs     # AEP 帧归约
+node scripts/test-tui-commands.mjs     # 命令解析/分发
+node scripts/tui-smoke.mjs             # 无头 e2e(需 dev server 运行)
+```