01它能帮你做什么
✓活动配置模板
✓分阶段数据加工
✓HTML 可视化报告模板
✓结果导出与对比组织
使用前准备
- Python 与项目依赖
- 符合配置约定的示例数据
- 自行确认的活动规则与指标定义
02从这里开始
复制配置模板
参考公开包中的 config/example.yaml 建立自己的配置，写明活动周期、字段和指标口径。
先用虚构输入
S1 取数依赖未随公开包提供的专用认证模块。先阅读后续脚本，准备符合 S1 输出结构的虚构 JSON；CSV 样例只解释字段，不能直接充当完整输入。
python scripts/s2_process_data.py --help按阶段核对
依次检查清洗、分组和汇总结果，再进入报告生成及导出阶段；命令参数以各脚本帮助为准。
审阅报告
核对图表单位、分母和筛选范围。涉及规则评价时同时说明样本与数据缺口。
03用一个例子看明白
案例使用示例或虚构数据，用于说明流程，不代表真实业务效果。
04获取文件
选择需要的文件。固定版本保留原始内容，可用校验值确认下载完整性。
incentive-analysis-2026.10.22-source.zip
查看 SHA256 校验值
ff20143fec68366a1305deca9599595f1cb819b874f0185e9e0e97fb6154b604incentive-analysis-2026.10.22-examples.zip
查看 SHA256 校验值
461803c1bade228deadd0d5d1aae5a9f5fac06bff92fc07b845d2b8ca5bc2712源代码和模板参考包，不含真实活动报告与投稿明细；S1 还需要外部认证模块，本地处理依赖已整理，不能视为完整自带数据流水线。
05你可能会遇到的问题
必须连接线上接口吗？
不必从真实取数开始，先用符合结构的虚构输入验证加工与报告更容易定位问题。
能直接套用任何激励方案吗？
需要调整配置和指标逻辑，特别是封顶、阶梯或多条件规则。
06适用范围与当前限制
- 真实活动取数依赖部署者的授权与接口环境。
- 未用真实业务数据复算，本页示例仅解释流程。
- S1 依赖未打包的外部认证模块；完整流水线需要补齐相应环境。
本页资料整理于 2026-10-22。这不是运行兼容性验证日期。下载包有完整性校验；依赖外部系统的真实操作，请按所需权限和环境使用。