跳转到内容
Fynvra
GitHub 下载 EN
使用文档日常工作工作区

添加工作区,管理目录与会话

工作区就是你挂进 Fynvra 的目录,也是所有会话和任务的根。左栏的每个工作区都可以展开成一棵会话列表;同一时间只查看一个工作区。

  1. 左栏「工作区」标题右侧的 +;工作区为空时,中栏也有「挂入目录」按钮。

  2. 选 Git 仓库的根目录。若选了仓库里的子目录,Fynvra 会询问是挂入仓库根目录,还是把子目录按普通目录挂入;按普通目录挂入时不会建 worktree。

  3. 工作区行显示名称和路径。Git 仓库显示文件夹图标;普通目录带「无 git」徽标。

  4. 点工作区左侧的箭头,或再次点击已选中的工作区,展开它下面的「会话」分组。

每个工作区可以独立展开。展开「会话」分组后,标题右侧有搜索按钮和新会话 +。点会话行会切换到该会话;展开其他工作区只加载它的列表,不会改变当前正在查看的会话。

搜索会话时,点搜索图标或按 Ctrl+K(macOS 为 ⌘+K),在会话列表上方输入标题关键字。按 Enter 打开第一个结果,Esc 清空并收起搜索。

把鼠标移到工作区行上,点右侧的省略号;也可以在行上右键。菜单里有:

  • 打开于:用 VS Code、文件管理器或自定义应用打开该目录。自定义应用需要先选择程序并命名。
  • 复制路径 / 复制名称 / 复制当前分支:只复制文本;分支项只在 Git 工作区出现。
  • 从列表移除:把工作区从 Fynvra 列表里移除,不会删除磁盘上的项目目录。

主 Agent 每次派发会给任务建一个独立的 git worktree,分支名是 fynvra/<slug>。默认放在仓库同级的 <仓库目录名>-worktrees,可以在「设置 → 通用 → Worktree 位置」里选择其他目录或恢复默认;「磁盘占用」会列出每个工作区当前的 worktree 数量和大小。

任务合并后主 Agent 会清理对应 worktree。需要临时看某个已清理 worktree 的历史改动时,从任务详情的「查看改动」进入。