G41_TAPD_BUG_SYNC/docs/全局迭代日志.md

全局迭代日志

用途：跨任务（src / src2）记录每个阶段的增改内容、验收结果与回滚点。 约束：每次阶段验收通过后，必须追加一条日志记录。

---

记录模板

阶段：

• 阶段名称：
• 日期：
• 目标：

变更清单

• 新增文件：
• 修改文件：
• 删除文件：

关键改动说明

• 日志结构变更：
• 接口/调用链变更：
• 兼容性说明：

验收结果

• 通过项：
• 未通过项：
• 遗留风险：

回滚与追踪

• 可回滚点：
• 关联文档：
• 备注：

---

阶段日志

阶段0：文档与约定先行

• 阶段名称：日志系统重构 - 阶段0
• 日期：2026-02-28
• 目标：建立重构方案与全局文档骨架，为后续代码改造提供统一约束。

变更清单

• 新增文件：
  • docs/日志系统重构实施方案.md
  • docs/全局迭代日志.md
  • docs/全局框架文档.md
• 修改文件：无
• 删除文件：无

关键改动说明

• 日志结构变更：确定后续采用 jsonl，并以 sync_id 分隔每次同步。
• 接口/调用链变更：明确生产链路以 src/scheduler.py、src2/scheduler.py 为准。
• 兼容性说明：阶段0仅文档，不影响现网行为。

验收结果

• 通过项：
  • 分阶段路线、边界条件、验收清单已落文档。
  • 已建立全局迭代日志与框架文档容器。
• 未通过项：无
• 遗留风险：
  • 任务二存在复用模块导致串目录风险（待阶段3修复）。
  • 现有日志写入策略存在双记录与结构损坏风险（待阶段1/2修复）。

回滚与追踪

• 可回滚点：当前为纯文档提交，可直接整提交回滚。
• 关联文档：docs/日志系统重构实施方案.md
• 备注：阶段1开始前需再次确认日志字段最终版。

阶段1：实现全局日志内核

• 阶段名称：日志系统重构 - 阶段1
• 日期：2026-02-28
• 负责人：Codex
• 目标：在任务目录外提供可复用的统一日志内核，支持 jsonl、sync_id、token 脱敏。

变更清单

• 新增文件：
  • core/global_log_system.py
  • core/__init__.py
• 修改文件：
  • docs/全局迭代日志.md
  • docs/全局框架文档.md
• 删除文件：无

关键改动说明

• 日志结构变更：新增 start_sync / api_call / end_sync 三类事件模型。
• 接口/调用链变更：提供 start_sync、log_api、end_sync_with_stats 三个核心接口。
• 兼容性说明：阶段1仅新增内核，未接入任务一/任务二业务调用，不影响现网逻辑。

验收结果

• 通过项：
  • 已支持按天写入 api_log_YYYY-MM-DD.jsonl。
  • 已支持 sync_id 生命周期记录。
  • 已支持 token/secret 脱敏。
  • 已提供任务一、任务二创建器（固定目录）。
• 未通过项：
  • 尚未接入 src / src2，串目录与双记录矛盾仍待后续阶段修复。
• 遗留风险：
  • 阶段2/3接线时若沿用旧 logger 分支逻辑，可能再次引入双记录。

回滚与追踪

• 可回滚点：core/ 新增为独立改动，可单独回滚。
• 关联文档：docs/日志系统重构实施方案.md
• 备注：下一阶段优先完成任务一接入并验证“单次调用单条记录”。