🟢 入門｜ThinkRail 是 JetBrains incubator 的開源代理式 IDE (agentic IDE)：pi coding agent 是唯一引擎，ThinkRail 是包在外面的薄殼主機——工作區、編輯器與傳輸層。先搞懂它解決的三個問題與「thin host」分工，後面每一課才知道自己在操作哪一層。

🟢 入門｜macOS/Linux 用 curl、Windows 用 PowerShell 一行裝起 thinkrail CLI；要桌面 app 就抓 DMG／setup 包。安裝器會驗 SHA-256、放進 PATH。裝完只需要 git 與一個 model provider。

🟢 入門｜ThinkRail 的核心隔離模型：一個專案 = 一個 git repo，一件工作 = 一個 git worktree 工作區（自己的分支、自己的目錄）。代理平行作業不踩線，做完合併好的、刪掉其餘的；收納進 Shelf 的是已完成而不是被刪除。

🟢 入門｜Monaco 編輯器分頁、帶 git 變更標記的檔案樹、終端機、文件——全部綁定目前工作區。還能在檔案與 diff 上釘審查註解、把 worktree 丟給外部 IDE 開。

🟡 中階｜每個工作區可同時開多個 pi session，各有自己的模型與即時 token／成本讀數。執行中可以轉向 (steer) 或排隊追問、派子代理 (subagent)、共用一份代理會更新、你可以編輯的計畫。

🟡 中階｜一張互相連結的 SPEC.md 圖譜活在程式碼旁邊，代理用 spec_* 七個工具讀、搜、維護它——意圖 (intent) 不隨對話消失。這是 ThinkRail 對「Intent evaporates.」的答案。

🟡 中階｜你為其他代理準備的 Agent Skills 原地讀取、不用搬家（~/.pi、~/.claude、~/.codex、~/.copilot、~/.gemini 都掃）；出貨用的工作流——專案設置、設計發想、開 PR——開箱即有，PR 走你自己的 gh。

🟡 中階｜ThinkRail 自家擴充（ask-user-question、visualize、web-access）在 Settings → Extensions 開關；同一頁還能裝任何 pi 套件（npm／git／本機資料夾）。想讓 vanilla pi CLI 也有同款體驗？這些套件也發布在 npm。

🟡 中階｜ThinkRail 讀 pi 的 mcp.json，可從 Settings 新增（含 presets）。非唯讀的 MCP 呼叫會先在對話裡問你；repo 定義的伺服器預設關閉，核准才開；OAuth 直接從 Settings 登入。

🔴 進階｜ThinkRail 沒有自己的帳號體系：登入 JetBrains AI，或用 pi 原生的 provider 設定。JetBrains AI 走你自己的 central CLI；自架 OpenAI-compatible 伺服器（Ollama、vLLM…）從 Settings → Providers 加，存進 pi 的 models.json。

🟢 入門｜介面內建英／日／俄／簡中／西語，放檔案到 ~/.thinkrail/locales 自帶翻譯；主題進 ~/.thinkrail/themes；字型進 ~/.thinkrail/fonts（v0.3.1 起可自選介面與程式碼字型）。遙測不含程式碼與 prompt，可一鍵退出。