兩層擴充
| 層 | 內容 | 管理 |
|---|---|---|
ThinkRail 自家擴充（packages/thinkrail-extensions/） |
ask-user-question、visualize、web-access 三件（@thinkrail/ext-*） |
Settings → Extensions 可逐一關 |
pi 套件（packages/pi-extensions/） |
以 npm 發布給整個 pi 生態：@thinkrail/pi-ask-user-question、@thinkrail/pi-visualize |
pi install 進任何 pi 環境 |
也就是同一套能力兩種包法：在 ThinkRail 裡開箱即用；在純 pi CLI 裡手動裝。
Settings → Extensions
README〈What you get · Agent tools beyond the shell〉：
Settings → Extensions lists the ThinkRail extensions the agent gets and lets you switch each one off (and, for questions, their rich previews) — and installs any
pipackage by source (npm, git or a local folder), for you or for a repository, showing what each one adds and letting you switch packages, their individual extensions and skills, and pi’s built-ins on or off; open chats pick a change up when their turn ends.
重點：
- 來源三種：npm、git repo、本機資料夾
- 範圍兩種：for you（全域）或 for a repository（單一 repo）
- 粒度四種：整個 package、單一 extension、單一 skill、連 pi 內建都能開關
- 生效時機：開著的對話在這一輪結束時撿起變更——不砍你進行中的工作
ask-user-question：代理不瞎猜
擴充 README 定位：
Instead of guessing, the agent asks you one or more structured multiple-choice questions and waits for your answers.
細節（對話課已述，此處補齊）：
- 一輪一次問完所有可問的問題，不擠牙膏
- 2–4 個選項、
multiSelect多選、永遠有 “Other” 自填與備註欄位 - Discuss first：先討論再決定
- preview 支援 markdown——mockup、圖表、組態並排比較
visualize：圖而不是 ASCII art
Visualize architecture and workflow diagrams, option comparisons, and file previews (HTML mockups, Markdown, SVG, CSV, JSON, notebooks, images, PDF, code) — or a before/after diff of two files.
三種渲染型別：
| 型別 | 內容 |
|---|---|
| diagram | Mermaid（流程、時序、ER、甘肅…） |
| comparison | 選項並排＋pros/cons＋推薦標記 |
| file | 檔案渲染；HTML mockup 可帶 before/after 對照 |
終端環境退回 Unicode（lovely-mermaid）；超過 128 節點或不支援的平台直接給 mermaid code fence。
web-access：受控的網路存取
web-access 給代理網頁／內容擷取能力（本站就是以它驅動查核）。與 MCP 審批同一精神：能力要強，授權在你。
把 ThinkRail 體驗帶進 vanilla pi
pi install npm:@thinkrail/pi-ask-user-question
pi install npm:@thinkrail/pi-visualize裝完後，沒有 ThinkRail 的終端機 pi 也有結構化提問與視覺化。v0.3.2 起 pi.dev 套件庫（gallery）還給這些套件加了影片預覽：feat(pi-extensions): add pi.dev gallery video previews to the published packages（#1162）。
下一課
外部工具的另一大體系：MCP 伺服器。