agentworkshop 0.7.61 → 0.7.63

package/docs/full-test-plan.md

@@ -1,6 +1,6 @@
 # AgentWorkShop 全功能测试流程 Plan
 
-> 版本无关的常备测试手册（撰写时基线 v0.7.48）。用途：后续直接指令 agent
+> 版本无关的常备测试手册（撰写时基线 v0.7.62）。用途：后续直接指令 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.63**. `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.63**。`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.63) —
 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.63)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `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.61",
-  "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.63",
+  "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/api/workshop/analysis/[id].patch.ts

@@ -1,100 +1,100 @@
-/**
- * PATCH /api/workshop/analysis/:id —— 人工修订分析报告(v27 编辑面)。
- * 权限:admin,或对该报告产线有「可操控」(operate)的用户;readonly/无授权 403。
- * 可编辑字段:title/category/summary/conclusions/report/metrics/recipe_id/recipe_version/
- * window_from/window_to/data_sources(缺省 = 保留原值);修订归因固化进 updated_*。
- * Agent 面仍无改删 —— 编辑是带审计的人类管理操作(recordOps analysis.update)。
- */
-import { getQuery, getRouterParam, readBody } from 'h3'
-import { resolveUser } from '@/server/api/workshop/caller'
-import { defineApiHandler } from '@/server/utils/response'
-import { AppError } from '@/server/utils/errors'
-import { lineMode } from '@/server/services/workshop/permissions'
-import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
-import { getDcwRecipeRepo } from '@/server/services/workshop/dcw/dcw-recipe.repo'
-import { recordOps } from '@/server/services/workshop/ops/ops'
-
-export default defineApiHandler(async (event) => {
-  const user = resolveUser(event)
-  const id = getRouterParam(event, 'id')!
-  const repo = getAnalysisRepo()
-  const report = repo.get(id)
-  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
-
-  // 编辑权限:admin 或产线 operate(readonly/无授权不可改)
-  const isAdmin = user.role === 'admin'
-  if (!isAdmin && (!report.lineId || lineMode(user, report.lineId) !== 'operate')) {
-    throw new AppError(403, 'ANALYSIS_FORBIDDEN', `无权修订该分析报告:需要产线「可操控」权限或 admin(报告产线 ${report.lineName || report.lineId || '-'})`)
-  }
-
-  const body = (await readBody<Record<string, unknown>>(event)) ?? {}
-  const str = (k: string): string | undefined => (body[k] === undefined ? undefined : String(body[k] ?? '').trim())
-  const title = str('title')
-  const summary = str('summary')
-  if (title !== undefined && !title) throw new AppError(400, 'VALIDATION_ERROR', 'title 不能为空')
-  if (summary !== undefined && !summary) throw new AppError(400, 'VALIDATION_ERROR', 'summary 不能为空')
-
-  // 配方校验(与保存面同口径:存在且归属该产线)
-  const recipeId = str('recipe_id')
-  if (recipeId) {
-    const recipe = getDcwRecipeRepo().list().find(r => r.id === recipeId)
-    if (!recipe) throw new AppError(404, 'NOT_FOUND', `配方不存在: ${recipeId}`)
-    if (recipe.lineId && report.lineId && recipe.lineId !== report.lineId) {
-      throw new AppError(400, 'VALIDATION_ERROR', `配方「${recipe.name}」不属于该报告的产线`)
-    }
-  }
-
-  // 时间窗归一:列内为本地 ISO(平台 toISOString 补丁),外部 Z 格式/epoch ms 归一后入库
-  const timeArg = (k: string): string | null | undefined => {
-    if (body[k] === undefined) return undefined
-    const raw = String(body[k] ?? '').trim()
-    if (!raw) return null
-    const ms = /^\d{10,}$/.test(raw) ? Number(raw) : Date.parse(raw)
-    if (!Number.isFinite(ms)) throw new AppError(400, 'VALIDATION_ERROR', `${k} 时间格式无效(ISO 8601 或 epoch ms)`)
-    return new Date(ms).toISOString()
-  }
-
-  const conclusions = body.conclusions === undefined
-    ? undefined
-    : (Array.isArray(body.conclusions) ? body.conclusions : String(body.conclusions ?? '').split('\n'))
-        .map((x: unknown) => String(x).replace(/^[-*\d.\s]+/, '').trim())
-        .filter(Boolean)
-  let metrics: Record<string, unknown> | undefined
-  if (body.metrics !== undefined && body.metrics !== null && String(body.metrics).trim() !== '') {
-    try {
-      metrics = typeof body.metrics === 'object' && !Array.isArray(body.metrics)
-        ? (body.metrics as Record<string, unknown>)
-        : JSON.parse(String(body.metrics))
-    }
-    catch {
-      throw new AppError(400, 'VALIDATION_ERROR', 'metrics 需为 JSON 对象(或留空保留原值)')
-    }
-  }
-
-  const updated = repo.update(id, {
-    title: title ?? undefined,
-    category: str('category') ?? undefined,
-    summary: summary ?? undefined,
-    conclusions,
-    report: body.report === undefined ? undefined : String(body.report ?? ''),
-    metrics,
-    recipeId,
-    recipeVersion: str('recipe_version'),
-    windowFrom: timeArg('window_from'),
-    windowTo: timeArg('window_to'),
-    dataSources: str('data_sources'),
-  }, { id: user.id, name: user.name })
-  if (!updated) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
-
-  try {
-    recordOps({
-      actor: user.id, actorName: user.name, actorKind: 'user',
-      action: 'analysis.update', kind: 'analysis', targetKind: 'analysis', targetId: id,
-      lineId: updated.lineId, recipeId: updated.recipeId,
-      summary: `人工修订分析报告「${updated.title}」(产线「${updated.lineName || updated.lineId || '-'}」)`,
-    })
-  }
-  catch { /* 审计失败不阻断 */ }
-
-  return { report: updated }
-})
+/**
+ * PATCH /api/workshop/analysis/:id —— 人工修订分析报告(v27 编辑面)。
+ * 权限:admin,或对该报告产线有「可操控」(operate)的用户;readonly/无授权 403。
+ * 可编辑字段:title/category/summary/conclusions/report/metrics/recipe_id/recipe_version/
+ * window_from/window_to/data_sources(缺省 = 保留原值);修订归因固化进 updated_*。
+ * Agent 面仍无改删 —— 编辑是带审计的人类管理操作(recordOps analysis.update)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { lineMode } from '@/server/services/workshop/permissions'
+import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
+import { getDcwRecipeRepo } from '@/server/services/workshop/dcw/dcw-recipe.repo'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id')!
+  const repo = getAnalysisRepo()
+  const report = repo.get(id)
+  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
+
+  // 编辑权限:admin 或产线 operate(readonly/无授权不可改)
+  const isAdmin = user.role === 'admin'
+  if (!isAdmin && (!report.lineId || lineMode(user, report.lineId) !== 'operate')) {
+    throw new AppError(403, 'ANALYSIS_FORBIDDEN', `无权修订该分析报告:需要产线「可操控」权限或 admin(报告产线 ${report.lineName || report.lineId || '-'})`)
+  }
+
+  const body = (await readBody<Record<string, unknown>>(event)) ?? {}
+  const str = (k: string): string | undefined => (body[k] === undefined ? undefined : String(body[k] ?? '').trim())
+  const title = str('title')
+  const summary = str('summary')
+  if (title !== undefined && !title) throw new AppError(400, 'VALIDATION_ERROR', 'title 不能为空')
+  if (summary !== undefined && !summary) throw new AppError(400, 'VALIDATION_ERROR', 'summary 不能为空')
+
+  // 配方校验(与保存面同口径:存在且归属该产线)
+  const recipeId = str('recipe_id')
+  if (recipeId) {
+    const recipe = getDcwRecipeRepo().list().find(r => r.id === recipeId)
+    if (!recipe) throw new AppError(404, 'NOT_FOUND', `配方不存在: ${recipeId}`)
+    if (recipe.lineId && report.lineId && recipe.lineId !== report.lineId) {
+      throw new AppError(400, 'VALIDATION_ERROR', `配方「${recipe.name}」不属于该报告的产线`)
+    }
+  }
+
+  // 时间窗归一:列内为本地 ISO(平台 toISOString 补丁),外部 Z 格式/epoch ms 归一后入库
+  const timeArg = (k: string): string | null | undefined => {
+    if (body[k] === undefined) return undefined
+    const raw = String(body[k] ?? '').trim()
+    if (!raw) return null
+    const ms = /^\d{10,}$/.test(raw) ? Number(raw) : Date.parse(raw)
+    if (!Number.isFinite(ms)) throw new AppError(400, 'VALIDATION_ERROR', `${k} 时间格式无效(ISO 8601 或 epoch ms)`)
+    return new Date(ms).toISOString()
+  }
+
+  const conclusions = body.conclusions === undefined
+    ? undefined
+    : (Array.isArray(body.conclusions) ? body.conclusions : String(body.conclusions ?? '').split('\n'))
+        .map((x: unknown) => String(x).replace(/^[-*\d.\s]+/, '').trim())
+        .filter(Boolean)
+  let metrics: Record<string, unknown> | undefined
+  if (body.metrics !== undefined && body.metrics !== null && String(body.metrics).trim() !== '') {
+    try {
+      metrics = typeof body.metrics === 'object' && !Array.isArray(body.metrics)
+        ? (body.metrics as Record<string, unknown>)
+        : JSON.parse(String(body.metrics))
+    }
+    catch {
+      throw new AppError(400, 'VALIDATION_ERROR', 'metrics 需为 JSON 对象(或留空保留原值)')
+    }
+  }
+
+  const updated = repo.update(id, {
+    title: title ?? undefined,
+    category: str('category') ?? undefined,
+    summary: summary ?? undefined,
+    conclusions,
+    report: body.report === undefined ? undefined : String(body.report ?? ''),
+    metrics,
+    recipeId,
+    recipeVersion: str('recipe_version'),
+    windowFrom: timeArg('window_from'),
+    windowTo: timeArg('window_to'),
+    dataSources: str('data_sources'),
+  }, { id: user.id, name: user.name })
+  if (!updated) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
+
+  try {
+    recordOps({
+      actor: user.id, actorName: user.name, actorKind: 'user',
+      action: 'analysis.update', kind: 'analysis', targetKind: 'analysis', targetId: id,
+      lineId: updated.lineId, recipeId: updated.recipeId,
+      summary: `人工修订分析报告「${updated.title}」(产线「${updated.lineName || updated.lineId || '-'}」)`,
+    })
+  }
+  catch { /* 审计失败不阻断 */ }
+
+  return { report: updated }
+})