# AIPROS Lite 学员懒人包

这是课程学员使用的 AIPROS Lite Student Release。目标是：拿到这个文件夹后，不需要理解前后端工程结构，只要用 AI coding 工具或终端执行一个命令，就能在本地启动 Skill 管理平台。

## 一键本地启动

```bash
npm run local
```

第一次运行会自动完成这些事：

- 检查 Node.js 版本
- 安装前端依赖
- 安装后端依赖
- 生成本地 `.env`
- 初始化 SQLite 数据库
- 构建前端
- 启动本地服务
- 自动打开浏览器

启动后看终端输出的访问地址，默认是：

```text
http://localhost:4000
```

如果 4000 被占用，脚本会自动换到 4001、4002 等可用端口。

登录时可以使用任意邮箱 + 中国大陆手机号格式，例如：

```text
demo@example.com
13900000001
```

## 环境要求

必须安装：

- Node.js 22 或更高版本，推荐 Node.js 24
- npm，安装 Node.js 时通常会自带

检查版本：

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

如果你不会安装 Node.js，直接把 [AI-CODING-PROMPT.md](AI-CODING-PROMPT.md) 里的内容复制给 Cursor、Codex、Claude Code、Qoder 等 AI coding 工具，让它帮你检查和安装环境。需要搜索时，让它只查 Node.js、npm、Cloudflare 的官方文档。

## 常用命令

```bash
npm run check
```

检查学员包是否完整。

```bash
npm run setup
```

只安装依赖、初始化数据库、构建前端，但不启动服务。

```bash
npm run local
```

本地一键启动，学员最常用。

```bash
npm run cloudflare:deploy
```

部署到 Cloudflare。会打开浏览器让你登录或注册 Cloudflare，并授权 Wrangler。详见 [CLOUDFLARE-STUDENT.md](CLOUDFLARE-STUDENT.md)。

```bash
npm run package:student
```

生成新的学员 release zip。这个命令通常给老师或助教使用。

## 本地数据在哪里

本地数据库：

```text
cf-worker/data/aipro.db
```

本地上传文件：

```text
cf-worker/uploads/
```

想重置本地数据时，可以删除这两个目录后重新运行：

```bash
npm run local
```

## AI 功能说明

平台的基础管理功能可以直接本地运行，包括登录、流程架构、Skill 上传、Skill 列表、API Key 等。

AI 创建、AI 评测、Skill 运行等能力需要配置运行时：

- 本地测试可以配置本地 CLI 运行时
- Cloudflare 云端不能执行你电脑上的本地 CLI
- 云端建议配置 AgentRun 这类公网运行时

登录系统后，到“智能体配置”里填写运行时信息。

## 不要放进云端或发给学员的文件

release 打包脚本会自动排除这些内容：

- `node_modules/`
- `dist/`
- `.env`
- SQLite 数据库
- 上传目录
- `.wrangler/`
- SSL 私钥和证书
- 本地 release 输出目录

正式发给学员时，请使用 `npm run package:student` 生成的 zip。
