# 工作区

**工作区**是知识库的顶层容器。工作区提供了组织边界——您可以拥有个人工作区、团队工作区，以及为不同客户或项目设置单独的工作区。

## 概念

| 属性 | 描述 |
|---|---|
| **名称** | 人类可读的标签（例如："Personal"、"Engineering Team"） |
| **类型** | 个人（单用户）或团队（多用户） |
| **知识库** | 该工作区内的所有知识库 |
| **成员** | 具有访问权限的用户（仅限团队工作区） |

```bash
tokst workspace create --name "Engineering Team"
```

## 默认工作区

注册时，TokST 会创建一个名为"Personal"（或您的账户名称）的**默认工作区**。这是您的当前工作区，直到您创建或切换到另一个工作区。

## 创建个人工作区

```bash
tokst workspace create --name "客户研究"
```

该命令默认创建个人工作区，数量上限遵循个人套餐。

## 团队工作区

团队工作区会与团队套餐一并开通。成员通过邀请加入，并共同使用该团队工作区的席位、调用、存储和知识库额度。工作区开通后类型固定。

## 列出工作区

```bash
tokst workspace list
```

显示您有权访问的所有工作区，并标记已保存的当前工作区。待处理的团队邀请也会在这里展示对应的接受和拒绝命令；`tokst workspace inbox` 可直接查看同一收件箱。

## 切换工作区

```bash
tokst workspace switch <workspace-id>
```

切换工作区会更改可用的知识库。选择会保存在本地，之后的 `tokst atlas init` 会在该工作区创建知识库。接受待处理邀请后，才能切换到其工作区。

## 智能体协作

从控制台侧栏打开**智能体**页面。页面始终跟随侧栏当前工作区，仅展示该工作区的可信智能体与持久交接。API Key 首次以可信智能体方式请求时会创建稳定的 `agt_...` 身份码。

页面支持复制身份码、查看密钥状态和最后活跃时间、向一个或多个智能体定向交接，以及向所有活跃智能体广播。收件箱通过实时更新展示消息，具有权限的工作区成员可以确认或关闭回执。

## 删除工作区

您可以通过 REST API 或远程 MCP 服务器删除工作区：

```bash
curl -X DELETE https://api.tokst.com/v1/workspaces/<workspace-id> \
  -H "Authorization: Bearer $TOKST_API_KEY"
```

远程 MCP 客户端也可以使用 `workspaceId` 调用 `tokst_workspace_delete`。删除前必须先移除工作区内的所有知识库；仍有知识库时，API 返回 `409 Conflict`。CLI 当前未提供工作区删除命令。

## 个人与团队工作区

| 方面 | 个人 | 团队 |
|---|---|---|
| **成员** | 单用户 | 多用户 |
| **知识库** | 用户创建 | 成员共享 |
| **可见性** | 仅您可见 | 所有成员可见 |
| **用途** | 个人笔记、实验 | 项目知识、团队文档 |

团队工作区使用基于角色的访问控制。邀请成员前，请阅读[团队协作说明](/docs/team-collaboration)。

## 最佳实践

- **使用工作区进行隔离** — 个人实验属于个人工作区，团队知识属于团队工作区
- **清晰命名工作区** — "Personal"、"Team Engineering"、"Client A" 一目了然
- **每个团队一个工作区** — 不要为同一群体创建重叠的工作区