# 课前工具安装说明

按顺序完成：`Node.js/npm → Pi → Google Chrome → 微信外链 → 课程版 Pi Web → 让 Pi 补齐其他环境`。后一步依赖前一步，不要跳步。

## 第一步：安装 Node.js 和 npm

Pi 要求 Node.js `22.19.0` 或更高版本。课堂统一使用 Node.js 22 LTS；npm 会随 Node.js 一起安装。

在学员站本步骤对应小节点击「查看详细攻略」，按 Windows 或 macOS 对应步骤安装。完成后验证：

```bash
node --version
npm --version
npm config get registry
```

成功标准：Node.js 不低于 `v22.19.0`，npm 可用，registry 显示 `https://registry.npmmirror.com/`。

## 第二步：安装并配置 Pi

```bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent --registry=https://registry.npmmirror.com
pi --version
pi
```

进入 Pi 后：

1. 输入 `/login`，选择自己的模型服务并在本机完成登录或密钥配置。
2. 输入 `/model`，选择课堂要用的模型。
3. 发一条简单消息确认模型能正常回复，再按 `Ctrl+C` 退出。

使用自定义模型服务时，可把自己的 `models.json` 放到：

- Windows：`%USERPROFILE%\.pi\agent\models.json`
- macOS：`~/.pi/agent/models.json`

API key、token 和 `models.json` 只能保存在学员自己的电脑里，不得放进聊天、截图、课堂目录或共享压缩包。

## 第三步：安装 Google Chrome 并设为默认浏览器

在学员站本步骤对应小节点击「查看详细攻略」，从 Google 官方中国站安装 Chrome，再在系统设置中把 Chrome 设为默认浏览器。

成功标准：从邮件、聊天软件或文档中点击可信链接时，会在 Google Chrome 中打开。

## 第四步：让电脑版微信使用外部浏览器

在学员站本步骤对应小节点击「查看详细攻略」，开启微信的“使用默认浏览器打开网页”设置。

成功标准：点击电脑版微信中的可信链接时，会离开微信内置窗口并在 Google Chrome 中打开。

## 第五步：安装课程版 Pi Web

课堂使用我们维护的 `@yansirplus/pi-web`，不使用原版包。

```bash
npm install -g @yansirplus/pi-web@latest --registry=https://registry.npmmirror.com
pi-web --hostname 127.0.0.1
```

用 Google Chrome 打开 <http://127.0.0.1:30141>。成功标准：能新建会话、选择模型并收到一条正常回复。

## 第六步：让 Pi 配置剩余课程环境

在 Pi Web 中新建会话并发送：

> 请检查并补齐这台电脑后续课程需要的环境：Git、Python 3、LibreOffice（用于 soffice 命令转 PDF），以及 Excel/Word/PPT 相关 Python 库（openpyxl、python-docx、python-pptx）；sqlite3、ssl、json、csv 是 Python 标准库，确认可用即可，无需安装。尽量使用国内源，先检查再安装、只补缺失项；遇到 UAC、sudo、系统设置或图形界面确认时停下来告诉我，全程不暴露任何密钥。

Pi 只补齐当前系统缺少、且课程确实需要的项目。Node.js、Pi、Chrome 和 Pi Web 已在前五步处理，不应重复安装。