核心用法
q-erp 是面向跨境电商卖家的智能经营分析工具，用户可通过自然语言对话实时获取ERP核心经营数据。支持三类查询模式：
1. 自由经营问答（`erp.analytics.ask`）：开放式诊断，如"今天生意怎么样""为什么利润下滑""Shopee为什么掉了"，系统自动分析多维度数据并给出归因建议与行动建议。
2. 固定场景快报（`erp.management.boss.briefing` / `erp.management.today.summary`）：一键生成老板经营简报或今日核心指标快照。
3. *多维度战绩与趋势（`erp.sales.record. / erp.product.` / `erp.sales.trend.seven_day`）*：按平台、站点、店铺、店铺组、店铺负责人、商品等维度查看销售排行，或分析七日走势与增长潜力。
所有查询均通过q-claw工具实时调用千易ERP后端，禁止编造数据。
显著优点
- 自然语言交互：支持中英文口语化提问，自动识别省略追问（如"昨天呢""店铺呢"）并补全上下文
- 智能归因诊断：不仅呈现数据，更主动分析"为什么掉了""谁在拉动""哪边拖后腿"
- 多维度穿透：从全局到单品，从平台到负责人，支持灵活下钻分析
- 利润估算能力：在数据可用范围内提供毛利估算，区分"销售额诊断"与"利润诊断"
- 实时授权集成：OAuth过期时自动提供可点击授权链接，保障数据安全访问
潜在缺点与局限性
- 一期范围限制：仅支持查询类场景，不支持创建/修改单据、审批、回写等写入操作
- 时间参数依赖后端：历史日期查询（昨日、上周等）的结果以后端实际返回为准，可能存在数据口径限制
- 利润数据覆盖度：毛利估算依赖后端数据接入情况，部分场景可能返回数据缺口提示
- 场景开通状态：部分分析场景可能因租户配置未开通而不可用
- 无历史对话复用：每轮查询必须基于本轮
q-claw返回，禁止基于历史轮次结论回答
适合人群
- 跨境电商企业老板/高管：需要快速掌握全局经营态势，关注利润与异常归因
- 运营负责人：需要按平台、站点、店铺、负责人维度监控业绩，定位问题店铺
- 商品运营：需要识别热销品、爆品、增长潜力品，优化选品与库存策略
- 数据分析师：需要结构化经营数据支持深度分析（需结合后端原始数据）
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据授权风险 | ERP数据敏感，存在`AUTH_REQUIRED`/`AUTH_EXPIRED`场景 | 强制输出可点击授权链接，引导用户完成OAuth |
| 数据有效性风险 | 商品核心标识字段缺失导致结果不可读 | 按规则降级处理，不展示无效商品项 |
| 归因准确性风险 | 智能诊断结论依赖后端算法与数据完整度 | 明确标注数据来源，数据缺口时仅给排查建议 |
| 语义理解偏差 | 用户口语化追问（如"那怎么办"）可能被误路由 | 多轮规则强制延续上一轮scene，禁止无依据切换 |
| 内部信息泄露风险 | 可能暴露scene code、技能文档、路由过程 | 输出层强制过滤所有内部标识，只展示本地化业务名 |
安全等级：S（企业级ERP数据接入，具备完善授权机制与数据有效性校验）
来源可信度：T1（官方千易ERP产品能力，企业SaaS级数据源）