sino-bc-cli 1.8.20 → 1.8.21

package/dist/skills/custom/biz-line-strategy-generate/scripts/cleanup.py

@@ -1,98 +1,87 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-"""只清理「本次请求」登记过的临时目录和 Excel。
-
-默认生成流程：Excel 落盘后不要删 request 目录（现拉回包要留着备查）。
-只有用户明确要求清缓存时才传 --request-dir。
-不会按桌面文件名 glob，也不会删除未出现在 --written-excel 里的文件。
-"""
+"""仅清理本次进程创建并登记的目录，所有类型临时文件统一处理。"""
 from __future__ import annotations
 
-import argparse
 import json
 import os
-import shutil
-import sys
-
+import stat
+import tempfile
+import uuid
+from dataclasses import dataclass
+from pathlib import Path
 
-def rm_request_dir(path: str) -> dict:
-    if not path:
-        return {"ok": False, "error": "empty --request-dir"}
-    abs_path = os.path.abspath(path)
-    if not os.path.isdir(abs_path):
-        return {"ok": True, "removed_dir": abs_path, "existed": False}
-    # 只允许删 sino-bc-strategy 下的某一层 requestId 目录，防止误传桌面/主目录
-    parent = os.path.basename(os.path.dirname(abs_path)).lower()
-    if parent != "sino-bc-strategy":
-        return {
-            "ok": False,
-            "error": "refuse: --request-dir 必须是 .../sino-bc-strategy/<requestId>",
-        }
-    shutil.rmtree(abs_path, ignore_errors=False)
-    return {"ok": True, "removed_dir": abs_path, "existed": True}
+MARKER = '.strategy-owner.json'
 
 
-def rm_extra_excels(keep: str | None, written: list[str]) -> dict:
-    keep_abs = os.path.abspath(keep) if keep else None
-    deleted = []
-    skipped = []
-    for raw in written:
-        if not raw:
-            continue
-        target = os.path.abspath(raw)
-        if keep_abs and os.path.normcase(target) == os.path.normcase(keep_abs):
-            skipped.append({"path": target, "reason": "keep"})
-            continue
-        if not os.path.isfile(target):
-            skipped.append({"path": target, "reason": "missing"})
-            continue
-        os.remove(target)
-        deleted.append(target)
-    return {"ok": True, "deleted": deleted, "skipped": skipped, "kept": keep_abs}
+def is_link(path: Path) -> bool:
+    """Windows junction 等重解析点与符号链接都不允许递归跟随。"""
+    info = path.lstat()
+    return stat.S_ISLNK(info.st_mode) or bool(getattr(info, 'st_file_attributes', 0) & 0x400)
 
 
-def main() -> int:
-    parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument(
-        "--request-dir",
-        default=None,
-        help="本次请求工作目录 TEMP/sino-bc-strategy/<requestId>，整目录删除",
-    )
-    parser.add_argument(
-        "--keep-excel",
-        default=None,
-        help="最终保留的 xlsx 绝对路径",
-    )
-    parser.add_argument(
-        "--written-excel",
-        action="append",
-        default=[],
-        help="本次请求成功写出过的 xlsx，可重复；只从这份名单里删",
-    )
-    args = parser.parse_args()
+@dataclass(frozen=True)
+class OwnedDirectory:
+    """创建时保存真实父路径与随机令牌，清理时不能只相信目录名。"""
+    path: Path
+    parent: Path
+    token: str
 
-    if not args.request_dir and not args.written_excel:
-        print(
-            json.dumps(
-                {"ok": False, "error": "至少传 --request-dir 或 --written-excel"},
-                ensure_ascii=False,
-            )
-        )
-        return 1
+    @classmethod
+    def create(cls, parent: Path, prefix: str):
+        parent = parent.resolve()
+        parent.mkdir(parents=True, exist_ok=True)
+        path = Path(tempfile.mkdtemp(prefix=prefix, dir=parent))
+        token = uuid.uuid4().hex
+        (path / MARKER).write_text(json.dumps({'token': token, 'path': str(path)}), encoding='utf-8')
+        return cls(path, parent, token)
 
-    result = {"ok": True}
-    if args.written_excel:
-        result["excels"] = rm_extra_excels(args.keep_excel, args.written_excel)
-        if result["excels"].get("ok") is False:
-            result["ok"] = False
-    if args.request_dir:
-        result["temps"] = rm_request_dir(args.request_dir)
-        if result["temps"].get("ok") is False:
-            result["ok"] = False
+    def validate(self):
+        """根目录或父路径被替换后拒绝删除，防止越界。"""
+        if is_link(self.path) or self.path.resolve() != self.path or self.path.parent.resolve() != self.parent:
+            raise ValueError(f'清理范围已变化：{self.path}')
+        marker = self.path / MARKER
+        if is_link(marker):
+            raise ValueError('所有权文件不能是链接')
+        data = json.loads(marker.read_text(encoding='utf-8'))
+        if data != {'token': self.token, 'path': str(self.path)}:
+            raise ValueError(f'所有权不匹配：{self.path}')
 
-    print(json.dumps(result, ensure_ascii=False))
-    return 0 if result["ok"] else 1
+    def cleanup(self, final: Path | None = None) -> dict:
+        """不按后缀筛选；保留可返回的失败清单，绝不静默忽略残留。"""
+        errors = []
+        try:
+            self.validate()
+            if final is not None and final.resolve().is_relative_to(self.path):
+                raise ValueError('最终 Excel 位于临时目录内，拒绝清理')
+        except Exception as exc:
+            return {'ok': False, 'residual': [{'path': str(self.path), 'error': str(exc)}]}
 
+        def remove(path):
+            try:
+                # 先 lstat 再决定删除方式；对 junction 仅解除链接自身。
+                if is_link(path):
+                    if path.is_symlink():
+                        path.unlink()
+                    else:
+                        os.rmdir(path)
+                elif path.is_dir():
+                    for child in path.iterdir():
+                        remove(child)
+                    path.rmdir()
+                else:
+                    path.unlink()
+            except Exception as exc:
+                errors.append({'path': str(path), 'error': str(exc)})
 
-if __name__ == "__main__":
-    sys.exit(main())
+        # 若某子项未能删除，留下所有权标记供诊断，不伪报清理成功。
+        for child in self.path.iterdir():
+            if child.name != MARKER:
+                remove(child)
+        if not errors:
+            remove(self.path / MARKER)
+            try:
+                self.path.rmdir()
+            except Exception as exc:
+                errors.append({'path': str(self.path), 'error': str(exc)})
+        return {'ok': not errors, 'residual': errors}

package/dist/skills/custom/biz-line-strategy-generate/scripts/cli_json.py

@@ -7,8 +7,33 @@ import json
 import os
 import shutil
 import subprocess
+import threading
+import math
+import re
+from contextlib import contextmanager
 from pathlib import Path
 
+_local = threading.local()
+
+
+@contextmanager
+def cli_context(cancel, progress):
+    """每个业务线独立传递取消信号与进度回调，不共享可变回包。"""
+    _local.cancel, _local.progress = cancel, progress
+    try:
+        yield
+    finally:
+        _local.cancel = _local.progress = None
+
+
+def report_progress(message):
+    """统一入口由协调回调串行输出；诊断脚本沿用控制台输出。"""
+    callback = getattr(_local, "progress", None)
+    if callback:
+        callback(message)
+    else:
+        print(message, flush=True)
+
 ENUM_ZH = {
     "OUTCOME_APP_PROMOTION": "应用推广",
     "OUTCOME_SALES": "销量",
@@ -73,6 +98,9 @@ def resolve_cli() -> list[str]:
     """优先 PATH 上的 sino-bc-cli；Windows 找不到时再退到 npm 全局包。"""
     found = shutil.which("sino-bc-cli")
     if found:
+        # Windows 的 cmd shim 会重新解释 JSON 中的特殊字符，直接调用同包 Node 入口。
+        if os.name == "nt" and Path(found).suffix.lower() in (".cmd", ".bat"):
+            return [shutil.which("node") or "node", str(shim_entry(Path(found)))]
         return [found]
     npm_js = (
         Path(os.environ.get("APPDATA", ""))
@@ -87,6 +115,21 @@ def resolve_cli() -> list[str]:
     raise FileNotFoundError("找不到 sino-bc-cli，请先全局安装或执行 /init")
 
 
+def shim_entry(shim: Path) -> Path:
+    """只读解析 npm/pnpm 的 Node 入口，不执行 cmd 文本或解释用户 JSON。"""
+    candidates = [shim.parent / 'node_modules/sino-bc-cli/dist/index.js']
+    content = shim.read_text(encoding='utf-8')
+    for value in re.findall(r'"([^"\r\n]*sino-bc-cli[\\/]dist[\\/]index\.js)"', content, re.I):
+        value = re.sub(r'%(?:~dp0%?|dp0%)', lambda _: str(shim.parent) + os.sep, value, flags=re.I)
+        if '%' not in value:
+            path = Path(value)
+            candidates.append(path if path.is_absolute() else shim.parent / path)
+    for entry in candidates:
+        if entry.is_file():
+            return entry.resolve()
+    raise RuntimeError('CLI shim 对应包入口不可访问或布局无法识别，请检查全局安装目录权限')
+
+
 def parse_json_text(raw: str):
     """从混有日志的文本里取出第一段 JSON。数组文件必须从 '[' 起读，不能先找 '{'。"""
     text = (raw or "").strip()
@@ -121,26 +164,37 @@ def unwrap_page(envelope: dict) -> tuple[list, int]:
         return [], 0
     if isinstance(data.get("data"), list):
         rows = data["data"]
-        return rows, int(data.get("total") or len(rows))
+        return rows, int(data["total"] if data.get("total") is not None else len(rows))
     if isinstance(data.get("result"), list):
         rows = data["result"]
-        return rows, int(data.get("total") or len(rows))
+        return rows, int(data["total"] if data.get("total") is not None else len(rows))
     return [], 0
 
 
 def exec_cli_to_file(cmd: list[str], out_path: Path) -> tuple[int, str]:
-    """CLI 回包直写文件，避免 capture_output 在沙箱里被截到约 64KB。"""
+    """两个输出流直写本次文件；取消时等待子进程退出后才允许清理。"""
     out_path.parent.mkdir(parents=True, exist_ok=True)
-    with out_path.open("w", encoding="utf-8") as f:
-        proc = subprocess.run(
-            cmd,
-            stdout=f,
-            stderr=subprocess.PIPE,
-            text=True,
-            encoding="utf-8",
-            errors="replace",
-            shell=False,
-        )
+    cancel = getattr(_local, "cancel", None)
+    if cancel and cancel.is_set():
+        raise InterruptedError("任务已取消")
+    with out_path.open("w", encoding="utf-8") as f, out_path.with_suffix(".stderr.txt").open("w", encoding="utf-8") as err:
+        proc = subprocess.Popen(cmd, stdout=f, stderr=err, shell=False)
+        try:
+            while True:
+                try:
+                    proc.wait(timeout=0.2)
+                    break
+                except subprocess.TimeoutExpired:
+                    if cancel and cancel.is_set():
+                        raise InterruptedError("任务已取消")
+        finally:
+            if proc.poll() is None:
+                proc.terminate()
+                try:
+                    proc.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+                    proc.wait()
     raw = out_path.read_text(encoding="utf-8")
     return proc.returncode, raw
 
@@ -162,6 +216,7 @@ def list_query_body(*, name: str = "", biz_id: int = 0) -> dict:
 
 
 def run_cli(args: list[str], body: dict | None, out_path: Path) -> dict:
+    out_path.parent.mkdir(parents=True, exist_ok=True)
     cmd = [*resolve_cli(), *args, "--format", "json"]
     if body is not None:
         body_path = out_path.with_name(out_path.name.replace(".out.json", ".body.json"))
@@ -170,13 +225,64 @@ def run_cli(args: list[str], body: dict | None, out_path: Path) -> dict:
         body_path.write_text(json.dumps(body, ensure_ascii=False), encoding="utf-8")
         cmd.extend(["--data", json.dumps(body, ensure_ascii=False)])
     rc, raw = exec_cli_to_file(cmd, out_path)
-    parsed = parse_json_text(raw.strip()) or {"ok": False, "error": (raw or "")[:400], "rc": rc}
-    if rc != 0:
-        parsed.setdefault("ok", False)
-        parsed.setdefault("rc", rc)
+    parsed = parse_json_text(raw.strip())
+    stderr = out_path.with_suffix(".stderr.txt").read_text(encoding="utf-8", errors="replace")
+    if not isinstance(parsed, dict) or rc != 0 or parsed.get("ok") is not True:
+        error = parse_json_text(stderr) or stderr or parsed or raw or "无有效 CLI 回包"
+        parsed = {"ok": False, "error": error, "rc": rc}
     return parsed
 
 
+def require_ok(envelope, label):
+    """失败信封不能按空数据继续生成报告。"""
+    if not isinstance(envelope, dict) or envelope.get("ok") is not True:
+        raise RuntimeError(f"{label}: {json.dumps(envelope, ensure_ascii=False)[:2000]}")
+    return envelope
+
+
+def optional_num(row, key):
+    """指标缺失与零分开，拒绝 NaN/Infinity 进入分析及 Excel。"""
+    try:
+        value = float(row.get(key))
+        return value if math.isfinite(value) else None
+    except (TypeError, ValueError):
+        return None
+
+
+def metric_value(rows, metric="CPI"):
+    """同一粒度先合计基础指标再计算，任一缺失不当作零补齐。"""
+    formulas = {"CPI": ("spend_usd", "installs", 1), "CPC": ("spend_usd", "clicks", 1),
+                "CPM": ("spend_usd", "impressions", 1000), "ROAS": ("purchase_value", "spend_usd", 1),
+                "CTR": ("clicks", "impressions", 100)}
+    a, b, scale = formulas[metric]
+    if not rows or any(optional_num(r, key) is None for r in rows for key in (a, b)):
+        return None
+    denominator = sum(optional_num(r, b) for r in rows)
+    return sum(optional_num(r, a) for r in rows) / denominator * scale if denominator > 0 else None
+
+
+def core_rule(text):
+    """只解析定义及币种明确的单一 KPI；自由文本组合目标保持不可判定。"""
+    text = (text or "").strip()
+    match = re.fullmatch(r"(CPI|CPC|CPM|ROAS|CTR)\s*(USD|美元|\$)?\s*(<=|>=|≤|≥|<|>)\s*(\d+(?:\.\d+)?)\s*(USD|美元|\$|%)?", text, re.I)
+    if match:
+        metric, currency, op, target, suffix = match.groups()
+        metric = metric.upper()
+        currency, suffix = (currency or '').upper(), (suffix or '').upper()
+        if (metric in ("CPI", "CPC", "CPM") and (currency or suffix in ("USD", "美元", "$")) and suffix != "%") or (metric == "ROAS" and not currency and not suffix) or (metric == "CTR" and not currency and suffix == "%"):
+            return {"metric": metric, "op": op, "target": float(target), "usable": True, "reason": "同口径 KPI"}
+    return {"metric": "CPI", "usable": False, "reason": "客户 KPI 不可判定：缺少明确的同币种、同转化定义或留存数据；安装 CPI 仅作观察指标"}
+
+
+def rule_hit(value, rule):
+    """仅对明确定义的 KPI 判断，缺数据不输出未达标。"""
+    if value is None or not rule.get("usable"):
+        return None
+    target, op = rule["target"], rule["op"]
+    return {"<=": value <= target, "≤": value <= target, "<": value < target,
+            ">=": value >= target, "≥": value >= target, ">": value > target}[op]
+
+
 def is_first_period(biz: dict) -> bool:
     start = str((biz or {}).get("prevPeriodStart") or "").strip()
     end = str((biz or {}).get("prevPeriodEnd") or "").strip()
@@ -373,14 +479,14 @@ def hit_kpi(v, target: float = 5.0):
     return v <= target
 
 
-def qoq_axis(curr, prev):
+def qoq_axis(curr, prev, higher_is_better=False):
     """成本类：下降为好。返回 (label, pct)。"""
     if curr is None or prev is None or prev == 0:
         return "无法对比", None
     change = (curr - prev) / prev
     if abs(change) <= 0.10:
         return "稳定", change
-    return ("变好" if change < 0 else "变差"), change
+    return ("变好" if (change > 0 if higher_is_better else change < 0) else "变差"), change
 
 
 def dual_verdict(is_hit, qoq_label: str) -> str:

package/dist/skills/custom/biz-line-strategy-generate/scripts/fetch_data.py

@@ -15,7 +15,8 @@ SCRIPTS = Path(__file__).resolve().parent
 if str(SCRIPTS) not in sys.path:
     sys.path.insert(0, str(SCRIPTS))
 
-from cli_json import list_query_body, run_cli, unwrap_page
+from cli_json import list_query_body, run_cli, unwrap_page, require_ok, report_progress
+from datetime import date
 
 # 维度/成效 size=1000 时，TikTok 出价按天明细可到 4～5 万行，旧上限 30 页会截断
 PAGE_CAP = 80
@@ -48,17 +49,23 @@ def fetch_paged(shortcut: str, base_body: dict, stem: str, bl_dir: Path) -> list
         body = {**base_body, "page": page, "size": 1000}
         out = bl_dir / f"{stem}.p{page}.out.json"
         env = run_cli(["biz-line", shortcut], body, out)
-        rows, total = unwrap_page(env)
+        require_ok(env, stem)
+        data = env.get("data")
+        if not isinstance(data, dict) or not isinstance(data.get("data"), list) or not isinstance(data.get("total"), int) or data["total"] < 0:
+            raise RuntimeError(f"{stem}: 分页信封缺少有效 data/total")
+        rows, current_total = unwrap_page(env)
+        if page > 1 and current_total != total:
+            raise RuntimeError(f"{stem}: 分页期间总数变化，请重新拉取")
+        total = current_total
         all_rows.extend(rows)
-        print(
-            f"  {stem} page={page} got={len(rows)} acc={len(all_rows)} total={total} ok={env.get('ok')}",
-            flush=True,
-        )
-        if not env.get("ok") or not rows or len(all_rows) >= total or len(rows) < 1000:
+        report_progress(f"{stem} page={page} got={len(rows)} acc={len(all_rows)} total={total}")
+        if len(all_rows) > total:
+            raise RuntimeError(f"{stem}: 累计行数超过 total")
+        if len(all_rows) == total:
             break
+        if not rows or page >= PAGE_CAP:
+            raise RuntimeError(f"{stem}: 分页不完整 {len(all_rows)}/{total}")
         page += 1
-        if page > PAGE_CAP:
-            break
     (bl_dir / f"{stem}.merged.json").write_text(
         json.dumps(all_rows, ensure_ascii=False), encoding="utf-8"
     )
@@ -75,12 +82,13 @@ CHANNEL_ALIAS = {
 
 
 def load_projects(req: Path, biz_line_id: int) -> tuple[list[str], dict[str, list[str]]]:
-    """project-list 优先；404 / 失败时退回详情的 projectNames。账号按渠道去重。"""
+    """关联项目必须查询成功，名称为空时查详情；账号按渠道去重。"""
     pl = run_cli(
         ["biz-line", "+project-list"],
         {"bizLineId": biz_line_id},
         req / "biz-line-project-list.out.json",
     )
+    require_ok(pl, "关联项目")
     rows, _ = unwrap_page(pl)
     names = [
         p.get("projectName")
@@ -107,6 +115,7 @@ def load_projects(req: Path, biz_line_id: int) -> tuple[list[str], dict[str, lis
             {"id": biz_line_id},
             req / "biz-line-detail.out.json",
         )
+        require_ok(detail, "业务线详情")
         data = detail.get("data") if isinstance(detail.get("data"), dict) else {}
         names = list(data.get("projectNames") or [])
     return names, buckets
@@ -218,11 +227,17 @@ def met_dims(ch: str) -> list[list[str]]:
     return [["objective"], ["targeting_interests"], *common]
 
 
-def main() -> int:
+def argument_parser(batch=False):
+    """单条诊断入口与批次入口共享日期和账号参数。"""
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--request-dir", required=True, help="本次 TEMP/sino-bc-strategy/<requestId>")
-    parser.add_argument("--name", default="", help="业务线名称模糊匹配")
-    parser.add_argument("--id", type=int, default=0, help="已知业务线 ID")
+    if not batch:
+        parser.add_argument("--request-dir", required=True, help="本次 TEMP/sino-bc-strategy/<requestId>")
+    target = parser.add_mutually_exclusive_group(required=True)
+    target.add_argument("--name", default="", help="业务线名称，命中多条时报歧义")
+    if batch:
+        target.add_argument("--id", type=int, action="append", default=[], help="业务线 ID，可重复传入多个")
+    else:
+        target.add_argument("--id", type=int, default=0, help="已知业务线 ID")
     parser.add_argument("--curr-start", default="")
     parser.add_argument("--curr-end", default="")
     parser.add_argument("--prev-start", default="")
@@ -230,7 +245,11 @@ def main() -> int:
     parser.add_argument("--account-fb", action="append", default=[])
     parser.add_argument("--account-gg", action="append", default=[])
     parser.add_argument("--account-tt", action="append", default=[])
-    args = parser.parse_args()
+    return parser
+
+
+def fetch_business(args):
+    """一条业务线内所有调用串行；阶段失败交由统一入口收尾。"""
 
     req = Path(args.request_dir)
     req.mkdir(parents=True, exist_ok=True)
@@ -241,16 +260,17 @@ def main() -> int:
         list_query_body(name=args.name, biz_id=args.id),
         req / "biz-line-list.out.json",
     )
-    rows, _ = unwrap_page(listed)
+    require_ok(listed, "查找业务线")
+    rows, total = unwrap_page(listed)
     if not rows:
-        print("FAIL 业务线列表为空", flush=True)
-        return 1
-    if len(rows) > 1 and not args.id:
+        raise RuntimeError("业务线列表为空")
+    if len(rows) != 1 or total != 1:
         names = "；".join(f"{r.get('id')} {r.get('name')}" for r in rows[:10])
-        print(f"FAIL 名称命中 {len(rows)} 条，请收窄：{names}", flush=True)
-        return 1
+        raise RuntimeError(f"名称命中 {total} 条，请收窄：{names}")
     biz = rows[0]
     biz_id = int(biz["id"])
+    if args.id and biz_id != args.id:
+        raise RuntimeError("返回的业务线 ID 与请求不一致")
     (req / "biz-line.json").write_text(json.dumps(biz, ensure_ascii=False, indent=2), encoding="utf-8")
 
     curr_start = args.curr_start or str(biz.get("periodStart") or "")
@@ -258,18 +278,23 @@ def main() -> int:
     prev_start = args.prev_start or str(biz.get("prevPeriodStart") or "")
     prev_end = args.prev_end or str(biz.get("prevPeriodEnd") or "")
     if not (curr_start and curr_end):
-        print("FAIL 缺少本期日期，且业务线也没有 periodStart/periodEnd", flush=True)
-        return 1
+        raise RuntimeError("缺少本期日期，且业务线也没有 periodStart/periodEnd")
     periods = {"curr": (curr_start, curr_end)}
     if prev_start and prev_end:
         periods["prev"] = (prev_start, prev_end)
+    if bool(prev_start) != bool(prev_end):
+        raise ValueError("上期起止日期必须成对提供")
+    for start, end in periods.values():
+        if date.fromisoformat(start) > date.fromisoformat(end):
+            raise ValueError("周期开始日期晚于结束日期")
 
-    run_cli(["biz-line", "+detail"], {"id": biz_id}, req / "biz-line-detail.out.json")
+    require_ok(run_cli(["biz-line", "+detail"], {"id": biz_id}, req / "biz-line-detail.out.json"), "业务线详情")
     names, discovered = load_projects(req, biz_id)
     # 用户指定账号覆盖接口返回；没指定则用项目下按 ID 去重后的账号
     for ch in accounts:
         if not accounts[ch]:
             accounts[ch] = discovered[ch]
+        accounts[ch] = list(dict.fromkeys(accounts[ch]))
     (req / "periods.json").write_text(
         json.dumps(
             {
@@ -290,15 +315,13 @@ def main() -> int:
         encoding="utf-8",
     )
     if not names and not any(accounts.values()):
-        print("SKIP 未绑定项目/广告账号", flush=True)
-        return 2
+        raise RuntimeError("未绑定项目/广告账号")
     if not any(accounts.values()):
-        print("SKIP 项目下没有 Meta/Google/TikTok 广告账号", flush=True)
-        return 2
-    print("ACCOUNTS", json.dumps(accounts, ensure_ascii=False), flush=True)
+        raise RuntimeError("项目下没有 Meta/Google/TikTok 广告账号")
 
     bl_dir = req / f"bl-{biz_id}"
     bl_dir.mkdir(parents=True, exist_ok=True)
+    manifest = {}
 
     for ch, acc in accounts.items():
         if not acc:
@@ -313,7 +336,7 @@ def main() -> int:
                     "dimensions": dims,
                     **extra,
                 }
-                fetch_paged(DIM_CMD[ch], body, stem, bl_dir)
+                manifest[stem] = len(fetch_paged(DIM_CMD[ch], body, stem, bl_dir))
             for dims in met_dims(ch):
                 stem = f"met_{ch}_{per}_{'+'.join(dims)}"
                 body = {
@@ -323,9 +346,15 @@ def main() -> int:
                     "dimensions": dims,
                     "indicators": INDICATORS,
                 }
-                fetch_paged(MET_CMD[ch], body, stem, bl_dir)
+                manifest[stem] = len(fetch_paged(MET_CMD[ch], body, stem, bl_dir))
+
+    # 只有全部所需数据完成后登记清单，汇总前按清单核对文件和数量。
+    (req / 'fetch-manifest.json').write_text(json.dumps(manifest), encoding='utf-8')
+    return biz
 
-    print("DONE", flush=True)
+
+def main() -> int:
+    fetch_business(argument_parser().parse_args())
     return 0