跨平台导入WorkBuddy技能包需验证元数据标准化、执行逻辑中立性、签名一致性、沙箱隔离及文件权限映射。具体包括检查manifest.json是否符合MCP v1.2、入口文件路径与编码是否跨平台兼容、使用wbtool校验签名、确认沙箱Python路径及依赖声明、修复文件权限并清除平台专属隐藏文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在不同操作系统间迁移或共享WorkBuddy技能包，但目标平台无法识别或加载该技能，则可能是由于路径约定、协议版本、元数据格式或执行环境差异所致。以下是验证并确保跨平台导入兼容性的具体操作步骤：
一、验证技能包元数据标准化程度
跨平台兼容的前提是技能包严格遵循MCP协议v1.2及以上标准，且manifest.json中不含平台专属字段（如Windows注册表路径或macOS沙箱扩展标识），否则将导致解析失败。
1、在源平台（如Windows）打开技能包根目录，确认存在manifest.json文件且未被重命名或隐藏。
2、用文本编辑器打开manifest.json，检查是否包含"mcp_version": "1.2"或更高版本声明，且不含"platform_specific"等非标准键。
3、确认"entry_point"字段值为纯Python文件名（如main.py），不包含绝对路径（如C:\skills\main.py）或符号链接。
4、检查"version"字段是否采用语义化格式（如"1.0.0"），而非时间戳或哈希值等不可移植标识。
二、校验Python执行逻辑的平台中立性
技能主逻辑若调用os.system()、subprocess.Popen()或硬编码路径分隔符（如'\'），将在macOS/Linux上中断；反之，使用posixpath或shutil模块可保障跨平台稳定性。
1、打开manifest.json中指定的入口Python文件（如main.py）。
2、查找所有os.path.join()调用，确认未拼接字符串路径（如"path\" + "file.txt"）。
3、检查是否存在os.system("taskkill /f /im chrome.exe")等Windows独占命令，若有，需替换为跨平台等效调用（如psutil库终止进程）。
4、确认所有文件I/O操作均使用open(..., encoding="utf-8")显式声明编码，避免macOS默认UTF-8与Windows默认GBK读取异常。
三、执行跨平台签名一致性校验
WorkBuddy对技能包执行数字签名验证，若同一ZIP包在Windows下签名有效、macOS下校验失败，说明签名生成时未启用平台无关哈希算法或证书链不完整。
1、在源平台导出技能包时，确保使用WorkBuddy v1.2+内置导出功能（菜单：技能中心 → 右键技能 → 导出为ZIP），而非手动压缩。
2、在目标平台（如macOS）解压后，进入终端，执行：wbtool verify-sig skills_export_*.zip（需提前安装wbtool CLI）。
WorkBuddy 会议助手——会议价值不该散会就流失。它把会议的采集、提炼、确认、分发串成一条流水线：从腾讯会议 / IMA / 企业微信多端取料，按 15 类场景模板自动提炼成结构化纪要，你过目确认后一键分发到钉钉、飞书、腾讯文档或企业微信。全程由 workflow 工作流编排驱动，只抽取不编造、先预览后推群、自动去重。 触发：「把会议纪要做一下发钉钉」「总结 IMA 里的 XX 录音」「按面试模板整理这场会」「把这场复盘发飞书」「发到腾讯文档让我手动改」「整理企业微信里的会议纪要」。 能力：腾讯
3、若返回"Signature OK (cross-platform mode)"，表示签名兼容；若提示"Invalid platform tag"，需重新导出并勾选“通用签名模式”。
4、未安装wbtool时，可临时关闭签名验证：启动前设置环境变量WORKBUDDY_SKIP_SIGNATURE=1（仅限测试环境）。
四、测试沙箱化Python解释器隔离行为
新版WorkBuddy默认启用独立Python沙箱实例，旧技能若依赖全局site-packages或硬编码Python路径（如"/usr/local/bin/python3"），将因沙箱路径映射失败而崩溃。
1、在目标平台启动WorkBuddy后，进入开发者模式（快捷键Ctrl+Shift+I），输入/sandbox info查看当前沙箱Python路径。
2、确认技能代码中所有import语句未使用绝对路径导入（如sys.path.insert(0, "/opt/mylib")）。
3、若技能依赖第三方库（如pdfplumber），检查manifest.json中"requirements"字段是否列出精确版本（如"pdfplumber==0.7.1"），而非"pdfplumber>=0.5"。
4、在目标平台首次导入后，执行/reload_skills，观察控制台是否输出"Sandbox environment initialized for skill_xxx"。
五、验证文件系统权限映射完整性
Windows使用NTFS ACL，macOS使用POSIX ACL + Extended Attributes，跨平台ZIP包若保留源平台权限位，可能触发目标平台拒绝执行。
1、在目标平台解压技能包后，进入终端，执行：ls -l ~/.workbuddy/skills/your_skill/，确认所有.py文件具有-rwxr-xr-x权限（即755）。
2、若显示-rw-r--r--（644），手动修复：chmod +x *.py。
3、检查是否存在__MACOSX隐藏文件夹，若有，立即删除（该文件夹携带macOS专属资源叉，会干扰Windows解析）。
4、在Windows平台导入macOS导出的ZIP前，先用7-Zip打开并删除所有以._开头的资源分叉文件（如._main.py）。
