工作空间协作

工作空间是的协作单元，每个工作空间包含任务看板、文件管理、Agent对话，是项目级工作的载体。

什么时候用

• 需要为不同项目/团队创建独立的协作环境时
• 需要在项目内管理任务、文件和对话历史时
• 需要通过看板可视化跟踪任务进度时
• 需要保存和复用工作流程时

你需要准备

• （管理员）可以查看和管理所有工作空间
• （普通用户）只能查看和管理自己创建的工作空间
• （如需关联Agent）至少一个已配置好的智能体，详见创建并配置智能体

操作步骤

第 1 步：进入工作空间列表

左侧菜单 -> 工作空间。

页面显示：

• 英雄区：总工作空间数、进行中任务数、「新建工作空间」按钮
• 卡片网格：所有可访问的工作空间卡片

第 2 步：创建新工作空间

1. 点击右上角「新建工作空间」按钮
2. 填写表单：
   • 名称：工作空间名称（必填）
   • 描述：简单说明用途（可选）
3. 点击「创建」

创建成功后自动进入该工作空间详情页。

第 3 步：工作空间卡片说明

每个工作空间卡片显示：

• 工作空间名称
• 描述
• （管理员可见）拥有者
• 统计：关联智能体数、待处理任务、进行中任务、已完成任务
• 操作按钮：编辑、删除（仅管理员或拥有者可见）

点击卡片或「进入空间」进入工作空间详情页。

第 4 步：任务看板

工作空间详情页左侧是任务看板：

4.1 创建任务

1. 点击看板中的「+」按钮
2. 填写任务信息：
   • 标题：任务名称（必填）
   • 描述：任务详情（可选）
   • 优先级：低/中/高（默认中）
   • 截止时间：可选
   • 执行模式：自动/确认（默认确认）
3. 保存任务

任务会出现在默认列中。

4.2 拖拽移动

直接拖拽任务卡片到不同列或调整列内顺序。

4.3 编辑/删除任务

点击任务卡片进行编辑，或删除任务。

第 5 步：工作流

工作流用于保存可复用的任务序列：

1. 在看板中点击「保存工作流」
2. 为工作流命名和添加描述
3. 后续可以加载工作流快速创建批量任务

第 6 步：文件管理

在工作空间中管理文件：

6.1 上传文件

1. 点击看板顶部的「上传文件」按钮打开上传管理
2. 选择文件进行上传

6.2 查看/下载/删除产出文件

1. 点击看板顶部的「产出文件」按钮打开产出管理
2. 点击文件进行下载，或删除文件

第 7 步：工作空间对话

工作空间详情页右侧是对话面板：

1. 在对话面板中与Agent交流
2. 对话历史与当前工作空间绑定
3. （可选）切换「侧重看板」或「侧重对话」布局

点击中间的切换按钮调整左右面板比例：

• 侧重看板：左侧面板占2/3，右侧占1/3
• 侧重对话：左侧面板占1/3，右侧占2/3

第 8 步：编辑/删除工作空间

在工作空间列表页：

• 点击「编辑」修改名称和描述
• 点击「删除」删除整个工作空间（级联删除任务、看板、工作流等）

删除操作不可恢复，请谨慎操作。

怎么验证成功了

1. 在工作空间列表中看到新创建的工作空间
2. 进入工作空间后能看到看板、对话面板和文件管理
3. 创建任务后能在看板中看到并拖拽移动
4. 上传文件后能在文件列表中看到并下载
5. 对话历史与工作空间绑定

常见问题

普通用户看不到其他用户的工作空间

这是正常的权限设计：

• 管理员可以看到所有工作空间
• 普通用户只能看到自己创建的工作空间
• 无权限访问的工作空间返回404（隐藏资源存在性）

删除工作空间后数据能恢复吗

不能。删除工作空间会级联删除所有相关数据（任务、看板、工作流、文件等），操作不可恢复。请在删除前确认并备份重要数据。

工作空间对话与普通对话有什么区别

• 工作空间对话使用固定的会话亲和键，不会创建新的会话记录
• 对话历史与当前工作空间绑定

看板中的列可以自定义吗

当前版本使用系统预设的列（如待处理、进行中、已完成），暂不支持自定义列。

深入

核心概念

工作空间是什么

工作空间是租户内用户级的协作单元，每个工作空间包含：

• 任务看板：可视化任务管理，支持拖拽排序和状态流转
• 文件管理：上传/下载文件，区分uploads和outputs子目录
• 工作流：保存可复用的任务序列，一键加载创建任务
• Agent对话：在工作空间内调用Agent，会话亲和性绑定工作空间
• 记忆管理：四份结构化记忆文件（SPEC/PLAN/LOG/KNOWLEDGE），支持版本定稿
• 打包下载：将工作空间文件和记忆打包为ZIP

权限边界

• 租户 admin：可查看、管理本租户所有工作空间
• 普通用户：仅能查看、管理自己创建的工作空间（owner_user_id）
• 非授权访问返回404（隐藏资源存在性）

工作空间对话

工作空间内对话行为与普通对话一致，但：

• 不支持n != 1
• messages数量上限500条
• 对话历史与当前工作空间绑定

记忆管理

工作空间包含四份记忆文件：

• SPEC：需求规格
• PLAN：计划
• LOG：日志
• KNOWLEDGE：知识

支持定稿记忆版本，将四份记忆文件复制到outputs/versions目录。

打包下载

打包files/memory + files/outputs为ZIP文件下载。

对话历史

获取工作空间的所有对话历史（按时间排列），前端进入工作空间时调用。

字段说明

工作空间字段

• 名称
• 描述
• 状态（active）
• 所有者
• 创建时间/更新时间
• 关联智能体数
• 待处理任务数
• 进行中任务数
• 已完成任务数

任务字段

• 标题
• 描述
• 状态：pending/running/completed/failed
• 优先级：low/medium/high
• 执行模式：auto/confirm
• 位置
• 截止时间
• 分配的Agent
• 编排运行ID

权限边界

注意事项

• 所有URL路径中的ID都是加密字符串
• 非admin用户只能管理自己的工作空间
• 即使知道其他用户工作空间的ID，访问也会返回404（隐藏资源存在性）
• 工作空间对话不创建新ChatSession，使用固定的会话亲和键
• 文件操作限制子目录：仅允许操作uploads、outputs、memory子目录，其他目录返回错误

排错速查

• 需要在工作空间中使用智能体，先阅读创建并配置智能体
• 任务看板可能需要插件支持，详见插件管理