docs/完整技术文档: 头部加路径迁移说明

文档主体(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 <noreply@anthropic.com>
This commit is contained in:
CodexandClaude Opus 4.7 committed 2026-05-21 12:18:58 +08:00
1 parent 6ac99530d6
commit c92af75d02
1 file changed
+19
+19
View File
@@ -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 <name>.py` 运行——根目录保留了 launcher 转发。文档里 `python run_cli.py …` 的示例命令依旧可用。
-- 变更记录
- 2026-01-18: V4.5 — 修复预约更新后的循环问题,添加强制切换标志防止在同一直播间反复检测。
- 2026-01-18: V4.4 — 修复并行OCR重试导致日志/重试噪音,参与失败自动切换直播间;购物红包像素+OCR复查(非直播间也OCR复查);并行OCR完成后写盘映射表以提升回退校验一致性;预约回退纠偏(方向提示)与二次回退改进;GUI映射表自适应列与新增购物红包阈值配置(GUI暴露)。