agentworkshop 0.7.34 → 0.7.37

package/nuxt.config.ts

@@ -6,6 +6,18 @@ import { loadConfig } from './app/config'
 // 构建期一次性读取 config.yml，作为整个运行时的单一事实来源
 const config = loadConfig()
 
+// 版本号的事实源是 package.json —— config.yml 的 app.version 只是历史遗留副本,
+// 长期不同步(config.yml 停在 0.7.9 而包已到 0.7.35),且 /api/health 直接回显它。
+// 这里以包版本优先,config.yml 仅作回退,消除"发版后版本号两处不一致"。
+const PKG_VERSION = (() => {
+  try {
+    return JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8')).version as string
+  }
+  catch {
+    return null
+  }
+})()
+
 // @nuxt/eslint 仅在依赖树内存在时启用 —— 全局安装载荷(用户机)不装 eslint,
 // 构建期模块不可解析会直接炸;仓库开发环境正常启用
 const hasEslintModule = existsSync(join(process.cwd(), 'node_modules', '@nuxt', 'eslint'))
@@ -78,7 +90,7 @@ export default defineNuxtConfig({
     public: {
       appName: config.app.name,
       appTitle: config.app.title,
-      version: config.app.version,
+      version: PKG_VERSION ?? config.app.version,
       description: config.app.description,
       mode: config.mode,
       apiBase: config.api.baseURL,
@@ -123,7 +135,7 @@ export default defineNuxtConfig({
       // 运行时 engine.loadDescriptors 经 cwd 兜底读 schema.json。
       // shared/lru.mjs 同理(daq-controller 的 siblingsCache 使用有界 LRU);
       // 漏内联的后果是构建产物里留下未绑定的 new LruMap(...) → 运行时 ReferenceError。
-      inline: ['**/shared/config/engine.mjs', '**/shared/lru.mjs'],
+      inline: ['**/shared/config/engine.mjs', '**/shared/lru.mjs', '**/shared/config/home.mjs'],
     },
     // 服务器侧 rollup 构建:显式外置 node:* 内建模块(如 node:sqlite)。
     // rollup 的内建模块清单不含 node:sqlite,Nitro 的 externals 插件也放行,
@@ -192,6 +204,19 @@ export default defineNuxtConfig({
         catch (err) {
           console.error('[build] schema.json copy failed:', err)
         }
+        // AML Python 运行时资产同样随产物分发:这些 .py/.txt 是运行时经 fs 读取的
+        // (requirementsHash 读 requirements.txt、jobEnv 把 amlkit.py 所在目录塞进
+        // PYTHONPATH),nitro 不会打包它们。缺了它们的后果不是启动失败,而是
+        // **训练作业在供给 venv 时才炸**,且报错指向空文件摘要,很难定位。
+        try {
+          const pySrc = join(process.cwd(), 'server', 'services', 'workshop', 'aml', 'python')
+          const pyOut = join(process.cwd(), '.output', '.AgentWorkShop', 'aml-python')
+          cpSync(pySrc, pyOut, { recursive: true })
+          console.log('[build] aml python assets copied →', pyOut)
+        }
+        catch (err) {
+          console.error('[build] aml python assets copy failed:', err)
+        }
       },
     },
   },

package/package.json

@@ -1,153 +1,164 @@
-{
-  "name": "agentworkshop",
-  "version": "0.7.34",
-  "type": "module",
-  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
-  "license": "PolyForm-Noncommercial-1.0.0",
-  "exports": {
-    ".": {
-      "types": "./sdk/index.d.mts",
-      "default": "./sdk/index.mjs"
-    },
-    "./sdk": {
-      "types": "./sdk/index.d.mts",
-      "default": "./sdk/index.mjs"
-    },
-    "./sdk/client": {
-      "types": "./sdk/client.d.mts",
-      "default": "./sdk/client.mjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "aw": "bin/aw.mjs",
-    "agentworkshop": "bin/aw.mjs"
-  },
-  "files": [
-    ".output",
-    "bin",
-    "cli",
-    "sdk",
-    "app",
-    "server",
-    "shared",
-    "i18n",
-    "public",
-    "scripts",
-    ".AgentWorkShop/prompts",
-    "server/plugins-builtin",
-    "config.yml",
-    "nuxt.config.ts",
-    "tsconfig.json",
-    "uno.config.ts",
-    "docker-compose.yml",
-    ".env.example",
-    "README-zh.md",
-    "docs/cli.md",
-    "docs/plugins.md",
-    "docs/sdk.md",
-    "docs/tui.md",
-    "tui"
-  ],
-  "packageManager": "pnpm@11.9.0",
-  "engines": {
-    "node": ">=23.4.0"
-  },
-  "scripts": {
-    "dev": "node bin/aw.mjs dev",
-    "build": "node bin/aw.mjs build",
-    "start": "node bin/aw.mjs start",
-    "generate": "nuxt generate",
-    "preview": "node bin/aw.mjs start",
-    "cli": "node bin/aw.mjs",
-    "tui": "node tui/aw-tui.mjs",
-    "postinstall": "node scripts/home-bootstrap.mjs",
-    "prepublishOnly": "node bin/aw.mjs build",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "typecheck": "nuxt typecheck",
-    "prepare": "husky",
-    "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
-    "test:api-live": "node scripts/api-live-e2e.mjs",
-    "game:verify": "node scripts/verify-game.mjs",
-    "game:build-assets": "node scripts/build-player-sheet.mjs",
-    "game:build-wuwa": "node scripts/build-wuwa-assets.mjs",
-    "game:build-models": "node scripts/build-character-models.mjs",
-    "game:build-world": "node scripts/build-world-map.mjs",
-    "game:build-model3d": "node scripts/build-model-3d.mjs"
-  },
-  "lint-staged": {
-    "*.{js,mjs,cjs,ts,vue}": "eslint --fix"
-  },
-  "dependencies": {
-    "@ant-design-vue/nuxt": "^1.4.6",
-    "@ant-design/icons-vue": "^7.0.1",
-    "@anthropic-ai/claude-agent-sdk": "0.3.266",
-    "@earendil-works/pi-tui": "^0.84.4",
-    "@fontsource-variable/fraunces": "^5.3.0",
-    "@fontsource-variable/geist": "^5.3.0",
-    "@fontsource-variable/geist-mono": "^5.3.0",
-    "@fontsource-variable/inter": "^5.3.0",
-    "@fontsource/eb-garamond": "^5.3.0",
-    "@fontsource/ibm-plex-mono": "^5.3.0",
-    "@iconify-json/tabler": "^1.2.0",
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "@nuxtjs/i18n": "^9.0.0",
-    "@pinia/nuxt": "^0.11.0",
-    "@unocss/nuxt": "^66.0.0",
-    "@unocss/preset-attributify": "^66.0.0",
-    "@unocss/preset-icons": "^66.7.5",
-    "@unocss/preset-typography": "^66.0.0",
-    "@vueuse/core": "^13.0.0",
-    "@vueuse/nuxt": "^13.0.0",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/xterm": "^6.0.0",
-    "ant-design-vue": "^4.2.6",
-    "axios": "^1.7.9",
-    "echarts": "^5.6.0",
-    "h3": "2.0.1-rc.26",
-    "js-yaml": "^4.1.0",
-    "minio": "^8.0.7",
-    "modbus-serial": "^8.0.25",
-    "mqtt": "^5.15.2",
-    "node-opcua": "^2.178.0",
-    "nuxt": "^4.0.0",
-    "nuxt-auth-utils": "^0.5.0",
-    "pg": "^8.23.0",
-    "phaser": "^4.0.0",
-    "pinia": "^3.0.0",
-    "pinia-plugin-persistedstate": "^4.2.0",
-    "sqlite-vec": "^0.1.9",
-    "three": "^0.185.1",
-    "unocss": "^66.0.0",
-    "unplugin-icons": "^22.0.0",
-    "vue": "^3.5.13",
-    "vue-echarts": "^7.0.3",
-    "vue-router": "^4.5.0",
-    "zod": "^3.24.1"
-  },
-  "optionalDependencies": {
-    "onnxruntime-node": "^1.20.1"
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^19.6.1",
-    "@commitlint/config-conventional": "^19.6.0",
-    "@nuxt/eslint": "^1.0.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^26.2.0",
-    "@types/three": "^0.185.4",
-    "eslint": "^9.17.0",
-    "husky": "^9.1.7",
-    "lint-staged": "^15.3.0",
-    "pngjs": "^7.0.0",
-    "puppeteer-core": "^25.5.0",
-    "tsx": "^4.23.12",
-    "typescript": "^5.7.3",
-    "vue-tsc": "^3.3.10"
-  },
-  "pnpm": {
-    "ignoredBuiltDependencies": [
-      "@serialport/bindings-cpp"
-    ]
-  }
-}
+{
+  "name": "agentworkshop",
+  "version": "0.7.37",
+  "type": "module",
+  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "exports": {
+    ".": {
+      "types": "./sdk/index.d.mts",
+      "default": "./sdk/index.mjs"
+    },
+    "./sdk": {
+      "types": "./sdk/index.d.mts",
+      "default": "./sdk/index.mjs"
+    },
+    "./sdk/client": {
+      "types": "./sdk/client.d.mts",
+      "default": "./sdk/client.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "aw": "bin/aw.mjs",
+    "agentworkshop": "bin/aw.mjs"
+  },
+  "files": [
+    ".output",
+    "bin",
+    "cli",
+    "sdk",
+    "app",
+    "server",
+    "shared",
+    "i18n",
+    "public",
+    "scripts",
+    ".AgentWorkShop/prompts",
+    "server/plugins-builtin",
+    "config.yml",
+    "nuxt.config.ts",
+    "tsconfig.json",
+    "uno.config.ts",
+    "docker-compose.yml",
+    ".env.example",
+    "README-zh.md",
+    "docs/cli.md",
+    "docs/cli.en.md",
+    "docs/plugins.md",
+    "docs/plugins.en.md",
+    "docs/sdk.md",
+    "docs/sdk.en.md",
+    "docs/aml.md",
+    "docs/tui.md",
+    "docs/full-test-plan.md",
+    "docs/multi-harness-architecture.md",
+    "tui"
+  ],
+  "packageManager": "pnpm@11.9.0",
+  "engines": {
+    "node": ">=23.4.0"
+  },
+  "scripts": {
+    "dev": "node bin/aw.mjs dev",
+    "build": "node bin/aw.mjs build",
+    "start": "node bin/aw.mjs start",
+    "generate": "nuxt generate",
+    "preview": "node bin/aw.mjs start",
+    "cli": "node bin/aw.mjs",
+    "tui": "node tui/aw-tui.mjs",
+    "postinstall": "node scripts/home-bootstrap.mjs",
+    "prepublishOnly": "node bin/aw.mjs build",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "nuxt typecheck",
+    "docs:check": "node scripts/check-docs-sync.mjs",
+    "docs:dev": "cd docs/site && npx vitepress dev",
+    "docs:build": "cd docs/site && npx vitepress build",
+    "test:plugin-lifecycle": "node scripts/test-plugin-lifecycle.mjs",
+    "test:sdk-surface": "node scripts/test-sdk-surface.mjs",
+    "prepare": "husky",
+    "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
+    "test:api-live": "node scripts/api-live-e2e.mjs",
+    "game:verify": "node scripts/verify-game.mjs",
+    "game:build-assets": "node scripts/build-player-sheet.mjs",
+    "game:build-wuwa": "node scripts/build-wuwa-assets.mjs",
+    "game:build-models": "node scripts/build-character-models.mjs",
+    "game:build-world": "node scripts/build-world-map.mjs",
+    "game:build-model3d": "node scripts/build-model-3d.mjs"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts,vue}": "eslint --fix"
+  },
+  "dependencies": {
+    "@ant-design-vue/nuxt": "^1.4.6",
+    "@ant-design/icons-vue": "^7.0.1",
+    "@anthropic-ai/claude-agent-sdk": "0.3.266",
+    "@earendil-works/pi-tui": "^0.84.4",
+    "@fontsource-variable/fraunces": "^5.3.0",
+    "@fontsource-variable/geist": "^5.3.0",
+    "@fontsource-variable/geist-mono": "^5.3.0",
+    "@fontsource-variable/inter": "^5.3.0",
+    "@fontsource/eb-garamond": "^5.3.0",
+    "@fontsource/ibm-plex-mono": "^5.3.0",
+    "@iconify-json/tabler": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@nuxtjs/i18n": "^9.0.0",
+    "@pinia/nuxt": "^0.11.0",
+    "@unocss/nuxt": "^66.0.0",
+    "@unocss/preset-attributify": "^66.0.0",
+    "@unocss/preset-icons": "^66.7.5",
+    "@unocss/preset-typography": "^66.0.0",
+    "@vueuse/core": "^13.0.0",
+    "@vueuse/nuxt": "^13.0.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "ant-design-vue": "^4.2.6",
+    "axios": "^1.7.9",
+    "echarts": "^5.6.0",
+    "h3": "2.0.1-rc.26",
+    "js-yaml": "^4.1.0",
+    "minio": "^8.0.7",
+    "modbus-serial": "^8.0.25",
+    "mqtt": "^5.15.2",
+    "node-opcua": "^2.178.0",
+    "nuxt": "^4.0.0",
+    "nuxt-auth-utils": "^0.5.0",
+    "pg": "^8.23.0",
+    "phaser": "^4.0.0",
+    "pinia": "^3.0.0",
+    "pinia-plugin-persistedstate": "^4.2.0",
+    "sqlite-vec": "^0.1.9",
+    "three": "^0.185.1",
+    "unocss": "^66.0.0",
+    "unplugin-icons": "^22.0.0",
+    "vue": "^3.5.13",
+    "vue-echarts": "^7.0.3",
+    "vue-router": "^4.5.0",
+    "zod": "^3.24.1"
+  },
+  "optionalDependencies": {
+    "onnxruntime-node": "^1.20.1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.1",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@nuxt/eslint": "^1.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.2.0",
+    "@types/three": "^0.185.4",
+    "eslint": "^9.17.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.3.0",
+    "pngjs": "^7.0.0",
+    "puppeteer-core": "^25.5.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.7.3",
+    "vue-tsc": "^3.3.10"
+  },
+  "pnpm": {
+    "ignoredBuiltDependencies": [
+      "@serialport/bindings-cpp"
+    ]
+  }
+}

package/scripts/.mimosa/hook-status/sess_aeaecb58-8833-4b83-b93c-050467d21e03-d944d71bb3.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": "mimosa-hook-status/v1",
+  "recordedAt": "2026-09-12T02:04:56.653Z",
+  "sessionId": "sess_aeaecb58-8833-4b83-b93c-050467d21e03",
+  "event": "PostToolUse",
+  "toolName": "Write",
+  "file": "D:\\codes\\ABO\\AgentWorkShop\\docs\\full-test-plan.md",
+  "outcome": "clear",
+  "coverage": "complete",
+  "findingCount": 0,
+  "durationMs": 4,
+  "hostState": "hook_complete",
+  "reportHint": ".mimosa/reports/"
+}

package/scripts/_audit/aml-layout-diag.mjs

@@ -0,0 +1,83 @@
+/**
+ * /aml 布局错位定点定位 —— 复刻 review-fix-verify 的完整上下文
+ * (新建 browser context + 模态交互 + 多跳导航),然后打印祖先链与几何。
+ */
+import { existsSync } from 'node:fs'
+import puppeteer from 'puppeteer-core'
+
+const BASE = 'http://127.0.0.1:3111'
+const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
+const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+const EXEC = existsSync(EDGE) ? EDGE : CHROME
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const chainOf = `(el) => { const out = []; let e = el; while (e && e.tagName !== 'BODY') {
+  const r = e.getBoundingClientRect(); const cs = getComputedStyle(e)
+  out.push({ t: e.tagName + '.' + e.className.toString().split(' ').filter(c => !c.startsWith('css-')).slice(0, 3).join('.'),
+    top: Math.round(r.top), left: Math.round(r.left), w: Math.round(r.width), h: Math.round(r.height),
+    disp: cs.display, dir: cs.flexDirection, pos: cs.position })
+  e = e.parentElement } return out }`
+
+async function main() {
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox', '--hide-scrollbars'], defaultViewport: { width: 1680, height: 1050 } })
+  const lg = await fetch(`${BASE}/api/users/login`, {
+    method: 'POST', headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }),
+  }).then(r => r.json())
+  const token = lg.data.token
+
+  const ctx = await browser.createBrowserContext()
+  const page = await ctx.newPage()
+  await page.goto(`${BASE}/daq`, { waitUntil: 'domcontentloaded' })
+  await page.evaluate((t) => {
+    document.cookie = `token=${encodeURIComponent(t)}; path=/`
+    document.cookie = 'aw-theme=light; path=/'
+    // 与 review-fix-verify 一致的 pinia 持久化预置(唯一未复刻的变量)
+    localStorage.setItem('app', JSON.stringify({ isDark: false, sidebarCollapsed: false, accent: '', themeTouched: true }))
+  }, token)
+  await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle2' })
+  await sleep(900)
+  // 模态交互
+  await page.evaluate(() => {
+    const btns = [...document.querySelectorAll('button, .aw-pill, .line-pill')]
+    const b = btns.find(x => /添加|新建|add/i.test(x.textContent ?? ''))
+    b?.click()
+  })
+  await sleep(500)
+  await page.keyboard.press('Escape')
+  await sleep(500)
+  // 多跳
+  await page.goto(`${BASE}/`, { waitUntil: 'networkidle2' })
+  await sleep(1200)
+  await page.goto(`${BASE}/dcw`, { waitUntil: 'networkidle2' })
+  await sleep(400)
+  await page.goto(`${BASE}/aml`, { waitUntil: 'networkidle2' })
+  await sleep(2000)
+
+  const dump = await page.evaluate(`(() => {
+    const chainOf = ${chainOf}
+    const main = document.querySelector('.app-main')
+    const sider = document.querySelector('.app-sider')
+    const layouts = [...document.querySelectorAll('.ant-layout')].map(e => {
+      const r = e.getBoundingClientRect(); const cs = getComputedStyle(e)
+      return { cls: e.className.toString().slice(0, 50), top: Math.round(r.top), left: Math.round(r.left),
+        w: Math.round(r.width), h: Math.round(r.height), dir: cs.flexDirection, wrap: cs.flexWrap }
+    })
+    return {
+      docH: document.documentElement.scrollHeight,
+      layouts,
+      mainChain: chainOf(main),
+      siderChain: chainOf(sider),
+      sider: (() => { const r = sider?.getBoundingClientRect(); const cs = sider ? getComputedStyle(sider) : null
+        return sider ? { top: Math.round(r.top), left: Math.round(r.left), w: Math.round(r.width), h: Math.round(r.height),
+          display: cs.display, position: cs.position, flex: cs.flex, cssFloat: cs.cssFloat } : null })(),
+      layoutDisplay: (() => { const L = document.querySelector('.app-layout'); const cs = getComputedStyle(L)
+        return { display: cs.display, dir: cs.flexDirection, wrap: cs.flexWrap, w: Math.round(L.getBoundingClientRect().width) } })(),
+      mainParentHTMLHead: main?.parentElement?.outerHTML.slice(0, 260),
+    }
+  })()`)
+  console.log(JSON.stringify(dump, null, 1))
+  await browser.close()
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/scripts/_audit/bump-version.mjs

@@ -0,0 +1,51 @@
+// 发版版本号同步:把"当前版本"类声明改到 package.json 的版本
+// 只改 live 声明,不动历史记录(run 报告日期、能力交付表等)
+import { readFileSync, writeFileSync } from 'node:fs'
+import { join, sep } from 'node:path'
+
+const ROOT = process.cwd()
+const NEXT = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).version
+const PREV = process.argv[2] ?? '0.7.36'
+
+const JOBS = [
+  // [文件, 正则, 替换文本]
+  ['README-zh.md', /当前版本：\*\*v0\.7\.\d+\*\*/g, () => `当前版本：**v${NEXT}**`],
+  ['README.md', /Current version: \*\*v0\.7\.\d+\*\*/g, () => `Current version: **v${NEXT}**`],
+  ['docs/cli.md', /agentworkshop@0\.7\.\d+/g, () => `agentworkshop@${NEXT}`],
+  ['docs/cli.md', /\| 当前版本 \| `0\.7\.\d+`/, () => `| 当前版本 | \`${NEXT}\``],
+  ['docs/cli.en.md', /agentworkshop@0\.7\.\d+/g, () => `agentworkshop@${NEXT}`],
+  ['docs/cli.en.md', /\| Current version \| `0\.7\.\d+`/, () => `| Current version | \`${NEXT}\``],
+  ['docs/sdk.md', /`version`,当前 0\.7\.\d+\)/, () => `\`version\`,当前 ${NEXT})`],
+  ['docs/sdk.en.md', /`package\.json`, currently 0\.7\.\d+\)/, () => `\`package.json\`, currently ${NEXT})`],
+  ['docs/plugins.md', /对应当前版本 \*\*v0\.7\.\d+\*\*/, () => `对应当前版本 **v${NEXT}**`],
+  ['docs/plugins.en.md', /describes \*\*v0\.7\.\d+\*\*/, () => `describes **v${NEXT}**`],
+  ['docs/full-test-plan.md', /撰写时基线 v0\.7\.\d+/, () => `撰写时基线 v${PREV}`],
+]
+
+// 站点孪生文件必须与单一事实源逐字节一致:同步复制
+const TWINS = [
+  ['docs/cli.md', 'docs/site/cli/index.md'],
+  ['docs/cli.en.md', 'docs/site/en/cli/index.md'],
+  ['docs/plugins.md', 'docs/site/plugins/guide.md'],
+  ['docs/plugins.en.md', 'docs/site/en/plugins/guide.md'],
+  ['docs/sdk.md', 'docs/site/sdk/guide.md'],
+  ['docs/sdk.en.md', 'docs/site/en/sdk/guide.md'],
+]
+
+let changed = 0
+for (const [file, re, to] of JOBS) {
+  const p = join(ROOT, file.split('/').join(sep))
+  let text
+  try { text = readFileSync(p, 'utf8') } catch { console.log(`  跳过(不存在) ${file}`); continue }
+  const before = text
+  text = text.replace(re, to)
+  if (text !== before) { writeFileSync(p, text, 'utf8'); changed++; console.log(`  ✔ ${file}`) }
+}
+for (const [src, dst] of TWINS) {
+  const a = readFileSync(join(ROOT, src.split('/').join(sep)), 'utf8')
+  const p = join(ROOT, dst.split('/').join(sep))
+  const b = readFileSync(p, 'utf8')
+  if (a !== b) { writeFileSync(p, a, 'utf8'); changed++; console.log(`  ⇄ 孪生同步 ${dst}`) }
+}
+
+console.log(`\n版本 → ${NEXT}(原 live 声明 ${PREV});改动 ${changed} 处`)

package/scripts/_audit/channel-inspect.mjs

@@ -0,0 +1,49 @@
+/**
+ * channel-inspect.mjs —— 按名字看某个 Channel 的任务与消息(排障常用)
+ * 用法:node scripts/_audit/channel-inspect.mjs --base http://127.0.0.1:3112 --match 矩阵-A [--full]
+ */
+const arg = (k, d) => {
+  const i = process.argv.indexOf(`--${k}`)
+  return i > 0 && process.argv[i + 1] ? process.argv[i + 1] : d
+}
+const BASE = arg('base', 'http://127.0.0.1:3112').replace(/\/$/, '')
+const MATCH = arg('match', '')
+const FULL = process.argv.includes('--full')
+
+let TOKEN = null
+const api = async (method, path, { body } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (TOKEN) headers.authorization = `Bearer ${TOKEN}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+const data = r => r?.data ?? {}
+
+TOKEN = data(await api('POST', '/api/users/login', { body: { email: 'plant@awshop.local', password: 'Plant!2026' } })).token
+if (!TOKEN) { console.error('✖ 登录失败'); process.exitCode = 2; throw new Error('login') }
+
+const raw = data(await api('GET', '/api/workshop/channels'))
+const chans = Array.isArray(raw) ? raw : (raw.channels ?? [])
+const targets = MATCH ? chans.filter(c => new RegExp(MATCH).test(c.name)) : chans
+if (!targets.length) {
+  console.log(`没有匹配「${MATCH}」的 Channel。现有:${chans.map(c => c.name).join(' | ')}`)
+  process.exitCode = 1
+}
+else {
+  for (const ch of targets) {
+    console.log(`\n═══ ${ch.name}  (${ch.id})  lead=${String(ch.leadAgentId).slice(0, 8)} ═══`)
+    const tasks = data(await api('GET', `/api/workshop/channels/${ch.id}/tasks`)) ?? []
+    for (const t of (Array.isArray(tasks) ? tasks : [])) {
+      console.log(`  TASK ${t.id.slice(0, 8)} ${String(t.state).padEnd(10)} progress=${String(t.progress ?? 0).padEnd(4)} retry=${t.retryCount ?? 0} history=${(t.history ?? []).length} assignee=${String(t.assigneeId).slice(0, 8)}  ${t.title}`)
+    }
+    const m = data(await api('GET', `/api/workshop/channels/${ch.id}/messages?limit=60`))
+    const msgs = Array.isArray(m) ? m : (m.messages ?? [])
+    console.log(`  ── 消息 ${msgs.length} 条 ──`)
+    for (const x of msgs.slice(-10)) {
+      const text = (x.parts ?? []).map(p => String(p.text ?? '')).join(' ').replace(/\s+/g, ' ')
+      const meta = x.metadata ? ` meta=${JSON.stringify(x.metadata)}` : ''
+      console.log(`  · ${(x.kind ?? x.role ?? '?')}${meta}`)
+      console.log(`    ${FULL ? text : text.slice(0, 400)}`)
+    }
+  }
+}