agentworkshop 0.7.62 → 0.7.64

package/docs/full-test-plan.md

@@ -1,6 +1,6 @@
 # AgentWorkShop 全功能测试流程 Plan
 
-> 版本无关的常备测试手册（撰写时基线 v0.7.48）。用途：后续直接指令 agent
+> 版本无关的常备测试手册（撰写时基线 v0.7.63）。用途：后续直接指令 agent
 > 「按 docs/full-test-plan.md 执行 Phase 0–N」即可完成全功能测试。
 > 断言数为历史全绿基线（2026-09 上旬各轮验收），以脚本实际输出为准；括号内数字仅用于识别明显回退。
 > 最后核对：2026-09-12（脚本清单逐一经 `scripts/` 实存核对）。

package/docs/plugins.en.md

@@ -9,7 +9,7 @@
 >
 > Applies to: plugin system v2 has been available since **v0.7.29** (frontend component
 > injection / plugin settings / plugin i18n / runtime services surface); this document
-> describes **v0.7.58**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.64**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.7.58**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.7.64**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 

package/docs/sdk.en.md

@@ -7,7 +7,7 @@
 
 **SDK version constants**: server-side `SDK_VERSION = '0.3.0'`, browser-side `CLIENT_SDK_VERSION = '0.3.0'`.
 These two constants are the **interface version of the SDK itself** and evolve **independently**
-from the npm package version (the `version` field in `package.json`, currently 0.7.58) —
+from the npm package version (the `version` field in `package.json`, currently 0.7.64) —
 them being out of sync is expected. Never use `SDK_VERSION` to infer the package version, or the reverse.
 **Module format**: ESM only (only `import` / `export`; there is no CJS entry).
 **Types**: `sdk/index.d.mts` and `sdk/client.d.mts` ship with the package, so TypeScript projects

package/docs/sdk.md

@@ -5,7 +5,7 @@
 > 零第三方运行时依赖,Node ≥ 23.4 与现代浏览器双端可用。
 
 **SDK 版本常量**:服务端 `SDK_VERSION = '0.3.0'`,浏览器端 `CLIENT_SDK_VERSION = '0.3.0'`。
-这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.58)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.64)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/package.json

@@ -1,181 +1,181 @@
-{
-  "name": "agentworkshop",
-  "version": "0.7.62",
-  "type": "module",
-  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
-  "license": "Apache-2.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",
-    "mcp",
-    "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/mcp.md",
-    "docs/mcp.en.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": "node scripts/typecheck.mjs",
-    "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",
-    "test:twin-provider": "tsx --test tests/aml-twin-provider-registry.test.ts",
-    "test:unit": "tsx --tsconfig .nuxt/tsconfig.server.json --test --test-force-exit tests/*.test.ts",
-    "prepare": "husky",
-    "test:api-live": "node scripts/api-live-e2e.mjs",
-    "test:mcp": "tsx --tsconfig .nuxt/tsconfig.server.json --test --test-force-exit tests/aw-mcp-server.test.ts",
-    "test:skills": "node scripts/test-aw-skills.mjs",
-    "test:mcp-live": "node scripts/_audit/aw-mcp-live-e2e.mjs",
-    "test:skills-guided": "node scripts/_audit/skills-guided-e2e.mjs",
-    "ui:seed": "node scripts/ui/seed-demo.mjs",
-    "ui:shots": "node scripts/ui/shots.mjs",
-    "ui:audit": "node scripts/ui/audit-layout.mjs",
-    "ui:verify": "node scripts/ui/verify-responsive.mjs",
-    "ui:verify-nav": "node scripts/ui/verify-nav.mjs",
-    "readme:lint": "node scripts/ui/md-lint.mjs README.md README-zh.md",
-    "readme:assets": "node scripts/ui/readme-assets.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",
-    "serialport": "^13.0.0"
-  },
-  "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/pg": "^8.23.1",
-    "@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.64",
+  "type": "module",
+  "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
+  "license": "Apache-2.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",
+    "mcp",
+    "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/mcp.md",
+    "docs/mcp.en.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": "node scripts/typecheck.mjs",
+    "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",
+    "test:twin-provider": "tsx --test tests/aml-twin-provider-registry.test.ts",
+    "test:unit": "tsx --tsconfig .nuxt/tsconfig.server.json --test --test-force-exit tests/*.test.ts",
+    "prepare": "husky",
+    "test:api-live": "node scripts/api-live-e2e.mjs",
+    "test:mcp": "tsx --tsconfig .nuxt/tsconfig.server.json --test --test-force-exit tests/aw-mcp-server.test.ts",
+    "test:skills": "node scripts/test-aw-skills.mjs",
+    "test:mcp-live": "node scripts/_audit/aw-mcp-live-e2e.mjs",
+    "test:skills-guided": "node scripts/_audit/skills-guided-e2e.mjs",
+    "ui:seed": "node scripts/ui/seed-demo.mjs",
+    "ui:shots": "node scripts/ui/shots.mjs",
+    "ui:audit": "node scripts/ui/audit-layout.mjs",
+    "ui:verify": "node scripts/ui/verify-responsive.mjs",
+    "ui:verify-nav": "node scripts/ui/verify-nav.mjs",
+    "readme:lint": "node scripts/ui/md-lint.mjs README.md README-zh.md",
+    "readme:assets": "node scripts/ui/readme-assets.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",
+    "serialport": "^13.0.0"
+  },
+  "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/pg": "^8.23.1",
+    "@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/e2e-plc-plugin-closedloop.mjs

@@ -535,7 +535,7 @@ console.log('\n── H Harness 集成面 ──')
   const names = (list?.json?.data?.tools ?? list?.json?.tools ?? []).map(t => t?.name)
   // rag 侧工具面已收敛为单入口 kb_agent(+kb_agent_status);diag 侧仍是 diag_run/diag_status
   for (const t of ['kb_agent', 'kb_agent_status', 'diag_run', 'diag_status']) ok(names.includes(t), `omp 执行器工具清单含 ${t}`)
-  for (const t of ['daq_query', 'dcw_control', 'dcw_judge', 'dcw_read', 'line_context']) ok(names.includes(t), `omp 执行器工业工具含 ${t}`)
+  for (const t of ['daq_query', 'dcw_control', 'dcw_judge', 'line_context']) ok(names.includes(t), `omp 执行器工业工具含 ${t}`)
   const ctxT = await invoke(exec, 'line_context', {}, 60000)
   ok(!resultText(ctxT).startsWith('工具') || resultText(ctxT).length > 0, 'line_context 可用(工业链路)', resultText(ctxT).slice(0, 60))
 }

package/server/plugins-builtin/diag-bridge/host/diagnosis.mjs

@@ -5,10 +5,15 @@
 import { baseOf, harnessOf, jpost, maxMinutesOf, maxTurnsOf, runKey, runningOfLine, short } from './helpers.mjs'
 import { snapshotCore } from './snapshot.mjs'
 import { startingLines } from './constants.mjs'
+import { defaultQuestionFor, resolveBridgeIntent } from './intents.mjs'
 
-export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source, dataPath, dataPaths, harness, agentId, channelId }) {
+export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source, dataPath, dataPaths, harness, agentId, channelId, analysisIntent, model, permissionMode }) {
   const base = baseOf(ctx)
   if (!base) return { ok: false, error: 'diag.base_url 非法(仅允许 http/https 且 host 为 127.0.0.1/localhost)。' }
+  const intent = resolveBridgeIntent(analysisIntent)
+  if (analysisIntent && String(analysisIntent).trim() && !intent) {
+    return { ok: false, error: `未知分析意图: ${String(analysisIntent)}(支持 deep-diagnosis/stability-report/quick-screen/doe-analysis/experience-mining/optimizer-campaign)` }
+  }
   if (startingLines.has(line)) return { ok: false, error: `产线 ${line} 已有诊断正在启动,请稍后再试。` }
   const existing = runningOfLine(ctx, line)
   if (existing) return { ok: false, error: `产线 ${line} 已有运行中的诊断(run_id=${existing.id}),请稍后用 diag_status 查询。` }
@@ -19,7 +24,8 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
       snap = await snapshotCore(ctx, line, fromMs, toMs)
       if (!snap.ok) return { ok: false, error: snap.error }
     }
-    const q = question || `${line} 产线该时窗数据深度根因诊断`
+    // 按情景注入业务提示词:调用方显式 question 优先,否则用意图目录的模板(分析语义在此,执行解耦在 IDD)
+    const q = question || defaultQuestionFor(intent, { line, fromMs, toMs })
     const sceneName = scene || `${line}_diag`
     // v2.1:统一走 IDD 任务管理面 /api/diagnosis/tasks——接收即返 task_id,
     // 诊断在 IDD 后台线程执行(内部 start+execute),Channel 绝不等待。
@@ -32,6 +38,9 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
       sceneName,
       userQuestion: q,
       harness: harness || harnessOf(ctx), // 缺省落 claude 引擎会因无 key 失败,必须显式(系统配置 plugins.diag-bridge.harness → kv → omp;diag_run 可按次覆盖)
+      ...(intent && intent !== 'deep-diagnosis' ? { analysisIntent: intent } : {}), // 分析意图透传(缺省意图不传,由 IDD 兜底)
+      ...(model ? { model: String(model) } : {}), // 引擎模型按次覆盖(合法性由 IDD validateEngineOption 校验,不合法 400)
+      ...(permissionMode ? { permissionMode: String(permissionMode) } : {}),
       enhancement: 'off',
       reportLanguage: 'zh',
       maxTurns: maxTurnsOf(ctx), // 修复循环会加转数;150 不够走完全管线
@@ -42,6 +51,7 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
     if (!runId) return { ok: false, error: `tasks 响应缺少 data.task_id: ${short(started)}` }
     ctx.kv.set(runKey(runId), {
       line, fromMs, toMs, question: q, scene: sceneName,
+      intent: intent || 'deep-diagnosis',
       status: 'running', createdAt: Date.now(), source,
       csvPath: snap.csvPath,
       files: Array.isArray(dataPaths) ? dataPaths.length : 0,
@@ -49,7 +59,7 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
       // 归因:发起 Agent 完成后的结果回执靠它寻址(平台通告面 deliver)
       agentId: agentId || '', channelId: channelId || '',
     })
-    return { ok: true, runId, name, csvPath: snap.csvPath, rows: snap.rows, nodes: snap.nodes, files: Array.isArray(dataPaths) ? dataPaths.length : 0 }
+    return { ok: true, runId, name, csvPath: snap.csvPath, rows: snap.rows, nodes: snap.nodes, files: Array.isArray(dataPaths) ? dataPaths.length : 0, intent: intent || 'deep-diagnosis', question: q }
   }
   catch (err) {
     return { ok: false, error: `发起诊断失败: ${err?.message ?? err}` }

package/server/plugins-builtin/diag-bridge/host/intents.mjs

@@ -0,0 +1,62 @@
+/**
+ * 分析意图目录(diag-bridge 侧镜像)。
+ *
+ * ⚠️ 权威源在 IDD:`app/backend/src/engine/claude-client.mjs` 的 ANALYSIS_INTENTS
+ * (每个意图 = 一个 skill 协议,buildIntentDirective 生成绑定指令,由 IDD 的 harness 执行)。
+ * 本目录只是**调用面镜像**:给 diag_run 提供 enum 校验、中文标签与按情景的缺省提问模板
+ * (数据分析业务语义在此注入,执行完全解耦在 IDD)。IDD 对未知意图 400 拒绝,不会静默降级。
+ */
+
+/** 各意图的缺省提问模板(按任务情景注入给 IDD harness 的业务提示词)。
+ *  line=产线标识;win=可读时窗描述(缺省时可空)。 */
+const QUESTION_TEMPLATES = {
+  'deep-diagnosis': ({ line, win }) =>
+    `${line} 产线${win}数据深度根因诊断:定位异常根因,给出证据链与修复建议`,
+  'stability-report': ({ line, win }) =>
+    `${line} 产线${win}运行稳定性报告:给出综合评分与等级、各参数稳态表现(均值/波动/趋势)、问题清单与运行建议;不需要根因分析`,
+  'quick-screen': ({ line, win }) =>
+    `${line} 产线${win}数据快速筛查:识别越限/漂移/冻结/卡死等异常,按严重度给出关注点清单,产出筛查报告与 HTML 看板;不做深度根因分析`,
+  'doe-analysis': ({ line, win }) =>
+    `${line} 产线${win}DOE 试验数据分析:识别因子与响应,给出因子效应、显著性判断与最优工况组合建议;若数据不含多因子试验结构,请在报告中明确说明数据局限`,
+  'experience-mining': ({ line, win }) =>
+    `${line} 产线${win}数据调参经验挖掘:总结可复用的调整经验(参数方向、幅度、生效条件与反例),按结构化经验条目输出,供知识库沉淀`,
+  'optimizer-campaign': ({ line, win }) =>
+    `${line} 产线${win}数据优化战役:基于数据确定优化目标与约束,执行寻优迭代并汇报每轮目标值变化,最终给出推荐工况与预期收益`,
+}
+
+/** 意图元数据(label 给审批卡/回执用;skill 仅供诊断对账,执行由 IDD 自主) */
+export const ANALYSIS_INTENTS = {
+  'deep-diagnosis': { label: '深度根因诊断', skill: 'industrial-analysis-auto', defaultPolicy: true },
+  'stability-report': { label: '产线稳定报告', skill: 'industrial-line-stability-report' },
+  'quick-screen': { label: '快速筛查', skill: 'industrial-sentinel' },
+  'doe-analysis': { label: 'DOE 试验分析', skill: 'industrial-doe-analyzer' },
+  'experience-mining': { label: '调参经验挖掘', skill: 'industrial-tuning-memory' },
+  'optimizer-campaign': { label: '优化战役', skill: 'industrial-optimizer-loop' },
+}
+
+/** 归一化:空/未知 → null(空=缺省 deep-diagnosis 由 IDD 兜底;未知由调用方报错) */
+export function resolveBridgeIntent(value) {
+  const v = String(value ?? '').trim()
+  if (!v) return 'deep-diagnosis'
+  return Object.prototype.hasOwnProperty.call(ANALYSIS_INTENTS, v) ? v : null
+}
+
+export function intentLabel(intent) {
+  return ANALYSIS_INTENTS[intent]?.label ?? intent
+}
+
+/** 按情景生成缺省提问(业务提示词注入点;caller 显式 question 优先) */
+export function defaultQuestionFor(intent, { line, fromMs, toMs } = {}) {
+  const tpl = QUESTION_TEMPLATES[intent] ?? QUESTION_TEMPLATES['deep-diagnosis']
+  const win = fromMs && toMs && toMs > fromMs
+    ? `${new Date(fromMs).toISOString().slice(0, 16)} ~ ${new Date(toMs).toISOString().slice(0, 16)} 时窗`
+    : '该时窗'
+  return tpl({ line: line || 'offline-data', win })
+}
+
+/** diag_run 参数面的 enum 说明(工具描述用;一行一意图) */
+export function intentCatalogText() {
+  return Object.entries(ANALYSIS_INTENTS)
+    .map(([id, m]) => `${id}=${m.label}`)
+    .join(';')
+}