RAI 能力沉浸体验课永康锐达工具 · 学员站
Day0 · 🧰 模块 00

准备

建立独立课堂工作区，确认工具边界。

下载本模块材料
主线需联网

安装 Node.js 和 npm

准备 Pi 与 Pi Web 的共同运行前提。

约 8 分钟
本节材料
Pi 与课堂工具准备说明00-start/tool-setup.md3 KB ↓
操作步骤
  1. 打开本节详细攻略，使用国内镜像安装适配当前操作系统的 Node.js 22 LTS；npm 会随 Node.js 一起安装。
  2. 重新打开终端，验证 node --version 不低于 22.19.0，并检查 npm --version 与 npm registry。
完成标志

Node.js 不低于 22.19.0，npm 可用并已连接可用的国内源。

人工边界

只执行当前操作系统对应的步骤；系统确认和密码由学员本人处理。

走查记录安装 Node.js 和 npmDay0 · 主线 · 预估 8 分钟
主线需联网

安装 Pi

把 Pi 装好，并确认它能正常启动。

约 8 分钟
在终端运行

操作步骤
  1. 命令跑完后，运行 pi 启动。
  2. 看到 pi 的交互界面就说明安装成功。
  3. 按 Ctrl+C 退出。登录和选模型放到后面的步骤，这里先不用做。
完成标志

pi 能正常启动并进入交互界面（模型配置在后面的步骤完成）。

人工边界

这一步不需要填任何密钥或登录；模型配置留到后面统一设置。

走查记录安装 PiDay0 · 主线 · 预估 8 分钟
主线需联网

安装并设置 Google Chrome

统一课堂使用的浏览器，并让系统链接默认用 Chrome 打开。

约 8 分钟
操作步骤
  1. 打开本节详细攻略，从 Google 官方中国站安装 Chrome。
  2. 把 Chrome 设为系统默认浏览器。
  3. 从另一个应用点击可信链接，确认链接会在 Chrome 中打开。
完成标志

Chrome 可启动、可访问网页，并已成为系统默认浏览器。

人工边界

只从 Google 官方来源下载；系统确认由学员本人处理。

走查记录安装并设置 Google ChromeDay0 · 主线 · 预估 8 分钟
主线需联网

设置微信用外部浏览器打开链接

让电脑版微信链接直接进入默认的 Google Chrome。

约 5 分钟
操作步骤
  1. 打开本节详细攻略，在电脑版微信中开启“使用默认浏览器打开网页”。
  2. 在文件传输助手中点击可信链接，确认链接会在默认浏览器中打开。
完成标志

点击电脑版微信里的网页链接时，会在 Google Chrome 中打开。

人工边界

不修改注册表或微信程序文件；不向 AI 提供微信密码、验证码或二维码。

走查记录设置微信用外部浏览器打开链接Day0 · 主线 · 预估 5 分钟
主线需联网

安装课程版 Pi Web

通过浏览器使用 Pi 和本地课程目录。

约 5 分钟
在终端运行

操作步骤
  1. 命令跑完后，运行 pi-web 启动服务。
  2. 在 Google Chrome 打开 http://localhost:30141 ，能看到 Pi Agent Web 界面即可（此时还没有可用模型，下一步再配置）。
完成标志

pi-web 可在本机浏览器启动，Pi Agent Web 界面正常打开。

人工边界

只安装 @yansircc/pi-web；服务仅监听 127.0.0.1。

走查记录安装课程版 Pi WebDay0 · 主线 · 预估 5 分钟
主线需联网

配置课程模型

把课程提供的模型接入 pi-web，之后就能正常对话。

约 3 分钟
操作步骤
  1. 在下方输入框填入你的 API Key，点「生成配置」，再点「一键复制」拷贝整段 JSON。
  2. 回到 pi-web，点左下角「模型」，在弹窗右上角点「Raw JSON」。
  3. 把复制的 JSON 粘贴进 Raw JSON 输入框，覆盖原有内容。
  4. 点右下角「校验」，看到「配置有效」变绿后，再点「保存」。
  5. 回到会话，在底部选择模型 gpt-5.6-luna，发一条消息确认能收到正常回复。

完成标志

models.json 校验通过并保存，能用课程模型收到正常回复。

人工边界

API Key 只填在本机 pi-web，别发群里或截图外传；本页输入不会保存，刷新即清空。

走查记录配置课程模型Day0 · 主线 · 预估 3 分钟
主线需联网

安装课程 Pi 插件

装上课程要用的 3 个 Pi 插件（网页 / 微信 / 循环）。

约 3 分钟
操作步骤
  1. 在 pi-web 左下角点「插件」，在弹窗左下角点「+ 添加插件」。
  2. 把下面每个插件来源逐个复制，粘贴到「来源」输入框，保持 global，点「安装」。
  3. 三个插件依次装完后，列表里能看到它们且状态为已启用。
npm:@yansircc/pi-chrome
npm:@yansircc/pi-weixin
npm:@yansircc/pi-loop

完成标志

@yansircc/pi-chrome、pi-weixin、pi-loop 三个插件均安装并启用。

人工边界

只安装课程指定的 @yansircc 插件；来源逐字粘贴，不要改动。

走查记录安装课程 Pi 插件Day0 · 主线 · 预估 3 分钟
主线需联网

让 Pi 补齐课程环境

由 Pi 针对当前电脑检查并补齐后续课程依赖。

约 15 分钟
复制给 AI

完成标志

Git、Python 3、LibreOffice、办公文档 Python 库和 Wrangler CLI 均已安装并可用。

人工边界

不安装无关工具；不暴露秘密；所有高权限和图形界面操作由学员确认。

走查记录让 Pi 补齐课程环境Day0 · 主线 · 预估 15 分钟
主线

建立课堂工作区

把课程工作与真实公司文件隔离在专用目录里。

约 5 分钟
操作步骤
  1. 在合适的位置新建一个专用课堂目录，例如 macOS 用户可建在 ~/ 下。
  2. 把本课程后续素材和产出都放进该目录，并只在该目录中开始课堂 coding 对话。
  3. 确认目录中不包含真实公司文件、客户隐私或密钥。
完成标志

已建立专用课堂目录，后续所有素材和 coding 对话都在该目录内进行。

人工边界

不在真实公司文件目录里直接操作 AI；不授予整个磁盘的读写权限。

走查记录建立课堂工作区Day0 · 主线 · 预估 5 分钟
主线

认识统一业务世界

确认公司、买家和 10 个 SKU 的事实边界。

约 5 分钟
本节材料
锐达工具公司档案00-start/company-profile.md1 KB ↓德国买家档案00-start/buyer-profile.md1 KB ↓10 SKU 产品主数据00-start/product-master.xlsx6 KB ↓规范产品图片包00-start/product-images-clean.zip692 KB ↓
复制给 AI

完成标志

能准确说出公司、德国买家与 RD-CW1232。

人工边界

不要补写材料没有的事实。

走查记录认识统一业务世界Day0 · 主线 · 预估 5 分钟