宝安退单回捞日报

要解决什么问题

网格退单跟进往往散落在金山文档《宝安退单回捞清单跟进》里：接口人每天要按网格筛数据、算回捞率、盯未认领工单、把认领人写回在线表，再整理文字通报和长图发邮件。手工重复且容易漏列或列映射搞错。

技能如何工作

技能把链路收成一条可配置的管线：抽取（kdocs）→ 分析（回捞率 / 未认领 / TOP10）→ 写回认领人 → 生成通报（正文 + 浅色商务风长图）→ 发邮件。

• 配置集中：网格、文档 ID、列映射、收件人都在 config.json，换网格只改配置不改代码。
• 列结构硬约束：A 列为回捞状态、E 列为负责人、G 列（或配置指定列）为网格；不匹配会直接报错，避免静默算错。
• 渐进引导：Phase 0 环境自检 → Phase 1 配置向导（先读表展示可选网格与子表）→ Phase 2 试运行 → Phase 3 可选定时；交互步骤要求用选项框确认，不让用户背字段号。
• 脚本分工：daily_pipeline.py 一键串联 extract_data.py、analyze_report.py、writeback.py；邮件由各平台 Agent 按所选方式（如 QQ 邮箱连接器或手动只出文件）发送。

适用边界与注意

• 子表需符合分公司模板列头；无法自动识别时不能自行改列映射，需更新在线模板。
• 依赖 Kdocs CLI 与授权；Linux 生成长图可能需中文字体（如 fonts-wqy-zenhei）。
• 多网格部署：复制同一套技能，为新网格生成/调整 config.json 即可，文档连接信息可复用。