中文和空格会导致路径解析失败，因OpenClaw插件依赖Node.js的child_process.spawn等机制，Windows下不自动转义空格致路径截断，macOS存在编码不一致问题，引发安装中断、权限报错及扫描失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy本地文件路径包含中文或空格会导致底层技能调用失败、文件扫描中断、权限报错甚至安装卡死，不是提示“找不到文件”，而是根本无法解析路径字符串。
为什么中文和空格会引发故障
WorkBuddy调用的多数插件（如小红书、飞书、PDF解析器）基于OpenClaw规范，依赖Node.js的child_process.spawn或shell脚本执行。这些机制在Windows下对路径空格不作自动转义，遇到Users/张三/桌面这类路径时，会被截断为Users/张三/，后续部分直接丢失；macOS上则可能因APFS快照跳过自动编码，导致模块加载失败。
错误示例：Error: spawn /c/Users/张三/Desktop/WorkBuddy/node_modules/.bin/curl ENOENT——这不是curl没装，是路径在传递过程中已被系统砍掉一半。
哪些环节会出问题
方法一：安装阶段报“路径错误”
安装器启动时即校验路径，检测到中文、全角空格、括号()、&、#等符号，直接中断流程，不进入下一步。
方法二：工作空间授权后仍无法读写
即使设置里成功填入C:\Users\张三\Work，AI执行读取C:\Users\张三\Work\report.docx时，底层返回PermissionDeniedError，因为沙盒进程实际收到的是被截断的路径。
方法三：批量重命名扫描失败
输入读取D:\项目素材26Q3，WorkBuddy返回“目录为空”或仅列出部分文件——【含空格或中文的路径必须用英文双引号包裹】，否则扫描逻辑直接跳过该层级。
完整的工作区安全套件：检测未授权修改，扫描提示注入模式，自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
正确设置路径的操作步骤
第一步：彻底卸载当前版本，清空残留文件夹（包括C:\Program Files\WorkBuddy和用户目录下的.workbuddy隐藏文件夹）。
第二步：在D盘根目录新建纯英文无空格文件夹，例如D:\WB_Workspace；【不要建在桌面、文档、下载等系统默认中文路径下】。
第三步：以管理员身份运行安装包→在“选择安装位置”界面，手动删除默认路径→完整输入D:\WB_Workspace→点击下一步完成安装。
第四步：首次启动后，立即进入头像 → 设置 → 系统设置 → 默认工作空间存储路径，点击右侧路径框→导航至D:\WB_Workspace→确认保存。
第五步：重启WorkBuddy，新建任务并输入读取"D:\WB_Workspace"（加双引号），验证能否完整列出子文件与修改时间。
