空间模式

空间模式用于配置当前工作空间的“默认环境”。当用户创建新对话且没有显式选择执行环境时，系统会按照空间模式决定 AI 在云端 Sandbox 运行，还是在绑定的本地执行机目录中运行。

空间模式是工作空间自身的默认执行配置，保留 executionMode、localAgentHostId 和 localPath 这组空间级字段。它不会创建新的工作空间、副本或执行环境记录，也不会影响已经显式选择执行环境的会话。

使用入口

工作空间管理员可进入「空间设置」→「空间模式」进行配置。

空间模式复用执行配置能力，以完整设置页形式展示：

• 当前默认执行方式。
• 云端模式与本地模式切换。
• 本地执行机选择。
• 本地工作目录配置。
• 绑定、解绑和切换模式时的状态提示。

如果当前空间还没有绑定本地执行机，空间模式页会展示空状态，并提供“选择已有 Agent 绑定”和“在新设备安装”的入口。

云端模式

云端模式表示默认环境使用平台云端 Sandbox。适合不依赖本机工具链、浏览器或内网资源的轻量任务。

选择云端模式后：

• 新对话不选择执行环境时，会在云端 Sandbox 中运行。
• 已保存的本地执行机和目录配置可按产品策略保留，用于后续切回本地模式。
• 已创建会话不会因为空间模式切换而迁移。

本地模式

本地模式表示默认环境使用指定本地执行机和本地目录。适合需要使用本机依赖、内网服务、本机浏览器调试或稳定开发目录的场景。

切换到本地模式前，需要先在「本地主机」中接入本地执行机，并在空间模式中选择 Host 和 localPath。

本地模式下：

• 新对话不选择执行环境时，会在空间模式绑定的本地目录中运行。
• 如果新对话显式选择了执行环境，则以所选执行环境为准，不使用空间模式绑定。
• 解绑空间模式中的本地执行机后，默认环境会回到云端模式；机器上的本地目录不会被删除。

与执行环境的关系

空间模式和执行环境都可以让会话使用本地执行机，但作用不同：

如果团队只有一个稳定本地目录，可以直接通过空间模式把默认环境设置为本地。如果同一个空间需要多个可选本地目录，应在执行环境中添加多个绑定，并在新会话中按需选择。

与执行空间的关系

执行空间是历史工作副本能力，已不推荐继续使用，也不再支持新增。空间模式不会创建执行空间，也不会迁移或删除存量执行空间。

存量执行空间仍按自己的执行位置运行；主空间不再通过执行空间列表里的“主空间”默认记录管理默认执行方式。主空间的默认云端或本地执行方式统一在「空间模式」中管理。

使用建议

• 默认大多数会话都应在同一个本地目录运行时，使用空间模式配置本地默认环境。
• 只偶尔需要切到特定本地目录时，优先添加执行环境并在新会话中显式选择。
• 不确定本地执行机是否稳定在线时，保持云端模式作为默认环境。
• 需要隔离多个工作副本时，优先评估执行环境和 Git 工作区方案，不再新建执行空间。

相关文档

• 执行环境
• 执行空间
• 本地执行机