工作区

什么是工作区？

工作区是与单个商业计划书项目相关的一切内容的顶层容器。 每个工作区都有自己独立的会话、数据源、技能、任务和配置 — 与其他工作区 完全隔离。

工作区身份标识

每个工作区都有两个标识符：

工作区 ID 才是唯一可信来源。两台机器可以为同一个工作区使用不同的 名称，只要工作区 ID 一致，服务器就会将它们视为同一个项目。

你可以在桌面应用的 Settings → Workspace 中找到你的工作区 ID， 也可以在 torly.ai 的 Dashboard 上、当前活跃项目名称的下方找到它。

使用场景

创建工作区

1. 点击侧边栏底部的工作区名称
2. 选择 Create New Workspace
3. 输入名称和可选的描述
4. 选择是否从现有工作区复制设置

系统会自动生成一个新的 UUID。它将成为该工作区的永久身份标识。

工作区内容

每个工作区包含：

~/.torlyai/workspaces/{workspace-id}/
├── config.json          # Workspace settings (name, ID, rootPath)
├── theme.json           # Theme overrides
├── permissions.json     # Safety rules
├── sessions/            # Chat session data (JSONL)
├── sources/             # Connected sources
│   └── {source-slug}/
│       ├── config.json
│       ├── guide.md
│       └── permissions.json
├── skills/              # Custom skills
├── statuses/            # Status configuration
├── labels/              # Label configuration
├── business-plans/      # Generated business plan sections
├── discovery/           # Idea discovery sessions
├── interviews/          # Mock interview records
├── exports/             # PDF/DOCX exports
└── project/             # Project Workspace (tasks, deliverables)
    ├── config.json
    └── tasks.json

项目槽位与授权

你的 Builder 套餐包含 1 个活跃项目槽位。同一时间只有一个工作区可以 占用该槽位。当你打开一个工作区时，应用会向服务器将其注册为活跃项目。

激活的工作原理

每次应用启动时，桌面端都会带上工作区 ID 和名称调用服务器的激活端点。 可能出现三种结果：

幂等性检查使用的是 工作区 ID，而非名称。这意味着 重新启动应用，或从另一台机器使用同一个工作区，都能无缝进行， 而不会触发该对话框。

归档工作区

当出现“Project Slot Full”（项目槽位已满）对话框时，你可以点击 Archive & Switch来释放槽位并激活新的工作区。它的作用如下：

归档不会做什么

归档会做什么

重新激活工作区

只需再次打开该工作区即可。应用会调用激活端点，从而创建一行新的 活跃项目记录。如果另一个工作区正占用着槽位，你会看到 “Project Slot Full”（项目槽位已满）对话框，可以归档另一个项目以继续。

多设备使用

同一个工作区 ID 可以在多台机器上使用（例如 Mac 和 Windows）。服务器会 识别该工作区 ID，并将来自不同设备的重新激活视为同一个项目。

要在两台机器上使用同一个工作区，请确保工作区 ID 一致。你可以 在 Settings → Workspace 中查看你的工作区 ID。

切换工作区

点击侧边栏底部的工作区名称即可查看所有工作区 并在它们之间切换。每个工作区都维护着各自独立的会话历史。

如果你切换到的工作区与当前活跃项目的工作区 ID 不同， 系统会提示你先归档当前项目。

工作区设置

打开 Settings → Workspace 即可查看和编辑：

配置文件

// ~/.torlyai/workspaces/{workspace-id}/config.json
{
  "id": "fcac7128-bb9a-c18f-8479-7e4b30bdc6ee",
  "name": "IFV Workspace",
  "createdAt": 1769608505354,
  "rootPath": "/Users/me/.craft-agent/workspaces/my-workspace"
}