diff --git a/docs/完整技术文档.md b/docs/完整技术文档.md index 42c3555..e8f04df 100644 --- a/docs/完整技术文档.md +++ b/docs/完整技术文档.md @@ -6,6 +6,25 @@ 说明:本文件为项目主要技术文档的重构版,聚焦“快速上手、配置规范、关键模块地图、运行与排障、验证清单”。文档同时给出可执行的诊断/采样命令,便于自动化采集与 CI 校验。 +> **⚠️ 路径迁移说明(2026-05 之后阅读本文档时请对照)** +> +> 本文档主体撰写于项目大重构之前,正文里仍出现大量旧路径。重构后实际位置如下(旧 → 新): +> +> | 文档里写的(旧) | 当前实际位置(新) | +> |---|---| +> | `Underlying_Operations.py` | `douyin/core/underlying_operations.py` | +> | `path_config.py` | `douyin/core/path_config.py` | +> | `run_cli.py` | `bin/run_cli.py` | +> | `gui_app.py` | `bin/gui_app.py`(launcher)/ `gui/gui_app.py`(实现) | +> | `webgui_launcher.py` | `bin/webgui_launcher.py`(launcher)/ `gui/webgui_launcher.py`(实现) | +> | `manage_logs.py` | `bin/manage_logs.py` | +> | `unified_logger.py` | `douyin/logging/unified_logger.py` | +> | `version.py` | `douyin/core/version.py` | +> | `from Underlying_Operations import …` | `from douyin.core.underlying_operations import …` | +> | `from path_config import …` | `from douyin.core.path_config import …` | +> +> 入口脚本(`bin/run_cli.py`、`bin/gui_app.py` 等)仍可从仓库根直接 `python .py` 运行——根目录保留了 launcher 转发。文档里 `python run_cli.py …` 的示例命令依旧可用。 + -- 变更记录 - 2026-01-18: V4.5 — 修复预约更新后的循环问题,添加强制切换标志防止在同一直播间反复检测。 - 2026-01-18: V4.4 — 修复并行OCR重试导致日志/重试噪音,参与失败自动切换直播间;购物红包像素+OCR复查(非直播间也OCR复查);并行OCR完成后写盘映射表以提升回退校验一致性;预约回退纠偏(方向提示)与二次回退改进;GUI映射表自适应列与新增购物红包阈值配置(GUI暴露)。