From c92af75d028b4bf4db0441234d207cef552af276 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 21 May 2026 12:18:58 +0800 Subject: [PATCH] =?UTF-8?q?docs/=E5=AE=8C=E6=95=B4=E6=8A=80=E6=9C=AF?= =?UTF-8?q?=E6=96=87=E6=A1=A3:=20=E5=A4=B4=E9=83=A8=E5=8A=A0=E8=B7=AF?= =?UTF-8?q?=E5=BE=84=E8=BF=81=E7=A7=BB=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 文档主体(7363 行)撰写于项目大重构之前,正文中仍存在大量旧路径 (Underlying_Operations.py / path_config.py 在根目录,run_cli.py / gui_app.py 不在 bin/ 等)。全面改写风险高,改为在文档头部加一段醒目的"路径迁移说明", 列出新旧路径映射,让读者遇到旧路径时能查得到对应位置。 收益: - 不破坏现有内部链接 / 锚点 - 读者一眼就能找到新旧路径对照 - 入口脚本(bin/)仍有根目录 launcher,文档里 python run_cli.py 命令仍可用 Co-Authored-By: Claude Opus 4.7 --- docs/完整技术文档.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) 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暴露)。