@whyshu/argent-engine 0.0.0-stage → 0.6.1

package/engine/scripts/base-bootstrap.sh

@@ -0,0 +1,576 @@
+#!/bin/bash
+. "$(dirname "$0")/lib/argent-datadir.sh"   # 0.7.0 W8/S1：数据根唯一判据
+# ============================================================
+# base-bootstrap.sh — 飞书多维表格「FULL任务」自动代建脚本 v2（模板复制路径）
+#
+# 路径 A（默认，推荐）：BOT 从生产 FULL 模板 Base 复制新 Base
+#   lark-cli base +base-copy --as bot --without-content
+#   → 新 Base 100% 继承模板结构：12 字段 + 3 视图（表格/待处理/运营填写）
+#     （实测验证：字段名/类型/视图与模板完全一致，0 条记录）
+#   → permission.public patch → link_share_entity=tenant_editable（企业内全员可编辑，
+#     无需逐个授权，无需转移所有者）
+#   → 复制后 CLI 自动给当前 CLI 用户 full_access（可管理权限）
+#   → 回读字段验证 + 测试记录写入/清理（确认 BOT 可写）
+#   → 写 fulfillment.env：BASE_TOKEN/TABLE_ID/FEISHU_BASE_TOKEN/FEISHU_TABLE_ID
+#
+# 实测记录（2026-08-18）：
+#   · 复制继承结构（12 字段 + 3 视图）✅；不继承「历史记录」开关
+#     （源模板开 → 副本关；飞书无公开 API 可读写该开关，已排查 bitable app /
+#       drive file-version / record-history 均不涉及）——开关延后，需人工在 UI 打开
+#     （副本创建者/BOT 可管理权限账号可在「··· → 历史记录」开启）
+#   · BOT 读历史记录能力 ✅（record-history-list 实测返回完整字段变更审计）
+#   · 生产模板 MKsLbkFfmahoEGsZSKKcXHrbnDA 为只读复制源，永不修改
+#     （hermes 智能体正在使用，复制不会触碰源）
+#
+# 路径 B（--url）：客户已有 Base 内创建「FULL任务」表（12 字段 + 3 视图）——
+# 旧版兼容路径，需先把应用加为该 Base 协作者
+#
+# 身份：一律 --as bot，沿用 lark-cli 当前全局应用（本机为 hermes 旧应用
+# cli_a93b9354c6e35cd1，hermes agent 正在使用）——⚠️ 禁止任何 lark-cli config init
+# 切换应用，否则会打断运行中的 hermes agent。本脚本不触碰全局配置。
+# 兼容 bash 3.2（macOS 默认）：中文变量一律 ${VAR} 花括号形式。
+#
+# 用法:
+#   base-bootstrap.sh [--base-name <名称>] [--owner-email <邮箱>]
+#                     [--owner-openid <open_id>] [--url <base_url>]
+#                     [--env-file <path>] [--domain <host>]
+#                     [--force] [--skip-test] [--json] [--non-interactive]
+#     --base-name <名称>   新 Base 名称（默认 Argent 货件管理）
+#     --owner-email/-openid  可选：写入 env（FEISHU_OWNER_*），不做授权/转移
+#     --url <base_url>     路径 B：在客户已有 Base 内建表（需先加应用为协作者）
+#     --env-file <path>    输出 env 文件（默认 ~/.dsh/argent/fulfillment.env）
+#     --domain <host>      租户域名（默认 lcn33f9yunjm.feishu.cn，用于生成链接）
+#     --force              路径 B：表已存在时删除重建
+#     --skip-test          跳过测试记录写入
+#     --json               末尾输出一行 RESULT_JSON: {...}（机器可读，隐含 --non-interactive）
+#     --non-interactive    不询问确认，直接执行
+# ============================================================
+set -euo pipefail
+
+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} $*"; }
+
+# ── 常量 ──────────────────────────────────────────────
+TEMPLATE_BASE_TOKEN="MKsLbkFfmahoEGsZSKKcXHrbnDA"   # 生产 FULL 模板（只读源，永不修改）
+TEMPLATE_TABLE_NAME="FULL任务"
+
+# ── 参数解析 ──────────────────────────────────────────
+BASE_URL=""
+OWNER_EMAIL=""
+OWNER_OPENID=""
+BASE_NAME=""
+ENV_FILE="$ARGENT_DATA_DIR_RESOLVED/fulfillment.env"
+DOMAIN="lcn33f9yunjm.feishu.cn"
+FORCE=0
+SKIP_TEST=0
+JSON_OUT=0
+NON_INTERACTIVE=0
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --help|-h)
+      echo "用法: base-bootstrap.sh [选项]"
+      echo ""
+      echo "  飞书多维表格「FULL任务」自动代建脚本 v2（默认：从生产模板复制）"
+      echo ""
+      echo "  --base-name <名称>   新 Base 名称（默认 Argent 货件管理）"
+      echo "  --owner-email <邮箱>     可选：写入 env 的 FEISHU_OWNER_EMAIL（不做授权/转移）"
+      echo "  --owner-openid <open_id> 可选：写入 env 的 FEISHU_OWNER_OPENID"
+      echo "  --url <base_url>     路径 B：在客户已有 Base 内建表（需手动加应用为协作者）"
+      echo "  --env-file <path>    输出 env 文件（默认 ~/.dsh/argent/fulfillment.env）"
+      echo "  --domain <host>      租户域名（默认 lcn33f9yunjm.feishu.cn，生成链接用）"
+      echo "  --force              路径 B：表已存在时删除重建"
+      echo "  --skip-test          跳过测试记录写入"
+      echo "  --json               末尾输出 RESULT_JSON 行（机器可读）"
+      echo "  --non-interactive    非交互模式：不询问确认，直接执行"
+      echo ""
+      echo "  注意：本脚本沿用 lark-cli 当前全局应用（--as bot），绝不执行 config init"
+      echo "        （本机 hermes agent 正在使用该应用，切换会打断它）。"
+      echo ""
+      echo "  示例:"
+      echo "    base-bootstrap.sh --base-name 'Argent 货件管理（华东仓）'"
+      echo "    base-bootstrap.sh --url https://xxx.feishu.cn/base/XXX --non-interactive"
+      exit 0 ;;
+    --url)            BASE_URL="${2:-}"; shift 2 ;;
+    --owner-email)    OWNER_EMAIL="${2:-}"; shift 2 ;;
+    --owner-openid)   OWNER_OPENID="${2:-}"; shift 2 ;;
+    --base-name)      BASE_NAME="${2:-}"; shift 2 ;;
+    --env-file)       ENV_FILE="${2:-}"; shift 2 ;;
+    --domain)         DOMAIN="${2:-}"; shift 2 ;;
+    --force)          FORCE=1; shift ;;
+    --skip-test)      SKIP_TEST=1; shift ;;
+    --json)           JSON_OUT=1; NON_INTERACTIVE=1; shift ;;
+    --non-interactive) NON_INTERACTIVE=1; shift ;;
+    *) log_err "未知参数: ${1}"; exit 1 ;;
+  esac
+done
+BASE_NAME="${BASE_NAME:-Argent 货件管理}"
+
+# ── 交互确认（默认 Yes）──
+_confirm() {
+  [ "$NON_INTERACTIVE" = "1" ] && return 0
+  local ans
+  read -r -p "$1 [Y/n]: " ans
+  case "$(echo "$ans" | tr '[:upper:]' '[:lower:]')" in
+    ""|y|yes) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# ── 工具：JSON 提取（python3 读文件，避免管道安全拦截）──
+# 容忍 stderr 混入文件头部的 Warning 行：从第一个 { 或 [ 起解析
+_json_get() { # $1=文件路径 $2=python 表达式（d 为已解析 dict）
+  python3 -c "
+import json
+s = open('$1').read()
+i = s.find('{')
+if i < 0:
+    i = s.find('[')
+d = json.loads(s[i:]) if i >= 0 else {}
+print($2)
+" 2>/dev/null || true
+}
+
+# ── 1. bot 身份就绪检查（--as bot）──────────────────────
+AUTH_JSON=$(mktemp -t lark-auth.XXXXXX.json)
+trap 'rm -f "$AUTH_JSON"' EXIT
+lark-cli auth status > "$AUTH_JSON" 2>/dev/null || true
+BOT_STATUS=$(python3 -c "
+import json
+try:
+    d = json.load(open('$AUTH_JSON'))
+    print(d.get('identities', {}).get('bot', {}).get('status', 'missing'))
+except Exception:
+    print('missing')
+")
+
+if [ "$BOT_STATUS" != "ready" ]; then
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  飞书应用（bot 身份）未就绪"
+  echo "════════════════════════════════════════════════"
+  log_err "lark-cli 的 bot 身份未就绪（当前状态: ${BOT_STATUS}）——建表/授权需要以应用身份执行。"
+  echo ""
+  echo "  请检查飞书应用配置（Web 设置页保存 App ID/Secret 即可自动初始化）："
+  echo "    ① ~/.dsh/argent/config.json 的 feishuAppId / feishuAppSecret 是否正确、已绑定"
+  echo "    ② 确认已开通权限：bitable:app（查看评论编辑管理多维表格）、"
+  echo "       drive:drive（查看评论编辑管理云空间文件）"
+  echo "    ③ 确认应用已发布（开放平台 → 版本管理与发布 → 发布）"
+  echo "    ④ 修复后重跑本脚本"
+  exit 1
+fi
+log_ok "bot 身份就绪"
+
+# ── 2. 分支：路径 A（模板复制）／路径 B（--url 已有 Base）──
+if [ -z "$BASE_URL" ]; then
+  # ═══════════════ 路径 A：模板复制（默认） ═══════════════
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  📋 从生产模板复制 Base（12 字段 + 3 视图，仅结构）"
+  echo "════════════════════════════════════════════════"
+  log_info "模板: ${TEMPLATE_BASE_TOKEN}（只读源，永不修改）"
+  if ! _confirm "  确认从模板复制新 Base「${BASE_NAME}」？"; then
+    log_err "已取消"; exit 1
+  fi
+
+  COPY_JSON=$(mktemp -t lark-base-copy.XXXXXX.json)
+  if ! lark-cli base +base-copy \
+      --as bot \
+      --base-token "$TEMPLATE_BASE_TOKEN" \
+      --name "${BASE_NAME}" \
+      --without-content \
+      --format json > "$COPY_JSON" 2>&1; then
+    log_err "模板复制失败："
+    head -8 "$COPY_JSON"
+    log_err "请检查：① 应用是否有模板 Base 的访问权限（tenant_editable 或协作者）；"
+    echo "    ② 是否已开通 bitable:app 与 drive:drive；③ 应用是否已发布"
+    exit 1
+  fi
+  # 新 Base token 解析（兼容多种返回结构）
+  BASE_TOKEN=$(_json_get "$COPY_JSON" "d.get('data', {}).get('base', {}).get('base_token') or d.get('data', {}).get('base_token') or d.get('data', {}).get('app', {}).get('app_token') or ''")
+  # 复制后 CLI 尝试给当前 CLI 用户 full_access（可管理）——成功/跳过都必须告知
+  GRANT_STATUS=$(_json_get "$COPY_JSON" "d.get('permission_grant', {}).get('status') or ''")
+  PERM_GRANT=$(_json_get "$COPY_JSON" "json.dumps(d.get('permission_grant'), ensure_ascii=False) if d.get('permission_grant') else ''")
+  rm -f "$COPY_JSON"
+  if [ -z "$BASE_TOKEN" ]; then
+    log_err "复制成功但无法解析 Base Token——请检查模板访问权限后重试"
+    exit 1
+  fi
+  log_ok "新 Base 已创建: ${BASE_TOKEN}"
+  if [ "$GRANT_STATUS" = "skipped" ]; then
+    log_warn "自动授予当前用户 full_access 被跳过（lark-cli 无已登录用户会话）"
+    log_warn "如需管理员权限：可在网页端给账号加可管理协作者，或执行 lark-cli auth login 后重跑"
+    log_warn "（历史记录开关等管理操作需要该权限；企业内链接可编辑已由 tenant_editable 覆盖）"
+  elif [ -n "$PERM_GRANT" ]; then
+    log_info "permission_grant: ${PERM_GRANT}"
+  fi
+
+  # 解析表 ID（复制品含模板的 FULL任务 表，按名回查；复制后短暂时延需重试）
+  TABLE_ID=""
+  for _try in 1 2 3 4 5; do
+    [ -z "$TABLE_ID" ] || break
+    sleep 2
+    TABLES_JSON=$(mktemp -t lark-tables.XXXXXX.json)
+    lark-cli base +table-list --base-token "$BASE_TOKEN" --as bot --format json > "$TABLES_JSON" 2>/dev/null || true
+    TABLE_ID=$(python3 -c "
+import json
+try:
+    d = json.load(open('$TABLES_JSON'))
+    ts = [t.get('id', '') for t in d.get('data', {}).get('tables', []) if t.get('name') == '$TEMPLATE_TABLE_NAME']
+    print(ts[0] if ts else '')
+except Exception:
+    print('')
+")
+    rm -f "$TABLES_JSON"
+  done
+  if [ -z "$TABLE_ID" ]; then
+    log_err "无法确定「${TEMPLATE_TABLE_NAME}」表 ID——请检查复制品结构"
+    exit 1
+  fi
+  log_ok "表「${TEMPLATE_TABLE_NAME}」: ${TABLE_ID}"
+
+  # ── 开放企业内可编辑（tenant_editable）────────────────
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🔓 开放企业内可编辑（link_share_entity=tenant_editable）"
+  echo "════════════════════════════════════════════════"
+  PUB_JSON=$(mktemp -t lark-pub.XXXXXX.json)
+  PUB_OK=0
+  for _try in 1 2; do
+    if lark-cli drive permission.public patch --as bot --yes \
+        --params "{\"token\":\"${BASE_TOKEN}\",\"type\":\"bitable\"}" \
+        --data '{"link_share_entity":"tenant_editable"}' \
+        --format json > "$PUB_JSON" 2>&1; then
+      PUB_OK=1
+      break
+    fi
+    sleep 3
+  done
+  if [ "$PUB_OK" = "1" ]; then
+    log_ok "已开放：企业内成员通过链接可编辑（无需逐个授权/转移所有者）"
+  else
+    log_warn "开放企业内可编辑失败（可稍后手动处理）："
+    head -6 "$PUB_JSON"
+  fi
+  rm -f "$PUB_JSON"
+else
+  # ═══════════════ 路径 B：--url 已有 Base 建表（legacy） ═══════════════
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  📋 在已有 Base 中创建「${TEMPLATE_TABLE_NAME}」表（12 字段 + 3 视图）"
+  echo "════════════════════════════════════════════════"
+  BASE_TOKEN=$(echo "$BASE_URL" | python3 -c "
+import re, sys
+u = sys.stdin.read().strip()
+m = re.search(r'/base/([A-Za-z0-9]+)', u)
+print(m[1] if m else '')
+")
+  if [ -z "$BASE_TOKEN" ]; then
+    log_err "无法从 URL 解析 Base Token——请确认格式: https://xxx.feishu.cn/base/XXX"
+    exit 1
+  fi
+  log_warn "该 Base 需手动把飞书应用添加为协作者（可管理权限），否则后续 bot 操作会失败"
+
+  # 字段 schema（对齐模板字段；SKU 主字段）
+  FIELDS_JSON='[
+    {"type":"text","name":"SKU"},
+    {"type":"select","name":"状态","options":[{"name":"Pending"},{"name":"运行中"},{"name":"已完成"},{"name":"失败"}]},
+    {"type":"select","name":"店铺名称","options":[{"name":"3店-主账号"},{"name":"2店-子账号"},{"name":"1店-子账号"}]},
+    {"type":"text","name":"品名"},
+    {"type":"number","name":"数量","style":{"type":"plain","precision":2}},
+    {"type":"number","name":"箱数","style":{"type":"plain","precision":2}},
+    {"type":"checkbox","name":"就绪"},
+    {"type":"created_at","name":"创建时间"},
+    {"type":"text","name":"当前步骤"},
+    {"type":"text","name":"货件号"},
+    {"type":"attachment","name":"产品标签"},
+    {"type":"attachment","name":"箱唛"}
+  ]'
+
+  # 建表前检查：是否已有同名表
+  TABLES_JSON=$(mktemp -t lark-tables.XXXXXX.json)
+  lark-cli base +table-list --base-token "$BASE_TOKEN" --as bot --format json > "$TABLES_JSON" 2>/dev/null || true
+  HAS_TABLE=$(python3 -c "
+import json
+try:
+    d = json.load(open('$TABLES_JSON'))
+    print('yes' if any(t.get('name') == '$TEMPLATE_TABLE_NAME' for t in d.get('data', {}).get('tables', [])) else 'no')
+except Exception:
+    print('no')
+")
+  rm -f "$TABLES_JSON"
+  if [ "$HAS_TABLE" = "yes" ]; then
+    if [ "$FORCE" = "1" ]; then
+      log_warn "检测到已有「${TEMPLATE_TABLE_NAME}」表，--force 将删除重建"
+      if ! _confirm "  确认删除旧表并重建？"; then
+        log_err "已取消"; exit 1
+      fi
+      lark-cli base +table-delete --base-token "$BASE_TOKEN" --table-id "$TEMPLATE_TABLE_NAME" --yes --as bot --format json >/dev/null 2>&1 || true
+      log_ok "旧表已删除"
+    else
+      log_err "该 Base 中已存在「${TEMPLATE_TABLE_NAME}」表——为避免误覆盖，脚本已中止。"
+      echo "  如需重建请加 --force（会删除旧表，请确认没有在用数据）。"
+      exit 1
+    fi
+  fi
+
+  CREATE_JSON=$(mktemp -t lark-create.XXXXXX.json)
+  if ! lark-cli base +table-create \
+      --base-token "$BASE_TOKEN" \
+      --name "$TEMPLATE_TABLE_NAME" \
+      --fields "$FIELDS_JSON" \
+      --as bot --format json > "$CREATE_JSON" 2>&1; then
+    log_err "建表失败："
+    head -5 "$CREATE_JSON"
+    exit 1
+  fi
+  TABLE_ID=$(_json_get "$CREATE_JSON" "d.get('data', {}).get('table', {}).get('id') or ''")
+  rm -f "$CREATE_JSON"
+  if [ -z "$TABLE_ID" ]; then
+    log_err "建表成功但无法解析 Table ID——请检查上表是否存在"
+    exit 1
+  fi
+  log_ok "「${TEMPLATE_TABLE_NAME}」表已创建: ${TABLE_ID}（12 字段）"
+
+  # 视图（路径 B 需手工建；路径 A 由模板自带）
+  VIEW_JSON=$(mktemp -t lark-views.XXXXXX.json)
+  lark-cli base +view-list --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" --as bot --format json > "$VIEW_JSON" 2>/dev/null || true
+  DEFAULT_VIEW_ID=$(_json_get "$VIEW_JSON" "d.get('data', {}).get('views', [{}])[0].get('id') or ''")
+  rm -f "$VIEW_JSON"
+  if [ -n "$DEFAULT_VIEW_ID" ]; then
+    lark-cli base +view-rename --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+      --view-id "$DEFAULT_VIEW_ID" --name "表格" --as bot --format json >/dev/null 2>&1 || \
+      log_warn "默认视图改名「表格」失败（可忽略）"
+  fi
+  VIEW2_JSON=$(mktemp -t lark-view2.XXXXXX.json)
+  lark-cli base +view-create --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --json '{"name":"待处理","type":"grid"}' --as bot --format json > "$VIEW2_JSON" 2>&1
+  if grep -q '"ok": true' "$VIEW2_JSON"; then
+    lark-cli base +view-set-filter --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+      --view-id "待处理" --json '{"logic":"and","conditions":[["就绪","==",true]]}' \
+      --as bot --format json >/dev/null 2>&1 && \
+      log_ok "视图「待处理」就绪（筛选 就绪=true）" || \
+      log_warn "「待处理」视图筛选设置失败，请手动设置"
+  else
+    log_warn "「待处理」视图创建失败（可稍后手动创建）"
+  fi
+  rm -f "$VIEW2_JSON"
+  VIEW3_JSON=$(mktemp -t lark-view3.XXXXXX.json)
+  lark-cli base +view-create --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --json '{"name":"运营填写","type":"grid"}' --as bot --format json > "$VIEW3_JSON" 2>&1
+  if grep -q '"ok": true' "$VIEW3_JSON"; then
+    VIEWLIST_JSON=$(mktemp -t lark-viewlist.XXXXXX.json)
+    lark-cli base +view-list --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+      --as bot --format json > "$VIEWLIST_JSON" 2>/dev/null || true
+    FULFILL_VIEW_ID=$(python3 -c "
+import json
+d = json.load(open('$VIEWLIST_JSON'))
+vid = ''
+for v in d.get('data', {}).get('views', []):
+    if isinstance(v, dict) and v.get('name') == '运营填写':
+        vid = v.get('id') or ''
+        break
+print(vid)
+" 2>/dev/null || true)
+    rm -f "$VIEWLIST_JSON"
+    if [ -n "$FULFILL_VIEW_ID" ]; then
+      lark-cli base +view-set-visible-fields --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+        --view-id "$FULFILL_VIEW_ID" \
+        --json '{"visible_fields":["店铺名称","SKU","品名","数量","箱数"]}' \
+        --as bot --format json >/dev/null 2>&1 && \
+        log_ok "视图「运营填写」就绪（仅运营 5 字段）" || \
+        log_warn "「运营填写」视图可见字段设置失败，请手动设置"
+    fi
+  else
+    log_warn "「运营填写」视图创建失败（可稍后手动创建）"
+  fi
+  rm -f "$VIEW3_JSON"
+fi
+
+# ── 3. 验证闭环：回读字段与模板 schema 对比 ─────────────
+echo ""
+echo "════════════════════════════════════════════════"
+echo "  🔍 验证闭环：回读字段清单与模板 schema 对比"
+echo "════════════════════════════════════════════════"
+# 期望 schema（与生产模板实测一致；创建时间模板为 datetime）
+FIELDS_READ=$(mktemp -t lark-fields-read.XXXXXX.json)
+lark-cli base +field-list --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" --as bot --format json > "$FIELDS_READ" 2>/dev/null || true
+# 复制后时延：字段清单为空时重试一次
+if ! grep -q '"fields"' "$FIELDS_READ" 2>/dev/null; then
+  sleep 2
+  lark-cli base +field-list --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" --as bot --format json > "$FIELDS_READ" 2>/dev/null || true
+fi
+VERIFY=$(python3 -c "
+import json
+d = json.load(open('$FIELDS_READ'))
+fields = {f['name']: f for f in d.get('data', {}).get('fields', [])}
+expect = {
+    'SKU':        'text',       '当前步骤': 'text',
+    '箱数':        'number',     '状态':     'select',
+    '创建时间':    'datetime',   '货件号':   'text',
+    '店铺名称':    'select',     '就绪':     'checkbox',
+    '品名':        'text',       '箱唛':     'attachment',
+    '数量':        'number',     '产品标签': 'attachment',
+}
+diffs = []
+for n in expect:
+    if n not in fields:
+        diffs.append('缺字段: ' + n)
+    elif fields[n].get('type') != expect[n]:
+        diffs.append('字段「%s」类型不符: 期望 %s, 实际 %s' % (n, expect[n], fields[n].get('type')))
+# select 字段至少 1 个选项（选项以模板为准，不强制精确匹配）
+for n in ('状态', '店铺名称'):
+    if n in fields and fields[n].get('type') == 'select' and not fields[n].get('options'):
+        diffs.append('字段「%s」无 select 选项' % n)
+print('OK' if not diffs else '\n'.join(diffs))
+")
+rm -f "$FIELDS_READ"
+if [ "$VERIFY" = "OK" ]; then
+  log_ok "字段验证通过：12/12 字段名、类型与模板完全一致"
+else
+  log_warn "字段验证发现差异："
+  echo "$VERIFY" | sed 's/^/    /'
+  log_warn "请人工检查上表字段是否需要修正"
+fi
+
+# ── 4. 测试记录：写入 1 条 → 确认 → 删除 → 确认清理 ────
+if [ "$SKIP_TEST" = "1" ]; then
+  log_warn "已跳过测试记录写入（--skip-test）"
+else
+  echo ""
+  echo "════════════════════════════════════════════════"
+  echo "  🧪 测试纪律：写入 1 条测试记录并清理"
+  echo "════════════════════════════════════════════════"
+  TEST_JSON=$(mktemp -t lark-test.XXXXXX.json)
+  lark-cli base +record-batch-create \
+    --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --json '{"fields":["SKU","品名","货件号","状态"],"rows":[["TEST-验证","测试",null,"Pending"]]}' \
+    --as bot --format json > "$TEST_JSON" 2>&1
+  TEST_REC_ID=$(_json_get "$TEST_JSON" "d.get('data', {}).get('record_id_list', [''])[0] or ''")
+  rm -f "$TEST_JSON"
+  if [ -z "$TEST_REC_ID" ]; then
+    log_err "测试记录写入失败——请检查字段配置与 bot 权限（bitable:app）"
+    exit 1
+  fi
+  log_ok "测试记录已写入: ${TEST_REC_ID}（SKU=TEST-验证，品名=测试，货件号留空）"
+
+  sleep 2
+  READ_TEST=$(mktemp -t lark-test-read.XXXXXX.json)
+  lark-cli base +record-list \
+    --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --filter-json '{"logic":"and","conditions":[["SKU","==","TEST-验证"]]}' \
+    --as bot --format json --limit 5 > "$READ_TEST" 2>/dev/null || true
+  TEST_FOUND=$(python3 -c "
+import json
+try:
+    d = json.load(open('$READ_TEST'))
+    print('yes' if d.get('data', {}).get('data') else 'no')
+except Exception:
+    print('no')
+")
+  rm -f "$READ_TEST"
+  if [ "$TEST_FOUND" != "yes" ]; then
+    log_warn "回读测试记录未找到（可能有时延）——继续尝试删除"
+  else
+    log_ok "回读确认：测试记录可读可写"
+  fi
+
+  lark-cli base +record-delete \
+    --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --record-id "$TEST_REC_ID" --yes \
+    --as bot --format json >/dev/null 2>&1 || log_warn "测试记录删除请求失败，请手动删除 rec: ${TEST_REC_ID}"
+  sleep 3
+  CONFIRM_EMPTY=$(mktemp -t lark-test-empty.XXXXXX.json)
+  lark-cli base +record-list \
+    --base-token "$BASE_TOKEN" --table-id "$TABLE_ID" \
+    --filter-json '{"logic":"and","conditions":[["SKU","==","TEST-验证"]]}' \
+    --as bot --format json --limit 5 > "$CONFIRM_EMPTY" 2>/dev/null || true
+  EMPTY=$(python3 -c "
+import json
+try:
+    d = json.load(open('$CONFIRM_EMPTY'))
+    rows = d.get('data', {}).get('data', [])
+    print('clean' if not rows else 'left:' + str(len(rows)))
+except Exception:
+    print('unknown')
+")
+  rm -f "$CONFIRM_EMPTY"
+  if [ "$EMPTY" = "clean" ]; then
+    log_ok "测试记录已删除，表内无 TEST-验证 残留"
+  else
+    log_warn "测试记录清理未确认（${EMPTY}）——请手动检查并清理"
+  fi
+fi
+
+# ── 5. 输出 BASE_TOKEN/TABLE_ID 写入 fulfillment.env ────
+echo ""
+echo "════════════════════════════════════════════════"
+echo "  💾 写入配置: ${ENV_FILE}"
+echo "════════════════════════════════════════════════"
+mkdir -p "$(dirname "$ENV_FILE")"
+[ -f "$ENV_FILE" ] || touch "$ENV_FILE"
+
+# 安全追加：只更新/追加目标键，绝不触碰其他键（含已有 FEISHU_* 等配置）
+update_env_key() {
+  local key="$1" val="$2" file="$3"
+  if grep -qE "^${key}=" "$file"; 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
+}
+update_env_key "BASE_TOKEN"   "$BASE_TOKEN" "$ENV_FILE"
+update_env_key "TABLE_ID"     "$TABLE_ID"   "$ENV_FILE"
+# 兼容 orchestrator 生态键名（FEISHU_BASE_TOKEN / FEISHU_TABLE_ID 同值）
+update_env_key "FEISHU_BASE_TOKEN" "$BASE_TOKEN" "$ENV_FILE"
+update_env_key "FEISHU_TABLE_ID"   "$TABLE_ID"   "$ENV_FILE"
+if [ -n "${OWNER_EMAIL:-}" ]; then
+  update_env_key "FEISHU_OWNER_EMAIL" "$OWNER_EMAIL" "$ENV_FILE"
+fi
+if [ -n "${OWNER_OPENID:-}" ]; then
+  update_env_key "FEISHU_OWNER_OPENID" "$OWNER_OPENID" "$ENV_FILE"
+fi
+log_ok "已写入 BASE_TOKEN / TABLE_ID（及 FEISHU_BASE_TOKEN / FEISHU_TABLE_ID 生态别名）"
+[ -n "${OWNER_EMAIL:-}" ] && log_ok "已写入 FEISHU_OWNER_EMAIL"
+[ -n "${OWNER_OPENID:-}" ] && log_ok "已写入 FEISHU_OWNER_OPENID"
+
+BASE_URL_FULL="https://${DOMAIN}/base/${BASE_TOKEN}"
+
+echo ""
+echo "════════════════════════════════════════════════"
+echo "  🎉 全部完成！"
+echo "════════════════════════════════════════════════"
+echo "  Base:  ${BASE_URL_FULL}"
+echo "  表:    ${TEMPLATE_TABLE_NAME}（${TABLE_ID}）"
+echo "  字段:  12 个（模板复制，已验证一致）"
+echo "  视图:  表格 · 待处理（筛选 就绪=true）· 运营填写（仅运营 5 字段）"
+echo "  权限:  企业内链接可编辑（tenant_editable）"
+echo "  配置:  ${ENV_FILE}"
+echo ""
+echo "  使用方式：在表格中新增记录 → 勾选「就绪」→ 编排器自动捡取执行"
+echo "  提示：历史记录开关复制不继承（模板开→副本关），需要时由管理员在"
+echo "        副本「··· → 历史记录」手动开启（BOT/管理员可管理权限可开）"
+
+# ── 6. 机器可读输出（--json）───────────────────────────
+if [ "$JSON_OUT" = "1" ]; then
+  python3 -c "
+import json
+print('RESULT_JSON: ' + json.dumps({
+    'ok': True,
+    'base_token': '$BASE_TOKEN',
+    'table_id': '$TABLE_ID',
+    'base_url': '$BASE_URL_FULL',
+    'base_name': '$BASE_NAME',
+    'table_name': '$TEMPLATE_TABLE_NAME',
+    'env_file': '$ENV_FILE',
+    'owner_email': '${OWNER_EMAIL:-}',
+    'owner_openid': '${OWNER_OPENID:-}',
+}, ensure_ascii=False))
+"
+fi

package/engine/scripts/billing-mode-daily.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+. "$(dirname "$0")/lib/argent-datadir.sh"   # 0.7.0 W8/S1：数据根唯一判据
+# 每日 provider 装配巡检（2026-09-29；2026-10-02 口径更新 = 组合声明的 provider 有没有装上）。
+# 文件名保留 billing-mode-*：LaunchAgent `com.whyshu.billing-mode-check` 指的就是这个路径。
+# 由 LaunchAgent com.whyshu.billing-mode-check 调用（每天 09:20）。
+set -uo pipefail
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+LOG="$ARGENT_DATA_DIR_RESOLVED/logs/billing-mode.log"
+mkdir -p "$(dirname "$LOG")"
+OUT="$(bash "$REPO/scripts/check-billing-mode.sh" 2>&1)"; CODE=$?   # 只检查：组合声明了的 provider 是否都装上了（不再改写任何 provider 配置）
+{ echo "----- $(date '+%F %T') exit=$CODE"; echo "$OUT"; } >> "$LOG"
+if [ $CODE -ne 0 ]; then logger -t billing-mode "provider 装配异常 exit=${CODE}（详见 ${LOG}）"; fi
+exit 0