agentworkshop 0.8.6 → 0.8.8

package/config.yml

@@ -1,193 +1,212 @@
-# ============================================================
-# 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.8.6
-  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
-
-# 系统时间：人读日志/聊天/审计/调度的统一 IANA 时区；默认上海。DAQ 原始时间轴仍为绝对时间。
-time:
-  timeZone: Asia/Shanghai
-
-# 主题
-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)
-
-# Optimizer Solver(本地 Python Worker;复用 AML .venv)
-optimizer:
-  solver:
-    poolSize: 1             # 进程池(1-4;每进程同时 1 个 solve)
-    requestTimeoutMs: 30000 # 单次求解硬超时
-    threads: 1              # OMP/OPENBLAS/MKL/NUMEXPR 线程预算
-  crosscheck:
-    tol: 0.000001           # 候选互校逐 CV 无量纲一致性容差(AW_OPTIMIZER_CROSSCHECK_TOL)
-
-# 数据保留清理(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)
-  optimizer_days: 365       # Optimizer 运行/建议/收益台账
-  process_model_days: 365   # 过程模型资格/试验台账
-
-# 服务端日志(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
-  uq:
-    freshDays: 7    # 工件 UQ 校准保鲜天数(AW_AML_UQ_FRESH_DAYS),超期建议降级 unverified
+# ============================================================
+# 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.8.8
+  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
+
+# 系统时间：人读日志/聊天/审计/调度的统一 IANA 时区；默认上海。DAQ 原始时间轴仍为绝对时间。
+time:
+  timeZone: Asia/Shanghai
+
+# 主题
+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
+    # 口令不落仓库:留空则用服务端生成的本机凭据(data/daq-infra-credentials.env),
+    # 或用环境变量 AW_DAQ_TIMESCALE_PASSWORD 显式覆盖(外部托管实例请显式设置)。
+    password: ""
+    database: awshop
+    poolMax: 8                       # 连接池上限(写入攒批 + 并发查询)
+    statementTimeoutMs: 30000        # 单条 SQL 超时,防异常查询长期占用连接
+  # 分层保留(数据不会"满 7 天直接删"):
+  #   raw 原始样本 → tsRetentionH(缺省 720h = 30 天)
+  #   之后自动保留 1 分钟聚合 → rollup.minuteRetentionH(缺省 8760h = 1 年)
+  #   再之后保留 1 小时聚合 → rollup.hourRetentionH(0 = 永久,适合长期趋势/审计)
+  # 超过 raw 保留期的查询会自动走聚合表;逐产线可在 /api/workshop/daq/storage/retention 覆写。
+  tsRetentionH: 720
+  rollup:
+    enabled: true
+    intervalMs: 600000             # 聚合调度间隔 10min
+    lagMs: 300000                  # 只聚合 5min 前的闭合窗口
+    windowMs: 3600000              # 单窗口 1h
+    maxWindowsPerRun: 24           # 单轮最多 24 个窗口(积压多轮追平)
+    minuteRetentionH: 8760         # 1m 聚合保留 1 年
+    hourRetentionH: 0              # 1h 聚合永久保留
+  # 对象存储(图像帧;MinIO,S3 兼容)。不可达时自动降级本地磁盘 data/daq-objects/,采集不中断。
+  objectstore:
+    host: 127.0.0.1
+    port: 9000
+    # 同上:留空 = 本机生成的凭据;也可用 AW_DAQ_OBJECTSTORE_ACCESSKEY / AW_DAQ_OBJECTSTORE_SECRETKEY
+    accessKey: ""
+    secretKey: ""
+    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)
+
+# Optimizer Solver(本地 Python Worker;复用 AML .venv)
+optimizer:
+  solver:
+    poolSize: 1             # 进程池(1-4;每进程同时 1 个 solve)
+    requestTimeoutMs: 30000 # 单次求解硬超时
+    threads: 1              # OMP/OPENBLAS/MKL/NUMEXPR 线程预算
+  crosscheck:
+    tol: 0.000001           # 候选互校逐 CV 无量纲一致性容差(AW_OPTIMIZER_CROSSCHECK_TOL)
+
+# 数据保留清理(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)
+  optimizer_days: 365       # Optimizer 运行/建议/收益台账
+  process_model_days: 365   # 过程模型资格/试验台账
+
+# 服务端日志(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
+  uq:
+    freshDays: 7    # 工件 UQ 校准保鲜天数(AW_AML_UQ_FRESH_DAYS),超期建议降级 unverified

package/docker-compose.yml

@@ -1,63 +1,69 @@
-# ============================================================
-# AgentWorkShop 数采基础设施(DAQ infrastructure)
-# ------------------------------------------------------------
-# 与 config.yml `daq:` 段默认一致;项目启动时若端口不通且存在 Docker,
-# 服务端自动执行 `docker compose up -d daq-mosquitto daq-timescale daq-minio`。
-#   - daq-mosquitto:标准 MQTT 3.1.1/5 broker(数采下沉队列)
-#   - daq-timescale:TimescaleDB(时序数据/帧元数据持久化;named volume 常驻)
-#   - daq-minio:    S3 兼容对象存储(图像帧像素;named volume 常驻)
-# 手动启动:docker compose up -d
-# ============================================================
-services:
-  daq-mosquitto:
-    image: eclipse-mosquitto:2
-    container_name: awshop-daq-mosquitto
-    # no-auth 配置:内网/开发态;生产请挂载自定义 mosquitto.conf 启用鉴权/TLS。
-    # 2026-10-28(S13):默认只绑 127.0.0.1,避免同网段任意主机向队列注入样本;
-    # 跨机部署请显式改回 0.0.0.0 并同时启用 broker 账号/TLS。
-    command: ["mosquitto", "-c", "/mosquitto-no-auth.conf"]
-    ports:
-      - "127.0.0.1:1883:1883"   # 与 config.yml daq.mqtt.port 一致
-    restart: unless-stopped
-
-  daq-timescale:
-    image: timescale/timescaledb:latest-pg16
-    container_name: awshop-daq-timescale
-    # TSL license(自托管免费):列存压缩(compression policy)是 Community 特性,
-    # 默认 apache license 下 ALTER TABLE ... SET(timescaledb.compress) 直接报错
-    # (P0-3;服务端逐条守护只告警不阻断,但要真开压缩必须用本参数启动)。
-    command: ["postgres", "-c", "timescaledb.license=timescale"]
-    # ⚠️ 必须显式放大 /dev/shm:Docker 默认只给 64MB,而 PostgreSQL 的并行查询
-    # 会按需扩容共享内存段 —— 不够时报的错是
-    #   could not resize shared memory segment "...": No space left on device
-    # 这句话看起来像"磁盘满了",实际是 shm 满了,极难排查(实测在回退账本的
-    # 兜底评估查询上稳定复现,而宿主机还剩 230GB)。512MB 是 Postgres 官方镜像文档的建议值。
-    shm_size: 512mb
-    environment:
-      POSTGRES_USER: postgres        # config.yml daq.timescale.user
-      POSTGRES_PASSWORD: awshop      # config.yml daq.timescale.password
-      POSTGRES_DB: awshop            # config.yml daq.timescale.database
-    ports:
-      - "5432:5432"                  # 与 config.yml daq.timescale.port 一致
-    volumes:
-      - awshop-daq-tsdata:/var/lib/postgresql/data
-    restart: unless-stopped
-
-  daq-minio:
-    image: minio/minio:latest
-    container_name: awshop-daq-minio
-    # S3 兼容对象存储:图像帧像素落这里,Timescale 只存元数据(daq_frames.meta.objectKey)
-    command: ["server", "/data", "--console-address", ":9001"]
-    environment:
-      MINIO_ROOT_USER: awshop            # config.yml daq.objectstore.accessKey
-      MINIO_ROOT_PASSWORD: awshop-secret # config.yml daq.objectstore.secretKey
-    ports:
-      - "9000:9000"                  # S3 API(与 config.yml daq.objectstore.port 一致)
-      - "9001:9001"                  # Web 控制台(开发态观察用)
-    volumes:
-      - awshop-daq-objdata:/data
-    restart: unless-stopped
-
-volumes:
-  awshop-daq-tsdata:
-  awshop-daq-objdata:
+# ============================================================
+# AgentWorkShop 数采基础设施(DAQ infrastructure)
+# ------------------------------------------------------------
+# 与 config.yml `daq:` 段默认一致;项目启动时若端口不通且存在 Docker,
+# 服务端自动执行 `docker compose up -d daq-mosquitto daq-timescale daq-minio`。
+#   - daq-mosquitto:标准 MQTT 3.1.1/5 broker(数采下沉队列)
+#   - daq-timescale:TimescaleDB(时序数据/帧元数据持久化;named volume 常驻)
+#   - daq-minio:    S3 兼容对象存储(图像帧像素;named volume 常驻)
+# 手动启动(凭据必须显式提供,仓库不再内置口令):
+#   docker compose --env-file <AW_DATA_DIR>/daq-infra-credentials.env up -d
+#   (服务端首次启动会生成该文件;或自行 export AW_DAQ_TIMESCALE_PASSWORD /
+#    AW_DAQ_OBJECTSTORE_ACCESSKEY / AW_DAQ_OBJECTSTORE_SECRETKEY)
+# 端口只绑 127.0.0.1:跨机部署请显式改绑定并启用 TLS/账号(audit P0-5,2026-10-30)。
+# ============================================================
+services:
+  daq-mosquitto:
+    image: eclipse-mosquitto:2
+    container_name: awshop-daq-mosquitto
+    # no-auth 配置:内网/开发态;生产请挂载自定义 mosquitto.conf 启用鉴权/TLS。
+    # 2026-10-28(S13):默认只绑 127.0.0.1,避免同网段任意主机向队列注入样本;
+    # 跨机部署请显式改回 0.0.0.0 并同时启用 broker 账号/TLS。
+    command: ["mosquitto", "-c", "/mosquitto-no-auth.conf"]
+    ports:
+      - "127.0.0.1:1883:1883"   # 与 config.yml daq.mqtt.port 一致
+    restart: unless-stopped
+
+  daq-timescale:
+    image: timescale/timescaledb:latest-pg16
+    container_name: awshop-daq-timescale
+    # TSL license(自托管免费):列存压缩(compression policy)是 Community 特性,
+    # 默认 apache license 下 ALTER TABLE ... SET(timescaledb.compress) 直接报错
+    # (P0-3;服务端逐条守护只告警不阻断,但要真开压缩必须用本参数启动)。
+    command: ["postgres", "-c", "timescaledb.license=timescale"]
+    # ⚠️ 必须显式放大 /dev/shm:Docker 默认只给 64MB,而 PostgreSQL 的并行查询
+    # 会按需扩容共享内存段 —— 不够时报的错是
+    #   could not resize shared memory segment "...": No space left on device
+    # 这句话看起来像"磁盘满了",实际是 shm 满了,极难排查(实测在回退账本的
+    # 兜底评估查询上稳定复现,而宿主机还剩 230GB)。512MB 是 Postgres 官方镜像文档的建议值。
+    shm_size: 512mb
+    environment:
+      POSTGRES_USER: postgres        # config.yml daq.timescale.user
+      POSTGRES_PASSWORD: ${AW_DAQ_TIMESCALE_PASSWORD:?AW_DAQ_TIMESCALE_PASSWORD 未设置:见服务端数据目录 daq-infra-credentials.env 或自行 export}
+      POSTGRES_DB: awshop            # config.yml daq.timescale.database
+    ports:
+      - "127.0.0.1:5432:5432"        # 与 config.yml daq.timescale.port 一致;仅本机可连
+    volumes:
+      - awshop-daq-tsdata:/var/lib/postgresql/data
+    restart: unless-stopped
+
+  daq-minio:
+    image: minio/minio:latest
+    container_name: awshop-daq-minio
+    # S3 兼容对象存储:图像帧像素落这里,Timescale 只存元数据(daq_frames.meta.objectKey)
+    command: ["server", "/data", "--console-address", ":9001"]
+    environment:
+      MINIO_ROOT_USER: ${AW_DAQ_OBJECTSTORE_ACCESSKEY:?AW_DAQ_OBJECTSTORE_ACCESSKEY 未设置}
+      MINIO_ROOT_PASSWORD: ${AW_DAQ_OBJECTSTORE_SECRETKEY:?AW_DAQ_OBJECTSTORE_SECRETKEY 未设置}
+    ports:
+      - "127.0.0.1:9000:9000"        # S3 API(与 config.yml daq.objectstore.port 一致;仅本机可连)
+    # Web 控制台(9001)默认不 publish:需要调试时用
+    #   docker compose -f docker-compose.yml -f docker-compose.debug.yml up -d
+    # 或临时 `docker port awshop-daq-minio 9001` 走容器网络访问。
+    volumes:
+      - awshop-daq-objdata:/data
+    restart: unless-stopped
+
+volumes:
+  awshop-daq-tsdata:
+  awshop-daq-objdata: