BettaFish 根目录兼容层清单

状态：Active
更新时间：2026-04-09

1. 目的

本清单用于记录当前仓库仍保留的根级兼容入口，以及已经完成清理的历史兼容目录，避免后续继续把旧路径当作正式结构。

2. 已移除的历史兼容目录

以下目录已在 T-517 清理完成，不再作为仓库的一部分保留：

• QueryEngine/
• MediaEngine/
• InsightEngine/
• ReportEngine/
• ForumEngine/
• MindSpider/
• frontend/
• SingleEngineApp/
• SentimentAnalysisModel/

说明：

• 这些目录原本承担旧 import 路径、旧 CLI 或示例兼容职责。
• 当前仓库内部代码已不再依赖这些目录。
• 相关兼容测试 tests/unit/test_root_compat_shims.py 与共享 shim helper utils/compat_shims.py 也已随之移除。

3. 当前仍保留的根级兼容入口

对象	当前角色	canonical 位置	当前建议
start_local.bat	Windows 一键启动入口	scripts/dev/start_local_stack.ps1	保留

4. 当前结论

• 根目录兼容层已经从“目录级 + 文件级混合兼容”收缩到“单个高价值文件级入口”。
• T-519 已删除根目录报告工具 wrapper，报告类命令统一从 tools.reports.* 执行。
• T-520 已删除根目录 config.py、crawler_web.py 与 openai_compat.py；对应 canonical 导入面分别固定为 services.shared.config、backend.crawler 与 utils.openai_compat。
• T-521 已删除根目录 Dockerfile、docker-compose.yml 与 docker-compose.override.yml；Docker 入口现已统一固定为 infra/docker/。
• T-524 已完成 app.py 保留评估，T-525 已删除该根级 Web API shim；当前仓库不再保留根目录 Python Web 入口。
• start_local.bat 仍建议继续保留为 Windows 一键启动入口，而不是重新引入新的根目录兼容包或兼容脚本。