# 环境准备说明

这份说明给 AI Coding 工具看。学员不需要自己理解环境细节。

## 必备环境

本地启动只需要三类环境：

1. Node.js 22 或 24，包含 npm。
2. 一个本地 AI CLI，用来执行 Skill 生成、评测和运行。优先顺序：Codex、Qoder、Claude Code、CodeBuddy、Trae。
3. 浏览器，用来打开本地页面。

项目自己的前端依赖、后端依赖、SQLite 数据库和初始化数据都由 `npm start` 自动处理，不需要学员手动安装。

## AI Coding 工具执行顺序

先检查：

```bash
node -v
npm -v
codex --version
qoder --version
claude --version
codebuddy --version
trae --version
```

只要 Node.js/npm 存在，且至少一个 AI CLI 可用，就执行：

```bash
npm run check
npm start
```

## 如果 Node.js 或 npm 不存在

不要让学员自己查资料。AI Coding 工具应该只参考官方 Node.js 文档，指导或代为安装 Node.js 24 LTS。

macOS 常见方式：

```bash
brew install node@24
```

如果没有 Homebrew，打开 Node.js 官方下载页安装 LTS 版本。

Windows 常见方式：

```powershell
winget install OpenJS.NodeJS.LTS
```

如果没有 winget，打开 Node.js 官方下载页安装 LTS 版本。

安装完成后重新检查：

```bash
node -v
npm -v
```

## 如果本地 AI CLI 不存在

平台仍然可以启动，但 Skill 的 AI 生成、评测、运行需要本地 AI CLI。AI Coding 工具应该帮助学员安装并登录其中一个：

- Codex CLI
- Qoder CLI
- Claude Code
- CodeBuddy
- Trae

优先使用学员已经在课堂上使用的 AI Coding 工具。安装完成后重新执行：

```bash
npm start
```

## 不要做的事

- 不要要求学员手动编辑 `.env`。
- 不要要求学员手动创建数据库。
- 不要要求学员手动安装前端或后端依赖。
- 不要让学员理解 Vite、Workers、SQLite、migration、runtime 这些开发概念。
- 不要把 Cloudflare 部署作为本地课堂启动的前置条件。
