agentworkshop 0.6.1 → 0.7.0

package/server/data/line-runs.json

@@ -1 +1,12 @@
-[]
+[
+  {
+    "lineId": "ln-af002514",
+    "runId": "rr-6da3f412",
+    "recipeId": "rc-7bf584db",
+    "recipeName": "A-标准工艺",
+    "productId": "pd-6348a595",
+    "productName": "0.8mm 光学膜",
+    "startedAt": "2026-09-03T11:18:01.213Z",
+    "taggedSamples": 0
+  }
+]

package/server/plugins/backup.ts

@@ -10,6 +10,7 @@ import { DatabaseSync } from 'node:sqlite'
 import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import { resolve } from 'node:path'
 import { ensureDataDir } from '@/shared/config/home.mjs'
+import { backupSettings } from '../services/workshop/settings'
 
 const g = globalThis as typeof globalThis & { __awBackupTimer?: NodeJS.Timeout, __awBackupLastAt?: string }
 
@@ -47,8 +48,8 @@ async function backupOnce(dataDir: string): Promise<void> {
       console.error(`[backup] ${file} 快照失败:`, err instanceof Error ? err.message : err)
     }
   }
-  // 轮转:每库仅保留最近 BACKUP_KEEP 份(按文件名内时间戳倒序)
-  const keep = Math.max(1, Number(process.env.BACKUP_KEEP) || 7)
+  // 轮转:每库仅保留最近 backup.keep 份(按文件名内时间戳倒序;env BACKUP_KEEP 兼容)
+  const keep = Math.max(1, backupSettings().keep)
   for (const file of DB_FILES) {
     const own = readdirSync(backupDir)
       .filter(f => f.startsWith(`${file}.`) && f.endsWith('.bak'))
@@ -67,11 +68,12 @@ async function backupOnce(dataDir: string): Promise<void> {
 }
 
 export default function backupPlugin() {
-  if (process.env.BACKUP_DISABLED === '1') return
+  const backupCfg = backupSettings()
+  if (backupCfg.disabled) return
   if (g.__awBackupTimer) return
   const dataDir = ensureDataDir()
 
-  // 启动 30s 后首备(避开启动风暴),此后每 BACKUP_INTERVAL_HOURS(默认 24h)
+  // 启动 30s 后首备(避开启动风暴),此后每 backup.interval_hours(默认 24h)
   const first = setTimeout(() => {
     try {
       backupOnce(dataDir)
@@ -81,7 +83,7 @@ export default function backupPlugin() {
     }
   }, 30_000)
   first.unref?.()
-  const hours = Math.max(1, Number(process.env.BACKUP_INTERVAL_HOURS) || 24)
+  const hours = Math.max(1, backupCfg.interval_hours)
   const timer = setInterval(() => {
     try {
       backupOnce(dataDir)

package/server/plugins/retention.ts

@@ -1,57 +1,59 @@
-/**
- * 保留期定时插件(hardening GROW-1)。
- *
- * 每 24h 对 workshop.sqlite 的 messages/audit_log/approval_history 做分批保留
- * 清理(策略见 db/retention.ts;RETENTION_DISABLED=1 可整体关闭)。
- * 调度模式同 backup.ts:setInterval + globalThis key 防 HMR 重复 + unref()。
- * 启动 90s 后首跑(避开启动风暴,且错峰于 backup 的 30s 首备)。
- */
-import { DatabaseSync } from 'node:sqlite'
-import { existsSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { runRetentionSweep } from '@/server/services/workshop/db/retention'
-import { ensureDataDir } from '@/shared/config/home.mjs'
-
-const g = globalThis as typeof globalThis & { __awRetentionTimer?: NodeJS.Timeout }
-
-function sweepOnce(dataDir: string): void {
-  const dbPath = resolve(dataDir, 'workshop.sqlite')
-  if (!existsSync(dbPath)) return
-  const db = new DatabaseSync(dbPath)
-  try {
-    const results = runRetentionSweep(db)
-    for (const r of results) {
-      if (r.removed > 0) console.log(`[retention] ${r.table} 清理 ${r.removed} 行(>${r.days}d)`)
-    }
-  }
-  finally {
-    db.close()
-  }
-}
-
-export default function retentionPlugin() {
-  if (process.env.RETENTION_DISABLED === '1' || process.env.AW_RETENTION_DISABLED === '1') return
-  if (g.__awRetentionTimer) return
-  const dataDir = ensureDataDir()
-
-  const first = setTimeout(() => {
-    try {
-      sweepOnce(dataDir)
-    }
-    catch (err) {
-      console.error('[retention] 首轮清理失败:', err instanceof Error ? err.message : err)
-    }
-  }, 90_000)
-  first.unref?.()
-
-  const timer = setInterval(() => {
-    try {
-      sweepOnce(dataDir)
-    }
-    catch (err) {
-      console.error('[retention] 定时清理失败:', err instanceof Error ? err.message : err)
-    }
-  }, 24 * 3_600_000)
-  timer.unref?.()
-  g.__awRetentionTimer = timer
-}
+/**
+ * 保留期定时插件(hardening GROW-1)。
+ *
+ * 每 24h 对 workshop.sqlite 的 messages/audit_log/approval_history 做分批保留
+ * 清理(策略见 db/retention.ts;RETENTION_DISABLED=1 可整体关闭)。
+ * 调度模式同 backup.ts:setInterval + globalThis key 防 HMR 重复 + unref()。
+ * 启动 90s 后首跑(避开启动风暴,且错峰于 backup 的 30s 首备)。
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { runRetentionSweep } from '@/server/services/workshop/db/retention'
+import { ensureDataDir } from '@/shared/config/home.mjs'
+import { retentionSettings } from '../services/workshop/settings'
+
+const g = globalThis as typeof globalThis & { __awRetentionTimer?: NodeJS.Timeout }
+
+function sweepOnce(dataDir: string): void {
+  const dbPath = resolve(dataDir, 'workshop.sqlite')
+  if (!existsSync(dbPath)) return
+  const db = new DatabaseSync(dbPath)
+  try {
+    const results = runRetentionSweep(db)
+    for (const r of results) {
+      if (r.removed > 0) console.log(`[retention] ${r.table} 清理 ${r.removed} 行(>${r.days}d)`)
+    }
+  }
+  finally {
+    db.close()
+  }
+}
+
+export default function retentionPlugin() {
+  // retention.disabled(env RETENTION_DISABLED / AW_RETENTION_DISABLED 兼容别名)
+  if (retentionSettings().disabled) return
+  if (g.__awRetentionTimer) return
+  const dataDir = ensureDataDir()
+
+  const first = setTimeout(() => {
+    try {
+      sweepOnce(dataDir)
+    }
+    catch (err) {
+      console.error('[retention] 首轮清理失败:', err instanceof Error ? err.message : err)
+    }
+  }, 90_000)
+  first.unref?.()
+
+  const timer = setInterval(() => {
+    try {
+      sweepOnce(dataDir)
+    }
+    catch (err) {
+      console.error('[retention] 定时清理失败:', err instanceof Error ? err.message : err)
+    }
+  }, 24 * 3_600_000)
+  timer.unref?.()
+  g.__awRetentionTimer = timer
+}

package/server/plugins/workshop.ts

@@ -39,6 +39,7 @@ import {
   type ManagerDeps,
 } from '../services/workshop/runtime/manager'
 import { AppError } from '../utils/errors'
+import { workshopSettings } from '../services/workshop/settings'
 
 declare global {
 
@@ -130,10 +131,10 @@ export default function workshopPlugin(nitroApp: {
 
   // idle sweeper:空闲 agent 超时自动卸载(释放 omp 子进程与内存)。
   // busy 成员有三重守卫(state!==idle / 信箱 pending / lead 活跃任务)不会被卸载,
-  // "作业期间进程不断开"由守卫保证;空闲宽限可经 env 调整 —— 需要进程更长常驻
-  // (免冷启动 30~90s)时调大 WORKSHOP_IDLE_GRACE_MS。
-  const idleSweepMs = Number(process.env.WORKSHOP_IDLE_SWEEP_MS) || 30_000
-  const idleGraceMs = Number(process.env.WORKSHOP_IDLE_GRACE_MS) || 120_000
+  // "作业期间进程不断开"由守卫保证;空闲宽限可经 workshop.idle_grace_ms 调整 ——
+  // 需要进程更长常驻(免冷启动 30~90s)时调大(env WORKSHOP_IDLE_GRACE_MS 兼容)。
+  const idleSweepMs = workshopSettings().idle_sweep_ms
+  const idleGraceMs = workshopSettings().idle_grace_ms
   const stopSweeper = manager.startIdleSweeper({ intervalMs: idleSweepMs, graceMs: idleGraceMs })
 
   // 关机:完整关闭 manager(sweeper + 调度循环 + agent 运行时),关闭数据库

package/server/services/workshop/agents/industrial-tools.ts

@@ -59,7 +59,7 @@ export async function toolMyIndustrialNodes(agentId: string): Promise<{ text: st
 ---
 通用规则:
 1. 一个 Agent 可绑定多个节点;先读本清单理解每个节点的物理意义与操作守则,再动手。
-2. 数控下发 dcw_control(node_id, value):目标值必须落在「安全量程 ∩ 活动配方工艺窗口」;单次调幅建议按语义卡的步进指引。
+2. 数控下发 dcw_control(node_id, value):目标值必须落在「安全量程 ∩ 活动配方工艺窗口」;单次调幅建议按语义卡的步进指引。下发前/后用 dcw_read(node_id) 读 PLC 当前值取证复核(被动观测免审批)。
 3. 数据获取 daq_query(不传 node_id = 全部数采节点),支持按产线/产品/配方/时间检索;解读数据时结合语义卡的判读方法。
 4. 改动设定后等待工艺响应(热惯性/传动惯量)再评估,避免连续大幅调整。
 5. 调控闭环:每次下发自动开一条优化记录(open);观察数采后用 dcw_judge 落判定(keep/rollback/uncertain);
@@ -158,6 +158,55 @@ export async function toolDcwControl(agentId: string, args: { node_id?: string,
   }
 }
 
+/** 工具:dcw_read —— 读取数控节点的 PLC 当前值(读写集成的读半边;被动观测免审批)。
+ *  返回 PLC 实时读数(标定解码后的物理量)与当前设定值对照,供下发前取证/下发后复核。 */
+export async function toolDcwRead(agentId: string, args: { node_id?: string }): Promise<{ text: string, isError?: boolean }> {
+  const nodeId = String(args.node_id ?? '').trim()
+  const repo = getAgentNodeBindingRepo()
+  const binding: AgentNodeBinding | undefined = nodeId ? repo.find(agentId, nodeId, 'dcw') : undefined
+  if (!binding) {
+    const mine = repo.byAgent(agentId).filter(b => b.kind === 'dcw')
+    return {
+      text: mine.length
+        ? `无权读取节点 ${nodeId || '(空)'}。你有权读取的数控节点:${mine.map(b => b.nodeId).join(', ')}。`
+        : '你尚未绑定任何数控节点,无权读取控制通道数据。请在数字孪生界面绑定数控节点。',
+      isError: true,
+    }
+  }
+  const node = getDcwController().byId(nodeId)
+  if (!node) {
+    repo.removeAgentNode(agentId, nodeId, 'dcw')
+    return { text: `数控节点 ${nodeId} 已不存在(可能被删除),原绑定已自动清理,请重新绑定。`, isError: true }
+  }
+  const tpl = findDcwTemplate(node.templateKey)
+  try {
+    const read = await getDcwController().readNow(nodeId)
+    if (!read.ok && read.value == null && !node.readValue) {
+      return { text: `读取失败:${read.message}(节点 ${node.name},驱动 ${node.driver} 可能不支持读取;可改用 daq_query 查关联数采通道)`, isError: true }
+    }
+    const setTxt = node.value != null ? `${node.value}${node.unit}` : '从未下发'
+    const readTxt = read.value != null
+      ? `${Number(read.value.toFixed(node.decimals))}${node.unit}`
+      : (node.readValue != null ? `${node.readValue}${node.unit}(最近一次)` : '无读数')
+    const devTxt = read.value != null && node.value != null
+      ? (Math.abs(read.value - node.value) < writeToleranceOf(node)
+          ? '读数与设定一致(设定已生效)'
+          : '读数与设定存在偏差(可能工艺在响应或被本地修改)')
+      : '设定与读数暂不可对照'
+    return {
+      text: `读取成功:${node.name}(${tpl?.ch ?? node.templateKey})\n  PLC 读数(ACT): ${readTxt} @ ${read.at.slice(11, 19)}\n  当前设定(SET): ${setTxt}\n  对照: ${devTxt}${read.raw != null ? `\n  原始值(raw): ${Number(read.raw.toFixed(4))}` : ''}`,
+    }
+  }
+  catch (err) {
+    return { text: `读取被拒绝:${err instanceof Error ? err.message : String(err)}(节点 ${node.name})`, isError: true }
+  }
+}
+
+/** 读/设定偏差对照容差(与服务端回读死区同口径) */
+function writeToleranceOf(node: { decimals: number, min: number, max: number }): number {
+  return Math.max(0.5 * 10 ** -node.decimals, (node.max - node.min) * 0.005)
+}
+
 /**
  * 数采目标集解析(工具共用鉴权面):Agent 绑定(kind=daq)为权限边界 ——
  * node_id/line_id 只能缩小范围,不能放大(越权节点一律拒绝)。

package/server/services/workshop/agents/omp-agent.ts

@@ -50,11 +50,11 @@ import {
   loadHostToolDefs,
   renderPrompt,
 } from '../prompts/loader'
-import { toolDaqFrames, toolDaqQuery, toolDcwControl, toolDcwJudge, toolDcwJournal, toolDcwRollback, toolMyIndustrialNodes } from './industrial-tools'
+import { toolDaqFrames, toolDaqQuery, toolDcwControl, toolDcwJudge, toolDcwJournal, toolDcwRead, toolDcwRollback, toolMyIndustrialNodes } from './industrial-tools'
 import { attachOmpPluginBridge, listPluginTools, onPluginToolsChange } from './plugin-tools'
 import { buildIndustrialContext, industrialLoopGuide } from './industrial-context'
+import { ompSettings } from '../settings'
 import { extractTaskMode } from '../runtime/execution-mode'
-import { envNum } from '../runtime/memory'
 
 const log = createLogger('workshop.omp')
 
@@ -261,22 +261,21 @@ export class OmpRpcAgentImpl implements AgentInterface {
   private lastHarvestKey = ''
   private lastHarvestAt = 0
 
-  /** 总开关(AW_OMP_COMPACT_ENABLED=0 显式关闭;envNum 拒 0,故单独解析) */
+  /** 总开关(omp.compact_enabled;env AW_OMP_COMPACT_ENABLED=0 显式关闭兼容) */
   private compactEnabled(): boolean {
-    const v = Number(process.env.AW_OMP_COMPACT_ENABLED)
-    return !(Number.isFinite(v) && v === 0)
+    return ompSettings().compact_enabled
   }
 
   private compactThreshold(): number {
-    return Math.min(1, envNum('AW_OMP_COMPACT_THRESHOLD', 0.7))
+    return ompSettings().compact_threshold
   }
 
   private compactMinIntervalMs(): number {
-    return envNum('AW_OMP_COMPACT_MIN_INTERVAL_MS', 300_000)
+    return ompSettings().compact_min_interval_ms
   }
 
   private compactWaitMs(): number {
-    return envNum('AW_OMP_COMPACT_WAIT_MS', 120_000)
+    return ompSettings().compact_wait_ms
   }
 
   /** 被动上下文用量快照(无探测 RPC;getStatus 透出用) */
@@ -1917,6 +1916,9 @@ export class OmpRpcAgentImpl implements AgentInterface {
         case 'dcw_control': {
           return toolDcwControl(this.selfAgentId, req.arguments as { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string })
         }
+        case 'dcw_read': {
+          return toolDcwRead(this.selfAgentId, req.arguments as { node_id?: string })
+        }
         case 'daq_query': {
           return toolDaqQuery(this.selfAgentId, req.arguments as Parameters<typeof toolDaqQuery>[1])
         }