多工作区
多工作区功能允许您同时打开和管理多个项目工作区，在本地和远程工作区之间自由切换，并为每个工作区维护独立的会话和配置。
概述
多工作区功能核心能力包括：
- 多工作区并行：同时打开多个本地或远程项目文件夹
- 工作区标签页：顶部标签栏快速切换工作区
- 远程访问：通过隧道连接访问其他电脑上的文件夹
- 会话隔离：每个工作区拥有独立的聊天会话历史
- 独立配置：每个工 作区可以有独立的规则、模型、MCP 工具等配置
工作区类型
| 类型 | 说明 | 标识 |
|---|---|---|
| 本地工作区 | 本机上的项目文件夹 | local:<路径> |
| 远程工作区 | 远程电脑上的项目文件夹 | remote:<机器ID>:<路径> |
| 默认工作区 | 首次启动时自动创建的主工作区（.codely/default） | 显示为"默认" |
界面显示：
- 顶部的工作区标签栏
- 左侧的工作区侧边栏（含会话历史）
- 工作区选择菜单
工作区界面
工作区标签栏
位于界面顶部，以水平标签页形式展示所有已打开的工作区：
- 默认工作区始终排在最左侧（如果存在）
- 当前激活的工作区以高亮样式显示
- 标签名过长时显示省略号，鼠标悬停显示完整路径
- 标签过多时自动切换为下拉菜单模式
标签栏交互：
- 点击标签切换到对 应工作区
- 下拉菜单模式下，当前工作区前显示 ✓ 标记
- 标签栏自动滚动到当前激活的标签
工作区侧边栏
左侧侧边栏展示所有工作区及其会话历史：
- 每个工作区为一个可折叠的分区
- 分区标题显示工作区名称和状态
- 工作区加载中时显示旋转动画和"核心加载中..."提示
- 会话按状态分组：置顶 → 活跃 → 已归档
管理工作区
打开本地工作区
- 点击侧边栏顶部的 「打开工作区」 按钮
- 在弹出的工作区菜单中：
- 最近项目：显示最近打开过的项目，点击即可打开
- 此电脑：浏览本机文件夹
- 点击 「打开文件夹」 选择本地目录
- 选择目录后，新工作区自动添加到标签栏和侧边栏
打开远程工作区
- 点击侧边栏顶部的 「打开工作区」 按钮
- 点击 「打开远程文件夹」
- 在远程文件夹对话框中：
- 左侧面板：选择远程电脑
- 右侧面板：浏览该电脑上的文件夹
- 导航到目标文件夹后，点击 「打开」 按钮
远程文件夹对话框功能：
- 多驱动器支持（Windows 的 C:、D: 等）
- 面包屑导航，快速跳转到上级目录
- 文件夹筛选，快速定位目标
- 网络错误与服务端错误分别提示
切换工作区
有三种方式切换工作区：
- 标签栏：点击顶部工作区标签
- 侧边栏：在左侧点击目标工作区的会话
- 工作区菜单：通过顶部下拉菜单选择
切换工作区时：
- 当前工作区的会话状态自动保存
- 目标工作区的核心引擎就绪状态自动检查
- 如果目标工作区没有活跃会话，将自动创建新会话
从侧边栏移除工作区
- 点击工作区分区标题右侧的 ⋯ 菜单
- 选 择 「从侧边栏移除」
- 工作区从标签栏和侧边栏移除
- 如果移除的是当前激活的工作区，系统自动切换到下一个可用工作区
远程访问设置
在使用远程工作区之前，需要先在被控端电脑上启用远程访问。
被控端（被访问的电脑）设置
- 打开设置 → 设备
- 开启 「允许其他人控制我的电脑」
- 仅同一 Codely 账号下的设备可以访问
- （推荐）开启 「保持电脑处于唤醒状态」
- 防止电脑休眠导致无法远程访问
控制端（访问远程的电脑）
- 确保两台电脑登录同一 Codely 账号
- 在侧边栏点击 「打开工作区」 → 「打开远程文件夹」
- 远程电脑列表自动发现（显示"正在发现远程机器..."）
- 选择远程电脑，浏览并打开文件夹
首次设置引导
如果远程电脑列表为空，对话框会显示三步引导：
- 在需要被控制的电脑中进入 设置 → 设备
- 打开 「允许其他人控制我的电脑」
- 在控制端打开 「打开远程文件夹」 访问被控端文件
工作区操作菜单
点击工作区分区标题右侧的 ⋯ 按钮，可执行以下操作：
| 操作 | 说明 | 远程工作区可用 |
|---|---|---|
| 显示文件夹 | 在系统文件管理器中打开工作区目录 | ✗ |
| 打开终端 | 在工作区目录打开终端 | ✓ |
| 打开编辑器 | 在 Unity 编辑器中打开项目（仅 Unity 项目可用） | ✓ |
| 全部标记为已读 | 将工作区内所有会话标记为已读 | ✓ |
| 从侧边栏移除 | 从侧边栏和标签栏移除工作区 | ✓ |
常见问题
工作区显示"核心加载中..."
原因：工作区的后端核心引擎尚未就绪。系统会自动轮询检查就绪状态。
解决：请等待几秒，核心引擎通常会在短时间内完成加载。
远程电脑列表为空
原因：被控端未开启远程访问，或两台电脑未登录同一 Codely 账号。
解决：
- 确认被控端已开启"允许其他人控制我的电脑"
- 确认两台电脑登录同一 Codely 账号
- 点击对话框中的"刷新"按钮重新发现
远程文件夹无法加载
原因：网络连接问题或远程电脑上的 Codely 服务异常。
解决：
- 如果提示"无法加载远程电脑，请检查网络连接"——检查本地网络
- 如果提示"出了点问题，请重试"——检查远程电脑上的 Codely 是否正常运行
- 点击"重试"按钮重新连接
工作区标签栏变成下拉菜单
原因：打开的工作区数量过多，标签无法在顶部一行内完整显示。
解决：这是正常的自适应行为。关闭不需要的工作区可恢复标签模式。
工作区显示名称
- 本地工作区显示文件夹名称（如
my-project） - 远程工作区显示"文件夹名 (机器名)"格式
- 默认工作区显示为"默认"