# haocode 运行依赖 # --------------------------------------------------------------------------- # 环境:Windows 10/11 x64 + Python 3.10(开发环境为 miniconda env: haocode) # 安装:pip install -r requirements.txt # 说明:本清单只列**代码真实 import 到**的第三方包(已用 AST 全量扫描核对), # 不含开发机上其它项目的包(numpy / matplotlib / pillow / paramiko 等均未使用)。 # --------------------------------------------------------------------------- # ---- GUI 框架(PyQt6)---- PyQt6==6.10.2 PyQt6-Qt6==6.10.2 # ---- 渲染回退:QtWebEngine(WebView2 不可用 / 无头 / 多实例时自动使用)---- # 注:WebView2 是首选渲染器,但它依赖微软运行时 + vendor/webview2/ 里的 .NET SDK, # 不走 pip;QtWebEngine 是本项目自带的兜底渲染路径,必须装。 PyQt6-WebEngine==6.10.0 PyQt6-WebEngine-Qt6==6.10.2 # ---- 大模型 SDK(OpenAI 兼容接口;DeepSeek / opencode-go / 自建反代均走它)---- openai==2.26.0 # ---- WebView2 绑定:pythonnet(import clr)+ 其加载器(仅 Windows;Linux 自动跳过)---- pythonnet==3.1.0; sys_platform == "win32" clr_loader==0.3.1; sys_platform == "win32" # ---- PDF 附件解析(ui/views/main_window.py → tools/builtin_tools/pdf_reader.py)---- PyMuPDF==1.28.0 # =========================================================================== # Linux 源码运行(Ubuntu 22.04/24.04 x64,仅 QtWebEngine;不装 WebView2 任何东西) # =========================================================================== # 1) pip install -r requirements.txt # pythonnet/clr_loader 带平台 marker,Linux 自动跳过 # 2) 安装 QtWebEngine 运行所需的系统库(apt,按需选装): # sudo apt install -y libnss3 libxkbcommon0 libfontconfig1 libdbus-1-3 \ # libgl1 libegl1 libasound2t64 # 24.04 用 libasound2t64;22.04 用 libasound2 # 离屏测试另需:QT_QPA_PLATFORM=offscreen # 3) 运行:python3.10 main.py # - 只使用 QtWebEngine;每实例独立 profile(data/webengine/profile__*) # - root/容器启动若页面空白:显式 QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox" python3.10 main.py # (启动会打印高可见风险警告;普通桌面不要加) # =========================================================================== # 以下仅在需要时安装 # =========================================================================== # ---- 打包 exe(可选)---- # PyInstaller==6.21.0 # pyinstaller-hooks-contrib==2026.6 # =========================================================================== # 不需要 pip 安装的运行时依赖(重要) # =========================================================================== # 1) vendor/webview2/ WebView2 .NET SDK(Core.dll)+ webview2loader_x64.dll # 已随仓库提供,勿删;缺失 → 自动回落 QtWebEngine # 2) WebView2Loader.dll 项目根目录的 loader(CWD 兜底路径) # 3) WebView2 Runtime(系统级) Win11 自带;Win10 需安装 Evergreen Runtime # 4) Node.js 仅 tests/test_math_extract.js 需要(可选) # 5) pytest 不需要!tests/run_tests.py 自带 harness 并 stub 掉 pytest