@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/init-ml.sh

@@ -0,0 +1,2275 @@
+#!/bin/bash
+# ============================================================
+# init-ml.sh — ML 卖家诊断/后备工具（KB-071：配置操作以 Argent 设置页 UI 为准，本脚本保留为
+# 诊断（--verify 体检）与后备（批量/无 UI 场景）用途；--verify 由设置页「一键体检」调用）
+# 一次配置全部客户侧参数：紫鸟环境 / ziniao apiKey / 飞书表格 /
+# 店铺映射（stores.json）/ CDP 端口 / cron 自动化
+#
+# 用法:
+#   init-ml.sh                完整初始化（首次使用）
+#   init-ml.sh --refresh-stores   仅刷新店铺选项（重跑 3a-3g，
+#                               紫鸟新增/改名环境后同步）
+#   init-ml.sh --reconfig     强制重新配置（忽略已有 fulfillment.env）
+#   init-ml.sh --verify       全链一致性校验（只读，输出红绿清单，
+#                               每个红灯附中文修复指引）
+#   init-ml.sh --daily-report 仅配置美客多日报推送（OAuth 授权 + cron；日常配置请用设置页 ML 配置区）
+#   init-ml.sh --feishu-gateway   仅配置飞书 gateway 对话接入
+#                               （App ID/Secret + 白名单 + gateway install）
+#
+# 飞书配置（App ID/Secret/Webhook）是 ML 角色的唯一配置点：
+# argent setup ③ 对 ML 角色已跳过（打印「由 ML 环境向导统一处理」），
+# 本向导统一处理飞书凭据/推送/登录/表格；已有配置自动检测复用（幂等）。
+# 明确顺序：先 argent setup，后 init-ml。
+#
+# 产物（argent-dsh 自持路径——脚本与数据均属 argent-dsh，不触碰 hermes 目录）:
+#   ~/.dsh/argent/stores.json      店铺映射（环境名 → store_id/platform/cdp_port）
+#   ~/.dsh/argent/fulfillment.env  飞书/店铺凭据
+#   ~/.dsh/argent/cdp-port-map.json  CDP 端口缓存（storeId → {store_name, env_name, cdp_port}，
+#                                   三方一致映射，由 ziniao-cli store list 提供名称）
+#   ~/.dsh/argent/daily-report.env 日报配置模板（ML 应用凭据 / 飞书 webhook / 补货参数）
+#   ~/.dsh/argent/ml-api-stores.json 美客多官方 API OAuth 授权（ml-oauth-setup.mjs 生成）
+#   ~/.argent-dsh/scripts/         固化脚本（poll/orchestrator/init/daily-report*，安装器部署）
+#   cron                           系统 crontab（每 5 分钟轮询 + 每小时日报门控）
+#
+# 飞书应用凭据（App ID/Secret）走 Web 配置中心（~/.dsh/argent/config.json）；
+# 本向导内 feishu 配置 / config bind / gateway 段为 hermes 遗留流程，新装请勿使用。
+# ============================================================
+set -euo pipefail
+
+# argent-dsh 自持路径：数据默认 ~/.dsh/argent/（update 不覆盖）；
+# 脚本默认 ~/.argent-dsh/scripts/（安装器部署）。ARGENT_DATA_HOME /
+# ARGENT_PROFILE_NAME / ARGENT_PROFILE_HOME 可覆盖（测试/多机）。
+PROFILE_NAME="${ARGENT_PROFILE_NAME:-argent-ml-seller}"
+PROFILE_HOME="${ARGENT_PROFILE_HOME:-$HOME/.argent-dsh}"
+PROFILE_SCRIPTS="$PROFILE_HOME/scripts"
+DATA_SCRIPTS="${ARGENT_DATA_HOME:-$HOME/.dsh/argent}"
+ENV_FILE="$DATA_SCRIPTS/fulfillment.env"
+STORES_JSON="$DATA_SCRIPTS/stores.json"
+CDP_CACHE="$DATA_SCRIPTS/cdp-port-map.json"
+DAILY_ENV="$DATA_SCRIPTS/daily-report.env"
+ML_API_STORES="$DATA_SCRIPTS/ml-api-stores.json"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+POLL_SRC="$SCRIPT_DIR/poll-fulfillment.sh"
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[0;33m'; CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m'
+log_info() { echo -e "${CYAN}→${NC} $*"; }
+log_ok()   { echo -e "${GREEN}✓${NC} $*"; }
+log_warn() { echo -e "${YELLOW}⚠${NC} $*"; }
+log_err()  { echo -e "${RED}✗${NC} $*"; }
+
+# 交互确认（默认 Yes）：返回 0=确认 / 1=拒绝；非交互（stdin EOF）视为拒绝
+_prompt() {
+  local ans
+  read -r -p "$1" ans
+  case "$(echo "$ans" | tr '[:upper:]' '[:lower:]')" in
+    ""|y|yes) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+REFRESH_STORES=0
+FORCE_RECONFIG=0
+FEISHU_GATEWAY_ONLY=0
+VERIFY_ONLY=0
+DAILY_REPORT_ONLY=0
+for arg in "$@"; do
+  case "$arg" in
+    --refresh-stores) REFRESH_STORES=1 ;;
+    --reconfig)       FORCE_RECONFIG=1 ;;
+    --verify)         VERIFY_ONLY=1 ;;
+    --daily-report)   DAILY_REPORT_ONLY=1 ;;
+    --feishu-gateway) FEISHU_GATEWAY_ONLY=1 ;;
+    *) echo "未知参数: ${arg}（支持 --refresh-stores / --reconfig / --verify / --daily-report / --feishu-gateway）" >&2; exit 1 ;;
+  esac
+done
+
+# ── 工具函数 ──────────────────────────────────────────────
+# 跨平台紫鸟客户端进程名：macOS 是 /Applications/ziniao.app（进程名 ziniao/Ziniao），
+# Windows 是 ziniaob（旧名 ziniaobro 兼容）——不再写死单一进程名
+ZINIAO_PROCS="ziniao|Ziniao|ziniaob|ziniaobro"
+
+# 探测已知 CDP 端口段（紫鸟店铺窗口 CDP 端口 52420+ 递增，curl /json/version 验证）
+probe_known_cdp_ports() {
+  local p
+  for p in $(seq 52420 52460); do
+    if curl -s -m 1 "http://127.0.0.1:${p}/json/version" >/dev/null 2>&1; then
+      echo "$p"
+    fi
+  done
+}
+
+# 跨平台紫鸟客户端检测：进程名（Mac: ziniao/Ziniao；Win: ziniaob）OR CDP 端口探测。
+# 返回 0=客户端运行中；1=未检测到。
+ziniao_client_running() {
+  local p
+  for p in ziniao Ziniao ziniaob ziniaobro; do
+    if pgrep -x "$p" >/dev/null 2>&1; then
+      return 0
+    fi
+  done
+  # CDP 端口探测兜底（进程名匹配不到时，端口通即认为客户端在跑）
+  [ -n "$(probe_known_cdp_ports)" ]
+}
+
+# 跨平台 CDP 端口发现：紫鸟进程（Mac: ziniao/Ziniao；Win: ziniaob）监听的
+# 127.0.0.1 端口逐端口 curl /json/version 验证（排除 9480/9481 等本地 API 端口），
+# 无进程匹配时回退已知端口段探测（与 orchestrator._discover_cdp_ports 语义一致）
+discover_cdp_ports() {
+  local ports p out=""
+  ports=$(lsof -i -P -n 2>/dev/null | awk "/${ZINIAO_PROCS}/ && /LISTEN/ { for (i=1;i<=NF;i++) if (\$i ~ /^127\\.0\\.0\\.1:[0-9]+\$/) { split(\$i, a, \":\"); print a[2] } }" | sort -n | uniq)
+  for p in $ports; do
+    # 必须响应含 "Browser" 才是 CDP 调试端口（curl 对 404/Forbidden 也返回 0）
+    if curl -s -m 1 "http://127.0.0.1:${p}/json/version" 2>/dev/null | grep -q '"Browser"'; then
+      out="$out $p"
+    fi
+  done
+  if [ -z "$out" ]; then
+    out=$(probe_known_cdp_ports)
+  fi
+  echo "$out"
+}
+
+has_api_key() {
+  # 检测紫鸟 apiKey 是否已配置（~/.ziniao/config.json 或 ~/.ziniao-cli/config.json 或 CLI 状态）
+  if [ -f "$HOME/.ziniao/config.json" ] && grep -q '"apiKey"' "$HOME/.ziniao/config.json" 2>/dev/null; then
+    return 0
+  fi
+  if [ -f "$HOME/.ziniao-cli/config.json" ] && grep -q '"apiKey"' "$HOME/.ziniao-cli/config.json" 2>/dev/null; then
+    return 0
+  fi
+  if command -v ziniao-cli >/dev/null 2>&1; then
+    if ziniao-cli config show 2>/dev/null | grep -q "apiKey"; then
+      return 0
+    fi
+  fi
+  return 1
+}
+
+# 旧布局迁移：早期数据可能落在脚本目录（~/.argent-dsh/scripts/）——
+# 检测旧路径文件存在且新路径（~/.dsh/argent/）无同名文件时复制过去（一次性）。
+migrate_legacy_data() {
+  local f
+  for f in stores.json fulfillment.env cdp-port-map.json; do
+    if [ -f "$PROFILE_SCRIPTS/$f" ] && [ ! -e "$DATA_SCRIPTS/$f" ]; then
+      mkdir -p "$DATA_SCRIPTS"
+      cp "$PROFILE_SCRIPTS/$f" "$DATA_SCRIPTS/$f"
+      log_ok "已迁移旧配置 ${PROFILE_SCRIPTS}/${f} → ${DATA_SCRIPTS}/${f}（v0.6.1 客户数据新位置）"
+    fi
+  done
+}
+
+# ── 1. 环境检测 ───────────────────────────────────────────
+check_env() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🔧 环境检测"
+  echo "════════════════════════════════════════════════"
+
+  if command -v ziniao-cli >/dev/null 2>&1; then
+    log_ok "ziniao-cli 可用: $(command -v ziniao-cli)"
+  else
+    log_err "未找到 ziniao-cli"
+    echo "  请先安装紫鸟 CLI："
+    echo "    npm install -g ziniao-cli"
+    echo "    或参考 https://open.ziniao.com 安装说明"
+    return 1
+  fi
+
+  local ports
+  if ziniao_client_running; then
+    log_ok "紫鸟客户端运行中（跨平台检测：进程名 OR CDP 端口）"
+    ports=$(discover_cdp_ports)
+    if [ -n "$ports" ]; then
+      log_ok "发现 CDP 端口: $(echo "$ports" | tr '\n' ' ')"
+    else
+      log_warn "客户端运行中但暂无店铺窗口（CDP 端口未探测到）"
+      echo "  稍后向导将自动打开所选店铺窗口（ziniao-cli store open --id <storeId>）"
+      echo "  如自动打开失败，请手动双击紫鸟中的店铺环境"
+    fi
+  else
+    log_warn "未检测到紫鸟客户端（Mac: ziniao/Ziniao；Win: ziniaob）"
+    echo "  请先启动紫鸟客户端（登录后向导可自动打开店铺窗口），再继续"
+    read -r -p "  按回车继续（或 Ctrl-C 退出）... " _dummy || true
+  fi
+
+  if command -v lark-cli >/dev/null 2>&1; then
+    log_ok "lark-cli 可用: $(command -v lark-cli)"
+  else
+    echo "  ℹ 检测到 lark-cli（飞书 CLI）未安装"
+    if ! command -v npm >/dev/null 2>&1; then
+      log_err "未找到 npm，请先安装 Node.js（LTS 版自带 npm）:"
+      echo "    https://nodejs.org/zh-cn/download"
+      echo "    或 macOS: brew install node"
+      return 1
+    fi
+    if _prompt "  是否自动安装？[Y/n]: "; then
+      # 国内客户机网络：npmmirror 可达（npmjs.org 不通）——优先国内源，失败 fallback 官方源
+      npm install -g @larksuite/cli --registry https://registry.npmmirror.com 2>/dev/null \
+        || npm install -g @larksuite/cli 2>/dev/null || true
+      if command -v lark-cli >/dev/null 2>&1; then
+        log_ok "lark-cli 就绪: $(command -v lark-cli)"
+      else
+        log_err "lark-cli 安装失败，请手动安装:"
+        echo "    npm install -g @larksuite/cli --registry https://registry.npmmirror.com"
+        return 1
+      fi
+    else
+      log_err "请先安装 lark-cli: npm install -g @larksuite/cli --registry https://registry.npmmirror.com"
+      return 1
+    fi
+  fi
+  return 0
+}
+
+# ── 2. ziniao apiKey 配置 ─────────────────────────────────
+ensure_api_key() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🔑 紫鸟开放平台 apiKey"
+  echo "════════════════════════════════════════════════"
+
+  if has_api_key; then
+    log_ok "apiKey 已配置（$(ziniao-cli config show 2>/dev/null | grep -o '"configPath": *"[^"]*"' | head -1 | sed 's/.*: *"//;s/"$//' || echo '~/.ziniao-cli/config.json')）"
+    return 0
+  fi
+
+  log_warn "未检测到紫鸟 apiKey 配置"
+  echo "  请登录紫鸟开放平台（https://open.ziniao.com）获取你的 apiKey"
+  echo "  ·「用户应用管理」vs「应用管理」区分：用户应用管理里创建的 Key 才能调用 ZClaw Bridge（store list 等本地自动化）；应用管理里的 Key 只能调服务端 ERP，store list 会报「API Key 认证失败」"
+  echo "    （拿错菜单是最常见坑，2026-08-15 实测：1504=应用管理不可用，6032=用户应用管理正确）"
+  echo "  · 新机器白名单：本机终端识别码须先加入「用户应用管理 → 终端管理」白名单，否则调用报 40004 拒绝"
+  echo "  · 成员/子账号：本脚本 config init 已用 --member 模式（跳过企业信息获取，绕过企业级 IP 白名单），用成员身份申请的 Key 即可"
+  read -r -p "  请输入 apiKey: " api_key
+  api_key="$(echo "$api_key" | tr -d '[:space:]')"
+  if [ -z "$api_key" ]; then
+    log_err "apiKey 不能为空"
+    return 1
+  fi
+
+  if command -v ziniao-cli >/dev/null 2>&1; then
+    # 参照本机现有方式：config init 写入 ~/.ziniao-cli/config.json（明文，成员账号）
+    if ! echo "$api_key" | ziniao-cli config init --api-key-stdin --member --no-keychain --profile ml-seller >/dev/null 2>&1; then
+      log_warn "ziniao-cli config init 失败，直接写入 ~/.ziniao/config.json"
+      mkdir -p "$HOME/.ziniao"
+      cat > "$HOME/.ziniao/config.json" << EOF
+{
+  "apiKey": "$api_key",
+  "serverUrl": "https://sbappstoreapi.ziniao.com"
+}
+EOF
+    fi
+    ziniao-cli config use ml-seller >/dev/null 2>&1 || true
+  else
+    mkdir -p "$HOME/.ziniao"
+    cat > "$HOME/.ziniao/config.json" << EOF
+{
+  "apiKey": "$api_key",
+  "serverUrl": "https://sbappstoreapi.ziniao.com"
+}
+EOF
+  fi
+  log_ok "apiKey 已保存"
+  return 0
+}
+
+# ── 3. 店铺初始化（核心）─────────────────────────────────
+# 3a. 获取环境列表
+fetch_store_list() {
+  local out
+  out=$(ziniao-cli store list 2>/dev/null) || {
+    # KB-071：区分「未配置 apiKey」与「已配置但认证失败」
+    if has_api_key; then
+      log_err "ziniao-cli store list 失败（apiKey 已配置但认证失败）"
+      echo "    💡 修复：Argent 设置页 → ML 配置区 → 紫鸟 API Key 重新配置"
+      echo "       · 注意 key 来源：必须在紫鸟开放平台「用户应用管理」创建（才能调 ZClaw Bridge/store list）；"
+      echo "         「应用管理」里的 Key 只能调服务端 ERP，store list 会报「API Key 认证失败」"
+    else
+      log_err "ziniao-cli store list 失败（未检测到 apiKey 配置）"
+      echo "    💡 修复：Argent 设置页 → ML 配置区 → 填写紫鸟 API Key（开放平台「用户应用管理」获取）"
+    fi
+    echo "       · 同时确认紫鸟客户端已启动并登录（store list 依赖本地客户端）"
+    return 1
+  }
+  python3 - "$out" << 'PYEOF'
+import json, sys
+try:
+    d = json.loads(sys.argv[1])
+    items = d.get("data", {}).get("items", [])
+except Exception:
+    sys.exit(1)
+# 过滤 MercadoLibre 平台
+ml = [i for i in items if "MercadoLibre" in (i.get("platformName") or "")]
+for i in ml:
+    print(f"{i.get('storeName')}\t{i.get('storeId')}\t{i.get('platformName')}")
+PYEOF
+}
+
+# 3c/3d. 交互选择 + 生成 stores.json
+init_stores() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🏬 店铺初始化（紫鸟环境 → FULL 货件）"
+  echo "════════════════════════════════════════════════"
+
+  local list
+  list=$(fetch_store_list) || return 1
+  if [ -z "$list" ]; then
+    log_err "未找到 MercadoLibre 环境（ziniao-cli store list 无结果）"
+    return 1
+  fi
+
+  echo "  紫鸟中的 MercadoLibre 环境："
+  echo ""
+  local i=0 name id platform
+  while IFS=$'\t' read -r name id platform; do
+    [ -z "$name" ] && continue
+    i=$((i + 1))
+    printf "   [%d] %s  (storeId=%s, %s)\n" "$i" "$name" "$id" "$platform"
+  done <<< "$list"
+  echo ""
+
+  read -r -p "  选择用于 FULL 货件的环境编号（逗号分隔，如 1,2；回车=全部）: " choice
+  choice="$(echo "$choice" | tr -d '[:space:]')"
+  if [ -z "$choice" ]; then
+    choice=$(seq -s, 1 "$i")
+  fi
+
+  # 校验选择
+  local selected=""
+  local c
+  IFS=',' read -ra picks <<< "$choice"
+  for c in "${picks[@]}"; do
+    if [ "$c" -ge 1 ] 2>/dev/null && [ "$c" -le "$i" ] 2>/dev/null; then
+      selected="$selected $c"
+    else
+      log_warn "忽略无效编号: $c"
+    fi
+  done
+  if [ -z "$selected" ]; then
+    log_err "未选择任何环境"
+    return 1
+  fi
+
+  # 3d. 生成 stores.json（cdp_port 待探测）
+  echo ""
+  log_info "生成店铺映射 stores.json ..."
+  mkdir -p "$DATA_SCRIPTS"
+  local sel_list="$selected"
+  python3 - "$STORES_JSON" "$sel_list" << 'PYEOF'
+import json, os, subprocess, sys
+
+stores_path, sel_str = sys.argv[1], sys.argv[2]
+selected = [int(x) for x in sel_str.split()]
+
+# 重新取 store list 保证名称/id 一致
+out = subprocess.run(["ziniao-cli", "store", "list"], capture_output=True, text=True)
+items = json.loads(out.stdout)["data"]["items"]
+ml = [i for i in items if "MercadoLibre" in (i.get("platformName") or "")]
+
+# 重建而非合并：客户取消选择的环境应从 stores.json 移除（--refresh-stores 同步语义）
+old = {}
+try:
+    with open(stores_path) as f:
+        old = json.load(f)
+except Exception:
+    pass
+
+stores = {}
+for idx in selected:
+    if idx - 1 >= len(ml):
+        continue
+    it = ml[idx - 1]
+    name = it["storeName"]
+    prev = old.get(name, {})
+    stores[name] = {
+        "store_id": it["storeId"],
+        "platform": it.get("platformName", ""),
+        "cdp_port": prev.get("cdp_port"),
+    }
+
+if unresolved:
+    print()
+    print(f"  ⚠ {len(unresolved)} 个店铺端口无法自动关联（{', '.join(unresolved)}）——"
+          f"若这些窗口均已打开且无法区分，请关闭多余窗口后重跑自动探测，"
+          f"或在 stores.json 手动填写 cdp_port 字段")
+
+with open(stores_path, "w") as f:
+    json.dump(stores, f, ensure_ascii=False, indent=2)
+print("stores.json 已更新:", list(stores.keys()))
+PYEOF
+  return 0
+}
+
+# 3e. 打开窗口 + 探测 CDP 端口
+probe_store_ports() {
+  echo ""
+  log_info "打开所选环境窗口并探测 CDP 端口 ..."
+  echo "  （每个环境会打开独立可见窗口，请勿关闭；已打开的窗口将复用）"
+
+  python3 - "$STORES_JSON" "$CDP_CACHE" << 'PYEOF'
+import json, os, subprocess, sys, time, urllib.request
+
+stores_path, cache_path = sys.argv[1], sys.argv[2]
+with open(stores_path) as f:
+    stores = json.load(f)
+
+unresolved = []
+
+# CDP 端口 → store_id 精确映射：监听端口进程的 user-data-dir 含 chrome_<storeId>
+# （紫鸟每个店铺独立用户数据目录，实测可精确关联已打开窗口的端口；
+#   只在 user-data-dir 参数内匹配，且仅认 stores.json 中真实存在的 store_id）
+def ports_by_store_id(store_ids):
+    import re
+    mapping = {}
+    try:
+        out = subprocess.run(["lsof", "-i", "-P", "-n", "-sTCP:LISTEN"],
+                             capture_output=True, text=True, timeout=10)
+        pid_by_port = {}
+        for line in out.stdout.splitlines():
+            m = re.search(r":(\d+)\s+\(LISTEN\)", line)
+            if m:
+                pid_by_port.setdefault(int(m.group(1)), set()).add(line.split()[1])
+        for port, pids in pid_by_port.items():
+            for pid in pids:
+                try:
+                    cmd = subprocess.run(["ps", "-p", str(pid), "-o", "command="],
+                                         capture_output=True, text=True, timeout=5).stdout
+                    m2 = re.search(r"user-data-dir[=\s\"']+[^\"']*?chrome_(\d+)", cmd)
+                    if m2 and m2.group(1) in store_ids:
+                        mapping[port] = m2.group(1)
+                        break
+                except Exception:
+                    continue
+    except Exception:
+        pass
+    return mapping
+
+port2store = ports_by_store_id({str(e.get("store_id") or "") for e in stores.values()})
+
+# 跨平台紫鸟进程名：Mac: ziniao/Ziniao（/Applications/ziniao.app）；Win: ziniaob（旧名 ziniaobro 兼容）
+ZINIAO_MARKS = ("ziniao", "ziniaob")
+
+def is_cdp_port(port, timeout=1.0):
+    """curl /json/version 验证端口是 CDP 调试端口（排除 9480/9481 等本地 API 端口）。"""
+    try:
+        with urllib.request.urlopen(f"http://127.0.0.1:{port}/json/version", timeout=timeout) as r:
+            return b"Browser" in r.read(200)
+    except Exception:
+        return False
+
+def discover_ports():
+    """跨平台 CDP 端口发现：紫鸟进程（Mac ziniao/Ziniao；Win ziniaob）监听端口
+    + /json/version 验证；无进程匹配时回退已知端口段（52420+ 递增）探测。"""
+    ports = []
+    try:
+        out = subprocess.run(["lsof", "-i", "-P", "-n"], capture_output=True, text=True, timeout=10)
+        for line in out.stdout.splitlines():
+            low = line.lower()
+            if any(m in low for m in ZINIAO_MARKS) and "LISTEN" in line:
+                for p in line.split():
+                    if p.startswith("127.0.0.1:"):
+                        port = p.split(":")[-1]
+                        if port.isdigit():
+                            ports.append(int(port))
+    except Exception:
+        pass
+    ports = [p for p in sorted(set(ports)) if is_cdp_port(p)]
+    if not ports:
+        # 回退：已知 CDP 端口段（52420+ 递增）
+        for p in range(52420, 52461):
+            if is_cdp_port(p, timeout=0.5):
+                ports.append(p)
+    return sorted(set(ports))
+
+# 读缓存（storeId → {store_name, env_name, cdp_port}；兼容旧格式 店铺名 → 端口）
+cached = {}
+try:
+    with open(cache_path) as f:
+        raw_cache = json.load(f)
+    for k, v in raw_cache.items():
+        if isinstance(v, dict) and v.get("cdp_port"):
+            cached[str(k)] = {"store_name": v.get("store_name", k),
+                              "env_name": v.get("env_name", ""),
+                              "cdp_port": int(v["cdp_port"])}
+        elif str(v).isdigit():
+            cached[str(k)] = {"store_name": k, "env_name": "", "cdp_port": int(v)}
+except Exception:
+    pass
+
+for name, entry in stores.items():
+    before = set(discover_ports())
+    store_id = str(entry.get("store_id") or "")
+    # 打开窗口（非 headless 显式声明）；优先 --id（name 可能重复/变更），旧数据无 store_id 时回退 --name
+    cmd = ["ziniao-cli", "store", "open", "--headless=false"]
+    if store_id:
+        cmd += ["--id", store_id]
+    else:
+        cmd += ["--name", name]
+    try:
+        r = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
+        raw = r.stdout
+        start = raw.find("{")
+        data = json.loads(raw[start:]) if start >= 0 else {}
+        reused = data.get("data", {}).get("reused", False)
+    except Exception as e:
+        print(f"  ⚠ {name}: store open 失败: {e}")
+        print(f"    请手动双击紫鸟中的「{name}」环境打开窗口，再重新运行")
+        continue
+    time.sleep(4)
+    after = set(discover_ports())
+    new_ports = sorted(after - before)
+    port = None
+    if len(new_ports) == 1:
+        port = new_ports[0]
+    elif reused and store_id in cached and cached[store_id]["cdp_port"] in after:
+        port = cached[store_id]["cdp_port"]
+    elif len(after) == 1:
+        port = list(after)[0]
+    elif not new_ports and store_id in cached and cached[store_id]["cdp_port"] in after:
+        port = cached[store_id]["cdp_port"]
+
+    if port is None and port2store:
+        # user-data-dir 匹配：chrome_<storeId> 精确关联已打开窗口（仅 CDP 端口集合）
+        sid = str(entry.get("store_id") or "")
+        for pnum, psid in port2store.items():
+            if psid == sid and pnum in after:
+                port = pnum
+                print(f"  ✓ {name}: CDP 端口 = {port}（窗口 user-data-dir 匹配 chrome_{sid}）")
+                break
+    if port is not None:
+        entry["cdp_port"] = int(port)
+        print(f"  ✓ {name}: CDP 端口 = {port}{'（复用缓存）' if port in [v['cdp_port'] for v in cached.values()] and port not in new_ports else ''}")
+    else:
+        entry["cdp_port"] = None
+        print(f"  ⚠ {name}: 无法确定 CDP 端口（当前端口: {sorted(after)}），请手动补充 stores.json cdp_port")
+        unresolved.append(name)
+
+if unresolved:
+    print()
+    print(f"  ⚠ {len(unresolved)} 个店铺端口无法自动关联（{', '.join(unresolved)}）——"
+          f"若这些窗口均已打开且无法区分，请关闭多余窗口后重跑自动探测，"
+          f"或在 stores.json 手动填写 cdp_port 字段")
+
+with open(stores_path, "w") as f:
+    json.dump(stores, f, ensure_ascii=False, indent=2)
+
+# 更新缓存：storeId → {store_name, env_name, cdp_port}（三方一致映射——
+# storeId/店铺名/环境名 均来自 ziniao-cli store list，端口来自本次探测）
+meta = {}
+try:
+    out = subprocess.run(["ziniao-cli", "store", "list"], capture_output=True, text=True, timeout=30)
+    items = json.loads(out.stdout)["data"]["items"]
+    meta = {str(i["storeId"]): {"store_name": i.get("storeName", ""),
+                                 "env_name": i.get("platformName", "")} for i in items}
+except Exception:
+    pass
+
+port_map = {}
+for name, entry in stores.items():
+    sid = str(entry.get("store_id") or "")
+    if entry.get("cdp_port") and sid:
+        m = meta.get(sid, {})
+        port_map[sid] = {
+            "store_name": m.get("store_name") or name,
+            "env_name": m.get("env_name", ""),
+            "cdp_port": int(entry["cdp_port"]),
+        }
+with open(cache_path, "w") as f:
+    json.dump(port_map, f, ensure_ascii=False, indent=2)
+PYEOF
+  return 0
+}
+
+# 3f. 飞书「店铺名称」字段同步为单选
+# 表格为 BOT 所建（方案 B）——默认 bot 身份即可（bot 是 Base 创建者/管理员，
+# 转移所有者后仍保留可管理 full_access）。
+sync_feishu_field() {
+  echo ""
+  log_info "同步飞书「店铺名称」字段为单选选项 ..."
+  local base_token="$1" table_id="$2"
+
+  python3 - "$STORES_JSON" "$base_token" "$table_id" << 'PYEOF'
+import json, os, subprocess, sys
+
+stores_path, base_token, table_id = sys.argv[1], sys.argv[2], sys.argv[3]
+with open(stores_path) as f:
+    stores = json.load(f)
+names = list(stores.keys())
+if not names:
+    print("  ⚠ stores.json 为空，跳过字段同步")
+    sys.exit(0)
+
+options = [{"name": n} for n in names]
+# lark-cli 1.0.53 API 要求字符串判别值 type="select"，options 在顶层
+# （"type":3 数字形式会被 API 拒绝: Invalid discriminator value）
+field_json = json.dumps({
+    "name": "店铺名称",
+    "type": "select",
+    "multiple": False,
+    "options": options,
+}, ensure_ascii=False)
+
+cmd = ["lark-cli", "base", "+field-update",
+       "--base-token", base_token, "--table-id", table_id,
+       "--field-id", "店铺名称", "--json", field_json, "--yes"]
+
+r = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
+if r.returncode != 0:
+    print(f"  ✗ 字段更新失败: {r.stderr or r.stdout}")
+    sys.exit(1)
+print(f"  ✓ 「店铺名称」已改为单选，选项: {names}")
+PYEOF
+  return $?
+}
+
+# 3g. 旧记录迁移
+migrate_old_records() {
+  echo ""
+  log_info "检查旧记录「店铺名称」值是否需要迁移 ..."
+  local base_token="$1" table_id="$2"
+
+  # 第一步：查询并输出迁移计划（old_value \t target \t record_id,...）
+  # 注意：python 通过 heredoc 运行，stdin 被占用，交互确认必须在 bash 层做
+  local plan
+  plan=$(python3 - "$STORES_JSON" "$base_token" "$table_id" << 'PYEOF'
+import json, os, subprocess, sys
+
+stores_path, base_token, table_id = sys.argv[1], sys.argv[2], sys.argv[3]
+with open(stores_path) as f:
+    stores = json.load(f)
+valid = set(stores.keys())
+
+cmd = ["lark-cli", "base", "+record-list",
+       "--base-token", base_token, "--table-id", table_id,
+       "--format", "json"]
+r = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
+if r.returncode != 0:
+    print(f"  ⚠ 查询记录失败: {r.stderr or r.stdout}", file=sys.stderr)
+    sys.exit(0)
+d = json.loads(r.stdout)
+fields = d["data"]["fields"]
+rows = d["data"]["data"]
+rids = d["data"]["record_id_list"]
+try:
+    col = fields.index("店铺名称")
+except ValueError:
+    print("  ⚠ 表格无「店铺名称」字段", file=sys.stderr)
+    sys.exit(0)
+
+# 旧值 → [record_ids]
+old_map = {}
+for i, row in enumerate(rows):
+    val = row[col] if col < len(row) else None
+    if val is None:
+        continue
+    if isinstance(val, list):
+        val = val[0] if val else None
+    if val is None or str(val) in valid:
+        continue
+    old_map.setdefault(str(val), []).append(rids[i])
+
+if not old_map:
+    print("  ✓ 无需要迁移的旧记录", file=sys.stderr)
+    sys.exit(0)
+
+# 迁移映射（bash 层交互确认）
+LEGACY_MAP = {"1店": "1店-子账号", "2店": "2店-子账号", "3店": "3店-主账号"}
+for val, ids in old_map.items():
+    target = LEGACY_MAP.get(val)
+    if target and target in valid:
+        print(f"PLAN\t{val}\t{target}\t{','.join(ids)}")
+    else:
+        print(f"MANUAL\t{val}\t\t{','.join(ids)}")
+PYEOF
+)
+  [ $? -eq 0 ] || return 1
+
+  if [ -z "$plan" ]; then
+    return 0
+  fi
+
+  # 第二步：bash 交互确认 + 逐条迁移
+  # 用 fd 3 读计划，避免 here-string 被内层 read（用户输入）抢走
+  local plan_file
+  plan_file=$(mktemp)
+  printf '%s\n' "$plan" > "$plan_file"
+  local failed=0
+  while IFS=$'\t' read -r kind val target rid_csv <&3; do
+    [ -z "$kind" ] && continue
+    if [ "$kind" = "MANUAL" ]; then
+      local n_manual
+      n_manual=$(echo "$rid_csv" | tr ',' '\n' | grep -c . || true)
+      log_warn "「${val}」无法自动映射（${n_manual} 条记录），请人工在飞书表格中处理"
+      continue
+    fi
+    local n
+    n=$(echo "$rid_csv" | tr ',' '\n' | grep -c . || true)
+    echo "  建议迁移: 「${val}」→「${target}」（$n 条）"
+    read -r -p "  确认迁移? [Y/n] " ans
+    case "$(echo "$ans" | tr '[:upper:]' '[:lower:]')" in
+      ""|y|yes)
+        local ok=1 rid
+        IFS=',' read -ra rid_arr <<< "$rid_csv"
+        for rid in "${rid_arr[@]}"; do
+          upd=$(lark-cli base +record-upsert \
+            --base-token "$base_token" --table-id "$table_id" \
+            --record-id "$rid" --json "{\"店铺名称\":\"$target\"}" 2>&1) || { ok=0; echo "    ✗ 更新 $rid 失败: $upd"; }
+        done
+        if [ "$ok" = "1" ]; then
+          echo "    ✓ 已迁移 $n 条 →「${target}」"
+        else
+          failed=1
+        fi
+        ;;
+      *)
+        echo "    - 跳过「${val}」"
+        ;;
+    esac
+  done 3< "$plan_file"
+  rm -f "$plan_file"
+  return "$failed"
+}
+
+# 3h. 一致性验证
+# 表格为 BOT 所建——默认 bot 身份即可
+verify_consistency() {
+  echo ""
+  log_info "验证 stores.json 与表格选项一致性 ..."
+  local base_token="$1" table_id="$2"
+
+  python3 - "$STORES_JSON" "$base_token" "$table_id" << 'PYEOF'
+import json, os, subprocess, sys
+
+stores_path, base_token, table_id = sys.argv[1], sys.argv[2], sys.argv[3]
+with open(stores_path) as f:
+    stores = json.load(f)
+store_keys = set(stores.keys())
+
+cmd = ["lark-cli", "base", "+field-list",
+       "--base-token", base_token, "--table-id", table_id]
+r = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
+if r.returncode != 0:
+    print(f"  ✗ 查询字段失败: {r.stderr or r.stdout}")
+    sys.exit(1)
+d = json.loads(r.stdout)
+target = None
+for fld in d["data"]["fields"]:
+    if fld.get("name") == "店铺名称":
+        target = fld
+        break
+if target is None:
+    print("  ✗ 未找到「店铺名称」字段")
+    sys.exit(1)
+
+if target.get("type") != "select":
+    print(f"  ✗ 「店铺名称」字段类型不是单选（当前: {target.get('type')}）")
+    sys.exit(1)
+
+opts = {(o.get("name") if isinstance(o, dict) else o) for o in (target.get("options") or [])}
+if opts == store_keys:
+    print(f"  ✓ 一致性通过: 表格选项 == stores.json keys（{sorted(store_keys)}）")
+else:
+    print(f"  ✗ 不一致!")
+    print(f"    表格选项: {sorted(opts)}")
+    print(f"    stores.json: {sorted(store_keys)}")
+    print("    请重新运行 --refresh-stores 同步")
+    sys.exit(1)
+PYEOF
+  return $?
+}
+
+# ── 4. 飞书配置 ──────────────────────────────────────────
+# 4a0. 飞书凭据/推送配置（ML 角色唯一配置点）
+# argent setup ③ 对 ML 角色已跳过（打印「飞书配置将由 ML 环境向导统一处理」），
+# 本函数是 App ID/Secret/Webhook 的唯一入口；已有配置自动检测复用（幂等）。
+# 返回 0（跳过/失败都不中止向导——后续 check_lark_login 决定是否继续表格配置）。
+_write_feishu_config_webhook() {
+  # 写 config.yaml argent.feishu（mode=webhook）；缺 python3-yaml 时返回 1
+  local url="$1"
+  python3 - "$PROFILE_HOME" "$url" <<'PYEOF'
+import sys, os
+home, url = sys.argv[1], sys.argv[2]
+cfg_path = os.path.join(home, "config.yaml")
+try:
+    import yaml
+except Exception:
+    print("NO_YAML", file=sys.stderr)
+    sys.exit(1)
+cfg = {}
+if os.path.exists(cfg_path):
+    with open(cfg_path) as f:
+        cfg = yaml.safe_load(f) or {}
+if not isinstance(cfg, dict):
+    cfg = {}
+argent = cfg.get("argent")
+if not isinstance(argent, dict):
+    argent = {}
+argent["feishu"] = {"mode": "webhook", "webhook_url": url}
+cfg["argent"] = argent
+with open(cfg_path, "w") as f:
+    yaml.safe_dump(cfg, f, allow_unicode=True)
+print("OK")
+PYEOF
+}
+
+feishu_cred_setup() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🪽 飞书配置（ML 角色唯一入口）"
+  echo "════════════════════════════════════════════════"
+  echo "  argent setup ③ 已跳过飞书——App ID/Secret/Webhook 由本向导统一配置"
+  echo ""
+
+  # 幂等：已有配置直接复用（.env 应用凭据 或 config.yaml argent.feishu）
+  if [ -f "$PROFILE_HOME/.env" ] && grep -q '^FEISHU_APP_ID=' "$PROFILE_HOME/.env"; then
+    log_ok "检测到已有飞书应用凭据（${PROFILE_HOME}/.env FEISHU_APP_ID），复用现有配置"
+    return 0
+  fi
+  if [ -f "$PROFILE_HOME/config.yaml" ] && grep -qE '^[[:space:]]*feishu:' "$PROFILE_HOME/config.yaml"; then
+    log_ok "检测到已有飞书配置（config.yaml argent.feishu），复用现有配置"
+    return 0
+  fi
+
+  echo "  请选择飞书配置方式："
+  echo "    [1] 企业自建应用（App ID/Secret）— 推荐：推个人/群、支持文件、bitable 自动化必需"
+  echo "    [2] 群机器人 Webhook — 仅推群，配置最简单"
+  echo "    [3] 跳过（稍后补配）"
+  local choice
+  read -r -p "  请选择 [1-3]（默认 1）: " choice
+  choice="${choice:-1}"
+
+  case "$choice" in
+    2)
+      local url
+      read -r -p "  输入 Webhook URL（https://open.feishu.cn/open-apis/bot/v2/hook/...）: " url
+      url="$(echo "$url" | tr -d '[:space:]')"
+      if [ -z "$url" ]; then
+        log_warn "Webhook URL 为空，已跳过飞书配置"
+        return 0
+      fi
+      if ! _write_feishu_config_webhook "$url"; then
+        log_warn "config.yaml 写入失败（本机缺 python3-yaml）——请稍后运行 argent feishu-setup 补配"
+      else
+        log_ok "Webhook 已写入 config.yaml（argent.feishu mode=webhook）"
+      fi
+      ;;
+    3)
+      echo "  已跳过飞书配置（后续可重跑本向导，或 argent feishu-setup 补配）"
+      ;;
+    *)
+      local app_id app_secret
+      read -r -p "  输入 App ID: " app_id
+      app_id="$(echo "$app_id" | tr -d '[:space:]')"
+      if [ -z "$app_id" ]; then
+        log_warn "App ID 为空，已跳过飞书配置"
+        return 0
+      fi
+      read -r -p "  输入 App Secret: " app_secret
+      app_secret="$(echo "$app_secret" | tr -d '[:space:]')"
+      if [ -z "$app_secret" ]; then
+        log_warn "App Secret 为空，已跳过飞书配置"
+        return 0
+      fi
+      mkdir -p "$PROFILE_HOME"
+      local env_path="$PROFILE_HOME/.env"
+      touch "$env_path"
+      local tmp
+      tmp=$(mktemp)
+      grep -vE '^(FEISHU_APP_ID=|FEISHU_APP_SECRET=)' "$env_path" > "$tmp" || true
+      cat >> "$tmp" << EOF
+FEISHU_APP_ID=$app_id
+FEISHU_APP_SECRET=$app_secret
+EOF
+      mv "$tmp" "$env_path"
+      log_ok "飞书应用凭据已写入 ${env_path}"
+      echo "  后续 lark-cli config bind / gateway 将自动读取（无需重复输入）"
+      ;;
+  esac
+  return 0
+}
+
+# 4a. 登录态检测
+# 已登录（bot/user 任一 identity status=ready）返回 0；未登录时向导内直接触发登录
+# （自动打开系统浏览器授权——无需另开终端）；拒绝/超时返回 1（跳过飞书配置，后续可补）。
+lark_auth_ready() {
+  lark-cli auth status 2>/dev/null | grep -q '"status": "ready"'
+}
+
+# 4a1. 引导飞书应用凭据绑定（bot 身份需要 FEISHU_APP_ID/FEISHU_APP_SECRET——
+#      config bind --source hermes 自动读取 hermes 上下文凭据，绑定后 bot 立即 ready）
+lark_ensure_bound() {
+  if lark-cli config show 2>/dev/null | grep -q '"appId"'; then
+    return 0
+  fi
+  log_warn "飞书应用凭据未绑定（bot 身份需要 FEISHU_APP_ID/FEISHU_APP_SECRET）"
+  if ! _prompt "  是否现在绑定（lark-cli config bind --source hermes）？[Y/n]: "; then
+    echo "  已跳过绑定。稍后手动执行:"
+    echo "    lark-cli config bind --source hermes --identity bot-only"
+    return 1
+  fi
+  if lark-cli config bind --source hermes --identity bot-only 2>&1 | tail -2; then
+    log_ok "应用凭据绑定成功（bot 身份）"
+    return 0
+  fi
+  log_err "绑定失败——请先在 hermes 环境配置 FEISHU_APP_ID/FEISHU_APP_SECRET:"
+  echo "    ~/.hermes/.env 或 profile .env（如 ~/.hermes/profiles/argent-ml-seller/.env）"
+  echo "    然后手动执行: lark-cli config bind --source hermes --identity bot-only"
+  return 1
+}
+
+check_lark_login() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  📋 飞书登录授权（lark-cli，表格自动化需要）"
+  echo "════════════════════════════════════════════════"
+
+  if lark_auth_ready; then
+    log_ok "lark-cli 已登录（bot identity ready）"
+    return 0
+  fi
+
+  log_warn "lark-cli 未登录（bot 不可用）"
+  echo "  · 授权链接 10 分钟有效，客户需在现场点击「授权」；本机浏览器已登录飞书时一键即可"
+  echo "  · 授权账号 = 客户自己的飞书账号（所有权将转移给该账号，无邮箱要求，openid 机制）"
+  if ! _prompt "  是否现在登录（将自动打开飞书授权页）？[Y/n]: "; then
+    echo "  已跳过登录。稍后手动执行: lark-cli auth login"
+    echo "  本次跳过飞书配置（后续重跑向导可补）"
+    return 1
+  fi
+
+  # bot 身份即可：未绑定应用凭据时先引导 config bind（读取 hermes 上下文凭据）
+  if ! lark-cli config show 2>/dev/null | grep -q '"appId"'; then
+    lark_ensure_bound || return 1
+    if lark_auth_ready; then
+      log_ok "lark-cli 已登录（bot identity ready）"
+      return 0
+    fi
+  fi
+
+  # auth login（device flow，自动打开系统浏览器）+ 轮询 auth status 最多 120 秒
+  echo ""
+  echo "  ⏳ 授权完成后自动继续（最多等待 120 秒）..."
+  lark-cli auth login 2>&1 &
+  local login_pid=$!
+  local waited=0
+  while [ "$waited" -lt 120 ]; do
+    sleep 5
+    waited=$((waited + 5))
+    if lark_auth_ready; then
+      log_ok "lark-cli 登录成功（等待 ${waited}s）"
+      kill "$login_pid" 2>/dev/null || true
+      wait "$login_pid" 2>/dev/null || true
+      return 0
+    fi
+    # auth login 提前退出（如 strict-mode 拒绝）→ 再确认一次登录态后结束轮询
+    if ! kill -0 "$login_pid" 2>/dev/null; then
+      if lark_auth_ready; then
+        log_ok "lark-cli 登录成功"
+        return 0
+      fi
+      break
+    fi
+  done
+  kill "$login_pid" 2>/dev/null || true
+  wait "$login_pid" 2>/dev/null || true
+  log_warn "登录未完成（超时 120s 或 auth login 提前退出）"
+  echo "  请稍后手动执行: lark-cli auth login"
+  echo "  本次跳过飞书配置（后续重跑向导可补）"
+  return 1
+}
+
+# 4b. 表格 URL 输入解析
+parse_table_url() {
+  echo ""
+  if [ -n "${FEISHU_BASE_TOKEN:-}" ] && [ -n "${FEISHU_TABLE_ID:-}" ] && [ "$FORCE_RECONFIG" = "0" ]; then
+    echo "  当前配置表格:"
+    echo "    Base Token: ${FEISHU_BASE_TOKEN:0:12}..."
+    echo "    Table ID:   ${FEISHU_TABLE_ID}"
+    read -r -p "  使用已有表格? [Y/n] " use_existing
+    case "$(echo "$use_existing" | tr '[:upper:]' '[:lower:]')" in
+      ""|y|yes) return 0 ;;
+    esac
+  fi
+
+  # 客户飞书邮箱（将成为表格所有者/管理员；BOT 代建后授予 full_access 并转移所有者）
+  local owner_email=""
+  while [ -z "$owner_email" ]; do
+    if ! read -r -p "  请输入客户飞书邮箱（该账号将成为表格所有者）: " owner_email; then
+      log_err "未输入邮箱，已中止表格配置"
+      return 1
+    fi
+    owner_email="$(echo "$owner_email" | tr -d '[:space:]')"
+    if [ -n "$owner_email" ] && ! echo "$owner_email" | grep -qE '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$'; then
+      log_err "邮箱格式不正确，请重新输入（例如 name@company.com）"
+      owner_email=""
+    fi
+  done
+  FEISHU_OWNER_EMAIL="$owner_email"
+  export FEISHU_OWNER_EMAIL
+
+  echo "  表格来源："
+  echo "    [1] BOT 代建（推荐）— 系统自动创建「FULL任务」表（12 字段 + 3 视图），"
+  echo "        并授予 ${owner_email} 可管理权限（full_access）+ 转移 Base 所有者"
+  echo "    [2] 已有表格 — 使用已建好的「FULL任务」表格链接"
+  echo "    [3] 手动建表 — 按指引在飞书手动建表后输入链接"
+  local src
+  read -r -p "  请选择 [1-3]（默认 1）: " src
+  src="${src:-1}"
+
+  local base_url
+  case "$src" in
+    2)
+      read -r -p "  请输入飞书多维表格 URL（https://xxx.feishu.cn/base/XXX?table=XXX）: " base_url
+      _parse_table_url "$base_url" || return 1
+      ;;
+    3)
+      manual_base_guide
+      read -r -p "  请输入飞书多维表格 URL（https://xxx.feishu.cn/base/XXX?table=XXX）: " base_url
+      _parse_table_url "$base_url" || return 1
+      ;;
+    *)
+      # BOT 代建：调用 base-bootstrap.sh（方案B）——BOT 建 Base+表+字段
+      # + 授客户 full_access + 转移所有者 + 回读验证闭环 + 测试记录写入/清理
+      echo ""
+      echo "  ⏳ BOT 代建（调用 base-bootstrap.sh）："
+      echo "      · BOT 代建新 Base 并创建「FULL任务」表（12 字段，schema 对齐固化文档）"
+      echo "      · 创建 3 个视图：「表格」·「待处理（筛选 就绪=true）」·「运营填写」（仅运营 5 字段）"
+      echo "      · 自动将 ${owner_email} 添加为协作者（可管理 full_access）并转移 Base 所有者"
+      echo "      · 写入 1 条测试记录验证可写后自动清理"
+      echo "      · BASE_TOKEN/TABLE_ID/FEISHU_OWNER_EMAIL 自动写入 ${ENV_FILE}"
+      echo ""
+      if "$SCRIPT_DIR/base-bootstrap.sh" --owner-email "$owner_email" --env-file "$ENV_FILE"; then
+        # base-bootstrap 已写入 BASE_TOKEN/TABLE_ID（含 FEISHU_* 生态别名）→ 重新加载
+        set -a; source "$ENV_FILE"; set +a
+        if [ -n "${FEISHU_BASE_TOKEN:-}" ] && [ -n "${FEISHU_TABLE_ID:-}" ]; then
+          # 表格为 BOT 所建——后续字段同步/迁移/一致性校验默认 bot 身份即可
+          log_ok "BOT 代建完成：${FEISHU_BASE_TOKEN:0:12}... / ${FEISHU_TABLE_ID}"
+          return 0
+        fi
+        log_err "BOT 代建完成但 env 未写入成功（请检查 ${ENV_FILE}）"
+        return 1
+      fi
+      # 代建失败 → 提供 --force 重试 / 手动建表 fallback
+      log_err "BOT 代建失败（base-bootstrap.sh 退出码 $?）"
+      echo "  常见原因：飞书应用未就绪（App ID/Secret、权限 bitable:app/drive:drive、未发布），"
+      echo "           或邮箱不在当前飞书租户内"
+      echo ""
+      echo "  请选择："
+      echo "    [1] 重试 BOT 代建"
+      echo "    [2] 手动建表（按指引操作后输入链接；手动建的 Base 也需把应用添加为协作者）"
+      local retry
+      read -r -p "  请选择 [1-2]（默认 2）: " retry
+      retry="${retry:-2}"
+      if [ "$retry" = "1" ]; then
+        if "$SCRIPT_DIR/base-bootstrap.sh" --owner-email "$owner_email" --env-file "$ENV_FILE" --force; then
+          set -a; source "$ENV_FILE"; set +a
+          if [ -n "${FEISHU_BASE_TOKEN:-}" ] && [ -n "${FEISHU_TABLE_ID:-}" ]; then
+            log_ok "BOT 代建完成（--force 重试）"
+            return 0
+          fi
+        fi
+        log_err "BOT 代建再次失败——请转手动建表"
+      fi
+      manual_base_guide
+      read -r -p "  请输入飞书多维表格 URL（https://xxx.feishu.cn/base/XXX?table=XXX）: " base_url
+      _parse_table_url "$base_url" || return 1
+      ;;
+  esac
+  return 0
+}
+
+# 4b1. 解析已有表格 URL（https://xxx.feishu.cn/base/XXX?table=XXX）
+_parse_table_url() {
+  local table_url="$1"
+  local parsed
+  parsed=$(echo "$table_url" | python3 -c "
+import re, sys
+u = sys.stdin.read().strip()
+m1 = re.search(r'/base/([A-Za-z0-9]+)', u)
+m2 = re.search(r'table=([A-Za-z0-9]+)', u)
+print((m1[1] if m1 else '') + '\t' + (m2[1] if m2 else ''))
+")
+  FEISHU_BASE_TOKEN=$(echo "$parsed" | cut -f1)
+  FEISHU_TABLE_ID=$(echo "$parsed" | cut -f2)
+  if [ -z "$FEISHU_BASE_TOKEN" ] || [ -z "$FEISHU_TABLE_ID" ]; then
+    log_err "无法解析 URL，请确认格式: https://xxx.feishu.cn/base/XXX?table=XXX"
+    return 1
+  fi
+  log_ok "已解析表格配置"
+  return 0
+}
+
+# 4b2. 手动建表 fallback 指引（客户不愿自动建表时手把手步骤）
+manual_base_guide() {
+  echo ""
+  echo "  ── 手动建表指引（约 3 分钟）────────────────────────"
+  echo "  ① 打开飞书 → 新建空白多维表格（Base）"
+  echo "  ② 将默认数据表重命名为「FULL任务」"
+  echo "  ③ 依次添加以下 12 个字段："
+  echo "       · SKU（文本）——主字段"
+  echo "       · 状态（单选）：Pending / 运行中 / 已完成 / 失败"
+  echo "       · 店铺名称（单选）：3店-主账号 / 2店-子账号 / 1店-子账号"
+  echo "       · 品名（文本）· 数量（数字）· 箱数（数字）· 就绪（复选框）"
+  echo "       · 创建时间（日期-创建时间类型）· 当前步骤（文本）· 货件号（文本）"
+  echo "       · 产品标签（附件）· 箱唛（附件）"
+  echo "  ④ 新建视图「待处理」：筛选条件 就绪 = ✓（勾选）"
+  echo "  ⑤ 把飞书应用添加为 Base 协作者（可管理权限）：分享 Base → 添加应用/机器人 →"
+  echo "     选择您的飞书应用并授予可管理——否则后续 bot 操作会失败"
+  echo "  ⑥ 建好后复制表格链接（含 ?table= 参数），粘贴到下一步"
+  echo "  ──────────────────────────────────────────────────"
+  echo ""
+}
+
+# 4c. FEISHU_USER_ID 自动获取（按邮箱查 open_id，bot 身份直查）
+# 优先：用本环节已收集的客户邮箱调官方「通过邮箱获取用户 ID」API（bot 身份）；
+# 失败时若用户身份可用可试 contact +search-user（需 --as user）；
+# 仍取不到则指引给 BOT 发消息/管理后台查 open_id，保留手动输入兜底。
+auto_feishu_user() {
+  echo ""
+  log_info "获取飞书客户 open_id（推送目标）..."
+  local owner_email="${FEISHU_OWNER_EMAIL:-}"
+  if [ -n "$owner_email" ]; then
+    FEISHU_USER_ID=$(lark-cli api POST "/open-apis/contact/v3/users/batch_get_id" \
+      --as bot --params '{"user_id_type":"open_id"}' \
+      --data "{\"emails\":[\"${owner_email}\"]}" \
+      --format json 2>/dev/null | python3 -c "
+import json, sys
+try:
+    d = json.load(sys.stdin)
+    ul = d.get('data', {}).get('user_list', [])
+    print(ul[0].get('user_id', '') if ul else '')
+except Exception:
+    pass
+")
+  fi
+  if [ -z "$FEISHU_USER_ID" ] && [ -n "$owner_email" ]; then
+    # 兜底：用户身份可用时按邮箱搜索（lark-cli contact +search-user 需 --as user）
+    FEISHU_USER_ID=$(lark-cli contact +search-user --query "$owner_email" --as user 2>/dev/null | python3 -c "
+import json, sys
+try:
+    d = json.load(sys.stdin)
+    print(d.get('user_open_id') or d.get('data', {}).get('open_id') or '')
+except Exception:
+    pass
+")
+  fi
+  if [ -n "$FEISHU_USER_ID" ]; then
+    log_ok "推送目标 open_id: ${FEISHU_USER_ID:0:12}..."
+  else
+    log_warn "无法自动获取 open_id（应用需有 contact:user.id:readonly「获取用户 ID」权限，且用户在本租户）"
+    echo "  获取 open_id 的方法："
+    echo "    · 让客户在飞书里给 BOT 发一条消息，BOT 日志会记录其 open_id"
+    echo "    · 飞书管理后台 → 成员 → 查看成员 open_id"
+    read -r -p "  请手动输入飞书用户 open_id（或留空跳过）: " FEISHU_USER_ID
+  fi
+  return 0
+}
+
+# ── 5. 机器环境 ──────────────────────────────────────────
+# 系统 crontab 注册（幂等）：已有含 poll-fulfillment.sh 的行 → 整体替换为
+# 当前脚本绝对路径；否则追加（每 5 分钟轮询）。ml-status 的 cronRegistered
+# 即检查 crontab 是否含 poll-fulfillment.sh。
+# 另注册日报小时任务：每小时整点跑 daily-report.mjs，脚本内部按各站点
+# 本地时间门控（gateDue）+ 幂等标记，未到点/已推送自动跳过（多站点自动适配）。
+register_cron() {
+  local poll_abs cron_cmd cron_line daily_line cron_file daily_abs
+  poll_abs="$PROFILE_SCRIPTS/poll-fulfillment.sh"
+  if [ -f "$poll_abs" ]; then
+    cron_cmd="/bin/bash ${poll_abs} >> ${DATA_SCRIPTS}/fulfillment-logs/cron.log 2>&1"
+    cron_line="*/5 * * * * ${cron_cmd}"
+  else
+    log_warn "未找到轮询脚本 ${poll_abs}，跳过履约 cron"
+    cron_line=""
+  fi
+  daily_abs="$PROFILE_SCRIPTS/daily-report.mjs"
+  daily_line=""
+  if [ -f "$daily_abs" ] && command -v node >/dev/null 2>&1; then
+    mkdir -p "${DATA_SCRIPTS}/daily-report-logs"
+    daily_line="0 * * * * $(command -v node) ${daily_abs} >> ${DATA_SCRIPTS}/daily-report-logs/cron.log 2>&1"
+  else
+    log_warn "未找到日报脚本或 node，跳过日报 cron"
+  fi
+  cron_file=$(mktemp -t argent-cron.XXXXXX)
+  crontab -l 2>/dev/null | grep -v -e "poll-fulfillment.sh" -e "daily-report.mjs" > "$cron_file" || true
+  [ -n "$cron_line" ] && printf '%s\n' "$cron_line" >> "$cron_file"
+  [ -n "$daily_line" ] && printf '%s\n' "$daily_line" >> "$cron_file"
+  if crontab "$cron_file"; then
+    log_ok "Cron 已注册（系统 crontab）：履约每 5 分钟 + 日报每小时整点（门控推送）"
+    rm -f "$cron_file"
+    return 0
+  fi
+  rm -f "$cron_file"
+  log_warn "cron 注册失败——可手动执行: (crontab -l; echo '${cron_line}'; echo '${daily_line}') | crontab -"
+  return 1
+}
+
+# 读 argent 配置中心的 ML 相关键（feishuBaseUrl / feishuUserId），输出 "url<TAB>uid"
+read_argent_cfg() {
+  python3 -c "
+import json, os
+try:
+    d = json.load(open(os.path.expanduser('~/.dsh/argent/config.json')))
+except Exception:
+    d = {}
+print((d.get('feishuBaseUrl') or '') + '\t' + (d.get('feishuChatId') or ''))
+"
+}
+
+# env 键安全写入：已有键原地替换，否则追加（绝不触碰其他键）
+update_env_key() {
+  local key="$1" val="$2" file="$3"
+  if grep -qE "^${key}=" "$file" 2>/dev/null; then
+    if [ "$(uname -s)" = "Darwin" ]; then
+      sed -i '' "s|^${key}=.*|${key}=${val}|" "$file"
+    else
+      sed -i "s|^${key}=.*|${key}=${val}|" "$file"
+    fi
+  else
+    printf '%s=%s\n' "$key" "$val" >> "$file"
+  fi
+}
+
+setup_machine() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🖥 机器环境（Playwright / 轮询脚本 / cron）"
+  echo "════════════════════════════════════════════════"
+
+  # 5a. Playwright venv
+  log_info "安装 Playwright（~/.dsh/argent/venv，python3.11+）..."
+  local py
+  if command -v python3.11 >/dev/null 2>&1; then py=python3.11
+  elif command -v python3.12 >/dev/null 2>&1; then py=python3.12
+  elif /usr/bin/python3 --version 2>&1 | grep -q "3.1[1-9]"; then py=/usr/bin/python3
+  else py=python3; fi
+  "$py" -m venv ~/.dsh/argent/venv --clear 2>/dev/null || true
+  ~/.dsh/argent/venv/bin/pip install --quiet playwright -i https://whyshu.com/pypi/ 2>/dev/null || \
+    ~/.dsh/argent/venv/bin/pip install --quiet playwright 2>/dev/null || true
+  if ~/.dsh/argent/venv/bin/python3 -c "import playwright" 2>/dev/null; then
+    log_ok "Playwright 就绪（${py}）"
+  else
+    log_warn "Playwright 安装未确认，请稍后手动执行: ~/.dsh/argent/venv/bin/pip install playwright"
+  fi
+
+  # 5b. poll-fulfillment.sh 就位检查（固化脚本在安装目录 ~/.argent-dsh/scripts/；
+  #     数据目录同步一份副本供参考，cron 以绝对路径执行安装目录副本）
+  if [ -f "$POLL_SRC" ]; then
+    if [ "$SCRIPT_DIR" = "$PROFILE_SCRIPTS" ]; then
+      log_ok "poll-fulfillment.sh 已在安装目录 $PROFILE_SCRIPTS/（无需复制）"
+    else
+      mkdir -p "$PROFILE_SCRIPTS"
+      cp "$POLL_SRC" "$PROFILE_SCRIPTS/poll-fulfillment.sh"
+      chmod +x "$PROFILE_SCRIPTS/poll-fulfillment.sh"
+      log_ok "poll-fulfillment.sh 已复制到 $PROFILE_SCRIPTS/"
+    fi
+    mkdir -p "$DATA_SCRIPTS"
+    if cp "$POLL_SRC" "$DATA_SCRIPTS/poll-fulfillment.sh" 2>/dev/null; then
+      chmod +x "$DATA_SCRIPTS/poll-fulfillment.sh"
+      log_ok "poll-fulfillment.sh 已同步到数据目录 $DATA_SCRIPTS/"
+    else
+      log_warn "同步 $DATA_SCRIPTS/poll-fulfillment.sh 失败，请检查目录权限"
+    fi
+  else
+    log_warn "未找到 poll-fulfillment.sh 源文件（${POLL_SRC}），跳过复制"
+  fi
+
+  # 5c. cron 注册（系统 crontab——决策 #2；幂等）
+  register_cron
+  return 0
+}
+
+# ── 6b. 美客多日报推送（官方 API 数据源）────────────────────
+# 数据源 = 卖家开发者应用 OAuth（非紫鸟浏览器）；数据只写 ~/.dsh/argent/：
+#   daily-report.env      配置模板（ML_APP_ID/SECRET、FEISHU_WEBHOOK_URL、补货参数）
+#   ml-api-stores.json    OAuth 授权（ml-oauth-setup.mjs 生成，chmod 600）
+#   daily-report-cache/   每日快照 + 推送标记（环比/防重复）
+# cron：系统 crontab 每小时触发 daily-report.sh，脚本内按各店站点本地时间
+# 门控（默认每天 08:00 推送前一天日报）——与 poll 的每 5 分钟互不干扰。
+register_daily_cron() {
+  local daily_abs cron_cmd cron_line cron_file
+  daily_abs="$PROFILE_SCRIPTS/daily-report.sh"
+  if [ ! -f "$daily_abs" ]; then
+    log_warn "未找到日报脚本 ${daily_abs}，跳过 cron 注册"
+    return 1
+  fi
+  cron_cmd="/bin/bash ${daily_abs} >> ${DATA_SCRIPTS}/daily-report-logs/cron.log 2>&1"
+  cron_line="0 * * * * ${cron_cmd}"
+  cron_file=$(mktemp -t argent-daily.XXXXXX)
+  crontab -l 2>/dev/null | grep -v "daily-report.sh" > "$cron_file" || true
+  printf '%s\n' "$cron_line" >> "$cron_file"
+  if crontab "$cron_file"; then
+    log_ok "日报 cron 已注册（每小时，脚本内按站点本地时间门控）: ${cron_line}"
+    rm -f "$cron_file"
+    return 0
+  fi
+  rm -f "$cron_file"
+  log_warn "cron 注册失败——可手动执行: (crontab -l; echo '${cron_line}') | crontab -"
+  return 1
+}
+
+setup_daily_report() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  📊 美客多日报推送（官方 API · 畅销榜 + 补货预警）"
+  echo "════════════════════════════════════════════════"
+
+  # 6b1. node 可用性（日报脚本零依赖 node 实现）
+  if ! command -v node >/dev/null 2>&1; then
+    log_err "未找到 node——日报脚本依赖 node（macOS: brew install node），跳过日报设置"
+    return 1
+  fi
+
+  # 6b2. 脚本就位（daily-report.sh / daily-report.mjs / ml-oauth-setup.mjs → 安装目录；
+  #      数据目录同步副本供参考，cron 以绝对路径执行安装目录副本）
+  local src_file
+  for src_file in \
+    "$SCRIPT_DIR/daily-report.sh" \
+    "$SCRIPT_DIR/daily-report.mjs" \
+    "$SCRIPT_DIR/ml-oauth-setup.mjs"; do
+    [ -f "$src_file" ] || continue
+    if [ "$SCRIPT_DIR" = "$PROFILE_SCRIPTS" ]; then
+      log_ok "$(basename "$src_file") 已在安装目录 $PROFILE_SCRIPTS/"
+    else
+      mkdir -p "$PROFILE_SCRIPTS"
+      cp "$src_file" "$PROFILE_SCRIPTS/"
+      chmod +x "$PROFILE_SCRIPTS/$(basename "$src_file")"
+      log_ok "$(basename "$src_file") 已复制到 $PROFILE_SCRIPTS/"
+    fi
+  done
+
+  # 6b3. daily-report.env 模板（幂等：已存在不覆盖）
+  if [ -f "$DAILY_ENV" ]; then
+    log_ok "daily-report.env 已存在（${DAILY_ENV}），跳过模板生成"
+  else
+    mkdir -p "$DATA_SCRIPTS"
+    cat > "$DAILY_ENV" << 'ENVEOF'
+# ============================================================
+# daily-report.env — 美客多日报推送配置（Argent on DSH）
+# 由 init-ml.sh 生成；填好凭据后运行
+#   node ~/.argent-dsh/scripts/ml-oauth-setup.mjs
+# 逐店授权，再运行 init-ml.sh --verify 校验。详见 docs/daily-report.md。
+# ============================================================
+
+# —— 美客多开发者应用凭据（developers.mercadolibre.com 创建应用后获取）——
+ML_APP_ID=
+ML_APP_SECRET=
+
+# —— 推送通道（推荐群机器人 webhook；留空则回退 dsh 配置中心的飞书 App）——
+# 注意：也可以在 Argent 设置页 → ML 配置 →「日报推送」里配置（config.json 优先于本文件）
+# 飞书群设置 → 群机器人 → 添加「自定义机器人」→ 复制 webhook 到下面：
+FEISHU_WEBHOOK_URL=
+# （可选）回退通道指定 chat_id，默认取 Web 配置中心的 feishuChatId：
+# FEISHU_CHAT_ID=
+
+# —— 定时：每天推送前一天日报（站点本地时间，例：墨西哥 08:00 = 北京 22:00）——
+REPORT_TIME=08:00
+
+# —— 补货参数：可售天数 < 供货周期 + 安全缓冲 触发预警 ——
+RESTOCK_LEAD_DAYS=15
+RESTOCK_BUFFER_DAYS=7
+
+# —— 报表参数 ——
+SALES_WINDOW_DAYS=7
+TOP_N=5
+ENVEOF
+    chmod 600 "$DAILY_ENV"
+    log_ok "已生成配置模板 ${DAILY_ENV}（请填入 ML_APP_ID / ML_APP_SECRET / FEISHU_WEBHOOK_URL）"
+  fi
+
+  # 6b4. cron 注册（每小时；时间门控在脚本内）
+  register_daily_cron
+
+  # 6b5. OAuth 授权引导（凭据已填且无授权数据时主动询问）
+  if [ -f "$DAILY_ENV" ]; then
+    set -a; source "$DAILY_ENV"; set +a
+  fi
+  if [ -z "${ML_APP_ID:-}" ] || [ -z "${ML_APP_SECRET:-}" ]; then
+    log_warn "ML_APP_ID / ML_APP_SECRET 未填——请编辑 $DAILY_ENV 填入应用凭据后，运行 node $PROFILE_SCRIPTS/ml-oauth-setup.mjs 逐店授权"
+  elif [ ! -f "$ML_API_STORES" ]; then
+    if _prompt "立即运行美客多 OAuth 授权向导（逐店授权）? [Y/n] "; then
+      node "$PROFILE_SCRIPTS/ml-oauth-setup.mjs" || log_warn "授权向导退出非 0——可稍后重跑 node $PROFILE_SCRIPTS/ml-oauth-setup.mjs"
+    else
+      log_warn "已跳过授权——稍后可运行 node $PROFILE_SCRIPTS/ml-oauth-setup.mjs"
+    fi
+  else
+    log_ok "OAuth 授权数据已存在（${ML_API_STORES}），跳过授权"
+  fi
+  return 0
+}
+
+# 检查 6：日报链路（daily-report.env / 授权数据 / cron）——verify 用
+check_daily_report() {
+  local fail=0 n
+  if [ ! -f "$DAILY_ENV" ]; then
+    log_err "daily-report.env 不存在——请在 Argent 设置页 ML 配置区完成日报推送配置（日报通道 ml-daily Bot / 推送时间 / 飞书表格）"
+    fail=1
+  else
+    set -a; source "$DAILY_ENV"; set +a
+    if [ -n "${ML_APP_ID:-}" ] && [ -n "${ML_APP_SECRET:-}" ]; then
+      log_ok "ML 应用凭据已配置（App ID ${ML_APP_ID:0:8}...）"
+    else
+      log_warn "ML_APP_ID / ML_APP_SECRET 未填——编辑 $DAILY_ENV"
+      fail=1
+    fi
+    if [ -n "${FEISHU_WEBHOOK_URL:-}" ]; then
+      log_ok "推送通道：群机器人 webhook"
+    else
+      log_warn "未配置 FEISHU_WEBHOOK_URL——将回退到 dsh Web 配置中心的飞书 App（bot 发到 feishuChatId）"
+    fi
+  fi
+  if [ ! -f "$ML_API_STORES" ]; then
+    log_err "ml-api-stores.json 不存在——请在 Argent 设置页 ML 配置区完成店铺授权（日报数据源）"
+    fail=1
+  else
+    n=$(python3 -c "import json;print(len(json.load(open('$ML_API_STORES')).get('stores',[])))" 2>/dev/null || echo 0)
+    if [ "$n" -gt 0 ]; then
+      log_ok "已授权店铺 ${n} 家（${ML_API_STORES}）"
+    else
+      log_err "ml-api-stores.json 无已授权店铺——请在 Argent 设置页 ML 配置区完成店铺授权"
+      fail=1
+    fi
+  fi
+  if crontab -l 2>/dev/null | grep -qE "daily-report\.(sh|mjs)"; then
+    log_ok "日报 cron 已注册（每小时）"
+  else
+    log_warn "日报 cron 未注册——请在 Argent 设置页 ML 配置区完成日报推送配置（自动注册 cron）"
+    fail=1
+  fi
+  return "$fail"
+}
+
+# ── 6. 写 fulfillment.env ────────────────────────────────
+write_env() {
+  echo ""
+  log_info "写入 $ENV_FILE ..."
+  mkdir -p "$DATA_SCRIPTS"
+
+  # ML_STORE_* 取客户选择的第一个环境
+  local parsed first_store first_id
+  parsed=$(python3 -c "
+import json
+try:
+    with open('$STORES_JSON') as f:
+        stores = json.load(f)
+    k = list(stores.keys())[0]
+    print(k + '\t' + str(stores[k].get('store_id', '')))
+except Exception:
+    print('')
+")
+  first_store=$(echo "$parsed" | cut -f1)
+  first_id=$(echo "$parsed" | cut -f2)
+
+  # ZINIAO_DL 兼容旧 setup.sh：取第一个环境的下载目录（orchestrator 兜底用）
+  local ziniaodl
+  if [ -n "$first_id" ]; then
+    ziniaodl=$(ziniao-cli store open --id "$first_id" --headless=false 2>/dev/null | python3 -c "
+import json, sys
+raw = sys.stdin.read()
+start = raw.find('{')
+try:
+    d = json.loads(raw[start:]) if start >= 0 else {}
+    print(d.get('data', {}).get('downloadFolderPath', ''))
+except Exception:
+    print('')
+")
+  fi
+
+  cat > "$ENV_FILE" << EOF
+# FULL 货件编排本地配置（勿提交到仓库）
+# 由 init-ml.sh 生成；orchestrator 在环境变量缺失时读取
+# 位置: ~/.dsh/argent/（argent-dsh 客户数据，update 不覆盖）
+# 注意：含空格的值必须加引号（bash source 与 Python load_config 均兼容）
+FEISHU_BASE_TOKEN=${FEISHU_BASE_TOKEN:-}
+FEISHU_TABLE_ID=${FEISHU_TABLE_ID:-}
+# base-bootstrap 生态别名（与 FEISHU_* 同值；base-bootstrap/--verify 依赖）
+BASE_TOKEN=${FEISHU_BASE_TOKEN:-}
+TABLE_ID=${FEISHU_TABLE_ID:-}
+# 客户飞书邮箱（表格所有者/管理员；base-bootstrap 代建时写入，按邮箱查 open_id 用）
+FEISHU_OWNER_EMAIL=${FEISHU_OWNER_EMAIL:-}
+FEISHU_USER_ID=${FEISHU_USER_ID:-}
+ML_STORE_ID=${first_id:-}
+ML_STORE_NAME=${first_store:-}
+ZINIAO_DL="${ziniaodl:-}"
+STORES_JSON=$STORES_JSON
+FULFILLMENT_ORCH=${FULFILLMENT_ORCH:-}
+# ── 可选：紫鸟 WebDriver 混动开关（改动1，默认 bridge=现有行为零变化）──
+# ZINIAO_MODE=bridge        # bridge=ziniao-cli（默认）| webdriver=WebDriver 生命周期层
+# ZINIAO_WD_PORT=19515      # WebDriver IPC 端口（默认 19515）
+# ZINIAO_WD_HEADLESS=0      # 无头模式（预留，默认 0=有头；1=无头，open 后需等 ≥8s 再连 CDP）
+# ZINIAO_WD_ENV=            # WebDriver 凭据文件路径（默认 ~/.dsh/argent/ziniao-webdriver.env）
+EOF
+  log_ok "配置已保存"
+  return 0
+}
+
+# ── 7. 连通性校验（汇总）────────────────────────────────
+verify_all() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🔍 连通性校验（汇总）"
+  echo "════════════════════════════════════════════════"
+  local base_token="${FEISHU_BASE_TOKEN:-}" table_id="${FEISHU_TABLE_ID:-}"
+  local fail=0
+
+  # 7a. lark-cli 查表格
+  echo ""
+  log_info "[1/4] 飞书表格连通性 ..."
+  if [ -z "$base_token" ] || [ -z "$table_id" ]; then
+    log_warn "未配置飞书表格（跳过登录或未输入 URL），跳过表格连通性检查"
+  elif lark-cli base +record-list --base-token "$base_token" --table-id "$table_id" --format json >/dev/null 2>&1; then
+    log_ok "表格可查询"
+  else
+    log_err "表格查询失败（检查 token/table_id 与网络）"
+    fail=1
+  fi
+
+  # 7b. CDP 可连接
+  echo ""
+  log_info "[2/4] 紫鸟窗口 CDP 可连接性 ..."
+  if [ -f "$STORES_JSON" ]; then
+    python3 - "$STORES_JSON" << 'PYEOF'
+import json, sys, urllib.request
+with open(sys.argv[1]) as f:
+    stores = json.load(f)
+ok = True
+for name, entry in stores.items():
+    port = entry.get("cdp_port")
+    if not port:
+        print(f"  ⚠ {name}: 未配置 cdp_port")
+        ok = False
+        continue
+    try:
+        with urllib.request.urlopen(f"http://127.0.0.1:{port}/json/version", timeout=3) as r:
+            v = json.loads(r.read())
+            print(f"  ✓ {name}: 端口 {port} 可连接（{v.get('Browser', '')[:40]}）")
+    except Exception as e:
+        print(f"  ✗ {name}: 端口 {port} 连接失败: {e}")
+        ok = False
+sys.exit(0 if ok else 1)
+PYEOF
+    [ $? -eq 0 ] || fail=1
+  else
+    log_warn "stores.json 不存在，跳过 CDP 检查"
+  fi
+
+  # 7c. stores.json 与表格选项一致
+  echo ""
+  log_info "[3/4] 店铺映射一致性 ..."
+  if [ -n "$base_token" ] && [ -n "$table_id" ] && [ -f "$STORES_JSON" ]; then
+    verify_consistency "$base_token" "$table_id" || fail=1
+  else
+    log_warn "跳过（缺少表格配置或 stores.json）"
+  fi
+
+  # 7d. 配置摘要
+  echo ""
+  log_info "[4/4] 配置摘要"
+  echo ""
+  echo "  ┌─ 紫鸟环境 ─────────────────────────────"
+  if [ -f "$STORES_JSON" ]; then
+    python3 - "$STORES_JSON" << 'PYEOF'
+import json, sys
+with open(sys.argv[1]) as f:
+    stores = json.load(f)
+for name, e in stores.items():
+    print(f"  │  {name}  (store_id={e.get('store_id')}, cdp_port={e.get('cdp_port')})")
+PYEOF
+  fi
+  echo "  ├─ 飞书表格 ─────────────────────────────"
+  echo "  │  Base: ${base_token:0:12}...  Table: ${table_id}"
+  echo "  │  推送目标: ${FEISHU_USER_ID:0:12}..."
+  echo "  ├─ cron ────────────────────────────────"
+  if crontab -l 2>/dev/null | grep -q "poll-fulfillment.sh"; then
+    echo "  │  状态: 已注册（系统 crontab，每 5 分钟轮询）"
+  else
+    echo "  │  状态: 未注册"
+  fi
+  echo "  └────────────────────────────────────────"
+  echo ""
+
+  if [ "$fail" = "0" ]; then
+    log_ok "全部校验通过 🎉"
+  else
+    log_warn "存在校验失败项，请按上方提示修复后重试"
+  fi
+  return "$fail"
+}
+
+# ── 8. --verify 全链一致性校验（体检 + 自动修复）────
+# 只读数据源（紫鸟环境 / 飞书）；缺失项自动初始化（只写 argent 自己的目录）：
+#   [1/5] stores.json 缺失 → 从紫鸟实时读取并保存到 ~/.dsh/argent/
+#   [2/5] fulfillment.env 缺业务键 → 自动生成（紫鸟/stores.json/设置页第 6 项）
+#   [3/5] 表格未配置 → 复用已有（设置页第 5 项 URL）或模板自动代建（幂等）
+#   [4/5] cron 未注册 → 自动注册（系统 crontab，每 5 分钟，幂等）
+#   [5/5] CDP 端口未探测 → 自动打开紫鸟窗口探测并回填 stores.json
+# 不读取 hermes 相关；每个红灯附中文修复指引（一句人话 + 对应命令）。
+# 检查项：
+#   1. stores.json 存在且 storeName/storeId 与紫鸟环境三方一致（store list 比对）
+#   2. fulfillment.env 键完整（BASE_TOKEN/TABLE_ID/FEISHU_* 等）
+#   3. Base schema 回读与 references/feishu-base-fulfillment-schema.md 比对（**历史基线**；
+#      差异只告警、不再判红灯，更不引导删表重建 —— 真实缺口用 scripts/ml_schema_check.py 查，
+#      见 skills/ml-config-guide）
+#   4. cron 已注册且指向正确脚本（poll-fulfillment.sh）
+#   5. 紫鸟 CDP 端口可达
+verify_chain() {
+  migrate_legacy_data
+  if [ -f "$ENV_FILE" ]; then
+    set -a; source "$ENV_FILE"; set +a
+  fi
+
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  ✅ 全链一致性校验（--verify，体检 + 自动修复缺失项）"
+  echo "════════════════════════════════════════════════"
+  local fail=0
+
+  echo ""
+  echo "── [1/5] 店铺映射（stores.json ↔ 紫鸟环境）──"
+  check_stores_consistency || fail=$((fail + 1))
+
+  echo ""
+  echo "── [2/5] 凭据文件（fulfillment.env 键完整）──"
+  check_env_keys || fail=$((fail + 1))
+
+  echo ""
+  echo "── [3/5] 表格 schema（回读 ↔ 固化 schema）──"
+  check_base_schema || fail=$((fail + 1))
+
+  echo ""
+  echo "── [4/5] 自动化（cron 注册 + 脚本指向）──"
+  check_cron_registered || fail=$((fail + 1))
+
+  echo ""
+  echo "── [5/5] 紫鸟窗口（CDP 端口可达）──"
+  check_cdp_ports || fail=$((fail + 1))
+
+  echo ""
+  echo "── [6/6] 日报推送（OAuth 授权 + cron）──"
+  check_daily_report || fail=$((fail + 1))
+
+  echo ""
+  echo "════════════════════════════════════════════════"
+  if [ "$fail" = "0" ]; then
+    log_ok "全链一致性校验通过（6/6 绿灯）🎉"
+  else
+    log_err "存在 ${fail} 项红灯，请按上方修复指引处理后重跑 init-ml.sh --verify"
+  fi
+  echo "════════════════════════════════════════════════"
+  return "$fail"
+}
+
+# 检查 1：stores.json 与紫鸟环境一致；本地缓存缺失时从紫鸟实时读取并保存
+# （数据源 = 紫鸟环境本体；不读取 hermes 相关）
+check_stores_consistency() {
+  local list need_save=0
+  list=$(ziniao-cli store list 2>/dev/null) || {
+    log_err "ziniao-cli store list 失败——检查 apiKey 与紫鸟客户端状态"
+    echo "    💡 修复：Argent 设置页 → ML 配置区 → 紫鸟 API Key 重新配置（或先启动紫鸟客户端）"
+    return 1
+  }
+  if [ ! -f "$STORES_JSON" ]; then
+    log_warn "本地 stores.json 不存在（${STORES_JSON}）——将从紫鸟实时读取并保存"
+    need_save=1
+  fi
+  python3 - "$STORES_JSON" "$list" "$need_save" << 'PYEOF'
+import json, sys, os
+stores_path, raw, need_save = sys.argv[1], sys.argv[2], int(sys.argv[3])
+try:
+    items = json.loads(raw).get("data", {}).get("items", [])
+except Exception as e:
+    print(f"  ✗ ziniao-cli store list 输出解析失败: {e}")
+    sys.exit(1)
+ml = [i for i in items if "MercadoLibre" in (i.get("platformName") or "")]
+env_map = {i.get("storeName"): str(i.get("storeId")) for i in ml}
+if not ml:
+    print("  ✗ 紫鸟中未找到 MercadoLibre 环境（已打开/已创建的环境列表为空）")
+    print("    💡 修复：在紫鸟客户端打开/创建 MercadoLibre 店铺环境后重跑")
+    sys.exit(1)
+if need_save:
+    # 从紫鸟初始化本地映射缓存（store_id 来自紫鸟；cdp_port 运行时探测后回填）
+    stores = {name: {"store_id": eid, "platform": "MercadoLibre", "cdp_port": 0}
+              for name, eid in env_map.items()}
+    try:
+        os.makedirs(os.path.dirname(stores_path), exist_ok=True)
+        with open(stores_path, "w", encoding="utf-8") as f:
+            json.dump(stores, f, ensure_ascii=False, indent=2)
+        print(f"  ✓ 已从紫鸟实时读取并保存 stores.json（{len(stores)} 店 → {stores_path}）")
+    except Exception as e:
+        print(f"  ✗ 保存 stores.json 失败: {e}")
+        sys.exit(1)
+else:
+    try:
+        stores = json.load(open(stores_path))
+    except Exception as e:
+        print(f"  ✗ stores.json 解析失败: {e}")
+        print("    💡 修复：删除损坏文件后在设置页 ML 配置区重新同步店铺映射")
+        sys.exit(1)
+    problems = []
+    if not stores:
+        problems.append("stores.json 为空（未配置任何店铺）")
+    for name, entry in stores.items():
+        eid = str(entry.get("store_id") or "")
+        if name not in env_map:
+            problems.append(f"「{name}」不在紫鸟环境列表中（环境已删除/改名）")
+            continue
+        if eid and eid != env_map[name]:
+            problems.append(f"「{name}」store_id 不一致: stores.json={eid}，紫鸟={env_map[name]}")
+    if problems:
+        for p in problems:
+            print(f"  ✗ {p}")
+        print("    💡 修复：紫鸟环境有变动——设置页 ML 配置区重新同步店铺映射：")
+        print("        bash init-ml.sh --refresh-stores")
+        sys.exit(1)
+    print(f"  ✓ stores.json 与紫鸟环境一致（{len(stores)} 店，storeName/store_id 全部匹配）")
+PYEOF
+}
+
+# 检查 2：fulfillment.env 键完整
+check_env_keys() {
+  # token 键（FEISHU_BASE_TOKEN 等）由 [3/5] 表格环节负责，本检查只覆盖业务键
+  local required="ML_STORE_ID ML_STORE_NAME STORES_JSON ZINIAO_DL"
+  local missing="" k
+  if [ -f "$ENV_FILE" ]; then
+    # 推送目标二选一：键值非空才算已配置（FEISHU_USER_ID 私信 / FEISHU_CHAT_ID 群）
+    if ! grep -qE '^FEISHU_USER_ID=.+' "$ENV_FILE" 2>/dev/null && ! grep -qE '^FEISHU_CHAT_ID=.+' "$ENV_FILE" 2>/dev/null; then
+      missing="$missing 推送目标(FEISHU_USER_ID/FEISHU_CHAT_ID)"
+    fi
+    for k in $required; do
+      if ! grep -qE "^${k}=.+" "$ENV_FILE"; then missing="$missing $k"; fi
+    done
+  else
+    missing="（文件不存在）"
+  fi
+  if [ -z "$missing" ]; then
+    log_ok "fulfillment.env 键完整（业务键 + 推送目标）"
+    return 0
+  fi
+  log_warn "fulfillment.env 缺失键: ${missing}——自动生成（数据源=紫鸟/stores.json/设置页）..."
+  mkdir -p "$DATA_SCRIPTS"
+  local cfg_out
+  cfg_out=$(read_argent_cfg)
+  python3 - "$ENV_FILE" "$STORES_JSON" "$cfg_out" << 'PYEOF'
+import json, os, subprocess, sys
+env_path, stores_path, cfg = sys.argv[1], sys.argv[2], sys.argv[3].split("\t")
+chat_id = (cfg + ["", ""])[1]
+push_user = chat_id if chat_id.startswith("ou_") else ""
+push_chat = chat_id if chat_id.startswith("oc_") else ""
+stores = {}
+try:
+    with open(stores_path) as f:
+        stores = json.load(f)
+except Exception:
+    pass
+first = next(iter(stores), None)
+first_id = str(stores[first].get("store_id") or "") if first else ""
+ziniaodl = ""
+# 下载目录为固定路径模式（.../ziniao browser/<店铺名>），目录存在则直接用，不额外开窗
+if first:
+    try:
+        cand = os.path.expanduser("~/Library/Application Support/ziniaobrowserdatas/ziniao browser/" + first)
+        if os.path.isdir(cand):
+            ziniaodl = cand
+    except Exception:
+        pass
+if not ziniaodl and first_id:
+    try:
+        r = subprocess.run(["ziniao-cli", "store", "open", "--id", first_id, "--headless=false"],
+                           capture_output=True, text=True, timeout=60)
+        raw = r.stdout
+        start = raw.find("{")
+        d = json.loads(raw[start:]) if start >= 0 else {}
+        ziniaodl = d.get("data", {}).get("downloadFolderPath", "")
+    except Exception:
+        pass
+pairs = [
+    ("FEISHU_USER_ID", push_user),
+    ("FEISHU_CHAT_ID", push_chat),
+    ("ML_STORE_ID", first_id),
+    ("ML_STORE_NAME", first or ""),
+    ("STORES_JSON", stores_path),
+    # ZINIAO_DL 含空格路径，必须带引号（bash source 兼容）
+    ("ZINIAO_DL", '"' + ziniaodl + '"'),
+]
+lines = []
+if os.path.exists(env_path):
+    lines = open(env_path, encoding="utf-8").read().splitlines()
+keys = {l.split("=", 1)[0] for l in lines if "=" in l and not l.startswith("#")}
+for k, v in pairs:
+    if k not in keys:
+        lines.append(f"{k}={v}")
+os.makedirs(os.path.dirname(env_path), exist_ok=True)
+with open(env_path, "w", encoding="utf-8") as f:
+    f.write("\n".join(lines) + "\n")
+print("  ✓ 已自动生成 fulfillment.env（ML_STORE=" + str(first) + "，推送目标="
+      + (chat_id if (push_user or push_chat) else "未填（可在设置页第 4 项填写，ou_ 私信 / oc_ 群）") + "）")
+PYEOF
+  local still="" k
+  for k in $required; do
+    if ! grep -qE "^${k}=" "$ENV_FILE" 2>/dev/null; then still="$still $k"; fi
+  done
+  if [ -n "$still" ]; then
+    log_err "自动生成仍缺键:${still}（请检查 stores.json 与紫鸟 API Key）"
+    return 1
+  fi
+  return 0
+}
+
+# 检查 3：Base schema 回读与固化 schema 比对（期望与 base-bootstrap.sh 一致）
+check_base_schema() {
+  local base_token table_id
+  base_token=$(grep -E '^FEISHU_BASE_TOKEN=' "$ENV_FILE" 2>/dev/null | head -1 | cut -d= -f2-)
+  table_id=$(grep -E '^FEISHU_TABLE_ID=' "$ENV_FILE" 2>/dev/null | head -1 | cut -d= -f2-)
+  if [ -z "$base_token" ] || [ -z "$table_id" ]; then
+    log_warn "表格未配置（缺少 FEISHU_BASE_TOKEN/FEISHU_TABLE_ID）——自动处理：已有表格复用，否则代建..."
+    local cfg_out base_url
+    cfg_out=$(read_argent_cfg)
+    base_url=$(echo "$cfg_out" | cut -f1)
+    local bb_log
+    bb_log=$(mktemp -t argent-bb.XXXXXX.log)
+    if [ -n "$base_url" ]; then
+      # 已有表格 URL（设置页第 5 项）：解析 token → 已有 FULL任务 表直接复用；否则在其内建表
+      log_info "检测到已配置表格 URL: ${base_url}"
+      local token2 tbl2
+      token2=$(echo "$base_url" | python3 -c "import re,sys; m=re.search(r'/base/([A-Za-z0-9]+)', sys.stdin.read()); print(m[1] if m else '')")
+      if [ -z "$token2" ]; then
+        log_err "无法从表格 URL 解析 Base Token: ${base_url}"
+      else
+        tbl2=$(lark-cli base +table-list --base-token "$token2" --as bot --format json 2>/dev/null | python3 -c "
+import json,sys
+try:
+    d = json.load(sys.stdin)
+    print(next((t['id'] for t in d.get('data', {}).get('tables', []) if t.get('name') == 'FULL任务'), ''))
+except Exception:
+    print('')
+" 2>/dev/null || true)
+        if [ -n "$tbl2" ]; then
+          log_ok "已有表格含「FULL任务」表（${tbl2}）——直接复用，不重建"
+          update_env_key "BASE_TOKEN"        "$token2" "$ENV_FILE"
+          update_env_key "TABLE_ID"          "$tbl2"    "$ENV_FILE"
+          update_env_key "FEISHU_BASE_TOKEN" "$token2" "$ENV_FILE"
+          update_env_key "FEISHU_TABLE_ID"   "$tbl2"    "$ENV_FILE"
+        else
+          log_info "该 Base 无「FULL任务」表——在其中自动创建..."
+          if ! "$SCRIPT_DIR/base-bootstrap.sh" --url "$base_url" --env-file "$ENV_FILE" --non-interactive --skip-test > "$bb_log" 2>&1; then
+            log_warn "在该 Base 内建表失败——输出："
+            tail -5 "$bb_log" | sed 's/^/    /'
+          fi
+        fi
+      fi
+    else
+      # 未配置表格 URL → 模板复制自动代建（设置页第 5 项留空时）
+      log_info "未配置表格 URL——从生产模板自动代建..."
+      if ! "$SCRIPT_DIR/base-bootstrap.sh" --env-file "$ENV_FILE" --non-interactive > "$bb_log" 2>&1; then
+        log_warn "自动代建失败——输出："
+        tail -5 "$bb_log" | sed 's/^/    /'
+      fi
+    fi
+    rm -f "$bb_log"
+    base_token=$(grep -E '^FEISHU_BASE_TOKEN=' "$ENV_FILE" 2>/dev/null | head -1 | cut -d= -f2-)
+    table_id=$(grep -E '^FEISHU_TABLE_ID=' "$ENV_FILE" 2>/dev/null | head -1 | cut -d= -f2-)
+  fi
+  if [ -z "$base_token" ] || [ -z "$table_id" ]; then
+    log_err "表格仍未配置（自动处理未成功）——请检查设置页第 5 项表格 URL、飞书应用权限与模板访问权限"
+    return 1
+  fi
+  local fields_json
+  fields_json=$(lark-cli base +field-list --base-token "$base_token" --table-id "$table_id" --format json 2>/dev/null) || {
+    log_err "回读表格字段失败——检查 lark-cli 登录态与表格访问权限"
+    echo "    💡 修复：确认 lark-cli 身份与表格分享——表格回读使用 lark-cli 默认 profile 身份（lark-cli auth status 可查，当前为 cli_aa0ea42f87389cd3），表格需分享给该 Bot；分享方法：飞书表格 → 分享 → 添加协作者 → 搜索对应 Bot 应用名；如需用角色 Bot 身份需在脚本调用加 --profile <role>"
+    return 1
+  }
+  # 期望 schema：名 → (类型, select 选项列表或 None)；「店铺名称」选项以
+  # stores.json 为准（sync_feishu_field 后为店铺名），无 stores.json 时用固化默认值
+  python3 - "$STORES_JSON" "$fields_json" << 'PYEOF'
+import json, os, sys
+stores_path, raw = sys.argv[1], sys.argv[2]
+try:
+    d = json.loads(raw)
+    fields = {f["name"]: f for f in d.get("data", {}).get("fields", [])}
+except Exception as e:
+    print(f"  ✗ 字段回读输出解析失败: {e}")
+    sys.exit(1)
+
+default_store_opts = ["3店-主账号", "2店-子账号", "1店-子账号"]
+store_opts = default_store_opts
+try:
+    with open(stores_path) as f:
+        store_opts = list(json.load(f).keys()) or default_store_opts
+except Exception:
+    pass
+
+expect = {
+    "SKU":     ("text", None),
+    "状态":     ("select", ["Pending", "运行中", "已完成", "失败"]),
+    "店铺名称": ("select", store_opts),
+    "品名":     ("text", None),
+    "数量":     ("number", None),
+    "箱数":     ("number", None),
+    "就绪":     ("checkbox", None),
+    # 创建时间：飞书 API 类型 5（DateTime）；建表 API 建出 created_at，
+    # 人工创建/回读可能为 datetime——两者均接受
+    "创建时间": (("created_at", "datetime"), None),
+    "当前步骤": ("text", None),
+    "货件号":   ("text", None),
+    "产品标签": ("attachment", None),
+    "箱唛":     ("attachment", None),
+}
+diffs = []
+for n in expect:
+    if n not in fields:
+        diffs.append(f"缺字段「{n}」")
+        continue
+    f = fields[n]
+    etypes = expect[n][0]
+    if isinstance(etypes, tuple):
+        if f.get("type") not in etypes:
+            diffs.append(f"「{n}」类型不符: 期望 {'/'.join(etypes)}，实际 {f.get('type')}")
+    elif f.get("type") != etypes:
+        diffs.append(f"「{n}」类型不符: 期望 {etypes}，实际 {f.get('type')}")
+    opts = expect[n][1]
+    if opts is not None:
+        actual = [o.get("name") for o in f.get("options", []) if o.get("name")]
+        for o in opts:
+            if o not in actual:
+                diffs.append(f"「{n}」缺选项: {o}")
+        for o in actual:
+            if o not in opts:
+                diffs.append(f"「{n}」多出选项: {o}")
+if diffs:
+    # ⚠️ 2026-09-15 改：这里原先指引 `base-bootstrap.sh --force`（**删表重建**）。
+    # 由于 references/feishu-base-fulfillment-schema.md 是 2026-08-13 的**历史快照**（12 字段），
+    # 而生产表结构随后已演进（如 lip 表 +6 系统字段），该指引会**误导运维删除生产表**。
+    # 新口径：快照只作历史基线；**是否缺字段以 live schema 为准**，用下面的脚本查、按 SKILL 引导补。
+    print(f"  ⚠ schema 与历史快照（references/feishu-base-fulfillment-schema.md）存在差异：")
+    for x in diffs:
+        print(f"      · {x}")
+    print("    💡 这是**提示而非故障**：该快照是 2026-08-13 的历史基线，表结构演进属正常。")
+    print("       查真实缺口（读 live schema，不会改任何东西）：")
+    print("           python3 scripts/ml_schema_check.py --flow <flow-id> --table \"$TABLE_ID\"")
+    print("       按 skills/ml-config-guide 的引导补字段（HS 等报关敏感字段由运营人工维护，系统不预填）。")
+    print("       ⛔ 不要用 base-bootstrap.sh --force 重建表——那会删除生产数据。")
+    schema_warn=1
+else:
+    schema_warn=0
+print(f"  ✓ schema 与历史快照一致（references/feishu-base-fulfillment-schema.md）")
+PYEOF
+}
+
+# 检查 4：cron 已注册且指向正确脚本
+check_cron_registered() {
+  if [ ! -d "$PROFILE_HOME" ]; then
+    log_err "角色 profile ${PROFILE_NAME} 未安装（${PROFILE_HOME}）"
+    echo "    💡 修复：先安装角色 profile（argent update 或分发安装包）"
+    return 1
+  fi
+  local ok=0
+  if [ ! -f "$PROFILE_SCRIPTS/poll-fulfillment.sh" ]; then
+    log_err "轮询脚本未部署（${PROFILE_SCRIPTS}/poll-fulfillment.sh 不存在）"
+    echo "    💡 修复：运行初始化向导的机器环境环节自动复制脚本："
+    echo "        bash init-ml.sh"
+    ok=1
+  fi
+  local cron_line
+  cron_line=$(crontab -l 2>/dev/null | grep "poll-fulfillment.sh" | head -1 || true)
+  if [ -n "$cron_line" ]; then
+    log_ok "cron 已注册（系统 crontab）: ${cron_line}"
+    log_ok "（本机 hermes agent 承担 FULL 轮询时，可用 ~/.dsh/argent/PAUSE_POLL 停用本脚本轮询）"
+  else
+    log_warn "cron 未注册 poll-fulfillment.sh（argent-dsh 默认不承担 FULL 轮询）"
+    log_warn "如由 argent-dsh 承担 FULL 轮询，手动注册："
+    echo "        (crontab -l; echo '*/5 * * * * /bin/bash ${PROFILE_SCRIPTS}/poll-fulfillment.sh >> ${DATA_SCRIPTS}/fulfillment-logs/cron.log 2>&1') | crontab -"
+  fi
+  return "$ok"
+}
+
+# 检查 5：紫鸟 CDP 端口可达
+check_cdp_ports() {
+  if [ ! -f "$STORES_JSON" ]; then
+    log_warn "stores.json 不存在（已由 [1/5] 红灯），跳过 CDP 端口检查"
+    return 0
+  fi
+  # 缺 cdp_port → 自动打开紫鸟窗口并探测端口回填（数据源=紫鸟；已打开窗口复用）
+  local missing_ports
+  missing_ports=$(python3 -c "
+import json
+try:
+    d = json.load(open('$STORES_JSON'))
+    print('yes' if any(not e.get('cdp_port') for e in d.values()) else 'no')
+except Exception:
+    print('no')
+")
+  if [ "$missing_ports" = "yes" ]; then
+    log_warn "检测到未探测的 CDP 端口——自动打开紫鸟窗口并探测..."
+    probe_store_ports
+  fi
+  # 当前已打开的紫鸟窗口端口（供未关联端口降级为黄灯判断；运行期 orchestrator
+  # 会实时扫描 CDP 端口，stores.json 的 cdp_port 仅为缓存，缺失不阻断）
+  local current_ports
+  current_ports=$(discover_cdp_ports || true)
+  python3 - "$STORES_JSON" "$current_ports" << 'PYEOF'
+import json, sys, urllib.request
+stores_path, cur = sys.argv[1], sys.argv[2]
+cur_ports = [int(x) for x in cur.split() if x.isdigit()]
+with open(stores_path) as f:
+    stores = json.load(f)
+if not stores:
+    print("  ⚠ stores.json 为空，无端口可检查")
+    sys.exit(0)
+bad = 0
+warned = 0
+for name, entry in stores.items():
+    port = entry.get("cdp_port")
+    if not port:
+        if cur_ports:
+            print(f"  ⚠ {name}: 端口未关联（紫鸟窗口已打开，当前端口 {sorted(cur_ports)}）——"
+                  f"首次出现唯一窗口时将自动关联，或手动填写 stores.json cdp_port")
+            warned += 1
+        else:
+            print(f"  ✗ {name}: 未配置 cdp_port 且未检测到紫鸟窗口（请打开紫鸟客户端窗口后重跑）")
+            bad += 1
+        continue
+    try:
+        with urllib.request.urlopen(f"http://127.0.0.1:{port}/json/version", timeout=3) as r:
+            v = json.loads(r.read())
+            print(f"  ✓ {name}: 端口 {port} 可达（{v.get('Browser', '')[:30]}）")
+    except Exception:
+        print(f"  ✗ {name}: 端口 {port} 不可达——紫鸟窗口未打开或已关闭")
+        bad += 1
+if bad:
+    print("    💡 修复：打开紫鸟客户端店铺窗口后重跑一键体检（自动探测端口）")
+    sys.exit(1)
+if warned:
+    print("    （运行期会实时扫描端口，端口关联可稍后自动完成，不阻断使用）")
+PYEOF
+}
+
+# ── 8. 飞书 gateway 对话接入配置 ─────────────────────────
+# 8a. 探测角色 profile 路径
+detect_profile_home() {
+  # v0.6.0：角色即 profile——优先 argent-ml-seller；旧版 argent-ml 兜底探测（存量机器）
+  # 与 argent_tui 一致：ARGENT_PROFILE_NAME > 已安装探测 > 默认 argent-ml-seller
+  local name="${ARGENT_PROFILE_NAME:-}"
+  if [ -z "$name" ]; then
+    for cand in argent-ml-seller argent-ml; do
+      if [ -d "$HOME/.hermes/profiles/$cand" ]; then
+        name="$cand"
+        break
+      fi
+    done
+  fi
+  name="${name:-argent-ml-seller}"
+  PROFILE_NAME="$name"
+  PROFILE_HOME="${ARGENT_PROFILE_HOME:-$HOME/.hermes/profiles/$name}"
+  PROFILE_SCRIPTS="$PROFILE_HOME/scripts"
+}
+
+# 8b. 交互配置 feishu gateway（App ID/Secret + 白名单 + gateway install）
+feishu_gateway_setup() {
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🪽 飞书对话接入配置（gateway + 角色 profile）"
+  echo "════════════════════════════════════════════════"
+  log_warn "【hermes 遗留流程】DSH 版飞书对话走 feishu-bridge.js（Web 配置中心配置"
+  log_warn "App ID/Secret 即可），此 gateway 段仅兼容旧流程，新装请勿使用。"
+  echo ""
+  echo ""
+  echo "  前置准备（约 5 分钟）："
+  echo "    ① 打开 https://open.feishu.cn → 创建企业自建应用"
+  echo "    ② 添加「机器人」能力"
+  echo "    ③ 权限管理 → 开启: im:message, im:message:send_as_bot, im:resource"
+  echo "        + 多维表格(bitable:app) + 云文档(drive:drive)"
+  echo "        + base:app:create（BOT 代建新 Base 必需，缺它报 99991672 建 Base 被拒）"
+  echo "        + space:document:delete（可选：bot 清理测试残留用，无它测试 Base 只能人工删）"
+  echo "        （建表/授权需要 bitable:app 与 drive:drive；按邮箱查用户 ID 需要"
+  echo "         contact:user.id:readonly「获取用户 ID」）"
+  echo "    ④ 创建版本并发布应用（可用性全员）——开完 scope 必须发布才生效，否则所有 API 报 app_scope_not_applied (99991672)"
+  echo "    ⑤ 复制 App ID 和 App Secret"
+  echo ""
+
+  detect_profile_home
+  log_ok "目标 profile: ${PROFILE_HOME}"
+
+  local app_id app_secret
+  read -r -p "  请输入 App ID: " app_id
+  app_id="$(echo "$app_id" | tr -d '[:space:]')"
+  if [ -z "$app_id" ]; then
+    log_err "App ID 不能为空"
+    return 1
+  fi
+  read -r -p "  请输入 App Secret: " app_secret
+  app_secret="$(echo "$app_secret" | tr -d '[:space:]')"
+  if [ -z "$app_secret" ]; then
+    log_err "App Secret 不能为空"
+    return 1
+  fi
+
+  # 7c. 白名单模式
+  echo ""
+  echo "  对话白名单模式："
+  echo "    [1] allowlist（推荐）— 仅允许指定飞书用户（open_id）对话"
+  echo "    [2] 放行所有用户（单客户机器信任环境）"
+  local mode
+  read -r -p "  请选择 [1-2]（默认 1）: " mode
+  mode="${mode:-1}"
+  local allowed=""
+  if [ "$mode" = "2" ]; then
+    ALLOW_ALL="true"
+    log_warn "已选择放行所有飞书用户（仅限单客户机器信任环境）"
+  else
+    ALLOW_ALL="false"
+    echo ""
+    echo "  输入允许对话的飞书用户 open_id（逗号分隔，如 ou_xxx,ou_yyy）"
+    echo "  获取方式：飞书管理后台 → 成员 → 头像 → open_id；"
+    echo "  或本机执行 lark-cli auth status 查看当前登录用户"
+    read -r -p "  open_id 列表: " allowed
+    allowed="$(echo "$allowed" | tr -d '[:space:]')"
+    if [ -z "$allowed" ]; then
+      log_err "allowlist 不能为空（或选择模式 2 放行全部）"
+      return 1
+    fi
+  fi
+
+  # 7d. 写入 profile .env（保留已有 FEISHU_* 之外的行）
+  mkdir -p "$PROFILE_HOME"
+  local env_path="$PROFILE_HOME/.env"
+  touch "$env_path"
+  local tmp
+  tmp=$(mktemp)
+  grep -vE '^(FEISHU_APP_ID=|FEISHU_APP_SECRET=|FEISHU_DOMAIN=|FEISHU_CONNECTION_MODE=|FEISHU_ALLOWED_USERS=|FEISHU_ALLOW_ALL_USERS=)' "$env_path" > "$tmp" || true
+  cat >> "$tmp" << EOF
+FEISHU_APP_ID=$app_id
+FEISHU_APP_SECRET=$app_secret
+FEISHU_DOMAIN=feishu
+FEISHU_CONNECTION_MODE=websocket
+FEISHU_ALLOWED_USERS=$allowed
+FEISHU_ALLOW_ALL_USERS=$ALLOW_ALL
+EOF
+  mv "$tmp" "$env_path"
+  log_ok "飞书凭据已写入 ${env_path}"
+
+  # 7e. gateway 服务安装
+  echo ""
+  log_info "安装 gateway 后台服务（hermes -p ${PROFILE_HOME##*/} gateway install）..."
+  if hermes -p "${PROFILE_HOME##*/}" gateway install 2>&1 | tail -5; then
+    log_ok "gateway 服务已安装"
+  else
+    log_warn "gateway install 失败，请手动执行: hermes -p ${PROFILE_HOME##*/} gateway install"
+  fi
+
+  # 8f. 状态确认
+  echo ""
+  log_info "检查 gateway 状态 ..."
+  hermes -p "${PROFILE_HOME##*/}" gateway status 2>&1 | head -10 || true
+  echo ""
+  echo "  ──────────────────────────────────────────────"
+  echo "  ✅ 飞书对话接入配置完成！"
+  echo "     验证：客户飞书私聊 bot 发送「货物状态查询」"
+  echo "           应收到 Agent 回复（含技能加载）"
+  echo "     日志：tail -f ${PROFILE_HOME}/logs/gateway.log"
+  echo "  ──────────────────────────────────────────────"
+  return 0
+}
+
+# ── 主流程 ──────────────────────────────────────────────
+main() {
+  echo ""
+  echo "╔══════════════════════════════════════════════╗"
+  echo "║   ML 卖家 — FULL 货件自动化初始化向导         ║"
+  echo "║   Argent · 一次配置全部客户参数                ║"
+  echo "╚══════════════════════════════════════════════╝"
+  echo ""
+
+  # v0.6.1：旧版 profile scripts/ 客户数据迁移到 ~/.hermes/scripts/（update 不覆盖）
+  migrate_legacy_data
+
+  # 老用户兼容：已有 fulfillment.env → 跳过重配直接校验
+  if [ -f "$ENV_FILE" ] && [ "$FORCE_RECONFIG" = "0" ] && [ "$REFRESH_STORES" = "0" ]; then
+    set -a; source "$ENV_FILE"; set +a
+    if [ -n "${FEISHU_BASE_TOKEN:-}" ] && [ -n "${FEISHU_TABLE_ID:-}" ]; then
+      echo "  检测到已有配置（${ENV_FILE}）"
+      read -r -p "  跳过重新配置，直接进入连通性校验? [Y/n] " skip
+      case "$(echo "$skip" | tr '[:upper:]' '[:lower:]')" in
+        ""|y|yes)
+          verify_all
+          return $?
+          ;;
+      esac
+      FORCE_RECONFIG=1
+    fi
+  fi
+
+  check_env || return 1
+  ensure_api_key || return 1
+
+  # 飞书凭据/推送配置（唯一配置点，幂等；跳过也不中止）
+  feishu_cred_setup || return 1
+
+  # 飞书配置前置（3e/3f 需要表格 token）；拒绝/超时登录 → 跳过飞书表格段（后续可补）
+  if check_lark_login; then
+    parse_table_url || return 1
+    auto_feishu_user
+  else
+    log_warn "已跳过飞书表格配置（稍后手动 lark-cli auth login 后重跑向导可补全）"
+  fi
+
+  init_stores || return 1
+  probe_store_ports
+  if [ -n "${FEISHU_BASE_TOKEN:-}" ] && [ -n "${FEISHU_TABLE_ID:-}" ]; then
+    sync_feishu_field "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID" || return 1
+    migrate_old_records "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID"
+    verify_consistency "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID" || return 1
+  else
+    log_warn "未配置飞书表格，跳过店铺选项同步/一致性校验（登录后可重跑向导补全）"
+  fi
+
+  setup_machine
+  write_env
+  setup_daily_report
+  verify_all
+  return $?
+}
+
+# ── --refresh-stores：只重跑 3a-3g ───────────────────────
+if [ "$REFRESH_STORES" = "1" ]; then
+  echo ""
+  echo "🔄 刷新店铺选项模式（--refresh-stores）"
+  echo "  仅重新同步: 环境列表 → stores.json → CDP 端口 → 表格单选选项 → 旧记录迁移 → 一致性验证"
+  echo ""
+  migrate_legacy_data
+  if [ -f "$ENV_FILE" ]; then
+    set -a; source "$ENV_FILE"; set +a
+  fi
+  if [ -z "${FEISHU_BASE_TOKEN:-}" ] || [ -z "${FEISHU_TABLE_ID:-}" ]; then
+    log_err "缺少表格配置（$ENV_FILE 不存在或不完整），请先完整运行 init-ml.sh"
+    exit 1
+  fi
+  check_env || exit 1
+  init_stores || exit 1
+  probe_store_ports
+  sync_feishu_field "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID" || exit 1
+  migrate_old_records "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID"
+  verify_consistency "$FEISHU_BASE_TOKEN" "$FEISHU_TABLE_ID" || exit 1
+  log_ok "店铺选项刷新完成"
+  exit 0
+fi
+
+# ── --verify：全链一致性校验（只读，独立子命令）──────────
+if [ "$VERIFY_ONLY" = "1" ]; then
+  verify_chain
+  exit $?
+fi
+
+# ── --daily-report：仅配置日报推送（OAuth 授权 + cron）───
+if [ "$DAILY_REPORT_ONLY" = "1" ]; then
+  migrate_legacy_data
+  setup_daily_report
+  exit $?
+fi
+
+# ── --feishu-gateway：仅配置飞书对话接入 ─────────────────
+if [ "$FEISHU_GATEWAY_ONLY" = "1" ]; then
+  feishu_gateway_setup
+  exit $?
+fi
+
+main "$@"