agentworkshop 0.5.9 → 0.6.1

package/scripts/_dbg-plugin-verify-e2e.mjs

@@ -0,0 +1,123 @@
+/**
+ * 插件扩展全栈验证 A(数据管线 + 前端 + 孪生):
+ * ①插件模板+插件驱动建节点 → 产线开跑 → mock 一次性 vector 采样
+ * ②sink 加工断言(×2 确定性签名:argmax=6、points[6]≈1.08、points[0]≈0.90、verifyTag=1)
+ * ③DB 事实(REST frames = Timescale 读取)
+ * ④/daq 列表页实时值变化(浏览器)
+ * ⑤/town 数字孪生右轨面板实时变化(浏览器)
+ * 产出 .e2e-plugin-ctx.json 供 Agent 读库段使用;节点保留(--cleanup=1 时清理)。
+ * 运行: node scripts/_dbg-plugin-verify-e2e.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { writeFileSync, readFileSync } from 'node:fs'
+
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const CLEANUP = process.env.CLEANUP === '1'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+let failed = 0
+const check = (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 cookie = { name: 'token', value: login.data.token, domain: '127.0.0.1', path: '/' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+// ===== ① 插件模板/驱动在目录 =====
+const daq0 = (await j('/api/workshop/daq')).data
+const tpl = daq0.templates.find(t => t.key === 'plug-verify-x2-profile')
+check('①插件模板在目录(plugin 标记,vector)', !!tpl && tpl.plugin != null && tpl.signalKind === 'vector')
+
+// ===== ② 开跑 + 插件模板 + 插件驱动建节点 =====
+const d = (await j('/api/workshop/dcw')).data
+const cand = d.lines.map(l => ({ line: l, recipe: d.recipes.find(r => r.lineId === l.id) })).find(x => x.recipe)
+await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+await sleep(800)
+await j(`/api/workshop/dcw/lines/${cand.line.id}/start`, 'POST', { recipeId: cand.recipe.id })
+const node = (await j('/api/workshop/daq', 'POST', {
+  templateRef: 'plug-verify-x2-profile',
+  driver: 'verify-burst',
+  lineId: cand.line.id,
+  name: '全栈验证 ×2 轮廓',
+  posX: 120, posZ: 120,
+})).data.node
+check('②节点创建(插件模板+插件驱动)', node?.driver === 'verify-burst', `driver=${node?.driver}`)
+
+// ===== ③ 等帧 → sink 加工确定性断言 =====
+let frames = []
+for (let i = 0; i < 15; i++) {
+  await sleep(2000)
+  frames = (await j(`/api/workshop/daq/${node.id}/frames?limit=5`)).data.frames
+  if (frames.length >= 3) break
+}
+check('③帧入库(Rest = Timescale 事实源)', frames.length >= 3, `${frames.length} 帧`)
+if (frames.length >= 3) {
+  const f = frames[0]
+  const pts = f.points ?? []
+  const argmax = pts.reduce((best, p, i) => (p > pts[best] ? i : best), 0)
+  check('一次性 vector:24 点完整轮廓', pts.length === 24, `len=${pts.length}`)
+  check('×2 标定签名:argmax=6(尖峰位)', argmax === 6, `argmax=${argmax}`)
+  check('×2 标定签名:points[6]∈[1.06,1.12](=2×0.54)', pts[6] >= 1.06 && pts[6] <= 1.12, String(pts[6]))
+  check('×2 标定签名:points[0]∈[0.88,0.92](=2×0.45)', pts[0] >= 0.88 && pts[0] <= 0.92, String(pts[0]))
+  check('插件处理器指纹:metrics.verifyTag=1', f.metrics.verifyTag === 1)
+  check('内置 derive-metric 在插件后执行:max=points[6]', Math.abs((f.metrics.max ?? 0) - pts[6]) < 0.001, `max=${f.metrics.max}`)
+  check('产线打标继承', f.lineId === cand.line.id)
+}
+
+// ===== ④/⑤ 浏览器:/daq 列表实时 + /town 孪生面板实时 =====
+const twins = (await j('/api/workshop/device-twins')).data
+const twinsList = twins.twins ?? twins
+const device = twinsList.find(t => t.kind !== 'daq' && t.kind !== 'dcw')
+if (device) await j(`/api/workshop/daq/${node.id}/bind`, 'POST', { deviceId: device.id })
+
+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(cookie)
+try {
+  // ④ /daq 列表页
+  await page.goto(`${ROOT}/daq`, { waitUntil: 'networkidle2', timeout: 90000 })
+  await sleep(5000)
+  const rowVal = () => page.evaluate(() => {
+    const row = [...document.querySelectorAll('tbody tr')].find(r => r.textContent?.includes('全栈验证'))
+    const m = row?.textContent?.match(/(\d+\.\d+)\s*mm/)
+    return m ? m[1] : null
+  })
+  const v1 = await rowVal()
+  await sleep(4500)
+  const v2 = await rowVal()
+  check('④/daq 列表页出现插件节点行', v1 != null, `v1=${v1}`)
+  check('④/daq 实时值变化(WS 帧驱动)', v1 != null && v2 != null && v1 !== v2, `${v1} → ${v2}`)
+
+  // ⑤ /town 数字孪生
+  await page.goto(`${ROOT}/town`, { waitUntil: 'domcontentloaded', timeout: 90000 })
+  await sleep(20000)
+  const panel = () => page.evaluate(() => {
+    const item = [...document.querySelectorAll('.twin-daq .daq-item')].find(e => e.textContent?.includes('标定轮廓'))
+    return { text: item?.textContent?.replace(/\s+/g, '') ?? '', val: item?.querySelector('b')?.textContent?.replace(/\s+/g, '') ?? null }
+  })
+  const p1 = await panel()
+  await sleep(5000)
+  const p2 = await panel()
+  check('⑤/town 孪生面板出现插件节点行(标定轮廓)', p1.text !== '', p1.text.slice(0, 60))
+  check('⑤/town 面板实时值变化(加工后量级)', p1.val != null && p2.val != null && p1.val !== p2.val, `${p1.val} → ${p2.val}`)
+} finally {
+  await browser.close().catch(() => {})
+}
+
+// ===== Agent 绑定(供读库段)=====
+const agents = (await j('/api/workshop/agents')).data
+const list = agents.agents ?? agents
+const agent = list.find(a => a.enabled !== 0 && a.role === 'worker') ?? list[0]
+await fetch(`${ROOT}/api/workshop/agent-tools/bindings`, { method: 'POST', headers: H, body: JSON.stringify({ agentId: agent.id, nodeId: node.id, kind: 'daq', mode: 'manual' }) }).then(r => r.json())
+writeFileSync('.e2e-plugin-ctx.json', JSON.stringify({ nodeId: node.id, agentId: agent.id, lineId: cand.line.id }))
+
+if (CLEANUP) {
+  await j(`/api/workshop/daq/${node.id}`, 'DELETE').catch(() => {})
+  await j(`/api/workshop/dcw/lines/${cand.line.id}/stop`, 'POST').catch(() => {})
+  console.log('(cleanup 模式:节点已删/线已停)')
+} else {
+  console.log(`(节点 ${node.id} 与产线运行保留,供 Agent 段/浏览器复验;CLEANUP=1 可清理)`)
+}
+
+console.log(failed === 0 ? '\nSTACK-A ALL PASS' : `\nSTACK-A FAILED(${failed})`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-prompts-hotreload-test.ts

@@ -0,0 +1,76 @@
+/**
+ * prompts 热重载 + 目录优先级实测(对真实 ~/.AgentWorkShop/prompts 操作,测完恢复)。
+ * 用法:npx tsx --tsconfig .nuxt/tsconfig.shared.json scripts/_dbg-prompts-hotreload-test.ts
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, utimesSync, writeFileSync } from 'node:fs'
+import { homedir, tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const homeConfigRoot = join(homedir(), '.AgentWorkShop')
+const homePrompts = join(homeConfigRoot, 'prompts')
+const TARGET = 'mode-goal.md'
+const MARKER = `HOTRELOAD-MARKER-${Date.now()}`
+const targetFile = join(homePrompts, TARGET)
+
+const proj = mkdtempSync(join(tmpdir(), 'aw-hr-proj-'))
+mkdirSync(join(proj, '.AgentWorkShop', 'prompts'), { recursive: true })
+
+const NAME = 'mode-goal' // renderPrompt 入参为 prompt 名(loader 内部拼 .md)
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures++
+}
+
+const { promptsDir, renderPrompt } = await import('@/server/services/workshop/prompts/loader')
+const bumpMtime = (file: string) => {
+  const t = new Date(Date.now() + 5)
+  utimesSync(file, t, t)
+}
+
+// ===== 场景 1:Home 兜底目录 + 修改即热重载 =====
+console.log('━━━ 场景 1:~/.AgentWorkShop/prompts(Home 兜底)+ 修改即热重载 ━━━')
+process.chdir(homedir())
+const resolved1 = promptsDir()
+check('解析到 Home prompts 目录', resolved1 === homePrompts, resolved1)
+check('目标文件存在', existsSync(targetFile))
+
+const original = readFileSync(targetFile, 'utf8')
+try {
+  const before = renderPrompt(NAME, {})
+  writeFileSync(targetFile, original + '\n' + MARKER)
+  bumpMtime(targetFile)
+  const after = renderPrompt(NAME, {})
+  check('修改后热重载(渲染含新标记,无需重启)', after.includes(MARKER) && before !== after,
+    `before=${before.length}ch after=${after.length}ch`)
+  writeFileSync(targetFile, original)
+  bumpMtime(targetFile)
+  const restored = renderPrompt(NAME, {})
+  check('恢复原文件后渲染还原', restored === before)
+}
+finally {
+  writeFileSync(targetFile, original)
+}
+
+// ===== 场景 2:项目内 ./.AgentWorkShop/prompts 优先 + 独立热重载 =====
+console.log('━━━ 场景 2:项目内 ./.AgentWorkShop/prompts 优先 ━━━')
+process.chdir(proj)
+writeFileSync(join(proj, '.AgentWorkShop', 'prompts', TARGET), 'PROJECT-LOCAL GOAT PROMPT v1')
+const resolved2 = promptsDir()
+check('解析到项目内 prompts 目录', resolved2 === join(proj, '.AgentWorkShop', 'prompts'), resolved2)
+const projV1 = renderPrompt(NAME, {})
+check('渲染取自项目文件(而非 Home)', projV1.includes('PROJECT-LOCAL GOAT PROMPT v1'))
+writeFileSync(join(proj, '.AgentWorkShop', 'prompts', TARGET), 'PROJECT-LOCAL GOAT PROMPT v2')
+bumpMtime(join(proj, '.AgentWorkShop', 'prompts', TARGET))
+const projV2 = renderPrompt(NAME, {})
+check('项目文件修改同样热重载', projV2.includes('v2') && !projV2.includes('v1'))
+
+// ===== 场景 3:双目录隔离(切回 Home 不受项目文件影响)=====
+process.chdir(homedir())
+const homeRender = renderPrompt(NAME, {})
+check('切回 Home 目录渲染不受项目文件影响', !homeRender.includes('PROJECT-LOCAL'))
+
+rmSync(proj, { recursive: true, force: true })
+console.log(failures === 0 ? '\nHOTRELOAD + PRIORITY ALL PASS' : `\n${failures} FAILED`)
+if (failures > 0) process.exit(1)

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/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'})`)
+}