agentworkshop 0.7.3 → 0.7.5

package/scripts/test-tui-commands.mjs

@@ -0,0 +1,148 @@
+/**
+ * TUI 命令系统单元测试(node 直跑):
+ *   node scripts/test-tui-commands.mjs
+ *
+ * 覆盖:/命令解析(参数/--flag)/未知命令兜底/分发路由/mock ctx 下的命令执行。
+ */
+import { parseCommand, dispatchCommand } from '../tui/commands/index.mjs'
+
+let failures = 0
+const check = (name, cond, extra = '') => {
+  console.log(`${cond ? '  ✓' : '  ✗ FAIL'} ${name}${extra ? ` (${extra})` : ''}`)
+  if (!cond) failures++
+}
+
+// ── 解析 ──
+console.log('[1] parseCommand')
+const p1 = parseCommand('/channel new demo --desc 测试频道 --lead 调度长')
+check('命令名解析', p1?.name === 'channel')
+check('位置参数', JSON.stringify(p1.args) === JSON.stringify(['new', 'demo']))
+check('--flag 带值', p1.flags.desc === '测试频道' && p1.flags.lead === '调度长')
+const p2 = parseCommand('/task 调高设定值 --mode loop')
+check('中文标题 + 尾随 flag', p2.args.join(' ') === '调高设定值' && p2.flags.mode === 'loop')
+const p3 = parseCommand('普通文本')
+check('非 / 前缀返回 null', p3 === null)
+const p4 = parseCommand('/hitl')
+check('裸命令', p4.name === 'hitl' && p4.args.length === 0)
+const p5 = parseCommand('/channel add 巡检员 --role lead --bool')
+check('--bool 无值 flag', p5.flags.role === 'lead' && p5.flags.bool === true)
+
+// ── 分发(mock ctx) ──
+console.log('[2] dispatchCommand')
+function mockCtx() {
+  const calls = []
+  const state = {
+    channels: [{ id: 'ch-1', name: 'prod线' }],
+    activeChannelId: 'ch-1',
+    agents: [{ id: 'agt-1', name: '调度长', role: 'lead', harness: 'omp', enabled: 1 }],
+    agentStates: {},
+    tasks: [],
+    hitl: [],
+    hitlAnswering: null,
+    target: null,
+    log: [],
+    userName: '张伟',
+  }
+  return {
+    state,
+    calls,
+    echo: (kind, text) => calls.push({ kind, text }),
+    api: {
+      listChannels: async () => state.channels,
+      createChannel: async body => ({ channelId: 'ch-new', leadAgentId: null, name: body.name }),
+      listAgents: async () => state.agents,
+      listTemplates: async () => [{ id: 'tpl-1', name: '巡检员' }],
+      addAgent: async (_id, body) => ({ id: 'inst-1', name: body.agentId ? '巡检员' : body.name, role: body.role ?? 'worker' }),
+      sendMessage: async (_id, body) => calls.push({ send: body }),
+      submitTask: async (_id, body) => {
+        calls.push({ task: body })
+        return { id: 'tk-9' }
+      },
+      listTasks: async () => [],
+      hitlPending: async () => [],
+      hitlRespond: async body => calls.push({ respond: body }),
+    },
+    actions: {
+      switchChannel: async (id) => {
+        state.activeChannelId = id
+        calls.push({ switched: id })
+      },
+      refreshAgents: async () => {},
+      openMonitor: agent => calls.push({ monitor: agent.name }),
+      closeMonitor: () => calls.push({ monitorOff: true }),
+      submitHitlAnswer: async t => calls.push({ hitlAnswer: t }),
+      quit: () => calls.push({ quit: true }),
+    },
+  }
+}
+
+let ctx = mockCtx()
+check('未知命令被兜底', await dispatchCommand(ctx, '/nope') === true && ctx.calls[0].kind === 'error')
+check('非命令放行', await dispatchCommand(ctx, '普通任务文本') === false)
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/channel new smoke线 --lead 调度长')
+check('创建频道并自动切换', ctx.state.activeChannelId === 'ch-new' && ctx.calls.some(c => c.switched === 'ch-new'))
+check('lead 内联定义传递', ctx.state.channels.some(c => c.id === 'ch-new'))
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/channel use prod线')
+check('/channel use 按名切换', ctx.state.activeChannelId === 'ch-1')
+await dispatchCommand(ctx, '/channel use 1')
+check('/channel use 按序号切换', ctx.state.activeChannelId === 'ch-1')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/channel add 巡检员 --role lead')
+check('模板克隆放置(传 agentId)', ctx.calls.some(() => true) && ctx.state.agents.length === 1)
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/send 调度长 请确认产线状态')
+const sent = ctx.calls.find(c => c.send)
+check('/send immediate 直发+requireReply', sent?.send?.priority === 'immediate' && sent?.send?.toAgentId === 'agt-1')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/send 不存在的人 你好')
+check('/send 未知成员报错', ctx.calls.some(c => c.kind === 'error'))
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/task 调高温度到182 --mode loop --assignee 调度长')
+const task = ctx.calls.find(c => c.task)
+check('/task 标题+mode+assignee', task?.task?.title === '调高温度到182' && task?.task?.mode === 'loop' && task?.task?.assigneeId === 'agt-1')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/monitor 调度长')
+check('/monitor 打开面板', ctx.calls.some(c => c.monitor === '调度长'))
+await dispatchCommand(ctx, '/monitor off')
+check('/monitor off 关闭', ctx.calls.some(c => c.monitorOff))
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/hitl 1')
+check('/hitl 序号无效报错', ctx.calls.some(c => c.kind === 'error'))
+
+ctx = mockCtx()
+ctx.state.hitl = [{ kind: 'omp-dialog', id: 'd1', method: 'confirm', title: '确认?', agentName: '调度长' }]
+await dispatchCommand(ctx, '/hitl 1')
+check('/hitl 进入作答模式', ctx.state.hitlAnswering?.id === 'd1')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/msg 心跳检查,请确认')
+const msg = ctx.calls.find(c => c.send)
+check('/msg 缺省路由 lead(immediate)', msg?.send?.toAgentId === 'agt-1' && msg?.send?.priority === 'immediate')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/msg 调度长 收到请回答')
+const msg2 = ctx.calls.find(c => c.send)
+check('/msg 指定成员', msg2?.send?.toAgentId === 'agt-1')
+
+ctx = mockCtx()
+ctx.state.target = { agentId: 'agt-1', name: '调度长' }
+await dispatchCommand(ctx, '/task 检查设备')
+const tsk = ctx.calls.find(c => c.task)
+check('/task 目标成员自动成为 assignee', tsk?.task?.assigneeId === 'agt-1')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/quit')
+check('/quit 触发退出', ctx.calls.some(c => c.quit))
+
+console.log(failures === 0 ? '\n[commands] 全部通过' : `\n[commands] ${failures} 项失败`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/test-tui-reducers.mjs

@@ -0,0 +1,72 @@
+/**
+ * TUI 归约器单元测试(node 直跑,无服务依赖):
+ *   node scripts/test-tui-reducers.mjs
+ *
+ * 覆盖 AEP 帧 → 会话状态:delta 聚合定稿去重/消息归属/task 状态/hitl 增删/
+ * 跨频道标记/终端帧归约(monitor 行)。
+ */
+import { createState, withLog } from '../tui/lib/state.mjs'
+import { reduceEnvelope, reduceTermFrame } from '../tui/lib/reducers.mjs'
+
+let failures = 0
+const check = (name, cond, extra = '') => {
+  console.log(`${cond ? '  ✓' : '  ✗ FAIL'} ${name}${extra ? ` (${extra})` : ''}`)
+  if (!cond) failures++
+}
+
+function fresh() {
+  const store = createState()
+  const state = withLog(store.state)
+  state.agents = [{ id: 'agt-1', name: '调度长', role: 'lead', harness: 'omp', enabled: 1 }]
+  return { store, state }
+}
+
+const env = (type, payload, extra = {}) => ({ v: 1, type, seq: 1, at: '', channelId: 'ch-1', ...extra, payload })
+
+// ── agent.delta 聚合 + agent.message 定稿 ──
+console.log('[1] 流式聚合')
+let { state } = fresh()
+reduceEnvelope(state, env('agent.delta', { delta: '你' }, { agentId: 'agt-1', taskId: 't1' }))
+reduceEnvelope(state, env('agent.delta', { delta: '好' }, { agentId: 'agt-1', taskId: 't1' }))
+check('delta 聚合进同一流式块', state.log.filter(r => r.kind === 'stream').length === 1 && state.log.at(-1).text === '你好')
+reduceEnvelope(state, env('agent.delta', { delta: '!' }, { agentId: 'agt-2', taskId: 't1' }))
+check('不同 agent 不粘连(独立块)', state.log.filter(r => r.kind === 'stream').length === 2)
+reduceEnvelope(state, env('agent.message', { parts: [{ text: '你好,完整消息' }], metadata: {} }, { agentId: 'agt-1', taskId: 't1' }))
+check('message 定稿升级为 agent 行', state.log.filter(r => r.kind === 'agent').length === 1 && state.log.filter(r => r.kind === 'stream').length === 1)
+check('定稿文本为全文', state.log.find(r => r.kind === 'agent' && r.agentId === 'agt-1').text === '你好,完整消息')
+
+// ── a2a.message:人类回显/跨频道 ──
+console.log('[2] 消息投递')
+;({ state } = fresh())
+reduceEnvelope(state, env('a2a.message', { parts: [{ text: '帮我查产线状态' }], metadata: { 'x-aw-from-label': '张伟' } }))
+check('人类消息渲染 user 行', state.log.at(-1).kind === 'user' && state.log.at(-1).text.includes('产线状态'))
+reduceEnvelope(state, env('a2a.message', { parts: [{ text: '外部指令' }], metadata: { 'x-aw-cross-channel': 'true', 'x-aw-from-label': '母舰' } }))
+check('跨频道消息带标记', state.log.at(-1).text.startsWith('[跨频道]'))
+
+// ── task/hitl ──
+console.log('[3] 任务与 HITL')
+;({ state } = fresh())
+reduceEnvelope(state, env('task.status', { taskId: 'tk-1', state: 'WORKING', title: '调参', progress: 30 }))
+check('task.status 入列表且渲染任务行', state.tasks.length === 1 && state.log.at(-1).kind === 'task')
+reduceEnvelope(state, env('task.progress', { taskId: 'tk-1', progress: 80 }))
+check('task.progress 更新同条', state.tasks[0].progress === 80)
+reduceEnvelope(state, env('hitl.request', { kind: 'omp-dialog', id: 'd1', channelId: 'ch-1', agentId: 'agt-1', agentName: '调度长', method: 'confirm', title: '确认下发?' }))
+check('hitl.request 入待办并渲染提醒行', state.hitl.length === 1 && state.log.at(-1).kind === 'hitl')
+reduceEnvelope(state, env('hitl.request', { kind: 'omp-dialog', id: 'd1', channelId: 'ch-1', agentId: 'agt-1', agentName: '调度长', method: 'confirm', title: '确认下发?(更新)' }))
+check('hitl 幂等 upsert', state.hitl.length === 1 && state.hitl[0].title.includes('更新'))
+reduceEnvelope(state, env('hitl.resolved', { kind: 'omp-dialog', id: 'd1', channelId: 'ch-1', agentId: 'agt-1', outcome: 'answered' }))
+check('hitl.resolved 清空待办', state.hitl.length === 0 && state.log.at(-1).kind === 'hitl-resolved')
+
+// ── 终端帧归约 ──
+console.log('[4] 终端帧(monitor 行)')
+const r1 = reduceTermFrame({ type: 'tool_execution_start', toolName: 'dcw_control', args: { node_id: 'n1', value: 182 } })
+check('工具开始帧 → info 行', r1.lines.length === 1 && r1.lines[0].tone === 'info')
+const r2 = reduceTermFrame({ type: 'extension_ui_request', method: 'select', title: '选择方案' })
+check('HITL 帧 → warn 行', r2.lines[0].tone === 'warn' && r2.lines[0].text.includes('/hitl'))
+const r3 = reduceTermFrame({ type: 'extension_ui_request', method: 'cancel', targetId: 'x' })
+check('cancel 帧不产生行', r3.lines.length === 0)
+const r4 = reduceTermFrame({ type: '__terminal_notice', level: 'warning', message: '观看者离开' })
+check('notice 帧 → warn 行', r4.lines[0].tone === 'warn')
+
+console.log(failures === 0 ? '\n[reducers] 全部通过' : `\n[reducers] ${failures} 项失败`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  // tsx 直跑 scripts/*.ts 的解析配置(nuxt 根 tsconfig 是 references 组合,无 paths)。
+  // 用法:npx tsx --tsconfig scripts/tsconfig.json scripts/<test>.ts
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "baseUrl": "..",
+    "paths": {
+      "@/*": ["*"]
+    }
+  }
+}

package/scripts/tui-smoke.mjs

@@ -0,0 +1,100 @@
+/**
+ * TUI 无头 e2e(虚拟终端驱动真实 TUI ↔ 真实 dev server):
+ *   node scripts/tui-smoke.mjs [--base http://127.0.0.1:3000]
+ *
+ * 覆盖:认证引导(--token)→ 频道自动接入 → /channels → /channel new(创建+切换)
+ * → /agents → 普通文本发送(服务端回显) → /hitl → 清理 → /quit。
+ * 建的 tui-smoke-* 频道在退出前清理(?purge=1 级联删除)。
+ */
+import { createApi } from '../tui/lib/api.mjs'
+
+const base = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+
+// 种子 admin(dev 环境默认);生产勿用
+const api = createApi({ baseUrl: base })
+const login = await api.login(process.env.AW_TUI_EMAIL ?? 'zhangwei@awshop.io', process.env.AW_TUI_PASSWORD ?? 'Awshop@123')
+const token = login.token
+
+let failures = 0
+const check = (name, cond) => {
+  console.log(`${cond ? '  ✓' : '  ✗ FAIL'} ${name}`)
+  if (!cond) failures++
+}
+
+// ── 启动 TUI(headless;--token 免交互;--channel 空 = 自动选第一个频道) ──
+const { main } = await import('../tui/aw-tui.mjs')
+await main(['--headless', '--url', base, '--token', token, '--channel', ''])
+const vt = globalThis.__tuiSmokeTerminal
+check('虚拟终端句柄就绪', Boolean(vt))
+
+const waitText = async (needle, timeoutMs = 8000) => {
+  const t0 = Date.now()
+  while (Date.now() - t0 < timeoutMs) {
+    if (vt.text().includes(needle)) return true
+    await new Promise(r => setTimeout(r, 100))
+  }
+  return false
+}
+const type = async (text) => {
+  for (const ch of text) vt.emitInput(ch)
+  await new Promise(r => setTimeout(r, 40))
+  vt.emitInput('\r')
+  await new Promise(r => setTimeout(r, 500))
+}
+
+check('TUI 启动就绪横幅', await waitText('TUI 已就绪'))
+// 启动频道选择器(新交互):有频道 → Esc 自动进第一个;空账户 → 提示创建
+if (await waitText('选择要进入的频道', 8000)) {
+  vt.emitInput('\x1b')
+  check('启动自动接入首个频道', await waitText('已切换到频道「', 12_000))
+}
+else {
+  check('空账户提示创建频道', await waitText('尚无频道', 12_000))
+}
+
+await type('/channels')
+check('/channels 列出频道(计数行)', await waitText('个:'))
+
+const name = `tui-smoke-${Date.now().toString(36)}`
+// 带 --lead 创建:普通文本缺省路由 lead(messages 端点要求 toAgentId)
+await type(`/channel new ${name} --lead smoke-调度长 smoke测试频道`)
+check('/channel new 创建回执', await waitText('✔ 频道已创建'))
+check('/channel new 自动切换', await waitText(`已切换到频道「${name}」`))
+
+await type('/agents')
+check('/agents 成员面渲染(lead 成员行)', await waitText('smoke-调度长(lead)'))
+
+await type('你好,这是一条 smoke 测试任务')
+check('普通文本 = 发布正式任务(回执)', await waitText('✔ 任务已发布', 12_000))
+
+await type('/hitl')
+check('/hitl 无待办提示', await waitText('没有待人工处理'))
+
+// 监控面板:开启后右侧渲染面板头;omp 未 spawn 时还会出现等待提示
+// (真实 lead 可能已被上面的消息触发 spawn,故只断言确定事实)
+await type('/monitor smoke-调度长')
+check('/monitor 面板开启回执', await waitText('监控已开启:smoke-调度长'))
+check('/monitor 右侧面板渲染', await waitText('┌─ 监控 smoke-调度长', 12_000))
+await type('/monitor off')
+check('/monitor off 关闭回执', await waitText('监控面板已关闭'))
+
+// 清理 smoke 频道与 lead 模板(先于 /quit —— /quit 会 process.exit)
+try {
+  const ch = (await api.listChannels()).find(c => c.name === name)
+  if (ch) await api.request(`/api/workshop/channels/${ch.id}?purge=1`, { method: 'DELETE' })
+  const tpl = (await api.listTemplates()).find(t => t.name === 'smoke-调度长')
+  if (tpl) await api.request(`/api/workshop/agents/${tpl.id}`, { method: 'DELETE' })
+}
+catch { /* 清理失败不判失败 */ }
+
+// 退出码必须反映断言结果:失败时直接非零退出(不走 /quit 的 process.exit(0))
+const ok = failures === 0
+console.log(ok ? '\n[tui-smoke] 全部通过,/quit 退出' : `\n[tui-smoke] ${failures} 项失败,直接退出`)
+if (!ok) process.exit(1)
+await type('/quit')
+// /quit 内部 process.exit(0);若未退出(异常)则在此兜底收口
+console.log('[tui-smoke] /quit 未按预期退出进程(异常),兜底退出')
+process.exit(0)

package/server/api/workshop/hitl/pending.get.ts

@@ -0,0 +1,28 @@
+/**
+ * GET /api/workshop/hitl/pending?channelId= —— 全局待人工处理快照。
+ *
+ * 统一视图:omp ask 对话框(hitl-registry 的 omp-dialog)+ dcw 工具审批
+ * (dcw-approval)。WebUI 全局徽标与 TUI /hitl 命令共用;实时增量走 AEP
+ * hitl.request/hitl.resolved 帧,本端点为快照对齐/恢复入口。
+ *
+ * 鉴权:用户 token;按 channel 所有权过滤(listChannelsForUser 同口径),
+ * channelId 查询参数等价于单频道过滤。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getWorkshopManager } from '@/server/plugins/workshop'
+import { getHitlRegistry } from '@/server/services/workshop/agents/hitl-registry'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const q = getQuery(event)
+  const channelId = typeof q.channelId === 'string' ? q.channelId : ''
+
+  const manager = getWorkshopManager()
+  const visible = new Set(manager.listChannelsForUser(user.id).map(c => c.id))
+  const items = getHitlRegistry()
+    .snapshot(channelId || undefined)
+    .filter(i => visible.has(i.channelId))
+  return { items }
+})

package/server/api/workshop/hitl/respond.post.ts

@@ -0,0 +1,67 @@
+/**
+ * POST /api/workshop/hitl/respond —— 统一 HITL 应答路由(WebUI/TUI 共用)。
+ *
+ * body: { kind: 'omp-dialog' | 'dcw-approval', id, value?, confirmed?, cancelled?, comment? }
+ *  - omp-dialog   → respondTerminalUi(pid, …):extension_ui_response 直写 omp stdin
+ *  - dcw-approval → toolApprovals.decide(id, approved=confirmed===true, comment)(audit 留痕)
+ *
+ * 幂等:待办不在登记处(已被他端处理/超时/撤销)→ 409 ALREADY_RESOLVED。
+ * 鉴权:用户 token + channel 所有权(与 pending.get 同口径)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getWorkshopManager } from '@/server/plugins/workshop'
+import { getHitlRegistry } from '@/server/services/workshop/agents/hitl-registry'
+import { getToolApprovals } from '@/server/services/workshop/agents/tool-approvals'
+import { respondTerminalUi } from '@/server/services/workshop/agents/harness-terminal'
+import { audit } from '@/server/services/workshop/ops/ops'
+
+interface RespondBody {
+  kind?: string
+  id?: string
+  value?: string
+  confirmed?: boolean
+  cancelled?: boolean
+  comment?: string
+}
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<RespondBody>(event) ?? {}
+  const kind = body.kind
+  const id = String(body.id ?? '')
+  if ((kind !== 'omp-dialog' && kind !== 'dcw-approval') || !id) {
+    throw new AppError(400, 'BAD_REQUEST', 'body 需要 { kind: omp-dialog|dcw-approval, id, value?/confirmed?/cancelled?/comment? }')
+  }
+
+  // 所有权校验:待办必须属于请求者可见的 channel
+  const item = getHitlRegistry().find(kind, id)
+  if (!item) throw new AppError(409, 'ALREADY_RESOLVED', `待办已处理或不存在: ${id}`)
+  const manager = getWorkshopManager()
+  manager.getChannelForUser(item.channelId, user.id)
+
+  if (kind === 'omp-dialog') {
+    if (!item.pid) throw new AppError(410, 'SESSION_GONE', '对话框缺少 pid(进程已退出?)')
+    try {
+      respondTerminalUi(item.pid, {
+        id,
+        value: typeof body.value === 'string' ? body.value : undefined,
+        confirmed: typeof body.confirmed === 'boolean' ? body.confirmed : undefined,
+        cancelled: body.cancelled === true,
+      })
+    }
+    catch (err) {
+      throw new AppError(410, 'SESSION_GONE', `omp 会话不可用: ${err instanceof Error ? err.message : String(err)}`)
+    }
+    audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: 'hitl.respond', targetKind: 'omp-dialog', targetId: id, detail: { channelId: item.channelId, agentId: item.agentId, cancelled: body.cancelled === true } })
+    return { ok: true, kind, id }
+  }
+
+  // dcw-approval:approved = confirmed === true(缺省视为拒绝,与 decide 端点同语义)
+  const approved = body.confirmed === true
+  const approval = getToolApprovals().decide(id, approved, String(body.comment ?? ''), user.id, user.name)
+  audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: approved ? 'approval.approve' : 'approval.reject', targetKind: 'tool-approval', targetId: id, detail: { comment: String(body.comment ?? ''), via: 'hitl.respond' } })
+  return { ok: true, kind, id, approval }
+})

package/server/api/workshop/ws.ts

@@ -24,7 +24,8 @@ import type { AgentEvent } from '../../services/workshop/agents/agent-interface'
 import type { A2AMessage } from '../../services/workshop/types/a2a'
 import type { AepEnvelope } from '../../../shared/workshop-protocol'
 import { parseJson } from '../../services/workshop/db/database'
-import { registerScenePeer, unregisterScenePeer } from '../../services/workshop/scene-events'
+import { registerScenePeer, unregisterScenePeer, broadcastPeerEvent } from '../../services/workshop/scene-events'
+import { subscribeHitlEvents } from '../../services/workshop/agents/hitl-registry'
 import { createLogger } from '../../services/workshop/logger'
 import { retentionSettings } from '../../services/workshop/settings'
 
@@ -56,6 +57,12 @@ interface ChannelStream {
   ringBytes: number
   peers: Set<WsPeer>
   unsubs: Array<() => void>
+  /**
+   * HITL 待办事件订阅(hitl-registry 模块级总线 → 频道流)。
+   * 单独存放、不进 unsubs:rebindStreamIfStale 会整体清空 unsubs 重订总线,
+   * 而 registry 订阅与总线生命周期无关,只在建流/回收时挂接一次。
+   */
+  hitlUnsub: (() => void) | null
   /** 当前已订阅的 channel 总线对象(总线生命期短于 stream:空闲卸载会重建 bus → 需重订) */
   busRef: object | null
   /**
@@ -399,6 +406,17 @@ function bindStreamSubscriptions(manager: AgentChannelManager, stream: ChannelSt
   }))
 }
 
+/** HITL 待办事件挂接(建流时一次;closeStream 回收;与总线 rebind 解耦,见 ChannelStream.hitlUnsub)。
+ *  双水路:频道流 publish(seq/环形缓冲/落库,时间线可回放)+ 全员直推
+ *  (channelId='',WebUI 全局徽标/TUI 状态条不依赖 channel 订阅即达;快照恢复走 REST)。 */
+function bindHitlSubscription(manager: AgentChannelManager, stream: ChannelStream): void {
+  stream.hitlUnsub?.()
+  stream.hitlUnsub = subscribeHitlEvents(stream.channelId, (e) => {
+    publish(manager, stream, e.type, e.payload, { agentId: e.agentId })
+    broadcastPeerEvent(e.type, e.payload)
+  })
+}
+
 /** 自愈:stream 已订阅的总线 ≠ 管理器当前总线(空闲卸载销毁/重建)或 manager 更替 → 重订 */
 function rebindStreamIfStale(manager: AgentChannelManager, stream: ChannelStream): void {
   const currentBus = internalsOf(manager).buses.get(stream.channelId) ?? null
@@ -480,6 +498,13 @@ function closeStream(manager: AgentChannelManager, channelId: string): void {
     }
     catch { /* 尽力清理 */ }
   }
+  if (stream.hitlUnsub) {
+    try {
+      stream.hitlUnsub()
+    }
+    catch { /* 尽力清理 */ }
+    stream.hitlUnsub = null
+  }
   streams.delete(channelId)
   for (const peer of stream.peers) {
     peerChannels.get(peer)?.delete(channelId)
@@ -500,6 +525,8 @@ export function ensureStream(manager: AgentChannelManager, channelId: string): C
   if (existing) {
     // 订阅入口处即时自愈(不等 sweep):bus 已重建 → 立即重订到当前总线
     rebindStreamIfStale(manager, existing)
+    // manager 更替(HMR)时 hitl 订阅闭包持旧 manager → 幂等重挂(bind 内先退订)
+    bindHitlSubscription(manager, existing)
     return existing
   }
   // seq 从持久层续接(重启后继续递增;INSERT OR IGNORE 幂等兜底)
@@ -511,11 +538,13 @@ export function ensureStream(manager: AgentChannelManager, channelId: string): C
     ringBytes: 0,
     peers: new Set(),
     unsubs: [],
+    hitlUnsub: null,
     busRef: internalsOf(manager).buses.get(channelId) ?? null,
     dbBuffer: [],
     dbFlushTimer: null,
   }
   bindStreamSubscriptions(manager, stream)
+  bindHitlSubscription(manager, stream)
   // bind 过程可能懒创建 bus:同步真实 busRef,否则 stale 检查会误判重绑
   stream.busRef = internalsOf(manager).buses.get(channelId) ?? null
   streams.set(channelId, stream)

package/server/data/daqs.json

@@ -64,9 +64,9 @@
     "posX": 1695,
     "posZ": 1135,
     "lineId": "ln-af002514",
-    "value": 167.3,
+    "value": 168.3,
     "state": "ok",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-08-27T12:39:08.110Z"
   },
   {
@@ -308,9 +308,9 @@
     "deviceBindingId": null,
     "driverConfig": {},
     "lineId": "ln-af002514",
-    "value": 319,
+    "value": 316,
     "state": "ok",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-08-28T09:37:38.518Z"
   },
   {
@@ -330,9 +330,9 @@
     "deviceBindingId": null,
     "driverConfig": {},
     "lineId": "ln-af002514",
-    "value": 167.5,
+    "value": 168.2,
     "state": "ok",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-08-29T03:30:57.463Z"
   },
   {
@@ -1012,9 +1012,9 @@
     "posX": 2395,
     "posZ": 1135,
     "lineId": "ln-af002514",
-    "value": 168.9,
+    "value": 167.4,
     "state": "ok",
-    "lastAt": "2026-09-03T17:12:29.855Z",
+    "lastAt": "2026-09-04T05:12:12.962Z",
     "createdAt": "2026-08-31T04:07:19.038Z"
   },
   {
@@ -3026,9 +3026,9 @@
     "posX": 120,
     "posZ": 120,
     "lineId": "ln-af002514",
-    "value": 0.9894,
-    "state": "alarm",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "value": 0.9663,
+    "state": "ok",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-09-03T10:17:59.182Z"
   },
   {
@@ -3050,9 +3050,9 @@
     "posX": 120,
     "posZ": 120,
     "lineId": "ln-af002514",
-    "value": 0.9544,
-    "state": "alarm",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "value": 0.9841,
+    "state": "ok",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-09-03T11:18:01.401Z"
   },
   {
@@ -3072,9 +3072,9 @@
     "deviceBindingId": "dev-mthzr991-ujuad",
     "driverConfig": {},
     "lineId": "ln-af002514",
-    "value": 0.9924,
-    "state": "alarm",
-    "lastAt": "2026-09-03T17:12:29.342Z",
+    "value": 0.9652,
+    "state": "ok",
+    "lastAt": "2026-09-04T05:12:13.223Z",
     "createdAt": "2026-09-03T11:34:59.332Z"
   },
   {
@@ -3196,5 +3196,27 @@
     "state": "offline",
     "lastAt": null,
     "createdAt": "2026-09-03T17:12:52.201Z"
+  },
+  {
+    "id": "dn-2c41fbba",
+    "templateRef": "daq-temp-tc",
+    "name": "探针温度",
+    "driver": "mock",
+    "enabled": true,
+    "intervalMs": 500,
+    "publishIntervalMs": null,
+    "unit": "℃",
+    "decimals": 1,
+    "min": 150,
+    "max": 185,
+    "warnLow": 152.8,
+    "warnHigh": 182.2,
+    "deviceBindingId": null,
+    "driverConfig": {},
+    "lineId": "ln-1b318320",
+    "value": 168.5,
+    "state": "ok",
+    "lastAt": "2026-09-04T05:12:14.009Z",
+    "createdAt": "2026-09-04T05:08:10.069Z"
   }
 ]

package/server/data/dcw-lines.json

@@ -1083,5 +1083,19 @@
     "color": "#b58cff",
     "description": "",
     "createdAt": "2026-09-03T17:12:52.197Z"
+  },
+  {
+    "id": "ln-b44bea4f",
+    "name": "探针线",
+    "color": "#ff8a5c",
+    "description": "",
+    "createdAt": "2026-09-04T05:05:33.805Z"
+  },
+  {
+    "id": "ln-1b318320",
+    "name": "探针线1788498490044",
+    "color": "#3aa0ff",
+    "description": "",
+    "createdAt": "2026-09-04T05:08:10.054Z"
   }
 ]