ThinkRail AI 智能体 IDE 快速上手指南【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrailThinkRail 是围绕 pi 智能体的 AI 智能体 IDE专治智能体同目录踩踏、会话一关意图就丢。每个智能体拿到独立 worktree 副本意图留在 SPEC.md。读完你能跑起它并提交第一个 PR。一条命令启动 ThinkRail克隆、安装到亮屏机器上缺什么三样缺一样都跑不起Bun 1.4.4仓库锁定的包管理器版本写在根package.json的packageManager字段Node.js ≥ 22.19进程内pi引擎的硬性要求一个已认证的 pi provider智能体干活要用的模型凭据齐了就敲这四行git clone https://gitcode.com/GitHub_Trending/th/thinkrail cd thinkrail bun install bun run dev怎么算成功宿主和 Web 客户端会一起拉起浏览器自动打开工作台顶栏右侧出现ConnectedCtrlC 两者同时退出。想换外壳也行bun run desktop:dev打包并打开 Electrobun 桌面应用bun run build:binary构建独立 CLI 二进制。两点提醒开发模式不启用应用内更新器源码检出靠 Git 更新后重建即可应用在磁盘上的状态项目、工作区、worktree统一放在~/.thinkrail。跑起来之后怎么读架构一张表看懂前后端分工看完界面怎么在脑子里给它建模把它想成一家店后台跑pi引擎、管会话和持久化前台是你能看到的 React 界面两者之间只传递一份带版本号的合同类型化协议门口还有两个门房启动器负责开门但不开口办事。角色位置干什么后台引擎宿主packages/server/ packages/shared/进程内运行 pi 会话管持久化与协议端点合同wire 协议packages/contracts/类型化、带版本号的协议宿主与 UI 唯一的耦合前台UI 客户端apps/web/React 19 Zustand Tailwind v4可脱离宿主独立交付门房两个启动器apps/cli/ apps/desktop/薄壳内嵌同一个宿主库不写引擎逻辑三条要点抓住核心工作区即 git worktree每个 project 是一个 git 仓库每个 workspace 切出独立 worktree等于给每个智能体单独开一份代码副本各有自己的分支和目录存在~/.thinkrail/worktrees下并行干活互不踩踏。一个工作区可跑多个并发 pi 会话各自有独立模型和实时 token/费用读数运行中还能转向steer或排队后续指令。Specs 是事实来源项目里一棵 SPEC.md 规格树智能体通过专用 spec_* 工具读写意图不随会话蒸发。这条边界是硬规则apps/web只依赖contracts、locales、ui这类展示层包永远不碰server所以 UI 能在没有宿主的情况下独立交付。布局也是分权的面板本身不知道自己摆在哪由 shell 统一排布中心区可递归分割侧边和底部按你保存的预设Balanced、Focus、Review落位切换工作区不会乱。完整拓扑与决策清单见 architecture.md。动代码前先记住这几条贡献铁律 第一次碰这个仓库最怕翻车在哪不在代码在规矩。动手前过一遍这份清单规格领先代码改动动了边界、契约或行为先更新对应模块的 SPEC.md再改代码和测试见 CONTRIBUTING.md子模块只通过index.ts桶文件对外兄弟模块跨包导入只走桶不伸手进内部模块公开面能配测试就配上边界规则也留测试兜底不用ts-ignore、as any、biome-ignore把门禁变绿——把报错当设计信号见 AGENTS.md风格跟随周边代码不顺手重构无关代码每个 package 和重要目录都有自己的 SPEC.md写清它拥有什么、暴露什么、不许碰什么。先读你要改的那个模块的 SPEC.md再写第一行代码。提交 PR 前必过的门禁与端到端验证清单改了代码怎么证明自己没改坏分两步三道快速门禁 端到端套件。这些门禁同时也是 husky pre-commit 钩子提交前会自动跑。三条全绿才能往下走bun run lint # biome 代码检查 bun run typecheck # 全包 tsc 类型检查 bun run test # 单元测试根工具 各 package涉及应用行为还要过对着真实 UI 的端到端套件bunx playwright install chromium # 首次一次性 bun run e2e -- e2e/changes.spec.ts # 聚焦单个 spec 迭代 bun run e2e -- --last-failed # 只重跑失败用例 bun run e2e # 完整无智能体门禁自动分片节奏建议迭代期跑聚焦或 last-failed改一处验一处交接前完整跑一次bun run e2e。涉及真实智能体行为的再跑bun run e2e:full需要 pi 认证会消耗真实 token。然后按这五步提交Fork 仓库从main拉分支改动保持聚焦风格对齐周边代码与 AGENTS.md动了边界或行为先更新对应 SPEC.md再改代码和测试补上或更新测试跑通上面的门禁向main开 PR描述写清what改了什么和why为什么提交信息和 PR 描述讲推理不只讲操作。维护者会 review可能建议你调整后再合并。新手导航想改什么先读哪个文件外加三个高频坑 ️不知道从哪下手对着这张表找入口你想做什么先读这个理解产品目标与能力边界goal-and-requirements.md查系统拓扑与架构决策architecture.md改引擎宿主 / 会话逻辑packages/server/SPEC.md调宿主与 UI 之间的协议packages/contracts/SPEC.md改 UI 面板或布局apps/web/SPEC.md、apps/web/src/shell/加或改智能体技能与工作流packages/pi-thinkrail-workflow/SPEC.md、packages/pi-todos/SPEC.md贡献语言翻译packages/locales/en.json了解测试与 E2E 约定e2e/SPEC.md最容易翻车的三个全仓不变量界面文案必须走 i18n key硬编码进 JSX 的文字会被 lint 直接拒绝所有用户可见文字都得是packages/locales/en.json里的 key。浏览器端不能 value-importpipi 只活在宿主进程里前端只能从pi-ai/pi-agent-core的包根导入类型。别把 worktree 和主目录搞混每个 workspace 是独立 worktree只有 Default 工作区指向项目文件夹本身其余时间都让智能体在 worktree 里干活。不用等读懂整个仓库才动手敲一条bun run dev跑起来从 packages/locales/en.json 挑一条文案改再补一个测试你的第一个 PR 就齐了。【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考