ThinkRail 快速开始：从 Git 仓库到 AI Agent 的第一次协作
ThinkRail 快速开始：从 Git 仓库到 AI Agent 的第一次协作
项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail ThinkRail 快速开始指南来了！这是一个围绕 pi coding agent 构建的 AI Agent IDE（智能体集成开发环境），它把 AI 对话、代码编辑器、Git 变更审查整合进同一个工作台。跟着本文，你只需几分钟就能完成 ThinkRail 安装，打开自己的 Git 仓库，并让 AI Agent 完成第一次代码修改。
ThinkRail 工作台全景：一个 pi 会话与它产生的变更，都被圈定在隔离的 git worktree 工作区里。
🧭 30 秒了解 ThinkRail
在动手之前，先搞清楚它是什么、给你什么：
- AI Agent 原生工作台：编辑器、文件树、终端、Diff 审查全部围绕
piagent 组织，而不是在对话框外再开一个 IDE - 工作区隔离：每个 Git 仓库可切出多个 workspace（底层是
git worktree），每个工作区有自己的分支和工作目录，多个 Agent 可以并行干活而不互相干扰 - Specs 规格图：项目里的
SPEC.md组成一张规格知识图谱，Agent 通过spec_*工具读写它，项目意图可以跨会话保留
官方文档入口：README.md，产品目标与设计规格见 goal-and-requirements.md 和 architecture.md。
🚀 一键安装：桌面版或 CLI 任选
ThinkRail 提供两种安装形态：原生桌面应用和自包含的 thinkrail 命令行工具，两者共享同一个引擎。
方式一：桌面版（Desktop）
从官方 releases 页下载对应平台的 thinkrail-desktop-* 安装包：
| 平台 | 安装包 | 说明 |
|---|---|---|
| macOS（Apple Silicon） | DMG | 直接打开即可 |
| Windows x64 | setup ZIP | 解压后运行其中的安装程序 |
| Linux x64 / ARM64 | setup tarball | 解压后运行 installer，需 glibc 2.38+、GTK 3、WebKitGTK 4.1 |
方式二：CLI 命令行（更轻量）
安装脚本会自动下载正确的二进制、校验 SHA-256 并把 thinkrail 加入 PATH。macOS / Linux 执行（脚本源码见 install.sh）：
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash
Windows（PowerShell 或 cmd 均可，脚本见 install.ps1）：
powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"
装好后，直接带上一个 Git 仓库路径就能启动：
thinkrail ~/code/my-repo
⚠️ 前置条件：系统 PATH 中要有
git，并且需要一个大模型 provider——可以在应用里登录 JetBrains AI，或通过pi自带的 auth 连接你自己的 provider。ThinkRail 本身没有账号体系。
🛠 从源码运行 ThinkRail（Bun + Git 工作流）
如果你想参与开发，或体验最新的 nightly 功能，从源码运行也很简单。环境要求：
- Bun 1.4.3（仓库锁定的包管理器与运行时）
- Node.js ≥ 22.19（进程内
pi引擎需要） - 一个已认证的
piprovider（用于 agent 工作）
完整命令：
git clone https://gitcode.com/gh_mirrors/th/thinkrail
cd thinkrail
bun install
bun run dev
bun run dev 会同时拉起 engine host（packages/server/）和 Web 客户端（apps/web/），Ctrl+C 即全部停止。源码运行时的应用状态（项目、工作区、worktree）统一存放在 ~/.thinkrail。更多开发细节见 CONTRIBUTING.md。
📂 打开第一个项目：工作区即 Git worktree
打开项目后进入 Default 工作区，对话、变更和终端都直接运行在项目目录中。
启动 ThinkRail 后，在左侧 Projects 面板点 + 添加你的 Git 仓库，它就成为一个 project。每个 project 自带一个 Default workspace（就是仓库主工作树）：
- 在 Default workspace 里：AI 的改动直接落在你的项目目录，适合"就地干活"
- 新建隔离 workspace：底层自动创建
git worktree，独立分支、独立目录，Agent 改崩了也不影响你的主分支；合并好分支后删除其余工作区即可
完成的、休眠的工作区会自动"沉淀"到项目级的 Settled shelf 上（PR 合并或关闭后、或安静一周后），随时点回来继续。顶栏实时显示当前分支相对 origin 的状态，下一步操作（push、open PR）一键可达。
💬 与 AI Agent 的第一次协作
Agent 遇到不确定的决策时会停下来提问，确认后再动手改代码——每个工作区可以跑多个并发 pi 会话。
进入工作区后点 New chat，第一次协作建议从一个低风险任务开始，比如：
- 在输入框描述需求，例如"给 CLI 的
--help输出补一个用法示例" - Agent 会以流式方式展示思考、工具调用步骤（read / edit / bash），实时显示 token 与费用
- 执行过程中可以随时 steer（插话引导）或排队后续指令
- 完成后，中间的 Changes 面板列出它改动的文件与 diff，你可以逐行查看，甚至对某一行留下 review 评论再发回聊天
同一个工作区可以开多个并发会话，各自绑定不同模型；遇到子任务还能委托给 subagents 并行处理。
📐 Specs：让 AI 长期记住你的项目
Specs 工具以树状展示项目规格图谱，并排渲染当前规格文档。
这是 ThinkRail 最有特色的部分：仓库里层级化的 SPEC.md 文件构成一张规格图（spec graph），顶层是 goal-and-requirements.md 与 architecture.md，每个模块旁都有同级的 SPEC.md。
- Agent 通过专用
spec_*工具读、搜、维护这张图谱 - 你改了架构决策，规格跟着改，意图就不会在会话之间丢失
- 工作台里的 Specs 面板可直接浏览整棵树（只读渲染）
🎨 个性化你的工作台（可选）
在 Settings → Layout 里选择工作台布局预设，或保存自己的排列方式。
ThinkRail 的工作台可以任意分栏：中心区域可递归拆分，左右两侧是工具面板栈，底部放终端。不喜欢默认布局？Settings → Layout 提供了 Balanced / Focus / Review 三种预设，一键应用；你也可以把当前排列存成自定义预设。界面语言在 Settings → Language 跟随系统，还可以把一份翻译好的 en.json 放进 ~/.thinkrail/locales 热加载（内置词表见 packages/locales/en.json）。
⌨️ 常用命令速查
| 命令 | 作用 |
|---|---|
thinkrail ~/code/my-repo | 打开一个 Git 仓库作为项目 |
thinkrail --help | 查看全部启动参数 |
thinkrail --version | 打印当前构建版本 |
thinkrail update | 重新运行安装器自更新 |
thinkrail uninstall | 卸载（默认保留 ~/.thinkrail 数据） |
下一步去哪儿？
- 产品与架构规格：goal-and-requirements.md、architecture.md
- 贡献指南与测试流程：CONTRIBUTING.md
- CLI 源码：apps/cli/ · 桌面版源码：apps/desktop/
- 每个模块的详细规格：直接翻对应目录下的
SPEC.md
🏁 小结
ThinkRail 快速开始三步走：安装（桌面版或 CLI 一键完成）→ 打开 Git 仓库（自动获得 Default 工作区）→ New chat（让 pi agent 在隔离的 worktree 里改代码、出 diff、可审查）。它把 AI Agent 放进真正的 IDE 语境里，再用 Specs 让项目知识沉淀下来——用一次就熟一分，这就是它"越用越懂你"的原因。
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐
0
0- 0
已为社区贡献32条内容
所有评论(0)