| name | kovascape-daily-report |
| description | 从领星 MCP 拉取 15 个亚马逊站点（KovaScape 品牌）的真实库存和利润数据，运行规则引擎检测异常，生成 HTML 日报，分发钉钉待办，推送 Action Card。当用户要求"执行日报"、"生成 KovaScape 日报"、"跑日报流程"或自动化定时器触发日报任务时使用。 |
KovaScape 日报执行流程
项目路径
D:\WorkBuddy\2026-07-25-08-51-51\kovascape-daily-report\
├── config.yaml # 15站点sid、阈值、webhook、dws配置
├── main.py # 编排器
├── output/ # 输出目录
│ ├── listing_owners.json # 负责人缓存（已预拉取）
│ └── snapshot-{date}.json
├── scripts/
│ ├── data_layer.py # 数据模型 + MockDataSource
│ ├── rule_engine.py # 8条P0规则 + OwnerResolver
│ ├── html_renderer.py # Jinja2 HTML模板
│ ├── todo_dispatcher.py # aitable写入 + dws待办
│ └── webhook_pusher.py # Action Card推送
└── .workbuddy/skills/kovascape-daily-report/
├── SKILL.md # 本文件
└── scripts/
└── merge_mcp_data.py # MCP原始数据 → snapshot JSON
执行步骤（顺序执行）
0. 准备工作
cd /d/WorkBuddy/2026-07-25-08-51-51/kovascape-daily-report
mkdir -p output
确定美西日期（夏令时 PDT=UTC-7, 冬令时 PST=UTC-8）：
1. 通过 MCP 拉取真实数据
核心接口：query_product_performance_asin_lists —— 一个接口包含 sales/profit/ad/inventory/ranking 全部数据。
对每个 KS- 站点，调一次 MCP：
{"sids": "5018", "offset": 0, "length": 500, "start_date": "昨天", "end_date": "昨天", "date_type": "purchase", "query_order_profit": true}
保存到 output/raw/{sid}-performance.json。
⚠️ 关键参数：
sids：必须指定单个站点ID（不要拼多个，也不要漏掉——否则会拉全站！）start_date / end_date：都填美西昨天日期（一个站点一天的数据）query_order_profit: true：获取利润数据
15 个站点串行拉取，每站约 200-600 条记录。
1d. 合并原始数据为 snapshot JSON
python scripts/merge_mcp_data.py --date {美西日期} --output output/snapshot-{date}.json
此脚本读取 output/raw/ 下所有 {sid}-inventory.json / {sid}-profit.json / {sid}-listings.json，合并为 DailySnapshot 格式。
2. 运行规则引擎
python scripts/rule_engine.py output/snapshot-{date}.json output/alerts-{date}.json
输出：output/alerts-{date}.json（包含6-8条P0异常）
3. 渲染 HTML 日报
python scripts/html_renderer.py output/snapshot-{date}.json output/alerts-{date}.json output/{date}.html
输出：output/{date}.html
4. 分发待办（写入 aitable + 创建 dws 待办）
python scripts/todo_dispatcher.py output/alerts-{date}.json "https://d70f70b3d5174e90a35cc59ddab837cc.app.codebuddy.work/{date}.html"
- 写入钉钉多维表格
KovaScape工作大表 → 9.0_日报行动项
- P0 + due≤4h 的 alert 创建 dws 待办（DING 强推）
- 自动去重：同日期+规则+MSKU 的记录会跳过
5. 推送钉钉 Action Card
python scripts/webhook_pusher.py --date {date} --url "https://d70f70b3d5174e90a35cc59ddab837cc.app.codebuddy.work/{date}.html"
6. 汇报结果
最终输出格式：
✅ KovaScape 日报 {date} 完成
业绩：销售额 $X | 订单 Y | 毛利 $Z | TACoS W%
异常：P0 × N 条
待办分发：写入 A 条 | 去重跳过 B 条 | dws待办 C 条
钉钉推送：成功
关键数据
领星 UID → 归属人
| 领星 UID | 姓名 | 系统key | dws userId |
|---|
| 10896311 | 王祎 | wang_yi | 17566881508928543 |
| 10923094 | 化一博 | hua_yibo | 17597998065506150 |
钉钉配置
- Webhook：
https://oapi.dingtalk.com/robot/send?access_token=ba74877458660cee8526c367981821c5493aa0ae0493d205574bc82e8fe620d7
- 关键词：
广告（Action Card 的 title 和 text 都必须含关键词）
- 加签 secret：无（仅关键词模式）
dws 路径
node: C:/Users/Administrator/.workbuddy/binaries/node/versions/22.22.2/node.exe
dws_js: C:/Users/Administrator/.workbuddy/binaries/node/cli-connector-packages/node_modules/dingtalk-workspace-cli/bin/dws.js
阈值基线
| 指标 | 值 | 说明 |
|---|
| ACoS 盈亏线 | 50% | 硬线 |
| TACoS 当前目标 | 25% | 广告占总销售比 |
| 毛利率红线 | 18% | |
| 缺货阈值 | 7 days of supply | |
| 新品排除期 | 30天 | |
