ae-workspace

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ae-workspace

Use

ae-cli workspace

for AgentSpace operations. Here,

workspace_id

and

--workspace-id

always mean

AgentSpace.id

; they never mean the legacy sandbox

Workspace.id

or a filesystem directory name.

Before composing a workspace command, read references/commands.md. It contains the command matrix, mutation prerequisites, and file-transfer rules.

使用

ae-cli workspace

执行 AgentSpace 操作。在此，

workspace_id

和

--workspace-id

始终表示

AgentSpace.id

，绝不代表旧版 sandbox 的

Workspace.id

或文件系统目录名称。

在编写 workspace 命令前，请阅读 references/commands.md。其中包含命令矩阵、变更操作的前置条件以及文件传输规则。

Targeting

目标定位

Prefer an explicit
```
--workspace-id
```
supplied by the user or returned by
```
workspace list
```
.
Inside a run, the CLI may use
```
TE_AGENT_CURRENT_AGENT_SPACE_ID
```
, derive the ID from the canonical
```
/spaces/actived/<id>/.conversations/...
```
runtime directory, or ask the server to resolve
```
TE_AGENT_CONVERSATION_ID
```
.
When both workspace and conversation are available, send both so the server can reject a scope mismatch.
Outside a run, if the target is unknown, run
```
workspace list
```
and select from real IDs. Never fall back to an account default.

Use

workspace current

to verify the resolved ID, space type, role, and capabilities before a multi-step mutation.

优先使用用户明确提供的
```
--workspace-id
```
，或由
```
workspace list
```
返回的 ID。
在一次运行期间，CLI 可能会使用
```
TE_AGENT_CURRENT_AGENT_SPACE_ID
```
、从规范的
```
/spaces/actived/<id>/.conversations/...
```
运行时目录推导 ID，或请求服务器解析
```
TE_AGENT_CONVERSATION_ID
```
。
当 workspace 和 conversation 均可用时，应同时发送两者，以便服务器拒绝作用域不匹配的情况。
在非运行状态下，如果目标未知，请运行
```
workspace list
```
并从实际 ID 中选择。绝不要回退到账户默认项。

在执行多步骤变更前，使用

workspace current

验证解析出的 ID、space 类型、角色和能力。

Safety

安全

Read the latest record or revision before mutations that require
```
--version
```
.
Treat capability and membership changes as
```
high-risk-write
```
; preview them with
```
--dry-run
```
and obtain explicit confirmation before passing
```
--yes
```
.
Treat file and workspace deletion as
```
high-risk-write
```
.
Shared AgentSpace provisioning is administrator-owned.
```
workspace create
```
creates only a personal AgentSpace.
```
ae-cli sync
```
and
```
ae-cli model
```
manage the legacy sandbox Workspace. In an AgentSpace runtime, use workspace capability commands instead.

对于需要
```
--version
```
的变更操作，先读取最新记录或修订版本。
将能力和成员关系变更视为
```
high-risk-write
```
；先使用
```
--dry-run
```
预览，并在传入
```
--yes
```
前获得明确确认。
将文件和 workspace 删除视为
```
high-risk-write
```
。
共享 AgentSpace 的开通由管理员负责。
```
workspace create
```
仅可创建个人 AgentSpace。
```
ae-cli sync
```
和
```
ae-cli model
```
用于管理旧版 sandbox Workspace。在 AgentSpace 运行时，应改用 workspace 能力相关命令。

Related domains

Transition record

过渡记录

Transition status: transitional Owning module: te-claude AgentSpace Current transport: CLI-token REST under

/api/cli/workspace/v1

Gateway target: TBD Review after: 2026-12-01 Exit condition: equivalent stable Gateway capabilities exist; keep only commands that still add orchestration, file handling, safety, or stable typed output.

过渡状态：过渡期所属模块：te-claude AgentSpace 当前传输方式：基于

/api/cli/workspace/v1

的 CLI-token REST Gateway 目标：TBD 复审日期：2026-12-01 退出条件：存在功能等价且稳定的 Gateway 能力；仅保留仍能提供编排、文件处理、安全性或稳定类型化输出能力的命令。

ae-workspace

Original

Translation

ae-workspace

ae-workspace

Targeting

目标定位

Safety

安全

Related domains

相关领域

Transition record

过渡记录