📊 营销效能与转化报表生成 (stat_generator) 操作指南

1. 功能整体描述与核心价值

• 功能概述：系统针对海量群发、私信、拉群任务生成的执行数据库，进行多维交叉统计与商业可视化报表提炼。
• 实现功能：
  • 自动读取指定任务数据库并计算总推送量、净到达量、失败熔断量；
  • 提取高价值成功转化名单（only_send_done / only_invite_done）；
  • 统计账号矩阵中各个账号的贡献度、单位成本与损耗比；
  • 导出标准的 Excel / CSV 商业汇报报表。
• 核心优点：
  • ROI 一目了然：让每一次出海营销投放都有精准的数据支撑；
  • 沉淀二次营销资产：将成功触达过的客户自动提取为“高意向一级私域资产池”。

2. 界面功能全景图

3. 输入参数字典与控制开关深度说明

表 1：输入参数清单

字段 / 控件 ID	界面显示名	数据类型	默认值	推荐配置	字段深度业务逻辑与说明
file_db	任务数据源路径	字符串	空	任务 DB 文件	指定需要进行报表分析的 SQLite 数据库绝对路径

表 2：控制开关深度说明

开关控件 ID	界面开关名	默认状态	说明与使用建议
only_send_done	仅导出私信成功名单	开启	过滤掉因对方被封或网络超时失败的数据，仅提取真正成功接收的客户
only_invite_done	仅导出拉群成功名单	开启	提取已被顺利加入群组的名单，便于后续群内定向艾特与活动破冰

4. 推荐标准操作流程 (SOP)

1. 第一步：选择刚刚执行完毕的发信或拉群任务生成的 .db 数据库文件。
2. 第二步：勾选 only_send_done，点击“生成效能分析报告”。
3. 第三步：在弹出的报表中查看总触达率，并一键下载纯净客户名单。