@whyshu/argent-engine 0.7.3 → 0.7.5

package/engine/scripts/session-load-check.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * session-load-check —— 用**真实加载路径的校验**回放 session 日志（只读）。
+ *
+ * 与 `scripts/patches/verify-session-migration.mjs` 的分工（两者都必要，别互相替代）：
+ *   · verify-session-migration：跑**格式迁移链**（v0→v4），`validation: 'transformed'`
+ *     ⇒ 只回答"能不能迁移"；v4 文件是恒等迁移，**不会**触发 v4 结构校验。
+ *   · 本工具：`validation: 'current'` ⇒ 触发 `restoreCurrent()`（= 宿主真正加载时走的校验，
+ *     含 turn/step 作用域、surface 折叠、工具生命周期等）。
+ *
+ * 为什么要它（2026-10-17 实测）：主会话 06732069 在 0.2.0 上打不开
+ * （`SessionFormatError: tool/result is outside an open turn`），而 verify-session-migration
+ * 对同一个文件**判绿**——因为迁移校验不跑 v4 结构校验。别再拿迁移绿灯当"会话能打开"的证据。
+ *
+ * 用法：
+ *   DSH_SCOPE=<…/@deepseek-ai> node scripts/session-load-check.mjs <session.vN.jsonl.zstd> [...]
+ *   不给文件 ⇒ 校验"当前用户近 N 天最常打开的几个 v4 会话"（默认 3 个，按 mtime 取最新）。
+ * 退出码：0 全绿 / 1 有失败 / 2 用法或环境错误。
+ *
+ * 边界（诚实）：只做**读取 + 校验**，不迁移、不写任何文件；v3 及更早日志的 v3→v4 迁移需要
+ * 子会话事实，本工具传空数组 ⇒ 对 v3 文件的结论仅作参考（该场景用 verify-session-migration）。
+ */
+import { createRequire } from 'node:module'
+import { readdirSync, readFileSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+import { requireDshScope } from './lib/dsh-scope.mjs'
+import { decodeSessionLines } from './lib/zstd-frames.mjs'
+
+let scope
+try { scope = requireDshScope({ what: 'session 加载校验（session-load-check）' }) }
+catch (e) { console.error(`  ❌ ${e.message}`); process.exit(2) }
+const requireGlobal = createRequire(scope.replace(/\/?$/, '/'))
+const { createSessionFormatCatalogWithChildren, sessionFormatCatalog } =
+  requireGlobal('@deepseek-ai/dsh-session-format-catalog')
+
+/** 取最近修改的 v4 日志（默认样本源）。 */
+function recentV4(limit = 3) {
+  const root = join(process.env.DSH_HOME || join(process.env.HOME || '', '.dsh'), 'sessions')
+  const out = []
+  const walk = (dir, depth = 0) => {
+    let entries
+    try { entries = readdirSync(dir) } catch { return }
+    for (const name of entries) {
+      const p = join(dir, name)
+      let st
+      try { st = statSync(p) } catch { continue }
+      if (st.isDirectory()) { if (depth < 2) walk(p, depth + 1); continue }
+      if (/^session\.v4\.jsonl\.zstd$/.test(name)) out.push({ p, mtime: st.mtimeMs })
+    }
+  }
+  walk(root)
+  return out.sort((a, b) => b.mtime - a.mtime).slice(0, limit).map((x) => x.p)
+}
+
+function checkOne(file) {
+  let decoded
+  try { decoded = decodeSessionLines(readFileSync(file)) } catch (e) {
+    return { ok: false, why: `解压失败：${e.message}` }
+  }
+  const { header: headerRaw, lines } = decoded
+  const header = JSON.parse(headerRaw.split('\n')[0])
+  // v3 及更早：v3→v4 迁移需要子会话事实；本工具传空数组 ⇒ 结论仅供参考
+  const catalog = createSessionFormatCatalogWithChildren
+    ? createSessionFormatCatalogWithChildren([])
+    : sessionFormatCatalog
+  let restore
+  try { restore = catalog.createRestore(header, { recovery: 'strict', validation: 'current' }) } catch (e) {
+    return { ok: false, why: `createRestore 失败：${e.message}` }
+  }
+  let n = 0
+  for (const { raw } of lines) {
+    if (!raw.trim()) continue
+    n += 1
+    let ev
+    try { ev = JSON.parse(raw) } catch (e) { return { ok: false, why: `行 ${n} JSON 解析失败：${e.message}` } }
+    try { restore.decodeRow(ev) } catch (e) {
+      return { ok: false, why: `行 ${n} / seq ${ev.seq} / ${ev.type}：${e.name}: ${e.message}` }
+    }
+  }
+  try {
+    const artifact = restore.finish()
+    return { ok: true, detail: `v${header.version} → v${artifact.header.version}，事件 ${artifact.events.length}，行 ${n}`, header }
+  } catch (e) {
+    return { ok: false, why: `finish：${e.name}: ${e.message}` }
+  }
+}
+
+const files = process.argv.slice(2)
+const targets = files.length ? files : recentV4(3)
+if (targets.length === 0) { console.error('  ❌ 没有可校验的会话文件（给个路径，或确认 DSH_HOME/sessions 存在）'); process.exit(2) }
+
+let failed = 0
+for (const file of targets) {
+  const r = checkOne(file)
+  if (r.ok) {
+    console.log(`✅ ${file}`)
+    console.log(`   ${r.detail}`)
+  } else {
+    failed += 1
+    console.log(`❌ ${file}`)
+    console.log(`   ${r.why}`)
+  }
+}
+console.log(`\n${failed === 0 ? '✅' : '❌'} session-load-check：${targets.length - failed} 通过 / ${failed} 失败`)
+process.exit(failed > 0 ? 1 : 0)

package/engine/scripts/sync-scripts.sh

@@ -198,7 +198,7 @@ deliver_faces() {
 # ⚠️ `install-argent.mjs` 同族（2026-10-10 实测）：克隆里它是**旧版**（仓库 ff4069d6 vs 克隆
 #   618f4bbd）⇒ 克隆侧跑 `--agent hr` 报「未知参数: hr」（新 flag 根本不存在）。
 #   它此前只靠 `argent-upgrade.mjs` 自举更新（滞后窗口 = 客户机装到旧安装器的风险）⇒ 一并进根文件清单。
-ROOT_FILES=(VERSION install-argent.mjs)
+ROOT_FILES=(VERSION)
 deliver_root_files() {
   local f
   for f in "${ROOT_FILES[@]}"; do

package/engine/scripts/xzh-browser.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# 鑫中航常驻浏览器：启动/停止/状态（保留一个标签页给登录态）
+set -u
+ROOT="${ARGENT_DSH_HOME:-$HOME/.argent-dsh}"
+DATA="${ARGENT_DATA_DIR:-$HOME/.dsh/argent}"
+PY="$DATA/venv/bin/python3"
+[ -x "$PY" ] || PY="$(command -v python3)"
+LOG="$DATA/xzh-browser.log"
+PORT="${XZH_CDP_PORT:-9223}"
+case "${1:-status}" in
+  start)
+    if curl -s -m 2 "http://127.0.0.1:$PORT/json/version" >/dev/null 2>&1; then
+      echo "already running: CDP $PORT"; exit 0
+    fi
+    mkdir -p "$DATA"
+    nohup "$PY" "$ROOT/scripts/xzh_browser.py" >>"$LOG" 2>&1 &
+    echo $! > "$DATA/xzh-browser.pid"
+    for i in $(seq 1 20); do
+      if curl -s -m 1 "http://127.0.0.1:$PORT/json/version" >/dev/null 2>&1; then
+        echo "started: CDP $PORT"; exit 0
+      fi
+      sleep 1
+    done
+    echo "start failed; see $LOG"; tail -20 "$LOG"; exit 1
+    ;;
+  stop)
+    PID_FILE="$DATA/xzh-browser.pid"
+    if [ -f "$PID_FILE" ]; then kill "$(cat "$PID_FILE")" 2>/dev/null || true; rm -f "$PID_FILE"; fi
+    # 只杀监听该调试端口的 Chrome（避免误杀用户其它窗口）
+    PIDS=$(lsof -tiTCP:"$PORT" -sTCP:LISTEN 2>/dev/null || true)
+    [ -n "$PIDS" ] && kill $PIDS 2>/dev/null || true
+    echo stopped
+    ;;
+  status)
+    if curl -s -m 2 "http://127.0.0.1:$PORT/json/version" >/dev/null 2>&1; then echo "running CDP $PORT"; else echo "not running"; exit 1; fi
+    ;;
+esac

package/engine/scripts/xzh_browser.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""鑫中航常驻浏览器：保留一个标签页/登录态；invoice_stageb 通过 CDP 复用。
+
+用法:
+  python3 scripts/xzh_browser.py             # 前台常驻（调试）
+  nohup ... > ~/.dsh/argent/xzh-browser.log 2>&1 &
+启动后监听 127.0.0.1:9223；invoice_stageb 会自动 connect_over_cdp。
+"""
+import json
+import os
+import sys
+import time
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent / 'lib'))
+from argent_datadir import resolve_data_dir  # noqa: E402
+
+DATA = Path(resolve_data_dir()['dir'])
+CHROME = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+PROFILE = str(DATA / "chrome-profile-xinhang")
+PORT = int(os.environ.get("XZH_CDP_PORT", "9223"))
+
+
+def main():
+    from playwright.sync_api import sync_playwright
+    mapping = json.load(open(DATA / "invoice-mapping.json"))
+    url = mapping["xinzhonghang"]["url"]
+    home = url.replace("/Login/VueLoginView", "") + "/home/EleIndex?lang=cn"
+    p = sync_playwright().start()
+    ctx = p.chromium.launch_persistent_context(
+        user_data_dir=PROFILE,
+        executable_path=CHROME,
+        headless=False,
+        viewport={"width": 1440, "height": 900},
+        accept_downloads=True,
+        args=[f"--remote-debugging-port={PORT}"],
+    )
+    page = ctx.pages[0] if ctx.pages else ctx.new_page()
+    try:
+        page.goto(home, timeout=20000, wait_until="domcontentloaded")
+    except Exception as exc:
+        print(f"⚠️ 打开首页失败（保留已开标签）: {exc}", flush=True)
+    print(f"✅ 鑫中航常驻浏览器已启动：CDP http://127.0.0.1:{PORT}｜profile={PROFILE}", flush=True)
+    while True:
+        time.sleep(30)
+
+
+if __name__ == "__main__":
+    main()

package/engine/skills/ml-full-appointment/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: ml-full-appointment
+description: 美客多 FULL 抢预约对话与 ERP 任务创建（BOT/gateway 只做桥；真正预约由 ERP worker 执行）。处理 SKU/货件号、字段缺口、任意日期范围、二次确认、停止与不跑步骤5-8。
+---
+
+# 美客多 FULL 抢预约（ml-full-appointment）
+
+## 定位
+
+飞书 @美客多 FULL BOT 只是**对话/确认桥梁**：
+
+- BOT/gateway 负责：识别意图、补齐字段、二次确认、创建 ERP 预约任务、反馈“已受理/已停止”；
+- **BOT/gateway 不轮询、不操作浏览器**；
+- 真正抢预约由 Huangwei 的 **ERP appointment worker** 执行；
+- 成功后通知发起人；**只到预约成功，不进入 FULL 步骤 5–8**。
+
+## 触发意图
+
+用户 @BOT 说类似：
+
+- “抢预约 SKU HW-MX-168，店铺 墨西哥-1店-子账号，10/20 到 10/25”
+- “抢货件 79922453 的预约，今天起 2 天内”
+- “帮我抢 FULL 预约，30 天内的”
+
+## 必须收集的字段
+
+- **店铺**（必填；SKU 可能跨店）
+- **SKU 或货件号**（二选一；货件号优先续传）
+- **日期窗口**：用户本次给的具体要求，两种模式：
+  - 用户说 `最近5天/最近5个可用日` ⇒ `dateMode=available_days`, `availableDays=5`（跳过 disabled，取最近 5 个可选日，不是日历固定 5 天）；
+  - 用户给绝对范围 `2026-10-20 ~ 2026-10-25` ⇒ `dateMode=range`, `dateFrom/dateTo`；
+- 若只给 SKU：**不读取 lip 表**，必须通过对话补齐 FULL 建单所需字段：店铺、SKU、数量 `quantity`、箱数 `boxCount`（产品名可选）；缺什么问什么；
+- 若给货件号：校验该货件存在，店铺/记录一致，当前进度允许预约；
+- 所有参数以任务形式传给 ERP，worker 只使用任务参数；
+- 轮询间隔默认 60 秒（后台参数，不需用户每次提供）。
+
+不要把 7/14 天写成固定变量；**每个任务保存用户本次的 dateFrom/dateTo**。
+
+## 二次确认（必须）
+
+创建任务前回显一段摘要，例如：
+
+> 确认信息：店铺 墨西哥-1店-子账号；SKU HW-MX-168；预约日期 2026-10-20 ~ 2026-10-25；只抢预约，不继续箱唛/发票。回复「开始」才执行。
+
+用户明确说「开始」/「确认」后才创建 ERP 任务；未确认不得创建。
+
+## 创建 ERP 任务
+
+BOT/gateway 通过确定性 CLI 创建任务（不在会话里轮询）：
+
+```bash
+node ~/.argent-dsh/scripts/appointment-create.mjs --json '<任务 JSON>' [--chat-id <当前群> --open-id <发起人open_id>]
+```
+
+返回 `{ ok, id, status }` 后，BOT 回复“已创建任务 #id”。
+
+尽量传 `--chat-id`/`--open-id`，worker 完成/停止时服务端会用 FULL BOT 通知发起人并附逐日结果。
+
+CLI 内部读取 `~/.dsh/argent/config.json` 的 `apiKey`（或 `WHYSHU_API_KEY`），调用：
+
+```
+POST /api/argent/v1/tenants/<tenantAppId>/appointments
+{
+  "store": "...",
+  "sku": "...",            // 或 shipmentNo
+  "shipmentNo": "...",
+  "quantity": 100,          // SKU-only 必填
+  "boxCount": 10,           // SKU-only 必填
+  "productName": "",        // 可选
+  "dateMode": "available_days",
+  "availableDays": 5,
+  // range 模式才填 dateFrom/dateTo
+  "windowText": "10/20-10/25",
+  "pollIntervalSec": 60
+}
+```
+
+返回任务 `queued` 后，BOT 回复：
+
+> 已创建抢预约任务 #<id>，worker 会按 60 秒一轮执行；回复「停止」可终止。
+
+## 用户停止
+
+用户说「停止」时运行：
+
+```bash
+node ~/.argent-dsh/scripts/appointment-stop.mjs <AppointmentTask id>
+```
+
+只置停止请求，worker 收尾；BOT 不轮询任务状态。
+
+## 禁止
+
+- ⛔ 不在 BOT/gateway 会话里执行浏览器操作或循环轮询；
+- ⛔ 不跑 FULL 步骤 5–8（箱唛/标签/发票/完成态）；
+- ⛔ 不把 7/14 天硬编码；不替用户改日期范围；
+- ⛔ 未二次确认不创建任务；
+- ⛔ 同一店铺预约仍走 ERP/编排器的同店步骤4互斥锁，避免与 FULL 任务串预约。

package/engine/version.mjs

@@ -1 +1 @@
-export const VERSION = "0.7.3"
+export const VERSION = "0.7.5"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whyshu/argent-engine",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Argent 引擎（L1）：流程/台账/重试/守卫/审计/浏览器自动化 —— 逐字节来自 argent-dsh 仓库",
   "type": "module",
   "engines": {

package/engine/scripts/drill-clean-machine.sh

@@ -1,315 +0,0 @@
-#!/usr/bin/env bash
-# drill-clean-machine.sh —— **干净机器一条命令**的隔离演练（D1/D2 的可复现证据；2026-10-05）
-#
-# 用途：把 `scripts/install-one-shot.mjs` 放进一个**与真实机器无关的夹具**里真跑一遍，
-#       并按"真实目录零变化"哨兵自证**没有**碰过 `~/.dsh/**`、`~/.argent-dsh/**`。
-#
-# 隔离构造（三条，缺一不可）：
-#   ① `HOME` 指向 `$FIX/home`（全新空目录）⇒ `~/.dsh`、`~/.argent-dsh`、`~/.pnpm` 全落在夹具里；
-#   ② 子进程一律 `env -i`（**极简环境**：只给 HOME/PATH，清掉 DSH_HOME/ARGENT_DATA_DIR/密钥等实例级开关）；
-#   ③ PATH 只含**夹具 bin**（node/git/dsh 的软链）+ 系统目录 ⇒ 包管理器**不在** PATH 上
-#      （演练刻意不跑 pnpm —— 装配走安装器的 `--from-packs` 离线面）。
-#   能力来源 = **离线包目录**（`capability_pack.py --build` 现场构建），不依赖 `~/.argent-dsh` 克隆。
-#
-# 演练内容（六跑）：
-#   A. dry-run             ⇒ 退出码 0，且夹具**零写入**（dry-run 语义）
-#   B. --apply（无许可）   ⇒ 退出码 0，装配 + 技能同步真跑；许可段 skipped（"未装许可"不算失败）
-#   C. 重跑 B              ⇒ 退出码 0，逐段结论与 B 一致（**幂等**）
-#   D. --only license --apply（夹具许可）⇒ 退出码 0，许可真落到夹具数据目录
-#   F. 在线装配面（本地镜像克隆 file://<仓库>、零网络、无包管理器 ⇒ 安装器既有"直拷"回退）
-#   E. 多包一起装（full,invoice）⇒ **预期退出码 0**（2026-10-09 起）：注册表投影在计划阶段与落盘阶段
-#      用**同一个**判据豁免（`isRegistryProjection()`），落盘后盘上注册表 = 两份投影的并集。
-#   收尾：哨兵比对（真实目录零变化）+ 夹具树/清单快照
-#
-# 用法：
-#   bash scripts/drill-clean-machine.sh [--keep] [--dir <夹具根>] [--caps <单个能力>] [--timeout <秒>]
-#   `--caps` 可给**多个**（逗号分隔）：同批发布的包本就该一起装（跨包共用引擎文件必须同版）；
-#   E 步仍单独用全新树演示一次"两个包一起装"的完整判据（退出码 + 装机清单 + 注册表并集）。
-# 退出码：0 四跑与哨兵均符合预期 ｜ 1 有不符合预期项（逐条点名）｜ 2 用法/环境错误
-set -uo pipefail
-
-REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
-KEEP=0
-FIX=""
-CAPS="full"
-GUARD_CAPS="full,invoice"   # E 步：多包一起装（回归判据，见文档 §E）
-TIMEOUT=1800
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --keep) KEEP=1; shift ;;
-    --dir) FIX="$2"; shift 2 ;;
-    --caps) CAPS="$2"; shift 2 ;;
-    --timeout) TIMEOUT="$2"; shift 2 ;;
-    -h|--help) sed -n '2,26p' "$0"; exit 0 ;;
-    *) echo "✗ 未知参数：$1" >&2; exit 2 ;;
-  esac
-done
-case "$CAPS" in
-  *,*) : ;;   # 多能力（逗号分隔）自 2026-10-09 起支持：一起装是**推荐**路径
-  '') echo "✗ --caps 不能为空" >&2; exit 2 ;;
-esac
-[ -n "$FIX" ] || FIX="$(mktemp -d "${TMPDIR:-/tmp}/argent-drill.XXXXXX")"
-FIX="$(cd "$FIX" && pwd -P)"
-mkdir -p "$FIX/bin" "$FIX/home" "$FIX/packs"
-
-ONE="$REPO/scripts/install-one-shot.mjs"
-[ -f "$ONE" ] || { echo "✗ 缺 $ONE" >&2; exit 2; }
-
-FAIL=0
-note() { printf '%s\n' "$*"; }
-ok()   { printf '  ✅ %s\n' "$*"; }
-bad()  { printf '  ✗ %s\n' "$*"; FAIL=1; }
-warn() { printf '  ⚠️  %s\n' "$*"; }
-hdr()  { printf '\n── %s\n' "$*"; }
-
-# ── 夹具 bin：只放 node / git / dsh（**不放** pnpm/npm/corepack）──────────────
-for t in node git dsh; do
-  p="$(command -v "$t" 2>/dev/null || true)"
-  [ -n "$p" ] && ln -sf "$p" "$FIX/bin/$t"
-done
-MINPATH="$FIX/bin:/usr/bin:/bin:/usr/sbin:/sbin"
-RUN=(env -i "HOME=$FIX/home" "PATH=$MINPATH" "TMPDIR=$FIX/tmp" \
-     "ARGENT_REPO_URL=file://$REPO"      # 在线面用**本地镜像**克隆（不是 whyshu 私服）：零网络
-     "ARGENT_SKIP_MODEL_PROBE=1")        # 联网凭证探针在夹具里没有 Key ⇒ 用安装器既有逃逸阀（它会打警告）
-mkdir -p "$FIX/tmp"
-
-note "═══════════════════════════════════════════════════"
-note "  干净机器演练夹具：$FIX"
-note "  HOME=$FIX/home（隔离）｜ PATH=$MINPATH"
-note "  node=$(node --version 2>/dev/null)｜git=$(git --version 2>/dev/null | awk '{print $3}')｜dsh=$(command -v dsh || echo 无)"
-note "  ⛔ 包管理器不在 PATH（演练刻意不跑 pnpm）"
-note "═══════════════════════════════════════════════════"
-
-# ── 哨兵（真实目录）────────────────────────────────────────────────────────
-# 立场：演练**只读**真实目录。哨兵盯"本次演练最可能误写的面"，逐条 sha 比对。
-# 刻意**不**盯会话/日志（常驻 dsh web 在写，盘它必然恒红，属噪声不属判据）。
-# 真实数据目录：**只调内核的唯一判据**（`core/lib/argent-datadir.mjs#resolveDataDir()`），
-# 本脚本里**不写第二份**（`ARGENT_DATA_DIR`/`DSH_HOME` 一律清掉 ⇒ 解析出的就是"本机默认位置"）。
-# 为什么哨兵也必须这样：门禁 scripts/tests/argent-datadir-parity.test.mjs【4】对 .sh 里的
-# `$HOME/.dsh/argent` 式硬编码判据**判红**（2026-10-01 桌面端事故形态）。
-# 用 `env -i` 清掉整份环境（**不点名任何**实例级开关变量 —— 点名它本身就是"第二份三级链"，
-# 会被同一条门禁的 `ARGENT_DATA_DIR` 规则判红）。
-REAL_DATA_DIR="$(env -i "HOME=$HOME" "PATH=$PATH" node -e \
-  'import(process.argv[1]).then(m=>process.stdout.write(m.resolveDataDir().dir))' \
-  "$REPO/core/lib/argent-datadir.mjs" 2>/dev/null)"
-[ -n "$REAL_DATA_DIR" ] || { echo "✗ 解析不出真实数据目录（缺 core/lib/argent-datadir.mjs？）—— 哨兵无法自证，演练中止" >&2; exit 2; }
-
-sentinel() {
-  local out="$1"
-  {
-    echo "# $(date -u +%FT%TZ) 真实目录哨兵（演练前后必须逐字节一致）｜数据目录=${REAL_DATA_DIR}"
-    for f in "$REAL_DATA_DIR/install.json" "$REAL_DATA_DIR/license.json" \
-             "$REAL_DATA_DIR/license.secret" "$REAL_DATA_DIR/skin.json" \
-             "$REAL_DATA_DIR/gateway.json" "$REAL_DATA_DIR/roles.json" \
-             "$HOME/.dsh/settings.yaml" "$HOME/.dsh/.credentials.yaml" \
-             "$HOME/.dsh/profiles/web/package.json" "$HOME/.dsh/profiles/web/cordis.patch.yml"; do
-      if [ -f "$f" ]; then printf '%s  %s\n' "$(shasum -a 256 "$f" | cut -c1-16)" "${f/#$HOME/~}"; else printf 'MISSING           %s\n' "${f/#$HOME/~}"; fi
-    done
-    for d in "$HOME/.dsh/skills" "$HOME/.dsh/.agent-presets"; do
-      if [ -d "$d" ]; then
-        printf 'DIR %s files=%s hash=%s\n' "${d/#$HOME/~}" \
-          "$(find "$d" -type f | wc -l | tr -d ' ')" \
-          "$(find "$d" -type f | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-      else printf 'DIR-MISSING       %s\n' "${d/#$HOME/~}"; fi
-    done
-    if [ -d "$HOME/.argent-dsh" ]; then
-      printf 'ARGENT-DSH head=%s dirty=%s files=%s\n' \
-        "$(git -C "$HOME/.argent-dsh" rev-parse --short HEAD 2>/dev/null || echo 非git)" \
-        "$(git -C "$HOME/.argent-dsh" status --porcelain 2>/dev/null | wc -l | tr -d ' ')" \
-        "$(find "$HOME/.argent-dsh" -type f -not -path '*/.git/*' | wc -l | tr -d ' ')"
-    else printf 'ARGENT-DSH MISSING\n'; fi
-  } > "$out" 2>/dev/null
-}
-sentinel "$FIX/sentinel-before.txt"
-node "$REPO/scripts/check-test-env-safety.mjs" --snapshot "$FIX/sentinel-datadir-before.json" >/dev/null 2>&1 || true
-note ""
-note "哨兵已拍：$FIX/sentinel-before.txt（+ 真实数据目录三层快照）"
-
-# ── 离线包（能力来源；不依赖克隆）───────────────────────────────────────────
-# 演练主线可多包（`--caps a,b`）：自 2026-10-09 起"一起装"是支持路径（E 步另有显式判据）。
-BUILD_CAPS="$CAPS,$GUARD_CAPS"   # 去重后逐个构建（重复目录会撞 --force 守卫）
-hdr "构建离线能力包（主线 --caps ${CAPS}；E 步多包 ${GUARD_CAPS}）"
-PACKARGS=""
-GUARDPACKARGS=""
-OLDIFS="$IFS"; IFS=','
-BUILT=","
-for cap in $BUILD_CAPS; do
-  IFS="$OLDIFS"
-  case "$BUILT" in *",$cap,"*) IFS=','; continue ;; esac
-  if [ -n "$cap" ]; then
-    if python3 "$REPO/scripts/capability_pack.py" --build "$cap" --out-dir "$FIX/packs/$cap" >"$FIX/packs/$cap.build.log" 2>&1; then
-      ok "$cap → $FIX/packs/${cap}（$(tail -1 "$FIX/packs/$cap.build.log" | sed 's/^ *//')）"
-      BUILT="$BUILT$cap,"
-    else
-      bad "$cap 打包失败，见 $FIX/packs/$cap.build.log"; tail -5 "$FIX/packs/$cap.build.log"
-    fi
-  fi
-  IFS=','
-done
-IFS="$OLDIFS"
-IFS=','
-for cap in $CAPS; do
-  IFS="$OLDIFS"; [ -n "$cap" ] || { IFS=','; continue; }
-  if [ -z "$PACKARGS" ]; then PACKARGS="$FIX/packs/$cap"; else PACKARGS="$PACKARGS,$FIX/packs/$cap"; fi
-  IFS=','
-done
-for cap in $GUARD_CAPS; do
-  IFS="$OLDIFS"; [ -n "$cap" ] || { IFS=','; continue; }
-  if [ -z "$GUARDPACKARGS" ]; then GUARDPACKARGS="$FIX/packs/$cap"; else GUARDPACKARGS="$GUARDPACKARGS,$FIX/packs/$cap"; fi
-  IFS=','
-done
-IFS="$OLDIFS"
-[ "$FAIL" = 0 ] || { echo "✗ 打包失败，演练中止"; exit 1; }
-
-one() {  # one <标签> <期望退出码> <参数…>
-  local label="$1" want="$2"; shift 2
-  local t0 t1
-  t0=$(date +%s)
-  "${RUN[@]}" node "$ONE" "$@" >"$FIX/run-$label.out" 2>&1
-  local rc=$?
-  t1=$(date +%s)
-  if [ "$rc" = "$want" ]; then ok "$label 退出码 ${rc}（期望 ${want}，耗时 $((t1-t0))s）"
-  else bad "$label 退出码 ${rc}（期望 ${want}）—— 见 $FIX/run-$label.out"; tail -25 "$FIX/run-$label.out"; fi
-  return 0
-}
-
-BASE=(--tree "$FIX/home/.argent-dsh" --dsh-home "$FIX/home/.dsh" --from-packs "$PACKARGS" --timeout "$TIMEOUT")
-
-# ── A. dry-run ─────────────────────────────────────────────────────────────
-hdr "A. dry-run（默认；必须零写入）"
-one A 0 "${BASE[@]}" --report "$FIX/report-A.json"
-if [ -e "$FIX/home/.dsh" ] || [ -e "$FIX/home/.argent-dsh" ]; then
-  bad "dry-run 竟然写了夹具（$FIX/home 下出现 .dsh/.argent-dsh）"
-else ok "dry-run 零写入（夹具 home 下没有 .dsh / .argent-dsh）"; fi
-
-# ── B. --apply（无许可）────────────────────────────────────────────────────
-hdr "B. --apply（无 --license-file ⇒ 许可段 skipped，不算失败）"
-one B 0 "${BASE[@]}" --apply --report "$FIX/report-B.json"
-[ -f "$FIX/home/.dsh/argent/install.json" ] && ok "装机清单在位：$FIX/home/.dsh/argent/install.json" \
-  || bad "装机清单不在位（--from-packs 装配判据）"
-[ -d "$FIX/home/.dsh/skills" ] && ok "技能已同步到夹具：$FIX/home/.dsh/skills（$(find "$FIX/home/.dsh/skills" -maxdepth 1 -mindepth 1 | wc -l | tr -d ' ') 项）" \
-  || bad "技能目录没生成（技能同步段判据）"
-TREE_HASH_B="$( { [ -d "$FIX/home/.argent-dsh" ] && find "$FIX/home/.argent-dsh" -type f; }  | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-
-# ── C. 重跑（幂等）─────────────────────────────────────────────────────────
-hdr "C. 重跑 --apply（幂等：逐段结论必须与 B 一致）"
-one C 0 "${BASE[@]}" --apply --report "$FIX/report-C.json"
-python3 - "$FIX/report-B.json" "$FIX/report-C.json" <<'PY' && ok "B/C 逐段状态一致（幂等）" || bad "B/C 逐段状态不一致（幂等被破）"
-import json,sys
-b=json.load(open(sys.argv[1])); c=json.load(open(sys.argv[2]))
-sb={s['id']:s['status'] for s in b['steps']}; sc={s['id']:s['status'] for s in c['steps']}
-if sb==sc: print('   B/C 状态：',sb)
-else:
-    print('   B:',sb); print('   C:',sc); sys.exit(1)
-PY
-TREE_HASH_C="$( { [ -d "$FIX/home/.argent-dsh" ] && find "$FIX/home/.argent-dsh" -type f; }  | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-[ "$TREE_HASH_B" = "$TREE_HASH_C" ] && ok "重跑后目标树逐字节不变（${TREE_HASH_C}）" \
-  || warn "重跑后目标树有变化（$TREE_HASH_B → ${TREE_HASH_C}）—— 逐条比对是 churn 还是缺陷"
-
-# ── D. 只跑许可段（夹具许可）───────────────────────────────────────────────
-hdr "D. --only license --apply（夹具密钥自签的许可；验的是「许可段能不能真装」）"
-SECRET="$FIX/fixture-license-secret"
-printf '%s' 'drill-fixture-secret-not-a-real-key' > "$SECRET"; chmod 600 "$SECRET"
-if "${RUN[@]}" node "$REPO/scripts/self-sign-license.mjs" --user drill-fixture --secret-file "$SECRET" \
-      --out "$FIX/fixture-license.json" --sign-v2 --device-from-local --cap full --seats 1 --days 30 \
-      >"$FIX/selfsign.out" 2>&1; then
-  ok "夹具许可已自签：$FIX/fixture-license.json（夹具密钥，⛔ 不是任何真实环境的密钥）"
-else bad "夹具许可自签失败，见 $FIX/selfsign.out"; tail -5 "$FIX/selfsign.out"; fi
-one D 0 --tree "$FIX/home/.argent-dsh" --dsh-home "$FIX/home/.dsh" \
-        --license-file "$FIX/fixture-license.json" --license-secret-file "$SECRET" \
-        --only license --apply --report "$FIX/report-D.json"
-[ -f "$FIX/home/.dsh/argent/license.json" ] && ok "许可已落到夹具数据目录（真实数据目录不动）" \
-  || bad "许可没落盘（许可段判据）"
-
-# ── F. 在线装配面（本地镜像克隆；零网络；无包管理器 ⇒ 走安装器既有"直拷"回退）──────
-hdr "F. 在线装配面（ARGENT_REPO_URL=file://<仓库>，零网络；无包管理器 ⇒ 直拷回退）"
-note "  ⛔ 全程不跑 pnpm：夹具 PATH 里没有 pnpm/npm/corepack ⇒ 安装器走它自己的回退分支。"
-note "  ⚠️ 该回退曾**不可达**（ensurePnpm 的 \`npm install -g pnpm\` 不在 try 里 ⇒ spawn npm ENOENT 未捕获崩），"
-note "     2026-10-05 已修（install-argent.mjs，见文档「失败与修法」）。"
-one F 0 --tree "$FIX/home-f/.argent-dsh" --dsh-home "$FIX/home-f/.dsh" --profile web \
-       --skip-provider --no-venv --apply --report "$FIX/report-F.json"
-[ -f "$FIX/home-f/.dsh/profiles/web/cordis.patch.yml" ] && ok "在线面产物：profile patch 在位（profiles/web/cordis.patch.yml）" \
-  || bad "在线面产物缺失：profiles/web/cordis.patch.yml"
-[ -d "$FIX/home-f/.dsh/.agent-presets" ] && ok "在线面产物：角色已落位（.agent-presets/$(ls "$FIX/home-f/.dsh/.agent-presets" | head -3 | tr '\n' ' ')）" \
-  || warn "在线面没落 preset（机制可能不是目录式；见 report-F.json）"
-[ -d "$FIX/home-f/.argent-dsh/plugins" ] && ok "在线面克隆到夹具树：$FIX/home-f/.argent-dsh（$(find "$FIX/home-f/.argent-dsh" -maxdepth 1 -mindepth 1 | wc -l | tr -d ' ') 个顶层条目）" \
-  || bad "在线面没克隆出树"
-
-# ── E. 多包一起装（2026-10-09 起**支持**，本步验证它真能装成）────────────────
-hdr "E. 多包一起装 --from-packs ${GUARD_CAPS}（期望退出码 0；注册表 = 两份投影的并集）"
-# ⚠ 必须用**全新**的树/home：B 已把主线能力铺好，复用会让安装器走"升级"路径，测不到"首次多包装"。
-one E 0 --tree "$FIX/home-e/.argent-dsh" --dsh-home "$FIX/home-e/.dsh" --profile web \
-       --from-packs "$GUARDPACKARGS" --apply --report "$FIX/report-E.json"
-# 判据三条：① 不再报"多包校验失败"；② 装机清单里两个能力都在且 integrity=verified；③ 盘上注册表是并集
-if grep -q "多包校验失败" "$FIX/run-E.out"; then
-  bad "多包一起装仍被拦下（见 $FIX/run-E.out）；拦下原因：$(grep -m1 '多包校验失败' "$FIX/run-E.out" | sed 's/^ *· *//')"
-else
-  ok "不再报「多包校验失败」（注册表投影已被判据豁免：计划阶段与落盘阶段同一个 isRegistryProjection()）"
-fi
-python3 - "$FIX/home-e/.dsh/argent/install.json" "$FIX/home-e/.argent-dsh/scripts/flow-requirements.json" <<'PY'
-import json, os, sys
-ij, reg = sys.argv[1], sys.argv[2]
-if not os.path.exists(ij):
-    print(f'  ✗ 装机清单不在位：{ij}'); sys.exit(1)
-doc = json.load(open(ij))
-caps = {c['id']: c.get('integrity') for c in doc.get('capabilities', [])}
-want = {'full', 'invoice'}
-if want <= set(caps):
-    print(f"  ✅ 装机清单两个能力都在（{', '.join(f'{k}={v}' for k, v in sorted(caps.items()))}）")
-else:
-    print(f"  ✗ 装机清单缺能力：{sorted(want - set(caps))}（实际 {sorted(caps)}）"); sys.exit(1)
-if all(caps[k] == 'verified' for k in want):
-    print('  ✅ 两个能力的 integrity 都是 verified')
-else:
-    print(f"  ✗ integrity 不是全 verified：{caps}"); sys.exit(1)
-if not os.path.exists(reg):
-    print(f'  ✗ 盘上注册表不在位：{reg}'); sys.exit(1)
-d = json.load(open(reg))
-c = sorted(d.get('capabilities') or {})
-if {'full', 'invoice'} <= set(c):
-    print(f"  ✅ 盘上注册表 = 两份投影的并集（capabilities：{', '.join(c)}）")
-else:
-    print(f"  ✗ 注册表缺能力条目（实际 {c}）—— 并集没写成"); sys.exit(1)
-PY
-[ "$?" = 0 ] || bad "E 步判据未过（装机清单 / 注册表并集，见上）"
-
-# ── 哨兵比对 ───────────────────────────────────────────────────────────────
-hdr "哨兵：真实目录零变化"
-sentinel "$FIX/sentinel-after.txt"
-tail -n +2 "$FIX/sentinel-before.txt" > "$FIX/sentinel-before.body"
-tail -n +2 "$FIX/sentinel-after.txt"  > "$FIX/sentinel-after.body"
-if diff -u "$FIX/sentinel-before.body" "$FIX/sentinel-after.body" > "$FIX/sentinel.diff" 2>&1; then
-  ok "真实目录哨兵逐字节一致（$FIX/sentinel-before.txt）"
-else
-  bad "真实目录哨兵有变化（本次演练本应零写入）："; cat "$FIX/sentinel.diff"
-fi
-if node "$REPO/scripts/check-test-env-safety.mjs" --verify "$FIX/sentinel-datadir-before.json" >"$FIX/sentinel-datadir.out" 2>&1; then
-  ok "真实数据目录三层判据（关键文件/新增文件/配置内容）无本次演练引起的改动"
-else
-  warn "真实数据目录有变化（可能是常驻服务的正常写入；逐条判断）："; tail -12 "$FIX/sentinel-datadir.out"
-fi
-
-# ── 汇总 ───────────────────────────────────────────────────────────────────
-hdr "汇总"
-python3 - "$FIX" <<'PY'
-import json,os,sys
-fix=sys.argv[1]
-for tag in ('A','B','C','D','E','F'):
-    p=os.path.join(fix,f'report-{tag}.json')
-    if not os.path.exists(p): print(f'  {tag}: （无报告）'); continue
-    d=json.load(open(p))
-    st={s['id']:s['status'] for s in d['steps']}
-    print(f"  {tag}: ok={d['ok']} mode={d['mode']} 耗时={d['elapsedSeconds']}s 逐段={st}")
-    print(f"      装配={d['segments']['install']}")
-    print(f"      技能={d['segments']['skills']}")
-    print(f"      许可={d['segments']['license']}")
-    print(f"      自检={d['selfCheck']}")
-PY
-note ""
-if [ "$FAIL" = 0 ]; then
-  note "✅ 演练全部符合预期（夹具：${FIX}）"
-else
-  note "✗ 演练有不符合预期项（夹具：${FIX}）—— 逐条见上"
-fi
-if [ "$KEEP" = 0 ] && [ "$FAIL" = 0 ]; then rm -rf "$FIX"; note "（夹具已清理；要留证据加 --keep）"; else note "（夹具保留：${FIX}）"; fi
-exit "$FAIL"