106 lines
3.4 KiB
Markdown
106 lines
3.4 KiB
Markdown
# 全局迭代日志
|
||
|
||
> 用途：跨任务（`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`
|
||
- **备注**：下一阶段优先完成任务一接入并验证“单次调用单条记录”。
|