WorkBuddy要求Python版本不低于3.14，若安装失败或提示“找不到Python解释器”，需确认版本、从python.org手动安装3.14、用pyenv设全局默认、手动配置内部路径，并通过指令验证是否正确识别。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装WorkBuddy并启用本地代码执行能力（如生成PPT、运行Python脚本等），但任务中途失败或提示“找不到Python解释器”，则可能是由于系统未安装兼容版本的Python，或WorkBuddy无法定位到正确的可执行路径。以下是配置系统默认Python解释器路径的多种方法：
一、确认Python版本是否满足最低要求
WorkBuddy明确要求Python运行时版本不低于3.14，该版本在稳定性、标准库完整性和async支持方面经过官方验证。低于此版本（如3.11或3.12）可能导致插件加载失败、subprocess调用异常或SSL模块不兼容。
1、打开终端（Windows：Win+R → 输入cmd；macOS/Linux：打开Terminal）
2、执行命令查看当前Python版本：python --version 或 python3 --version
立即学习“Python免费学习笔记（深入）”；
3、若输出版本号低于3.14（例如3.11.9），需卸载旧版本并安装符合要求的Python。
二、从python.org手动安装Python 3.14
该方法适用于所有平台，确保获取官方编译、无第三方修改的纯净二进制包，避免包管理器分发版本可能存在的ABI偏差。
1、访问https://www.python.org/downloads/，查找并下载标有“Python 3.14.x”的最新稳定版安装包
2、Windows用户：运行下载的.exe文件，勾选“Add Python to PATH”后点击【Install Now】
3、macOS用户：双击.pkg安装包，全程点击【继续】，安装程序将自动写入/usr/local/bin/python3
4、Linux用户：解压tar.xz包后执行./configure && make && sudo make install，新版本将安装至/usr/local/bin/python3.14
三、通过pyenv管理多版本并设为全局默认
该方法适用于已存在多个Python版本、需精确控制WorkBuddy所用解释器的高级用户，尤其适合开发环境与生产环境隔离场景。
1、安装pyenv（macOS/Linux）：curl https://pyenv.run | bash，按提示配置shell初始化
2、执行pyenv install 3.14.0下载并编译安装指定版本
3、设置全局默认：pyenv global 3.14.0
4、验证生效：python --version 应返回3.14.0，且which python指向pyenv shims路径
四、手动配置WorkBuddy内部Python路径
当系统中存在多个Python 3.14安装实例（如conda环境、Homebrew安装、自定义编译路径），且WorkBuddy自动探测失败时，可通过其内置配置强制指定解释器绝对路径。
1、启动WorkBuddy客户端，进入主界面右上角头像菜单 → 【设置】→ 【高级】
2、找到“Python解释器路径”输入框，点击右侧“浏览”按钮
3、Windows示例路径：C:Users[用户名]AppDataLocalProgramsPythonPython314python.exe
4、macOS示例路径：/usr/local/bin/python3.14
5、Linux示例路径：/usr/local/bin/python3.14
五、验证Python环境是否被WorkBuddy正确识别
完成上述任一配置后，必须执行端到端验证，确保WorkBuddy能成功调用解释器并加载标准库，而非仅通过命令行可用。
1、在WorkBuddy聊天框中输入指令：“运行python -c \"import sys; print(sys.version)"”
2、观察响应结果：应准确输出3.14.x格式版本号，且无ModuleNotFoundError或ImportError
3、若返回错误信息含“command not found”或“Permission denied”，说明路径未生效或权限不足，需回溯步骤四重新配置
