第7章 Jean 核心工作流解析:Projects、Worktrees 与 Sessions 详解
Projects、Worktrees、Sessions
Jean 用来保持 AI 工作有序、可恢复的核心对象。Jean 新手阶段感觉简洁、用起来多了以后依然顺手,靠的就是这套模型。
层级结构
Jean 这样组织工作:
``` 文件夹 └── Project ├── Base session │ └── Session 标签页 └── Worktree └── Session 标签页 ```
Project
Project 是 Jean 能操作的代码仓库。
每个 Project 可以保存这些默认配置:
- backend - provider - worktree 目录 - MCP server 选择 - 自定义 system prompt - Linear 设置 - 关联的 projects
Base session
Base session 直接使用 project 的主目录。
可以把它理解为“待在主干上”的选项。适合这些场景:
- 浏览一个陌生仓库 - 只做很小的改动 - 做 review 或规划工作 - 不想折腾分支管理
Worktree
Worktree 是基于分支的工作区,有自己独立的路径和生命周期。
Jean 会为每个 worktree 记录元数据,包括:
- 分支和路径 - setup 脚本执行结果 - PR 关联 - 来源(issue、PR、security、Linear 或 Mr. Robot) - worktree 标签(包括固定在 project 筛选器上的标签) - 缓存的 git 和 PR 状态 - 归档状态
适合用 worktree 的场景:
- 任务需要隔离 - 想保留独立的终端状态 - 可能需要切走、之后再回来 - 在同一个仓库上并行处理多个任务
Session
Session 是 base session 或 worktree 里的一个对话线程。
Session 也会保存 UI 和工作流状态,比如:
- 选中的模型和 backend - provider 和执行模式 - 审批状态 - recap 摘要 - review 结果 - 待回答的问题或权限请求
当一个对话超出 base 分支的范围,或者你想在不丢失聊天记录的前提下做隔离的后续工作时,可以把 session fork 成一个新的 worktree。
归档 vs 删除
关闭条目时,Jean 可以根据你的偏好选择归档或永久删除。
归档适合想要保持活动工作区清爽、但又不想丢失对话或 worktree 记录的情况。
标签、时间与未读工作
Jean 还会记录足够的元数据来帮你恢复工作:
- session 标签和多标签的 worktree 标签 - 最近打开时间 - 最近活动时间 - 未读 session 状态 - 最近归档的条目
这让画布更像一个工作队列,而不是一棵原始的文件树。
延伸阅读
- Backends、Models 和 MCP - Project 画布与聊天 - 归档、恢复与更新 - 开始你的第一个 Session —— 选择 base session 或 worktree,选好 backend,发出第一条消息。 - Backends, Models, and MCP —— Jean 如何选择 backend、路由模型设置,以及如何把额外的工具引入 session。