Workspace 与 Git 变更

上一篇：工作台与协作 · 文档首页 · 下一篇：团队管理

团队所有成员共享一个 Workspace。不同成员可以使用不同权限，但看到的是同一份目录和文件变化。

展开和收起

工作台右上角的 Workspace 按钮用于展开面板。面板打开后，可点击收起图标释放更多对话空间。

展开或收起只改变界面布局，不影响成员访问 Workspace。

文件页签

文件 页签以目录树展示 Workspace：

• 点击文件夹逐层展开。
• 新文件和目录变化会自动刷新。
• 右上角刷新图标可随时手动刷新。
• 列表只展示 Workspace 范围内的安全路径。

为避免路径逃逸，插件会拒绝绝对路径、.. 和通过符号链接离开 Workspace 的访问。

变更页签

Workspace 是 Git 仓库时，变更 页签会分类展示：

• 冲突文件。
• 已暂存文件。
• 已修改文件。
• 未跟踪文件。

不同状态使用颜色和状态码区分。点击文件可打开只读 Diff 预览，查看新增、删除和修改内容。

非 Git Workspace

如果当前 Workspace 不是 Git 仓库，变更页签会明确提示。文件浏览仍然可用。

注意：如果 Workspace 根目录不是仓库，但某个子目录是仓库，插件不会自动把子目录当作 Workspace 仓库。创建团队时应直接选择正确的仓库根目录。

自动刷新机制

插件在 Host 端跟踪 Workspace 文件变化，并通过团队事件连接刷新目录和 Git 状态。以下情况仍建议手动刷新：

• 外部工具一次生成大量文件。
• 文件系统事件被操作系统合并。
• 浏览器长时间休眠后恢复。
• 网络断开后刚刚重连。

从输入框选择文件

浏览器无法把任意本地绝对路径安全地直接交给 Host Agent。因此，从输入框选择 Workspace 外文件时，插件会：

1. 上传文件内容到团队 Workspace。
2. 保存到 .agent-team/uploads/。
3. 在消息中插入 Workspace 内路径。

删除附件后再次添加同一文件，会尽量复用可用名称；发生同名冲突时才会生成新的安全文件名。

多成员修改建议

多个成员可以同时修改同一 Workspace。为减少冲突：

• 让 Leader 按文件或模块拆分任务。
• 在任务说明中写清负责文件范围。
• 修改共享核心文件前先通过团队消息协调。
• 任务完成后让 Leader查看 Git Diff 并统一验收。