Track successful sync runs

REAMME.md

@@ -34,6 +34,18 @@ WORKBOOK_ID=your-workbook-id ./update.sh
 - 合并结果末尾增加生成的 `LinkName` 列。
 - 看板对仅包含 `Date`、且 `Commission` 与 `GMV` 均为空的日期行进行过滤；该过滤由 `index.html` 完成。
 
+### 同步运行日志
+
+`data/sync-log.json` 保存最后一次成功同步的摘要，字段包括：
+
+- `last_success_at`：UTC ISO-8601 时间，使用 `Z` 表示 UTC。
+- `last_success_at_shanghai`：`Asia/Shanghai` 时区的 ISO 时间。
+- `worksheet_count`：本次读取的工作表数量。
+- `record_count`：合并结果中的数据记录数量，不含标题行。
+- `artifact_bytes`：本次生成的 `data/merged.html` 字节数。
+
+只有 Google Sheets 读取、合并和 HTML 生成全部成功后才会生成并发布新的运行日志。同步失败或 Git 推送失败不会用失败时间覆盖已发布的最后成功时间。AgentStage 每次成功运行都会提交 `data/merged.html` 或 `data/sync-log.json` 中发生变化的文件；即使数据内容没有变化，运行日志的成功时间也会变化，因此仍可通过 Git 提交和日志确认运行记录。
+
 ## 看板功能
 
 看板页面采用上下布局，包含以下内容：