workbuddy不支持将工作区或技能缓存目录直接指向nfs、smb或网盘同步文件夹，因其依赖posix硬链接、原子重命名和实时文件监听，而网络文件系统存在缓存延迟、锁机制不兼容等问题；推荐方案包括：迁移至本地磁盘、通过符号链接接入已同步的网盘本地副本、启用claw远程代理调用nas服务，或使用腾讯微云企业版协同空间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试将WorkBuddy的工作区或技能缓存目录指向外部存储设备（如NFS共享、NAS挂载点或第三方网盘同步文件夹），系统可能无法正常识别或持续访问该路径，导致任务初始化失败、技能加载中断或本地知识索引损坏。以下是针对该问题的多种处理方式：
一、禁止直接挂载NFS或SMB网络文件系统作为主工作区
WorkBuddy的本地执行沙箱与文件操作模块依赖POSIX硬链接、原子性重命名及毫秒级文件状态监听能力，而NFSv3/v4及SMB/CIFS协议在跨网络时存在缓存延迟、锁机制不兼容与硬链接不可用等固有缺陷，将导致技能包解压失败、日志写入阻塞或任务状态不同步。
1、检查当前挂载类型：在终端中执行 mount | grep -E "(nfs|cifs|smb)"，确认是否存在非本地文件系统挂载。
2、若输出中包含NFS或CIFS路径，立即卸载：执行 sudo umount -f /path/to/nfs/mount（Linux/macOS）或在Windows资源管理器中右键选择“断开网络驱动器”。
3、将WorkBuddy安装路径及默认Workspace目录迁移至本地磁盘根分区（如Windows的C:WorkBuddy、macOS的~/Library/Application Support/WorkBuddy、Ubuntu的/home/user/.workbuddy）。
二、允许通过符号链接间接接入已同步的网盘内容
WorkBuddy支持对授权文件夹内子目录进行读写操作，但要求父路径必须位于本地文件系统。可通过创建符号链接方式，将网盘客户端完成同步后的本地缓存目录映射为Workspace下的子目录，从而实现数据源接入，同时规避协议层限制。
1、确保网盘客户端（如腾讯微云、OneDrive、坚果云）已完成全量同步，并在本地生成完整可读写副本（例如：~/SyncedDocs/Reports）。
2、打开WorkBuddy设置→“文件权限”→点击“添加授权文件夹”，选择该本地同步目录的父级路径（如 ~/SyncedDocs），而非网盘挂载点本身。
3、在终端或命令提示符中执行符号链接指令：Linux/macOS运行 ln -s ~/SyncedDocs/Reports ~/.workbuddy/workspace/reports；Windows运行 mklink /D "%USERPROFILE%AppDataRoamingWorkBuddyworkspace eports" "%USERPROFILE%SyncedDocsReports"。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、启用Claw远程代理模式调用NAS上部署的独立服务
当需处理存储于NAS中的原始大文件（如视频素材、数据库备份），可绕过WorkBuddy本地文件系统限制，改由Claw插件发起HTTP请求，调用NAS上已部署的轻量API服务（如FFmpeg转码接口、SQLite查询接口），将结果返回至本地Workspace进行后续AI处理。
1、在NAS中部署支持Basic Auth的REST API服务（如使用Python Flask暴露/api/extract-text端点）。
2、进入WorkBuddy“Claw设置”→“自定义技能”→新建SKILL，协议选择HTTP，填写NAS内网地址（如 http://192.168.1.100:5000/api/extract-text）及认证凭据。
3、在自然语言指令中明确引用该技能，例如：“用NAS文本提取技能读取\nasrchive6Q1.pdf，提取全部正文并总结要点”。
四、使用腾讯微云企业版内置协同空间替代通用网盘
WorkBuddy与腾讯微云企业版深度集成，其协同空间采用私有协议直连，具备文件版本快照、元数据透传与变更事件实时推送能力，可被WorkBuddy识别为可信本地扩展存储，支持直接拖入、自动触发技能链及多端状态同步。
1、登录WorkBuddy后，在左侧面板点击“云空间”图标，选择“绑定腾讯微云企业版”，扫码完成OAuth 2.0授权。
2、在微云管理后台开通“AI协同空间”，设置访问权限为“仅本企业成员可写入”。
3、在WorkBuddy中执行指令时，可直接指定路径为微云:/AI-Projects/Q4-Analysis，系统将自动路由至对应加密空间，无需手动挂载或同步。
