agentworkshop 0.7.40 → 0.7.44

package/app/plugins/locale-restore.client.ts

@@ -1,11 +1,26 @@
 /**
  * 语言恢复(detectBrowserLanguage 关闭):客户端启动时读取持久化选择。
- * AppHeader/settings 切换时写入 localStorage 并强刷(保证 setup 期词条整体切换)。
+ * AppHeader/settings 切换时写入 localStorage + cookie 并强刷(保证 setup 期词条整体切换)。
  * 注意:插件上下文不能调 useI18n()(要求 setup),必须走 nuxtApp.$i18n。
+ *
+ * cookie 镜像(locale-cookie.global.ts 消费):老用户偏好只存在于 localStorage,
+ * 首次加载时镜像进 cookie 并强刷一次,让 SSR 首帧即以偏好语言渲染
+ * (否则 SSR 恒 zh,客户端异步切换在水合竞态下会留下中文 attr 残留)。
+ * sessionStorage 守卫防 cookie 写入被挡时的刷新循环。
  */
 export default defineNuxtPlugin((nuxtApp) => {
   const saved = localStorage.getItem('aw.locale')
+  const cookie = useCookie<string | undefined>('aw.locale', { maxAge: 60 * 60 * 24 * 365 })
   if (!saved) return
+  if (cookie.value !== saved) {
+    const mirrored = sessionStorage.getItem('aw.locale.mirrored')
+    if (mirrored !== saved) {
+      sessionStorage.setItem('aw.locale.mirrored', saved)
+      cookie.value = saved
+      window.location.reload()
+      return
+    }
+  }
   const $i18n = (nuxtApp as unknown as { $i18n?: { locale: { value?: string } | string, setLocale: (l: string) => Promise<unknown> } }).$i18n
   if (!$i18n) return
   const current = typeof $i18n.locale === 'string' ? $i18n.locale : $i18n.locale?.value

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,170 @@
-# ============================================================
-# 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.43
+  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

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.38 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.41 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.38` (`package.json`) |
+| Current version | `0.7.41` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.38 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.41 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.38`（`package.json`） |
+| 当前版本 | `0.7.41`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 

package/docs/full-test-plan.md

@@ -74,7 +74,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 +86,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 +134,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.38**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.41**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 
@@ -210,10 +210,41 @@ async setup(ctx) {
 | Events | `ctx.events.on(type, fn)` / `ctx.events.off(type, fn)` | scene-event sugar: subscribes to `event:<type>` internally (see §7) |
 | Paths | `ctx.paths.home / configRoot / dataDir`; `ctx.dataDir` | `ctx.dataDir` is this plugin's KV folder, `<configRoot>/data/plugins/<plugin>` |
 | DAQ | `ctx.daq.registerDriver / registerProcessor / registerTemplate / onFrame / onSample / query / nodes` | driver, sink-processor and node-template registration + time-series queries + node metadata snapshot |
+| Write control | `ctx.dcw.registerWriteDriver(driver)` | write-driver injection (symmetric to DAQ read drivers): contract `{ kind, available(), write(input), test(cfg), read?(input), meta? }`; disabled plugins lose their drivers on hot reload |
 | Tools | `ctx.omp.registerTool({ name, label?, description, parameters, roles?, handler })` | agent tool injection; `roles` accepts `'lead'` and `'worker'` only (see §10) |
 | Services | `ctx.services.names()` / `.get(name)` / `.provide(name, getter)` | runtime object surface: `get('daq' \| 'lines' \| 'channels' \| 'plugins')`; `provide` auto-prefixes `<plugin>.` |
 | Permissions | `ctx.permissions.lineMode / visibleLineIds / listGrants / setGrants` | line-grant queries and management |
 
+### Communication-protocol plugins (custom interface connections)
+
+`ctx.daq.registerDriver` / `ctx.dcw.registerWriteDriver` are the **protocol plug-in points**: serial
+links, other PLC protocols and private buses all inject here — the main pipelines (sampling loop /
+write gateway / frontend forms) need zero changes.
+
+```js
+ctx.daq.registerDriver({
+  kind: 'serial',                    // custom protocol kind (overriding a builtin logs a warning)
+  async available() { return true }, // protocol-stack probe (missing package → UI shows "not installed")
+  async sample({ driverConfig }) { return 25.3 },   // reading (scalar or v2 frame envelope)
+  async test(driverConfig) { return { ok: true, message: 'connected', sampleValue: 25.3 } },
+  meta: {                            // self-description (frontend "add node" dropdown + dynamic form)
+    label: 'Serial (RS-232/485)',
+    status: 'real',
+    configFields: [{ key: 'path', label: 'Port path', type: 'string', required: true, placeholder: 'COM3' }],
+  },
+})
+```
+
+Key points:
+- The driver catalog is served via the `drivers` field of `GET /api/workshop/daq` (read) and
+  `GET /api/workshop/dcw` (write); the DAQ/DCW pages render plugin protocols and their forms from it
+  (with a ⌁ badge). Drivers registered without `meta` only appear in availability;
+- Hot reload clears all plugin drivers first, then re-loads: **disabled/unloaded protocol drivers
+  take effect immediately upon removal** and never linger until restart;
+- Builtin example: `server/plugins-builtin/serial-bridge` (serial Modbus RTU + ASCII line protocol,
+  with read/write drivers, `health`/`ports`/`probe` APIs, a frontend panel and the `serial_ports`
+  agent tool) — use it as the template for new protocol plugins.
+
 ### Where KV lives
 
 `<configRoot>/data/plugins/<plugin>/kv.json` — **not** inside the plugin folder. Writes are authoritative in memory and flushed atomically (`tmp` + `rename`) after a 200 ms debounce; on shutdown and hot reload the pending debounce is cancelled and the state is flushed synchronously. `ctx.kv` has exactly four methods: `get / set / all / bump`.
@@ -524,6 +555,7 @@ export default {
 - **A newly enabled browser plugin injects within 15 s** (instantly when the WS channel is up).
 - **`server:close` / `onDispose` depend on graceful shutdown signals**; a forced kill on Windows does not trigger them.
 - **`aw plugin list` only scans directories** — it reflects neither load failures nor runtime health.
+- **Protocol plugins share the host process with their native stacks**: serial-bridge's RTU framing is a self-contained implementation (single serialport native stack; modbus-serial is deliberately NOT used — its wrapper reproducibly crashed under dev mode). Known boundary: **inside the `aw dev` process, a serial transaction that ends in write → timeout → close can trigger a native V8 crash in `bindings-cpp`** (HandleScope fatal — not catchable in JS, regardless of which port is used); **production mode (`aw start`) is unaffected — the exact same sequence was verified live to return an honest timeout with the server healthy**, and open-only probes are also fine under dev. Connect real hardware during development with this in mind; for hardened deployments, run the serial gateway in its own process (see the plc-node-simulator child-process pattern).
 
 ## 13. Pre-release checklist