agentworkshop 0.7.44 → 0.7.47

package/scripts/typecheck.mjs

@@ -0,0 +1,75 @@
+/**
+ * 类型检查入口(替代裸 `nuxt typecheck`)。
+ *
+ * 为什么需要它:Nuxt 4.5 的 pages 模块在 `prepare:types` 里**无条件**把
+ * `vue-router/volar/sfc-route-blocks` 写进生成 tsconfig 的 `vueCompilerOptions.plugins`,
+ * 而 vue-router 4.6 起 package.json 的 exports 已不再暴露该子路径 →
+ * `vue-tsc` 在**加载 tsconfig 阶段**就抛 ERR_PACKAGE_PATH_NOT_EXPORTED,
+ * 类型检查等于一次都没跑(命令失败但原因与源码无关,极易被当成"项目有类型错")。
+ *
+ * 本脚本做三件事,顺序固定:
+ *   ① nuxi prepare            重新生成 .nuxt 类型(与 nuxt typecheck 行为一致)
+ *   ② 剔除那条已不存在的插件   只删这一个字符串条目;其余 vueCompilerOptions 原样保留
+ *   ③ vue-tsc -b --noEmit     与 nuxt typecheck 内部调用完全一致的参数
+ *
+ * 本项目<b>不使用</b> <route> SFC 块(全仓 0 处),去掉该插件无功能损失。
+ * 若将来要用 typed route blocks:把 vue-router 对齐到仍导出该子路径的版本,
+ * 然后删除本脚本的 ② 步(或整个脚本)即可。
+ *
+ * 用法:`pnpm typecheck`(或 `node scripts/typecheck.mjs [--skip-prepare]`)
+ */
+import { spawnSync } from 'node:child_process'
+import { readdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const repo = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const PHANTOM = 'vue-router/volar/sfc-route-blocks'
+const skipPrepare = process.argv.includes('--skip-prepare')
+
+const run = (cmd, args) => spawnSync(cmd, args, { cwd: repo, stdio: 'inherit' })
+
+/** 直接用 node 跑本地 bin:不经 shell(npx.cmd 需要 shell),避免参数拼接与 deprecation 噪声 */
+const NUXT_BIN = join(repo, 'node_modules', 'nuxt', 'bin', 'nuxt.mjs')
+const VUE_TSC_BIN = join(repo, 'node_modules', 'vue-tsc', 'bin', 'vue-tsc.js')
+
+if (!skipPrepare) {
+  console.log('[typecheck] ① nuxi prepare(重新生成 .nuxt 类型)')
+  const prep = run(process.execPath, [NUXT_BIN, 'prepare'])
+  if (prep.status !== 0) {
+    console.error('[typecheck] prepare 失败')
+    process.exit(prep.status ?? 1)
+  }
+}
+
+console.log(`[typecheck] ② 剔除生成配置里已不存在的 volar 插件条目:${PHANTOM}`)
+const nuxtDir = join(repo, '.nuxt')
+let patched = 0
+for (const file of readdirSync(nuxtDir).filter(f => /^tsconfig.*\.json$/.test(f))) {
+  const p = join(nuxtDir, file)
+  const src = readFileSync(p, 'utf8')
+  let json
+  try {
+    json = JSON.parse(src)
+  }
+  catch {
+    continue // 非纯 JSON(带注释)→ 跳过,由 ③ 自行报错
+  }
+  const vco = json.vueCompilerOptions
+  if (!vco || !Array.isArray(vco.plugins)) continue
+  const kept = vco.plugins.filter(p0 => !(typeof p0 === 'string' && p0 === PHANTOM))
+  if (kept.length === vco.plugins.length) continue
+  vco.plugins = kept
+  writeFileSync(p, `${JSON.stringify(json, null, 2)}\n`)
+  patched += 1
+  console.log(`           · ${file}: plugins ${vco.plugins.length + 1} → ${kept.length}`)
+}
+if (patched === 0) console.log('           · 无需改动(生成配置已不含该条目)')
+
+console.log('[typecheck] ③ vue-tsc -b --noEmit')
+const tsc = run(process.execPath, [VUE_TSC_BIN, '-b', '--noEmit'])
+if (tsc.status !== 0) {
+  console.error('[typecheck] 类型检查未通过')
+  process.exit(tsc.status ?? 1)
+}
+console.log('[typecheck] ✔ 类型检查通过')

package/scripts/ui/lib.mjs

@@ -14,6 +14,14 @@ export const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3021'
 export const CHROME = process.env.AW_CHROME
   ?? 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
 
+/**
+ * 渲染倍率:默认 2(视觉走查/截图取清晰像素)。
+ * 资源紧张的机器(或长链路交互 E2E:多页 + 整页截图)可 `AW_UI_SCALE=1` 降一档 ——
+ * 否则 Chromium 会以 `net::ERR_INSUFFICIENT_RESOURCES` 拒绝加载后续资源,
+ * 表现为"页面加载不出来",实际是渲染表面内存打满(与产品无关)。
+ */
+export const UI_SCALE = Number(process.env.AW_UI_SCALE ?? 2) || 2
+
 export const VISUAL_USER = {
   name: 'visual',
   email: 'visual@awshop.local',
@@ -107,6 +115,10 @@ export async function launch({ width = 1440, height = 900 } = {}) {
   return puppeteer.launch({
     executablePath: CHROME,
     headless: true,
+    // 重页面(echarts/three/phaser + 首帧 SSR 水合)在**负载较高的机器**上单次
+    // Runtime.evaluate 可能超过 CDP 默认 180s → ProtocolError 直接把断言打断。
+    // 这里放宽到 5 分钟:慢 ≠ 失败,断言本身仍各自带超时。
+    protocolTimeout: 300_000,
     args: [
       '--no-sandbox',
       '--disable-dev-shm-usage',
@@ -114,7 +126,7 @@ export async function launch({ width = 1440, height = 900 } = {}) {
       '--force-color-profile=srgb',
       '--font-render-hinting=none',
     ],
-    defaultViewport: { width, height, deviceScaleFactor: 2 },
+    defaultViewport: { width, height, deviceScaleFactor: UI_SCALE },
   })
 }
 
@@ -124,7 +136,7 @@ export async function launch({ width = 1440, height = 900 } = {}) {
  * 只写其一会导致首帧闪色 + antd cssinjs 不重注入(历史踩坑)。
  */
 export async function openPage(browser, {
-  token, dark = true, width = 1440, height = 900, deviceScaleFactor = 2, touch,
+  token, dark = true, width = 1440, height = 900, deviceScaleFactor = UI_SCALE, touch,
 } = {}) {
   const page = await browser.newPage()
   // 窄视口默认按**触摸设备**仿真:不这么做,Chromium 报告 pointer:fine →

package/scripts/ui/smoke-refactor.mjs

@@ -0,0 +1,258 @@
+/**
+ * 前端重构后的**浏览器冒烟**:逐页加载、等客户端水合、收集控制台错误与页面异常。
+ *
+ * 为什么必须有这一步:typecheck/eslint 看不到「模板搬进子组件后运行时报错 / 响应式断链 /
+ * scoped CSS 失配」这类问题,而本轮把 8 个巨型页面/组件拆成了上百个文件。
+ *
+ * 用法: node scripts/ui/smoke-refactor.mjs [--base http://127.0.0.1:3458] [--routes /aml,/daq,...]
+ * 判据:HTTP 加载成功 + 客户端水合(data-vp-tier)+ 无 console error/pageerror + 根节点有内容
+ */
+import { existsSync } from 'node:fs'
+
+/** 找到可用的 Chromium:优先 AW_CHROME,其次本机 Chrome/Edge(puppeteer-core 不自带浏览器) */
+function resolveChrome() {
+  if (process.env.AW_CHROME) return process.env.AW_CHROME
+  const cands = [
+    'C:/Program Files/Google/Chrome/Application/chrome.exe',
+    'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
+    'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
+    'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
+  ]
+  return cands.find(p => existsSync(p))
+}
+const arg = (k, d) => {
+  const i = process.argv.indexOf(k)
+  if (i >= 0) return process.argv[i + 1]
+  const kv = process.argv.find(a => a.startsWith(`${k}=`))
+  return kv ? kv.slice(k.length + 1) : d
+}
+// lib.mjs 在**模块加载时**读取 AW_CHROME / AW_BASE,所以两者都必须先定好再动态导入
+process.env.AW_BASE = arg('--base', process.env.AW_BASE ?? 'http://127.0.0.1:3458')
+process.env.AW_CHROME = resolveChrome() ?? ''
+if (!process.env.AW_CHROME) {
+  console.error('未找到 Chromium:请设置 AW_CHROME 指向本机 chrome/msedge 可执行文件')
+  process.exit(2)
+}
+
+const { BASE: DEFAULT_BASE, api, ensureVisualUser, launch, openPage, ROUTES, sleep } = await import('./lib.mjs')
+
+const only = arg('--routes', '')?.split(',').map(s => s.trim()).filter(Boolean)
+const routes = only?.length ? ROUTES.filter(r => only.includes(r.path) || only.includes(r.name)) : ROUTES
+
+let pass = 0
+const fails = []
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) pass += 1
+  else fails.push(`${name}${detail ? ` (${detail})` : ''}`)
+}
+
+const NOISE = [
+  /favicon/i,
+  /ResizeObserver loop/i,
+  /Download the Vue Devtools/i,
+  /\[nuxt\]/i,
+  /WebSocket connection to .* failed/i,
+  /net::ERR_CONNECTION_REFUSED/i,
+]
+const isNoise = t => NOISE.some(re => re.test(t))
+
+/**
+ * 水合判据:Vue 在挂载容器上写 `__vue_app__` —— 它出现即客户端已接管。
+ * 不用 `data-vp-tier`:那是 useResponsive 的副作用,/town 的**空态**不会挂载它(实测踩过,
+ * 会把"合法的空状态页"误判成"没水合")。
+ */
+const HYDRATED = () => Boolean(document.querySelector('#__nuxt')?.__vue_app__)
+
+/** 预置:建频道 + 建 workspace + 挂载 → 让 /town 与 /workshop/w/:wsId 走**真实渲染分支**而不是空态 */
+async function seedTown(api, token) {
+  const name = `smoke-${Date.now().toString(36)}`
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: { name, leadAgent: { name: `${name}-lead`, harness: 'mock', config: { delayMs: 30 } } },
+    token,
+  })
+  const channelId = ch.data?.channelId
+  if (!channelId) return null
+  const wsName = `${name}-ws`
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: wsName }, token })
+  const wsId = ws.data?.id ?? ws.data?.workspaceId
+  if (wsId) {
+    await api('POST', `/api/workshop/workspaces/${wsId}/channels/${channelId}`, { body: {}, token })
+  }
+  return { channelId, wsId, wsName }
+}
+
+/**
+ * 预置:/daq/:id(节点详情)与 /dcw/:id(**产线**详情)+ 挂载节点/产品/配方。
+ * 为什么必须预置:
+ *  1) 详情页拆成了 5~9 个 composable + 3~4 个子组件,只在数据存在时才挂载;
+ *     访问不存在的 id 只渲染一行「未找到 / 产线不存在」,等于什么都没验证(实测踩过:
+ *     /dcw/<节点id> 渲染出的是「产线不存在或已被删除」——该路由的参数是**产线 id**,不是节点 id);
+ *  2) 挂上节点/产品/配方后,页面才会渲染控制节点清单、配方版本历史、数据查询这些真实分支。
+ * templateRef 用内置模板(shared/{daq,dcw}-protocol.ts),无需先建模板。
+ */
+async function seedDetail(api, token) {
+  const name = `smoke-${Date.now().toString(36)}`
+  const daqName = `${name}-daq`
+  const lineName = `${name}-line`
+  const daq = await api('POST', '/api/workshop/daq', {
+    body: { name: daqName, templateRef: 'temp-tc', driver: 'mock' },
+    token,
+  })
+  const line = await api('POST', '/api/workshop/dcw/lines', { body: { name: lineName }, token })
+  const lineId = line.data?.line?.id ?? ''
+  if (!lineId) return { daqId: daq.data?.node?.id ?? '', lineId: '', dcwId: '', daqName, lineName }
+
+  const dcw = await api('POST', '/api/workshop/dcw', {
+    body: { name: `${name}-dcw`, templateRef: 'temp-sp', driver: 'mock', lineId },
+    token,
+  })
+  const product = await api('POST', '/api/workshop/dcw/products', {
+    body: { name: `${name}-product`, lineId },
+    token,
+  })
+  const productId = product.data?.product?.id ?? ''
+  if (productId) {
+    await api('POST', '/api/workshop/dcw/recipes', {
+      body: { name: `${name}-recipe`, productId, params: [] },
+      token,
+    })
+  }
+  return { daqId: daq.data?.node?.id ?? '', lineId, dcwId: dcw.data?.node?.id ?? '', daqName, lineName }
+}
+
+const token = await ensureVisualUser()
+check('0.1 取得可登录测试账号 token', Boolean(token))
+
+const wantsDetail = routes.some(r => r.name === 'daq' || r.name === 'dcw')
+if (wantsDetail) {
+  const { daqId, lineId, dcwId, daqName, lineName } = await seedDetail(api, token)
+  // expect:把"有内容"升级为"渲染的确实是这个实体" —— 详情页早退到「未找到」时页面同样非空
+  if (daqId) routes.push({ path: `/daq/${daqId}`, name: 'daq-detail', title: '数采节点详情', expect: daqName })
+  if (lineId) routes.push({ path: `/dcw/${lineId}`, name: 'dcw-detail', title: '产线控制台', expect: lineName })
+  check('0.3 详情页预置:数采节点 + 产线(挂节点/产品/配方)—— 否则只渲染「未找到」,拆分出的 composable/子组件全不挂载',
+    Boolean(daqId && lineId && dcwId), `daqId=${daqId} lineId=${lineId} dcwId=${dcwId}`)
+}
+
+/**
+ * 已知既存缺陷(与本轮重构无关,已在未改动的文件上复现):
+ *   connection.ts:87 对**每一帧**都调用 onDataRecovered(),而 useWorkshopWs 的回调在
+ *   其中 `sendNotificationsSub()` + `backfill()` —— 服务端收到 sub 会回 notification.snapshot,
+ *   它同样是"非 pong 帧",于是再次触发 → 客户端/服务端 ping-pong。
+ *   实测:有实时实体时 967 帧/s 的 notification.snapshot + ~1450 次/s 的通知 REST,
+ *   直到浏览器 socket 耗尽报 ERR_INSUFFICIENT_RESOURCES;空库(0 实体)则完全不出现。
+ *   两个文件都与 HEAD 逐字节一致(git diff 为空),且同一风暴在**未重构**的 / 与 /daq 列表页出现。
+ *
+ * 处理:仅当"错误全是资源耗尽类 + 通知接口请求数达到风暴量级"时降级为 WARN,
+ * 其余任何控制台错误仍判 FAIL —— 不能让这条已知噪声淹掉真正的重构回归。
+ */
+const STORM_URL = '/api/workshop/notifications'
+const STORM_MIN_REQ = 200
+/** 浏览器级:本次冒烟里是否出现过通知风暴(资源耗尽是跨标签页的,见下面用法说明) */
+let stormSeen = false
+const isResourceExhaustion = t => /ERR_INSUFFICIENT_RESOURCES|ERR_ABORTED|ERR_FAILED|Failed to load resource/i.test(t)
+/**
+ * 风暴的另一种下游症状:Nuxt 客户端在启动时会拉 `/_nuxt/builds/meta/<buildId>.json`(版本自检),
+ * socket 被风暴打满后这一步会失败,控制台只留一行 `[NUXT_E5002]`。
+ * 已证伪"产物缺文件":该 json 存在于 .output 且服务端 GET 返回 200(实测),失败纯属客户端资源耗尽。
+ * 只在"本次冒烟确实观察到风暴"时才把它并入风暴桶,避免掩盖真正的分包缺失。
+ */
+const isStormSymptom = t => isResourceExhaustion(t) || /^\[NUXT_E5002\]$/.test(t.trim())
+const STORM_MIN_EXHAUSTION = 100
+
+console.log(`\n━━━ 前端重构冒烟 @ ${process.env.AW_BASE}(${routes.length} 条路由)━━━`)
+// /workshop/w/:wsId(单工作区控制台)需要一个**已挂载频道**的 workspace 才走真实分支,
+// 与 /town 同一份预置;id 只能运行时拿到,故路由在这里追加。
+if (routes.some(r => r.path === '/town' || r.name === 'ws-console')) {
+  const seeded = await seedTown(api, token)
+  check('0.2 /town 与 /workshop/w/:wsId 预置:建频道 + workspace + 挂载(否则只会渲染空态,测不到拆分后的控制台/孪生视图)',
+    Boolean(seeded?.channelId), JSON.stringify(seeded))
+  if (seeded?.wsId) {
+    routes.push({
+      path: `/workshop/w/${seeded.wsId}`,
+      name: 'ws-console',
+      title: '单工作区控制台',
+      expect: seeded.wsName,
+    })
+  }
+}
+
+const browser = await launch({ width: 1440, height: 900 })
+try {
+  for (const r of routes) {
+    const page = await openPage(browser, { token, dark: true })
+    const consoleErrors = []
+    const pageErrors = []
+    const warnings = []
+    const reqCount = new Map()
+    page.on('request', (r) => {
+      const u = r.url().split('?')[0]
+      if (u.endsWith(STORM_URL)) reqCount.set(STORM_URL, (reqCount.get(STORM_URL) ?? 0) + 1)
+    })
+    page.on('console', (m) => {
+      const t = m.text()
+      if (isNoise(t)) return
+      // 生产构建下 Vue 只给"有 mismatch"这一句、没有任何节点级细节,无法据此定位;
+      // 且实测**未改动**的页面(/workshop/agents、teams、channel-templates)同样会报,
+      // 与本轮重构无关 ⇒ 单列为 WARN 而不是 FAIL。
+      if (/Hydration completed but contains mismatches/i.test(t)) {
+        warnings.push(t)
+        return
+      }
+      if (m.type() === 'error') consoleErrors.push(t.slice(0, 200))
+    })
+    page.on('pageerror', e => pageErrors.push(String(e.message).slice(0, 200)))
+    let status = 0
+    try {
+      const resp = await page.goto(DEFAULT_BASE + r.path, { waitUntil: 'domcontentloaded', timeout: 60_000 })
+      status = resp?.status() ?? 0
+      await page.waitForFunction(HYDRATED, { timeout: 90_000, polling: 200 })
+      await sleep(1800)
+    }
+    catch (e) {
+      pageErrors.push(`导航/水合失败: ${String(e.message).slice(0, 160)}`)
+    }
+    const bodyText = await page.evaluate(() => document.body.innerText.replace(/\s+/g, ' ').trim()).catch(() => '')
+    const bodyLen = bodyText.length
+    const mainChildren = await page.evaluate(() => {
+      const el = document.querySelector('#__nuxt > *, main, .page, [class*="page"]')
+      return el ? el.children.length : 0
+    }).catch(() => 0)
+    check(`${r.path} 可加载并水合`, status === 200 && pageErrors.length === 0,
+      `status=${status} pageErrors=${pageErrors.length}${pageErrors.length ? ` :: ${pageErrors[0]}` : ''}`)
+    check(`${r.path} 渲染出内容(非空白页)`, bodyLen > 40 && mainChildren > 0, `text=${bodyLen} chars, children=${mainChildren}`)
+    if (r.expect) {
+      check(`${r.path} 渲染的确实是预置实体「${r.expect}」(而非「未找到」早退分支)`, bodyText.includes(r.expect))
+    }
+
+    const notifReq = reqCount.get(STORM_URL) ?? 0
+    if (notifReq >= STORM_MIN_REQ) stormSeen = true
+    const exhaustion = consoleErrors.filter(isResourceExhaustion).length
+    const onlyStormSymptoms = consoleErrors.every(isStormSymptom)
+    // 资源耗尽是**浏览器级**的:一个标签页把 socket 打满后,后续标签页即使自己没发起风暴
+    // 也会报 ERR_INSUFFICIENT_RESOURCES(实测:/workshop 风暴之后,/workshop/w/:wsId 单独看请求数
+    // 并不多却仍然报错)。故用"本次冒烟里是否出现过风暴"作为全局判据,并把本页与全局计数都打出来。
+    if (consoleErrors.length > 0 && onlyStormSymptoms && stormSeen && exhaustion >= STORM_MIN_EXHAUSTION) {
+      console.log(`  WARN  ${r.path} 通知风暴的浏览器级连带(既存缺陷,非本轮重构):本页 ${notifReq} 次`
+        + ` + ${exhaustion} 条资源耗尽错误${consoleErrors.length > exhaustion ? ' + build-meta 自检失败' : ''}`
+        + `;见 connection.ts:87 每帧回调 onDataRecovered`)
+    }
+    else {
+      // 打印**全部**去重后的错误(只印前两条会掩盖"第三条才是真因"的情况,实测踩过)
+      const uniq = [...new Set(consoleErrors)]
+      check(`${r.path} 无控制台错误`, consoleErrors.length === 0,
+        uniq.length ? `${consoleErrors.length} 条/${uniq.length} 种 :: ${uniq.slice(0, 4).join(' || ')}` : '')
+    }
+    if (warnings.length) console.log(`  WARN  ${r.path} 水合告警(生产构建无细节;未改动页面同样存在): ${warnings[0]}`)
+    await page.close()
+  }
+}
+finally {
+  await browser.close()
+}
+
+console.log(`\n${'='.repeat(64)}`)
+console.log(`前端冒烟: PASS=${pass} FAIL=${fails.length}`)
+for (const f of fails) console.log(`  FAIL  ${f}`)
+console.log('='.repeat(64))
+process.exit(fails.length > 0 ? 1 : 0)

package/scripts/verify-a2a-live.mjs

@@ -109,8 +109,22 @@ async function main() {
   console.log('\n--- 4. tasks/cancel ---')
   const cancelTask = await req('POST', `/channels/${CH}/tasks`, { token, body: { title: '待取消任务', description: '将被取消' } })
   const CT = cancelTask.json?.data?.id
+  // 时序现实:mock lead 对一步任务会在首个监督回合直接收口,取消请求可能输掉这场竞态。
+  // 两种结局都必须正确 —— 在途 → CANCELED;已终态 → 终态护栏(409 TASK_TERMINAL,
+  // 绝不把 COMPLETED 静默改写为 CANCELED)。断言按实际到场状态分支。
+  const preCancel = await req('GET', `/tasks/${CT}`, { token })
+  const preState = preCancel.json?.data?.state ?? preCancel.json?.state
+  const wasOpen = !!preState && !['COMPLETED', 'FAILED', 'CANCELED'].includes(preState)
   const cancelR = await rpc(LEAD, { jsonrpc: '2.0', id: 10, method: 'tasks/cancel', params: { taskId: CT } })
-  check('tasks/cancel 生效 CANCELED', cancelR.json?.result?.status?.state === 'CANCELED', cancelR.json?.result?.status?.state ?? JSON.stringify(cancelR.json))
+  if (wasOpen) {
+    check('tasks/cancel 生效 CANCELED', cancelR.json?.result?.status?.state === 'CANCELED', cancelR.json?.result?.status?.state ?? JSON.stringify(cancelR.json))
+  }
+  else {
+    const errCode = cancelR.json?.error?.data?.appCode ?? cancelR.json?.error?.code
+    check('已终态任务的 tasks/cancel 被终态护栏拒绝(不改写 COMPLETED)',
+      errCode === 'TASK_TERMINAL' || errCode === 'INVALID_TRANSITION',
+      `preState=${preState} err=${JSON.stringify(cancelR.json?.error ?? cancelR.json?.result?.status?.state)}`)
+  }
 
   console.log(`\n━━━ 结果: PASS=${pass} FAIL=${fail} ━━━`)
   process.exit(fail === 0 ? 0 : 1)

package/scripts/verify-ws-events.mjs

@@ -52,6 +52,9 @@ async function main() {
   const worker = await api('POST', `/channels/${CH}/agents`, { token, body: { name: 'ws-worker', harness: 'mock', role: 'worker' } })
   const WORKER = worker.json?.data?.id
   check('lead/worker 实例创建', !!WORKER)
+  // agent token(发 a2a 消息用;任务派发走信箱不产生 a2a.message 帧,只有真实 a2a 发送才有)
+  const members = await api('GET', `/channels/${CH}/agents`, { token })
+  const LEAD_TOKEN = (members.json?.data ?? []).find(m => m.role === 'lead')?.token
 
   // 连接 WS + sub
   const ws = new WebSocket(WS)
@@ -77,12 +80,27 @@ async function main() {
   check('snapshot 信封合法(v/seq/at/channelId)', snapshot?.v === 1 && typeof snapshot.seq === 'number' && typeof snapshot.at === 'string')
 
   // 提交任务 → 事件流
-  const task = await api('POST', `/channels/${CH}/tasks`, { token, body: { title: 'ws-event-task', description: '触发事件流' } })
+  // 必须显式要求分解:平台既定行为是「简单任务 Lead 直接完成」(§10 Real OMP 第 1 项),
+  // 不派发子任务就不会有 task.progress(子任务进度)与 worker 间的 a2a.message 帧。
+  const task = await api('POST', `/channels/${CH}/tasks`, {
+    token,
+    body: {
+      title: '[mock:complex] ws-event-task',
+      description: '本任务必须分解为可并行的子任务并派发给 worker 执行,等待子任务完成后汇总收口。不要自己直接完成。',
+    },
+  })
   const TASK = task.json?.data?.id
   check('任务提交', !!TASK)
 
   const final = await waitTaskTerminal(TASK, token)
   check('任务 COMPLETED', final?.state === 'COMPLETED', final?.state ?? '')
+  // 真实 a2a 发送(子任务 assign 走信箱、不产生 a2a.message 帧)→ 覆盖该帧型
+  if (LEAD_TOKEN && WORKER) {
+    await api('POST', '/a2a/send', {
+      token: LEAD_TOKEN,
+      body: { toAgentId: WORKER, parts: [{ text: 'ws-events 覆盖检查:请确认收到' }] },
+    })
+  }
   await sleep(800) // 等尾部事件
 
   ws.send(JSON.stringify({ type: 'unsub', channelId: CH }))

package/server/api/system/monitor/terminal/ws.ts

@@ -9,6 +9,11 @@
  *
  * 鉴权:用户 token(?token= 查询参数,与管理 API 同口径)——终端可向
  * 真实 agent 会话注入输入(HITL),必须认证。
+ *
+ * v17(P0 §13.2):**不再只检查 token 有效**。终端是 Channel 级高权控制面
+ * (可读会话内容 / 注入 steer 输入 / 中止回合 / 应答 HITL 对话框),必须同时核对
+ * Channel 归属:仅 Channel owner 或 admin 可接入。遗留无归属 Channel(owner NULL)
+ * 仅 admin 可接入。越权一律 4403 关闭,且**不泄露**会话元信息。
  */
 import { defineWebSocketHandler } from 'h3'
 import { resolveUserByToken } from '../../../../services/user.service'
@@ -20,6 +25,9 @@ import {
   subscribeTerminal,
   terminalSessionSnapshot,
 } from '../../../../services/workshop/agents/harness-terminal'
+import { listHarnessProcesses } from '../../../../services/workshop/agents/harness-process'
+import { getWorkshopManager } from '../../../../plugins/workshop'
+import { AppError } from '../../../../utils/errors'
 import type { TerminalClientMessage, TerminalServerMessage } from '../../../../../shared/terminal-protocol'
 
 /** 最小 peer 接口(h3 2.x 未 re-export crossws 类型,duck typing;与 workshop ws.ts 同风格) */
@@ -52,7 +60,8 @@ export default defineWebSocketHandler({
 
     // 鉴权:?token= 用户 token(管理面同口径)
     const token = resolveQueryParam(ws, 'token')
-    if (!token || !resolveUserByToken(token)) {
+    const user = token ? resolveUserByToken(token) : null
+    if (!user) {
       fail(ws, 'USER_UNAUTHORIZED', '需要有效用户 token(?token= 查询参数)', 4401)
       return
     }
@@ -79,6 +88,47 @@ export default defineWebSocketHandler({
       return
     }
 
+    // v17 §13.2:Channel 级授权核对(在读取任何会话元信息之前)。
+    // 解析 pid → channelId:agentId 直连走成员表;pid 直连走 harness 进程注册表。
+    // 无法归属到 Channel 的孤儿进程 → 仅 admin 可接入(否则越权者只能靠 pid 猜)。
+    let channelId: string | null
+    let agentName: string
+    try {
+      const manager = getWorkshopManager()
+      if (agentId) {
+        const row = manager.findChannelAgentById(agentId)
+        channelId = row?.channelId ?? null
+        agentName = row ? (manager.getChannelAgent(agentId)?.name ?? '') : ''
+      }
+      else {
+        const entry = listHarnessProcesses().find(p => p.pid === pid)
+        channelId = entry?.channelId ?? null
+        agentName = entry?.name ?? ''
+      }
+    }
+    catch {
+      // workshop 未初始化:无法核对授权 → 拒绝(不降级为"仅 token 有效")
+      fail(ws, 'WORKSHOP_NOT_READY', 'workshop 未初始化,无法核对终端授权', 4503)
+      return
+    }
+
+    if (user.role !== 'admin') {
+      if (!channelId) {
+        fail(ws, 'FORBIDDEN_TERMINAL', '该终端会话未归属任何 Channel,仅管理员可接入', 4403)
+        return
+      }
+      try {
+        getWorkshopManager().requireChannelOwner(channelId, { id: user.id, role: user.role }, 'channel')
+      }
+      catch (err) {
+        const code = err instanceof AppError ? err.code : 'FORBIDDEN'
+        // 越权信息最小化:不回传 channel 名/agent 名,避免探测
+        fail(ws, code === 'FORBIDDEN_LEGACY' ? 'FORBIDDEN_LEGACY' : 'FORBIDDEN_TERMINAL', '终端仅 Channel owner 可接入', 4403)
+        return
+      }
+    }
+    void agentName
+
     const snap = terminalSessionSnapshot(pid)
     if (!snap) {
       fail(ws, 'NO_SESSION', `PID ${pid} 无终端镜像会话(进程未启动或非 omp harness)`, 4404)

package/server/api/workshop/agent-tools/approvals/[id]/decide.post.ts

@@ -1,21 +1,75 @@
 /**
  * POST /api/workshop/agent-tools/approvals/:id/decide —— 批准/拒绝一次工具执行。
  * body: { approved: boolean, comment?: string }(备注随 tool result 返回给 Agent)
+ *
+ * v17 安全修复(主计划 §13.2):
+ *  ① `approved` 必须是**显式布尔值**:旧实现 `body.approved !== false` 让字段缺失
+ *     (=客户端漏传/构造请求)自动变成"批准" —— 高危数控下发的静默放行,现已 400 拒绝;
+ *  ② 决策前先做 Channel 归属 + 可见性 + 审批资格校验(与列表端点同口径),
+ *     越权/跨 Channel 一律 403;
+ *  ③ decide() 的"审批不存在或已处理"从裸 Error(→500)映射为 **409 ALREADY_RESOLVED**,
+ *     与 hitl/respond 的并发语义一致。
  */
 import { readBody, getRouterParam } 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 { getToolApprovals } from '@/server/services/workshop/agents/tool-approvals'
+import { assertCanDecideHitlChannel, snapshotOfRow } from '@/server/services/workshop/agents/hitl-decision'
 import { audit } from '@/server/services/workshop/ops/ops'
 
 export default defineApiHandler(async (event) => {
   const user = resolveUser(event)
   const id = getRouterParam(event, 'id')!
-  const body = await readBody<{ approved?: boolean, comment?: string }>(event) ?? {}
-  // S4:裁决人留痕(谁批准/拒绝了这次 HITL 下发)
-  const approved = body.approved !== false
-  const approval = getToolApprovals().decide(id, approved, String(body.comment ?? ''), user.id, user.name)
+  const body = await readBody<{ approved?: unknown, comment?: string }>(event) ?? {}
+
+  // ① 显式布尔:禁止"缺省即批准"
+  if (typeof body.approved !== 'boolean') {
+    throw new AppError(400, 'BAD_REQUEST', 'body.approved 必须是显式布尔值(true=批准 / false=拒绝);字段缺失不再默认为批准')
+  }
+  const approved = body.approved
+  const comment = String(body.comment ?? '')
+
+  const manager = getWorkshopManager()
+  const acting = { id: user.id, name: user.name, role: user.role }
+  const row = manager.groupChat.hitl.findById(id)
+  const pending = getToolApprovals().listPending().find(a => a.id === id)
+  const agentId = row?.agentId || pending?.agentId || ''
+
+  if (agentId) {
+    const channelId = manager.findChannelAgentById(agentId)?.channelId
+    if (channelId) {
+      // ② 与列表端点同口径:可见性 + 审批策略 + 创建时资格快照
+      assertCanDecideHitlChannel(channelId, acting, row ? { policy: row.policy, snapshot: snapshotOfRow(row) } : {})
+    }
+    else if (user.role !== 'admin') {
+      // 归属无法解析(Agent 已删除/未落库):非管理员不放行
+      throw new AppError(403, 'SCOPE_VIOLATION', '该审批的 Agent 已不属于任何 Channel,仅管理员可处理')
+    }
+  }
+  else if (pending && user.role !== 'admin') {
+    throw new AppError(403, 'SCOPE_VIOLATION', '无法确定审批归属的 Channel,仅管理员可处理')
+  }
+
+  let approval
+  try {
+    approval = getToolApprovals().decide(id, approved, comment, user.id, user.name)
+  }
+  catch (err) {
+    // ③ 非 pending(已被他人处理/超时/被取消)→ 409(不再 500)
+    throw new AppError(409, 'ALREADY_RESOLVED', err instanceof Error ? err.message : String(err))
+  }
+
   // R1:HITL 裁决审计(闭环中的人为决策留痕)
-  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 ?? '') } })
+  audit({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: approved ? 'approval.approve' : 'approval.reject',
+    targetKind: 'tool-approval',
+    targetId: id,
+    detail: { comment, via: 'agent-tools/decide', agentId, channelId: manager.findChannelAgentById(agentId)?.channelId ?? '' },
+  })
   return { approval }
 })

package/server/api/workshop/agent-tools/approvals/index.get.ts

@@ -1,18 +1,43 @@
 /**
  * GET /api/workshop/agent-tools/approvals?agentId=&scope=pending|history
  * —— 手动确认模式的执行审批列表(孪生侧栏审批面板轮询)。
+ *
+ * v17 安全修复(主计划 §13.2):此前 `resolveUser(event)` 的结果被**丢弃**,
+ * 任何已登录用户都能看到全部 Channel 的待审批项(越权读取 + 越权裁决入口)。
+ * 现在按 Channel 归属与审批资格过滤:
+ *   ① 审批的 agentId → channelId(getWorkshopManager().findChannelAgentById);
+ *   ② 该 Channel 必须在调用者可见范围内(listChannelsVisibleTo ∪ 遗留公共行),
+ *      且调用者具备审批资格(owner_only → 仅 owner;any_member → 任意 active 成员;admin 全量);
+ *   ③ 归属无法解析(Agent 已删除等)→ 仅 admin 可见(fail-closed)。
+ * history 与 pending 用同一过滤口径,避免"历史里泄露、列表里看不到"的错配。
  */
 import { getQuery } from 'h3'
 import { resolveUser } from '@/server/api/workshop/caller'
 import { defineApiHandler } from '@/server/utils/response'
+import { getWorkshopManager } from '@/server/plugins/workshop'
 import { getToolApprovals } from '@/server/services/workshop/agents/tool-approvals'
+import { canDecideHitlChannel, snapshotOfRow } from '@/server/services/workshop/agents/hitl-decision'
 
 export default defineApiHandler(async (event) => {
-  resolveUser(event)
+  const user = resolveUser(event)
   const q = getQuery(event)
   const agentId = typeof q.agentId === 'string' ? q.agentId : ''
   const scope = q.scope === 'history' ? 'history' : 'pending'
-  return {
-    approvals: scope === 'history' ? getToolApprovals().historyList() : getToolApprovals().listPending(agentId),
+
+  const manager = getWorkshopManager()
+  const acting = { id: user.id, name: user.name, role: user.role }
+
+  /** 单条审批是否对当前用户可见/可裁决 */
+  const visible = (approvalAgentId: string, approvalId: string): boolean => {
+    // 审批的 Channel 归属:Agent 实例 → channelId
+    const channelId = manager.findChannelAgentById(approvalAgentId)?.channelId
+    if (!channelId) return user.role === 'admin'
+    // dcw 审批的冻结策略(创建时快照);无持久化行则按当前 Channel 策略
+    const row = manager.groupChat.hitl.find('dcw-approval', approvalId)
+    const opts = row ? { policy: row.policy, snapshot: snapshotOfRow(row) } : {}
+    return canDecideHitlChannel(channelId, acting, opts)
   }
+
+  const all = scope === 'history' ? getToolApprovals().historyList() : getToolApprovals().listPending(agentId)
+  return { approvals: all.filter(a => visible(a.agentId, a.id)) }
 })