# 项目工作区 **项目工作区（Project Workspace）** 是 Explorer「文件 → 项目工作区」页面中的命名入口，指向某台智能体主机上的绝对路径目录。路径按字节精确保存——包括尾随空格和大小写——所以 AgentTeam 记录的路径和机器上的实际目录完全一致。 项目工作区适合反复打开的代码库或工作目录。如果只是想快速查看某个 agent 正在做什么，请使用 **智能体目录**。 ## 项目工作区 vs. 智能体目录 | | 项目工作区 | 智能体目录 | | -------- | ---------------------------- | ---------------------------------------------------- | | 指向什么 | 你在机器上选择的任意绝对目录 | agent 专属的工作目录（`~/.agentteam/agents//`） | | 谁创建 | 你主动创建 | agent 创建时 AgentTeam 自动生成 | | 适合场景 | 浏览代码库、针对某路径做评审 | 查看 agent 的文件、记忆与状态 | ## 创建项目工作区 1. 在 Explorer 侧边栏打开「**文件 → 项目工作区**」。 2. 从按智能体主机分组的内嵌资源列表中选择项目，或点击 **+** 创建项目。 3. 填写两个字段： - **项目名称**：项目选择器中显示的名称。 - **根路径**：目录的绝对路径。 4. 点击 **创建项目**。 新建的项目工作区默认 **private**（仅自己可见）、描述为空。你可以在项目设置中随时修改这两项，以及可见性和成员访问权限。 只有项目 owner 可以移除项目。设置页将此操作放在独立的「**危险操作**」区域，并要求输入界面显示的项目名称后才能确认；无名项目则输入界面显示的根路径。移除项目只会删除 Explorer 中的项目记录和访问授权，绝不会改动智能体主机上的文件。 ### 根路径按字节精确保存 根路径按你输入的原始字节保存。像 `/home/user/repo `（尾随空格）这样的路径会被原样保留，确保它解析到机器上的同一个目录。AgentTeam 绝不会 trim 这个值。 ### 浏览或手动输入 当选中的机器在线且其守护进程声明了目录浏览能力时，根路径旁会出现 **浏览** 按钮。点击它打开机器目录选择器，无需离开键盘就能在文件夹之间导航。 如果浏览被禁用，说明机器离线或运行的是较旧的守护进程。你仍可以直接输入绝对路径——只有浏览按钮被禁用，根路径输入框始终可用。 ## 浏览不可用时 浏览要求机器在线，且其守护进程声明了 `machine.directory.list` 能力。在以下两种常见情况下会看到浏览被禁用： - **机器离线**：WS 连接已断开。等待重连或选择另一台机器。 - **守护进程版本较旧**：当前守护进程还没有目录浏览能力。在该机器上更新守护进程即可获得浏览。 无论哪种情况，都可以直接在根路径中输入绝对路径继续操作。手动输入始终可用。 ## 创建之后 「文件」Section 提供独立的 **项目工作区** 和 **变更评审** 页面： - 在 **项目工作区** 中，从内嵌资源列表选择项目，再在右侧浏览目录树与文件预览；选择后资源列表会自动隐藏。项目名称和路径左侧的控制可以恢复或再次隐藏列表，拖动分隔线可调整并记住宽度。owner / manage 可从同一标题栏进入项目设置，编辑名称、描述、可见性和成员访问权限。 - 在 **变更评审** 中，使用评审界面自身的 Review Context 控制切换可访问的评审。 ## 打开共享的项目工作区 项目访问权和智能体主机管理权是两套独立权限。如果他人向你共享了项目工作区，但你不能管理其主机，「文件」资源列表仍会按该主机标识分组显示获授权的项目，而不会创建一个受限的主机管理页面；可访问的评审仍通过变更评审界面提供。你可以浏览获授权的项目和评审，但不能创建或修改主机资源。AgentTeam 检查项目访问权时会显示加载状态；项目列表加载失败时可以点击 **重试**。 ## 浏览时可能看到的错误 如果机器目录选择器无法列出某个目录，会显示一条简短的、不含路径的提示信息。这些提示都不包含你的路径： - **请求的路径无效**：路径不是绝对路径或无法解析。请输入绝对路径后重试。 - **机器无法读取该目录**：检查权限或换一个路径。 - **该机器的守护进程不支持目录浏览**：请升级守护进程或手动输入路径。 - **目录浏览暂不可用**：稍后重试或手动输入路径。 - **机器正在忙于浏览目录**：稍后重试。 - **此层级文件夹过多**：目录下的条目超过单页容量。请输入更具体的绝对路径以缩小范围。