# 工作台数据同步机制（2026-07-30 建立）

## 核心问题
- 本地修改 JSON 数据文件 ≠ CloudBase 工作台看到新数据
- 中间缺一步 `tcb hosting deploy`

## 同步管线

```
数据变更 → check_sync.py 检测 → cb_sync_data.sh 一键部署7个文件
```

文件清单：
- kpi_progress.json
- workbench_data.json（⚠️ 内嵌kpiProgress字段，部署此文件才能更新KPI卡片）
- shipment_status.json
- my_activities.json
- customer_360.json
- file_manifest.json
- pricing/_key_customers.json

## 自动同步
- KPI cron (b5c6c96b1eee) 每日00:00刷新+自动tcb deploy
- 顺丰 watchdog 每日3次(9:00/15:00/22:00)刷新+自动部署

## 手动同步
```bash
bash ~/.hermes/scripts/cb_sync_data.sh
```

## 同步状态检查
```bash
python3 脚本/check_sync.py
```