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

第5章 添加你的第一个项目

添加你的第一个项目 将代码仓库导入 Jean,在侧边栏中整理,并决定第一天需要多少自动化。项目是 Jean 中的顶级单元。 一旦添加项目,Jean 可以立即为其创建一个基础会话,并围绕该仓库打开后续工作流程。

添加仓库 在侧边栏中选择「新建」,然后选择「项目」。 Jean 会添加该仓库,在侧边栏中展开并选中它,还可以自动打开一个基础会话,让你立即开始工作。 你也可以从同一菜单中选择「克隆项目」,直接从 Jean 克隆远程仓库并一步完成添加。

文件夹与项目 Jean 允许你在侧边栏中创建文件夹。 在以下情况下使用文件夹: 将相关仓库分组 将客户工作与内部工作分开 在拥有众多仓库时保持侧边栏整洁

当条目指向真实的 git 仓库时,使用项目。

接下来会发生什么 当项目被添加时,Jean 可以: 打开项目画布 自动创建基础会话 如果你尚未见过,提供 jean.json 向导 这意味着你可以从「选择仓库」几乎无缝地过渡到「与智能体对话」。

添加 jean.json jean.json 是 Jean 从仓库根目录读取的项目级自动化文件。它可以定义: 在工作树创建后运行的设置脚本 在工作树删除前运行的清理脚本 终端中一个或多个运行命令 开发服务的命名端口

示例: { "scripts": { "setup": "bun install", "teardown": "docker compose down", "run": ["bun run dev"] }, "ports": [ { "port": 3000, "label": "App" }, { "port": 5173, "label": "Vite" } ] } Jean 还会向这些脚本暴露一些有用的变量:

$JEAN_WORKSPACE_PATH $JEAN_ROOT_PATH $JEAN_BRANCH

起初保持简单 你的第一个 jean.json 不必完美。从以下开始: 如果你的工作树需要初始化,添加单个设置命令 如果你启动本地开发服务器,添加一个运行命令 仅当命名端口能帮你提高效率时才使用

项目级设置 项目创建后,你还可以自定义: 头像 默认后端 默认提供商 默认 CLI 配置文件 启用的 MCP 服务器 自定义系统提示词 Linear API 密钥和团队筛选 用于共享上下文流的链接项目(参见项目链接)

「项目设置」还有一个内置的 jean.json 面板,无需打开编辑器即可在应用内编辑自动化文件。

工作树位置 默认情况下,Jean 在 ~/jean// 下创建工作树。 「项目设置」中「常规」选项卡里的「工作树位置」部分允许你按项目覆盖基础目录。Jean 总是在你选择的基础目录下追加项目名称,因此多个项目可以共享同一个自定义基础目录而不会冲突。在以下情况下使用此功能: 默认主目录空间不足 你希望将工作树放在更快的驱动器上 你希望将项目的工作树归组到现有的工作区文件夹下

延伸阅读

开始你的第一个会话 项目、工作树和会话 后端、模型和 MCP 安装与设置安装 Jean,连接你偏好的后端,并完成首次运行设置。开始你的第一个会话选择一个基础会话或工作树,选择正确的后端,并发送第一条消息。

评论 (0)