workbuddy默认不自带python运行时，必须手动安装python 3.14并重启应用，否则依赖python的指令（如生成ppt）将卡住或报错；需在设置→环境配置中确认路径有效，并通过命令行验证python --version和路径是否正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 默认不自带 Python 运行时，必须手动安装并重启应用才能执行 Python 脚本——否则所有依赖 python 的指令（如生成 PPT、数据清洗）都会卡在“正在执行”或直接报错退出。
确认 WorkBuddy 是否已识别本地 Python
启动 WorkBuddy 后，进入设置 → 【环境配置】页，查看 “Python 路径” 一栏：
- 显示为空或
not found：说明未检测到可用 Python，需安装； - 显示类似
C:\Users\XXX\AppData\Local\Programs\Python\Python314\python.exe：路径有效，但需验证版本是否匹配； - 显示路径但执行脚本仍失败：大概率是环境变量未刷新或权限不足。
别信界面上的“已检测”，一定要在命令行里手动验证：python --version 和 where python（Windows）或 which python3（macOS/Linux）必须能立刻返回结果。
安装 Python 3.14（推荐）或 3.12，避开常见兼容问题
WorkBuddy 内部调用 Python 时对 ABI 和标准库行为敏感，高版本（如 3.15+）或低版本（如 3.9 以下）都容易触发 ImportError 或 subprocess 启动失败。
- Windows 用户优先用
winget install Python.Python.3 --version 3.14.0（比官网 MSI 更易集成 PATH）； - macOS 用户用
brew install python@3.14，然后确保python3指向该版本（brew unlink python && brew link python@3.14）； - 不要用 pyenv 管理多个版本后只激活某一个——WorkBuddy 只读系统 PATH，不读 shell 的 virtualenv 激活状态；
- 安装时务必勾选 “Add Python to PATH”（Windows）或确认
brew安装路径已加入$PATH（macOS）。
重启 WorkBuddy 是硬性要求，不是可选项
WorkBuddy 在启动时一次性扫描并缓存 python 和 node 的可执行路径，运行中不会重新探测。即使你刚装完 Python 并刷新了环境变量，不重启就等于没装。
- 任务栏右键 WorkBuddy 图标 → 【退出】，再从开始菜单/桌面快捷方式重开；
- macOS 用户需在活动监视器里确认
WorkBuddy进程已完全退出（不止是关闭窗口）； - 重启后再次进【环境配置】页，等待 3–5 秒看 Python 路径是否自动填充；
- 如果仍为空，打开终端执行
echo $PATH（macOS/Linux）或path（Windows），确认 Python 安装目录确实在其中。
执行脚本时报 “Permission denied” 或 “No module named xxx”
这通常不是 Python 没装好，而是 WorkBuddy 以受限上下文调用 subprocess.run()，导致当前工作目录、用户权限或包隔离出问题。
-
No module named requests：用python -m pip install requests而非pip install，避免装到错误的 site-packages； -
Permission denied：检查脚本路径是否含中文、空格或符号（如C:\我的脚本\clean.py），改用纯英文路径（如C:\wb_scripts\clean.py）； - 脚本里用了相对路径（如
open("data.csv")）：WorkBuddy 执行时工作目录不固定，必须用绝对路径或__file__动态拼接； - 想用虚拟环境？不行——WorkBuddy 不支持激活 venv，只能把包装到全局 Python 里。
最常被忽略的一点：WorkBuddy 的 Python 调用不继承你的终端环境变量（比如 HTTP_PROXY 或自定义 PYTHONPATH），所有依赖必须能在干净环境下直接 import。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
