所有Agent必须基于共享资源区同一版本文件协作：第一步将文件拖入主界面中央「共享资源区」；第二步在各Agent输入源中统一选择带一致版本号（如v5）的该文件；第三步开启「强制刷新」策略，确保每次执行前校验ETag。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让多个Agent在协作过程中始终基于同一份最新文件做判断和输出，而不是各自读取不同时间点的缓存或旧版本内容。这在专家团模式下尤为关键——比如一份刚上传的PDF合同、刚更新的Excel销售数据表、或刚同步进系统的会议纪要，若某个Agent读的是3分钟前的快照，整个协作链就可能产出矛盾结论。
确保所有Agent读取同一份最新文件
第一步：把文件拖进WorkBuddy主界面中央的「共享资源区」，不是放在某个Agent的独立输入框里。这个区域位于左侧导航栏下方、Agent列表上方，图标是两个交叠的文档页。只有放在这里的文件，才会被系统自动注册为全局可读资源，并触发版本号递增。
第二步：在每个Agent的「输入源」配置中，取消勾选“本地上传文件”，改为选择「共享资源区→[文件名]」。注意：这里显示的文件名右侧带有一个灰色小标签，写着“v3”或“v5”这类版本号——【必须确认所有Agent选中的版本号完全一致】。版本号不一致说明有人手动上传过副本，或某次编辑未保存成功。
第三步：打开任意一个Agent的配置面板，在「上下文控制」模块中，将“文件访问策略”设为“强制刷新”。该选项默认关闭，开启后会跳过本地缓存，每次执行前主动向共享资源区发起HEAD请求校验ETag。关闭此开关时，Agent可能复用10分钟内的缓存副本，导致多人协作时看到“同一份文件却输出不同结果”的诡异现象。
避免文件版本错乱的两种典型操作
方法一：禁用“自动保存草稿”功能。该功能在设置→协作偏好中，默认开启。一旦开启，用户在腾讯文档中编辑时每30秒生成一个临时快照，这些快照会被WorkBuddy误识别为新文件并分配独立版本号。关闭后，仅当用户显式点击「发布为正式版」才触发版本升级。
基于 Rust 的快速无头浏览器自动化 CLI 工具，支持 Node.js 回退，使 AI 代理能够通过结构化指令导航、点击、输入和截取页面。
方法二：对关键文件启用「写锁」。右键共享资源区中的文件→「锁定编辑」。锁定后，任何人在腾讯文档端的修改都会被拦截，并弹出提示：“该文件正被WorkBuddy专家团引用，请联系协调者解锁”。【解锁操作只能由当前正在运行的协调者Agent执行，普通成员无权限】。这能彻底杜绝“边跑任务边改源文件”导致的逻辑撕裂。
验证是否真正同步成功
① 在专家团运行中，任意暂停一个Agent，打开其日志面板，查找关键词“context_file_version”。如果三台Agent的日志里都显示“v7”，且时间戳误差在2秒内，说明同步有效。
② 手动修改共享资源区文件末尾加一个空格→保存→观察所有Agent配置面板右上角的版本号是否同步跳变为“v8”。若某个Agent仍显示“v7”，说明它的“强制刷新”未生效，需检查该Agent是否被分配了独立沙盒且未接入共享内存通道。
③ 直接删除共享资源区中的文件。此时所有正在运行的Agent会立即中断，并报错“shared_resource_not_found: version v8 no longer exists”。这是正常保护机制，证明它们确实依赖同一份实时资源而非本地拷贝。
