agentworkshop 0.7.3 → 0.7.4

package/app/components/AppHeader.vue

@@ -1,7 +1,10 @@
 <script setup lang="ts">
 import type { MenuProps, SelectProps } from 'ant-design-vue'
+import type { AepHitlItem } from '#shared/workshop-protocol'
 import { useUserStore } from '@/app/stores/workshop/user'
 import { useWsConnectionStore } from '@/app/stores/workshop/connection'
+import { useHitlStore } from '@/app/stores/workshop/hitl'
+import { useWorkshopWs } from '@/app/composables/workshop/useWorkshopWs'
 
 const { t, locale, locales, setLocale } = useI18n()
 const store = useAppStore()
@@ -10,6 +13,26 @@ const trail = useRouteTrailStore()
 const userStore = useUserStore()
 const { metaFor } = useRouteMeta()
 
+// ── HITL 全局待办(omp ask 对话框 + dcw 审批统一徽标;页头保底建连 ——
+//    hitl 全员直推帧只达已连 peer,不建连的页面收不到提醒;快照兜底刷新前待办) ──
+const hitl = useHitlStore()
+const wsSession = useWorkshopWs()
+const ensureHitlLive = () => {
+  if (userStore.isLoggedIn) wsSession.ensureConnected()
+}
+watch(() => userStore.token, (t2) => {
+  if (t2) {
+    ensureHitlLive()
+    void hitl.loadSnapshot()
+  }
+  else hitl.clear()
+}, { immediate: true })
+const hitlKindLabel = (kind: AepHitlItem['kind']) =>
+  kind === 'omp-dialog' ? t('appHeader.hitlKindOmp') : t('appHeader.hitlKindDcw')
+const hitlGo = (item: AepHitlItem) => {
+  navigateTo({ path: '/monitor', query: { agentId: item.agentId, channelId: item.channelId } })
+}
+
 const localeOptions = computed(() =>
   (locales.value as Array<{ code: string, name: string }>).map(l => ({
     label: l.name,
@@ -205,6 +228,40 @@ const onAvatarMenu: MenuProps['onClick'] = async ({ key }) => {
 
     <!-- 右侧:功能集群 -->
     <div class="header-right">
+      <!-- HITL 待办铃标(有待办才出现;点击下拉 → 进入对应 agent 终端处理) -->
+      <ClientOnly>
+        <a-dropdown
+          v-if="hitl.count > 0"
+          placement="bottomRight"
+        >
+          <button
+            class="icon-btn hitl-bell"
+            :title="t('appHeader.hitlBadge')"
+          >
+            <span class="i-tabler-bell-ringing" />
+            <span class="hitl-count">{{ hitl.count }}</span>
+          </button>
+          <template #overlay>
+            <div class="hitl-menu">
+              <div class="hitl-menu-title">
+                {{ t('appHeader.hitlBadge') }} · {{ hitl.count }}
+              </div>
+              <button
+                v-for="item in hitl.items"
+                :key="`${item.kind}:${item.id}`"
+                class="hitl-item"
+                @click="hitlGo(item)"
+              >
+                <span class="hitl-item-top">
+                  <span class="hitl-item-agent">{{ item.agentName }}</span>
+                  <span class="hitl-item-kind">{{ hitlKindLabel(item.kind) }}</span>
+                </span>
+                <span class="hitl-item-title">{{ item.title }}</span>
+              </button>
+            </div>
+          </template>
+        </a-dropdown>
+      </ClientOnly>
       <!-- 实时连接状态点(WS 会话全局单例;未用过 WS 的会话不显示) -->
       <span
         v-if="wsVisible"
@@ -660,6 +717,87 @@ const onAvatarMenu: MenuProps['onClick'] = async ({ key }) => {
   50% { opacity: 0.45; }
 }
 
+/* ── HITL 待办铃标(琥珀警示;角标数字极简,无装饰堆砌) ── */
+.hitl-bell {
+  position: relative;
+  color: var(--tone-warning-dot, #d4a017);
+}
+.hitl-count {
+  position: absolute;
+  top: 2px;
+  right: 2px;
+  min-width: 15px;
+  height: 15px;
+  padding: 0 4px;
+  font-family: var(--font-mono);
+  font-size: 9.5px;
+  font-weight: 700;
+  line-height: 15px;
+  color: var(--on-accent, #fff);
+  text-align: center;
+  background: var(--tone-danger-dot, #e05252);
+  border-radius: 8px;
+}
+.hitl-menu {
+  min-width: 260px;
+  max-width: 340px;
+  padding: 6px;
+  background: var(--paper, #fff);
+  border: 1px solid var(--line);
+  border-radius: var(--radius-panel-sm, 10px);
+  box-shadow: 0 10px 32px rgba(0, 0, 0, 0.14);
+}
+.hitl-menu-title {
+  padding: 6px 10px;
+  font-size: 11px;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  color: var(--ink-faint);
+  border-bottom: 1px solid var(--line);
+}
+.hitl-item {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  width: 100%;
+  margin-top: 4px;
+  padding: 8px 10px;
+  text-align: left;
+  cursor: pointer;
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: var(--radius-panel-sm, 8px);
+  transition: background var(--transition-fast), border-color var(--transition-fast);
+}
+.hitl-item:hover {
+  background: var(--paper-deep);
+  border-color: var(--line);
+}
+.hitl-item-top {
+  display: flex;
+  gap: 8px;
+  align-items: baseline;
+  justify-content: space-between;
+}
+.hitl-item-agent {
+  font-size: 12.5px;
+  font-weight: 600;
+  color: var(--ink);
+}
+.hitl-item-kind {
+  font-family: var(--font-mono);
+  font-size: 9.5px;
+  letter-spacing: 0.1em;
+  color: var(--tone-warning-dot, #d4a017);
+}
+.hitl-item-title {
+  overflow: hidden;
+  font-size: 12px;
+  color: var(--ink-soft);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 @media (prefers-reduced-motion: reduce) {
   .plotter-line.run {
     animation: none;

package/app/composables/workshop/useWorkshopWs.ts

@@ -8,6 +8,7 @@ import { useUserStore } from '../../stores/workshop/user'
 import { WorkshopWsSession, useWsConnectionStore } from '../../stores/workshop/connection'
 import { useEventsStore } from '../../stores/workshop/events'
 import { useEntitiesStore } from '../../stores/workshop/entities'
+import { useHitlStore } from '../../stores/workshop/hitl'
 import { useTownBus } from './useTownBus'
 import type { AepEnvelope, AepSnapshot } from '#shared/workshop-protocol'
 
@@ -16,6 +17,7 @@ export function useWorkshopWs() {
   const userStore = useUserStore()
   const events = useEventsStore()
   const entities = useEntitiesStore()
+  const hitl = useHitlStore()
   const townBus = useTownBus()
 
   // 模块级单例:多组件共享一条连接
@@ -48,6 +50,8 @@ export function useWorkshopWs() {
           events.ingest(e)
           entities.applyEvent(e)
         }
+        // HITL 全局待办(频道帧 + channelId='' 全员直推各到一次,store 内 kind+id 幂等)
+        if (e.type === 'hitl.request' || e.type === 'hitl.resolved') hitl.applyEnvelope(e)
         if (typeof e.seq === 'number' && e.seq > 0 && e.channelId) {
           conn.cursors[e.channelId] = e.seq
           s.updateCursor(e.channelId, e.seq) // 推进重连续传游标

package/app/pages/monitor.vue

@@ -67,6 +67,7 @@ interface MonitorSnapshot {
 interface ApiEnvelope<T> { code: number | string, message: string, data: T | null }
 
 const { t } = useI18n()
+const route = useRoute()
 const userStore = useUserStore()
 const isAdmin = computed(() => userStore.isAdmin)
 
@@ -112,7 +113,9 @@ watch(() => userStore.token, () => {
 })
 
 onMounted(() => {
-  if (userStore.token) void poll()
+  if (userStore.token) {
+    void poll().then(() => openFromQuery())
+  }
   applyTimer()
 })
 onBeforeUnmount(() => {
@@ -169,6 +172,19 @@ const openTerminal = (pid: number, name: string | null, role: string | null): vo
   terminalOpen.value = true
 }
 
+// HITL 徽标跳转定位:?agentId=&channelId= → 自动打开该 agent 的终端面板(omp 未
+// spawn 时无进程行,保持关闭;用后即清 query,刷新/再进不重复弹开)
+const openFromQuery = (): void => {
+  const agentId = route.query.agentId
+  if (typeof agentId !== 'string' || !agentId) return
+  const channelId = typeof route.query.channelId === 'string' ? route.query.channelId : ''
+  const proc = snapshot.value?.processes.find(p => p.agentId === agentId && (!channelId || p.channelId === channelId))
+  if (proc?.pid) {
+    openTerminal(proc.pid, proc.name, proc.role)
+    void navigateTo({ path: '/monitor' }, { replace: true })
+  }
+}
+
 // ===== 展示辅助 =====
 const shortId = (id: string | null | undefined): string => (id && id.length > 8 ? `${id.slice(0, 8)}…` : (id ?? '-'))
 const stateColor: Record<string, string> = { idle: 'success', busy: 'processing', stopped: 'error' }

package/app/stores/workshop/hitl.ts

@@ -0,0 +1,80 @@
+/**
+ * HITL 全局待办 store:omp ask 对话框 + dcw 工具审批的统一待答视图。
+ *
+ * 数据源:
+ *  - AEP hitl.request/hitl.resolved 帧(频道流 seq 帧与 channelId='' 全员直推
+ *    会各到一次,upsert 按 kind+id 幂等去重;徽标不依赖 channel 订阅)
+ *  - GET /api/workshop/hitl/pending 快照(页面挂载/重连后的基线对齐)
+ */
+import { defineStore } from 'pinia'
+import type { AepEnvelope, AepHitlItem } from '#shared/workshop-protocol'
+import { useUserStore } from './user'
+
+const keyOf = (i: Pick<AepHitlItem, 'kind' | 'id'>) => `${i.kind}:${i.id}`
+
+interface HitlPendingRes {
+  code: number | string
+  data?: { items: AepHitlItem[] }
+}
+
+export const useHitlStore = defineStore('workshop.hitl', {
+  state: () => ({
+    /** 当前待人工处理条目(kind+id 幂等) */
+    items: [] as AepHitlItem[],
+    /** 快照已加载(防重复拉取;WS 掉线重连后由 ensureBaseline 重置) */
+    snapshotLoaded: false,
+  }),
+  getters: {
+    count: state => state.items.length,
+    /** 按 agent 分组(徽标下拉/跳转用) */
+    byAgent: (state) => {
+      const map = new Map<string, AepHitlItem[]>()
+      for (const i of state.items) {
+        const list = map.get(i.agentId) ?? []
+        list.push(i)
+        map.set(i.agentId, list)
+      }
+      return map
+    },
+  },
+  actions: {
+    /** AEP 帧消费(hitl.request / hitl.resolved;幂等 upsert/remove) */
+    applyEnvelope(e: AepEnvelope): void {
+      if (e.type === 'hitl.request') {
+        const item = e.payload as AepHitlItem
+        const key = keyOf(item)
+        const idx = this.items.findIndex(i => keyOf(i) === key)
+        if (idx >= 0) this.items[idx] = item
+        else this.items.push(item)
+      }
+      else if (e.type === 'hitl.resolved') {
+        const r = e.payload as { kind: AepHitlItem['kind'], id: string }
+        this.items = this.items.filter(i => keyOf(i) !== keyOf(r))
+      }
+    },
+    /** 快照对齐(挂载/重连;替换式 —— 以 REST 为准收敛 WS 期间的可能漂移) */
+    async loadSnapshot(): Promise<void> {
+      if (typeof window === 'undefined') return
+      const token = useUserStore().token
+      if (!token) return
+      try {
+        const res = await $fetch<HitlPendingRes>('/api/workshop/hitl/pending', {
+          headers: { authorization: `Bearer ${token}` },
+        })
+        if (res.code === 0 && res.data) {
+          this.items = res.data.items
+          this.snapshotLoaded = true
+        }
+      }
+      catch { /* 快照失败不阻塞实时帧 */ }
+    },
+    /** WS 断线重连后重新对齐 */
+    invalidate(): void {
+      this.snapshotLoaded = false
+    },
+    clear(): void {
+      this.items = []
+      this.snapshotLoaded = false
+    },
+  },
+})

package/cli/commands/tui.mjs

@@ -0,0 +1,19 @@
+// ============================================================
+// 指令:tui —— 终端工作台(与 AgentTeam 交互作业;实现在 tui/)。
+// 用法:aw tui [--url http://127.0.0.1:3000] [--token ut-*] [--channel <名>]
+// ============================================================
+
+export const meta = {
+  name: 'tui',
+  aliases: ['tui'],
+  group: '交互',
+  summary: '终端工作台 TUI:频道管理/发任务/实时监控/HITL 作答',
+  usage: 'aw tui [--url <baseUrl>] [--token <ut-*>] [--channel <名>]',
+  needsProject: false,
+}
+
+export async function run(argv) {
+  const { main } = await import('../../tui/aw-tui.mjs')
+  await main(argv)
+  return 0
+}

package/config.yml

@@ -1,134 +1,134 @@
-# ============================================================
-# AgentWorkShop 运行配置 —— 单一事实来源（Single Source of Truth）
-# ------------------------------------------------------------
-# 本文件由 nuxt.config.ts（构建/开发期）与 scripts/start.mjs（生产启动期）
-# 读取并解析，驱动整个运行时。修改后重启对应模式即可生效：
-#   开发：pnpm dev     -> 读取 server.dev
-#   生产：pnpm start   -> 读取 server.prod
-# ============================================================
-
-app:
-  name: AgentWorkShop
-  title: AgentWorkShop
-  version: 0.7.3
-  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
-
-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
+# ============================================================
+# AgentWorkShop 运行配置 —— 单一事实来源（Single Source of Truth）
+# ------------------------------------------------------------
+# 本文件由 nuxt.config.ts（构建/开发期）与 scripts/start.mjs（生产启动期）
+# 读取并解析，驱动整个运行时。修改后重启对应模式即可生效：
+#   开发：pnpm dev     -> 读取 server.dev
+#   生产：pnpm start   -> 读取 server.prod
+# ============================================================
+
+app:
+  name: AgentWorkShop
+  title: AgentWorkShop
+  version: 0.7.4
+  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
+
+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

package/docs/tui.md

@@ -0,0 +1,43 @@
+# TUI 终端工作台(`aw tui`)
+
+与 AgentTeam 交互作业的终端客户端。渲染层基于 `@earendil-works/pi-tui`(openclaw
+同款组件化 TUI 框架),代码在仓库 `tui/` 目录(`.mjs` 直跑,零构建);与服务端
+的关系和 WebUI 平级 —— 同一套 REST + AEP WebSocket,不引入新的服务端形态。
+
+> 完整用法/按键/命令表见 [`tui/README.md`](../tui/README.md);本文是架构与集成说明。
+
+## 能力总览
+
+- **频道管理**:`/channel new|use|add` 创建频道(可内联建 lead)、切换订阅、
+  放置 Agent 实例(模板克隆或内联定义)。
+- **任务下发**:普通文本发 lead(`priority=task`);`/send` immediate 直发
+  (忙碌时 steer 注入 omp 当前回合);`/task` 正式任务(goal/loop/pipeline)。
+- **实时观察**:AEP WS 订阅(断线 `lastSeq` 续传);`/monitor <agent>` 打开
+  右侧终端镜像面板(omp `rpc-ui` 会话的净化帧流)。
+- **HITL 统一作答**:omp ask 对话框与 dcw 下发审批的待办在 `/hitl` 聚合,
+  作答经 `POST /api/workshop/hitl/respond` 路由回 omp stdin / 审批裁决。
+
+## HITL 集成(服务端增量)
+
+服务端新增 `server/services/workshop/agents/hitl-registry.ts`(进程内待办登记处):
+
+- 两条既有 HITL 链路统一登记:`harness-terminal.ts`(omp `extension_ui_request`,
+  park 语义:零订阅倒计时 `security.hitl_timeout_ms`,订阅即暂停)与
+  `tool-approvals.ts`(dcw 审批,180s 超时同源)。
+- AEP 新帧:`hitl.request` / `hitl.resolved`(频道流 publish + 全员直推各一路,
+  WebUI/TUI 不依赖频道订阅即达;快照恢复走 `GET /api/workshop/hitl/pending`)。
+- 统一应答:`POST /api/workshop/hitl/respond`(幂等,已落定返回 409
+  `ALREADY_RESOLVED`;用户 token + channel 所有权校验 + audit 留痕)。
+
+WebUI 侧:`app/stores/workshop/hitl.ts` 消费帧 → `AppHeader` 铃标 → 点击跳
+`/monitor?agentId=&channelId=` 直达该 Agent 终端作答(OmpTerminalPanel 既有
+作答界面不变)。
+
+## 测试
+
+| 命令 | 覆盖 |
+|---|---|
+| `npx tsx scripts/test-hitl-registry.ts` | registry 登记/落定/订阅/park 暂停与超时(22 断言) |
+| `node scripts/test-tui-reducers.mjs` | AEP 帧 → 会话状态归约(15 断言) |
+| `node scripts/test-tui-commands.mjs` | 命令解析/分发(21 断言) |
+| `node scripts/tui-smoke.mjs` | 无头 e2e:虚拟终端驱动真实 TUI ↔ 真实 dev server(12 断言) |

package/i18n/locales/en.ts

@@ -1850,6 +1850,9 @@ export default {
     kwsdot0002: 'Syncing in real time…',
     kwsdot0003: 'Connecting…',
     kwsdot0004: 'Connection lost',
+    hitlBadge: 'Needs human input',
+    hitlKindOmp: 'omp dialog',
+    hitlKindDcw: 'write approval',
   },
   ompTerminalPanel: {
     k14jk3nu001: '  {p0}· 对话框已撤销({p1}){p2}',

package/i18n/locales/zh-CN.ts

@@ -1849,6 +1849,9 @@ export default {
     kwsdot0002: '实时同步中…',
     kwsdot0003: '连接中…',
     kwsdot0004: '连接已断开',
+    hitlBadge: '待人工处理',
+    hitlKindOmp: 'omp 对话框',
+    hitlKindDcw: '下发审批',
   },
   ompTerminalPanel: {
     k14jk3nu001: '  {p0}· 对话框已撤销({p1}){p2}',