workbuddy 工作区路径不可直接修改配置文件，因启动时校验 workspacepath 与授权目录一致性，不匹配则拒载并回退默认路径，且硬改会导致授权失效、ai 无法读取文件；安全迁移须三步：全进程关闭→完整复制工作区→执行 /folder 命令并重授权限；技能包失效需检查 skill.md 中 script_path 等路径引用是否适配新位置；权限凭证 credentials.bin 和 settings.json 需手动同步至 %appdata%\workbuddy\ 目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 的数据存储目录（即工作区）不能通过设置界面直接“更改”，只能通过重新指定工作区路径 + 手动迁移数据实现。试图修改注册表或配置文件硬编码路径会导致授权失效、技能加载异常甚至启动失败。
为什么不能直接改配置文件里的路径
WorkBuddy 启动时会校验 config.json 中的 workspacePath 与实际授权目录的一致性；若两者不匹配，它会拒绝加载该工作区，并回退到默认路径（如 C:\Users\{用户名}\WorkBuddy\Claw）。更关键的是，所有已授权的文件夹权限都绑定在原始路径上，硬改路径后，authorizedFolders 数组中的条目将全部失效，AI 将无法读取任何本地文件。
安全迁移工作区的三步操作
必须按顺序执行，缺一不可：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 关闭 WorkBuddy 全进程（包括系统托盘图标右键「退出」）
- 将原工作区整个文件夹（例如
C:\Users\HP\WorkBuddy\Claw）复制到目标位置（如D:\WorkBuddy_Projects），保留完整目录结构 - 启动 WorkBuddy，在输入框中执行命令：
/folder D:\WorkBuddy_Projects（注意空格，且路径不含引号） - 进入「文件夹授权管理」，手动重新勾选
D:\WorkBuddy_Projects及其子目录（如需多级授权）
迁移后技能包不生效？检查 SKILL.md 路径引用
部分技能（如 paper-check）会在 SKILL.md 的 script_path: 字段里写死相对路径，例如 check_format.py。如果原技能目录是 C:\Users\HP\WorkBuddy\Claw\skills\paper-check\，而你迁移到 D:\WorkBuddy_Projects\skills\paper-check\，只要目录层级没变，通常无需修改；但若移动了 skills/ 的位置（比如提到 D:\WorkBuddy_Projects\tools\skills\），就必须编辑每个 SKILL.md，更新 script_path: 和 input_dir: 等字段指向新位置。
别忽略权限备份文件的同步
Windows 下的权限凭证存于 %APPDATA%\WorkBuddy\credentials.bin 和 settings.json，它们不随工作区迁移自动更新。如果你希望新路径下也能使用企业微信/飞书等集成能力，需要手动把这两个文件从旧配置目录（%APPDATA%\WorkBuddy\）复制到新工作区同级的 %APPDATA%\WorkBuddy\ —— 注意不是放进 D:\WorkBuddy_Projects\ 里，而是覆盖用户级配置目录。否则即使路径对了，登录态和 OAuth 令牌也会丢失。
