agentworkshop 0.5.8 → 0.6.0

package/scripts/_dbg-release-smoke.mjs

@@ -0,0 +1,104 @@
+/**
+ * 发布前五大功能烟囱测试:产线管理 / 数采数控 / 插件处理节点 / Agent 团队作业 / 数字孪生。
+ * 运行: node scripts/_dbg-release-smoke.mjs
+ */
+import puppeteer from 'puppeteer-core'
+
+const ROOT = 'http://127.0.0.1:3000'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const ok = (name, cond, detail = '') => { console.log(`  ${cond ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!cond) failed++ }
+
+const login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }) }).then(r => r.json())
+const H = { authorization: `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+// ===== ① 产线管理 =====
+console.log('\n--- ① 产线管理 ---')
+{
+  const d = (await j('/api/workshop/dcw')).data
+  ok('产线清单可读', (d.lines?.length ?? 0) > 0, `${d.lines?.length} 条`)
+  ok('配方清单可读', (d.recipes?.length ?? 0) > 0, `${d.recipes?.length} 条`)
+  const cand = d.lines.map(l => ({ line: l, recipe: d.recipes.find(r => r.lineId === l.id) })).find(x => x.recipe)
+  const stop = await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => null)
+  ok('停线操作可用', stop !== null)
+  await sleep(800)
+  const st = await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+  ok('开跑操作可用(产线激活)', st.data?.line?.active === true)
+  const daqA = (await j('/api/workshop/daq')).data
+  await sleep(4000)
+  const daqB = (await j('/api/workshop/daq')).data
+  ok('产线运行态保持(采样持续)', daqB.meta.produced > daqA.meta.produced, `produced ${daqA.meta.produced} → ${daqB.meta.produced}`)
+  // 保持运行(后续数采/插件节点依赖);结束统一停线
+  globalThis.__smokeLine = cand.line.id
+}
+
+// ===== ② 数采数控 =====
+console.log('\n--- ② 数采数控 ---')
+{
+  const daq = (await j('/api/workshop/daq')).data
+  ok('数采节点清单可读', (daq.nodes?.length ?? 0) > 0, `${daq.nodes.length} 节点`)
+  ok('数采后端就绪(timescale/mqtt/minio)', daq.meta.tsdb === 'timescale' && daq.meta.queue === 'mqtt' && daq.meta.objectstore === 'minio', JSON.stringify({ tsdb: daq.meta.tsdb, queue: daq.meta.queue, os: daq.meta.objectstore }))
+  const live = daq.nodes.filter(n => n.value != null && n.state === 'ok').length
+  ok('标量节点实时采集中', live > 0, `${live} 节点有值`)
+  const dcw = (await j('/api/workshop/dcw')).data
+  const dcwLive = dcw.nodes?.filter(n => n.value != null) ?? []
+  ok('数控节点有设定/回读值', dcwLive.length > 0, `${dcwLive.length} 节点`)
+  const framesOk = daq.meta.framesStored == null || daq.meta.framesStored >= 0
+  ok('帧管线指标可用', framesOk, `framesStored=${daq.meta.framesStored}`)
+}
+
+// ===== ③ 插件处理节点 =====
+console.log('\n--- ③ 插件处理节点 ---')
+{
+  const daq = (await j('/api/workshop/daq')).data
+  ok('插件模板在目录(plug-demo-roughness)', daq.templates.some(t => t.plugin && t.signalKind === 'vector'))
+  const manifest = await fetch(`${ROOT}/api/plugins/manifest`).then(r => r.json())
+  const names = ((manifest.data ?? manifest).plugins ?? []).map(p => p.name)
+  ok('三个扩展插件已装载', ['daq-vector-demo', 'omp-sensor-tools', 'daq-sink-verify'].every(n => names.includes(n)), names.join(','))
+}
+
+// ===== ④ Agent 团队作业 =====
+console.log('\n--- ④ Agent 团队作业 ---')
+{
+  const agents = (await j('/api/workshop/agents')).data
+  const list = agents.agents ?? agents
+  ok('Agent 实例清单可读', list.length > 0, `${list.length} 实例`)
+  const channels = (await j('/api/workshop/channels')).data
+  const chList = channels.data ?? channels
+  ok('Channel 清单可读', (Array.isArray(chList) ? chList : chList.channels ?? []).length >= 0)
+  const chList2 = (await j('/api/workshop/channels')).data
+  const ch0 = (Array.isArray(chList2) ? chList2 : chList2.channels ?? [])[0]
+  const memories = ch0 ? await j(`/api/workshop/channels/${ch0.id}/memories?limit=3`).catch(e => ({ data: null })) : { data: null }
+  ok('记忆系统可读(channel 级)', Array.isArray(memories.data))
+}
+
+// ===== ⑤ 数字孪生控制(浏览器)=====
+console.log('\n--- ⑤ 数字孪生 ---')
+{
+  const browser = await puppeteer.launch({ executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', headless: 'new', args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'] })
+  const page = await browser.newPage()
+  await page.setViewport({ width: 1600, height: 1000 })
+  await page.setCookie({ name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' })
+  let pageError = false
+  page.on('pageerror', () => { pageError = true })
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await sleep(22000)
+  const town = await page.evaluate(() => ({
+    canvas: document.querySelectorAll('canvas').length,
+    panelDaq: document.querySelectorAll('.twin-daq .daq-item').length,
+    panelDcw: document.querySelectorAll('.twin-dcw .dcw-item').length,
+  }))
+  ok('/town 页面加载(canvas 场景)', town.canvas > 0, `${town.canvas} canvas`)
+  ok('孪生面板数采监控行', town.panelDaq > 0, `${town.panelDaq} 行`)
+  ok('孪生面板数控设定行', town.panelDcw > 0, `${town.panelDcw} 行`)
+  ok('/town 无页面级 JS 错误', !pageError)
+  // 控制面:DCW 设定行存在即数控控制面已接入面板
+  await browser.close()
+}
+
+// ===== 收尾:停线 =====
+if (globalThis.__smokeLine) await j(`/api/workshop/dcw/lines/${globalThis.__smokeLine}/stop`, 'POST').catch(() => {})
+
+console.log(failed === 0 ? '\nRELEASE SMOKE ALL PASS' : `\nRELEASE SMOKE FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/home-bootstrap.mjs

@@ -146,6 +146,24 @@ export function runBootstrap({ quiet = false, env = process.env } = {}) {
     renameSync(stateTmp, stateFile)
   }
 
+  // 9. prompts 初始化(提示词规约):包内资产(.AgentWorkShop/prompts)→ AW Home/prompts,
+  //    只补缺失文件、绝不覆盖用户定制 —— 运行时目录引导即完整,服务端 loader.ts 另有
+  //    同规则兜底(懒播种),两处幂等互不冲突
+  const promptsSrc = join(packageRoot, '.AgentWorkShop', 'prompts')
+  if (existsSync(promptsSrc)) {
+    const promptsDest = join(home, 'prompts')
+    mkdirSync(promptsDest, { recursive: true })
+    for (const f of readdirSync(promptsSrc)) {
+      const dest = join(promptsDest, f)
+      if (existsSync(dest)) continue
+      try {
+        copyFileSync(join(promptsSrc, f), dest)
+        seeds.push(`prompts/${f}`)
+      }
+      catch { /* 单文件失败不阻断 */ }
+    }
+  }
+
   log(`[aw-home] ${home}  ${created.length ? `（新建 ${created.length} 项）` : '（已就绪）'}`)
   if (seeds.length) log(`[aw-home] 种子文件: ${seeds.join(', ')}`)
   return { home, created, seeds }

package/scripts/i18n-merge.mjs

@@ -1,67 +1,69 @@
-/**
- * 合并器:把 i18n/dicts/<ns>.json(zh)+ i18n/dicts/_en.json(zh→en)
- * 注入 i18n/locales/zh-CN.ts 与 en.ts。
- * - ns 已存在 → 在其块首插入缺词条;否则新建 ns 块
- * - vue-i18n 特殊字符({}@$|)转义为字面量插值
- * - en 缺失 → 回退 zh(报告计数)
- */
-import fs from 'node:fs'
-import path from 'node:path'
-
-const esc = v => v
-  // 保护 vue-i18n 占位符 {pN},其余 { } @ | $ 转义为字面量插值
-  .replace(/\{(?!p\d+\})/g, '{\'{\'}')
-  .replace(/([@$|])/g, '{\'$1\'}')
-const enMap = JSON.parse(fs.readFileSync('i18n/dicts/_en.json', 'utf-8'))
-let miss = 0
-
-function buildEntries(ns, dict, isEn) {
-  const out = []
-  for (const [k, zh] of Object.entries(dict)) {
-    let v = zh
-    if (isEn) {
-      const normalized = s => s.replace(/\s+/g, ' ').trim()
-      const hit = enMap[normalized(zh)] ?? enMap[zh]
-      if (hit == null) {
-        miss++
-        v = zh
-      }
-      else v = hit
-    }
-    out.push(`    ${k}: '${esc(v).replace(/\\/g, '\\\\').replace(/'/g, '\\\'').replace(/\r?\n/g, '\\n')}',`)
-  }
-  return out
-}
-
-for (const [localeFile, isEn] of [['i18n/locales/zh-CN.ts', false], ['i18n/locales/en.ts', true]]) {
-  let src = fs.readFileSync(localeFile, 'utf-8')
-  let insertedTotal = 0
-  for (const f of fs.readdirSync('i18n/dicts').filter(x => x.endsWith('.json') && !x.startsWith('_'))) {
-    const ns = f.replace('.json', '')
-    const dict = JSON.parse(fs.readFileSync(path.join('i18n/dicts', f), 'utf-8'))
-    const entries = buildEntries(ns, dict, isEn)
-    if (entries.length === 0) continue
-    const nsRe = new RegExp(`^  ${ns}: \\{`, 'm')
-    const m = src.match(nsRe)
-    if (m) {
-      // 已有 ns:块首插入尚不存在的键
-      const start = m.index + m[0].length
-      const end = src.indexOf('\n  },', start)
-      const block = src.slice(start, end)
-      const fresh = entries.filter(e => !block.includes(e.match(/ {4}(\w+):/)[1] + ':'))
-      if (fresh.length) {
-        src = src.slice(0, start) + '\n' + fresh.join('\n') + src.slice(start)
-        insertedTotal += fresh.length
-      }
-    }
-    else {
-      // 新 ns:插到文件末尾闭合前
-      const tail = src.lastIndexOf('}')
-      const block = `  ${ns}: {\n${entries.join('\n')}\n  },\n`
-      src = src.slice(0, tail) + block + src.slice(tail)
-      insertedTotal += entries.length
-    }
-  }
-  fs.writeFileSync(localeFile, src)
-  console.log(`${localeFile}: +${insertedTotal} entries (en missing fallback: ${isEn ? miss : 'n/a'})`)
-}
+/**
+ * 合并器:把 i18n/dicts/<ns>.json(zh)+ i18n/dicts/_en.json(zh→en)
+ * 注入 i18n/locales/zh-CN.ts 与 en.ts。
+ * - ns 已存在 → 在其块首插入缺词条;否则新建 ns 块
+ * - vue-i18n 特殊字符({}@$|)转义为字面量插值
+ * - en 缺失 → 回退 zh(报告计数)
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+
+const esc = v => v
+  // 保护 vue-i18n 占位符 {pN},其余 { } @ | $ 转义为字面量插值
+  .replace(/\{(?!p\d+\})/g, '{\'{\'}')
+  .replace(/([@$|])/g, '{\'$1\'}')
+const enMap = JSON.parse(fs.readFileSync('i18n/dicts/_en.json', 'utf-8'))
+let miss = 0
+
+function buildEntries(ns, dict, isEn) {
+  const out = []
+  for (const [k, zh] of Object.entries(dict)) {
+    let v = zh
+    if (isEn) {
+      const normalized = s => s.replace(/\s+/g, ' ').trim()
+      const hit = enMap[normalized(zh)] ?? enMap[zh]
+      if (hit == null) {
+        miss++
+        v = zh
+      }
+      else v = hit
+    }
+    const keyLit = /^[A-Za-z0-9_$]+$/.test(k) ? k : JSON.stringify(k)
+    out.push(`    ${keyLit}: '${esc(v).replace(/\\/g, '\\\\').replace(/'/g, '\\\'').replace(/\r?\n/g, '\\n')}',`)
+  }
+  return out
+}
+
+for (const [localeFile, isEn] of [['i18n/locales/zh-CN.ts', false], ['i18n/locales/en.ts', true]]) {
+  let src = fs.readFileSync(localeFile, 'utf-8')
+  let insertedTotal = 0
+  for (const f of fs.readdirSync('i18n/dicts').filter(x => x.endsWith('.json') && !x.startsWith('_'))) {
+    const ns = f.replace('.json', '')
+    const dict = JSON.parse(fs.readFileSync(path.join('i18n/dicts', f), 'utf-8'))
+    const entries = buildEntries(ns, dict, isEn)
+    if (entries.length === 0) continue
+    const nsRe = new RegExp(`^  ${ns}: \\{`, 'm')
+    const m = src.match(nsRe)
+    if (m) {
+      // 已有 ns:块首插入尚不存在的键
+      const start = m.index + m[0].length
+      const end = src.indexOf('\n  },', start)
+      const block = src.slice(start, end)
+      // 键可能带引号(点号等非 \w 键由 emitter JSON.stringify 加引号)
+      const fresh = entries.filter(e => !block.includes(e.match(/ {4}"?([\w.]+)"?:/)[1] + ':'))
+      if (fresh.length) {
+        src = src.slice(0, start) + '\n' + fresh.join('\n') + src.slice(start)
+        insertedTotal += fresh.length
+      }
+    }
+    else {
+      // 新 ns:插到文件末尾闭合前
+      const tail = src.lastIndexOf('}')
+      const block = `  ${ns}: {\n${entries.join('\n')}\n  },\n`
+      src = src.slice(0, tail) + block + src.slice(tail)
+      insertedTotal += entries.length
+    }
+  }
+  fs.writeFileSync(localeFile, src)
+  console.log(`${localeFile}: +${insertedTotal} entries (en missing fallback: ${isEn ? miss : 'n/a'})`)
+}

package/scripts/test-context-governor.ts

@@ -1,176 +1,176 @@
-/**
- * 上下文治理环测试(假 RPC 客户端,零真实子进程):
- * 70% 门控 / get_state 复查 / compact→compaction_end 等待 / legacy 降级 /
- * 压缩事件分支 harvest / 被动 usage 透出 / 总开关与最小间隔。
- * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-context-governor.ts
- */
-import { OmpRpcAgentImpl } from '../server/services/workshop/agents/omp-agent'
-
-let failures = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-
-type Frame = Record<string, unknown>
-
-/** 假 omp RPC 客户端:协议面仿真(命令应答/事件订阅/被动 usage) */
-class FakeOmpClient {
-  alive = true
-  streaming = false
-  statsOk = true
-  compactOk = true
-  usageTokens = 0
-  contextWindow = 1000
-  autoCompact: boolean | null = null
-  sent: Array<Record<string, unknown>> = []
-  private listeners = new Set<(e: Frame) => void>()
-
-  onEvent(fn: (e: Frame) => void): () => void {
-    this.listeners.add(fn)
-    return () => this.listeners.delete(fn)
-  }
-
-  emit(e: Frame): void {
-    for (const fn of this.listeners) fn(e)
-  }
-
-  async send(cmd: Record<string, unknown>): Promise<{ success: boolean, data?: unknown }> {
-    this.sent.push(cmd)
-    const type = cmd.type as string
-    if (type === 'get_session_stats') {
-      if (!this.statsOk) throw new Error('omp RPC 命令失败: get_session_stats 未知命令')
-      return { success: true, data: { contextUsage: { tokens: this.usageTokens, contextWindow: this.contextWindow, percent: this.usageTokens / this.contextWindow } } }
-    }
-    if (type === 'get_state') {
-      return { success: true, data: { isStreaming: this.streaming, isCompacting: false, sessionId: 'sess-1', model: { contextWindow: this.contextWindow } } }
-    }
-    if (type === 'compact') {
-      if (!this.compactOk) throw new Error('omp RPC 命令失败: compact 未知命令')
-      const summary = '压缩摘要:完成任务A;未竟:验证B'
-      setTimeout(() => {
-        this.emit({ type: 'compaction_end', result: { summary, tokensBefore: this.usageTokens, tokensAfter: 30000 }, reason: 'manual' })
-      }, 10)
-      return { success: true, data: {} }
-    }
-    if (type === 'set_auto_compaction') {
-      this.autoCompact = cmd.enabled as boolean
-      return { success: true }
-    }
-    return { success: true }
-  }
-
-  getContextUsage(): { tokens: number, contextWindow: number, percent: number } {
-    return { tokens: this.usageTokens, contextWindow: this.contextWindow, percent: this.usageTokens / this.contextWindow }
-  }
-
-  setContextWindow(n: number): void {
-    this.contextWindow = n
-  }
-
-  onHostToolCall(_fn: unknown): void {}
-}
-
-/** 装配:真实 OmpRpcAgentImpl + 注入假客户端/假 workspace */
-function assemble(): { impl: OmpRpcAgentImpl, client: FakeOmpClient, harvested: Array<Record<string, unknown>> } {
-  const impl = new OmpRpcAgentImpl({ agentId: 'a1', name: 'A', role: 'worker', channelId: 'ch1' })
-  const client = new FakeOmpClient()
-  const harvested: Array<Record<string, unknown>> = []
-  const box = impl as unknown as Record<string, unknown>
-  box.client = client
-  box.workspace = {
-    recordSessionMemory: async (i: Record<string, unknown>) => {
-      harvested.push(i)
-    },
-  }
-  return { impl, client, harvested }
-}
-
-const gate = (impl: OmpRpcAgentImpl, reason = 'test'): Promise<void> =>
-  (impl as unknown as Record<string, unknown>).contextGate(reason) as Promise<void>
-
-process.env.AW_OMP_COMPACT_THRESHOLD = '0.7'
-process.env.AW_OMP_COMPACT_MIN_INTERVAL_MS = '300000'
-process.env.AW_OMP_COMPACT_WAIT_MS = '5000'
-
-console.log('\n--- 门控基础路径 ---')
-{
-  process.env.AW_OMP_COMPACT_ENABLED = '1'
-  const { impl, client, harvested } = assemble()
-  client.usageTokens = 500 // 50% < 70%
-  await gate(impl)
-  check('低于阈值不触发 compact', !client.sent.some(c => c.type === 'compact'), `sent=${client.sent.map(c => c.type)}`)
-
-  client.usageTokens = 850 // 85% ≥ 70%
-  await gate(impl)
-  check('达阈值发起 compact', client.sent.some(c => c.type === 'compact'))
-  check('compact 前先复查 get_state', client.sent.indexOf('get_state') !== -1 || client.sent.some(c => c.type === 'get_state'))
-  await new Promise(r => setTimeout(r, 50))
-  check('compaction_end 摘要 harvest 入库', harvested.length === 1 && harvested[0]!.summary === '压缩摘要:完成任务A;未竟:验证B', JSON.stringify(harvested))
-  check('harvest 携带 token 元信息', harvested[0]!.tokensBefore === 850 && harvested[0]!.tokensAfter === 30000)
-
-  // 最小间隔:压缩后立即再 gate 不应二次 compact
-  client.usageTokens = 950
-  await gate(impl)
-  check('最小间隔防振荡(不再 compact)', client.sent.filter(c => c.type === 'compact').length === 1)
-}
-
-console.log('\n--- 安全防线 ---')
-{
-  // get_state 复查:流式中绝不压缩
-  const { impl, client } = assemble()
-  client.usageTokens = 900
-  client.streaming = true
-  await gate(impl)
-  check('isStreaming=true 时不发起 compact', !client.sent.some(c => c.type === 'compact'))
-
-  // 总开关
-  process.env.AW_OMP_COMPACT_ENABLED = '0'
-  const g2 = assemble()
-  g2.client.usageTokens = 900
-  await gate(g2.impl)
-  check('总开关关闭不压缩', !g2.client.sent.some(c => c.type === 'compact'))
-  process.env.AW_OMP_COMPACT_ENABLED = '1'
-
-  // legacy 降级:compact 未知命令 → 标记后不再尝试
-  const g3 = assemble()
-  g3.client.usageTokens = 900
-  g3.client.compactOk = false
-  await gate(g3.impl)
-  const box3 = g3.impl as unknown as Record<string, unknown>
-  check('未知命令 → legacy 标记', box3.compactLegacy === true)
-  g3.client.usageTokens = 980
-  await gate(g3.impl)
-  check('legacy 后续回合不再发 compact', g3.client.sent.filter(c => c.type === 'compact').length === 1)
-}
-
-console.log('\n--- 事件分支与状态透出 ---')
-{
-  const { impl, client, harvested } = assemble()
-  // 回合中途原生压缩(compaction_start/end 事件):不污染事件流 + harvest
-  const map = (impl as unknown as Record<string, (e: Frame) => Frame[]>).mapOmpEvent.bind(impl)
-  const startOut = map({ type: 'compaction_start' }, undefined)
-  const endOut = map({ type: 'compaction_end', result: { summary: '原生阈值压缩摘要', tokensBefore: 900 }, reason: 'threshold' }, undefined)
-  const settledOut = map({ type: 'agent_settled' }, undefined)
-  check('压缩事件映射为空(不污染 AgentEvent 流)', startOut.length === 0 && endOut.length === 0 && settledOut.length === 0)
-  await new Promise(r => setTimeout(r, 20))
-  check('原生压缩摘要同样 harvest', harvested.some(h => h.summary === '原生阈值压缩摘要'))
-
-  // 被动 usage 透出 getContextStats
-  client.usageTokens = 420
-  const stats = (impl as unknown as Record<string, () => unknown>).getContextStats()
-  check('getContextStats 透出用量与占比', JSON.stringify(stats) === JSON.stringify({ usedTokens: 420, contextWindow: 1000, percent: 0.42, compacting: false }), JSON.stringify(stats))
-
-  // 双路去重:同摘要 60s 内只入库一次
-  map({ type: 'compaction_end', result: { summary: '原生阈值压缩摘要' }, reason: 'threshold' }, undefined)
-  await new Promise(r => setTimeout(r, 20))
-  check('同摘要双达去重(60s 窗口)', harvested.filter(h => h.summary === '原生阈值压缩摘要').length === 1)
-
-  // onTurnSettled 复用 gate(自守卫不抛错)
-  client.usageTokens = 100
-  await impl.onTurnSettled()
-  check('onTurnSettled 低用量安全返回', true)
-}
-
-console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
-process.exit(failures === 0 ? 0 : 1)
+/**
+ * 上下文治理环测试(假 RPC 客户端,零真实子进程):
+ * 70% 门控 / get_state 复查 / compact→compaction_end 等待 / legacy 降级 /
+ * 压缩事件分支 harvest / 被动 usage 透出 / 总开关与最小间隔。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-context-governor.ts
+ */
+import { OmpRpcAgentImpl } from '../server/services/workshop/agents/omp-agent'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+type Frame = Record<string, unknown>
+
+/** 假 omp RPC 客户端:协议面仿真(命令应答/事件订阅/被动 usage) */
+class FakeOmpClient {
+  alive = true
+  streaming = false
+  statsOk = true
+  compactOk = true
+  usageTokens = 0
+  contextWindow = 1000
+  autoCompact: boolean | null = null
+  sent: Array<Record<string, unknown>> = []
+  private listeners = new Set<(e: Frame) => void>()
+
+  onEvent(fn: (e: Frame) => void): () => void {
+    this.listeners.add(fn)
+    return () => this.listeners.delete(fn)
+  }
+
+  emit(e: Frame): void {
+    for (const fn of this.listeners) fn(e)
+  }
+
+  async send(cmd: Record<string, unknown>): Promise<{ success: boolean, data?: unknown }> {
+    this.sent.push(cmd)
+    const type = cmd.type as string
+    if (type === 'get_session_stats') {
+      if (!this.statsOk) throw new Error('omp RPC 命令失败: get_session_stats 未知命令')
+      return { success: true, data: { contextUsage: { tokens: this.usageTokens, contextWindow: this.contextWindow, percent: this.usageTokens / this.contextWindow } } }
+    }
+    if (type === 'get_state') {
+      return { success: true, data: { isStreaming: this.streaming, isCompacting: false, sessionId: 'sess-1', model: { contextWindow: this.contextWindow } } }
+    }
+    if (type === 'compact') {
+      if (!this.compactOk) throw new Error('omp RPC 命令失败: compact 未知命令')
+      const summary = '压缩摘要:完成任务A;未竟:验证B'
+      setTimeout(() => {
+        this.emit({ type: 'compaction_end', result: { summary, tokensBefore: this.usageTokens, tokensAfter: 30000 }, reason: 'manual' })
+      }, 10)
+      return { success: true, data: {} }
+    }
+    if (type === 'set_auto_compaction') {
+      this.autoCompact = cmd.enabled as boolean
+      return { success: true }
+    }
+    return { success: true }
+  }
+
+  getContextUsage(): { tokens: number, contextWindow: number, percent: number } {
+    return { tokens: this.usageTokens, contextWindow: this.contextWindow, percent: this.usageTokens / this.contextWindow }
+  }
+
+  setContextWindow(n: number): void {
+    this.contextWindow = n
+  }
+
+  onHostToolCall(_fn: unknown): void {}
+}
+
+/** 装配:真实 OmpRpcAgentImpl + 注入假客户端/假 workspace */
+function assemble(): { impl: OmpRpcAgentImpl, client: FakeOmpClient, harvested: Array<Record<string, unknown>> } {
+  const impl = new OmpRpcAgentImpl({ agentId: 'a1', name: 'A', role: 'worker', channelId: 'ch1' })
+  const client = new FakeOmpClient()
+  const harvested: Array<Record<string, unknown>> = []
+  const box = impl as unknown as Record<string, unknown>
+  box.client = client
+  box.workspace = {
+    recordSessionMemory: async (i: Record<string, unknown>) => {
+      harvested.push(i)
+    },
+  }
+  return { impl, client, harvested }
+}
+
+const gate = (impl: OmpRpcAgentImpl, reason = 'test'): Promise<void> =>
+  (impl as unknown as Record<string, unknown>).contextGate(reason) as Promise<void>
+
+process.env.AW_OMP_COMPACT_THRESHOLD = '0.7'
+process.env.AW_OMP_COMPACT_MIN_INTERVAL_MS = '300000'
+process.env.AW_OMP_COMPACT_WAIT_MS = '5000'
+
+console.log('\n--- 门控基础路径 ---')
+{
+  process.env.AW_OMP_COMPACT_ENABLED = '1'
+  const { impl, client, harvested } = assemble()
+  client.usageTokens = 500 // 50% < 70%
+  await gate(impl)
+  check('低于阈值不触发 compact', !client.sent.some(c => c.type === 'compact'), `sent=${client.sent.map(c => c.type)}`)
+
+  client.usageTokens = 850 // 85% ≥ 70%
+  await gate(impl)
+  check('达阈值发起 compact', client.sent.some(c => c.type === 'compact'))
+  check('compact 前先复查 get_state', client.sent.indexOf('get_state') !== -1 || client.sent.some(c => c.type === 'get_state'))
+  await new Promise(r => setTimeout(r, 50))
+  check('compaction_end 摘要 harvest 入库', harvested.length === 1 && harvested[0]!.summary === '压缩摘要:完成任务A;未竟:验证B', JSON.stringify(harvested))
+  check('harvest 携带 token 元信息', harvested[0]!.tokensBefore === 850 && harvested[0]!.tokensAfter === 30000)
+
+  // 最小间隔:压缩后立即再 gate 不应二次 compact
+  client.usageTokens = 950
+  await gate(impl)
+  check('最小间隔防振荡(不再 compact)', client.sent.filter(c => c.type === 'compact').length === 1)
+}
+
+console.log('\n--- 安全防线 ---')
+{
+  // get_state 复查:流式中绝不压缩
+  const { impl, client } = assemble()
+  client.usageTokens = 900
+  client.streaming = true
+  await gate(impl)
+  check('isStreaming=true 时不发起 compact', !client.sent.some(c => c.type === 'compact'))
+
+  // 总开关
+  process.env.AW_OMP_COMPACT_ENABLED = '0'
+  const g2 = assemble()
+  g2.client.usageTokens = 900
+  await gate(g2.impl)
+  check('总开关关闭不压缩', !g2.client.sent.some(c => c.type === 'compact'))
+  process.env.AW_OMP_COMPACT_ENABLED = '1'
+
+  // legacy 降级:compact 未知命令 → 标记后不再尝试
+  const g3 = assemble()
+  g3.client.usageTokens = 900
+  g3.client.compactOk = false
+  await gate(g3.impl)
+  const box3 = g3.impl as unknown as Record<string, unknown>
+  check('未知命令 → legacy 标记', box3.compactLegacy === true)
+  g3.client.usageTokens = 980
+  await gate(g3.impl)
+  check('legacy 后续回合不再发 compact', g3.client.sent.filter(c => c.type === 'compact').length === 1)
+}
+
+console.log('\n--- 事件分支与状态透出 ---')
+{
+  const { impl, client, harvested } = assemble()
+  // 回合中途原生压缩(compaction_start/end 事件):不污染事件流 + harvest
+  const map = (impl as unknown as Record<string, (e: Frame) => Frame[]>).mapOmpEvent.bind(impl)
+  const startOut = map({ type: 'compaction_start' }, undefined)
+  const endOut = map({ type: 'compaction_end', result: { summary: '原生阈值压缩摘要', tokensBefore: 900 }, reason: 'threshold' }, undefined)
+  const settledOut = map({ type: 'agent_settled' }, undefined)
+  check('压缩事件映射为空(不污染 AgentEvent 流)', startOut.length === 0 && endOut.length === 0 && settledOut.length === 0)
+  await new Promise(r => setTimeout(r, 20))
+  check('原生压缩摘要同样 harvest', harvested.some(h => h.summary === '原生阈值压缩摘要'))
+
+  // 被动 usage 透出 getContextStats
+  client.usageTokens = 420
+  const stats = (impl as unknown as Record<string, () => unknown>).getContextStats()
+  check('getContextStats 透出用量与占比', JSON.stringify(stats) === JSON.stringify({ usedTokens: 420, contextWindow: 1000, percent: 0.42, compacting: false }), JSON.stringify(stats))
+
+  // 双路去重:同摘要 60s 内只入库一次
+  map({ type: 'compaction_end', result: { summary: '原生阈值压缩摘要' }, reason: 'threshold' }, undefined)
+  await new Promise(r => setTimeout(r, 20))
+  check('同摘要双达去重(60s 窗口)', harvested.filter(h => h.summary === '原生阈值压缩摘要').length === 1)
+
+  // onTurnSettled 复用 gate(自守卫不抛错)
+  client.usageTokens = 100
+  await impl.onTurnSettled()
+  check('onTurnSettled 低用量安全返回', true)
+}
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)