sino-bc-cli 1.8.23 → 1.8.24

package/dist/skills/custom/biz-line-strategy-generate/SKILL.md

@@ -28,7 +28,7 @@ metadata:
 使用本技能目录的 **`scripts/run_workflow.py`**，不要临时重写拉数、分析或排版脚本。执行前定位技能的绝对路径；Python 只需标准库。首次使用读取 [`references/runtime.md`](references/runtime.md)。
 
 1. 用户给名称，传 `--name`；命中多个候选则返回歧义。用户给多个 ID，重复传 `--id`。用户要第一页/前 N 条，先用既有 `biz-line +list --data` 选出真实 ID，再在**一次入口调用**中传入。
-2. 入口默认最多 **3 条业务线并发**，允许 `--concurrency 1` 或 `2`，不能大于 3。同一批次不要并排启动多个入口绕开限制；单条内部 CLI 请求和分页串行。分页回包只落到本次临时目录的 `*.pN.out.json`，由脚本写 `*.pages.json` 索引；**禁止**在对话里重写拉数脚本、把各页 `extend` 进内存或再拼一份 `merged.json`。分析按页迭代，不要把全表读进 list。
+2. 入口默认最多 **3 条业务线并发**，允许 `--concurrency 1` 或 `2`，不能大于 3。同一批次不要并排启动多个入口绕开限制；单条内部 CLI 请求和分页串行。分页回包只落到本次临时目录的 `*.pN.out.json`，由脚本写 `*.pages.json` 索引；**禁止**在对话里重写拉数脚本、把各页 `extend` 进内存或再拼一份 `merged.json`。分析按页迭代，不要把全表读进 list。明细写 `details.ndjson`，出价按广告组落盘外排；不要把明细或出价快照再攒成大 list。
 3. 每条自动执行现拉 → 固定分析 → 一次性排版 → Excel 回读校验 → 发布最终文件 → 清理。默认接口周期；用户给日期时成对传 `--curr-start/--curr-end`、`--prev-start/--prev-end`。
 4. 每条成功后立即交付**该业务线自己的最终 Excel**，并删除本次其他临时产物，包括 JSON、请求/回包、日志副本、图片、临时脚本、缓存、无扩展名文件及临时 Excel，不等全部业务线结束。
 5. 失败任务返回阶段和错误摘要，清理自己的临时文件，其他业务线继续。清理失败须报告残留路径，不能声称已清理。只给实际成功返回的 `output_path` 链接；不用已删除的请求目录作交付物。
@@ -69,7 +69,8 @@ python3 -B <本技能绝对路径>/scripts/run_workflow.py --id <真实ID1> --id
 - 未绑定项目/账号不要编造。多项目仍一行，名称 `\n` 分隔。
 - 文案用中文/`display_*`；词包只写「新增/本期未出现 N 个」+ 最多 3 短词。
 - learning 第 1 层只写消耗 ≥$50 的新增。
-- CLI 回包必须直写文件（`exec_cli_to_file`），`capture_output` 会在约 64KB 截断。每页是 `stem.pN.out.json`，拉数成功才写 `stem.pages.json`；不要写全表 `merged.json`，也不要手写翻页把结果攒在内存里。翻页上限用脚本 `PAGE_CAP`（≥80），不要手写 30 页就停。
+- CLI 回包必须直写文件（`exec_cli_to_file` 只返回退出码），`capture_output` 会在约 64KB 截断。失败摘要只读文件头，不要 `read_text` 整页。每页是 `stem.pN.out.json`，拉数成功才写 `stem.pages.json`；不要写全表 `merged.json`，也不要手写翻页把结果攒在内存里。翻页上限用脚本 `PAGE_CAP`（≥80），不要手写 30 页就停。
+- `payload.json` 只记明细路径和条数，不要再嵌入全量 `details` 数组。Excel 明细表按 ndjson 流式写出，校验按行回读，不要先展开成 list 再进 SST。
 - 每条业务线只留一份最终 Excel；禁止按桌面 `业务线策略生成_*.xlsx` glob 删除。
 
 ## References

package/dist/skills/custom/biz-line-strategy-generate/references/api-flow.md

@@ -94,7 +94,7 @@ sino-bc-cli biz-line api biz-line-project-list --data '{"bizLineId": 1251}'
 
 ## 分页与数据量
 
-维度/成效接口默认每页 10 条（`size`），脚本显式 `size=1000`，按 `data.total` 翻页，上限 `PAGE_CAP=80`。每一页回包直写 `stem.pN.out.json`，全部页成功后写 `stem.pages.json`；不要把各页拼成内存全表或 `merged.json`。分析按页 yield，占比和比率一次扫描。TikTok 出价按天可达 4～5 万行，并发多条业务线时尤其不能在 Python 里 `extend` 全量。每次现拉，不要跳过已有页；最终 Excel 校验发布后立即清理该条全部临时文件。
+维度/成效接口默认每页 10 条（`size`），脚本显式 `size=1000`，按 `data.total` 翻页，上限 `PAGE_CAP=80`。每一页回包直写 `stem.pN.out.json`，全部页成功后写 `stem.pages.json`；不要把各页拼成内存全表或 `merged.json`。分析按页 yield，占比和比率一次扫描。明细写 `details.ndjson`，出价按广告组落盘外排。TikTok 出价按天可达 4～5 万行，并发多条业务线时尤其不能在 Python 里 `extend` 全量。每次现拉，不要跳过已有页；最终 Excel 校验发布后立即清理该条全部临时文件。
 
 ## 汇总到 Excel 前的数据整理
 

package/dist/skills/custom/biz-line-strategy-generate/references/output-excel.md

@@ -35,7 +35,7 @@
 
 ## 输出与校验
 
-先在本条临时目录生成一次最终样式，通过 ZIP、两张表、列名及逐单元格完整性校验后，以独占创建方式发布；再次回读验证成功才交付。最终目录必须在批次临时根外。
+先在本条临时目录生成一次最终样式：策略表走共享字符串，明细表按 `details.ndjson` 流式写出（单元格用 inlineStr），不要先把全部明细 intern 进 SST。通过 ZIP、两张表、列名及逐单元格完整性校验后，以独占创建方式发布；明细校验按行回读，再次回读验证成功才交付。最终目录必须在批次临时根外。
 
 默认最终目录为桌面 `~/Desktop`，不存在时回退用户主目录，可用 `--output-dir` 指定。文件名为 `业务线策略_<ID>_<名称>_<随机标识>.xlsx`，同名目标拒绝覆盖。
 

package/dist/skills/custom/biz-line-strategy-generate/references/runtime.md

@@ -7,9 +7,9 @@
 - 默认同时处理至多 3 条业务线，可显式设置 1 或 2。单条从查询到清理占一个名额，清理结束即补位。同一批次不能拆成多个入口绕过上限；不做跨会话全局调度。
 - 单条内部接口、渠道和分页串行；只通过已安装 `sino-bc-cli`，不手写 HTTP。
 - Windows 通过已安装 CLI 对应 Node 入口传参数数组，避免 cmd 重新解释 JSON。权限错误应报告，不当成未安装去自动下载。
-- `--format json`，请求用 `--data`。成功必须同时满足退出码 0 和信封 `ok == true`；stderr 与 stdout 都直写本次文件。
+- `--format json`，请求用 `--data`。成功必须同时满足退出码 0 和信封 `ok == true`；stderr 与 stdout 都直写本次文件。`exec_cli_to_file` 只返回退出码，不得把 stdout 再读成字符串；失败摘要只读文件头。拉数回读用 `drop_rows`，返回值里只留 `total`/行数。
 - 列表行为 `data.result`，项目为 `data` 数组，维度/成效为 `data.data` 和 `data.total`。分页 `size=1000`、`PAGE_CAP=80`；总数未取全、提前空页、失败或总数变化均中止该条，不导出部分成功文件。
-- 维度/成效每一页 MUST 直写 `bl-<id>/<stem>.pN.out.json`。拉数在内存中只保留当前页和行数累计，成功后才写 `<stem>.pages.json`（`total` / `pages` / `counts`）。开始前若已有本 stem 的 `pages.json` 必须先删掉。MUST NOT 把各页 `extend` 成全表再写 `merged.json`。汇总按 `pages.json` 逐页 yield，占比/比率/覆盖日期一次扫描，不得为分析再拼全表 list。无索引却有 `p2` 及之后页时失败。清单校验只对索引上的 `total`/`counts`，不得为校验再整表加载。失败页 MUST NOT 写下完整 `pages.json`。
+- 维度/成效每一页 MUST 直写 `bl-<id>/<stem>.pN.out.json`。拉数在内存中只保留当前页和行数累计，统计完本页行数后丢掉信封中的行 list，成功后才写 `<stem>.pages.json`（`total` / `pages` / `counts`）。开始前若已有本 stem 的 `pages.json` 必须先删掉。MUST NOT 把各页 `extend` 成全表再写 `merged.json`。汇总按 `pages.json` 逐页 yield，占比/比率/覆盖日期一次扫描，不得为分析再拼全表 list。明细逐条写 `details.ndjson`，`payload.json` 只记路径；出价按广告组落盘外排。无索引却有 `p2` 及之后页时失败。清单校验只对索引上的 `total`/`counts`，不得为校验再整表加载。失败页 MUST NOT 写下完整 `pages.json`。
 
 ## 目录归属
 
@@ -18,7 +18,7 @@
   .strategy-owner.json
   line-<业务线ID>-<随机标识>/
     .strategy-owner.json
-    请求体、stderr、分页回包 <stem>.pN.out.json、索引 <stem>.pages.json、临时 Excel
+    请求体、stderr、分页回包 <stem>.pN.out.json、索引 <stem>.pages.json、details.ndjson、出价外排、临时 Excel
 ```
 
 每次现拉，新建目录，不复用历史缓存。所有本次临时文件写入本次目录；不向技能源码树写缓存。最终 Excel 写在批次临时根以外，文件名包含业务线 ID 和随机请求标识，独占创建、不覆盖已有文件。

package/dist/skills/custom/biz-line-strategy-generate/references/spec.md

@@ -37,7 +37,7 @@
 
 ### Requirement: 分页与失败回包必须完整校验
 
-每页 CLI 回包 MUST 直写 `<stem>.pN.out.json` 并检查退出码、信封和分页总数。拉数成功后 MUST 写 `<stem>.pages.json`（含 `total`、`pages`、每页 `counts`）。拉数过程 MUST 只在内存保留当前页与行数累计，MUST NOT 将各页累积为全表 list，MUST NOT 再写一份全表 `merged.json`。汇总 MUST 按 `pages.json` 顺序逐页 yield 行；`pages.json` 缺失但存在 `p2` 及之后页文件时 MUST 失败，不得只读第一页。`share_map` / `metric_value` / 覆盖日期 / 出价快照 MUST 一次扫描完成，MUST NOT 为占比或比率把全表物化成 list。新增对象识别 MUST 只为新增行保留明细，持续对象 MUST NOT 再攒成全表。开始分析前的清单校验 MUST 只核对该索引与 manifest 的 `total`/`counts`，MUST NOT 为校验整表加载。广告/广告组命名规律 MUST 只用原始展示名，MUST NOT 把空名回退成 ID 再拆词。异常、解析失败、未到总数即遇空页、达到分页上限仍未取全，MUST 阻止该业务线生成成功报告，且 MUST NOT 写下完整 `pages.json`。CLI stderr 错误 MUST 保留到本次任务结果摘要，而非当作无数据。其他业务线 MUST 可以继续执行。
+每页 CLI 回包 MUST 直写 `<stem>.pN.out.json` 并检查退出码、信封和分页总数。`exec_cli_to_file` MUST 只返回退出码，MUST NOT 把 stdout 再读成字符串返回。`run_cli` 在失败摘要中 MUST 只读文件头部，MUST NOT 再 `read_text` 整页。JSON 解析失败 MUST NOT 把文件头之后埋着的对象当成成功回包。拉数回读 MUST 在返回前丢掉信封中的行 list，只保留 `total` 与本页行数。拉数成功后 MUST 写 `<stem>.pages.json`（含 `total`、`pages`、每页 `counts`）。拉数过程 MUST 只在内存保留当前页与行数累计，MUST NOT 将各页累积为全表 list，MUST NOT 再写一份全表 `merged.json`。汇总 MUST 按 `pages.json` 顺序逐页 yield 行；`pages.json` 缺失但存在 `p2` 及之后页文件时 MUST 失败，不得只读第一页。`share_map` / `metric_value` / 覆盖日期 / 出价快照 MUST 一次扫描完成，MUST NOT 为占比或比率把全表物化成 list。新增对象识别 MUST 只为新增行保留明细，持续对象 MUST NOT 再攒成全表。生产分析 MUST 把明细逐条写入 `details.ndjson`，`payload.json` MUST 只记路径与条数，MUST NOT 再嵌入全量明细数组。生产路径的 `bid_changes` MUST 按广告组把日快照落盘并外排序，MUST NOT 把全渠道出价快照同时留在内存 map。开始分析前的清单校验 MUST 只核对该索引与 manifest 的 `total`/`counts`，MUST NOT 为校验整表加载。广告/广告组命名规律 MUST 只用原始展示名，MUST NOT 把空名回退成 ID 再拆词。异常、解析失败、未到总数即遇空页、达到分页上限仍未取全，MUST 阻止该业务线生成成功报告，且 MUST NOT 写下完整 `pages.json`。CLI stderr 错误 MUST 保留到本次任务结果摘要，而非当作无数据。其他业务线 MUST 可以继续执行。
 
 #### Scenario: 后续页失败不导出部分结果
 - **GIVEN** 首页成功且声明仍有下一页
@@ -51,6 +51,8 @@
 - **AND** 不存在 `stem.merged.json`
 - **AND** 汇总能从页文件读出这 3 行
 - **AND** `share_map` / `metric_value` 对一次性迭代器也能得到与 list 相同的占比和比率
+- **AND** 生产分析写出 `details.ndjson`，`payload.json` 只含路径而不含明细数组
+- **AND** 同一组出价快照在落盘外排与内存路径下得到相同结果
 
 ### Requirement: 指标与周期口径固定
 
@@ -84,7 +86,7 @@
 
 ### Requirement: 每条业务线只交付一份校验通过的最终 Excel
 
-每条业务线 MUST 独立产出一份包含固定 12 列策略摘要及完整明细的 Excel。分析与排版 MUST 由固定脚本完成；正常流程 MUST 一次生成最终样式，MUST NOT 依赖 Agent 临时生成修订脚本或二次导入重排。文件发布前 MUST 检查 Excel 容器、两张表、列名及记录完整性。最终路径 MUST 位于待清理工作目录之外，名称 MUST 能区分业务线与请求，MUST NOT 覆盖已存在的其他文件。
+每条业务线 MUST 独立产出一份包含固定 12 列策略摘要及完整明细的 Excel。分析与排版 MUST 由固定脚本完成；正常流程 MUST 一次生成最终样式，MUST NOT 依赖 Agent 临时生成修订脚本或二次导入重排。导出明细表 MUST 按 ndjson 或等价迭代器流式写入，MUST NOT 先把全部明细展开成 list 再写入共享字符串表。文件发布前 MUST 检查 Excel 容器、两张表、列名及记录完整性；明细表校验 MUST 按行回读对比，MUST NOT 先 `fromstring` 整张明细表。最终路径 MUST 位于待清理工作目录之外，名称 MUST 能区分业务线与请求，MUST NOT 覆盖已存在的其他文件。
 
 #### Scenario: 并发生成不覆盖结果
 - **GIVEN** 两条业务线在同一秒完成导出
@@ -96,6 +98,11 @@
 - **WHEN** 执行发布前校验
 - **THEN** 该任务失败，不对外声明最终 Excel 已生成
 
+#### Scenario: 明细走 ndjson 导出
+- **GIVEN** 明细是两行 ndjson 文件
+- **WHEN** 导出并校验 Excel
+- **THEN** 明细表行数为 2，且不要求调用方先把文件读成 list
+
 ### Requirement: 任务结束后按归属清理全部临时产物
 
 每条业务线任务完成后，MUST 清理本次任务创建的全部非最终产物，包括但不限于 JSON、请求/响应、日志副本、预览图片、临时脚本、临时 Excel、检查文件及运行时缓存。成功时 MUST 先确认最终文件已发布且验证通过，再清理；失败时 MUST 先保存可返回的错误摘要到内存/输出，再清理其临时和不完整产物。所有任务结束后 MUST 清理本次批次共享临时目录。MUST NOT 保留额外磁盘分析报告或将已删除目录作为交付物。

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

@@ -14,16 +14,8 @@ payload.json 结构：
 {
   "output_path": "可选，未传时默认写到桌面 业务线策略生成_YYYYMMDD_HHMMSS.xlsx",
   "rows": [ { "...策略摘要行..." } ],
-  "details": [
-    {
-      "bizLine": "业务线",
-      "kind": "国家|广告组|出价|兴趣词|关键词|广告",
-      "action": "新增|本期未出现|上调|下调|当期",
-      "channel": "Meta|Google|TikTok",
-      "name": "名称",
-      "extra": "补充"
-    }
-  ]
+  "details": "details.ndjson 的路径（兼容旧调用时也可以是明细对象数组）",
+  "detail_count": 13
 }
 
 列固定为：组别、业务线、本期/上期、项目名称、
@@ -41,6 +33,7 @@ import zipfile
 import math
 import unicodedata
 import uuid
+from itertools import chain, zip_longest
 from pathlib import Path
 from xml.etree import ElementTree as ET
 from datetime import datetime
@@ -160,20 +153,13 @@ def _intern_factory():
     return intern, order
 
 
-def build_shared_strings(rows, details=None):
-    """收集策略表 + 明细表全部字符串去重。"""
+def build_strategy_strings(rows):
+    """只为策略表建 SST。明细走 inlineStr，避免把几万行广告名再进共享字符串。"""
     intern, order = _intern_factory()
     header_indices = [intern(label) for _key, label in COLUMNS]
     row_indices = [
         [intern(str(row.get(key, "") or "")) for key, _label in COLUMNS] for row in rows
     ]
-    detail_header = [intern(label) for _key, label in DETAIL_COLUMNS]
-    detail_rows = []
-    for row in details or []:
-        detail_rows.append(
-            [intern(str(row.get(key, "") or "")) for key, _label in DETAIL_COLUMNS]
-        )
-
     # XML 会把原始 CR/CRLF 归一化为 LF；用字符引用保留客户文本，保证逐字回读。
     items = "".join(
         f'<si><t xml:space="preserve">{xml_escape(text, {chr(13): "&#13;"})}</t></si>' for text in order
@@ -183,7 +169,13 @@ def build_shared_strings(rows, details=None):
         f'<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" '
         f'count="{len(order)}" uniqueCount="{len(order)}">{items}</sst>'
     )
-    return sst_xml, header_indices, row_indices, detail_header, detail_rows
+    return sst_xml, header_indices, row_indices
+
+
+def build_shared_strings(rows, details=None):
+    """兼容旧调用：策略表走 SST；明细参数忽略，导出不再把明细 intern。"""
+    sst_xml, header_indices, row_indices = build_strategy_strings(rows)
+    return sst_xml, header_indices, row_indices, [], []
 
 
 def build_sheet_xml(header_indices, row_indices, columns, content_keys=None, multiline_keys=None, values=None):
@@ -275,38 +267,148 @@ def chunks(text, width, max_lines=20):
     return result + [part] if part or not result else result
 
 
-def prepare_layout(rows, details):
-    """主表只放可见摘要，超长原文转完整明细；明细用续行保持全量。"""
-    rows = [dict(r) for r in rows]
-    details = [dict(r) for r in details or []]
-    for row in rows:
+def iter_detail_records(details):
+    """明细来源：内存 list 或 ndjson 路径。按行 yield，不把文件读成一张大表。"""
+    if details is None:
+        return
+    if isinstance(details, (str, Path)):
+        path = Path(details)
+        if not path.exists():
+            return
+        with path.open(encoding="utf-8") as handle:
+            for line in handle:
+                if line.strip():
+                    yield json.loads(line)
+        return
+    for record in details:
+        yield record
+
+
+def trim_strategy_rows(rows):
+    """主表只留可见摘要；超长原文变成「完整说明」明细。策略行很少，可在内存处理。"""
+    trimmed = [dict(row) for row in rows]
+    overflow: list[dict] = []
+    for row in trimmed:
         for key, label in COLUMNS:
-            text = str(row.get(key) or '')
-            width = COL_WIDTH_CONTENT if key in CONTENT_KEYS else (COL_WIDTH_MULTILINE if key in MULTILINE_KEYS else COL_WIDTH_DEFAULT)
+            text = str(row.get(key) or "")
+            width = COL_WIDTH_CONTENT if key in CONTENT_KEYS else (
+                COL_WIDTH_MULTILINE if key in MULTILINE_KEYS else COL_WIDTH_DEFAULT
+            )
             parts = chunks(text, width, 18)
             if len(parts) > 1:
-                details.append({'bizLine': row.get('bizLine', ''), 'kind': '完整说明', 'action': label, 'name': label, 'extra': text})
-                row[key] = parts[0] + '\n（完整内容见明细/完整说明）'
+                overflow.append(
+                    {
+                        "bizLine": row.get("bizLine", ""),
+                        "kind": "完整说明",
+                        "action": label,
+                        "name": label,
+                        "extra": text,
+                    }
+                )
+                row[key] = parts[0] + "\n（完整内容见明细/完整说明）"
+    return trimmed, overflow
+
+
+def expand_detail_record(record):
+    """单条明细按列宽拆续行。一次只处理一条，供流式写出。"""
+    split = {
+        key: chunks(
+            str(record.get(key) or ""),
+            COL_WIDTH_CONTENT if key in ("name", "extra") else COL_WIDTH_DEFAULT,
+            18,
+        )
+        for key, _ in DETAIL_COLUMNS
+    }
+    count = max(map(len, split.values()))
     expanded = []
-    for record in details:
-        split = {key: chunks(str(record.get(key) or ''), COL_WIDTH_CONTENT if key in ('name', 'extra') else COL_WIDTH_DEFAULT, 18) for key, _ in DETAIL_COLUMNS}
-        count = max(map(len, split.values()))
-        for index in range(count):
-            # 续行有行号标识，身份短字段重复展示便于筛选；长字段逐段保留。
-            row = {key: (parts[index] if index < len(parts) else (parts[0] if len(parts) == 1 and key not in ('name', 'extra') else '')) for key, parts in split.items()}
-            if count > 1:
-                row['action'] += f' [续 {index + 1}/{count}]'
-            expanded.append(row)
-    return rows, expanded
+    for index in range(count):
+        # 续行有行号标识，身份短字段重复展示便于筛选；长字段逐段保留。
+        row = {
+            key: (
+                parts[index]
+                if index < len(parts)
+                else (parts[0] if len(parts) == 1 and key not in ("name", "extra") else "")
+            )
+            for key, parts in split.items()
+        }
+        if count > 1:
+            row["action"] += f" [续 {index + 1}/{count}]"
+        expanded.append(row)
+    return expanded
+
+
+def prepare_layout(rows, details):
+    """兼容旧测试：仍返回两张表的 list。生产写 xlsx 走流式路径，不要用这个物化明细。"""
+    trimmed, overflow = trim_strategy_rows(rows)
+    expanded = []
+    for record in chain(overflow, iter_detail_records(details)):
+        expanded.extend(expand_detail_record(record))
+    return trimmed, expanded
+
+
+def _inline_t(text: str) -> str:
+    return xml_escape(str(text or ""), {chr(13): "&#13;"})
+
+
+def _local_tag(tag: str) -> str:
+    return tag.rsplit("}", 1)[-1]
+
+
+def _detail_row_xml(row_num: int, record: dict, style_id: int = 2) -> str:
+    cells = []
+    lines = 1
+    for i, (key, _) in enumerate(DETAIL_COLUMNS):
+        text = str(record.get(key) or "")
+        width = COL_WIDTH_CONTENT if key in ("name", "extra") else COL_WIDTH_DEFAULT
+        lines = max(lines, visual_lines(text, width))
+        ref = f"{col_letter(i)}{row_num}"
+        cells.append(
+            f'<c r="{ref}" s="{style_id}" t="inlineStr"><is><t xml:space="preserve">{_inline_t(text)}</t></is></c>'
+        )
+    height = 32 if row_num == 1 else min(409, max(30, lines * 15 + 10))
+    return f'<row r="{row_num}" ht="{height}" customHeight="1">{"".join(cells)}</row>'
+
+
+def write_detail_sheet(records, dest: Path) -> int:
+    """先写数据行再包 worksheet，避免先攒整张明细 XML。"""
+    body = dest.with_suffix(".body.xml")
+    count = 0
+    with body.open("w", encoding="utf-8") as handle:
+        for record in records:
+            for expanded in expand_detail_record(record):
+                count += 1
+                handle.write(_detail_row_xml(count + 1, expanded))
+    last = count + 1
+    dim = f"A1:{col_letter(len(DETAIL_COLUMNS) - 1)}{last}"
+    cols = "".join(
+        f'<col min="{i + 1}" max="{i + 1}" width="'
+        f'{COL_WIDTH_CONTENT if key in ("name", "extra") else COL_WIDTH_DEFAULT}" customWidth="1"/>'
+        for i, (key, _) in enumerate(DETAIL_COLUMNS)
+    )
+    header = _detail_row_xml(1, {key: label for key, label in DETAIL_COLUMNS}, 1)
+    with dest.open("w", encoding="utf-8") as out, body.open(encoding="utf-8") as src:
+        out.write('<?xml version="1.0" encoding="UTF-8" standalone="yes"?>')
+        out.write('<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">')
+        out.write(f'<dimension ref="{dim}"/>')
+        out.write('<sheetViews><sheetView workbookViewId="0">')
+        out.write('<pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/>')
+        out.write(f"</sheetView></sheetViews><cols>{cols}</cols><sheetData>")
+        out.write(header)
+        while True:
+            chunk = src.read(262144)
+            if not chunk:
+                break
+            out.write(chunk)
+        out.write(f'</sheetData><autoFilter ref="{dim}"/></worksheet>')
+    body.unlink(missing_ok=True)
+    return count
 
 
 def write_xlsx(rows, output_path: str, details=None) -> str:
     if not rows:
-        raise ValueError('策略数据为空')
-    rows, details = prepare_layout(rows, details)
-    sst_xml, header_indices, row_indices, detail_header, detail_rows = build_shared_strings(
-        rows, details
-    )
+        raise ValueError("策略数据为空")
+    rows, overflow = trim_strategy_rows(rows)
+    sst_xml, header_indices, row_indices = build_strategy_strings(rows)
     sheet_xml = build_sheet_xml(
         header_indices,
         row_indices,
@@ -315,50 +417,89 @@ def write_xlsx(rows, output_path: str, details=None) -> str:
         multiline_keys=MULTILINE_KEYS,
         values=rows,
     )
-    detail_xml = build_sheet_xml(
-        detail_header,
-        detail_rows,
-        DETAIL_COLUMNS,
-        content_keys={"name", "extra"},
-        multiline_keys=set(),
-        values=details,
-    )
 
     out_dir = os.path.dirname(output_path)
     if out_dir and not os.path.isdir(out_dir):
         os.makedirs(out_dir, exist_ok=True)
 
-    with zipfile.ZipFile(output_path, "x", zipfile.ZIP_DEFLATED) as zf:
-        zf.writestr("[Content_Types].xml", CONTENT_TYPES_XML)
-        zf.writestr("_rels/.rels", ROOT_RELS_XML)
-        zf.writestr("xl/workbook.xml", WORKBOOK_XML)
-        zf.writestr("xl/_rels/workbook.xml.rels", WORKBOOK_RELS_XML)
-        zf.writestr("xl/styles.xml", STYLES_XML)
-        zf.writestr("xl/sharedStrings.xml", sst_xml)
-        zf.writestr("xl/worksheets/sheet1.xml", sheet_xml)
-        zf.writestr("xl/worksheets/sheet2.xml", detail_xml)
+    sheet2_path = Path(output_path).with_name(Path(output_path).name + ".sheet2.xml")
+    try:
+        write_detail_sheet(chain(overflow, iter_detail_records(details)), sheet2_path)
+        with zipfile.ZipFile(output_path, "x", zipfile.ZIP_DEFLATED) as zf:
+            zf.writestr("[Content_Types].xml", CONTENT_TYPES_XML)
+            zf.writestr("_rels/.rels", ROOT_RELS_XML)
+            zf.writestr("xl/workbook.xml", WORKBOOK_XML)
+            zf.writestr("xl/_rels/workbook.xml.rels", WORKBOOK_RELS_XML)
+            zf.writestr("xl/styles.xml", STYLES_XML)
+            zf.writestr("xl/sharedStrings.xml", sst_xml)
+            zf.writestr("xl/worksheets/sheet1.xml", sheet_xml)
+            zf.write(sheet2_path, "xl/worksheets/sheet2.xml")
+    finally:
+        sheet2_path.unlink(missing_ok=True)
+        sheet2_path.with_suffix(".body.xml").unlink(missing_ok=True)
 
     return output_path
 
 
+def _cell_text(cell, strings, ns) -> str:
+    kind = cell.get("t")
+    if kind == "inlineStr":
+        return "".join(cell.itertext())
+    value = cell.find("s:v", ns)
+    if value is None or value.text is None:
+        return ""
+    if kind == "s":
+        return strings[int(value.text)]
+    return value.text
+
+
+def _iter_sheet_rows(archive, sheet_name, strings, ns):
+    """按行解析 worksheet，读完一行就丢掉 DOM。"""
+    with archive.open(sheet_name) as handle:
+        for _event, elem in ET.iterparse(handle, events=("end",)):
+            if _local_tag(elem.tag) != "row":
+                continue
+            cells = [child for child in elem if _local_tag(child.tag) == "c"]
+            yield [_cell_text(cell, strings, ns) for cell in cells]
+            elem.clear()
+
+
 def validate_xlsx(path, rows, details):
-    """逐单元格回读，与布局后的完整输入比较，避免只检验文件存在。"""
-    ns = {'s': 'http://schemas.openxmlformats.org/spreadsheetml/2006/main'}
-    expected = prepare_layout(rows, details)
+    """逐单元格回读。策略表可整表比对；明细表按行对比，不先展开全表。"""
+    ns = {"s": "http://schemas.openxmlformats.org/spreadsheetml/2006/main"}
+    expected_rows, overflow = trim_strategy_rows(rows)
     with zipfile.ZipFile(path) as archive:
         if archive.testzip():
-            raise ValueError('Excel ZIP 校验失败')
-        workbook = ET.fromstring(archive.read('xl/workbook.xml'))
-        if [s.attrib['name'] for s in workbook.findall('s:sheets/s:sheet', ns)] != ['策略', '明细']:
-            raise ValueError('Excel 必须包含策略和明细两张表')
-        strings = [''.join(item.itertext()) for item in ET.fromstring(archive.read('xl/sharedStrings.xml'))]
-        for index, (records, columns) in enumerate(zip(expected, (COLUMNS, DETAIL_COLUMNS)), 1):
-            sheet = ET.fromstring(archive.read(f'xl/worksheets/sheet{index}.xml'))
-            actual = [[strings[int(cell.find('s:v', ns).text)] for cell in row] for row in sheet.findall('s:sheetData/s:row', ns)]
-            target = [[label for _, label in columns]] + [[str(r.get(key) or '') for key, _ in columns] for r in records]
-            if actual != target:
-                raise ValueError(f'Excel 第 {index} 张表内容或行列数不完整')
-    return {'rows': len(expected[0]), 'details': len(expected[1])}
+            raise ValueError("Excel ZIP 校验失败")
+        workbook = ET.fromstring(archive.read("xl/workbook.xml"))
+        if [s.attrib["name"] for s in workbook.findall("s:sheets/s:sheet", ns)] != ["策略", "明细"]:
+            raise ValueError("Excel 必须包含策略和明细两张表")
+        strings = ["".join(item.itertext()) for item in ET.fromstring(archive.read("xl/sharedStrings.xml"))]
+        actual1 = list(_iter_sheet_rows(archive, "xl/worksheets/sheet1.xml", strings, ns))
+        target1 = [[label for _, label in COLUMNS]] + [
+            [str(record.get(key) or "") for key, _ in COLUMNS] for record in expected_rows
+        ]
+        if actual1 != target1:
+            raise ValueError("Excel 第 1 张表内容或行列数不完整")
+        actual2 = _iter_sheet_rows(archive, "xl/worksheets/sheet2.xml", strings, ns)
+        header = next(actual2, None)
+        if header != [label for _, label in DETAIL_COLUMNS]:
+            raise ValueError("Excel 第 2 张表内容或行列数不完整")
+        missing = object()
+        expected2 = (
+            expanded
+            for record in chain(overflow, iter_detail_records(details))
+            for expanded in expand_detail_record(record)
+        )
+        count = 0
+        for exp, act in zip_longest(expected2, actual2, fillvalue=missing):
+            if exp is missing or act is missing:
+                raise ValueError("Excel 第 2 张表内容或行列数不完整")
+            target = [str(exp.get(key) or "") for key, _ in DETAIL_COLUMNS]
+            if act != target:
+                raise ValueError("Excel 第 2 张表内容或行列数不完整")
+            count += 1
+    return {"rows": len(expected_rows), "details": count}
 
 
 def main() -> int:
@@ -387,11 +528,16 @@ def main() -> int:
 
     output_path = args.output or payload.get("output_path") or default_output_path()
     output_path = os.path.abspath(output_path)
-    details = payload.get("details") or []
-    if not isinstance(details, list):
+    details = payload.get("details")
+    if isinstance(details, str):
+        details = Path(details)
+    elif not isinstance(details, list):
         details = []
 
     write_xlsx(rows, output_path, details=details)
+    detail_count = payload.get("detail_count")
+    if not isinstance(detail_count, int):
+        detail_count = sum(1 for _ in iter_detail_records(details))
 
     print(
         json.dumps(
@@ -399,7 +545,7 @@ def main() -> int:
                 "ok": True,
                 "output_path": output_path,
                 "row_count": len(rows),
-                "detail_count": len(details),
+                "detail_count": detail_count,
             },
             ensure_ascii=False,
         )