sino-bc-cli 1.8.19 → 1.8.21

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,14 +164,59 @@ 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]:
+    """两个输出流直写本次文件；取消时等待子进程退出后才允许清理。"""
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    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
+
+
+def list_query_body(*, name: str = "", biz_id: int = 0) -> dict:
+    """+list 只接受 --data，禁止再拼 --name / --id flag。"""
+    body = {
+        "pageNum": 1,
+        "pageSize": 20,
+        "sortType": "PERIOD",
+        "sortDirection": "DESC",
+    }
+    if biz_id:
+        body["idList"] = [int(biz_id)]
+        body["pageSize"] = 10
+    elif name:
+        body["name"] = name
+    return body
+
+
 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"))
@@ -136,23 +224,205 @@ def run_cli(args: list[str], body: dict | None, out_path: Path) -> dict:
             body_path = out_path.with_suffix(".body.json")
         body_path.write_text(json.dumps(body, ensure_ascii=False), encoding="utf-8")
         cmd.extend(["--data", json.dumps(body, ensure_ascii=False)])
-    proc = subprocess.run(
-        cmd,
-        capture_output=True,
-        text=True,
-        encoding="utf-8",
-        errors="replace",
-        shell=False,
-    )
-    raw = (proc.stdout or "").strip() or (proc.stderr or "").strip()
-    out_path.write_text(raw, encoding="utf-8")
-    parsed = parse_json_text(raw) or {"ok": False, "error": raw[:400], "rc": proc.returncode}
-    if proc.returncode != 0:
-        parsed.setdefault("ok", False)
-        parsed.setdefault("rc", proc.returncode)
+    rc, raw = exec_cli_to_file(cmd, out_path)
+    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()
+    return not (start and end)
+
+
+def period_verdict(
+    *,
+    first_period: bool,
+    qoq_label: str,
+    kpi_usable: bool = False,
+    kpi_hit=None,
+) -> str:
+    """第二期结论只跟环比；KPI 未达标不能单独打成无效。首期 KPI 认不出则待观察。"""
+    if first_period:
+        if not kpi_usable:
+            return "待观察"
+        return "有效" if kpi_hit else "待观察"
+    if qoq_label == "变好":
+        return "有效"
+    if qoq_label == "变差":
+        return "待观察（预警）"
+    return "待观察"
+
+
+def is_ghost_enum(curr_share: float, prev_share: float) -> bool:
+    """两端占比都是 0 的残留枚举，不当关停动作。"""
+    return float(curr_share or 0) <= 0 and float(prev_share or 0) <= 0
+
+
+def region_bucket(name: str) -> str:
+    n = name or ""
+    if "非东南亚" in n:
+        return "other"
+    if "东南亚" in n:
+        return "sea"
+    return "other"
+
+
+def bid_adjust_stats(items: list) -> dict:
+    raise_n = lower_n = flat_n = 0
+    deltas: list[float] = []
+    details = []
+    for it in items:
+        fr = float(it.get("from") or 0)
+        to = float(it.get("to") or 0)
+        delta = to - fr
+        deltas.append(abs(delta))
+        if to > fr:
+            raise_n += 1
+            action = "上调"
+        elif to < fr:
+            lower_n += 1
+            action = "下调"
+        else:
+            flat_n += 1
+            action = "持平"
+        details.append({**it, "action": action, "delta": delta})
+    n = len(deltas)
+    if n == 0:
+        median = 0.0
+    else:
+        ordered = sorted(deltas)
+        mid = n // 2
+        median = ordered[mid] if n % 2 else (ordered[mid - 1] + ordered[mid]) / 2
+    list_all = len(items) < 10
+    return {
+        "raise_n": raise_n,
+        "lower_n": lower_n,
+        "flat_n": flat_n,
+        "median_abs": median,
+        "list_all": list_all,
+        "details": details if list_all else [],
+    }
+
+
+def budget_abs_share(
+    channel: str,
+    *,
+    prev_abs: float,
+    curr_abs: float,
+    prev_share: float,
+    curr_share: float,
+) -> str:
+    abs_delta = curr_abs - prev_abs
+    share_delta = curr_share - prev_share
+    flag = ""
+    if share_delta > 0.2 and abs_delta < -0.5:
+        flag = "；⚠️占比升但金额降"
+    elif share_delta < -0.2 and abs_delta > 0.5:
+        flag = "；⚠️占比降但金额升"
+    return (
+        f"{channel}：${prev_abs:,.0f} → ${curr_abs:,.0f}（{abs_delta:+,.0f}）；"
+        f"{prev_share:.1f}% → {curr_share:.1f}%（{share_delta:+.1f}%）{flag}"
+    )
+
+
+_NAMING_SKIP = {
+    "ios",
+    "and",
+    "android",
+    "fb",
+    "tt",
+    "gg",
+    "bid",
+    "cap",
+    "all",
+    "copy",
+    "test",
+    "测试",
+    "自制",
+    "客供",
+    "英语",
+    "英文",
+    "中文",
+    "繁中",
+    "install",
+    "smart",
+}
+
+
+def naming_patterns(names: list[str], limit: int = 5) -> str:
+    counts: dict[str, int] = {}
+    for name in names:
+        for tok in str(name or "").replace("_", "-").split("-"):
+            tok = tok.strip()
+            if not tok or tok.isdigit() or len(tok) < 2 or tok.lower() in _NAMING_SKIP:
+                continue
+            counts[tok] = counts.get(tok, 0) + 1
+    top = sorted(counts, key=lambda k: (-counts[k], k))[:limit]
+    return "、".join(top) if top else "命名规律不明显"
+
+
+def summarize_countries(countries: list[str]) -> tuple[str, list[str]]:
+    uniq = [c for c in dict.fromkeys(countries) if c]
+    if len(uniq) <= 50:
+        return f"共 {len(uniq)} 个国家", uniq
+    return f"国家超过 50 个，主页面只展示区域/大洲聚合（共 {len(uniq)} 个）", uniq
+
+
 def num(row: dict, key: str) -> float:
     v = row.get(key)
     if v in (None, "", "-"):
@@ -209,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,11 @@ SCRIPTS = Path(__file__).resolve().parent
 if str(SCRIPTS) not in sys.path:
     sys.path.insert(0, str(SCRIPTS))
 
-from cli_json import 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
 
 INDICATORS = [
     "spend_usd",
@@ -45,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 > 30:
-            break
     (bl_dir / f"{stem}.merged.json").write_text(
         json.dumps(all_rows, ensure_ascii=False), encoding="utf-8"
     )
@@ -72,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")
@@ -104,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
@@ -215,57 +227,79 @@ 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")
-    parser.add_argument("--curr-start", required=True)
-    parser.add_argument("--curr-end", required=True)
-    parser.add_argument("--prev-start", required=True)
-    parser.add_argument("--prev-end", required=True)
+    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="")
+    parser.add_argument("--prev-end", default="")
     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)
-    periods = {
-        "curr": (args.curr_start, args.curr_end),
-        "prev": (args.prev_start, args.prev_end),
-    }
     accounts = {"fb": args.account_fb, "gg": args.account_gg, "tt": args.account_tt}
 
-    list_args = ["biz-line", "+list"]
-    if args.id:
-        list_args += ["--id", str(args.id)]
-    elif args.name:
-        list_args += ["--name", args.name]
-    listed = run_cli(list_args, None, req / "biz-line-list.out.json")
-    rows, _ = unwrap_page(listed)
+    listed = run_cli(
+        ["biz-line", "+list"],
+        list_query_body(name=args.name, biz_id=args.id),
+        req / "biz-line-list.out.json",
+    )
+    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")
 
-    run_cli(["biz-line", "+detail"], {"id": biz_id}, req / "biz-line-detail.out.json")
+    curr_start = args.curr_start or str(biz.get("periodStart") or "")
+    curr_end = args.curr_end or str(biz.get("periodEnd") or "")
+    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):
+        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("周期开始日期晚于结束日期")
+
+    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(
             {
-                "curr": [args.curr_start, args.curr_end],
-                "prev": [args.prev_start, args.prev_end],
+                "curr": [curr_start, curr_end],
+                "prev": [prev_start, prev_end],
             },
             ensure_ascii=False,
             indent=2,
@@ -281,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:
@@ -304,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 = {
@@ -314,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))
 
-    print("DONE", flush=True)
+    # 只有全部所需数据完成后登记清单，汇总前按清单核对文件和数量。
+    (req / 'fetch-manifest.json').write_text(json.dumps(manifest), encoding='utf-8')
+    return biz
+
+
+def main() -> int:
+    fetch_business(argument_parser().parse_args())
     return 0