用 JetBrains ThinkRail 让每个 Agent 任务各占一个工作区：worktree 隔离、规格图与并行会话实操

两条路：命令行与桌面应用，两者用的是同一套引擎宿主，区别只在载体。命令行路线从仓库拉安装脚本，脚本会校验二进制校验和并把 thinkrail 加进 PATH；装完在终端敲 thinkrail，它以浏览器作为前端打开同一套界面。桌面应用提供 macOS 14 及以上（Apple Silicon）、Windows x64、Linux x64 与 ARM64 的包，Linux 桌面包还依赖 glibc 2.38 及以上、GTK 3、WebKitGTK 4.1、Ayatana AppIndicator 3 与 librsvg 2。发布页同时提供 SHA256SUMS，手工下载时用它校验。

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash

# Windows（PowerShell）
powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"

# 装完启动（浏览器前端）
thinkrail

# 应用状态与工作区落点
~/.thinkrail/

装完先确认一件事：Git 必须已经在 PATH 里。它的一切隔离都建立在 git worktree 之上，没有 Git 就只剩一个编辑器。另外它是 JetBrains InnovationHub 的孵化项目，版本还处在 0.x、夜间构建每隔几天就有一次，所以「今天装的版本」和「文档里的截图」对不上是常态。

ThinkRail 不设账号体系。你可以用 JetBrains AI 登录，也可以用任何已经通过 pi 配好的提供方，覆盖 Anthropic、OpenAI 与本地模型。关键在于它是复用而不是重建：如果你已经在用 pi，API 密钥、模型配置、权限规则、技能与 MCP 服务都会被自动识别沿用。MCP 服务来自 pi 的 mcp.json，跨客户端通用的 Agent Skills 就地读取，不需要为了换个界面把配置重新填一遍。初次启动会引导你连接提供方。

它会沿用 pi 的这些配置
- 模型提供方与 API 密钥
- 权限规则
- Agent Skills（跨客户端通用格式，就地读取）
- MCP 服务（来自 pi 的 mcp.json）

非只读的 MCP 调用：在对话里先问你，再执行

这里有个分工值得记住：pi 拥有模型、技能、上下文压缩、成本与会话状态，ThinkRail 拥有工作区、编辑器与连线，它从不在你背后拼提示词。也就是说，你在界面上看到的配置就是真实生效的配置，没有一层隐藏的包装。

一个项目就是本机任意一个 git 仓库：可以打开已有仓库，也可以「新建项目」让它帮你建一个空仓库。项目之下是工作区，一个工作区就是一个从仓库切出来的 git worktree，带自己的分支与工作目录，一次点击就能建，列在侧栏里，不需要了就丢掉。已经存在的 worktree 也可以挂进来。你也可以直接在项目目录里工作，但那就等于放弃了隔离——这一步是整套方法的核心，不建议省。

~/code/my-repo                 ← 项目（一个 git 仓库）
└─ ~/.thinkrail/worktrees/
   ├─ feature/auth             ← 工作区 1，Agent A 在改
   ├─ fix/flaky-test           ← 工作区 2，Agent B 在修
   └─ spike/ideas              ← 工作区 3，你自己探索

每个工作区自带：分支 + 工作目录
文件、diff、终端与会话都限定在它内部
完成或闲置的工作区可以收进项目级的 shelf

工作区之间的切换是瞬时的，不重载、不串味。合并满意的那个，删掉其余的，你的主检出从头到尾没有被碰过——这就是它那句「Agent 该有自己的 worktree，而不是你的工作树」的意思。

很多 Agent 项目跑偏的根源是「意图只存在于会话里」：人讲过一次，模型记住了，会话一关就什么都没了。ThinkRail 在代码旁边维护一组互相连接的 SPEC.md 文件，构成一张规格图：Agent 通过专门的规格工具读取、搜索与更新它，界面上是只读的树状视图。规格是带元数据的 Markdown，用来定义软件应当有什么行为；规格引用会内置进系统提示，所以意图能跨会话活下来。

规格驱动的三件事
1) 规格图：代码旁一组互连的 SPEC.md
2) Agent 侧：用 spec_* 工具读、搜、更新
3) 人侧：只读的 Specs 视图以树形呈现

意图随会话存活，不随会话消失

它还提供了几个内置工作流：项目搭建、设计头脑风暴、发拉取请求。这些工作流本质上就是把「先写规格再写代码」这件事固化下来，省掉你每次重新组织提示词。

一个工作区里可以同时开多个 pi 会话，每个会话独立选模型，并实时显示 token 与成本读数。跑起来的会话可以中途引导、排队下一条指令、把活派给子 Agent，也可以直接编辑它们共享的那份计划。界面这一侧配的是 Monaco 编辑器标签页、带 git 改动标记的文件树、实时 diff、真实 PTY 终端（限定在该 worktree 内），以及可以锚定到文件和 diff 上的审阅评论。

一个工作区内的多个会话
- 每个会话独立选模型
- 每个会话有实时 token 与成本读数
- 可中途引导、排队后续指令、派子 Agent
- 共享一份可编辑的计划

内置工作流：项目搭建 / 设计头脑风暴 / 发拉取请求

界面语言内置英语与简体中文，也支持自定义语言文件。想一边看 Agent 写代码、一边自己在终端里跑测试，这个组合是它相对纯终端 Agent 最直接的增益。

Agent 干完之后，在审阅视图里看这个工作区的 diff，需要改的地方留锚定评论，评论会被送回对话里让 Agent 接着改。满意了就从顶部栏发分支并开拉取请求；不满意就删掉这个工作区。ThinkRail 把工作区状态接到 GitHub 上：分支与拉取请求状态、CI 检查、评审结论、就绪状态、合并动作，以及 Agent 生成的 PR 描述（用你自己的 gh）。

收口路径
1) 看 diff，留锚定评论 → 送回会话让 Agent 改
2) 发分支、开 PR（用你自己的 gh）
3) 看 CI 检查与评审结论，合并
4) 不满意：删掉工作区，主检出未受影响

遥测这一段要单独处理：使用统计默认开启，错误报告始终发送。想少共享就在 Settings → Privacy 里关掉附加共享，或用无分析参数的启动方式。团队统一装机前，把这一项写进装机说明。