dalongxia/remote_sync/README_SQL_TEMPLATES.remote.md

销售分析常用 SQL 模板包

数据源：JSDataMiddlePlatform（SQLServer）
执行方式：company-db run-file <sql文件路径>

默认分析口径（已按最新要求）：

• 主口径优先：发货件数 / 售后件数 / 订单数
• 金额口径：仅补充展示；除非明确要求，不作为主排序维度

模板列表

1. shop_weekly_report.sql

   • 用途：店铺周报（平台/店铺销售、退款、毛利、高退款风险店铺）
   • 默认时间：上一个自然周

2. sku_structure_report.sql

   • 用途：SKU结构分析（类目结构、SKU Top、价格带结构）
   • 默认时间：最近30天

3. refund_reason_report.sql

   • 用途：退款原因分析（全局原因Top、平台内原因Top、店铺风险清单、类型矩阵）
   • 默认时间：最近30天

4. fee_ratio_alert.sql

   • 用途：费比异常预警（店铺级P1/P2/P3预警、全局日趋势）
   • 默认时间：最近14天

5. logistics_sla_report.sql

   • 用途：物流时效/SLA分析（支付到发货、发货到签收、延迟预警）
   • 默认时间：最近30天

6. freight_efficiency_report.sql

   • 用途：运费效率分析（单票成本、单位重量成本、省份/快递组合成本）
   • 默认时间：最近30天

7. install_service_quality_report.sql

   • 用途：安装服务质量（工单状态、服务商表现、待审核区域）
   • 默认时间：最近90天

8. customer_service_hotspot_report.sql

   • 用途：客服问题热点（问题Top、店铺问题热点、日趋势）
   • 默认时间：最近30天

9. link_target_coverage_report.sql

   • 用途：链接目标覆盖（在线链接、运营负载、类目/价格带分布）
   • 默认时间：在线链接全量

10. after_sale_360_report.sql

• 用途：售后360分析（退款金额、一级/二级原因、类型矩阵、安装工单联动）
• 默认时间：上一个自然周

11. product-info（CLI辅助命令）

• 用途：按 SKU/SPU/关键词查询产品基础信息（成本、材质、预览图地址）
• 命令：product-info "<sku或关键词>" --days 30 --limit 20
• 输出：
  • 结果集1：产品基础信息（含 sku_name、cost_price、board_material、preview_pic_url）
  • 结果集2：最近N天出货/售后件数
  • 结果集3：最近N天店铺分布（件数）
  • 结果集4：最近N天一区/二区/三区运费汇总
  • 结果集5：最近N天省份运费TOP
  • 结果集6：最近N天售后总览（申请件数/退回件数/退款单数）
  • 结果集7：最近N天售后类型/结果矩阵
  • 结果集8：最近N天售后原因TOP（含来源）

12. product-skus-by-id（CLI辅助命令）

• 用途：按 商品ID 查询该ID下所有 SKU编码 与 SKU名称
• 命令：product-skus-by-id "<商品id>" --limit 1000
• 输出：
  • 结果集1：匹配汇总（SKU数量/SPU数量）
  • 结果集2：SKU编码+SKU名称清单（含分类、成本、预览图）

13. customer_service_experience_report.sql

• 用途：客服体验与话术分析（用户反馈问题结构、体验分、风险话术、日趋势）
• 默认时间：最近30天（可改模板顶部 @start_date/@end_date）

14. customer-service-analysis（CLI辅助命令）

• 用途：按指定时间段做客服维度的用户反馈体验/话术分析
• 命令：customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达" --limit 20
• 输出：
  • 结果集1：时间段总览（会话量、空内容率、无对应分类率）
  • 结果集2：一级/二级问题结构 TOP
  • 结果集3：店铺体验分对比
  • 结果集4：话术覆盖率（问候/共情/承诺/收尾）
  • 结果集5：风险话术命中 TOP
  • 结果集6：每日体验趋势
  • 结果集7：风险对话案例 + 建议回复话术
  • 结果集8：客服能力评分（响应能力/满意度/退款效率/求助风险控制 + 总分等级）
  • 结果集9：按客服名字评分（可识别优秀客服）

客服能力评分口径（代理映射）

• 参考维度：旺旺响应能力、旺旺满意度、退款处理体验、平台求助风险控制
• 当前数据库可用字段：pc_kfChatLog.content/mainReason/secondReason/thirdReason/reasonContent
• 评分权重（总分100）：
  • 响应能力 30%
  • 满意度 30%
  • 退款效率 20%
  • 求助风险控制 20%
• 等级：S>=90，A>=80，B>=70，C>=60，D<60
• 说明：该评分为“规则维度代理口径”，用于内部运营诊断，不等同平台官方最终分数。

运行示例

company-db run-file /root/.openclaw/workspace/sqlserver/shop_weekly_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/sku_structure_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/refund_reason_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/fee_ratio_alert.sql
company-db run-file /root/.openclaw/workspace/sqlserver/logistics_sla_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/freight_efficiency_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/install_service_quality_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/customer_service_hotspot_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/link_target_coverage_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/after_sale_360_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/customer_service_experience_report.sql
customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达" --limit 20

注意事项

• 所有模板都默认过滤 配件 和 特殊单 标签。
• 金额字段多为字符串，模板已使用 TRY_CONVERT 做安全转换。
• 如需自定义时间，修改每个模板顶部变量即可。