# 版本说明

每个版本新增、改进和修复了什么。已经装了 gtree 的话,有新版本时侧栏底部会提示「更新并重启」。

## v0.3.15 (2026-10-15) — agent 干活时更省 CPU,发给 agent 的话也有英文了

### 改进
- agent 在干活时,gtree 自己占的 CPU 少了一半。agent 状态的转圈、铃铛,原来按屏幕刷新率重画,现在每秒约 12 次。实测 3 个 agent 在干活、1 个在等你时,gtree 从 8.6% 降到 4.4%(单核);什么都没在跑时仍在 1% 以下。
- gtree 发给 agent 的话跟着界面语言走:中文界面发中文,其他语言发英文。包括同一个 worktree 里别的会话刚改过某个文件时的提醒、别的会话的留话、会话开头「谁在干什么」的说明,以及 gtree MCP 工具的说明。
- 开始页「还没连上 Claude Code」的提示改成一张卡片:说明占满一行,按钮另起一行,不再被挤成窄窄一列。
- 首次打开的引导文字跟上了现在的界面:同一个 worktree 里的 agent 改同一个文件前会先商量;「AI 每一轮」和 ⌘Y 代替了原来的时间线;「待处理」代替了原来的协作视图。
- 状态的悬停提示开头从「Claude ·」改成「AI ·」,Codex 的会话也用它。

### 修复
- 空仓库里,文件树的加载占位一直在闪,不会消失。
- 界面是英文或日文时,「历史对话」回放里的工具步骤(如「编辑 src/theme.ts」)显示成中文。
- 开始页的同改清单里,文件路径可能被挤得看不见。现在涉及的 worktree 放到第二行。
- 「待处理」不再提示「去工作台看」(工作台已经没有了),只写还有几组。
- 设置里 Claude Code 各个 hook 的说明不再提工作台和时间线。团队版的说明不再列「队友」(它已经在免费版里),并写明中转服务器只转发同步信息、不存储数据。

## v0.3.14 (2026-10-15) — 重开还是关闭前的样子,点一下就能看 diff

### 改进
- 关掉 gtree 再打开,之前打开着的项目、停在哪个项目、每个项目选中的 worktree 都还在,不用重新加一遍项目。
- 开始页的「看改动」,以及在右边「改动」里点一个文件,都会在中间直接打开 diff:左边是改动的文件,右边是内容,新建的文件也能看。暂存和取消暂存只用行尾的 + / −,点文件本身不会再把它暂存。
- 开始页的「用编辑器打开」改成「打开文件」:右边切到文件树,同时弹出 ⌘P 找文件。选中的文件在 gtree 里打开,可以直接改、保存。
- 分支变基后和远端不一致时,开始页不再同时提示「拉取」和「推送」,改成一条「变基后和远端的这条分支不一致了」,按钮是「推送(覆盖远端)」,点了先确认。远端有别人新推的改动时不会出现这一条。
- 一轮详情里很长的回复默认只显示 4 行,可以展开,下面的改动不会再被挤出屏幕。
- 侧栏项目、「已合并」、「AI 临时工作区」、「AI 每一轮」、开始页的同改清单,展开和收起都有过渡动画,展开时一行一行依次出现。「AI 每一轮」收起时标题不动。

### 修复
- 全局搜索里点文件范围框,搜索框不会再被关掉;⌘⇧F 现在总是打开搜索,再按一次不会把它关掉。
- 侧栏选中的线有时会跳到另一条。
- 开始页的同改清单只列和当前这条线有关的,换到别的线不会再带着别人的清单。
- 「AI 每一轮」里换会话的分隔线压住下一行文字。

## v0.3.13 (2026-10-14) — 右边面板更清楚:标签一眼看出能切换,提交信息框随内容变高

### 改进
- 右边面板的「文件」「改动」两个标签换了样子:选中的那个文字更深、下面有下划线,一眼看得出能切换。「改动」后面是还没提交的文件数,「文件」后面不再显示仓库的文件总数。
- 「改动」标签重新排版。工作区干净时,上面只留一行「未提交改动　干净」,空间都给下面的「AI 每一轮」。「全部丢弃」收进了「⋯」菜单。
- 「AI 每一轮」每轮占两行:第一行是你的提问和时间,第二行是改了几个文件、是哪些(如「3 个文件 · root.rs 等」)。左边的彩色竖条去掉了,不同会话之间用一条线隔开。「显示没改文件的轮」和「旧版快照」收进了「⋯」菜单。
- 「AI 每一轮」可以收起:点它的标题,收起后只在面板底部留一行。下次打开还是收起的。
- 写提交信息的框随内容变高,最多 4 行,再多就在框里滚动。长一点的提交信息也能看全,上面的文件列表也不会被挤没。
- 「待处理」里,AI 在干活的转圈图标会转,在等你的铃铛会闪,和侧栏一样。

### 修复
- AI 页的标签被压得只剩一个图标,看不到名字(0.3.12 引入的问题)。

## v0.3.12 (2026-10-14) — 新布局:点一条线就知道下一步做什么,侧栏显示 MR 状态

### 改进
- 界面重新布局。左边侧栏只剩「待处理」「提交历史」和你的项目。点项目里的一条线就进到它的主页:开着会话的进对话,闲着的显示这条线的开始页。原来的「工作台」取消了。快捷键:⌘1 待处理,⌘2 当前 worktree,⌘3 提交历史。
- 开始页列出这条线现在的状况,每种情况配一个按钮:已经合并(删除 worktree / 换一条新分支)、别处也在改同一个文件(看是哪些)、有没提交的改动(看改动)、远端有新提交(拉取)、还没推送(推送)、开着的 MR(打开 MR)、还没有 MR(创建 MR)、落后于主分支(变基)。下面一排是新开 Claude Code / Codex、打开终端、用编辑器打开。
- 右边的面板分成「文件」和「改动」两个标签(⌥⌘B 开合,⇧⌘E / ⌃⇧G 切换)。「改动」里是没提交的文件(在这里暂存、提交)和 AI 的每一轮,点一轮就在中间看它改了什么。原来的「改动」视图改名「提交历史」。
- 侧栏的分支后面显示 MR 状态:没合并的是 pull request 图标,已合并的是浅色的合并图标。鼠标停上去能看到编号、标题和链接,点一下在浏览器打开。用的是你电脑上已经登录的 glab 或 gh,支持 GitLab(包括公司自建的)和 GitHub;两个都没装就不显示。
- 侧栏每条线的行尾只放一个标记:AI 会话的状态(在干活、在等你等),别处也在改同一个文件(琥珀色 △),或者没提交的改动有多少行(如「+24 −3」)。鼠标停上去有说明。
- 分支已合并、也没在用的线,收进侧栏底部的「已合并 · N」。在平台上 squash 合并、git 自己认不出来的也算。
- 在侧栏右键一条线,打开 Git 菜单(推送、拉取、提交、切分支、删除 worktree 等)。worktree 多的时候,项目名固定在顶上,随时能点它收起。
- 侧栏里 AI 正在干活或在等你的线,不管在哪一页,点它都直接打开那个对话。
- AI 页不再自动启动 Claude Code,只是点进来看一眼不会多出一个会话。要开会话就点开始页的「新开 Claude Code」或按 ⌘T(装了 Codex 时可以选)。
- 历史对话改成 AI 页顶部的小窗(⌘Y):直接打字搜索,↩ 接着聊,⌘↩ 只看不接。在列表里单击一条也是接着聊。
- 用 ⌘W 关掉正在跑 Claude Code 的标签页时会先问一下。可以勾「不再询问」,之后在设置里改回来。

### 修复
- 「答完了,等你回复」的铃铛,切到那个终端标签页就会消失,不用再发一句话。
- 在「待处理」点一行,会切到那件事所在的会话标签页;列表刷新时,键盘选中的那一行不会再跳走。
- 快速连点顶栏里的按钮,不会再把窗口放大。
- 终端里被折成两行的长网址,按住 ⌘ 点击也能打开了。

## v0.3.11 (2026-10-13) — 工作台一眼看出先管哪个,「待处理」重做

### 改进
- 工作台改成每个 worktree 一行、按急缓分组:要你处理的(在等你、合并冲突)排最前,没改动、没有 AI 在干活的折起来,分支已合并的也一样。第一行是完整的分支名,第二行是 worktree 名和改了什么;按钮鼠标移上去才出现。
- 两个 worktree 改了同一个文件,改为写在那一行里、点开看文件清单,不再常驻橙色横幅。
- 工作台、状态栏、文件树和搜索里的状态颜色只剩四种意思:红色是要你处理,琥珀色是有风险,紫色是 agent 在干活,绿色是已暂存。
- 连上 Claude Code 或 Codex 后,agent 在会话开头(以及你提到 worktree 时)会拿到一份可以直接复用的 worktree 清单,不用再新建一个。
- 「待处理」重做:点一行就进到那个会话,也可以用 ↑↓ 选、↩ 进入、⌫ 收起。
- 去掉了「待处理」右边的「AI 往来」栏:agent 之间正在问的问题、给对方的留话,改为挂在相关那一行下面。「也许要留意」里还会出现:等另一个 agent 回答等太久、留话一直没送到、你问的 agent 回答了(点一下就地展开)。
- 「待处理」的列表和项目关系图各自滚动;关系图可以双指拖动、捏合缩放,双击空白处整张图放进窗口。
- 跨文件搜索(⌘⇧F)改版:边输入边出结果,按文件分组、命中处高亮;可以区分大小写、全词匹配、只搜有未提交改动的文件,也可以用 `*.rs  !tests` 这样的写法限定范围。
- 内嵌终端:按住 ⌘ 点链接直接打开;⌘← / ⌘→ 跳到行首 / 行尾,⌥← / ⌥→ 按词移动;从 Finder 拖文件进来会填入路径,拖进图片 Claude Code 也能认出来。
- 打开文件时,文件树会自动展开到那个文件。
- AI 页的历史对话按今天 / 昨天 / 近 7 天 / 更早分段,滚动时分段标题留在顶上。

### 修复
- gtree 没开着的时候(比如 ⌘Q 退出后),在别的终端里用 Claude Code 或 Codex,不会再收到 gtree 的通知。
- 点「继续这个会话」时,如果它已经开在 gtree 的某个终端标签页里,会直接切过去。
- 搜索结果按 ↩ 能打开了;路径里有中文等字符的结果也能打开了;新结果不会再被前一次搜索替换掉。
- 带换行的会话标题不再把历史对话列表撑乱。
- 项目关系图不再被撑宽、右边被裁掉;不再出现名为「/」的项目。

## v0.3.10 (2026-10-10) — 打开的文件可以直接改了

### 新增
- 打开的文件可以直接编辑:⌘S 保存,切到别的文件时自动保存。
- 打开之后文件在别处(比如被 agent)改过的话,保存时不会悄悄覆盖,由你选重新载入还是仍然覆盖;切走时的自动保存遇到这种情况也不覆盖,只提示哪个文件没存上。
- 不是 UTF-8 编码的文件以只读方式打开。

### 改进
- 侧栏、文件面板、AI 历史栏的收起 / 展开按钮统一成同一个面板图标。

## v0.3.9 (2026-10-10) — 连上 Codex,agent 之间自己商量,新增「队友」

### 新增
- 连上 Codex:在设置里点「连上 Codex」,Codex 会话就和 Claude Code 一样 —— 在干什么、什么时候在等你一眼看清,在等你的进「待处理」,每一轮的改动都记下来、可以按轮恢复,不用再去 Codex 里逐条批准。
- AI 视图的「+」可以新开 Codex,和 Claude Code 并排跑在内嵌终端里;「历史对话」也能搜到、回放 Codex 的会话。
- 同一个工作区里的 agent(Claude Code 或 Codex)互相知道对方:一个改了另一个也改过的文件,对方会自动收到通知;要改同一处时会给对方留话、商量谁先改,先改的一方做完会告诉另一方。
- 新增「队友」,默认关、按仓库开:最近有别人提交的仓库,侧栏项目下会出现「队友」一节,点「开启」、再点「开始同步」后,你和队友经团队自己的 git 仓库互相看到还在写的代码(包括没提交的),点开就能看对方的改动。
- 和队友改到同一处时,你的 AI 会在动手前先停下来问你;「待处理」里也会提醒,点「看对方的改动」直接看。
- AI 可以给队友留话:对方本人看过、点「交给我的 AI」后才会交给他的 AI,回复会自动回到发问的那个 AI。
- 队友之间的内容都带签名,留言只有收件人能解开,仓库里的其他人冒充不了队友;队友的身份变了,要你确认是本人才继续接收。

### 改进
- 状态栏的「别处开着的 AI」点开是一份会话列表:问的什么、多久前、在干什么,点一行就切到对应的终端;认不出在哪的,打开这段对话的回放。
- 文件树右键可以在浏览器中打开、用默认程序打开、在 Finder 中显示、在终端中打开(在 gtree 的内嵌终端里)和复制路径。

### 修复
- 引导翻页时不再闪出别的画面;最后一页的动图换成了「连上 Claude Code」的演示。
- 同一个工作区并行跑长命令时,文件不再被算到别的会话名下;测试输出里的「0 failed」也不再被当成报错。
- Claude Code 的连接说明里,去掉了应用实际不会显示的「出错 / 卡住」状态。

## v0.3.8 (2026-10-09) — 新增「待处理」和系统通知,导航收成 4 项

![gtree 的「待处理」页:最上面是在等你的会话,每条带「打开 →」;下面「也许要留意」列出两个 worktree 改了同一个文件;最下面是正在干活的 AI](/media/app/inbox-zh-light.webp "新的第一屏「待处理」:谁在等你、哪里改重了,一页看完")

### 新增
- 「待处理」成为第一屏,只回答一件事:现在有没有要你处理的。在等你的 AI 按等了多久排在最前,下面是也许要留意的事,比如两条分支改了同一个文件。
- AI 停下来等你(要授权,或者答完一轮在等你回复)时,发一条 macOS 系统通知,点一下跳到那个会话;Dock 图标上显示有几件事在等你。
- 同一个 worktree 里开着两个 Claude Code 会话时,一个 AI 要改另一个刚改过的文件前会先收到提醒,不会互相覆盖。
- 设置里可以直接从这台 Mac 删除 gtree:断开 Claude Code、删掉 gtree 的数据(打算重装也可以保留),再把 app 移到废纸篓。

### 改进
- 导航从 7 项收成 4 项:待处理 / 工作台 / 改动 / AI,⌘1–⌘4 依次对应;「改动」里分成 AI 改动、提交历史、对比。
- 连上 Claude Code 只要点一下:引导最后一页、工作台提示条、空的「AI 改动」页都能直接连,通知权限一并询问,不用再去终端敲命令。
- 打开「对比」就有内容:默认是主分支 → 当前 worktree。

### 修复
- 几百个分支的仓库不再把整台 Mac 拖慢。
- 关掉终端标签时,里面的 Claude 会一起结束;同一个 worktree 开多个 Claude 标签时,状态不再互相覆盖。
- 从「下载」文件夹直接打开 gtree 时,更新和连上 Claude Code 不再失败,还能一键把它移到「应用程序」。

## v0.3.7 (2026-10-09) — gtree 放在哪都行,Claude Code 集成不会失效

### 改进
- 把 gtree.app 挪到别的文件夹后,和 Claude Code 的连接不会再悄悄断掉;已经连上的,首次启动时自动切换过来。

### 修复
- 安装命令在部分终端里报「unbound variable」、装不上的问题修好了;0.3.3 起很多新用户因此没装成。

## v0.3.6 (2026-10-09) — 新用户安装当天就能正确计入使用统计

### 修复
- 新安装的用户当天就能被匿名使用统计正确计入;仍然是先告知、后统计,可以在设置里关闭。

## v0.3.5 (2026-10-09) — 浏览器下载的安装包也能顺利打开

### 修复
- 浏览器下载的 zip 打开时不再提示「gtree 已损坏,无法打开」:安装包已完整签名,首次打开只需在「系统设置 → 隐私与安全性」里点「仍要打开」。

## v0.3.3 (2026-10-09) — 在设置里一键接入 Claude Code

![gtree 设置面板里的「Claude Code 连接」:显示「未连上」,旁边是「连上 Claude Code」按钮,下面写着连上之后能做什么](/media/app/settings-claude-not-connected-zh-light.webp "在设置里点一下就能连上 Claude Code,连上能做什么、会改动什么都写在旁边")

### 新增
- 设置里新增 Claude Code 集成:一键安装,用大白话讲清为什么要装、会改动什么;还能改安装位置、逐条查看和开关 hook,或者卸载。
- Claude Code 集成没装或需要更新时,工作台顶部出现提示条,点一下直达设置。
- AI 标签可以拖动排序,标签多了放不下时可以横向滚动。
- 设置里预告了即将推出的团队版:说明、预计价格和早鸟名单入口。

### 改进
- 时间线顶部用一句话说明用途,默认只列改了文件的轮次,系统消息和 Markdown 都显示成好读的文字。
- 侧栏、文件面板、AI 历史栏的开合改成顺滑的动画。
- 命令行输出和 `gtree --help` 跟随界面语言。

### 修复
- 侧栏开合过程中,内容不再压到窗口左上角的按钮上。
- Claude Code 子 agent 结束后,历史对话不再一直显示「正开在别的终端里」,可以正常接着聊。

## v0.3.2 (2026-10-09) — 界面支持英文和日文,新增首次启动引导

![gtree 设置的「通用」部分:语言可以在 English、日本語、中文之间切换,下面是「新手引导」的「重新查看」按钮](/media/app/settings-general-notifications-zh-light.webp "设置里随时切换界面语言,也能重看一遍新手引导")

### 新增
- 界面支持英文、日文和简体中文,默认跟随 macOS 语言,也可以在设置里切换,立即生效。
- 侧栏左下角新增齿轮按钮,点开就是设置,上面标着当前语言。
- 新用户第一次启动会看到 6 页的新手引导,之后随时可以在「设置 → 通用」里重新查看。

### 改进
- 打开了 macOS「减弱动态效果」时,新手引导只做淡入淡出。
- 安装命令的终端输出改成英文。

### 修复
- 英文、日文界面下工作台面板标题不再被截断。
- 协作视图的卡片不再把系统标签当成你的提问显示出来。

## v0.3.1 (2026-10-08) — 新增设置面板,随时开关匿名使用统计

### 新增
- 新增「设置」(⌘,,或菜单栏 gtree → 设置…),第一项就是匿名使用统计的开关,随时可以打开或关闭。

### 改进
- 首次启动时的统计说明改成大白话,并告诉你可以在设置里关掉。

## v0.3.0 (2026-10-08) — 时间线:AI 每一轮的改动都能回看、能恢复

![「AI 改动」页:中间列出改了文件的几轮,右边是选中那一轮的提问、Claude 的回复、改动的文件和 diff,右上角是「恢复到这一轮」](/media/app/ai-changes-timeline-zh-light.webp "每一轮的提问、回复和改动都记下来,点「恢复到这一轮」把这一轮动过的文件退回去")

### 新增
- 「快照」改成「时间线」:Claude Code 每答完一轮,gtree 记下你的提问、它的回复和改了哪些文件,可以逐轮看 diff,把那一轮动过的文件恢复回去,不碰分支和暂存区。
- 新开的 Claude Code 会话一开头就知道同一个 worktree 里上一个会话做到哪:问了什么、最后说了什么、改了哪些文件。
- AI 自己就能翻以前几轮的记录,其他项目的也能查。
- 提交图上可以显示 AI 每一轮结束时的样子,像一条从当前提交长出来的分支,用工具条上的开关显示或隐藏。
- 协作视图顶部给每个在干活的 AI 一张卡片,写着它在做什么、上一轮做到哪,在等你的排在最前。
- 「去看看」直接跳到某个 worktree 里正在干活的 Claude:开在 gtree 里的切到它的 AI 标签,跑在你自己终端里的打开只读回放。

### 改进
- 下载和更新改走 gtree 自己的下载服务器,连不上时自动改连 GitHub。
- 新增匿名使用统计,第一次启动时先告知再上报;可以在告知卡片里关掉,或设置 GTREE_NO_TELEMETRY=1。