workbuddy自定义skill执行必须依赖python 3.9–3.11及基础cli工具：版本不符会报zoneinfo缺失或asyncio崩溃；需从python.org安装并勾选“add python to path”；git、zip、sqlite3、pdftotext等工具须在终端直接可用，且powershell用户需手动添加git路径至系统path；依赖检查须通过设置→开发者选项→「检查python环境」逐项验证，任一失败将导致skill上传失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy自定义Skill执行时依赖本地Python环境与系统工具链，缺一不可——没有正确配置的Python，技能连函数入口都找不到；缺少基础CLI工具，哪怕代码能跑通，也调不动文件、Git或数据库。
必须安装的Python运行时
WorkBuddy只支持Python 3.9～3.11区间版本，低于3.9会报ModuleNotFoundError: No module named 'zoneinfo'，高于3.11则因asyncio内部变更导致Skill进程启动即崩溃。
打开终端输入python --version，确认输出为Python 3.10.12这类格式。若未安装或版本不符，必须从 python.org 下载 Python 3.10 安装包，安装时【务必勾选“Add Python to PATH”】，否则WorkBuddy无法定位解释器。
这一步操作起来很简单，直接把文件拖进去就行。
必需的系统级CLI工具
不是所有Skill都用得上，但只要你的Skill涉及以下任一动作，对应工具就必须在终端中直接可用：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
-
Git操作（如自动提交日志、拉取模板仓库）→ 需
git --version返回有效版本号 -
文件压缩/解压（如打包输出ZIP报告）→ 需
zip -v或7z --version可执行 -
数据库交互（如读取SQLite本地知识库）→ 需
sqlite3 --version存在且≥3.35.0 -
PDF处理（如解析会议纪要附件）→ 需
pdftotext -v或pdfinfo -v，来自poppler-utils
Windows用户注意：PowerShell默认不识别git等命令，必须将Git for Windows的cmd目录（如C:\Program Files\Git\cmd）手动加入系统PATH，重启WorkBuddy后才生效。
依赖检查与验证路径
第一步：打开WorkBuddy主界面右下角「设置」→「开发者选项」→ 点击「检查Python环境」按钮。
第二步：观察弹窗中列出的三项状态：
✅ Python版本是否在3.9–3.11之间
✅ pip是否可调用且版本≥23.0
✅ 所有已声明依赖（如requirements.txt中的requests）是否已安装并可import
第三步：若任一栏显示❌，不要跳过——WorkBuddy不会自动修复，必须手动执行pip install -r requirements.txt或重装对应工具。这一步卡住，后续所有Skill上传都会失败。
