[Improvement] run_pipeline_test.py 直接运行报 ModuleNotFoundError

[vbqx]

测试场景

• 测试日期： 2026-06-14
• 步骤：
  1. 在项目根目录执行：python scripts/run_pipeline_test.py
  2. 不设置 PYTHONPATH 或 cd 到特定目录

发现的问题

脚本直接运行失败：

ModuleNotFoundError: No module named 'src'

• README 文档中测试命令为 python scripts/run_pipeline_test.py，未说明需设置模块路径
• 设置 PYTHONPATH=项目根目录 后可正常运行

建议修复方案

1. 方案 A（推荐）： 在脚本开头添加路径引导：

   ROOT = Path(__file__).resolve().parents[1]
   sys.path.insert(0, str(ROOT))

2. 方案 B： 改为可安装包入口：python -m scripts.run_pipeline_test

3. 同步更新 README 测试章节，确保一行命令即可跑通

4. 验收标准：

   • 在项目根目录直接 python scripts/run_pipeline_test.py 无 ModuleNotFoundError

[vbqx]

修复说明

改动文件： scripts/run_pipeline_test.py

在脚本开头添加：

sys.path.insert(0, str(ROOT))

测试结果

测试项	结果
项目根目录直接运行 python scripts/run_pipeline_test.py	✅ 无 ModuleNotFoundError
流水线输出	✅ OK price=4218.56 elapsed=176.3s

验证结论： 一行命令即可跑通，无需手动设置 PYTHONPATH。

[vbqx]

修复说明

改动文件： scripts/run_pipeline_test.py

在脚本开头添加：

sys.path.insert(0, str(ROOT))

测试结果

测试项	结果
项目根目录直接运行 python scripts/run_pipeline_test.py	✅ 无 ModuleNotFoundError
流水线输出	✅ OK price=4218.56 elapsed=176.3s

验证结论： 一行命令即可跑通，无需手动设置 PYTHONPATH。