泽洋电商经营报表大师 Free
产品名称：泽洋电商经营报表大师 Free
英文名称：ZeYang Ecommerce Report Master Free
适用场景
当用户希望分析订单表、整理销售报表、查看销售趋势、进行商品排行、生成基础经营报表或创建基础销售经营驾驶舱时使用本 Skill。
产品定位：将电商订单 Excel / CSV 自动整理成基础销售经营分析和可视化报表（Dashboard）。
能力范围与边界
- 输入通常为一份订单文件，默认支持
.xlsx和.csv。 .xls需要可选依赖xlrd>=2.0，不是默认安装的依赖。- 建议至少包含
date、order_id和sales_amount字段。如果表头不同，只使用高置信度字段映射；绝不强行使用低置信度映射。对于实收金额等含义不明确的字段，应请用户确认。 - 在数据支持的情况下，本版本可回答销售额、订单数、客单价、销量、商品排行、销售变化和销售高峰日期。如果没有
quantity字段，应将销量标记为不可用，不能把订单行数当作准确销量。 - 本版本不提供退款经营分析、利润分析、成本分析、广告分析、ROAS、流量转化、经营评分、完整异常诊断或高级老板模式。如果用户询问这些内容，必须原样回复：
当前 Free 版不包含该分析能力。不得编造结果。 - 对于“帮我算广告 ROAS”这一边界场景，回复：
当前 Free 版不包含该分析能力。，不得生成广告分析结果。 - 如果同时提供了退款、成本、广告或流量文件，不得报错或声称完成完整分析。应回复：
检测到退款 / 成本 / 广告 / 流量数据，当前 Free 版本未将这些数据纳入分析。 - 只报告数据能够支持的事实，不得仅根据订单数据推断利润健康度、广告效率、经营风险或投资/行动建议。
执行流程
- 识别用户任务并执行 Free 版边界控制。
- 读取上传的订单文件，识别字段并报告数据质量问题。
- 只应用高置信度字段映射，然后清洗订单数据。
- 执行基础销售、商品和趋势分析。
- 生成基础经营驾驶舱、Excel 工作簿和事实型经营总结。
请使用包根目录中的真实入口命令：
python scripts/run_free.py --input orders=examples/sample_orders.csv --output-dir outputs/free
只有在需要时才重复使用 --input。可以通过 --query "帮我分析这份电商订单表" 传入可选的自然语言上下文。依赖包括 pandas、numpy 和 openpyxl。官方 CLI 不需要 Node.js、@oai/artifact-tool、ZEYANG_ARTIFACT_TOOL 或 ZEYANG_NODE。默认不会覆盖已有输出目录；确需替换时请显式使用 --overwrite。仅在诊断时使用 --debug，诊断文件会写入 .debug/。遇到无法读取的文件、缺少必要字段、日期或金额无法解析、数据为空等情况时，应使用用户能理解的语言说明，不要直接暴露原始 traceback。
输出内容
默认工作簿为 泽洋电商经营报表_Free.xlsx，当前实现会写入以下工作表：
经营驾驶舱销售趋势商品分析数据质量报告
命令还会在指定输出目录下写入 analysis.json、mapping.json 和 经营总结.txt。不得声称存在实际未生成的工作表或 Pro 分析能力。
