直播商品角色规划

适用场景

直播前需要把候选商品分成引流款、主推款、利润款、复购款或互动款，并保留可解释的人工复核理由。

输入与输出

• - 输入：examples/input.json 同结构的脱敏商品 JSON，以及可选角色阈值。
• 输出：livestream_product_roles.json，包含商品角色、优先级、理由和人工复核项。

使用方式

1. 1. 准备商品编号、价格、毛利率、库存、近期开播转化率和是否适合讲解等字段。
2. 运行 python scripts/plan_product_roles.py --input input.json --output livestream_product_roles.json。
3. 逐项确认角色和库存口径，再把结果交给 livestream-sequence-builder。

规则与边界

价格低于候选中位数的商品优先考虑引流角色；高毛利且库存充足的商品优先考虑利润角色；转化与讲解适配度较好的商品优先考虑主推角色；标记为复购或互动的商品保留相应角色。缺字段、库存不足或指标冲突时只标记人工复核，不自动改价、上架或投放。

错误恢复

原始输入不会被覆盖。修正字段后重新运行；无法判断的商品进入 REVIEW，由运营人员决定，不以默认值代替。

验收

使用示例输入运行后，输出商品数相同、每个商品有唯一角色、缺失字段被列出，且 platform_change_executed 为 false。