执行环境

工作空间可以绑定多台本地执行机，或在同一台机器上绑定多个目录，作为新会话中可显式选择的执行环境。绑定不会创建新的工作空间、任务副本或成员关系；模型、插件、环境变量、工作指引和权限始终来自当前空间，只有命令执行与执行机文件来源使用所选 Host 和目录。

如果新会话不显式选择执行环境，会使用空间设置中的空间模式配置默认执行方式。空间模式负责将默认环境设置为云端或本地执行；执行环境只表示用户显式添加、按需选择的本地执行机和目录。

管理绑定

工作空间管理员可在空间设置的“执行环境”中新增、自定义名称、修改目录、启停或解除绑定。存量执行空间不能管理绑定。可选执行环境必须满足：

每个主空间最多绑定 100 个执行环境；同一台执行机可以绑定多个不同目录。

• Local Agent 在线且路径配置有效；目录是否存在在实际使用时校验。
• 绑定已启用并属于当前主空间。
• 当前用户是已认证的空间管理员或编辑者；只读成员和 Guest 不可使用。

旧本地模式割接派生的兼容投影不会作为新会话里的额外候选项；默认执行仍由空间模式配置承接。解绑显式执行环境不会删除机器上的文件，也不会改写已有会话快照。

新增执行环境时，需要填写名称、选择在线本地执行机，并配置该执行环境对应的工作目录。

创建与继续对话

有可用绑定时，新对话输入框底部会显示执行环境，默认项显示为“默认环境”。选择绑定后，只有首条消息携带执行环境 ID。该 ID 表示空间与执行机的绑定关系，不是 Host ID；继续旧会话也不能重新指定执行环境。旧会话未显式选择执行环境时，也会只读显示为“默认环境”。

只读成员查询新会话执行环境时会得到空列表，界面不展示切换入口，新会话只使用“默认环境”。即使手工构造 executionEnvironmentId，服务端也会拒绝该请求。

会话创建时会保存绑定、Host 名称、Host ID、本地目录及目录摘要的标量快照。禁用、改目录或解绑只影响新会话候选；旧会话继续按快照路由。Host 被删除或离线时，历史会话显示“环境不可用”并禁止继续执行。

空间管理员和编辑者可以在新对话输入区选择本次会话要使用的执行环境；保留“默认环境”时，系统会使用空间模式中的默认执行方式。

查看与编辑文件

文件树标题栏可以在“主空间”和已打开执行机会话之间切换。两个来源的同路径文件使用不同标签页，不会互相覆盖。

打开执行机会话后，文件树标题栏会展示当前文件来源，并可在默认环境和已绑定执行环境之间切换查看。

执行机文件支持与主空间一致的只读预览类型，包括文本、代码、Markdown、图片、PDF、Office、XMind 和音视频；预览会遵循各类型的大小上限。文件编辑仍仅支持已存在、最大 10 MB 的 UTF-8 文本，不提供通用的新建或删除接口；编辑器粘贴图片时会在当前执行环境中创建对应资源文件。保存使用 SHA-256 版本校验；文件被外部修改时拒绝覆盖并保留编辑草稿，只有对明确冲突再次确认后才可使用短期、用户与内容绑定的覆盖令牌。

与执行空间的关系

执行空间是历史工作副本模型，目前停止新增但存量继续可见可用。需要新的独立运行目录时，优先在“执行环境”中绑定本地执行机和目录；需要配置当前空间不选择执行环境时的默认云端或本地运行方式，使用空间模式。