WorkBuddy 不支持安装在 FAT32/exFAT 移动硬盘上，因其依赖硬链接与 POSIX 权限，而该格式不支持；仅 APFS（macOS）、ext4（Linux/WSL2）、NTFS（Windows）可用，且安装路径须为纯英文、无空格或符号，否则触发 403 错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
不支持将 WorkBuddy 安装在 FAT32 或 exFAT 格式的移动硬盘上，即使该硬盘已接入系统并显示为可写盘符。
为什么 FAT32/exFAT 移动硬盘会安装失败
WorkBuddy 初始化时需创建硬链接（用于技能包快照复用）并严格校验 POSIX 文件权限（如 chmod 755 对沙箱执行目录的控制）。FAT32 和 exFAT 文件系统根本不支持这两项特性，会导致以下具体问题：
- 安装过程卡在“正在解压核心运行时”阶段，日志中出现
ENOTSUP: operation not supported或EPERM: operation not permitted - 即使跳过报错强行完成安装，后续技能加载失败，
Claw子系统无法启动，微信指令接收无响应 - 知识索引构建中断，
workbuddy启动后始终停留在“正在加载技能市场”界面
哪些移动硬盘格式才算“可用”
仅当移动硬盘被格式化为以下任一原生支持硬链接与 POSIX 权限的文件系统时，才可作为 WorkBuddy 的安装路径：
- macOS 用户：必须是
APFS（不能是 APFS（加密）或 APFS（大小写敏感），需选默认 APFS） - Linux 用户（含 WSL2）：必须是
ext4（不可用 btrfs 或 xfs，后者虽支持硬链接但权限模型未通过兼容性测试） - Windows 用户：必须是
NTFS（不可用 ReFS；且需确认该 NTFS 分区未启用“压缩”或“加密”属性）
注意：df -T /path/to/drive（Linux/macOS）或 fsutil fsinfo ntfsinfo D:（Windows）可快速验证当前挂载点的文件系统类型。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
安装路径里有中文、空格或符号会触发 403 错误
即便移动硬盘格式正确，若安装路径包含任何非 ASCII 字符，也会导致技能市场请求被服务端直接拒绝：
- 错误现象：点击“安装技能”后立即返回
403 Forbidden，控制台显示Failed to fetch skill list: 403 - 典型非法路径：
/Volumes/我的硬盘/WorkBuddy、D:\Work Buddy\、/media/user/WD-MyBook/WorkBuddy&v2 - 合规路径示例：
/Volumes/WorkBuddyData、D:\wb_inst、/mnt/wb_root
这个限制是服务端强制校验的，客户端无法绕过。
更稳妥的替代方案
与其折腾移动硬盘兼容性，不如采用经验证的低风险做法：
- Windows 用户：安装到
C:\Program Files\WorkBuddy或D:\WorkBuddy（NTFS 分区），工作目录仍可设为移动硬盘上的D:\wb_data（只要该路径是 NTFS 且无特殊字符） - macOS 用户：安装到
/Applications/WorkBuddy.app，再在设置中将“工作区文件夹”指定为移动硬盘上一个纯英文命名的APFS目录（如/Volumes/ExtSSD/wb_workspace） - Linux/WSL2 用户：不建议使用移动硬盘安装；如确需便携，应使用
ext4格式 U 盘，并在每次插入后手动运行sudo mount -o uid=$UID,gid=$(id -g) /dev/sdb1 /mnt/wb再启动
真正容易被忽略的是：WorkBuddy 的“安装路径”和“工作区路径”是两个独立配置项。前者决定二进制与技能包存放位置，必须满足文件系统与路径字符双重约束；后者仅用于读写缓存与用户文件，限制宽松得多——把精力放在后者上，比强求前者更实际。
