工作区
导入仓库,创建、重命名、切换、关闭与删除工作区,并熟悉应用外壳。
在日常工作中,你在一个工作区里进行操作。本页介绍应用外壳、如何导入项目,以及如何创建、切换与移除工作区。关于项目、工作区与代码目标背后的模型,见 核心概念。
导入项目
Cordy 在本地 Git 仓库上工作。可从左侧栏的 Add repository(添加仓库) 操作添加、按 Ctrl+Shift+O,或将仓库文件夹拖拽到侧边栏上。导入仓库会创建一个项目——即拥有你的工作区以及 Files 与 Git 工具的仓库级容器。
如需处理同一仓库的第二个检出目录,请用 git worktree add 创建,并把该目录作为单独项目导入。
三区域外壳
| 区域 | 名称 | 承载内容 |
|---|---|---|
| 左 | Project / Workspace 导航 | 你的项目及其工作区 |
| 中 | 工作区画布 | 终端、智能体、笔记、浏览器,以及编辑器 / diff / 预览标签页 |
| 右 | Project Tools(项目工具) | Files、Changes、Graph 与 Search |
左:导航
左侧栏列出你的工作内容:
- 一个 Workspaces(工作区) 按钮,打开跨所有项目的全部工作区概览,并带搜索;
- 每个项目一个分组,展开后是它的工作区。每个工作区行都带有状态徽章,包括其中任何智能体的状态;点击智能体徽章会聚焦该智能体的标签页;以及
- 一个页脚,含 Add repository(添加仓库)、Settings(设置)、主题切换与 About(关于)。
当你需要更多空间时,它可收起为一条窄栏,并接受拖入的仓库文件夹以导入。
中:工作区画布
中央区域显示 Workspaces 概览,或当前工作区界面。一个工作区界面承载:
- 终端与智能体标签页,可分屏与排列;
- 工作区笔记面板;
- 可选的浏览器面板;以及
- 编辑器、diff 与媒体预览标签页。
工作区标题栏显示工作区名称和副标题 project root · <路径>。其操作为 New(新建工作区)、Notes、Browser、Duplicate、Fullscreen row / Restore row 与 Close。
少量最近使用过的工作区会保持挂载,因此在它们之间切换是即时的,其终端也会持续接收输出。
右:Project Tools
右侧栏有四个标签页——Files、Changes、Graph 与 Search。它们跟随当前工作区。完整操作见项目工具。
创建与切换工作区
创建工作区
选择工作区标题栏的 New、悬停侧栏项目分组时出现的 +、Cmd/Ctrl+Shift+↓,或命令面板中的 New workspace。Cordy 会立即在项目自身的检出目录中创建工作区,没有目标选择器。
标题栏的 Duplicate(Cmd/Ctrl+D)会在同一项目中复制当前工作区。
重命名工作区
双击工作区标题,或使用命令面板中的 Rename workspace。
切换工作区
点击侧边栏中的工作区即可切换。对已打开的工作区这是即时的;已关闭的会先被重新打开。命令面板会为当前项目的其他工作区列出 Switch to workspace: <名称>。键盘切换(跳转到编号、上一个 / 下一个、第一个 / 最后一个)见 快捷键。
你此前处于活跃状态的工作区会在重启与托盘恢复之间被记住。
关闭还是删除
- 关闭(标题栏操作、
Cmd/Ctrl+Shift+W,或命令面板中的 Close workspace)会保留工作区记录,之后可以重新打开。 - 删除使用悬停工作区行时出现的垃圾桶图标。Cordy 会询问"Delete workspace
<名称>? This removes its notes and chat history from Cordy."(删除工作区?这会从 Cordy 中移除它的笔记与聊天历史。)删除不会改动仓库中的文件。
Files 与编辑器
在 Files 中点击文件,会在中央画布中以标签页打开它。图片、SVG、视频与音频会在预览标签页中打开,而不是文本编辑器。该编辑器:
- 根据文件扩展名选择语言;
- 用
Cmd/Ctrl+S保存,用Cmd/Ctrl+F查找; - 防止更新丢失——若某文件在你打开后于磁盘上发生变化(某个智能体或某次 Git 操作编辑了它),保存前会先询问是否覆盖,从而不会悄悄覆盖智能体的工作成果;以及
- 以只读方式打开非 UTF-8 文件以避免损坏其字节,并把二进制或超大文件视为不可编辑。
文件树、Git、Graph 与 Search 见项目工具。
笔记
每个工作区有一篇笔记,是用块编辑器书写的文档,用于记录属于该任务的计划、发现与上下文。用工作区标题栏的 Notes 或 Focus notes(Cmd/Ctrl+→)打开。见笔记。
面板出错时
如果某个面板在绘制时出错,只有该面板显示错误,并提供 Reload pane(或 Reload note)按钮。窗口其他部分照常工作。