添加工作区,管理目录与会话
工作区就是你挂进 Fynvra 的目录,也是所有会话和任务的根。左栏的每个工作区都可以展开成一棵会话列表;同一时间只查看一个工作区。
挂入一个目录
Section titled “挂入一个目录”-
找到添加入口
Section titled “找到添加入口”左栏「工作区」标题右侧的 +;工作区为空时,中栏也有「挂入目录」按钮。
-
在系统目录选择器里选文件夹
Section titled “在系统目录选择器里选文件夹”选 Git 仓库的根目录。若选了仓库里的子目录,Fynvra 会询问是挂入仓库根目录,还是把子目录按普通目录挂入;按普通目录挂入时不会建 worktree。
-
确认左栏出现工作区
Section titled “确认左栏出现工作区”工作区行显示名称和路径。Git 仓库显示文件夹图标;普通目录带「无 git」徽标。
-
点工作区左侧的箭头,或再次点击已选中的工作区,展开它下面的「会话」分组。
展开、切换与搜索会话
Section titled “展开、切换与搜索会话”每个工作区可以独立展开。展开「会话」分组后,标题右侧有搜索按钮和新会话 +。点会话行会切换到该会话;展开其他工作区只加载它的列表,不会改变当前正在查看的会话。
搜索会话时,点搜索图标或按 Ctrl+K(macOS 为 ⌘+K),在会话列表上方输入标题关键字。按 Enter 打开第一个结果,Esc 清空并收起搜索。
工作区的更多操作
Section titled “工作区的更多操作”把鼠标移到工作区行上,点右侧的省略号;也可以在行上右键。菜单里有:
- 打开于:用 VS Code、文件管理器或自定义应用打开该目录。自定义应用需要先选择程序并命名。
- 复制路径 / 复制名称 / 复制当前分支:只复制文本;分支项只在 Git 工作区出现。
- 从列表移除:把工作区从 Fynvra 列表里移除,不会删除磁盘上的项目目录。
Git 工作区的 worktree
Section titled “Git 工作区的 worktree”主 Agent 每次派发会给任务建一个独立的 git worktree,分支名是 fynvra/<slug>。默认放在仓库同级的 <仓库目录名>-worktrees,可以在「设置 → 通用 → Worktree 位置」里选择其他目录或恢复默认;「磁盘占用」会列出每个工作区当前的 worktree 数量和大小。
任务合并后主 Agent 会清理对应 worktree。需要临时看某个已清理 worktree 的历史改动时,从任务详情的「查看改动」进入。