@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/daily-report.mjs

@@ -0,0 +1,1310 @@
+#!/usr/bin/env node
+/**
+ * daily-report.mjs — 美客多多店铺日报（官方 API 数据源）· 定时推送飞书
+ *
+ * 链路：ml-api-stores.json（OAuth token，由 ml-oauth-setup.mjs 生成）
+ *   → 逐店刷新 access token → /orders/search（昨日 + 近7日，按站点本地时区）
+ *   → /users/{uid}/items/search（库存/价格）→ 畅销榜 + 补货预警
+ *   → 飞书（ml-daily 角色 Bot 优先、webhook 兜底；两者都没配则 lark-cli bot → 配置中心 chatId）
+ *
+ * 时间语义：按店铺站点本地时间计算「昨日」，每天本地 REPORT_TIME（默认 08:00）
+ *   推送前一天日报；cron 每小时触发本脚本，由脚本做时间门控 + 幂等标记。
+ *
+ * 用法:
+ *   node daily-report.mjs --dry-run             # 只打印日报，不推送
+ *   node daily-report.mjs --force               # 跳过时间门控立即推送（成功后写幂等标记）
+ *   node daily-report.mjs --force --no-mark     # 测试/验证：强制推送但不写幂等标记（不挡当晚定时推送）
+ *   node daily-report.mjs --date 2026-08-20     # 指定日报日期（默认各店本地昨日）
+ *   node daily-report.mjs --env <env 文件路径>  # 默认 ~/.dsh/argent/daily-report.env
+ *   node daily-report.mjs --mock <fixture.json> # 开发自测：跳过联网，仅渲染/打印
+ *
+ * 数据（~/.dsh/argent/，update 不覆盖）:
+ *   daily-report.env       配置（init-ml.sh 生成模板）
+ *   ml-api-stores.json     店铺 OAuth token（ml-oauth-setup.mjs 生成）
+ *   daily-report-cache/    每日快照 + 推送标记（环比/防重复数据源）
+ *   daily-report-logs/     运行日志（cron wrapper 落盘）
+ */
+
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync, appendFileSync, accessSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+import { resolveDataDir } from './lib/argent-datadir.mjs'
+import { isDirectRun } from './lib/is-direct-run.mjs'
+// 共用取数/聚合/口径的唯一实现（2026-10-12 抽取）：日报 CLI 与只读对账 CLI 共用同一份，
+// ⛔ 不许在任何一边复制第二份口径逻辑。见 `scripts/lib/daily-report-core.mjs` 文件头。
+import {
+  SITE_TZ, SITE_CURRENCY, fallbackSite, sleep, loadEnvFile,
+  aggregateOrders, reportWindows, windowInfo, capturedAtInfo, captureNoteLines,
+  matchStores, storeKey,
+  localDateStr, tzOffsetMs, startOfLocalDayUTC, localHour,
+  apiGet as coreApiGet, fetchOrders as coreFetchOrders, refreshStoreToken as coreRefreshStoreToken,
+} from './lib/daily-report-core.mjs'
+
+// 逐字转出（既有调用方/单测 import 路径不变；同一绑定 ⇒ `M.aggregateOrders === core.aggregateOrders`）
+export { aggregateOrders, localDateStr, tzOffsetMs, startOfLocalDayUTC, localHour, loadEnvFile }
+
+const __dirname = dirname(fileURLToPath(import.meta.url))   // ESM 里没有 __dirname（用于找同目录脚本）
+
+// 每次调用时解析（不在模块加载时固化）：测试可把 ML_API_BASE 指向本地假服务
+// ⚠️ 引擎侧**不把平台域名**放进新文件（engine-words 门禁只拦新增、⛔ 不抬基线）⇒
+// 这份历史常量留在本文件（基线已记账），共用实现按参数接收基址；对账 CLI 从快照记录的
+// `apiBase` 取（见 lib/daily-report-core.mjs 文件头）。
+const apiBase = () => process.env.ML_API_BASE || 'https://api.mercadolibre.com'
+
+// ── 参数 ───────────────────────────────────────────────────
+const args = process.argv.slice(2)
+const argVal = (name) => {
+  const i = args.indexOf(name)
+  return i >= 0 && args[i + 1] ? args[i + 1] : null
+}
+// 数据目录：内核三级链（唯一判据；原为硬编码 ~/.dsh/argent ⇒ 隔离实例读生产配置）
+const DATA_DIR = resolveDataDir({ env: process.env }).dir
+const ENV_PATH = argVal('--env') || join(DATA_DIR, 'daily-report.env')
+const STORES_PATH = process.env.ML_API_STORES_JSON || join(DATA_DIR, 'ml-api-stores.json')
+// 运行期店铺授权列表（main 加载后挂模块级，token 刷新轮换后原子写回同一文件——
+// ML refresh_token 为轮换制：不落盘则下次仍用已作废旧 token 刷新 → 429 rate limit
+// （2026-09-04/05 连续两日断供根因：文件 access_expires_at 停在 08-24 证明从未写回））
+let STORE_LIST = null
+function persistStores() {
+  try {
+    if (!STORE_LIST) return
+    const tmp = `${STORES_PATH}.tmp`
+    writeFileSync(tmp, JSON.stringify({ stores: STORE_LIST }, null, 2) + '\n')
+    renameSync(tmp, STORES_PATH)
+  } catch (e) {
+    // 写回失败不阻断本次推送；但下次刷新会再用旧 token，可能再次触发限流
+    console.error(`✗ token 写回 ${STORES_PATH} 失败：${e.message}`)
+  }
+}
+const FLAG_DRY = args.includes('--dry-run')
+const FLAG_FORCE = args.includes('--force')
+// KB-074：测试/验证用——推送成功后不写幂等标记（手动 --force 不挡当晚定时推送）
+const FLAG_NO_MARK = args.includes('--no-mark')
+const FLAG_JSON = args.includes('--json') // KB-063：只输出日报卡片 JSON（BOT 回复卡片用），不推送
+const ARG_DATE = argVal('--date')
+const FLAG_LIST_SECTIONS = args.includes('--list-sections')
+const FLAG_LIST_STORES = args.includes('--list-stores')
+const ARG_STORE = (argVal('--store') || '').split(',').map((x) => x.trim()).filter(Boolean)
+const ARG_SECTIONS = (argVal('--sections') || '').split(',').map((x) => x.trim()).filter(Boolean)
+const ARG_GROUPS = (argVal('--groups') || '').split(',').map((x) => x.trim()).filter(Boolean)
+const MOCK_FILE = argVal('--mock')
+// `ARGENT_DATA_HOME` 是历史别名（core/mcp 影子跑两者都设）⇒ 保留优先，其余走内核三级链
+const DATA_HOME = process.env.ARGENT_DATA_HOME || DATA_DIR
+
+// ── 纯工具函数（导出供单测）────────────────────────────────
+// `loadEnvFile` 的实现已抽到 `scripts/lib/daily-report-core.mjs`（对账 CLI 共用同一份），
+// 本文件顶部逐字转出 ⇒ 既有调用方与单测 import 路径不变。
+
+export function parseTimeGate(s) {
+  const m = /^(\d{1,2})(?::(\d{2}))?$/.exec(String(s || '').trim())
+  if (!m) return { hour: 8, minute: 0 }
+  return { hour: Number(m[1]), minute: Number(m[2] || 0) }
+}
+
+// 某时区的「本地日期 YYYY-MM-DD」/ 偏移 / 本地日 00:00 / 本地小时 —— 实现已抽到
+// `scripts/lib/daily-report-core.mjs`（本文件顶部逐字转出，调用方与单测不受影响）。
+// 时间门控：站点本地时间是否已到 REPORT_TIME 所在小时
+
+export function gateDue(tz, now, reportTime) {
+  const { hour } = parseTimeGate(reportTime)
+  return localHour(tz, now) === hour
+}
+
+// 补推韧性（2026-09-06）：站点本地已过推送时刻、当日尚未成功推送（幂等标记）时，
+// 推送时刻后的 +5 小时窗口内允许每小时 cron 补试——单窗口失败（429/网络/漏跑）不再让当天断供。
+// already = 当日是否已推送（调用方按站点本地「昨日」日期查幂等标记）
+export function gateCatchUp(tz, now, reportTime, already) {
+  if (already) return false
+  const { hour } = parseTimeGate(reportTime)
+  const h = localHour(tz, now)
+  return h >= hour && h <= hour + 5
+}
+
+export function money(code, n) {
+  if (n == null) return '—'
+  return `${code} ${Math.round(n).toLocaleString('en-US')}`
+}
+
+export function pctMark(cur, prev) {
+  if (!prev) return ''
+  const d = cur - prev
+  if (d === 0) return '（与昨日持平）'
+  const p = Math.round((d / prev) * 100)
+  return d > 0 ? `（↗ 环比 +${p}%）` : `（↘ 环比 ${p}%）`
+}
+
+// ── 订单聚合（近7日 + 昨日，按 SKU）────────────────────────
+// 实现已抽到 `scripts/lib/daily-report-core.mjs`（本文件顶部逐字转出；对账 CLI 共用同一份）。
+
+// ── 补货预警 + 畅销榜 ─────────────────────────────────────
+export function computeAlerts(skus, leadDays, bufferDays, topN) {
+  const threshold = leadDays + bufferDays
+  const alerts = []
+  for (const s of skus) {
+    const rate = s.units7 / 7
+    const days = rate > 0 && s.avail != null ? s.avail / rate : null
+    s.rate = rate
+    s.days = days
+    let level = 'none'
+    if (s.avail === 0 && s.units7 > 0) level = 'red'
+    else if (s.avail > 0 && days != null && days < threshold) level = 'yellow'
+    else if (s.avail === 0 && s.units7 === 0) level = 'gray'
+    s.level = level
+    s.suggested = rate > 0 ? Math.max(0, Math.ceil(threshold * rate - (s.avail || 0))) : 0
+    if (level === 'red' || level === 'yellow') alerts.push(s)
+  }
+  const redFirst = (a, b) =>
+    (a.level === 'red' ? 0 : 1) - (b.level === 'red' ? 0 : 1) || (a.days ?? Infinity) - (b.days ?? Infinity)
+  alerts.sort(redFirst)
+  const top = [...skus].sort((a, b) => b.units7 - a.units7 || b.gmv7 - a.gmv7).slice(0, topN)
+  return { alerts, top, threshold }
+}
+
+// ── 展示名：**只用 SKU**（2026-09-27 用户口径：日报必须与 lip 表解耦）──
+// 决策经过：先做过「SKU · 中文品名」（中文名来自 lip 表 `产品名称`），随后用户明确
+// **"日报是要跟 lip 表解耦的，所以直接显示 SKU 就好了"** ⇒ 中文名链路（脚本/缓存/依赖）整条移除：
+// 日报只依赖美客多官方 API，不再读任何客户飞书表，也不会因为客户表没录/换列名而失效。
+// 展示链：`SKU` → 无 SKU 时中性占位 `商品 <id>`（**绝不退回西语标题**，用户口径"看不懂也没意义"）。
+export function skuLabel(s) {
+  const code = String((s && s.sku) || '').trim()
+  return code || `商品 ${(s && s.id) || ''}`.trim()
+}
+
+// ── 分区（section）注册表：日报的**插拔单位** ────────────────
+// 设计（docs/日报信息架构与插拔方案-2026-09-27.md）：
+//   · 每个分区自描述：id / group / needs（数据依赖）/ cost（请求量）/ cadence / default / minPlan
+//   · **采集层也按需**：只跑"已启用分区 needs 的并集" ⇒ 关掉的组不产生任何 API 请求
+//   · 注册表是唯一真源，三个消费方共用：① 定时卡片 ② 工作台详情 ③ 角色对话（SKILL）
+// 渲染约定：分区返回**行数组**（不自行 join），由 renderStoreSection 统一拼 ⇒ 重构前后逐字节一致。
+export const SECTION_GROUPS = ['risk', 'sales', 'profit', 'traffic', 'ads', 'ops']
+
+export const SECTIONS = [
+  {
+    id: 'risk.reputation', group: 'risk', title: '信誉与合规', needs: ['reputation'], cost: { requests: 1 },
+    cadence: 'daily', default: true,
+    render: ({ d }) => {
+      const rep = (d && d.reputation) || null
+      if (!rep) return d && d.__errors && d.__errors.reputation ? [`**🛡 信誉与合规**：未取到（${d.__errors.reputation}）`] : null
+      const m = rep.metrics || {}
+      const rate = (x) => (x && x.rate != null ? `${(x.rate * 100).toFixed(2)}%` : '—')
+      const val = (x) => (x && x.value != null ? x.value : '—')
+      const flag = (x, warn, bad) => { const v = (x && x.rate) || 0; return v >= bad ? '🔴' : v >= warn ? '🟡' : '✅' }
+      return [
+        `**🛡 信誉与合规**（60 天）· ${rep.level_id || '—'}${rep.power_seller_status ? ` / ${rep.power_seller_status}` : ''}`,
+        `${flag(m.claims, 0.01, 0.02)} 纠纷 ${rate(m.claims)}（${val(m.claims)} 件） · ${flag(m.delayed_handling_time, 0.01, 0.02)} 延迟发货 ${rate(m.delayed_handling_time)}（${val(m.delayed_handling_time)}） · ${flag(m.cancellations, 0.01, 0.02)} 取消 ${rate(m.cancellations)}（${val(m.cancellations)}）`,
+      ]
+    },
+  },
+  {
+    id: 'risk.todo', group: 'risk', title: '待办与时效', needs: ['claims', 'questions'], cost: { requests: 2 },
+    cadence: 'daily', default: true,
+    render: ({ d }) => {
+      const out = []
+      if (d && d.claims) out.push(`**📮 待办**：待处理纠纷 **${d.claims.total}** 条${d.claims.oldestDays != null ? `（最久 ${d.claims.oldestDays} 天）` : ''}`)
+      if (d && d.questions) out.push(`${out.length ? ' · ' : '**📮 待办**：'}未回复提问 **${d.questions.total}** 条${d.questions.oldestHours != null ? `（最久 ${d.questions.oldestHours} 小时）` : ''}`)
+      if (!out.length) {
+        const errs = (d && d.__errors) || {}
+        const why = [errs.claims, errs.questions].filter(Boolean).join(' / ')
+        return why ? [`**📮 待办**：未取到（${why}）`] : null
+      }
+      return [out.join('')]
+    },
+  },
+  {
+    id: 'risk.sla', group: 'risk', title: '发货时效', needs: ['orders', 'items', 'shipments'], cost: { requests: 'adaptive' },
+    cadence: 'daily', default: true,
+    render: ({ d }) => {
+      const sla = (d && d.sla) || null
+      if (!sla) return d && d.__errors && d.__errors.sla ? [`**🚚 发货时效**：未取到（${d.__errors.sla}）`] : null
+      if (!sla.checked) {
+        if (!sla.candidates) return sla.unknown ? [`**🚚 发货时效**：无自发货订单（另 ${sla.unknown} 单类型未知未查）`] : null
+        return [`**🚚 发货时效**：本轮未抽查（自发货 ${sla.candidates} 单 > 上限 ${sla.cap}）`]
+      }
+      const un = sla.unknown ? ` · 另 ${sla.unknown} 单类型未知未查` : ''
+      const out = [`**🚚 发货时效**：待发出 **${sla.pending}** 单 / 抽查 ${sla.checked} 单（自发货）${sla.oldestHours != null ? ` · 最久已等 ${sla.oldestHours} 小时` : ''}${un}`]
+      if (sla.pending > 10) out.push('🔴 建议今天优先处理超时发货（超 24–48h 会计入延迟发货指标）')
+      else if (sla.pending > 0) out.push('🟡 记得今天发出')
+      return out
+    },
+  },
+  {
+    id: 'sales.summary', group: 'sales', title: '昨日概览', needs: ['orders'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, store }) => {
+      const cur = money(SITE_CURRENCY[store.site] || 'USD', r.summary.gmv)
+      return [
+        `昨日订单 **${r.summary.orders}** · 销售额 **${cur}** · 已售件数 **${r.summary.units}** · 客单价 ${r.summary.avg != null ? Math.round(r.summary.avg).toLocaleString('en-US') : '—'} · 取消 ${r.summary.cancelled}${pctMark(r.summary.orders, r.prev && r.prev.summary.orders)}`,
+        // 2026-10-12（客户现场"为什么和平台差几个数"）：**追加**「数据截至 + 一行口径」。
+        // ⛔ 上面那行数字与措辞**一个字节都没改**；⛔ 不改推送目标/不新增推送。
+        // 老快照/夹具没有抓取时刻 ⇒ captureNoteLines 返回空数组 ⇒ 卡片与改动前逐字节一致。
+        ...captureNoteLines(r, SITE_TZ[fallbackSite(store.site)]),
+        '',
+      ]
+    },
+  },
+  {
+    id: 'sales.top', group: 'sales', title: '畅销榜', needs: ['orders', 'items'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, store, topN }) => {
+      const out = [`**🔥 畅销榜 Top ${Math.min(topN, r.top.length)}**（近7日）`]
+      if (!r.top.length) out.push('（近 7 日无成交）')
+      else r.top.forEach((s, i) => {
+        const days = s.days != null ? `可售≈${Math.max(0, Math.ceil(s.days))}天` : '可售 —'
+        out.push(`${i + 1}. **${skuLabel(s)}** · 7日 ${s.units7}件/${money(SITE_CURRENCY[store.site] || 'USD', s.gmv7)} · 累计已售 ${s.sold != null ? `${s.sold}件` : '—'} · 库存 ${s.avail ?? '—'} · ${days}`)
+      })
+      out.push('')
+      return out
+    },
+  },
+  {
+    id: 'sales.trend', group: 'sales', title: '每日趋势', needs: ['orders'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, store }) => {
+      const rows = (r.daily || [])
+      if (rows.length < 2) return null
+      const cur = (n) => money(SITE_CURRENCY[store.site] || 'USD', n)
+      const max = Math.max(...rows.map((x) => x.gmv), 1)
+      const bars = '▁▂▃▄▅▆▇█'
+      const spark = rows.map((x) => bars[Math.min(7, Math.floor((x.gmv / max) * 7))]).join('')
+      const best = rows.reduce((a, b) => (b.gmv > a.gmv ? b : a))
+      const worst = rows.reduce((a, b) => (b.gmv < a.gmv ? b : a))
+      return [`**📈 近 ${rows.length} 日** ${spark}　最好 ${best.date.slice(5)} ${cur(best.gmv)} · 最差 ${worst.date.slice(5)} ${cur(worst.gmv)}`]
+    },
+  },
+  {
+    id: 'structure.logistics', group: 'sales', title: '履约结构', needs: ['orders', 'items'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r }) => {
+      let fullGmv = 0, fullUnits = 0, selfGmv = 0, selfUnits = 0, unknownGmv = 0
+      const byId = r.itemLogistics || {}
+      for (const s of (r.skus7 || [])) {
+        const lt = byId[s.id]
+        if (lt === 'fulfillment') { fullGmv += s.gmv7; fullUnits += s.units7 }
+        else if (lt) { selfGmv += s.gmv7; selfUnits += s.units7 }
+        else unknownGmv += s.gmv7                      // 不在售/已下架 ⇒ 拿不到履约类型，不硬猜
+      }
+      const tot = fullGmv + selfGmv
+      if (!tot) return null
+      const pct = (x) => Math.round((x / tot) * 100)
+      const is3 = r.itemStats || {}
+      const un = unknownGmv ? ` · 未知（已下架/未取到）${Math.round((unknownGmv / (tot + unknownGmv)) * 100)}%` : ''
+      const note = is3.failed ? `（商品详情 ${is3.failed} 个未取到，已归入"未知"）` : ''
+      return [`**🚚 履约结构**（近7日 GMV）：Full **${pct(fullGmv)}%**（${fullUnits} 件） · 自发货 **${pct(selfGmv)}%**（${selfUnits} 件）${un}${note}`]
+    },
+  },
+  {
+    id: 'structure.concentration', group: 'sales', title: '销量集中度', needs: ['orders', 'items'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r }) => {
+      const rows = [...(r.skus7 || [])].sort((a, b) => b.gmv7 - a.gmv7)
+      const tot = rows.reduce((a, x) => a + x.gmv7, 0)
+      if (!tot || rows.length < 3) return null          // 1-2 个 SKU：谈不上集中度，直接不显示
+
+      const top10 = rows.slice(0, 10).reduce((a, x) => a + x.gmv7, 0)
+      const share = Math.round((top10 / tot) * 100)
+      if (rows.length < 10) return [`**🎯 集中度**：成交 SKU 仅 ${rows.length} 个（样本太少，暂不给结论）`]
+      const tone = share >= 70 ? '🔴 依赖偏高' : share >= 50 ? '🟡 尚可' : '✅ 分散健康'
+      return [`**🎯 集中度**：Top10 SKU 占近 7 日 GMV **${share}%**（${tone}）· 在售成交 SKU ${rows.length} 个`]
+    },
+  },
+  {
+    id: 'sales.movers', group: 'sales', title: '涨跌榜', needs: ['orders', 'ordersPrev', 'items'], cost: { requests: 'adaptive' },
+    cadence: 'daily', default: true,
+    render: ({ r }) => {
+      if (!r.prevSkus) return null
+      const prev = new Map(r.prevSkus.map((x) => [x.id, x]))
+      const rows = []
+      for (const s of (r.skus7 || [])) {
+        const p = prev.get(s.id)
+        const pUnits = p ? p.units7 : 0
+        const delta = s.units7 - pUnits
+        if (pUnits === 0 && s.units7 === 0) continue
+        rows.push({ sku: s.sku || s.id, units: s.units7, pUnits, delta, base: pUnits })
+      }
+      if (!rows.length) return null
+      const up = rows.filter((x) => x.delta > 0).sort((a, b) => b.delta - a.delta).slice(0, 3)
+      const down = rows.filter((x) => x.delta < 0).sort((a, b) => a.delta - b.delta).slice(0, 3)
+      const fmt = (x) => `${x.sku} ${x.pUnits}→${x.units}件(${x.delta > 0 ? '+' : ''}${x.delta})`
+      const out = []
+      if (up.length) out.push(`**🚀 涨**：${up.map(fmt).join(' · ')}`)
+      if (down.length) out.push(`**🔻 跌**：${down.map(fmt).join(' · ')}`)
+      return out.length ? [`**🔁 环比上周**（近7日 vs 前7日，件数）`, ...out] : null
+    },
+  },
+  {
+    id: 'profit.fees', group: 'profit', title: '平台费用', needs: ['orders'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, store }) => {
+      const cur = (n) => money(SITE_CURRENCY[store.site] || 'USD', n)
+      const gmv = r.summary.gmv || 0
+      const fees = r.summary.fees || 0
+      if (!gmv) return null
+      const rate = ((fees / gmv) * 100).toFixed(1)
+      const out = [`**💰 平台费用**：佣金 ${cur(fees)}（占 GMV ${rate}%）`]
+      if (r.summary.coupons) out.push(` · 优惠券 ${cur(r.summary.coupons)}`)
+      return [out.join('')]
+    },
+  },
+  {
+    id: 'profit.net', group: 'profit', title: '净收入估算', needs: ['orders'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, store }) => {
+      const cur = (n) => money(SITE_CURRENCY[store.site] || 'USD', n)
+      const gmv = r.summary.gmv || 0
+      if (!gmv) return null
+      const net = gmv - (r.summary.fees || 0) - (r.summary.coupons || 0)
+      return [`**🧾 净收入估算** ≈ ${cur(net)}（GMV − 佣金 − 优惠券；**未含运费**，运费在物流批次补）`]
+    },
+  },
+  {
+    id: 'traffic.visits', group: 'traffic', title: '流量与转化', needs: ['visits', 'orders', 'items'],
+    cost: { requests: '按 Top N（默认 20/店）' }, cadence: 'weekly', default: true,
+    render: ({ r, store, d }) => {
+      const v = (d && d.visits) || null
+      if (!v) return d && d.__errors && d.__errors.visits ? [`**👀 流量**：未取到（${d.__errors.visits}）`] : null
+      const known = Object.values(v).filter((x) => x != null)
+      if (!known.length) return null
+      const total = known.reduce((a, x) => a + x, 0)
+      const orders7 = (r.summary && r.summary.orders7) || 0
+      const cvr = total ? ((orders7 / total) * 100).toFixed(2) : '—'
+      const byId = r.itemById || {}
+      const top = Object.entries(v).filter(([, n]) => n != null && n > 0)
+        .sort((a, b) => b[1] - a[1]).slice(0, 5)
+        .map(([id, n]) => `${(byId[id] && byId[id].sku) || id} ${n}`)
+      const out = [`**👀 流量与转化**（近 7 日）：访客 **${total.toLocaleString('en-US')}**（抽查 ${known.length} 个商品） · 转化率 **${cvr}%**（${orders7} 单 / ${total} 访客）`]
+      if (top.length) out.push(`访客 Top5：${top.join(' · ')}`)
+      if (known.length < Object.keys(v).length) out.push(`⚠️ ${Object.keys(v).length - known.length} 个商品访客未取到（已从合计中剔除）`)
+      const is = r.itemStats || {}
+      if (is.failed) out.push(`⚠️ 商品详情 ${is.failed}/${is.total} 个未取到（限流等）⇒ 抽查样本偏小，重跑可补全`)
+      return out
+    },
+  },
+  {
+    id: 'traffic.zombies', group: 'traffic', title: '低效 listing', needs: ['visitsAll', 'items'],
+    cost: { requests: '全部在售商品（1 请求/个）' }, cadence: 'weekly', default: true,
+    render: ({ r, d }) => {
+      const v = (d && d.visits) || null
+      if (!v) return null
+      const byId = r.itemById || {}
+      const zero = Object.entries(v).filter(([id, n]) => n === 0 && byId[id] && byId[id].status === 'active')
+      const unknown = Object.values(v).filter((x) => x == null).length
+      const paused = d && d.paused != null ? d.paused : null
+      const out = [`**🧟 低效 listing**：7 日 **0 访客**的在售商品 **${zero.length}** 个（共抽查 ${Object.keys(v).length} 个）${paused != null ? ` · 已暂停 ${paused} 个` : ''}`]
+      const eg = zero.slice(0, 3).map(([id]) => (byId[id] && byId[id].sku) || id)
+      if (eg.length) out.push(`例：${eg.join(' · ')}　⇒ 建议重写标题/主图或下架重上`)
+      if (unknown) out.push(`⚠️ ${unknown} 个商品访客未取到（未计入 0 访客）`)
+      const is2 = r.itemStats || {}
+      if (is2.failed) out.push(`⚠️ 商品详情 ${is2.failed}/${is2.total} 个未取到（限流等）⇒ 上述"0 访客"可能漏计，重跑可补全`)
+      return out
+    },
+  },
+  {
+    id: 'traffic.priceToWin', group: 'traffic', title: '价格竞争力', needs: ['priceToWin', 'items'],
+    cost: { requests: '按 Top N（默认 20/店）' }, cadence: 'weekly', default: false,
+    render: ({ r, d }) => {
+      const p = (d && d.price) || null
+      if (!p) return null
+      const byId = r.itemById || {}
+      const rows = Object.entries(p).filter(([, x]) => x && x.target != null)
+      if (!rows.length) {
+        const n = Object.values(p).filter((x) => x && x.status === 'not_listed').length
+        return [`**🏷 价格竞争力**：本店商品未参与目录竞争（${n} 个 not_listed）⇒ 暂无价格建议`]
+      }
+      const out = [`**🏷 价格竞争力**（可获推荐位的目标价）`]
+      for (const [id, x] of rows.slice(0, 5)) {
+        const cur = x.current != null ? x.current : '—'
+        const gap = x.current != null && x.target != null ? (x.current - x.target).toFixed(2) : null
+        out.push(`· **${(byId[id] && byId[id].sku) || id}** 现价 ${cur} → 建议 ${x.target}${gap && Number(gap) > 0 ? `（差 ${gap}）` : ''} · ${x.status}${x.boosts ? ` · ${x.boosts} 项加成` : ''}`)
+      }
+      return out
+    },
+  },
+  {
+    id: 'ops.restock', group: 'ops', title: '补货提醒', needs: ['orders', 'items'], cost: { requests: 0 },
+    cadence: 'daily', default: true,
+    render: ({ r, threshold }) => {
+      const out = [`**⚠️ 补货提醒**（可售天数 < ${threshold} 天预警）`]
+      if (!r.alerts.length) out.push('✅ 今日无预警，库存健康')
+      else for (const s of r.alerts) {
+        if (s.level === 'red') out.push(`🔴 **${skuLabel(s)}**：已断货（近7日售 ${s.units7} 件）→ 建议补货 **${s.suggested} 件**`)
+        else {
+          const days = s.days != null ? `≈${Math.max(0, Math.ceil(s.days))}天` : '—'
+          out.push(`🟡 **${skuLabel(s)}**：剩 ${s.avail} 件，可售 ${days} → 建议补货 **${s.suggested} 件**`)
+        }
+      }
+      return out
+    },
+  },
+]
+
+const SECTION_BY_ID = new Map(SECTIONS.map((x) => [x.id, x]))
+
+/** 解析启用集合：命令行 --sections > 单条目开关 > 组开关/默认值。返回 Set<id>。 */
+export function resolveSections(cfg = {}, env = {}, cli = {}) {
+  if (cli.sections && cli.sections.length) return new Set(cli.sections.filter((x) => SECTION_BY_ID.has(x)))
+  const on = new Set()
+  for (const sec of SECTIONS) {
+    const norm = sec.id.replace(/[^A-Za-z0-9]/g, '_')
+    const envKey = `ML_SECTION_${norm.toUpperCase()}`
+    // 配置键统一用归一化下划线（控制台表单友好）：mlSection_risk_sla
+    // 同时兼容原始点号写法（mlSection_risk.sla），避免历史配置失效
+    let v = cfg[`mlSection_${norm}`]
+    if (v === undefined) v = cfg[`mlSection_${sec.id}`]
+    if (v === undefined) v = env[envKey]
+    if (v === undefined) {
+      const grpEnv = env[`ML_GROUP_${sec.group.toUpperCase()}`]
+      if (grpEnv !== undefined) v = grpEnv
+      else if (cfg.mlReportGroups && cfg.mlReportGroups[sec.group] !== undefined) v = cfg.mlReportGroups[sec.group]
+    }
+    if (cli.groups && cli.groups.length && !cli.groups.includes(sec.group)) v = false
+    const enabled = v === undefined ? !!sec.default : !(v === false || v === 0 || v === '0' || v === 'false')
+    if (enabled) on.add(sec.id)
+  }
+  return on
+}
+
+/** 已启用分区需要的数据类别（采集层据此**只发必要请求**）。 */
+export function neededData(enabled) {
+  const need = new Set()
+  for (const id of enabled) { const sec = SECTION_BY_ID.get(id); if (sec) for (const n of sec.needs) need.add(n) }
+  return need
+}
+
+/** 分区清单（--list-sections / 控制台 / 角色对话共用）。 */
+export function sectionCatalog(enabled) {
+  return SECTIONS.map((s) => ({
+    id: s.id, group: s.group, title: s.title, needs: s.needs, requests: (s.cost && s.cost.requests) || 0,
+    cadence: s.cadence, default: !!s.default, enabled: enabled ? enabled.has(s.id) : !!s.default,
+  }))
+}
+
+// ── 渲染：单店 Markdown 段（按注册表顺序、只渲染已启用分区）──
+export function renderStoreSection(store, r, topN, threshold, opts = {}) {
+  const enabled = opts.enabled || null
+  const lines = [`🏪 **${store.name}**（${store.site}）· ${r.date} 昨日数据`]
+  for (const sec of SECTIONS) {
+    if (enabled && !enabled.has(sec.id)) continue
+    if (r.error && sec.group !== 'sales') continue
+    const chunk = sec.render({ r, store, topN, threshold, d: (r.data || {}), opts })
+    if (chunk && chunk.length) lines.push(...chunk)
+  }
+  return lines.join('\n')
+}
+
+
+// ── 卡片 v2：折叠分区（用户 2026-09-27 决策 D）──────────────
+// 布局：**每店每天 1 张卡**（风险区常显 + 其他组折叠）+ 1 张跨店总览。
+// 注意：一律**发新卡**，不做 message patch —— 用户口径："更新卡片会让客户误会数据没更新，
+// 发新卡用户一眼就知道是新数据"。
+const GROUP_LABEL = { risk: '风险与待办', sales: '经营', profit: '利润与费用', traffic: '流量与转化', ads: '广告', ops: '库存与补货' }
+const GROUP_ORDER = ['sales', 'profit', 'traffic', 'ads', 'ops']
+
+/** 按分组把已启用分区渲染成块：{ risk: [lines], groups: [{group, lines}] }。 */
+export function renderStoreBlocks(store, r, topN, threshold, enabled, opts = {}) {
+  const byGroup = new Map()
+  const head = [`🏪 **${store.name}**（${store.site}）· ${r.date} 昨日数据`]
+  for (const sec of SECTIONS) {
+    if (enabled && !enabled.has(sec.id)) continue
+    if (r.error && sec.group !== 'sales') continue
+    let lines
+    if (opts.cached && opts.cached.has(sec.id)) {
+      const c = (r.weeklyCache || {})[sec.id]
+      lines = c && c.lines && c.lines.length ? [...c.lines, `（本组每周更新，上面是 ${c.at ? c.at.slice(0, 10) : '上次'} 的数据）`] : null
+    } else {
+      lines = sec.render({ r, store, topN, threshold, d: (r.data || {}) })
+      if (lines && lines.length && sec.cadence === 'weekly' && opts.onWeeklyRendered) opts.onWeeklyRendered(sec.id, lines)
+    }
+    if (!lines || !lines.length) continue
+    if (!byGroup.has(sec.group)) byGroup.set(sec.group, [])
+    byGroup.get(sec.group).push(...lines)
+  }
+  return {
+    head,
+    risk: byGroup.get('risk') || [],
+    groups: GROUP_ORDER.filter((g) => byGroup.has(g)).map((g) => ({ group: g, lines: byGroup.get(g) })),
+  }
+}
+
+/** 风险灯：🔴 > 🟡 > ✅ ⇒ 卡片模板色。 */
+export function riskLevel(blocks) {
+  const txt = (blocks.risk || []).join('\n')
+  if (txt.includes('🔴')) return 'red'
+  if (txt.includes('🟡')) return 'yellow'
+  return 'green'
+}
+
+/** 折叠面板：带图标 + 展开旋转，让人一眼知道能点（用户要求）。
+ *  · icon：飞书标准图标 token（默认 down-small-ccm_outlined，可用 mlFoldIcon 覆盖）
+ *  · icon_position=right、icon_expanded_angle=180 ⇒ 收起时朝下、展开时自动翻转
+ *  · 标题再补一个文字箭头作为**降级**提示（客户端若不支持标准图标，仍看得出可展开）
+ */
+export function collapsiblePanel(group, lines, opts = {}) {
+  const label = GROUP_LABEL[group] || group
+  const token = opts.foldIcon || process.env.ML_FOLD_ICON || 'down-small-ccm_outlined'
+  const mark = opts.foldMark === undefined ? '▾' : opts.foldMark   // 文字降级箭头（''=不要）
+  return {
+    tag: 'collapsible_panel',
+    expanded: false,
+    header: {
+      title: { tag: 'markdown', content: `${mark ? `${mark} ` : ''}**${label}**` },
+      icon: { tag: 'standard_icon', token, color: 'grey' },
+      icon_position: 'right',
+      icon_expanded_angle: 180,
+    },
+    elements: chunkText(lines.join('\n')).map((content) => ({ tag: 'markdown', content })),
+  }
+}
+
+/** 飞书卡片 schema 2.0（body.elements + collapsible_panel）。 */
+export function buildCardV2(title, blocks, opts = {}) {
+  const body = []
+  for (const line of blocks.head || []) body.push({ tag: 'markdown', content: line })
+  if (blocks.risk && blocks.risk.length) body.push({ tag: 'markdown', content: blocks.risk.join('\n') })
+  for (const g of blocks.groups || []) {
+    body.push(collapsiblePanel(g.group, g.lines, opts))
+  }
+  return {
+    schema: '2.0',
+    config: { wide_screen_mode: true },
+    header: { template: opts.template || 'blue', title: { tag: 'plain_text', content: title } },
+    body: { elements: body },
+  }
+}
+
+export function cardMessageV2(title, blocks, opts = {}) {
+  return { msg_type: 'interactive', card: buildCardV2(title, blocks, opts) }
+}
+
+/** 跨店总览（≥2 店时默认发；mlOverviewCard=false 可关）。 */
+export function buildOverviewBlocks(dateLabel, items) {
+  const lines = [`**跨店总览** · ${dateLabel}（昨日数据）`, '']
+  for (const x of items) {
+    const lvl = x.level === 'red' ? '🔴' : x.level === 'yellow' ? '🟡' : '✅'
+    lines.push(`${lvl} **${x.name}** · ${x.orders} 单 / ${money(x.currency, x.gmv)}${x.riskLine ? ` · ${x.riskLine}` : ''}`)
+  }
+  return { head: lines, risk: [], groups: [] }
+}
+
+// 超长内容分段（飞书卡片 markdown 元素单段上限保守取 3000 字符）
+export function chunkText(text, size = 3000) {
+  const out = []
+  let rest = text
+  while (rest.length > size) {
+    let cut = rest.lastIndexOf('\n', size)
+    if (cut <= 0) cut = size
+    out.push(rest.slice(0, cut))
+    rest = rest.slice(cut).replace(/^\n+/, '')
+  }
+  if (rest) out.push(rest)
+  return out
+}
+
+// ── 飞书 webhook 交互卡片 ─────────────────────────────────
+export function buildCardPayload(title, sections) {
+  return {
+    msg_type: 'interactive',
+    card: {
+      config: { wide_screen_mode: true },
+      header: {
+        template: 'blue',
+        title: { tag: 'plain_text', content: title },
+      },
+      elements: sections.flatMap((s) =>
+        chunkText(s).map((content) => ({ tag: 'markdown', content })),
+      ),
+    },
+  }
+}
+
+// ── 网络层：共用取数实现（本文件只注入 API 基址；实现见 lib/daily-report-core.mjs）──
+// `apiGet` / `fetchOrders` / `refreshStoreToken` 的**判断**（429 退避、token 复用 15min 阈值、
+// 轮换写回）全在共用实现里 —— 两个 CLI 一份实现，⛔ 不再有第二份。这里只做一件事：
+// 把本 CLI 的基址（历史常量 + `ML_API_BASE` 覆盖）与写回钩子（`persistStores`）注入。
+export async function apiGet(path, token, opts = {}) {
+  return coreApiGet(path, token, { ...opts, base: opts.base || apiBase() })
+}
+
+async function refreshStoreToken(env, store) {
+  return coreRefreshStoreToken(env, store, { base: apiBase(), onRotate: persistStores })
+}
+
+async function fetchOrders(token, sellerId, fromISO, toISO) {
+  return coreFetchOrders(token, sellerId, fromISO, toISO, { base: apiBase() })
+}
+
+async function fetchItems(token, userId) {
+  const map = {}
+  const ids = []
+  let failed = 0
+  let offset = 0
+  for (;;) {
+    const p = new URLSearchParams({ status: 'active', limit: '50', offset: String(offset) })
+    const d = await apiGet(`/users/${userId}/items/search?${p}`, token)
+    for (const it of d.results || []) {
+      const id = String((it && typeof it === 'object' && it.id) || it || '').trim()
+      if (id && !ids.includes(id)) ids.push(id)
+    }
+    const total = (d.paging && d.paging.total) || ids.length
+    if (ids.length >= total || ids.length >= 2000 || !(d.results || []).length) break
+    offset += 50
+  }
+  // 逐 ID 拉详情（并发 3 + 批间 80ms：**并发 5 无间隔会被限流**，中途失败的详情此前被静默丢掉 ⇒
+  // 商品表不完整 ⇒ 履约结构"未知"虚高、流量抽查样本偏小。现在既放慢也**统计失败数**）
+  for (let i = 0; i < ids.length; i += 3) {
+    await Promise.all(
+      ids.slice(i, i + 3).map(async (id) => {
+        try {
+          const it = await apiGet(
+            `/items/${id}?attributes=id,title,price,available_quantity,sold_quantity,status,shipping`,
+            token,
+          )
+          if (it && it.id) {
+            map[String(it.id)] = {
+              id: String(it.id),
+              title: it.title || '',
+              price: it.price ?? null,
+              available_quantity: it.available_quantity ?? null,
+              sold_quantity: it.sold_quantity ?? null,
+              permalink: it.permalink || '',
+              status: it.status || '',
+              // ⚠️ 必须带上 shipping：履约类型（fulfillment=Full / xd_drop_off=自发货）全靠它。
+              // 2026-09-27 踩过：这里只挑了部分字段 ⇒ logistic_type 恒为空 ⇒
+              // ① 履约结构恒显示"Full 0%"；② SLA 抽查把所有订单当自发货（300 单全部白查）。
+              shipping: it.shipping || null,
+            }
+          }
+        } catch { failed++ }                    // 单商品失败不阻塞，但要计数
+      }),
+    )
+    if (i + 3 < ids.length) await new Promise((r) => setTimeout(r, 80))
+  }
+  return { map, total: ids.length, failed }
+}
+
+// ── 快照缓存（环比 + 幂等标记）─────────────────────────────
+// 以 user_id 稳定命名（不按下标——多时区店铺在不同小时触发时下标会漂移）
+const cacheDir = () => join(DATA_HOME, 'daily-report-cache')
+// `storeKey` 由共用实现提供（对账 CLI 用同一份命名，否则两边找不到同一个快照）
+const snapshotFile = (date, store) => join(cacheDir(), `${date}-${storeKey(store)}.json`)
+const markerFile = (date, store) => join(cacheDir(), `.pushed-${date}-${storeKey(store)}`)
+
+function loadSnapshot(date, store) {
+  try { return JSON.parse(readFileSync(snapshotFile(date, store), 'utf8')) } catch { return null }
+}
+function saveSnapshot(r, store) {
+  mkdirSync(cacheDir(), { recursive: true })
+  writeFileSync(snapshotFile(r.date, store), JSON.stringify(r, null, 2) + '\n')
+}
+function alreadyPushed(date, store) { return existsSync(markerFile(date, store)) }
+function markPushed(date, store) {
+  mkdirSync(cacheDir(), { recursive: true })
+  writeFileSync(markerFile(date, store), new Date().toISOString() + '\n')
+}
+
+// ── 飞书推送 ───────────────────────────────────────────────
+function larkConfig() {
+  try {
+    const cfg = JSON.parse(readFileSync(join(DATA_HOME, 'config.json'), 'utf8'))
+    return cfg
+  } catch { return {} }
+}
+
+// 读取链：Web 配置中心 config.json（mlDaily*）→ daily-report.env（旧键）→ 默认
+export function pick(cfg, env, cfgKey, envKey, def) {
+  const v = cfg[cfgKey] ?? env[envKey]
+  return v === undefined || v === null || v === '' ? def : v
+}
+
+async function pushWebhook(url, payload) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  })
+  const body = await res.json().catch(() => ({}))
+  if (!res.ok || (body.code != null && body.code !== 0)) {
+    throw new Error(`webhook 推送失败 HTTP ${res.status}: ${JSON.stringify(body).slice(0, 300)}`)
+  }
+  return body
+}
+
+// KB-046 + 2026-08-30：日报推送统一身份角色 profile（默认 ml-daily，env LARK_PROFILE 可覆盖——
+// 客户机如无 ml-daily 独立 Bot，设 LARK_PROFILE=<主Bot profile> 即用主 Bot 身份）；webhook 降级为 fallback
+const LARK_PROFILE = process.env.LARK_PROFILE || 'ml-daily'
+const ML_DAILY_CHAT_ID = 'oc_e02401074a181e7e03610be93bed8cbd'
+
+// KB-091：告警与业务推送彻底解耦——内部运维/开发告警目标 = Argent 内部协作群
+// （09-03 事故：告警误发客户日报群 oc_d839；客户群不可承载内部技术信息）。
+// 告警 profile 默认主 Bot（cli_a93b9354c6e35cd1，可达内部群）；客户机可在 config.json
+// 配 mlDailyAlertProfile/mlDailyAlertChatId 或 env ML_DAILY_ALERT_PROFILE/ML_DAILY_ALERT_CHAT_ID 覆盖。
+const ML_DAILY_ALERT_CHAT_ID = 'oc_8ce5cbe50dd62f6df6e2c0ea92ab0bac'
+const ML_DAILY_ALERT_PROFILE = process.env.ML_DAILY_ALERT_PROFILE || 'cli_a93b9354c6e35cd1'
+
+// 2026-09-03 修复：cron 最小 PATH 无 ~/.local/bin（npm 全局 lark-cli）→ spawnSync('lark-cli')
+// ENOENT 且错误信息为空（status=null），09-01 起 Huangwei Mac mini 定时推送静默失败。
+// 三链兜底（同 poll-fulfillment.sh）：显式候选路径逐个 accessSync(X_OK)，都失败才原样交给 PATH。
+function resolveLarkCli() {
+  const home = homedir()
+  const cands = [
+    process.env.LARK_CLI || '',
+    join(home, '.local/bin/lark-cli'),
+    join(home, 'node/bin/lark-cli'),
+    '/opt/homebrew/bin/lark-cli',
+    '/usr/local/bin/lark-cli',
+  ]
+  for (const c of cands) {
+    if (!c) continue
+    try { accessSync(c, 0o1); return c } catch { /* 下一个 */ }
+  }
+  return 'lark-cli' // 最后兜底：依赖 PATH（SSH/交互环境通常可达）
+}
+const LARK_BIN = resolveLarkCli()
+// lark-cli（npm 包）shebang 为 /usr/bin/env node——最小 PATH（cron）下即使 lark-cli 用绝对路径
+// 也会因 env node 找不到而失败（2026-09-03 实测「env: node: No such file or directory」）。
+// spawn 时把 ~/.local/bin 与 ~/node/bin 注入 PATH（同 crontab PATH 行的双保险，防 crontab 被重置）。
+const LARK_ENV = {
+  ...process.env,
+  PATH: [join(homedir(), '.local/bin'), join(homedir(), 'node/bin'), process.env.PATH]
+    .filter(Boolean).join(':'),
+}
+
+function pushLark(md, chatId, profile) {
+  const r = spawnSync(LARK_BIN, ['--profile', profile, 'im', '+messages-send', '--chat-id', String(chatId), '--markdown', md, '--as', 'bot'], {
+    encoding: 'utf8',
+    timeout: 60000,
+    env: LARK_ENV,
+  })
+  if (r.status !== 0) {
+    throw new Error(`lark-cli 推送失败: ${(r.error?.message || r.stderr || r.stdout || '').slice(0, 300)}`)
+  }
+}
+
+// 2026-08-31：lark-bot 通道改发 interactive 卡片（与 webhook 卡片同构，角色化后保持卡片式）
+function pushLarkCard(card, chatId, profile) {
+  const r = spawnSync(LARK_BIN, ['--profile', profile, 'im', '+messages-send', '--chat-id', String(chatId), '--msg-type', 'interactive', '--content', JSON.stringify(card), '--as', 'bot'], {
+    encoding: 'utf8',
+    timeout: 60000,
+    env: LARK_ENV,
+  })
+  if (r.status !== 0) {
+    throw new Error(`lark-cli 卡片推送失败: ${(r.error?.message || r.stderr || r.stdout || '').slice(0, 300)}`)
+  }
+}
+
+async function pushCards(env, cards, overview) {
+  const cfg = larkConfig()
+  const chatId = pick(cfg, env, 'mlDailyChatId', 'ML_DAILY_CHAT_ID', ML_DAILY_CHAT_ID)
+  const profile = pick(cfg, env, 'mlDailyProfile', 'LARK_PROFILE', LARK_PROFILE)
+  if (!chatId) {
+    const webhook = cfg.mlDailyWebhook || env.FEISHU_WEBHOOK_URL
+    if (!webhook) throw new Error('未配置推送通道：ML_DAILY_CHAT_ID（lark-bot 身份）或 mlDailyWebhook（降级）')
+    for (const c of cards) await pushWebhook(webhook, c)          // webhook 兜底：逐卡 POST
+    if (overview) await pushWebhook(webhook, overview)
+    return 'webhook'
+  }
+  for (const c of cards) pushLarkCard(c.card, chatId, profile)     // 每店一张卡（用户决策 D）
+  if (overview) pushLarkCard(overview.card, chatId, profile)
+  return 'lark-bot-card'
+}
+
+async function notifyPushFailure(env, err) {
+  const cfg = larkConfig()
+  const text = `⚠️ **日报推送失败告警**\n时间：${new Date().toISOString()}\n错误：${String((err && err.message) || err).slice(0, 400)}`
+  // 通道1：lark-bot 告警（resolveLarkCli 三链 + PATH 注入后可达）。
+  // 目标群：env.ML_DAILY_ALERT_CHAT_ID → cfg.mlDailyAlertChatId → 内部群常量（oc_8ce5…）。
+  // profile：env.ML_DAILY_ALERT_PROFILE → cfg.mlDailyAlertProfile → 主 Bot（cli_a93b9354c6e35cd1）。
+  try {
+    const chatId = env.ML_DAILY_ALERT_CHAT_ID || (cfg && cfg.mlDailyAlertChatId) || ML_DAILY_ALERT_CHAT_ID
+    const profile = env.ML_DAILY_ALERT_PROFILE || (cfg && cfg.mlDailyAlertProfile) || ML_DAILY_ALERT_PROFILE
+    if (chatId) {
+      pushLark(text, chatId, profile)
+      console.error('[daily-report] 已通过 lark-bot 发送推送失败告警到内部群')
+      return 'lark-bot'
+    }
+  } catch (e) {
+    console.error(`✗ 告警 lark-bot 发送失败：${e.message}`)
+  }
+  // 通道2：落盘告警日志（定时巡检/人工兜底）
+  try {
+    const dir = join(DATA_DIR, 'daily-report-logs')
+    mkdirSync(dir, { recursive: true })
+    appendFileSync(join(dir, 'alert.log'), `[${new Date().toISOString()}] ${text}\n`)
+    console.error('[daily-report] 告警通道均失败，已落盘 alert.log')
+    return 'alert.log'
+  } catch {
+    /* 落盘也失败：静默（已尽力） */
+  }
+  return 'none'
+}
+
+// ── 单店采集 ───────────────────────────────────────────────
+
+
+// ── 周更分区（流量组等重型分区：每周只真算一次，其余日子用缓存）──────
+// 为什么：流量组每店要按商品逐个查访客（1店 238 个在售 ⇒ 238 请求），每天算太浪费；
+// 而"访客/转化/僵尸清单"看**周趋势**才稳定。⇒ cadence=weekly 的分区只在 mlWeeklyDay（默认周一）
+// 真算一次，其余日子直接渲染缓存（卡片上标注"（周一数据）"，不假装是今天的）。
+// 默认按**本机/部署时区**判断星期（不能写死 Asia/Shanghai：客户机在墨西哥，
+// 写死会让"周一"错一天 —— 2026-09-27 实测踩到：本机周日 17:5x 时上海已是周一）。
+export function weekdayDue(now, day, tz = process.env.ML_WEEKLY_TZ || Intl.DateTimeFormat().resolvedOptions().timeZone) {
+  const wd = new Date(now.toLocaleString('en-US', { timeZone: tz })).getDay()   // 0=周日
+  return Number(day) === wd
+}
+
+function sectionCachePath() { return join(cacheDir(), 'section-cache.json') }
+export function loadSectionCache() {
+  try { return JSON.parse(readFileSync(sectionCachePath(), 'utf8')) } catch { return {} }
+}
+function saveSectionCache(cache) {
+  try {
+    mkdirSync(cacheDir(), { recursive: true })
+    const tmp = `${sectionCachePath()}.tmp-${process.pid}`
+    writeFileSync(tmp, JSON.stringify(cache, null, 1), { mode: 0o600 })
+    renameSync(tmp, sectionCachePath())
+  } catch (e) { console.error(`[daily-report] ⚠️ 周更缓存写入失败：${e.message}`) }
+}
+
+/** 把启用集合拆成"今天要算的"与"用缓存的"（cadence=weekly 且今天不是 mlWeeklyDay）。 */
+export function splitByCadence(enabled, now, cfg = {}, env = {}) {
+  const day = Number(pick(cfg, env, 'mlWeeklyDay', 'ML_WEEKLY_DAY', 1))
+  const due = weekdayDue(now, day)
+  const active = new Set(), cached = new Set()
+  for (const id of enabled) {
+    const sec = SECTION_BY_ID.get(id)
+    if (!sec) continue
+    if (sec.cadence === 'weekly' && !due) cached.add(id)
+    else active.add(id)
+  }
+  return { active, cached, weeklyDay: day }
+}
+
+// ── 数据采集器（按 need 取数；只被"已启用分区"需要时才调用）──────
+const SHIP_PENDING_STATUS = new Set(['pending', 'handling', 'ready_to_ship'])
+
+async function mapLimit(items, limit, fn, gapMs = 120) {
+  const out = []
+  for (let i = 0; i < items.length; i += limit) {
+    // eslint-disable-next-line no-await-in-loop
+    out.push(...(await Promise.all(items.slice(i, i + limit).map(fn))))
+    if (gapMs && i + limit < items.length) await new Promise((r) => setTimeout(r, gapMs))
+  }
+  return out
+}
+
+async function collectReputation(token) {
+  const me = await apiGet('/users/me', token)
+  const rep = me.seller_reputation || {}
+  return { level_id: rep.level_id || '', power_seller_status: rep.power_seller_status || '', metrics: rep.metrics || {} }
+}
+
+async function collectClaims(token) {
+  const d = await apiGet('/post-purchase/v1/claims/search?role=seller&status=opened&limit=50', token)
+  const rows = d.data || []
+  const total = (d.paging && d.paging.total) != null ? d.paging.total : rows.length
+  const ts = rows.map((x) => Date.parse(x.date_created || '')).filter(Boolean)
+  return { total, oldestDays: ts.length ? Math.floor((Date.now() - Math.min(...ts)) / 86400000) : null }
+}
+
+async function collectQuestions(token, userId) {
+  const d = await apiGet(`/questions/search?seller_id=${userId}&status=UNANSWERED&limit=50`, token)
+  const rows = d.questions || []
+  const total = (d.paging && d.paging.total) != null ? d.paging.total : (d.total != null ? d.total : rows.length)
+  const ts = rows.map((x) => Date.parse(x.date_created || '')).filter(Boolean)
+  return { total, oldestHours: ts.length ? Math.floor((Date.now() - Math.min(...ts)) / 3600000) : null }
+}
+
+/** 发货时效：只抽查**自发货**订单（Full 单由平台揽收，卖家侧无发货 SLA）⇒ 请求量降一个数量级。 */
+async function collectSla(token, { orders, itemById, windowDays, cap }) {
+  const since = Date.now() - windowDays * 86400000
+  let unknown = 0
+  const rows = (orders || []).filter((o) => {
+    const t = Date.parse(o.date_created || '')
+    if (!t || t < since) return false
+    if (o.status === 'cancelled' || o.status === 'payment_required') return false
+    const id = String((o.order_items && o.order_items[0] && o.order_items[0].item && o.order_items[0].item.id) || '')
+    const it = itemById[id]
+    const lt = it && it.shipping && it.shipping.logistic_type
+    if (!lt) { unknown++; return false }             // 类型未知（下架/未在售）⇒ 不猜、不白查
+    return lt !== 'fulfillment'                      // 非 Full ⇒ 卖家自发货（才有发货 SLA）
+  })
+  const candidates = rows.length
+  const picked = rows.slice(0, cap)
+  const res = await mapLimit(picked, 3, async (o) => {
+    const sid = (o.shipping && o.shipping.id) || null
+    if (!sid) return null
+    try { return await apiGet(`/shipments/${sid}`, token) } catch { return null }
+  })
+  let pending = 0
+  let oldestMs = null
+  for (const sh of res) {
+    if (!sh || !sh.status) continue
+    if (SHIP_PENDING_STATUS.has(String(sh.status))) {
+      pending++
+      const t = Date.parse(sh.date_created || '')
+      if (t && (oldestMs === null || t < oldestMs)) oldestMs = t
+    }
+  }
+  return { candidates, cap, checked: picked.length, pending, unknown,
+           oldestHours: oldestMs ? Math.floor((Date.now() - oldestMs) / 3600000) : null }
+}
+
+
+/** 逐商品访客（1 请求/商品；null=取数失败，**不等于 0 访客**）。 */
+async function collectVisits(token, ids, gapMs = 100) {
+  const out = {}
+  await mapLimit(ids, 3, async (id) => {
+    try { out[id] = Number((await apiGet(`/items/${id}/visits/time_window?last=7&unit=day`, token)).total_visits || 0) }
+    catch { out[id] = null }
+  }, gapMs)
+  return out
+}
+
+/** 已暂停/已下架商品数（僵尸清单的对照项；1 请求）。 */
+async function collectPausedCount(token, userId) {
+  try {
+    const d = await apiGet(`/users/${userId}/items/search?status=paused&limit=1`, token)
+    return (d.paging && d.paging.total) != null ? d.paging.total : null
+  } catch { return null }
+}
+
+/** 价格竞争力（price_to_win v2）：只对 Top N 商品查（1 请求/商品）。 */
+async function collectPriceToWin(token, ids, gapMs = 100) {
+  const out = {}
+  await mapLimit(ids, 3, async (id) => {
+    try {
+      const p = await apiGet(`/items/${id}/price_to_win?version=v2`, token)
+      out[id] = { status: p.status || '', current: p.current_price ?? null, target: p.price_to_win ?? null,
+                  share: p.visit_share ?? null, boosts: (p.boosts || []).length }
+    } catch { out[id] = null }
+  }, gapMs)
+  return out
+}
+
+/** 按"已启用分区的 needs 并集"取数；返回 { reputation, claims, questions, sla } 中真正需要的项。 */
+async function collectExtras(env, store, token, need, ctx) {
+  const cfg = larkConfig()
+  const want = (n) => need.has(n)
+  const out = { __errors: {} }
+  const run = (name, p) => p.then((v) => { out[name] = v })
+    // 失败**必须可见**：限流(429)/权限(403) 要能在卡片上看到原因，而不是整块静默消失
+    .catch((e) => { const m = String((e && e.message) || e); out.__errors[name] = /429/.test(m) ? '限流(429)' : /403/.test(m) ? '无权限(403)' : m.slice(0, 60) })
+  const jobs = []
+  if (want('reputation')) jobs.push(run('reputation', collectReputation(token)))
+  if (want('claims')) jobs.push(run('claims', collectClaims(token)))
+  if (want('questions')) jobs.push(run('questions', collectQuestions(token, store.user_id)))
+  if (want('visits') || want('visitsAll') || want('priceToWin')) {
+    const topN = Number(pick(cfg, env, 'mlTrafficTopN', 'ML_TRAFFIC_TOP_N', 20))
+    const ranked = [...(ctx.skus || [])].sort((a, b) => b.units7 - a.units7).map((x) => x.id)
+    const activeIds = Object.keys(ctx.itemById || {})
+    const visitIds = want('visitsAll') ? activeIds : ranked.slice(0, topN)
+    if (want('visits') || want('visitsAll')) {
+      jobs.push(run('visits', collectVisits(token, visitIds)))
+      if (want('visitsAll')) jobs.push(run('paused', collectPausedCount(token, store.user_id)))
+    }
+    if (want('priceToWin')) jobs.push(run('price', collectPriceToWin(token, ranked.slice(0, topN))))
+  }
+  if (want('shipments')) {
+    const windowDays = Number(pick(cfg, env, 'mlSlaWindowDays', 'ML_SLA_WINDOW_DAYS', 2))
+    const cap = Number(pick(cfg, env, 'mlSlaMaxChecks', 'ML_SLA_MAX_CHECKS', 300))
+    jobs.push(run('sla', collectSla(token, { ...ctx, windowDays, cap })))
+  }
+  await Promise.all(jobs)
+  return out
+}
+
+async function collectStore(env, store, now, reportDate, opts = {}) {
+  // 窗口计算（站点本地自然日 + 近 7 日）与抓取时刻：共用实现（对账 CLI 用同一份口径）
+  const { site, tz, weekStart, reportStart, todayStart, prevStart } =
+    reportWindows(store.site, reportDate, now, { salesWindowDays: env.SALES_WINDOW_DAYS })
+  const token = await refreshStoreToken(env, store)
+  const needPrev = (opts.need || new Set()).has('ordersPrev')
+  const [orders, itemsRes, prevOrders] = await Promise.all([
+    fetchOrders(token, store.user_id, new Date(weekStart).toISOString(), new Date(todayStart).toISOString()),
+    fetchItems(token, store.user_id),
+    needPrev ? fetchOrders(token, store.user_id, new Date(prevStart).toISOString(), new Date(weekStart).toISOString()) : Promise.resolve(null),
+  ])
+  const itemById = itemsRes.map                       // fetchItems 现在返回 {map,total,failed}
+  const windows = { weekStartMs: weekStart, reportStartMs: reportStart, todayStartMs: todayStart }
+  const { summary, skus, daily, buyers } = aggregateOrders(orders, itemById, windows, site)
+  let prevSkus = null
+  if (prevOrders) {
+    const prevWindows = { weekStartMs: prevStart, reportStartMs: prevStart, todayStartMs: weekStart }
+    prevSkus = aggregateOrders(prevOrders, itemById, prevWindows, site).skus
+  }
+  const cfg = larkConfig()
+  const topN = Number(pick(cfg, env, 'mlDailyTopN', 'TOP_N', 5))
+  const lead = Number(pick(cfg, env, 'mlRestockLeadDays', 'RESTOCK_LEAD_DAYS', 15))
+  const buffer = Number(pick(cfg, env, 'mlRestockBufferDays', 'RESTOCK_BUFFER_DAYS', 7))
+  const { alerts, top, threshold } = computeAlerts(skus, lead, buffer, topN)
+  const dateStr = localDateStr(tz, reportDate)
+  const prev = loadSnapshot(dateStr, store)
+  const need = opts.need || new Set(['orders', 'items'])
+  const data = await collectExtras(env, store, token, need, { orders, itemById, skus })
+  const captured = capturedAtInfo(site, now)
+  return {
+    date: dateStr,
+    site,
+    name: store.name,
+    // ── 2026-10-12 新增（只新增，⛔ 不改任何既有字段名/形状）──────────────
+    // 抓取时刻（站点本地语义）+ 窗口边界：让"跟平台对不上"从争论变成可核对的事实。
+    // 老快照没有这三个字段 ⇒ 渲染优雅降级（卡片不追加那两行，见 captureNoteLines）。
+    capturedAt: captured.capturedAt,             // ISO8601 **带站点偏移**
+    capturedAtLocal: captured.capturedAtLocal,   // 站点本地 MM-DD HH:mm
+    window: windowInfo(site, reportStart, todayStart),   // {tz, from, to, fromLocal, toLocal}
+    // 抓取时用的 API 基址：只读对账工具据此重拉（引擎侧不硬编码平台域名，见 core 文件头）
+    apiBase: apiBase(),
+    summary,
+    top,
+    alerts,
+    threshold,
+    prev,
+    daily,
+    buyers,
+    prevSkus,
+    skus7: skus,
+    itemStats: { total: itemsRes.total, failed: itemsRes.failed, got: Object.keys(itemById).length },
+    itemById: Object.fromEntries(Object.entries(itemById).map(([id, it]) => {
+      const agg = skus.find((x) => x.id === id)
+      return [id, { sku: (agg && agg.sku) || it.sku || '', status: it.status || '', title: it.title || '' }]
+    })),
+    itemLogistics: Object.fromEntries(Object.entries(itemById).map(([id, it]) => [id, (it && it.shipping && it.shipping.logistic_type) || ''])),
+    data,
+    raw: { skuCount: skus.length, orderCount: orders.length },
+  }
+}
+
+// ── mock 模式（开发自测，不联网）───────────────────────────
+export function collectMock(fixture) {
+  return fixture.stores.map((s, i) => {
+    const env = fixture.env || {}
+    const cfg = fixture.cfg || {}
+    const topN = Number(pick(cfg, env, 'mlDailyTopN', 'TOP_N', 5))
+    const lead = Number(pick(cfg, env, 'mlRestockLeadDays', 'RESTOCK_LEAD_DAYS', 15))
+    const buffer = Number(pick(cfg, env, 'mlRestockBufferDays', 'RESTOCK_BUFFER_DAYS', 7))
+    const { alerts, top, threshold } = computeAlerts(
+      s.skus.map((k) => ({ ...k })),
+      lead, buffer, topN,
+    )
+    return {
+      date: fixture.reportDate,
+      site: fallbackSite(s.site),
+      name: s.name,
+      // 夹具可自带抓取时刻/窗口（预览新增两行）；不给 ⇒ 渲染优雅降级（与老快照同路）
+      capturedAt: s.capturedAt || null,
+      capturedAtLocal: s.capturedAtLocal || null,
+      window: s.window || null,
+      summary: s.summary,
+      top,
+      alerts,
+      threshold,
+      prev: s.prev || null,
+      raw: { skuCount: s.skus.length, orderCount: 0 },
+    }
+  })
+}
+
+// ── 主流程 ─────────────────────────────────────────────────
+async function main() {
+  // 进程 env 覆盖 env 文件（文件仍是部署基线；命令行临时覆盖用 process.env）
+  // 2026-09-27 修：此前只读文件 ⇒ `ML_WEEKLY_DAY=0 node daily-report.mjs` 这类临时覆盖**静默失效**，
+  // 排障时会被误判成"功能没生效"。优先级：config.json（控制台）→ process.env → 文件 → 默认。
+  const env = { ...loadEnvFile(ENV_PATH), ...process.env }
+  const cfg = larkConfig()
+  const enabled = resolveSections(cfg, env, { sections: ARG_SECTIONS, groups: ARG_GROUPS })
+  const cadence = splitByCadence(enabled, new Date(), cfg, env)
+  // 周更分区今天不算 ⇒ 不进 need ⇒ **一个请求都不发**（用上次缓存渲染）
+  const need = neededData(cadence.active)
+  if (FLAG_LIST_SECTIONS) {
+    const cat = sectionCatalog(enabled)
+    const reqs = cat.filter((x) => x.enabled).reduce((a, x) => a + (typeof x.requests === 'number' ? x.requests : 0), 0)
+    console.log(JSON.stringify({ sections: cat, enabled: [...enabled], needs: [...need],
+      weeklyDay: cadence.weeklyDay, dueToday: [...cadence.active], cachedToday: [...cadence.cached], fixedRequests: reqs }, null, 1))
+    return 0
+  }
+  console.error(`[daily-report] 启用分区 ${enabled.size}/${SECTIONS.length}：${[...enabled].join(', ')}`
+    + (cadence.cached.size ? `｜周更（用缓存，不取数）：${[...cadence.cached].join(', ')}` : '')
+    + `｜数据需求：${[...need].join(', ')}`)
+  const now = new Date()
+  const reportTime = pick(cfg, env, 'mlDailyTime', 'REPORT_TIME', '08:00')
+
+  if (MOCK_FILE) {
+    const fixture = JSON.parse(readFileSync(MOCK_FILE, 'utf8'))
+    const reports = collectMock(fixture)
+    const fxEnabled = resolveSections(fixture.cfg || {}, fixture.env || {}, { sections: ARG_SECTIONS, groups: ARG_GROUPS })
+    const sections = reports.map((r) => renderStoreSection({ name: r.name, site: r.site }, r, Number(pick(fixture.cfg || {}, fixture.env || {}, 'mlDailyTopN', 'TOP_N', 5)), r.threshold, { enabled: fxEnabled }))
+    const md = `📊 **美客多日报** · ${fixture.reportDate}（昨日数据）\n\n` + sections.join('\n\n---\n\n')
+    console.log(md)
+    return 0
+  }
+
+  let stores = null
+  try {
+    stores = JSON.parse(readFileSync(STORES_PATH, 'utf8'))
+  } catch {
+    console.error(`✗ 未找到店铺授权文件 ${STORES_PATH} —— 请先运行 node ml-oauth-setup.mjs 逐店授权`)
+    return 1
+  }
+  stores = stores.stores || []
+  STORE_LIST = stores // 供 token 轮换后原子写回（persistStores）
+  if (FLAG_LIST_STORES) {
+    console.log(JSON.stringify({ stores: stores.map((x) => ({ name: x.name, site: x.site, user_id: String(x.user_id) })) }, null, 1))
+    return 0
+  }
+  if (ARG_STORE.length) {                       // 角色对话/手工排障：只跑指定店（子串匹配，1店 → 墨西哥-1店-主账号）
+    const hit = matchStores(stores, ARG_STORE)  // 匹配判据与对账 CLI 共用同一份（matchStores）
+    if (!hit.length) {
+      console.error(`✗ --store 没匹配到店铺：${ARG_STORE.join(', ')}｜可用：${stores.map((x) => x.name).join(' / ')}`)
+      return 1
+    }
+    console.error(`[daily-report] --store 过滤：${stores.length} → ${hit.length} 家（${hit.map((x) => x.name).join('、')}）`)
+    stores = hit
+  }
+  if (!stores.length) {
+    console.error('✗ ml-api-stores.json 无已授权店铺 —— 请先运行 node ml-oauth-setup.mjs 逐店授权')
+    return 1
+  }
+
+  // 时间门控（每店按自己站点时区判断；--force 跳过）
+  // 主触发 = 站点本地推送时刻整点；错过/失败后由 gateCatchUp 在 +5h 窗口逐小时补试（幂等防重）
+  const dueStores = stores.filter((s) => {
+    if (FLAG_FORCE) return true
+    const tz = SITE_TZ[fallbackSite(s.site)]
+    if (gateDue(tz, now, reportTime)) return true
+    const reportDate = ARG_DATE ? new Date(`${ARG_DATE}T12:00:00Z`) : new Date(now.getTime() - 86400000)
+    const dateStr = localDateStr(tz, reportDate)
+    return gateCatchUp(tz, now, reportTime, alreadyPushed(dateStr, s))
+  })
+  if (!dueStores.length) {
+    console.log(`[daily-report] ${now.toISOString()} 未到推送时段（各店本地 ${reportTime} 触发），跳过`)
+    return 0
+  }
+
+  const reports = []
+  for (const [si, store] of dueStores.entries()) {
+    if (si > 0) await sleep(Number(process.env.ML_STORE_GAP_MS || 1500))   // 店与店之间留口气
+    const reportDate = ARG_DATE ? new Date(`${ARG_DATE}T12:00:00Z`) : new Date(now.getTime() - 86400000)
+    try {
+      console.error(`[daily-report] 采集 ${store.name}（${store.site}）...`) // stderr：--json 模式下 stdout 保持纯 JSON
+      const r = await collectStore(env, store, now, reportDate, { enabled, need })
+      saveSnapshot(r, store)
+      reports.push({ store, r })
+    } catch (err) {
+      console.error(`✗ 采集 ${store.name}（${store.site}）失败：${err.message}`)
+      reports.push({
+        store,
+        r: { date: '—', site: store.site, name: store.name, summary: null, top: [], alerts: [], prev: null, raw: {}, error: err.message },
+      })
+    }
+  }
+
+  const okReports = reports.filter((x) => x.r.summary)
+  if (!okReports.length) {
+    console.error('✗ 全部店铺采集失败，不推送')
+    return 1
+  }
+
+  const topN = Number(pick(cfg, env, 'mlDailyTopN', 'TOP_N', 5))
+  const sectionCache = loadSectionCache()
+  const blocksList = okReports.map(({ store, r }) => {
+    const key = storeKey(store)
+    r.weeklyCache = sectionCache[key] || {}
+    const onWeeklyRendered = (id, lines) => {
+      sectionCache[key] = sectionCache[key] || {}
+      sectionCache[key][id] = { at: new Date().toISOString(), lines }
+    }
+    return { store, r, blocks: renderStoreBlocks(store, r, topN, r.threshold, enabled, { cached: cadence.cached, onWeeklyRendered }) }
+  })
+  if (cadence.active.size) saveSectionCache(sectionCache)   // 只有真算过周更分区才写缓存
+  const dateLabel = okReports[0].r.date
+  // 按需问答（给了 --sections / --store）时，标题要能一眼看出"这是什么范围的数据"，
+  // 而不是让人以为又是一份完整日报（2026-09-27 第 4 批）。
+  const scoped = ARG_SECTIONS.length > 0 || ARG_STORE.length > 0
+  const groupLabels = [...new Set(SECTIONS.filter((x) => enabled.has(x.id)).map((x) => GROUP_LABEL[x.group] || x.group))]
+  const title = scoped
+    ? `📊 美客多 · ${groupLabels.join('/')} · ${dateLabel}`
+    : `📊 美客多日报 · ${dateLabel}（昨日数据）`
+  const failed = reports.filter((x) => !x.r.summary)
+
+  if (FLAG_DRY) {
+    const preview = blocksList.map(({ blocks }) => {
+      const parts = [...blocks.head, '', ...blocks.risk]
+      for (const g of blocks.groups) parts.push('', `［折叠］**${GROUP_LABEL[g.group] || g.group}**`, ...g.lines)
+      return parts.join('\n')
+    })
+    console.log(`\n${title}\n\n${preview.join('\n\n---\n\n')}\n`)
+    console.log(`[dry-run] 共 ${okReports.length} 家店铺（${failed.length} 家失败）｜启用分区 ${enabled.size}/${SECTIONS.length}，未推送`)
+    return 0
+  }
+
+  // KB-063：--json 模式——只生成日报卡片 JSON 输出 stdout，不推送（BOT 回复卡片用；
+  // 配合 --force 跳过时段门控/幂等；agent 执行后以 CARD:<json> 回复，脚本不再推送）
+  if (FLAG_JSON) {
+    // v2 折叠卡：每店一个块（head + 风险常显 + 其余组折叠）——工作台/角色对话共用同一形态
+    const elements = []
+    for (const { blocks } of blocksList) {
+      elements.push({ tag: 'markdown', content: blocks.head.join('\n') })
+      if (blocks.risk.length) elements.push({ tag: 'markdown', content: blocks.risk.join('\n') })
+      for (const g of blocks.groups) elements.push(collapsiblePanel(g.group, g.lines))
+    }
+    if (failed.length) elements.push({ tag: 'markdown', content: `⚠️ **数据缺失**：${failed.map((f) => `${f.store.name}（${f.r.error || '未知错误'}）`).join('；')}` })
+    const card = { schema: '2.0', config: { wide_screen_mode: true },
+                   header: { template: riskLevel(blocksList[0].blocks), title: { tag: 'plain_text', content: title } },
+                   body: { elements } }
+    console.log(JSON.stringify({ msg_type: 'interactive', card }))
+    return 0
+  }
+
+  // 幂等：非 force 时当天已推送过则跳过
+  const due = okReports.filter(({ store, r }) => FLAG_FORCE || !alreadyPushed(r.date, store))
+  if (!due.length) {
+    console.log('[daily-report] 今日已推送过（幂等标记），跳过')
+    return 0
+  }
+
+  try {
+    const cards = blocksList.map(({ store, blocks }) =>
+      cardMessageV2(`📊 美客多日报 · ${dateLabel}｜${store.name}`, blocks, { template: riskLevel(blocks) }))
+    let overview = null
+    const wantOverview = pick(cfg, env, 'mlOverviewCard', 'ML_OVERVIEW_CARD', 'true') !== 'false'
+    if (wantOverview && blocksList.length > 1) {
+      const items = blocksList.map(({ store, r, blocks }) => {
+        const riskLine = (blocks.risk.find((l) => l.includes('待办')) || '').replace(/\*\*/g, '').slice(0, 60)
+        return { name: store.name, orders: r.summary.orders, gmv: r.summary.gmv,
+                 currency: SITE_CURRENCY[store.site] || 'USD', level: riskLevel(blocks), riskLine }
+      })
+      overview = cardMessageV2(`📊 美客多日报 · ${dateLabel}｜跨店总览`, buildOverviewBlocks(dateLabel, items),
+                               { template: items.some((x) => x.level === 'red') ? 'red' : items.some((x) => x.level === 'yellow') ? 'yellow' : 'green' })
+    }
+    if (failed.length) {
+      cards.push(cardMessageV2(`⚠️ 美客多日报 · ${dateLabel}｜部分店铺未取到`, {
+        head: [`**以下店铺本轮采集失败**（其余店铺正常）`, ''],
+        risk: failed.map((f) => `🔴 **${f.store.name}**：${f.r.error || '未知错误'}`),
+        groups: [],
+      }, { template: 'yellow' }))
+    }
+    const channel = await pushCards(env, cards, overview)
+    // KB-074：--no-mark（手动 --force 测试/验证）不写幂等标记——否则白天测试会
+    // 污染当天 22:00 定时推送（幂等检查「今日已推送过」跳过，客户收不到日报）
+    if (!FLAG_NO_MARK) {
+      for (const { store, r } of due) markPushed(r.date, store)
+    }
+    console.log(`[daily-report] ✅ 日报已推送（${channel}）：${title}（${due.length} 家店铺）${FLAG_NO_MARK ? '（--no-mark 未写幂等标记）' : ''}`)
+    return 0
+  } catch (err) {
+    console.error(`✗ 推送失败：${err.message}`)
+    // KB-090：推送失败 → 飞书告警（webhook 优先/lark-bot 兜底/alert.log 落盘）
+    await notifyPushFailure(env, err).catch(() => {})
+    return 1
+  }
+}
+
+// 仅直接执行时跑主流程（import 单测时不触发）
+const isMain = isDirectRun(import.meta.url)
+if (isMain) {
+  main().then((code) => process.exit(code)).catch((err) => {
+    console.error(`✗ 异常：${err.message}`)
+    process.exit(1)
+  })
+}