AI实践知识库实验室：环境搭建
从零开始配置你的 AI 自增长系统开发环境
实验室：环境搭建 (The Laboratory)
在开始构建任何系统之前，你需要一个"实验室"。这一章手把手教你配置开发环境。
本章你将获得什么
- 一套可复用的环境搭建流程
- 最小可行实验室（MVS）与验收标准
- 常见问题的快速排查思路
一句话定义
实验室 = 可重复搭建的开发环境，让系统随时能跑起来。
最小可行实验室（MVS）
| 环节 | 你需要准备 | 验收结果 |
|---|---|---|
| 运行环境 | Node.js + pnpm | 能运行脚本 |
| 编辑器 | Cursor/VS Code | 可调用 AI |
| 部署平台 | Vercel | 可完成部署 |
| 数据库 | Supabase | 可创建项目 |
| API | OpenAI/DeepSeek | 调用成功 |
合格信号：Hello World 脚本可正常运行并输出结果。
核心指标（必须盯）
口径说明（默认）：
- 时间窗：如无特别说明，使用最近 7 天滚动。
- 数据源：选择单一可信来源（GA4/GSC/平台后台/日志），保持口径一致。
- 统计对象：仅统计当前产品/渠道，剔除自测与机器人流量。
| 指标 | 含义 | 合格线 |
|---|---|---|
| Environment Ready | 环境准备完成率 | 100% |
| First Run | Hello World 运行成功 | 必须通过 |
| First Deploy | 首次部署完成时间 | ≤ 30 分钟 |
为什么需要这一章？
很多人读完前面的理论章节，热血沸腾，然后打开电脑——发现不知道该打开什么软件。
这一章就是解决这个问题。我们会配置好一切，让你能够：
- 用 AI 辅助写代码 (Cursor)
- 一键部署网站 (Vercel)
- 存储数据 (Supabase)
- 调用 AI API (OpenAI / DeepSeek)
预计用时：1-2 小时
前置条件
在开始之前，请确保你有：
第一步：安装 Node.js
Node.js 是运行 JavaScript/TypeScript 代码的环境。我们的大部分代码都需要它。
下载安装
- 访问 nodejs.org
- 下载 LTS 版本 (长期支持版，更稳定)
- 按照提示安装
验证安装
打开终端 (Windows: PowerShell, Mac: Terminal)，输入：
node --version如果看到类似 v20.10.0 的输出，说明安装成功。
安装 pnpm (推荐)
pnpm 是比 npm 更快的包管理器。安装它：
npm install -g pnpm验证：
pnpm --version第二步：安装 Cursor (AI 代码编辑器)
Cursor 是一个集成了 AI 的代码编辑器，可以让 AI 帮你写代码、解释代码、修复 bug。
下载安装
- 访问 cursor.com
- 下载对应你系统的版本
- 安装并打开
首次配置
- 登录你的账号 (可以用 GitHub 登录)
- 选择你常用的键位方案 (如果你用过 VS Code，选 VS Code)
- Cursor 免费版每月有 500 次 AI 调用，对于学习足够了
你的第一个 AI 对话
打开 Cursor 后，按 Cmd + L (Mac) 或 Ctrl + L (Windows) 打开 AI 对话框。
试着输入：
用 Node.js 写一个 Hello World 程序AI 会生成代码，你可以直接点击 "Apply" 应用到编辑器。
第三步：配置 Vercel (部署平台)
Vercel 可以让你一键部署网站，而且对于小项目完全免费。
注册账号
- 访问 vercel.com
- 点击 "Sign Up"
- 选择 "Continue with GitHub" (用 GitHub 账号登录)
- 授权 Vercel 访问你的 GitHub
验证连接
登录后，你应该能看到 Vercel Dashboard。暂时不需要做其他事情，我们后面会用到它。
第四步：配置 Supabase (数据库)
Supabase 是一个开源的 Firebase 替代品，提供 PostgreSQL 数据库、认证、存储等功能。
注册账号
- 访问 supabase.com
- 点击 "Start your project"
- 用 GitHub 登录
创建你的第一个项目
- 点击 "New Project"
- 选择一个组织 (或创建新的)
- 填写项目信息：
- Name:
my-first-asgs(或任何你喜欢的名字) - Database Password: 设置一个强密码 (记下来!)
- Region: 选择离你最近的区域
- Name:
- 点击 "Create new project"
创建完成后，进入项目设置，找到 API 部分：
- 记下
Project URL - 记下
anon publickey
这些后面会用到。
第五步：获取 AI API Key
OpenAI API
- 访问 platform.openai.com
- 登录或注册
- 进入 "API Keys" 页面
- 点击 "Create new secret key"
- 复制并保存这个 key (只显示一次!)
注意：OpenAI API 是付费的，但新用户通常有免费额度。
DeepSeek API (备选，更便宜)
如果你想省钱，DeepSeek 是一个很好的替代品：
- 访问 platform.deepseek.com
- 注册账号
- 获取 API Key
DeepSeek 的价格大约是 OpenAI 的 1/10，质量也不错。
第六步：创建你的第一个项目
现在让我们把所有东西串起来，创建一个真正能运行的项目。
创建项目文件夹
打开终端，执行：
mkdir my-first-asgs
cd my-first-asgs
pnpm init创建配置文件
在项目根目录创建 .env 文件：
# .env 文件 - 存放你的 API 密钥
# 不要把这个文件提交到 Git!
OPENAI_API_KEY=sk-your-openai-key-here
DEEPSEEK_API_KEY=sk-your-deepseek-key-here
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key-here创建 .gitignore 文件
# .gitignore - 告诉 Git 忽略这些文件
.env
node_modules/
.DS_StoreHello World 脚本
创建 hello.js 文件：
// hello.js - 你的第一个 ASGS 脚本
const fs = require('fs');
// 获取当前时间
const now = new Date().toISOString();
// 要写入的内容
const content = `
# 我的第一个 ASGS 日志
生成时间: ${now}
这是一个自动生成的文件。
如果你能看到这行字，说明你的环境配置成功了！
## 下一步
1. 阅读 Ch01: 什么是 AI 自增长系统
2. 尝试修改这个脚本，让它做更多事情
3. 开始构建你自己的自增长系统
`;
// 写入文件
fs.writeFileSync('output.md', content);
console.log('✅ 文件已生成: output.md');
console.log('🎉 恭喜！你的环境配置成功！');运行它：
node hello.js如果看到"恭喜！你的环境配置成功！"，并且生成了 output.md 文件，说明一切就绪！
常用命令速查表
| 命令 | 说明 |
|---|---|
| node --version | 查看 Node.js 版本 |
| pnpm init | 初始化新项目 |
| pnpm install | 安装依赖 |
| pnpm add <package> | 添加新依赖 |
| node script.js | 运行 JavaScript 文件 |
| git init | 初始化 Git 仓库 |
| git push | 推送代码到远程仓库 |
常见错误
错误 1：node 命令找不到
原因：Node.js 没有正确添加到系统 PATH。
解决：重启终端，或者重新安装 Node.js 时勾选 "Add to PATH"。
错误 2：pnpm 安装失败
解决：使用 npm 作为替代：
npm install错误 3：API Key 无效
检查：
- 确保 Key 没有多余的空格
- 确保账户有余额
- 确保 Key 没有过期
验收清单
本章小结
恭喜！你的"实验室"已经搭建完成。现在你可以开始阅读 Ch01，了解什么是 AI 自增长系统，然后动手构建你的第一个系统了。