接入 Pi：需要先装 Node.js
图文分步 ｜ 面向愿意折腾一点的用户 ｜ Pi 是"自带模型 API key"的引擎
Pi 是 Scholardo 支持的另一个 CLI agent，走 "自带模型 API key"（Bring your own model API key） 的路线。和别的引擎相比，Pi 有一个额外前置条件：你的电脑上要先装好 Node.js。这一篇先把这个前提说清楚，再走安装。
前置条件（第一行就是重点）
- ✅ 必须先安装 Node.js：Pi 通过 npm 安装，而 npm 随 Node.js 一起提供。没有 Node.js，Pi 装不上。
- 去 nodejs.org 下载并安装（选 LTS 长期支持版即可）。
- Scholardo 在你安装 Pi 之前也会提示这一点——安装确认框会明确写着 Requires Node.js (npm) to be installed first.
- 一个你自己的模型 API key（Pi 走"自带 key"路线）。
- 一台装好 Scholardo 的 macOS 电脑。
💡 怎么确认 Node.js 装好了？打开"终端"App，输入
node -v回车，能显示一个版本号（如v20.x.x）就说明装好了。
分步文案
第 1 步 · 先装 Node.js
- 浏览器打开 nodejs.org，下载 LTS 版本的 macOS 安装包。
- 双击安装，一路下一步。
- 装完在"终端"里
node -v验证一下（见上）。
第 2 步 · 在 chooser 里安装 Pi
- 在右栏终端区新开 session，"Choose an agent" 卡片里找到 Pi 那一行（副标题 Bring your own model API key）。
- 点该行的 「安装 / Install」。
- 弹出确认框：
- 正文会包含命令
npm install -g --ignore-scripts @earendil-works/pi-coding-agent - 并追加一句：Requires Node.js (npm) to be installed first.（需先装 Node.js）
- 点 Install。
- 正文会包含命令
- 如果这一步报错、提示找不到 npm：说明 Node.js 没装好或没被识别——回第 1 步装 Node.js，重启 Scholardo 后再试。
第 3 步 · 填 key、启动
- 装完后，按 Pi 的引导填入你自己的模型 API key（"自带 key"路线）。
- A1 设计：装完 chooser 自动复现，点 Pi 行启动；失败显 「重试 / Retry」。
- 终端底部出现输入框，敲下第一句即可。
Shot list（截图清单）
Scholardo 界面用当前发布版录制。nodejs.org 属厂商界面，如实截取。key 截图打码。
| 图号 | 截什么 | 界面来源 | 关键 callout |
|---|---|---|---|
| 1 | nodejs.org 下载页，圈出 LTS 版本 | 厂商界面（nodejs.org，如实截取） | 🔴 "先装这个，否则 Pi 装不上" |
| 2 | 终端 node -v 显示版本号 | macOS 终端 | 字幕"能出版本号 = 装好了" |
| 3 | chooser 里 Pi 行（副标题 Bring your own model API key）+「安装 / Install」 | Scholardo | 圈出 Pi 行 |
| 4 | 安装确认框，含 npm install … pi-coding-agent 与 Requires Node.js (npm) to be installed first. | Scholardo | 圈红那句 Node.js 前置提示 |
| 5 | 填入自带 API key（打码）后启动 | Scholardo（key 打码） | 字幕"Pi 走自带 key 路线" |
关键 callout 汇总
- 🔴 先装 Node.js（nodejs.org，LTS）：Pi 靠 npm 安装，没有 Node.js 装不上。
- 确认框会明写 Requires Node.js (npm) to be installed first.
- Pi 是"自带 key"路线：需要你自己的模型 API key。
- A1 装完自动复现：点行启动，失败显「重试 / Retry」。
常见坑（详见 P0-6 安装/登录 FAQ）
- 提示找不到 npm / node：Node.js 没装好或没被识别。去 nodejs.org 装 LTS，重启 Scholardo 再试；可在终端
node -v/npm -v自查。 - 装完要填 key：Pi 不像 Claude/Codex 那样用订阅登录，它需要你自带模型 API key，按引导填入即可。
数据隐私披露
用 Pi 与模型对话时，你的文稿内容会发送给你所配置的模型服务商处理（由你自带的 API key 指向哪家而定）。Scholardo 只在你主动发起对话时发送所需内容。若材料涉及未公开数据、受访者隐私或保密协议，请先确认发送给第三方 AI 服务是否符合你所在机构的合规要求。