agentworkshop 0.7.44 → 0.7.46

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.43
+  version: 0.7.46
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）
@@ -126,6 +126,12 @@ dcw:
 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:

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 源码路径同样被拒。

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`。
 
 ## 一、目录结构与快速开始
 

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.41) —
+from the npm package version (the `version` field in `package.json`, currently 0.7.46) —
 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.41)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.46)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/i18n/dicts/dcwDetail.json

@@ -198,6 +198,8 @@
   "k1ledgr001": "优化记录",
   "k9r7d4e016": "周期读(ms)",
   "k9r7d4e017": "缺省 5000ms;0 = 仅手动读取",
+  "writeLockLabel": "写入保持(s)",
+  "writeLockHint": "缺省 30s;0 = 不锁;写成功后锁定防震荡",
   "k9r7d4e018": "PLC 读数",
   "k9r7d4e019": "暂无读数(周期读未开启或驱动不支持读取)",
   "k9r7d4e020": "读取 PLC 当前值",

package/i18n/locales/en.ts

@@ -913,6 +913,8 @@ export default {
     srcSystem: 'System',
     k9r7d4e016: 'Poll read (ms)',
     k9r7d4e017: 'Default 5000ms; 0 = manual read only',
+    writeLockLabel: 'Write hold (s)',
+    writeLockHint: 'Default 30s; 0 = unlocked; locks after each write to prevent oscillation',
     k9r7d4e018: 'PLC reading',
     k9r7d4e019: 'No reading yet (poll read off or driver lacks read support)',
     k9r7d4e020: 'Read current PLC value',
@@ -1434,6 +1436,7 @@ export default {
     k8n918k013: 'Model file deleted',
   },
   channelSessionList: {
+    schedTagTip: 'Bound to {p0} enabled schedule(s)',
     nameRequired: 'Channel name is required',
     defaultSuffix: ' (default)',
     tplCenterTitle: 'Channel template center',
@@ -1568,6 +1571,7 @@ export default {
   },
   commandPalette: {
     gotoTeams: 'Go to: AgentTeam groups',
+    gotoSchedules: 'Go to: Scheduled Task Hub',
     viewLanes: 'View: Agent lanes',
     actA2a: 'Action: A2A RPC/SSE debugger',
     k1nz14ux013: 'Switch Channel: {p0}',
@@ -2082,6 +2086,73 @@ export default {
     ctpl: 'Channel Template Hub · Workshop',
     monitor: 'Runtime Monitor · AgentWorkShop',
     settings: 'Settings · AgentWorkShop',
+    schedules: 'Scheduled Tasks · Workshop',
+  },
+  sched: {
+    title: 'Scheduled Tasks',
+    sub: 'Channel-bound recurring tasks: dispatch a task to the channel on schedule; waits while the channel is busy, then fires immediately.',
+    newBtn: 'New Schedule',
+    empty: 'No schedules yet — create one and let the team run on rhythm',
+    colState: 'State',
+    colPlan: 'Plan',
+    colName: 'Name',
+    colChannel: 'Channel',
+    colLastRun: 'Last run',
+    stateIdle: 'Idle',
+    stateRunning: 'Running',
+    stateWaiting: 'Waiting channel',
+    stateDisabled: 'Disabled',
+    stateFailed: 'Failed',
+    stateTripped: 'Tripped',
+    modeInterval: 'Every {p0}',
+    modeDaily: 'Daily at {p0}',
+    minutes: '{p0} min',
+    hours: '{p0} h',
+    modeIntervalRadio: 'Fixed interval',
+    modeDailyRadio: 'Daily at',
+    nextRun: 'Next:',
+    statLine: '{p0} runs / {p1} failed',
+    fuseLine: 'fuse {p0}/{p1}',
+    runNowTitle: 'Run now',
+    historyTitle: 'Run history',
+    deleteConfirm: 'Delete this schedule? Run history will be removed too',
+    editTitle: 'Edit Schedule',
+    createTitle: 'New Schedule',
+    fName: 'Name',
+    fNamePh: 'e.g. Morning line check',
+    fChannel: 'Bound channel',
+    fChannelPh: 'Channel that receives the task',
+    fTitle: 'Task title (dispatched on trigger)',
+    fTitlePh: 'e.g. Summarize yesterday line data',
+    fDesc: 'Task description',
+    fDescPh: 'Instructions sent to the channel (optional)',
+    fMode: 'Trigger mode',
+    fInterval: 'Interval',
+    fIntervalUnit: 'min (min 1)',
+    fDailyTime: 'Daily time',
+    fDailyHint: 'Local timezone HH:MM',
+    fFuse: 'Consecutive-failure trip limit',
+    fFuseHint: '0 = never auto-disable; re-enable resets the counter',
+    fSubmitHint: 'On trigger the task is submitted to the channel; if the channel is busy it waits and fires as soon as everything settles.',
+    nameRequired: 'Name is required',
+    channelRequired: 'Pick a channel',
+    titleRequired: 'Task title is required',
+    badDailyTime: 'Daily time must be a valid HH:MM',
+    saved: 'Schedule updated',
+    created: 'Schedule created',
+    enabledMsg: 'Enabled (timer reset)',
+    disabledMsg: 'Disabled',
+    deleted: 'Schedule deleted',
+    runAccepted: 'Triggered — task {p0} submitted to the channel',
+    channelHasSched: '(scheduled)',
+    enableToggle: 'Enable/disable',
+    historyEmpty: 'No runs yet',
+    runDone: 'Completed',
+    runFail: 'Failed',
+    runOngoing: 'Running',
+    triggerManual: 'Manual',
+    triggerTimer: 'Timer',
+    runTask: 'Channel task:',
   },
   chips: {
     chipAll: 'All {n}',

package/i18n/locales/zh-CN.ts

@@ -913,6 +913,8 @@ export default {
     srcSystem: '系统',
     k9r7d4e016: '周期读(ms)',
     k9r7d4e017: '缺省 5000ms;0 = 仅手动读取',
+    writeLockLabel: '写入保持(s)',
+    writeLockHint: '缺省 30s;0 = 不锁;写成功后锁定防震荡',
     k9r7d4e018: 'PLC 读数',
     k9r7d4e019: '暂无读数(周期读未开启或驱动不支持读取)',
     k9r7d4e020: '读取 PLC 当前值',
@@ -1434,6 +1436,7 @@ export default {
     k8n918k013: '已删除模型文件',
   },
   channelSessionList: {
+    schedTagTip: '已绑定 {p0} 个启用的定时任务',
     nameRequired: 'Channel 名称必填',
     defaultSuffix: '(默认)',
     tplCenterTitle: 'Channel 模板中心',
@@ -1568,6 +1571,7 @@ export default {
   },
   commandPalette: {
     gotoTeams: '前往:AgentTeam 编组库',
+    gotoSchedules: '前往:定时任务中心',
     viewLanes: '视图:Agent lanes',
     actA2a: '动作:A2A RPC/SSE 调试器',
     k1nz14ux013: '切换 Channel:{p0}',
@@ -2082,6 +2086,73 @@ export default {
     ctpl: 'Channel 模板中心 · Workshop',
     monitor: '运行时监控 · AgentWorkShop',
     settings: '系统设置 · AgentWorkShop',
+    schedules: '定时任务 · Workshop',
+  },
+  sched: {
+    title: '定时任务',
+    sub: '绑定 Channel 的周期任务:到点自动向 Channel 下发任务;Channel 忙时等其收口后执行。',
+    newBtn: '新建计划',
+    empty: '暂无定时任务 — 新建一个计划,让团队按节奏自动运转',
+    colState: '状态',
+    colPlan: '计划',
+    colName: '名称',
+    colChannel: '频道',
+    colLastRun: '最近运行',
+    stateIdle: '待命',
+    stateRunning: '执行中',
+    stateWaiting: '等 Channel 收口',
+    stateDisabled: '已停用',
+    stateFailed: '失败',
+    stateTripped: '已熔断',
+    modeInterval: '每 {p0}',
+    modeDaily: '每天 {p0}',
+    minutes: '{p0} 分钟',
+    hours: '{p0} 小时',
+    modeIntervalRadio: '固定间隔',
+    modeDailyRadio: '每日定点',
+    nextRun: '下次:',
+    statLine: '共 {p0} 次 / 失败 {p1}',
+    fuseLine: '熔断 {p0}/{p1}',
+    runNowTitle: '立即执行',
+    historyTitle: '运行历史',
+    deleteConfirm: '删除该定时任务?运行历史将一并删除',
+    editTitle: '编辑定时任务',
+    createTitle: '新建定时任务',
+    fName: '计划名称',
+    fNamePh: '如:产线晨检',
+    fChannel: '绑定 Channel',
+    fChannelPh: '选择到点后接任务的 Channel',
+    fTitle: '任务标题(到点下发的任务名)',
+    fTitlePh: '如:汇总昨日产线数据并生成晨报',
+    fDesc: '任务描述',
+    fDescPh: '下发给 Channel 的任务说明(可留空)',
+    fMode: '触发模式',
+    fInterval: '执行间隔',
+    fIntervalUnit: '分钟(最小 1 分钟)',
+    fDailyTime: '每日执行时刻',
+    fDailyHint: '本地时区 HH:MM',
+    fFuse: '连续失败熔断阈值',
+    fFuseHint: '0 = 不自动停用;达到阈值自动停用,重新启用即重置',
+    fSubmitHint: '到点即向 Channel 提交该任务;Channel 有未收口任务时自动等待,收口后立即执行。',
+    nameRequired: '请填写计划名称',
+    channelRequired: '请选择绑定的 Channel',
+    titleRequired: '请填写任务标题',
+    badDailyTime: '每日执行时刻须为合法 HH:MM',
+    saved: '定时任务已更新',
+    created: '定时任务已创建',
+    enabledMsg: '已启用(重新计时)',
+    disabledMsg: '已停用',
+    deleted: '定时任务已删除',
+    runAccepted: '已触发,任务 {p0} 已提交到 Channel',
+    channelHasSched: '(已绑定时任务)',
+    enableToggle: '启用/停用',
+    historyEmpty: '暂无运行记录',
+    runDone: '完成',
+    runFail: '失败',
+    runOngoing: '执行中',
+    triggerManual: '手动',
+    triggerTimer: '定时',
+    runTask: 'Channel 任务:',
   },
   chips: {
     chipAll: '全部 {n}',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.44",
+  "version": "0.7.46",
   "type": "module",
   "description": "AgentWorkShop \u8f6f\u4ef6\u5f00\u53d1\u7cfb\u7edf - \u57fa\u4e8e Nuxt 4 \u7684\u914d\u7f6e\u9a71\u52a8\u8fd0\u884c\u8303\u5f0f",
   "license": "PolyForm-Noncommercial-1.0.0",
@@ -71,14 +71,13 @@
     "prepublishOnly": "node bin/aw.mjs build",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "typecheck": "nuxt typecheck",
+    "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",
     "prepare": "husky",
-    "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
     "test:api-live": "node scripts/api-live-e2e.mjs",
     "ui:seed": "node scripts/ui/seed-demo.mjs",
     "ui:shots": "node scripts/ui/shots.mjs",

package/scripts/_audit/detached-instance.mjs

@@ -0,0 +1,112 @@
+/**
+ * 把 AgentWorkShop 以**真分离**方式拉起(dev 或 start),用于真实 E2E 的长跑服务。
+ *
+ * 为什么不用 agent 工具的后台作业:回合结束/回收时会连子进程一起终止,
+ * 表现为「日志停在半路、无 fatal、端口释放、退出码 1」,极易误判成服务崩溃。
+ *
+ * 为什么带隔离:`ensureDataDir()` 在 repo 模式下解析到 `.AgentWorkShop/data`
+ * (线上累积数据)。E2E 必须用**全新 AW_HOME**(home 模式),否则会污染真实库,
+ * 也会读到历史脏数据导致断言随机失败。
+ *
+ * 用法:
+ *   node scripts/_audit/detached-instance.mjs --port 3457 [--mode dev|start] [--home <dir>]
+ *   node scripts/_audit/detached-instance.mjs --port 3457 --status
+ *   node scripts/_audit/detached-instance.mjs --port 3457 --stop
+ */
+import { spawn, spawnSync } from 'node:child_process'
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const arg = (k, d) => {
+  const i = process.argv.indexOf(k)
+  return i >= 0 ? process.argv[i + 1] : d
+}
+const repo = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
+const PORT = Number(arg('--port', '3457'))
+const MODE = arg('--mode', 'dev')
+const HOME = resolve(arg('--home', join(repo, '.e2e-home')))
+const LOG = resolve(arg('--log', join(repo, `.e2e-${MODE}-${PORT}.log`)))
+const PIDFILE = `${LOG}.pid`
+const BASE = `http://127.0.0.1:${PORT}`
+
+const health = async () => {
+  try {
+    const r = await fetch(`${BASE}/api/health`, { signal: AbortSignal.timeout(8000) })
+    const j = await r.json()
+    return j?.data?.status === 'ok' ? { ok: true, version: j.data.version, uptimeMs: j.data.uptimeMs } : { ok: false }
+  }
+  catch { return { ok: false } }
+}
+
+if (process.argv.includes('--status')) {
+  const h = await health()
+  console.log(h.ok ? `✔ 健康 version=${h.version} uptime=${Math.round(h.uptimeMs / 1000)}s` : '✖ 不可达')
+  const pid = existsSync(PIDFILE) ? readFileSync(PIDFILE, 'utf8').trim() : '(无 pid 文件)'
+  console.log(`  pid=${pid}  log=${LOG}  AW_HOME=${HOME}`)
+  if (existsSync(LOG)) {
+    const tail = readFileSync(LOG, 'utf8').split(/\r?\n/).filter(Boolean).slice(-8)
+    for (const l of tail) console.log('    ' + l.slice(0, 160))
+  }
+  process.exitCode = h.ok ? 0 : 1
+}
+else if (process.argv.includes('--stop')) {
+  const pid = existsSync(PIDFILE) ? Number(readFileSync(PIDFILE, 'utf8').trim()) : NaN
+  if (Number.isInteger(pid)) {
+    const r = spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore' })
+    console.log(r.status === 0 ? `✔ 已终止 pid=${pid}` : `· taskkill 退出码 ${r.status}(可能已退出)`)
+  }
+  else console.log('· 无 pid 文件')
+}
+else {
+  const pre = await health()
+  if (pre.ok) {
+    console.log(`· ${BASE} 已有健康实例(version=${pre.version}),不重复启动`)
+  }
+  else {
+    mkdirSync(HOME, { recursive: true })
+    const out = openSync(LOG, 'a')
+    // 本机 7890 代理会拦 localhost;AW_MODE=home + AW_HOME 指向全新目录 = 完全隔离
+    const env = {
+      ...process.env,
+      NO_PROXY: '127.0.0.1,localhost',
+      HTTP_PROXY: '',
+      HTTPS_PROXY: '',
+      no_proxy: '127.0.0.1,localhost',
+      AW_MODE: 'home',
+      AW_HOME: HOME,
+      NUXT_SESSION_PASSWORD: process.env.NUXT_SESSION_PASSWORD ?? 'e2e-session-password-0123456789abcdef',
+    }
+    const args = [join(repo, 'bin', 'aw.mjs'), MODE, '--port', String(PORT)]
+    const child = spawn(process.execPath, args, { cwd: repo, env, detached: true, windowsHide: true, stdio: ['ignore', out, out] })
+    closeSync(out)
+    child.unref()
+    writeFileSync(PIDFILE, String(child.pid), 'utf8')
+    console.log(`✔ 已分离启动(${MODE}) pid=${child.pid} → ${BASE}`)
+    console.log(`  AW_HOME=${HOME}`)
+    console.log(`  日志 ${LOG}`)
+
+    const waitS = Number(arg('--wait', MODE === 'dev' ? '180' : '60'))
+    let ok = false
+    for (let i = 0; i < waitS; i += 3) {
+      await new Promise(r => setTimeout(r, 3000))
+      const h = await health()
+      if (h.ok) {
+        console.log(`✔ 健康门通过 version=${h.version}(${i + 3}s)`)
+        ok = true
+        break
+      }
+    }
+    if (!ok) {
+      console.error(`✖ ${waitS}s 内未通过健康门,看日志:${LOG}`)
+      if (existsSync(LOG)) {
+        const tail = readFileSync(LOG, 'utf8').split(/\r?\n/).filter(Boolean).slice(-15)
+        for (const l of tail) console.error('    ' + l.slice(0, 160))
+      }
+      process.exitCode = 1
+    }
+    else if (existsSync(LOG)) {
+      console.log(`  日志大小 ${(statSync(LOG).size / 1024).toFixed(1)} KB`)
+    }
+  }
+}

package/scripts/_audit/stubs/nuxt-imports.mjs

@@ -0,0 +1,67 @@
+/**
+ * Nuxt `#imports` 测试桩 —— 纯 node / tsx 环境下加载 server 侧源码时使用
+ * (无 Nuxt 运行时,`#imports` 这个虚拟模块在 Node ESM 里不可解析)。
+ *
+ * 只实现 server 侧真正用到的 `useRuntimeConfig()`:取值来自**共享配置引擎**
+ * (shared/config/engine.mjs,config.yml 的单一事实来源),映射口径与
+ * nuxt.config.ts 的 `runtimeConfig` 逐键一致 —— 回归脚本看到的配置与真实
+ * Nitro 运行期同源,不引入第二套默认值。
+ *
+ * 仅用于脚本/回归;真实运行始终走 Nuxt → Nitro。挂在 scripts/_audit/ts-resolve-hook.mjs 上。
+ */
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve as pathResolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findUp, loadEffective, settingsPathFor } from '../../../shared/config/engine.mjs'
+
+const REPO = pathResolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..')
+
+/** 定位配置根(含 config.yml 的目录;优先 cwd 向上,再回落仓库根) */
+function configRoot() {
+  try {
+    const hit = findUp(process.cwd(), 'config.yml')
+    if (hit) return dirname(hit)
+  }
+  catch { /* 继续 */ }
+  return existsSync(join(REPO, 'config.yml')) ? REPO : process.cwd()
+}
+
+/** 等价于 Nuxt 的 useRuntimeConfig()(public + 服务端专用键) */
+export function useRuntimeConfig() {
+  const root = configRoot()
+  const settings = settingsPathFor(root)
+  const { effective } = loadEffective({
+    configPath: join(root, 'config.yml'),
+    settingsPath: existsSync(settings) ? settings : undefined,
+  })
+  const get = (key, fallback) => (effective[key] !== undefined ? effective[key] : fallback)
+
+  return {
+    apiPageSize: get('api.pageSize', 20),
+    apiMaxPageSize: get('api.maxPageSize', 100),
+    session: { password: get('security.sessionPassword', '') },
+    approvalGate: get('security.approvalGate', false),
+    daq: {
+      startInfrastructure: get('daq.startInfrastructure', 'auto'),
+      mqtt: { host: get('daq.mqtt.host', '127.0.0.1'), port: get('daq.mqtt.port', 1883) },
+      timescale: { host: get('daq.timescale.host', '127.0.0.1'), port: get('daq.timescale.port', 5432) },
+    },
+    public: {
+      appName: get('app.name', 'AgentWorkShop'),
+      appTitle: get('app.title', 'AgentWorkShop'),
+      version: get('app.version', '0.0.0'),
+      description: get('app.description', ''),
+      mode: get('mode', 'dev'),
+      apiBase: get('api.baseURL', '/api'),
+      apiTimeout: get('api.timeout', 15_000),
+      primaryColor: get('theme.primaryColor', '#35e0a0'),
+      themeMode: get('theme.mode', 'light'),
+      serverHost: get('server.host', '0.0.0.0'),
+      devPort: get('server.dev.port', 3000),
+      prodPort: get('server.prod.port', 3001),
+      defaultLocale: get('i18n.defaultLocale', 'zh-CN'),
+    },
+  }
+}
+
+export default { useRuntimeConfig }

package/scripts/_audit/ts-register-hook.mjs

@@ -0,0 +1,12 @@
+/**
+ * `--import` 入口:把 TS 解析钩子注册为 Node ESM loader。
+ *
+ * 用途:纯 node 直接运行 server 侧 .ts 回归脚本(Node 24 内建类型擦除):
+ *   node --import ./scripts/_audit/ts-register-hook.mjs scripts/<suite>.ts
+ *
+ * 与 `register(new URL('./ts-resolve-hook.mjs', ...))` 的 .mjs 包装脚本等价;
+ * 单独成文件是为了让 `--import`(只执行、不注册)也能生效,避免钩子被注册两次。
+ */
+import { register } from 'node:module'
+
+register(new URL('./ts-resolve-hook.mjs', import.meta.url).href)