进阶 jean.build 2026-10-18 10:33:18 · 25 阅读

第2章 Jean 工作原理:项目、Worktree 与会话的流转机制

Jean 的工作原理

理解从项目到工作树(worktree)再到会话的流转过程,以及 Jean 如何将这一切紧密关联。Jean 的设计理念是让 AI 辅助工作遵循真实开发工作的边界。它不再为每个仓库维持一条无尽的线程,而是提供一套贴合实际任务执行方式的结构。

核心循环

Jean 中的大多数工作流程都遵循相同的循环:

- 添加一个项目。 - 打开一个基础会话(base session)或创建一个 worktree。 - 在该工作区内启动一个或多个聊天会话。 - 根据需要从文件、MCP、GitHub 或 Linear 中附加上下文。 - 使用内置命令处理提交、代码审查、PR、笔记或问题排查。 - 任务完成后,归档、恢复、合并或移除该工作区。

主要构建模块

项目 项目是 Jean 所识别的仓库。项目也可以存放于文件夹内,以便在管理多个仓库时保持侧边栏的可读性。

基础会话 基础会话直接在项目的主目录和基础分支上下文中运行。当你只需检查代码、提问或进行小幅修改,而不想创建单独的 worktree 时,请使用此模式。

Worktree Worktree 是一个拥有独立路径的隔离分支。当你需要清晰的业务边界、独立的终端状态、更安全的实验环境,或同时处理多个任务时,请使用此模式。

会话 会话是基础会话或 worktree 内部的一个聊天标签页。你可以为同一任务空间保留多个会话,为它们配置不同的模型或后端,将它们归档,或者稍后再回来继续。

UI 的工作状态

主窗口有三种主要状态:

- 欢迎视图:未选中任何内容时 - 项目画布:选中了项目但未打开工作区聊天时 - 聊天窗口:基础会话或 worktree 处于激活状态时

项目画布是 Jean 汇总 worktree 状态、会话状态、Git 信息、PR 状态及快捷操作的地方。聊天窗口则是你与后端交互、批准计划、检查工具调用、管理标签页、查看文件以及打开终端面板的地方。在 Linux 上,Jean 提供原生窗口控制,而不依赖系统边框,以确保跨桌面环境的一致性。

首次运行向导

当 Jean 首次启动时,一个简短的功能向导会带你浏览应用的主要区域:侧边栏、画布、聊天、魔法菜单(magic menu)和偏好设置。你可以随时关闭向导,并稍后通过命令面板重新打开。

上下文的流动

Jean 可以从多个来源获取上下文:

- 当前仓库及 worktree 文件 - 全局、按项目或按会话启用的 MCP 服务器 - 已加载的 GitHub issue、PR、工作流和安全上下文 - 已加载的 Linear issue 上下文 - 保存的上下文快照及链接项目

关键在于上下文的作用域(scoping)。会话属于一个工作区,Jean 会将相关状态保留在该工作区内,避免将其扩散到不相关的任务中。

为何这种模式很重要

这种结构让几件事变得更容易:

- 你可以保持多个任务活跃,而不会混淆它们的分支或对话 - 你可以回顾旧会话,而不会丢失周围的仓库上下文 - 你可以切换后端或提示词,而无需更改整个项目设置 - 你可以干净地归档工作,而不必将一切都保留在活跃视图中

延伸阅读

- 开始你的第一个会话 - 项目画布与聊天 - 魔法命令 - 什么是 Jean:面向团队和独立开发者的实用入门,旨在提供不牺牲控制权的本地 AI 工作流 - 本地优先与安全:Jean 存储什么、什么保留在本地,以及如何保障 Web 访问安全。

评论 (0)