agentworkshop 0.7.41 → 0.7.46

package/app/utils/builtin-catalog.ts

@@ -0,0 +1,104 @@
+/**
+ * 内置目录/种子的展示层翻译映射。
+ *
+ * 背景:模板目录(shared/daq-protocol、dcw-protocol)与内置种子(模板/编组/Channel 模板/
+ * 插件 manifest)的 name/description 是服务端写入的中文数据,DB 记录不做翻译;
+ * 但展示层可以按**稳定 key/id** 命中 i18n 词条 —— 未命中(用户自建/改名)回退原始名。
+ * 词条在 locale 的 `tplCatalog` / `builtinSeeds` / `plugins` 命名空间。
+ */
+
+/** 数采/智控模板目录的稳定 key(shared 协议目录) */
+export const TPL_CATALOG_IDS = new Set([
+  'temp-tc',
+  'pressure-tx',
+  'tension-cell',
+  'line-encoder',
+  'vision-cam',
+  'power-meter',
+  'thickness-scan',
+  'ccd-image',
+  'temp-sp',
+  'speed-sp',
+  'tension-sp',
+  'pressure-sp',
+])
+
+/** 内置 Agent 模板 id → 名称词条(server/db DEFAULT_AGENT_TEMPLATES + aml-team-seeds) */
+export const SEED_NAME_KEYS: Record<string, string> = {
+  'tpl-default-lead': 'builtinSeeds.tplDefaultLead',
+  'tpl-default-backend': 'builtinSeeds.tplDefaultBackend',
+  'tpl-default-frontend': 'builtinSeeds.tplDefaultFrontend',
+  'tpl-default-qa': 'builtinSeeds.tplDefaultQa',
+  'tpl-default-docs': 'builtinSeeds.tplDefaultDocs',
+  'tpl-scenario-payment-lead': 'builtinSeeds.tplScenarioPaymentLead',
+  'tpl-aml-lead': 'builtinSeeds.tplAmlLead',
+  'tpl-aml-data': 'builtinSeeds.tplAmlData',
+  'tpl-aml-trainer': 'builtinSeeds.tplAmlTrainer',
+  'tpl-aml-eval': 'builtinSeeds.tplAmlEval',
+  'team-default-fullstack': 'builtinSeeds.teamDefaultFullstack',
+  'team-default-docs': 'builtinSeeds.teamDefaultDocs',
+  'team-aml-shadow': 'builtinSeeds.teamAmlShadow',
+  'chtpl-default-fullstack': 'builtinSeeds.chtplDefaultFullstack',
+  'chtpl-default-review': 'builtinSeeds.chtplDefaultReview',
+  'chtpl-preset-optical-film': 'builtinSeeds.chtplPresetOpticalFilm',
+  'chtpl-preset-extrusion': 'builtinSeeds.chtplPresetExtrusion',
+}
+
+/** 内置 Channel 模板 id → 描述/场景预览词条 */
+export const SEED_EXTRA_KEYS: Record<string, { desc?: string, scenario?: string }> = {
+  'chtpl-default-fullstack': { desc: 'builtinSeeds.chtplDefaultFullstackDesc', scenario: 'builtinSeeds.chtplDefaultFullstackScenario' },
+  'chtpl-default-review': { desc: 'builtinSeeds.chtplDefaultReviewDesc', scenario: 'builtinSeeds.chtplDefaultReviewScenario' },
+  'chtpl-preset-optical-film': { desc: 'builtinSeeds.chtplPresetOpticalFilmDesc', scenario: 'builtinSeeds.chtplPresetOpticalFilmScenario' },
+  'chtpl-preset-extrusion': { desc: 'builtinSeeds.chtplPresetExtrusionDesc', scenario: 'builtinSeeds.chtplPresetExtrusionScenario' },
+}
+
+/** 插件名 → 描述词条(manifest description 是服务端文件数据) */
+export const PLUGIN_DESC_KEYS: Record<string, string> = {
+  'line-sentinel': 'plugins.descLineSentinel',
+  'ops-notifier': 'plugins.descOpsNotifier',
+  'sample-insight': 'plugins.descSampleInsight',
+  'diag-bridge': 'plugins.descDiagBridge',
+  'rag-bridge': 'plugins.descRagBridge',
+  'serial-bridge': 'plugins.descSerialBridge',
+}
+
+type NameLike = { key?: string, id?: string, name: string }
+
+/** 内置角色/设备模型 id → 名称/提示词条(useCharacterAssets 内置目录;扫描项回退文件名) */
+export const TOWN_MODEL_KEYS: Record<string, { name: string, hint?: string }> = {
+  'knight': { name: 'builtinSeeds.mKnight' },
+  'mage': { name: 'builtinSeeds.mMage' },
+  'bot': { name: 'builtinSeeds.mBot' },
+  'hero-3d': { name: 'builtinSeeds.mHero3d', hint: 'builtinSeeds.mHero3dHint' },
+  'yangyang-walk': { name: 'builtinSeeds.mYangyang', hint: 'builtinSeeds.mYangyangHint' },
+  'device-3d': { name: 'builtinSeeds.mDevice3d', hint: 'builtinSeeds.mDevice3dHint' },
+}
+
+/** 模型 hint 的兜底字面量(composable 里的固定中文提示)→ 词条 */
+export const MODEL_HINT_FALLBACKS: Record<string, string> = {
+  '设备实体(拖入场景生成数字孪生)': 'builtinSeeds.mDeviceFallbackHint',
+  '角色 3D 模型(在频道成员管理中设置)': 'builtinSeeds.mScannedCharacterHint',
+}
+
+export function townModelName(tr: (k: string) => string, m: { id: string, name: string }): string {
+  return TOWN_MODEL_KEYS[m.id]?.name ? tr(TOWN_MODEL_KEYS[m.id]!.name) : m.name
+}
+
+export function townModelHint(tr: (k: string) => string, m: { id: string, hint?: string }): string | undefined {
+  const mapped = TOWN_MODEL_KEYS[m.id]?.hint
+  if (mapped) return tr(mapped)
+  const fallback = m.hint ? MODEL_HINT_FALLBACKS[m.hint] : undefined
+  return fallback ? tr(fallback) : m.hint
+}
+
+/** 模板目录显示名:命中稳定 key 走 i18n,否则回退服务端名 */
+export function catalogTplName(tr: (k: string) => string, t: NameLike): string {
+  const k = t.key ?? t.id
+  return (k && TPL_CATALOG_IDS.has(k)) ? tr(`tplCatalog.${k}`) : t.name
+}
+
+/** 内置种子记录显示名:命中稳定 id 走 i18n,否则回退原始名(用户自建/改名不翻译) */
+export function seedName(tr: (k: string) => string, t: { id?: string, templateId?: string, name: string }): string {
+  const k = SEED_NAME_KEYS[t.id ?? t.templateId ?? '']
+  return k ? tr(k) : t.name
+}

package/config.yml

@@ -1,170 +1,176 @@
-# ============================================================
-# AgentWorkShop 运行配置 —— 运行时默认值的单一事实来源
-# ------------------------------------------------------------
-# 本文件由 nuxt.config.ts（构建/开发期）与 scripts/start.mjs（生产启动期）
-# 读取并解析，驱动整个运行时。修改后重启对应模式即可生效：
-#   开发：pnpm dev     -> 读取 server.dev
-#   生产：pnpm start   -> 读取 server.prod
-# 例外：app.version 的权威值在 package.json（nuxt.config.ts 以包版本优先，
-#   本字段仅作回退）—— 长期不同步过（曾停在 0.7.9 而包已 0.7.35），勿再依赖它。
-# ============================================================
-
-app:
-  name: AgentWorkShop
-  title: AgentWorkShop
-  version: 0.7.36
-  description: 基于 Nuxt 4 的配置驱动运行范式
-
-# 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）
-mode: dev
-
-# ------------------------------------------------------------
-# 服务端口：dev 与 prod 可分别自定义
-# ------------------------------------------------------------
-server:
-  host: 0.0.0.0
-  dev:
-    port: 3000
-  prod:
-    port: 3001
-
-# 后端 API（前端 axios 基址 + 服务端行为均由本段驱动）
-api:
-  baseURL: /api
-  timeout: 15000
-  pageSize: 20      # 服务端默认分页大小
-  maxPageSize: 100  # 服务端分页大小上限
-
-# 国际化
-i18n:
-  defaultLocale: zh-CN
-  locales:
-    - code: zh-CN
-      name: 简体中文
-    - code: en
-      name: English
-
-# 主题
-theme:
-  # Agent Harness · Digital Twin 控制室色板:品牌绿(交互/确认/DAQ)+ 数据青,见 TownView.vue --hud-*
-  primaryColor: "#35e0a0"
-  mode: light # light | dark
-
-# 安全配置
-# 数据采集基础设施(数采 DAQ;地址与 docker-compose.yml 默认一致)
-# startInfrastructure: never=启动探测,不通且有 Docker 则自动 docker compose 拉起;
-#   always=仅 Docker 拉起;never=只直连。连接失败降级并警告,可前端一键重连。
-daq:
-  startInfrastructure: auto
-  mqtt:
-    host: 127.0.0.1
-    port: 1883
-  timescale:
-    host: 127.0.0.1
-    port: 5432
-    user: postgres
-    password: awshop
-    database: awshop
-  # 对象存储(图像帧;MinIO,S3 兼容)。不可达时自动降级本地磁盘 data/daq-objects/,采集不中断。
-  objectstore:
-    host: 127.0.0.1
-    port: 9000
-    accessKey: awshop
-    secretKey: awshop-secret
-    bucket: daq
-  # 采样节拍(live 可调,热重载):节点未显式指定 intervalMs 时的采集周期与可配置下限。
-  # 下限同时钳制 create/patch/存量节点;设置页/`aw config set daq.sampling.*` 均可改。
-  sampling:
-    defaultIntervalMs: 5000   # 默认 5s
-    minIntervalMs: 1000       # 下限 1s(绝对硬底 200ms)
-  # 时序查询节拍(live 可调,热重载):查询未指定 bucketMs 时的降采样桶宽与下限。
-  # samples / 产线数据查询 / Agent daq_query 三处共用;Agent 工具描述实时携带当前值。
-  query:
-    defaultBucketMs: 15000    # 缺省 15s
-    minBucketMs: 1000         # 下限 1s(绝对硬底 100ms)
-
-security:
-  # Session cookie 加密密钥（nuxt-auth-utils 使用）
-  # 生产环境必须修改为强随机值；可用环境变量 NUXT_SESSION_PASSWORD 覆盖
-  sessionPassword: awshop-dev-secret-change-me-0123456789
-  # HITL 审批超时窗 ms（超时默认拒绝；env HITL_TIMEOUT_MS 兼容）
-  # hitl_timeout_ms: 180000
-
-# ------------------------------------------------------------
-# 以下运行语义组：全部键均可被 env AW_<键>(点转下划线)或历史别名覆盖，
-# 优先级 config.yml < data/runtime-settings.json < 环境变量。缺省即用默认。
-# ------------------------------------------------------------
-
-# Agent 记忆系统(env AW_MEMORY_*)
-memory:
-  primer_tokens: 300        # 记忆引子 token 预算(AW_MEMORY_PRIMER_TOKENS)
-  inject_total: 500         # 单次注入总硬顶(AW_MEMORY_INJECT_TOTAL)
-  maintenance_ms: 21600000  # 维护调度周期(AW_MEMORY_MAINTENANCE_MS)
-  expire_days: 180          # 情景记忆保留天数(AW_MEMORY_EXPIRE_DAYS)
-  expire_session_days: 14   # 会话记忆保留天数(AW_MEMORY_EXPIRE_SESSION_DAYS)
-  cap: 500                  # 条目驱逐上限(AW_MEMORY_CAP)
-  reflect_trigger: 8        # 空闲反思触发阈值(AW_MEMORY_REFLECT_TRIGGER)
-  embed_base_url: ''        # OpenAI 兼容 /embeddings 基址(AW_MEMORY_EMBED_BASE_URL;空=纯 FTS)
-  embed_model: ''           # 向量模型名(AW_MEMORY_EMBED_MODEL)
-  embed_api_key: ''         # Bearer 密钥(AW_MEMORY_EMBED_API_KEY)
-
-# omp Agent Harness(env AW_OMP_COMPACT_*)
-omp:
-  compact_enabled: true       # 上下文自动压缩总开关(AW_OMP_COMPACT_ENABLED=0 可关)
-  compact_threshold: 0.7      # 触发压缩的上下文占用比例(AW_OMP_COMPACT_THRESHOLD)
-  compact_min_interval_ms: 300000  # 两次压缩最小间隔(AW_OMP_COMPACT_MIN_INTERVAL_MS)
-  compact_wait_ms: 120000     # 等待压缩完成超时(AW_OMP_COMPACT_WAIT_MS)
-
-# 数控写控制(env DCW_ROLLBACK_*)
-dcw:
-  rollback_cooldown_ms: 300000     # 回退后同向重写冷却(DCW_ROLLBACK_COOLDOWN_MS)
-  rollback_min_window_ms: 120000   # 判定最小观察窗(DCW_ROLLBACK_MIN_WINDOW_MS)
-  rollback_baseline_ms: 600000     # 基线回看窗(DCW_ROLLBACK_BASELINE_MS)
-  rollback_stale_ms: 1800000       # open 记录接管阈值(DCW_ROLLBACK_STALE_MS)
-
-# 车间运行(env WORKSHOP_IDLE_*)
-workshop:
-  idle_sweep_ms: 30000    # 空闲 agent 扫描周期(WORKSHOP_IDLE_SWEEP_MS)
-  idle_grace_ms: 120000   # 空闲卸载宽限(WORKSHOP_IDLE_GRACE_MS)
-
-# 数据备份(env BACKUP_*)
-backup:
-  disabled: false       # BACKUP_DISABLED=1 关闭
-  interval_hours: 24    # 备份间隔(BACKUP_INTERVAL_HOURS)
-  keep: 7               # 保留份数(BACKUP_KEEP)
-
-# 数据保留清理(env RETENTION_DISABLED / AW_EVENTS_RETENTION_D 等)
-retention:
-  disabled: false     # RETENTION_DISABLED=1 / AW_RETENTION_DISABLED=1 关闭
-  events_days: 7      # WS 事件流保留天数(AW_EVENTS_RETENTION_D)
-  messages_days: 30   # Channel 消息(AW_MESSAGES_RETENTION_D)
-  audit_days: 90      # 审计日志(AW_AUDIT_RETENTION_D)
-  approval_days: 180  # 审批历史(AW_APPROVAL_RETENTION_D)
-
-# 服务端日志(env AWSHOP_LOG_LEVEL)
-log:
-  level: info  # debug | info | warn | error
-
-# AML 自动建模平台(Python 训练运行时/作业限额/GC 保留/评测门禁;全部键见 shared/config/schema.json)
-aml:
-  python:
-    pythonBin: ''   # 空=自动探测 python / py -3
-    uvBin: ''       # 空=自动探测 uv(存在则优先)
-    indexUrl: ''    # PyPI 兼容镜像,空=默认源;仅 venv 供给阶段联网,训练进程不联网
-  job:
-    timeoutMs: 1800000
-    maxConcurrent: 2
-    diskQuotaMb: 2048
-    stallMs: 600000
-  dataset:
-    maxRows: 200000
-    retentionDays: 30
-    allowCrossRecipe: false
-  model:
-    retiredKeepDays: 90
-  gates:
-    nrmse: 0.10
-    rolloutNrmse: 0.25
-    valTestGap: 0.20
-    minRows: 500
-    minRuns: 3
+# ============================================================
+# AgentWorkShop 运行配置 —— 运行时默认值的单一事实来源
+# ------------------------------------------------------------
+# 本文件由 nuxt.config.ts（构建/开发期）与 scripts/start.mjs（生产启动期）
+# 读取并解析，驱动整个运行时。修改后重启对应模式即可生效：
+#   开发：pnpm dev     -> 读取 server.dev
+#   生产：pnpm start   -> 读取 server.prod
+# 例外：app.version 的权威值在 package.json（nuxt.config.ts 以包版本优先，
+#   本字段仅作回退）—— 长期不同步过（曾停在 0.7.9 而包已 0.7.35），勿再依赖它。
+# ============================================================
+
+app:
+  name: AgentWorkShop
+  title: AgentWorkShop
+  version: 0.7.46
+  description: 基于 Nuxt 4 的配置驱动运行范式
+
+# 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）
+mode: dev
+
+# ------------------------------------------------------------
+# 服务端口：dev 与 prod 可分别自定义
+# ------------------------------------------------------------
+server:
+  host: 0.0.0.0
+  dev:
+    port: 3000
+  prod:
+    port: 3001
+
+# 后端 API（前端 axios 基址 + 服务端行为均由本段驱动）
+api:
+  baseURL: /api
+  timeout: 15000
+  pageSize: 20      # 服务端默认分页大小
+  maxPageSize: 100  # 服务端分页大小上限
+
+# 国际化
+i18n:
+  defaultLocale: zh-CN
+  locales:
+    - code: zh-CN
+      name: 简体中文
+    - code: en
+      name: English
+
+# 主题
+theme:
+  # Agent Harness · Digital Twin 控制室色板:品牌绿(交互/确认/DAQ)+ 数据青,见 TownView.vue --hud-*
+  primaryColor: "#35e0a0"
+  mode: light # light | dark
+
+# 安全配置
+# 数据采集基础设施(数采 DAQ;地址与 docker-compose.yml 默认一致)
+# startInfrastructure: never=启动探测,不通且有 Docker 则自动 docker compose 拉起;
+#   always=仅 Docker 拉起;never=只直连。连接失败降级并警告,可前端一键重连。
+daq:
+  startInfrastructure: auto
+  mqtt:
+    host: 127.0.0.1
+    port: 1883
+  timescale:
+    host: 127.0.0.1
+    port: 5432
+    user: postgres
+    password: awshop
+    database: awshop
+  # 对象存储(图像帧;MinIO,S3 兼容)。不可达时自动降级本地磁盘 data/daq-objects/,采集不中断。
+  objectstore:
+    host: 127.0.0.1
+    port: 9000
+    accessKey: awshop
+    secretKey: awshop-secret
+    bucket: daq
+  # 采样节拍(live 可调,热重载):节点未显式指定 intervalMs 时的采集周期与可配置下限。
+  # 下限同时钳制 create/patch/存量节点;设置页/`aw config set daq.sampling.*` 均可改。
+  sampling:
+    defaultIntervalMs: 5000   # 默认 5s
+    minIntervalMs: 1000       # 下限 1s(绝对硬底 200ms)
+  # 时序查询节拍(live 可调,热重载):查询未指定 bucketMs 时的降采样桶宽与下限。
+  # samples / 产线数据查询 / Agent daq_query 三处共用;Agent 工具描述实时携带当前值。
+  query:
+    defaultBucketMs: 15000    # 缺省 15s
+    minBucketMs: 1000         # 下限 1s(绝对硬底 100ms)
+
+security:
+  # Session cookie 加密密钥（nuxt-auth-utils 使用）
+  # 生产环境必须修改为强随机值；可用环境变量 NUXT_SESSION_PASSWORD 覆盖
+  sessionPassword: awshop-dev-secret-change-me-0123456789
+  # HITL 审批超时窗 ms（超时默认拒绝；env HITL_TIMEOUT_MS 兼容）
+  # hitl_timeout_ms: 180000
+
+# ------------------------------------------------------------
+# 以下运行语义组：全部键均可被 env AW_<键>(点转下划线)或历史别名覆盖，
+# 优先级 config.yml < data/runtime-settings.json < 环境变量。缺省即用默认。
+# ------------------------------------------------------------
+
+# Agent 记忆系统(env AW_MEMORY_*)
+memory:
+  primer_tokens: 300        # 记忆引子 token 预算(AW_MEMORY_PRIMER_TOKENS)
+  inject_total: 500         # 单次注入总硬顶(AW_MEMORY_INJECT_TOTAL)
+  maintenance_ms: 21600000  # 维护调度周期(AW_MEMORY_MAINTENANCE_MS)
+  expire_days: 180          # 情景记忆保留天数(AW_MEMORY_EXPIRE_DAYS)
+  expire_session_days: 14   # 会话记忆保留天数(AW_MEMORY_EXPIRE_SESSION_DAYS)
+  cap: 500                  # 条目驱逐上限(AW_MEMORY_CAP)
+  reflect_trigger: 8        # 空闲反思触发阈值(AW_MEMORY_REFLECT_TRIGGER)
+  embed_base_url: ''        # OpenAI 兼容 /embeddings 基址(AW_MEMORY_EMBED_BASE_URL;空=纯 FTS)
+  embed_model: ''           # 向量模型名(AW_MEMORY_EMBED_MODEL)
+  embed_api_key: ''         # Bearer 密钥(AW_MEMORY_EMBED_API_KEY)
+
+# omp Agent Harness(env AW_OMP_COMPACT_*)
+omp:
+  compact_enabled: true       # 上下文自动压缩总开关(AW_OMP_COMPACT_ENABLED=0 可关)
+  compact_threshold: 0.7      # 触发压缩的上下文占用比例(AW_OMP_COMPACT_THRESHOLD)
+  compact_min_interval_ms: 300000  # 两次压缩最小间隔(AW_OMP_COMPACT_MIN_INTERVAL_MS)
+  compact_wait_ms: 120000     # 等待压缩完成超时(AW_OMP_COMPACT_WAIT_MS)
+
+# 数控写控制(env DCW_ROLLBACK_*)
+dcw:
+  rollback_cooldown_ms: 300000     # 回退后同向重写冷却(DCW_ROLLBACK_COOLDOWN_MS)
+  rollback_min_window_ms: 120000   # 判定最小观察窗(DCW_ROLLBACK_MIN_WINDOW_MS)
+  rollback_baseline_ms: 600000     # 基线回看窗(DCW_ROLLBACK_BASELINE_MS)
+  rollback_stale_ms: 1800000       # open 记录接管阈值(DCW_ROLLBACK_STALE_MS)
+
+# 车间运行(env WORKSHOP_IDLE_*)
+workshop:
+  idle_sweep_ms: 30000    # 空闲 agent 扫描周期(WORKSHOP_IDLE_SWEEP_MS)
+  idle_grace_ms: 120000   # 空闲卸载宽限(WORKSHOP_IDLE_GRACE_MS)
+  max_descendants_per_root: 6
+  max_active_descendants_per_root: 4
+  max_canceled_descendants_per_root: 3
+  max_task_depth: 1
+  root_timeout_ms: 900000
+  max_lead_created_workers: 8
+
+# 数据备份(env BACKUP_*)
+backup:
+  disabled: false       # BACKUP_DISABLED=1 关闭
+  interval_hours: 24    # 备份间隔(BACKUP_INTERVAL_HOURS)
+  keep: 7               # 保留份数(BACKUP_KEEP)
+
+# 数据保留清理(env RETENTION_DISABLED / AW_EVENTS_RETENTION_D 等)
+retention:
+  disabled: false     # RETENTION_DISABLED=1 / AW_RETENTION_DISABLED=1 关闭
+  events_days: 7      # WS 事件流保留天数(AW_EVENTS_RETENTION_D)
+  messages_days: 30   # Channel 消息(AW_MESSAGES_RETENTION_D)
+  audit_days: 90      # 审计日志(AW_AUDIT_RETENTION_D)
+  approval_days: 180  # 审批历史(AW_APPROVAL_RETENTION_D)
+
+# 服务端日志(env AWSHOP_LOG_LEVEL)
+log:
+  level: info  # debug | info | warn | error
+
+# AML 自动建模平台(Python 训练运行时/作业限额/GC 保留/评测门禁;全部键见 shared/config/schema.json)
+aml:
+  python:
+    pythonBin: ''   # 空=自动探测 python / py -3
+    uvBin: ''       # 空=自动探测 uv(存在则优先)
+    indexUrl: ''    # PyPI 兼容镜像,空=默认源;仅 venv 供给阶段联网,训练进程不联网
+  job:
+    timeoutMs: 1800000
+    maxConcurrent: 2
+    diskQuotaMb: 2048
+    stallMs: 600000
+  dataset:
+    maxRows: 200000
+    retentionDays: 30
+    allowCrossRecipe: false
+  model:
+    retiredKeepDays: 90
+  gates:
+    nrmse: 0.10
+    rolloutNrmse: 0.25
+    valTestGap: 0.20
+    minRows: 500
+    minRuns: 3

package/docs/aml.md

@@ -74,6 +74,16 @@ canonical one-step:输入 `history [batch, H, nAll]`(归一化)→ 输出 `y_nex
 - **Agent**:内置团队「AML 影子建模团队」(`team-aml-shadow`,部署前先加成员)或任意成员直接调用工具族 `aml_node_catalog / aml_dataset_build / aml_dataset_stats / aml_job_submit / aml_job_status / aml_job_logs / aml_job_cancel / aml_leaderboard / aml_model_promote(lead 专属)/ aml_model_reference`(见 `.AgentWorkShop/prompts/host-tools.json`);调参 what-if 经 `aml_model_reference` 的 `controls` 参数传入拟议参数值。
 - **REST**:`/api/workshop/aml/{env,entities,datasets,jobs,experiments,models}`(见各路由文件头注释)。
 
+## 混合孪生 × MPC(Core Hybrid Twin)
+
+除「数据集 → 训练 → 门禁 → 注册表」这条数据链,AML 还承载**混合孪生**平面:灰箱物理主干(以注塑为例的低阶模型)+ **有界 PyTorch 残差**训练协议,外挂六类契约 ——
+`SceneContract`(场景:设备/信号/约束/目标)、`PhysicsModelManifest`(物理主干清单)、`TwinSnapshot`(带新鲜度的工况快照)、`ObjectiveProfile`(目标与权重)、`VirtualTrial`(虚拟试验)、`RecommendationCertificate`(推荐证书)。
+
+- **启用方式**:Channel 的 profile(`legacy` 默认 / `hybrid_twin`),在 Channel 模板与实例上选择;启用后按 profile 注入 6 个专属工具:`twin_scene_read` / `twin_snapshot_create` / `twin_trial_run` / `mpc_optimize` / `twin_gate_evaluate` / `twin_calibration_request`。
+- **安全语义**:试验**永远是虚拟的**(`candidateExecuted=false`);不安全候选被全轨迹硬约束直接拒绝;快照过期 → `SNAPSHOT_STALE`;只有门禁与收益同时通过才签发推荐证书,证书未签发前**不产生真实 DCW 写入**(recommendation-only)。
+- **服务端策略**:数据不足 → `safe_small_step`;模型过门禁 → `precise_search`;持续校准请求按去重 + cooldown 登记。
+- **工件与记录**:SQLite Hybrid Twin 元数据表 + 本地 `aml/twins/` 工件;计划与验收见 `docs/aml-hybrid-twin-mpc-integration-plan.md`、`docs/aml-hybrid-twin-implementation-acceptance.md`(首个场景 = PLC 模拟器 `injection-line`)。
+
 ## Python 运行时
 
 首次训练自动探测 uv 与 Python,并在 `./aml/.venv` 供给锁定依赖(`aml/python/requirements.txt`;仅此阶段联网,可配 `aml.python.indexUrl` 镜像)。

package/docs/cli.en.md

@@ -62,7 +62,7 @@ pnpm tui             # the terminal workbench
 ### 3. Quick use via npx (no global install)
 
 ```bash
-npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.41 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.46 start)
 npx agentworkshop doctor           # subcommands work as usual
 npx -p agentworkshop aw doctor     # use -p when you want the name aw
 ```
@@ -79,7 +79,7 @@ npx -p agentworkshop aw doctor     # use -p when you want the name aw
 | Package manager | `pnpm@11.9.0` (`packageManager`, needed only for source development) |
 | Module format | ESM (`type: module`) |
 | License | `PolyForm-Noncommercial-1.0.0` |
-| Current version | `0.7.41` (`package.json`) |
+| Current version | `0.7.46` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 
@@ -167,7 +167,7 @@ are never overwritten:
 - Precedence (the CLI, the web settings page and the dev/prod launch scripts all share one engine,
   `shared/config/engine.mjs`):
   `config.yml defaults < runtime-settings.json runtime overrides < environment variables / explicit CLI flags`.
-- There are **99 setting descriptors across 16 groups** (`aw config list` prints exactly 99 rows):
+- There are **111 setting descriptors across 16 groups** (`aw config list` prints exactly 111 rows):
 
 | Group | Count | Group | Count | Group | Count | Group | Count |
 |---|---|---|---|---|---|---|---|
@@ -176,7 +176,7 @@ are never overwritten:
 | `omp` | 4 | `harness` | 12 | `dcw` | 4 | `workshop` | 2 |
 | `backup` | 3 | `retention` | 5 | `log` | 1 | `aml` | 16 |
 
-  32 of them are `live` (effective as soon as they are saved) and 66 are `restart` (effective after
+  32 of them are `live` (effective as soon as they are saved) and 79 are `restart` (effective after
   restarting the corresponding mode); `aw config list` marks every row with `live` or `restart`.
 - Environment-variable mapping: `AW_<KEY uppercased, dots turned into underscores>`
   (for example `AW_SERVER_DEV_PORT`), plus the legacy `aliases` a descriptor declares explicitly
@@ -256,7 +256,7 @@ the CLI's `--json`.
 aw config set server.prod.port 8080     # change the production port (effective after restart)
 aw config set theme.primaryColor '#41c8f4'
 aw config get server.dev.port           # value + source
-aw config list                          # 99 settings (16 groups) + source + when they apply
+aw config list                          # 111 settings (16 groups) + source + when they apply
 aw config validate                      # validate config.yml and the runtime overrides
 aw start --port 3002                    # CLI flags win; the output marks 端口来源: CLI
 aw doctor                               # health check: Node/pnpm/AW Home/Docker/MQTT/ports/secrets/build

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.41 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.46 start)
 npx agentworkshop doctor           # 子命令照常可用
 npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 ```
@@ -76,7 +76,7 @@ npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 | 包管理器 | `pnpm@11.9.0`（`packageManager`，仅源码开发需要） |
 | 模块形态 | ESM（`type: module`） |
 | 许可证 | `PolyForm-Noncommercial-1.0.0` |
-| 当前版本 | `0.7.41`（`package.json`） |
+| 当前版本 | `0.7.46`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 
@@ -156,7 +156,7 @@ $ aw start
 
 - 优先级（CLI 与网页设置页、dev/prod 启动脚本共用同一引擎 `shared/config/engine.mjs`）：
   `config.yml 默认 < runtime-settings.json 运行时覆盖 < 环境变量 / CLI 显式参数`。
-- 设置描述符共 **98 项、16 组**（`aw config list` 即打印 98 行）：
+- 设置描述符共 **111 项、16 组**（`aw config list` 即打印 111 行）：
 
 | 组 | 项数 | 组 | 项数 | 组 | 项数 | 组 | 项数 |
 |---|---|---|---|---|---|---|---|
@@ -165,7 +165,7 @@ $ aw start
 | `omp` | 4 | `harness` | 12 | `dcw` | 4 | `workshop` | 2 |
 | `backup` | 3 | `retention` | 5 | `log` | 1 | `aml` | 16 |
 
-  其中 `live`（保存即生效）32 项、`restart`（重启对应模式后生效）66 项，
+  其中 `live`（保存即生效）32 项、`restart`（重启对应模式后生效）79 项，
   `aw config list` 每行末尾会标注 `live` 或 `restart`。
 - 环境变量映射：`AW_<KEY 大写、点转下划线>`（如 `AW_SERVER_DEV_PORT`），
   另加描述符显式声明的历史 `aliases`（优先级：`AW_<KEY>` 高于 `aliases` 声明顺序）。
@@ -241,7 +241,7 @@ $ aw start
 aw config set server.prod.port 8080     # 改生产端口(重启生效)
 aw config set theme.primaryColor '#41c8f4'
 aw config get server.dev.port           # 值 + 来源
-aw config list                          # 99 个设置项(16 组) + 来源 + 生效方式
+aw config list                          # 111 个设置项(16 组) + 来源 + 生效方式
 aw config validate                      # 校验 config.yml 与运行时覆盖合法性
 aw start --port 3002                    # CLI 参数最高优先(输出标注 端口来源: CLI)
 aw doctor                               # 体检:Node/pnpm/AW Home/Docker/MQTT/端口/密钥/产物

package/docs/full-test-plan.md

@@ -1,9 +1,13 @@
 # AgentWorkShop 全功能测试流程 Plan
 
-> 版本无关的常备测试手册（撰写时基线 v0.7.37）。用途：后续直接指令 agent
+> 版本无关的常备测试手册（撰写时基线 v0.7.45）。用途：后续直接指令 agent
 > 「按 docs/full-test-plan.md 执行 Phase 0–N」即可完成全功能测试。
 > 断言数为历史全绿基线（2026-09 上旬各轮验收），以脚本实际输出为准；括号内数字仅用于识别明显回退。
 > 最后核对：2026-09-12（脚本清单逐一经 `scripts/` 实存核对）。
+> **2026-09-24 全功能验收**见 `docs/audit/e2e-2026-09-24-full-coverage.md`（生产构建 + 真实引擎/
+> 协议/浏览器/崩溃重启，约 1100+ 断言；本轮修掉 5 处真实缺陷，受限项逐条归因）。
+> ⚠️ 下方各 Phase 的脚本清单仍停留在 2026-09-12 的版本，部分 `_dbg-*.mjs` 已随功能重构删除或改名；
+> 执行前先按 `scripts/` 实存核对（以验收报告里的可用脚本清单为准）。
 
 ---
 
@@ -15,6 +19,16 @@
 - 本机 7890 代理会拦截 localhost：所有对 127.0.0.1 的 curl/node 调用带 `NO_PROXY='127.0.0.1,localhost'`（或 `NO_PROXY='*'`）。
 - 探针避开 3000/3001 冲突：dev=3000、生产 `aw start`=3001、隔离实例=3021。
 - `.ts` 脚本必须 `npx tsx --tsconfig .nuxt/tsconfig.server.json`（先 build 过一次）。
+- **导入 Nuxt 虚拟模块（`#imports`）的 TS 套件**要走纯 node 路径（tsx 解析不了该虚拟模块）：
+  `node --experimental-transform-types --import ./scripts/_audit/ts-register-hook.mjs scripts/<suite>.ts`
+  —— 钩子把 `#imports` 映射到 `scripts/_audit/stubs/nuxt-imports.mjs`，配置取值与
+  `nuxt.config.ts` 的 runtimeConfig 同源。
+- **`pnpm typecheck` 走 `scripts/typecheck.mjs`**：Nuxt 4.5 会往生成的 tsconfig 里写一条
+  vue-router 4.6 已不再导出的 volar 插件，裸 `nuxt typecheck` 在加载 tsconfig 阶段即
+  `ERR_PACKAGE_PATH_NOT_EXPORTED` 崩溃（类型检查实际一次都没跑）。脚本头有完整说明。
+- **崩溃恢复三阶段**（硬杀 → 重启 → 验证）用
+  `node scripts/e2e-crash-cycle.mjs --port <port> --home <dir>` 一次跑完：
+  编排层自动拉起/重启隔离实例，再串 watch→crash→verify→gap→verify-gap 五个阶段。
 - 测试账号（勿改动）：admin@awshop.local / admin123（生产零种子 admin）；perf-runner@awshop.io（admin）；read-verify@awshop.io（plain）。老脚本默认 `E2E_USER ?? 'zhangwei@awshop.io'`，对生产须显式传 env。
 - 凭据纪律：脚本从 env / `/api/system/settings` 运行时读取，不写可用凭据字面量。
 - Bash 写源码/配置会被 Mimosa hook 拒绝 → 用 Write/Edit 工具；git add 源码路径同样被拒。
@@ -74,7 +88,6 @@
 | `NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-render-regression.mjs http://127.0.0.1:3001 admin@awshop.local admin123` | 关键页渲染回归 | 29 |
 | `AW_E2E_TOKEN=… NO_PROXY='127.0.0.1,localhost' node scripts/e2e-config-groups.mjs` | 配置分组系统 + 两桥接插件正确/错误 token·URL 实测 | 58 |
 | `E2E_USER=admin@awshop.local E2E_PASS=admin123 NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-groups-ui-verify.mjs` | 设置页分组 UI（浏览器实测） | 16 |
-| `node scripts/_dbg-daq-rowstyle-verify.mjs` | 数采行样式 + 设置页三节拍 | 10+6 |
 | `node scripts/_dbg-daq-intervals-func.mjs` | 三节拍（采集/WS下发/趋势刷新）独立热生效 + 下限钳制 + 详情页按节拍实测重拉 | 13 |
 | `node scripts/_dbg-town-smoke.mjs` | 数字孪生画布/场景钩子/帧推进 | 5 |
 
@@ -87,7 +100,7 @@
 | 脚本 | 覆盖 | 基线 |
 |---|---|---|
 | `NO_PROXY='*' node scripts/_dbg-protocol-matrix.mjs` | 5 协议 DAQ 读取 + 4 路 DCW 读/写闭环（modbus-tcp SP→PV 真收敛） | 全绿 |
-| `NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-live-line-e2e.mjs http://127.0.0.1:3001` | S1 夹具→S2 协议连通→S3 数采落库→S4 五路数控→S5 Agent 闭环(CLOSEDLOOP-OK)→S6 HITL 真实写入 | 37 |
+| `node bench/pipeline.mjs --profile integrated` | 五协议工业闭环现行门禁（原 37 项 live-line 脚本因模拟器端口演进退役，覆盖并入 bench P 阶段）：连通→数采落库→五路数控→Agent 闭环→HITL→配方/参数回退 | 75 |
 | `AW_E2E_TOKEN=… NO_PROXY='127.0.0.1,localhost' node scripts/e2e-plc-plugin-closedloop.mjs` | A 插件健康 / B 产线供给 / C 数采交叉核对 / D 真实诊断 / E 知识闭环 / F 参数逐键热生效 / G Channel 级开关 | 71 |
 | `AW_E2E_TOKEN=… NO_PROXY='127.0.0.1,localhost' node scripts/production-closed-loop-e2e.mjs` | 生产闭环增强：事件自动诊断(source=auto)→kb_search→dcw_control(HITL)→回写 | 23 |
 | `AW_E2E_TOKEN=… NO_PROXY='127.0.0.1,localhost' node scripts/three-system-e2e.mjs`（可选 `--full` 走 omp 真实诊断） | AW × 深度诊断 × rag-knowledge 三系统；插件启停热重载 | 52 |
@@ -135,7 +148,7 @@
 ## Phase 7 浏览器目视验收（Puppeteer 截图逐页过目）
 
 覆盖页：登录/仪表盘/产线管理/数采列表+详情（趋势图在动）/数控/数字孪生（帧推进+无黑屏）/设置（分组渲染+折叠+来源徽标）/插件/运维日志 /logs/AML/AgentTeam。
-工具：`scripts/ui-screenshot.mjs`、`scripts/_dbg-audit-all-pages.mjs`（全页 console error 扫描=0）。截图存 `.e2e-shots/` 逐张目视；破版/白屏/控制台报错即红项。
+工具：`scripts/ui-screenshot.mjs`、`scripts/ui/audit-layout.mjs`、`scripts/_sweep-button-contrast.mjs`（双主题全路由按钮对比度+空按钮扫描）。截图存 `.e2e-shots/` 逐张目视；破版/白屏/控制台报错即红项。
 
 ---
 

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.41**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.46**. `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.41**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.7.46**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始