## 诊断流程样例\n\n### 场景\n\n需要把 FAQ Base 中的 `PM一级标签` 回写到多维表格。用户给的是带 `view` 参数的 Base 链接，待写标签来自本地分类结果。\n\n### 输入\n\n```bash\npython tools/bitable_label_writeback_auditor.py \\\n --base-url 'https://.../base/...?...view=vewxxx' \\\n --record-csv out/faq_label_predictions.csv \\\n --label-fields PM一级标签 \\\n --rule-file configs/pm_label_rules.yaml \\\n --dry-run-plan out/faq_pm_label_writeback_plan.json\n```\n\n### 审计步骤\n\n1. 解析 Base 链接，识别 `app_token`、`table_id`、`view_id`，并把本次范围标记为 `view`。\n2. 读取多维表格字段结构，确认 `PM一级标签` 存在且类型为单选或多选。\n3. 拉取字段枚举，发现真实枚举是 `审核`，不是截图推断的 `商品审核`。\n4. 回放规则文件：先应用治理类规则，再应用审核规则，最后应用交易规则；若 `核销` 同时命中治理和交易，以后出现的交易规则覆盖。\n5. 按最终字段值组合分组，得到 129 个唯一标签组合；每组再按 200 条记录切片，生成真实写回批次。\n6. 对比视图范围和整表范围：当前 view 内 `PM一级标签` 空值为 0，但整表仍有 4606 个空值，报告口径差异。\n\n### 成功信号\n\n```json\n{\n "enum_ok": true,\n "scope": "view",\n "records_in_input": 7000,\n "records_in_scope": 2394,\n "unique_value_groups": 129,\n "request_batches": 174,\n "blocked": false\n}\n```\n\n### 失败信号\n\n```json\n{\n "enum_ok": false,\n "blocked": true,\n "unknown_enum_values": {\n "PM一级标签": ["商品审核"]\n },\n "suggested_existing_values": {\n "PM一级标签": ["审核"]\n }\n}\n```\n\n### 落地规则\n\n审计器只生成 plan 和风险报告，不直接 update。真实写回必须读取 `dry_run_plan`，并且只有在 `blocked=false` 时才允许执行。