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

第10章 项目 Canvas 与对话窗口

第10章:项目 Canvas 与对话

在 Canvas、会话标签页、终端、文件和快捷键之间无缝切换,确保工作脉络不断。 Jean 的日常主要活跃在两个地方:项目 Canvas 和对话窗口。 Canvas 负责选择和管理工作,对话窗口则负责执行。

项目 Canvas 当你选中一个项目但当前没有激活的工作区对话时,就会看到项目 Canvas。 它提供了一个整合视图,涵盖: worktrees 会话卡片 活动状态 git 状态 PR 状态 运行脚本可用性 针对编辑器、终端、Finder 和 GitHub 的快捷打开操作 Issues、PR、Mr. Robot 工作以及置顶 worktree 标签的筛选标签页

这是回答“这个仓库当前有哪些正在进行的工作”的最佳入口。

会话状态概览 Jean 通过以下状态提示对活跃工作进行分组: 等待输入或批准 规划中 正在执行 待审查或已完成

这让你更容易在重新投入某个会话前,识别出哪些会话需要你的关注。

对话窗口 当你打开基础会话或 worktree 时,Jean 会切换到对话窗口。 在这里你可以: 发送消息 切换标签页 批准计划 回答 Agent 提问 检查工具调用 预览文件和图片 打开差异对比(diff) 在对话旁边保留终端面板 使用 Cmd/Ctrl+F 搜索对话历史 在后端忙碌时,将后续提示词加入队列

会话与 Worktree 标签 每个会话都带有标签和摘要,方便你重新进入时快速回顾: 会话标签 - 从预设中选择,或分配自定义颜色,以在 Canvas 上区分活跃会话 摘要 - 当你返回会话时,Jean 可以自动生成简短摘要,你也可以按 R 键手动触发。Experimental 面板允许你选择生成摘要的模型。

Worktrees 也可以拥有多个标签。在项目 Canvas 中,使用“设置标签”功能添加自定义标签、更改标签颜色、将标签置顶为项目筛选标签,或在确认后删除自定义标签。即使只可见部分匹配的 worktrees,置顶标签仍可作为筛选器使用。 标签和摘要确保即使会话数量众多,Canvas 依然好用。

运行中的回合与队列提示 当支持的后端正在运行时,Jean 会将后续输入关联到同一会话,避免丢失。当启用自动转向(auto-steer)时,Codex、OpenCode、PI 和 Grok 可以将纯文本后续指令引导至正在进行的回合;其他后续指令则会被排队,并在当前运行结束后发送。你还可以在发送前编辑队列中的提示词。 对话界面还会将引导提示显示为独立行,以便你区分哪些内容是在运行中途添加的。当后端生成 Task/Agent 子智能体时,Jean 会在对话中展示它们的最终报告,让嵌套工作可视化,无需翻阅工具日志。

会话调试面板 会话调试面板显示会话的底层状态: Jean 从磁盘读取的文件路径 运行脚本日志 Token 用量和成本细分 后端参数和环境快照

当会话行为异常或需要确认后端实际看到的内容时,请打开此面板。

终端与文件工具 Jean 的对话工作流不仅限于文本。 在工作区中你可以: 运行 jean.json 中配置的项目命令 检查文件内容和预览 打开 git 差异对比 在你首选的编辑器或终端中打开工作区 当需要更大的临时终端且不想离开对话时,弹出模态终端抽屉 这将“沟通部分”与“检查部分”保持在一起。

跨项目 GitHub 仪表盘 命令面板可以打开一个跨项目 GitHub 仪表盘,聚合 Jean 中所有项目的 issues、PR 和 workflow 运行状态。 当你希望在恢复某个 worktree 之前获得开放工作的单一视图时,请使用此功能。

命令面板 在 macOS 上按 Cmd+K,在其他系统上按 Ctrl+K,即可打开命令面板。 它包括: 项目切换 导航 设置 GitHub 操作 会话操作 窗口控制 一旦工作区变得拥挤,这通常是最快的导航方式。

值得学习的几个默认快捷键 常用默认快捷键包括: Cmd+L 聚焦对话输入框 Cmd+B 切换左侧边栏 Cmd+, 打开偏好设置 Cmd+M 打开魔法菜单 Cmd+N 创建 worktree Cmd+T 创建新会话 Cmd+Shift+F 打开已完成/未读会话弹出菜单 Shift+Tab 循环切换执行模式

接下来阅读 魔法命令 GitHub、Linear 和审查 偏好设置与定制 项目链接 在相关仓库间共享上下文,让 Agent 无需复制粘贴即可跨项目边界读取。 浏览器上下文抓取 将源自感知(source-aware)的 DOM 上下文直接从 Jean 的内嵌浏览器发送到对话中。

评论 (0)