agentworkshop 0.7.54 → 0.7.59

package/server/services/workshop/daq/storage/timescale.adapter.ts

@@ -57,6 +57,8 @@ export class TimescaleAdapter implements TsdbPort {
     await this.pool.query('CREATE TABLE IF NOT EXISTS daq_frames (node_id text NOT NULL, ts timestamptz NOT NULL, kind text NOT NULL, template_key text, device_binding_id text, line_id text, product_id text, recipe_id text, run_id text, points integer NOT NULL DEFAULT 0, meta jsonb NOT NULL DEFAULT \'{}\'::jsonb, metrics jsonb NOT NULL DEFAULT \'{}\'::jsonb, PRIMARY KEY (node_id, ts))').catch(() => {})
     await this.pool.query(`SELECT create_hypertable('daq_frames', 'ts', if_not_exists => TRUE, migrate_data => TRUE)`).catch(() => {})
     await this.pool.query(`CREATE INDEX IF NOT EXISTS idx_daq_frames_node_ts ON daq_frames (node_id, ts DESC)`).catch(() => {})
+    // P0-3 物理参数(chunk=1 天 + 列存压缩;逐条守护)
+    await this.applyPhysicalPolicies()
     // 保留期:drop_chunks 周期执行(30min;未装扩展时静默跳过)
     void this.sweepRetention()
     if (!this.retentionTimer) {
@@ -65,6 +67,35 @@ export class TimescaleAdapter implements TsdbPort {
     }
   }
 
+  /**
+   * P0-3 物理(chunk/压缩)策略 —— 逐条守护,任一失败只告警不阻断 init:
+   * init 整体失败会被工厂降级 SQLite(等于扔掉生产库),绝不允许。
+   *  - chunk 钉 1 天(扩展默认 7 天 → drop_chunks 粒度过粗,空间回收滞后保留期一个 chunk);
+   *    与对象存储 GC 的 UTC 天前缀、保留期注释同一粒度。set_chunk_time_interval 只影响未来 chunk,
+   *    存量 7 天 chunk 靠 retention 自然出清。
+   *  - 列存压缩 segmentby=node_id / orderby=ts DESC(PK 全覆盖,ON CONFLICT 语义保持);
+   *    压缩窗 1 天 —— 活动 chunk 永不解压,写入冲突恒落未压缩 chunk;迟到 >1 天写入由
+   *    TS 2.11+ 压缩 chunk DML 支持。压缩是 TSL 特性:社区镜像默认 apache license 会报错,
+   *    需 docker-compose 以 `timescaledb.license=timescale` 启动(见 docker-compose.yml)。
+   */
+  private async applyPhysicalPolicies(): Promise<void> {
+    if (!this.pool) return
+    const steps: Array<[string, string]> = [
+      ['chunk_interval@daq_samples', `SELECT set_chunk_time_interval('daq_samples', INTERVAL '1 day')`],
+      ['chunk_interval@daq_frames', `SELECT set_chunk_time_interval('daq_frames', INTERVAL '1 day')`],
+      ['compress@daq_samples', `ALTER TABLE daq_samples SET (timescaledb.compress, timescaledb.compress_segmentby = 'node_id', timescaledb.compress_orderby = 'ts DESC')`],
+      ['compress@daq_frames', `ALTER TABLE daq_frames SET (timescaledb.compress, timescaledb.compress_segmentby = 'node_id', timescaledb.compress_orderby = 'ts DESC')`],
+      ['compress_policy@daq_samples', `SELECT add_compression_policy('daq_samples', INTERVAL '1 day', if_not_exists => TRUE)`],
+      ['compress_policy@daq_frames', `SELECT add_compression_policy('daq_frames', INTERVAL '1 day', if_not_exists => TRUE)`],
+    ]
+    for (const [name, sql] of steps) {
+      await this.pool.query(sql).catch((err: unknown) => {
+        const msg = err instanceof Error ? (err.message.split('\n')[0] ?? '') : String(err)
+        console.warn(`[timescale] 物理策略 ${name} 未生效: ${msg} —— 列存压缩需 timescaledb.license=timescale(TSL,自托管免费)`)
+      })
+    }
+  }
+
   private async sweepRetention(): Promise<void> {
     if (!this.pool) return
     try {
@@ -107,19 +138,22 @@ export class TimescaleAdapter implements TsdbPort {
   async query(nodeId: string, opts: DaqQueryOpts): Promise<TsdbPoint[]> {
     if (!this.pool) return []
     const limit = Math.min(opts.limit ?? 500, 5000)
+    // 时间正序(ASC):与 queryTagged 契约一致 —— 消费方(daq_query 最新/最近序列、
+    // daq_export 游标续页、AML 网格对齐)都按升序假设;窗口超 limit 时截取的是**最旧**段,
+    // 续页游标(lastAt+1)依赖升序才能翻完整窗。
     if (opts.bucketMs && opts.bucketMs >= 100) {
       const { rows } = await this.pool.query(
         `SELECT time_bucket($1::interval, ts) AS bucket,
                 avg(value)::double precision AS avg, min(value) AS min, max(value) AS max, count(*) AS cnt
          FROM daq_samples WHERE node_id = $2 AND ts >= $3 AND ts <= $4
-         GROUP BY bucket ORDER BY bucket DESC LIMIT $5`,
+         GROUP BY bucket ORDER BY bucket ASC LIMIT $5`,
         [`${opts.bucketMs} milliseconds`, nodeId, new Date(opts.fromMs ?? 0).toISOString(), new Date(opts.toMs ?? Date.now()).toISOString(), limit],
       )
       return rows.map(r => ({ at: Date.parse(r.bucket), avg: Number(r.avg), min: Number(r.min), max: Number(r.max), cnt: Number(r.cnt) }))
     }
     const { rows } = await this.pool.query(
       `SELECT ts, value, state FROM daq_samples WHERE node_id = $1 AND ts >= $2 AND ts <= $3
-       ORDER BY ts DESC LIMIT $4`,
+       ORDER BY ts ASC LIMIT $4`,
       [nodeId, new Date(opts.fromMs ?? 0).toISOString(), new Date(opts.toMs ?? Date.now()).toISOString(), limit],
     )
     return rows.map(r => ({ at: tsToMs(r.ts), value: Number(r.value), state: String(r.state) }))
@@ -154,7 +188,7 @@ export class TimescaleAdapter implements TsdbPort {
     params.push(new Date(q.fromMs ?? 0).toISOString())
     where.push(`ts <= $${params.length + 1}`)
     params.push(new Date(q.toMs ?? Date.now()).toISOString())
-    const limit = Math.min(q.limit ?? 2000, 10_000)
+    const limit = Math.min(q.limit ?? 2000, 1_000_000)
     const whereSql = where.join(' AND ')
     if (q.bucketMs && q.bucketMs >= 100) {
       const { rows } = await this.pool.query(

package/server/services/workshop/db/database/migrations.ts

@@ -46,6 +46,16 @@ export function migrateAddColumn(db: DatabaseSync, table: string, column: string
   }
 }
 
+/**
+ * 产线 Co-Pilot P2:审批历史结构化载荷列(加列式迁移,既有行安全 —— 历史行
+ * payload_json 为 NULL、choice 为 NULL,读取层按「空则文本降级」处理,不回填改史)。
+ * payload_json = 整包方案审批单的方案集+预检结果;choice = 批准时选定的包下标。
+ */
+export function migrateApprovalPayloadColumns(db: DatabaseSync): void {
+  migrateAddColumn(db, 'approval_history', 'payload_json', 'TEXT')
+  migrateAddColumn(db, 'approval_history', 'choice', 'INTEGER')
+}
+
 /** AgentTeam guardrail task metadata; additive and safe for existing task rows. */
 export function migrateAgentTeamTaskGuardrailColumns(db: DatabaseSync): void {
   migrateAddColumn(db, 'tasks', 'source_chat_message_id', 'TEXT')
@@ -236,11 +246,12 @@ export function migrateDropOwnerFks(db: DatabaseSync): void {
           id            TEXT PRIMARY KEY,
           name          TEXT NOT NULL,
           description   TEXT NOT NULL DEFAULT '',
+          visibility    TEXT NOT NULL DEFAULT 'private',
           owner_user_id TEXT,
           created_at    TEXT NOT NULL,
           updated_at    TEXT NOT NULL
         );
-        INSERT INTO teams_new SELECT id, name, description, owner_user_id, created_at, updated_at FROM teams;`,
+        INSERT INTO teams_new SELECT id, name, description, visibility, owner_user_id, created_at, updated_at FROM teams;`,
     })
   }
   if (rebuilds.length === 0) return

package/server/services/workshop/db/database/open.ts

@@ -6,7 +6,7 @@ import type * as sqliteVec from 'sqlite-vec'
 import { DatabaseSync } from 'node:sqlite'
 import { SCHEMA_SQL } from './schema'
 import { createRequire } from 'node:module'
-import { migrateAddColumn, migrateAgentTeamExecutionLeaseColumns, migrateAgentTeamTaskGuardrailColumns, migrateAgentTeamTaskGuardrails, migrateAgentTeamTaskQueueColumns, migrateAmlChannelOptimizationColumns, migrateAmlModelIdentityColumns, migrateDropOwnerFks, migrateGroupChatV17, migrateLegacySchema, migrateMissingForeignKeys, migrateAmlTwinProviderColumns } from './migrations'
+import { migrateAddColumn, migrateAgentTeamExecutionLeaseColumns, migrateAgentTeamTaskGuardrailColumns, migrateAgentTeamTaskGuardrails, migrateAgentTeamTaskQueueColumns, migrateAmlChannelOptimizationColumns, migrateAmlModelIdentityColumns, migrateApprovalPayloadColumns, migrateDropOwnerFks, migrateGroupChatV17, migrateLegacySchema, migrateMissingForeignKeys, migrateAmlTwinProviderColumns } from './migrations'
 import { seedDefaultWorkshopData } from './seed'
 
 export const require = createRequire(import.meta.url)
@@ -54,6 +54,8 @@ export function initWorkshopDb(db: DatabaseSync): void {
   migrateAddColumn(db, 'audit_log', 'recipe_id', 'TEXT NOT NULL DEFAULT \'\'')
   migrateAddColumn(db, 'audit_log', 'kind', 'TEXT NOT NULL DEFAULT \'\'')
   migrateAddColumn(db, 'audit_log', 'summary', 'TEXT NOT NULL DEFAULT \'\'')
+  // 2026-10-08 写控 ACK 鉴定:严重级列(info/warn/error;既有库补列,历史行按 info 语义)
+  migrateAddColumn(db, 'audit_log', 'level', 'TEXT NOT NULL DEFAULT \'info\'')
   migrateMissingForeignKeys(db)
   // Run after legacy task-table rebuilds so guardrail metadata and its index survive upgrades.
   migrateAgentTeamTaskQueueColumns(db)
@@ -64,6 +66,8 @@ export function initWorkshopDb(db: DatabaseSync): void {
   migrateAmlTwinProviderColumns(db)
   migrateAmlModelIdentityColumns(db)
   migrateAmlChannelOptimizationColumns(db)
+  // 产线 Co-Pilot P2:审批历史结构化载荷列(payload_json/choice;既有库补列,新库 DDL 已含)
+  migrateApprovalPayloadColumns(db)
   seedDefaultWorkshopData(db)
 }
 

package/server/services/workshop/db/database/rows.ts

@@ -253,6 +253,10 @@ export interface MemoryRow {
   agentId: string
   kind: MemoryKind
   title: string
+  /** 去重键(搜索投影含;写侧 upsert 用;可选:历史行兼容) */
+  dedupKey?: string
+  /** 标题分词(FTS 存储列;搜索投影含) */
+  titleFts?: string
   content: string
   importance: number
   taskId: string | null

package/server/services/workshop/db/database/schema.ts

@@ -222,7 +222,11 @@ CREATE TABLE IF NOT EXISTS approval_history (
   decided_by   TEXT NOT NULL DEFAULT '',    -- 裁决人(用户 id;空 = 超时/系统收敛)
   decided_name TEXT NOT NULL DEFAULT '',    -- 裁决人名(呈现用)
   created_at   TEXT NOT NULL,
-  decided_at   TEXT
+  decided_at   TEXT,
+  -- 产线 Co-Pilot P2:结构化审批载荷(整包方案审批单的方案集+预检结果;空串=无载荷)
+  payload_json TEXT,
+  -- 多方案裁决序号(批准时选定的包下标;NULL=非结构化审批单/未携带)
+  choice       INTEGER
 );
 CREATE INDEX IF NOT EXISTS idx_approval_history_created ON approval_history(created_at DESC);
 -- v12:DAQ 报警事件 + ack 闭环(S5:报警持久化/确认/升级)
@@ -258,7 +262,8 @@ CREATE TABLE IF NOT EXISTS audit_log (
   product_id  TEXT NOT NULL DEFAULT '',
   recipe_id   TEXT NOT NULL DEFAULT '',
   kind        TEXT NOT NULL DEFAULT '',     -- write|manual|alarm|line|recipe|rollback|daq|system
-  summary     TEXT NOT NULL DEFAULT ''
+  summary     TEXT NOT NULL DEFAULT '',
+  level       TEXT NOT NULL DEFAULT 'info'  -- 严重级:info|warn|error(写控 ACK 鉴定;2026-10-08)
 );
 CREATE INDEX IF NOT EXISTS idx_audit_log_at ON audit_log(at DESC);
 -- v14:高危管理操作双人复核(R3:maker-checker;config 开关默认关)

package/server/services/workshop/db/database/seed.ts

@@ -140,6 +140,77 @@ export const DEFAULT_CHANNEL_TEMPLATES: Array<{
       { inline: { name: '工艺工程师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的工艺工程师,按知识调优工程师的方案走配方链路执行:my_industrial_nodes 确认授权 → daq_query 取证 → 把方案转成 recipe_trial(多参数候选整批试验,一次带上所有要改的参数,带 hypothesis 声明依据;不写配方版本)→ 等待工艺惯性后 daq_query 复测 → 有进步/达标用 recipe_update 把候选值固化进配方(同 id 版本+1),需要正式落地用 recipe_apply 整批下发;无进步/劣化用 recipe_rollback(dispatch=true)统一回退(定义回退+PLC 整批恢复)。优化闭环内禁用 dcw_control/param_control 逐参数直调(防震荡)。你的节点授权可能由 lead 在派发时或执行中授予(权限变化以 my_industrial_nodes 实时查询为准)。manual 模式节点下发前说明理由等批准。结论一律引用带单位与时间窗的数据。' } }, role: 'worker' },
     ],
   },
+  {
+    id: 'chtpl-exp-miner-default',
+    name: '经验工程师',
+    description: '产线 Co-Pilot 经验学习频道(只读零写):以只读观察者身份驻守绑定产线,定时(默认 6h,可配)采集增量调优动作,构造「情境→动作→效果」三元组并按置信度演化沉淀入知识库;未经人类确认的本地推断动作只汇报不总结。实例化时建议开知识库集成(enableKnowledgeBase)并绑定产线(bindLineId)。',
+    scenarioPrompt: `## 身份与边界(开工先读完)
+你是本频道唯一的**工艺经验工程师**:以**只读观察者**身份驻守一条已绑定产线,把产线上发生过的调优动作(人类的平台操作 + 本地设定值调整)持续总结成结构化经验,沉淀入知识库,供后续诊断与优化复用。
+你的工具面已**物理移除全部写工具**(数控/参数/配方下发与回退一族不存在)——绝不尝试下发任何参数变更,也绝不请求写授权;发现应当调整之处,只能把「建议」写进汇报并提醒人类,动手永远是人。
+
+## 每轮学习流程(定时触发;手动触发同流程)
+1. **采集增量**:调 exp_collect 拿本产线自上轮以来的增量动作集(含既有经验注册表提示)。平台动作带账本锚与操作者归因;本地推断动作为「待确认」状态。
+2. **分流(诚实性优先)**:平台动作直接进总结流水线;「待确认」的推断动作**绝不总结**——只在本轮汇报中逐条列出(节点/参数/前后值/时间窗/判定依据),提醒人类到产线页确认卡处置;人类确认后,后续轮次方可作为已确认动作参与总结。
+3. **逐条构造三元组**(每轮 ≤10 条,证据最强者优先):
+   - 情境:用 ops_log / daq_query / line_context 查证动作时间窗内的报警、批次与偏差(当时为什么要调;查不到的不要硬编故事);
+   - 动作:改了哪个节点/参数、方向、幅度(带单位)、来源归因(人类 UI 操作 / Agent 既往动作 / 本地调整——来源必须如实标注);
+   - 效果:动作后窗口内相关指标变化(对照动作前基线窗,引用具体数值与时间窗);效果窗不成熟(响应滞后/整定时间不足)→ 标记「下轮复查」,本轮不硬编结论。
+4. **对照既有经验**:先 kb_agent(mode=sync) 检索同产线+同参数+同问题类型的既有经验条目:
+   - 无 → 新增(v1);
+   - 同向新证据 → 升置信:观察(1 例)→ 候选(≥2 例同向)→ 稳(≥3 例同向且效果显著、人类可验证);
+   - 需修订 → 出新版本:标题后缀 | v(n+1),正文首行声明「本文取代《旧标题》」并写明修订原因;不改旧条目。
+5. **入库**:kb_agent(mode=async) 异步提交(标签:经验、<产线>、<配方>;标题格式 \`[产线·配方] 经验: <问题短语> | v1\`),随后用 kb_agent_status 轮询确认入库完成;失败则停在已总结态、下轮重试,同一条不得重复提交。
+6. **汇报**(频道消息,结构化):学到什么(条目标题+一句话结论)/ 跳过什么(哪些没总结、明说原因)/ 待确认几条(提醒人类去产线页处理)。
+
+## 经验条目正文模板(逐项落齐;缺项写「无」并说明)
+情境 / 触发条件 / 动作(参数·方向·幅度·来源归因) / 依据机理 / 效果(前后窗数值+证据引用) / 置信度(观察|候选|稳) / 人工校验(HITL 通过率;新条目写「暂无记录」) / 适用范围与失效条件 / 修订史。
+
+## 诚实性纪律(优先级高于产出量,违反任一即本轮失败)
+- 停线期、样本过短、无因果链、快照瞬变盲区(改了又改回)→ 明说不总结;
+- 绝不虚构证据 id;每处引用必带时间窗与数值;
+- 来源为 Agent 自己的动作也可以学,但必须标注来源,且 Agent 来源的经验**不得单独支撑高置信结论**(升「稳」必须有人类可验证效果兜底);
+- 宁缺毋滥:没有合格证据就空手汇报,不凑数。`,
+    members: [
+      { inline: { name: '经验工程师', harness: 'omp', config: { rpcMode: 'rpc', role: 'lead', systemPromptPrefix: '你是产线工艺经验工程师:只读观察者,严格按频道任务书执行每轮学习流程与诚实性纪律;你的工具面没有任何写工具,绝不尝试下发;结论一律带时间窗、数值与证据引用,证据不足就明说不总结。' } }, role: 'lead' },
+    ],
+  },
+  {
+    id: 'chtpl-line-doctor-default',
+    name: '产线诊断工程师',
+    description: '产线 Co-Pilot 诊断巡检频道(只读巡检+整包方案审批下发):定时(默认 30min,可配)轻巡读数/报警/操作留痕并检索经验库输出运行判断,每日一次 diag_run 深度诊断入库,发现优化空间先查 AML 活动闸,再以 recipe_propose 提交 1~3 套整包候选方案(逐参数带依据与经验引用),由人类在产线页审批卡选定方案批准后整批下发;未经人类批准绝不变更产线。实例化时建议开知识库集成(enableKnowledgeBase)与诊断桥(diag-bridge)并绑定产线(bindLineId)。',
+    scenarioPrompt: `## 身份与边界(开工先读完)
+你是本频道唯一的**产线诊断工程师**:人类专家的**全能辅助位**,用只读工具持续巡检已绑定产线,依据知识库经验库、历史诊断与实时数据,输出运行判断与优化建议;发现优化空间时,把方案交由人类审批后执行 —— **一切产线变更必经人类批准**,这是铁律,不是流程形式。
+你的常规巡检面(读数/报警/日志/配方史/经验检索/诊断)全部只读;唯一的变更入口是 **recipe_propose 整包方案审批**:提交后产线不会有任何变化,只有人类在产线页审批卡**选定方案批准**才整批下发;拒绝/超时按未执行收敛。
+
+## 常规轻巡(默认每 30 分钟,定时触发)
+1. 用 line_context + daq_query + ops_log 拉近窗读数、报警与操作留痕(recipe_log 一并看),判断产线当前运行状态;
+2. kb_agent(mode=sync) 检索本产线经验条目(标签:经验/<产线>)与历史诊断(标签:诊断/<产线>),已知结论优先复用,不重复推断;
+3. 输出运行判断(频道简报,从简不刷屏):
+   - 正常:一句话带依据;
+   - 有优化空间:先查 AML 活动闸(见下),再走「整包方案」或「优化建议报告」流程;
+   - 异常需人类注意:现象+证据+建议动作说清楚,提醒人类处置,不自行扩大动作。
+
+## 每日深度诊断(默认每日一次)
+1. diag_run(line=<绑定产线>) 发起根因诊断(异步,提交即返 task_id);
+2. diag_status 轮询至完成,按其返回指引取报告;
+3. 报告按诊断工具内置契约用 kb_agent(mode=async) 入库(标签:诊断、<产线>),并在频道简报核心结论。
+
+## AML 活动闸(整包方案提交前必查;时间互斥防「双写者」)
+先用 aml_activity 查询绑定产线的 AML 优化循环是否活动:
+- **活动**(投用中的优化 Channel/在跑优化作业/近 30 分钟优化事件)→ **禁止整包下发**,把候选方案改写为优化建议报告入库,并提醒人类 AML 循环结束后再提交;绝不与 AML 循环同时写产线;
+- 不活动 → 方案证据充分时走下方「整包方案审批下发」流程。
+
+## 整包方案审批下发(recipe_propose;优化空间明确且证据充分时)
+1. 提交 1~3 套整包候选方案(每套=完整参数组,配方内节点),**每参数必须带依据 basis 与经验引用 exp_ref**(无引用的参数不得入包;服务端会按配方真实限界预检,越界参数剔除,全部失效整单打回);
+2. 挂单后在频道提醒人类到产线页审批卡处置;同一配方同一时刻只保留一张在飞单(拒绝/超时后可修订重提,**人类拒绝过的方案不得原样重提** —— 逐字吸收意见修订后再提);
+3. 批准(人类选定某套方案)→ 服务端整批下发,回执逐参数给出结果并带 **runId**:按 runId 回访效果(等待工艺惯性后 daq_query 复测),有进步 → 把「情境→方案→效果」经验回写知识库;劣化 → 立即建议 recipe_rollback(dispatch=true) 统一回退并通报;部分失败按回执指引补发/回退。
+
+## 优化建议报告(AML 活动期/证据尚不充分时;标签:建议、<产线>)
+逐参数给出:现状(带时间窗)→ 建议值 → 依据(引用经验条目标题或数据证据;**无依据的参数不得进报告**)→ 预期效果(方向与量级,说明不确定性)→ 风险与回退条件。报告首屏明确声明:「仅建议,未经人类审批不会下发」。同时在频道提示人类有新建议可审。`,
+    members: [
+      { inline: { name: '产线诊断工程师', harness: 'omp', config: { rpcMode: 'rpc', role: 'lead', systemPromptPrefix: '你是产线诊断工程师:人类专家的全能辅助位,只读巡检+诊断+建议;优化方案一律走 recipe_propose 整包审批(提交前先 aml_activity 查 AML 活动闸,活动期只出建议),未经人类在审批卡选定批准绝不发生产线变更;按回执 runId 回访效果并回写经验;结论一律带时间窗与数据/经验引用,无依据不下结论。' } }, role: 'lead' },
+    ],
+  },
 ]
 
 /**

package/server/services/workshop/db/memory.repo.ts

@@ -34,7 +34,7 @@ export interface MemoryUpsertInput {
 
 export type MemoryRepo = ReturnType<typeof createMemoryRepo>
 
-const COLS = `m.id, m.channel_id AS channelId, m.agent_id AS agentId, m.kind, m.title, m.content,
+const COLS = `m.id, m.channel_id AS channelId, m.agent_id AS agentId, m.kind, m.title, m.content, m.dedup_key AS dedupKey, m.title_fts AS titleFts,
   m.importance, m.task_id AS taskId, m.access_count AS accessCount,
   m.last_accessed_at AS lastAccessedAt, m.created_at AS createdAt`
 

package/server/services/workshop/db/ops.repo.ts

@@ -19,16 +19,21 @@ export interface ApprovalHistoryRow {
   decidedName: string
   createdAt: string
   decidedAt: string | null
+  /** 结构化审批载荷 JSON(整包方案审批的方案集+预检结果;空串=无载荷,文本降级) */
+  payloadJson: string
+  /** 多方案裁决序号(批准时选定的包下标;null=非结构化审批单/未携带) */
+  choice: number | null
 }
 
 const APPROVAL_COLS = `id, agent_id AS agentId, node_id AS nodeId, kind, detail, status,
-  comment, decided_by AS decidedBy, decided_name AS decidedName, created_at AS createdAt, decided_at AS decidedAt`
+  comment, decided_by AS decidedBy, decided_name AS decidedName, created_at AS createdAt, decided_at AS decidedAt,
+  payload_json AS payloadJson, choice`
 
 export function createApprovalHistoryRepo(db: DatabaseSync) {
   const insertStmt = db.prepare(
     `INSERT OR REPLACE INTO approval_history
-       (id, agent_id, node_id, kind, detail, status, comment, decided_by, decided_name, created_at, decided_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+       (id, agent_id, node_id, kind, detail, status, comment, decided_by, decided_name, created_at, decided_at, payload_json, choice)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
   )
   const listStmt = db.prepare(
     `SELECT ${APPROVAL_COLS} FROM approval_history ORDER BY created_at DESC LIMIT ?`,
@@ -47,10 +52,15 @@ export function createApprovalHistoryRepo(db: DatabaseSync) {
       decidedName?: string
       createdAt: string
       decidedAt?: string | null
+      /** 结构化审批载荷(JSON 序列化后落 payload_json 列;缺省空串) */
+      payloadJson?: string
+      /** 多方案裁决序号(缺省 NULL) */
+      choice?: number | null
     }): void {
       insertStmt.run(
         a.id, a.agentId, a.nodeId, a.kind, a.detail, a.status, a.comment,
         a.decidedBy ?? '', a.decidedName ?? '', a.createdAt, a.decidedAt ?? null,
+        a.payloadJson ?? '', typeof a.choice === 'number' && Number.isInteger(a.choice) ? a.choice : null,
       )
     },
     /** 审批历史(重启后仍可查;cap 由调用方给,默认沿用内存 HISTORY_CAP 的量级) */
@@ -166,17 +176,19 @@ export interface AuditEntry {
   recipeId?: string
   kind?: 'write' | 'manual' | 'alarm' | 'line' | 'recipe' | 'rollback' | 'daq' | 'system'
   summary?: string
+  /** 严重级(2026-10-08 写控 ACK 鉴定):info 缺省 / warn(未证实) / error(写入失败);日志页红黄标 */
+  level?: 'info' | 'warn' | 'error'
 }
 
 const AUDIT_COLS = `id, actor, actor_name AS actorName, actor_kind AS actorKind, action,
   target_kind AS targetKind, target_id AS targetId, detail_json AS detailJson, at,
-  line_id AS lineId, product_id AS productId, recipe_id AS recipeId, kind, summary`
+  line_id AS lineId, product_id AS productId, recipe_id AS recipeId, kind, summary, level`
 
 export function createAuditRepo(db: DatabaseSync) {
   const insertStmt = db.prepare(
     `INSERT INTO audit_log (actor, actor_name, actor_kind, action, target_kind, target_id, detail_json, at,
-       line_id, product_id, recipe_id, kind, summary)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+       line_id, product_id, recipe_id, kind, summary, level)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
   )
   const stmtCache = new Map<string, ReturnType<DatabaseSync['prepare']>>()
 
@@ -186,7 +198,7 @@ export function createAuditRepo(db: DatabaseSync) {
         e.actor, e.actorName ?? '', e.actorKind ?? 'user', e.action,
         e.targetKind ?? '', e.targetId ?? '', JSON.stringify(e.detail ?? {}),
         e.at ?? new Date().toISOString(),
-        e.lineId ?? '', e.productId ?? '', e.recipeId ?? '', e.kind ?? '', e.summary ?? '',
+        e.lineId ?? '', e.productId ?? '', e.recipeId ?? '', e.kind ?? '', e.summary ?? '', e.level ?? 'info',
       )
     },
     query(opts: {
@@ -198,6 +210,7 @@ export function createAuditRepo(db: DatabaseSync) {
       recipeId?: string
       actorKind?: string
       kind?: string
+      level?: string
       q?: string
       from?: string
       to?: string
@@ -237,6 +250,10 @@ export function createAuditRepo(db: DatabaseSync) {
         where.push('kind = ?')
         args.push(opts.kind)
       }
+      if (opts.level) {
+        where.push('level = ?')
+        args.push(opts.level)
+      }
       if (opts.q) {
         where.push('(summary LIKE ? OR action LIKE ? OR actor_name LIKE ? OR detail_json LIKE ?)')
         const like = `%${opts.q}%`