工具准备
学习过程中使用”木刀”:
都是免费的工具,无需翻墙,无需额外购买Token,虽不锋利,但足够学习使用.
都是免费的工具,无需翻墙,无需额外购买Token,虽不锋利,但足够学习使用.
# 1 准备你的日常 AI 工具箱
| 编号 | 大模型/工具 | 说明 |
|---|---|---|
| 1 | Qwen(通义千问) | 国内推荐:
|
| 2 | Sublime Text 编辑器 | 可选:免费的 Markdown 编辑器,编写 Prompt 首选 |
| 3 | Markdown 语法小抄在线版 Markdown 语法小抄下载 |
建议阅读 + 收藏:
Markdown 语法小抄,下载的文件可以用上面的 Sublime 打开 |
#2 学习以下内容
驾驭 AI 必备 – 有效提示词之 STAR 范式
| 元素 | 核心问题 | 推荐长度 | 常见错误 | 最佳实践 |
|---|---|---|---|---|
| S – Situation | 谁?什么背景?目前在做什么?为什么需要 AI? | 100 字内 | 写成个人简历 | • 无指令:不要写任务指令,只描述背景 • 只写跟任务有关的事实 • 使用 {}:用 {粘贴完整的背景和概念} 作为占位符,让用户动态填写,提高模板可复用性 |
| T – Task | 希望 AI 做什么?产出什么? | 120 字内 | 模糊的指令,例如”帮我写个脚本” | • 提供清晰、明确、无歧义的任务指令,让大模型清楚理解要做的事 • 分解:一句话一个指令 • 动词导向:使用动词引导的指令 • 关键要求:添加关键要求描述(例如 SMART 原则) |
| A – Action Role | 希望 AI 扮演谁?具备什么技能? | 200 字内 | 只写”你是某个领域的专家” | • 专业角色:指定具备任务相关技能的角色 • 领域知识:强调应当具备的专业知识 |
| R – Rule | 等待什么输入?产出什么输出?格式限制? | 120 字内 | 忽略格式限制,导致输出内容冗长杂乱 | • 指定清晰、一致的任务规则 • 实例化:给出实例帮助 AI 理解 • 边界清晰,例如将”请尽可能清楚描述”改为”必须提供至少三个场景” • 质量要求:如有质量标准,明确说明 • 模板:指定句式/结构模板 • 输出格式,例如纯文本、文本块等 |
# 3 在千问中尝试以下提示词
# S - Situation ## Chinese is my first language. ## English is my second language ## I need an assistant that can translate one language into the other. # T - Task ## Wait for my input. ## Identify which language my input is written in. ## Translate it into the the other language. ## Output only the translations, not the original text. # A - Action Roles ## You are a native-level expert in Simplified Chinese and English. ## You are a professional translator skilled at producing natural, accurate, and context-appropriate translations. # R - Rules ## Do not answer anything until I provide text to translate. ## For every input, first detect the original language. ## Translate the input into the other language. ## Use prefixes: ### [CN:] for Simplified Chinese ### [EN:] for English ## Output only the translations. ## Do not add explanations, notes, or extra text. ## Output as plain text. ## Example: I enter the input "你叫什么名字?", the output should be: [EN:] What is your name?
# 4 挑战:写一个编辑提示词的提示词,或者把 PRD 转为 用户故事 + AC 的提示词
推荐电脑配置
| 平台 | 可用型号 | 芯片 / 处理器 | 内存 | 存储 | 适用性 |
|---|---|---|---|---|---|
| Mac | MacBook Air M3 | Apple M3 | 16 GB | 512 GB SSD | 最佳选择 |
| MacBook Pro M3 / M4 | Apple M3 / M4 | 18 GB+ | 512 GB SSD | 最佳选择 | |
| MacBook Air M2 | Apple M2 | 16 GB | 512 GB SSD | 推荐 | |
| MacBook Air M1 | Apple M1 | 16 GB | 256 GB SSD | 可用 | |
| Windows | ThinkPad X1 Carbon (Gen 11+) | Intel Core i7-1365U+ | 16 GB | 512 GB SSD | 最佳选择 |
| Dell XPS 14 / 16 | Intel Core Ultra 7+ | 16 GB | 512 GB SSD | 最佳选择 | |
| Surface Laptop 6 | Snapdragon X Elite / Intel Ultra | 16 GB | 512 GB SSD | 推荐 | |
| Linux | ThinkPad T14s (Gen 4+) | AMD Ryzen 7 PRO 7840U+ | 16 GB | 512 GB SSD | 推荐 |
| System76 Lemur Pro | Intel Core i7-1365U+ | 16 GB | 512 GB SSD | 推荐 |
最低配置要求
如果你的电脑低于以下配置,可能无法流畅运行课程所需的开发工具。
| 配置项 | 最低要求 | 推荐配置 | 说明 |
|---|---|---|---|
| 处理器 (CPU) | Apple M1 / Intel i5 10代 / AMD Ryzen 5 5000 | Apple M3 / Intel i7 13代 / AMD Ryzen 7 7000 | AI 编程工具需要持续处理代码分析,CPU 性能直接影响响应速度 |
| 内存 (RAM) | 8 GB | 16 GB 及以上 | Code Buddy + 浏览器 + 终端同时运行,8 GB 会明显卡顿 |
| 存储 (SSD) | 256 GB SSD | 512 GB SSD 及以上 | 项目代码 + Node 模块会占用大量空间;必须是 SSD,机械硬盘随机读写速度慢数百倍,会导致工具启动和索引极慢 |
| 操作系统 | macOS 13+ / Windows 10 (WSL2) / Ubuntu 22.04+ | macOS 14+ / Windows 11 (WSL2) / Ubuntu 24.04 | Linux 推荐 Ubuntu 发行版 |
| 网络 | 稳定的宽带连接 | 50 Mbps+ 低延迟 | AI 编程工具依赖云端大模型,网络不稳定会严重影响体验 |
| 显示器 | 13 英寸 1080p | 15 英寸+ 2K 分辨率 | 编程需要同时查看代码、终端和文档,大屏幕效率更高 |
特别注意
- 8 GB 内存的 Mac:可以运行,但同时打开多个工具时会明显卡顿,建议升级到 16 GB
- Windows 用户:必须启用 WSL2(Windows Subsystem for Linux),课程中的开发环境基于 Linux
- iPad / Chromebook:无法安装课程所需的开发工具,不可用
- 机械硬盘 (HDD):随机读写速度比 SSD 慢数百倍,会导致项目索引、依赖安装等操作极慢,严重不推荐
协作工具
开发 IDE
Node.js
| # | 工具名 | 说明 | 链接 |
|---|---|---|---|
| 2 | Node.js | 开源、跨平台的 JavaScript 运行环境,必备 | Mac – 支持Apple芯片(ARM)和Intel芯片(x64) Windows – 支持 ARM 架构和 x64 Linux |
请下载完成后安装 Node.js。这是后续安装依赖包和开发应用程序必备的工具。
安裝 Git( Windows 用户 )
第一步:打开 CMD 工具,快捷键 Windows + R

第二步:直接在终端输入:
BASH
winget install --id Git.Git
第三部:安装完成后,输入以下指令检查 Git 是否可以执行:
BASH
git
安装云端 Postgres 数据库
跟着以下步骤操作,安装开发时需要用到的云端 Postgres 数据库。
第一步:打开 Neon 注册页面
- 打开 https://neon.com,点击右上角 “Sign up” 按钮

第二步:创建账号
- 输入注册的邮箱,创建账号密码
- 点击继续后,需要去邮箱激活账号

第三步:填写 Organization 信息
- 在 “Welcome to Neon” 页面输入 Organization 信息
- 注意:”What’s this organization for?” 要选 “Personal projects”(免费方案)

第四步:创建数据库
- 填入数据库信息,点击 “Create project” 按钮
- 注意:Postgres version 选 “18”,Region 选 “AWS Asia Pacific 1 (Singapore)”

第五步:复制数据库连接字符串
- 数据库建好后,点击 “Connection string”,再点 “Copy snippet” 复制连接字符串
- 将连接字符串粘贴到记事本保存,后续配置项目环境文件时会用到

这样属于你自己的云端 Postgres 数据库就装好了
安装所需的依赖包
跟着以下步骤操作,全程只需复制粘贴,不需要任何编程基础。
第一步:打开终端
Mac 用户(三种方法任选一种):
- 方法一:在 Finder 顶部菜单栏点击”前往” → “实用工具” → 双击”终端” 或 “Terminal”
- 方法二:激活 Spotlight,搜索”终端” 或 “Terminal”,按回车
- 方法三:打开 Launchpad,在”其他”文件夹里找到”终端” 或 “Terminal”

Windows 用户(两种方法任选一种):
- 方法一:按 Windows 键 + R,输入
cmd,按回车 - 方法二:点击开始菜单,搜索”命令提示符”,点击打开
第二步:确认已安装 Node.js
在终端输入以下命令验证:
BASH
node --version看到类似 v22.0.0 的版本号即表示已安装成功。

第三步:运行安装命令
把下面这条命令复制,粘贴到终端里,然后按回车。
BASH
npx sdd-env-cn@latest init
- 出现提示 “OK to proceed? (y)”, 输入 y 然后按回车。
第四步:选择 IDE
- 打开安装界面,用 ↑ ↓ 方向键 选择 IDE(我们选择最下方 CodeBuddy)

此步骤非常重要:一定不要忘记按一次空格键,看到 CodeBuddy CN 选项前面加了红色圆点,才表示选中了。如果不按空格键,虽然当前高亮显示的是 CodeBuddy CN,实际安装会是第一个选项 Cursor。

等待一会后,安装完成

示例程序
跟着以下步骤操作,通过运行示例作品,验证所有的工具、环境已正确配置。
第一步:建项目目录
- 在本地建一个新文件夹,文件夹的名称:
sdd-sample-cn - 打开 Code Buddy CN,在左侧 “编程模式” 中,选择 “打开文件夹”,然后选择第一步新建的
../sdd-sample-cn

- 你会看到如图所示的空白工程目录

第二步:拉取代码
- 如图中箭头1,在 Code Buddy 的 AI 对话框中,输入:
BASH
从以下 git repository 拉取代码:
https://gitee.com/woodsw0rd/sdd-example-cn.git- 你可能会看到以下弹出框,如图中箭头2
- 确认允许执行后,代码下载成功,如图中箭头3

第三步:验证数据库连接
- 找到前一步你配置好的 Neon 云端 Postgres 数据库连接字符串
- 如图中方框1所示,在 CodeBuddy CN AI 对话框中输入:
BASH
测试以下 Postgres 数据库连接:
*** 此处改为你自己的数据库连接字符串 ***- 如果有弹出对话框要求同意执行脚本的,如图中方框2,点同意即可
- AI 会自动尝试连接数据库,如果成功会告诉你连接结果,如图中方框3
- 当 AI 问你,数据库连接成功,但是是空的,要不要创建数据库表的时候,说“要”,然后 AI 就会帮你把数据库建起来了

第四步:配置千问 AI 大模型 API Key
- 在 Code Buddy CN AI 对话框中输入:
BASH
使用以下 qwen API 配置信息,连接 qwen 大模型:
#############################################
# 请在此处贴入在微信群中共享的 qwen API 配置信息 #
#############################################注:这里提供的 API Key 是真实的百炼平台千问大模型 API Key,请勿泄露。课后一周 API Key 会失效。
- 如果有弹出对话框要求同意执行脚本的,如图中方框2,点同意即可
- AI 会自动尝试通过 API Key 连接千问大模型,如果成功会告诉你结果,如图中方框3

第五步:创建本地环境配置文件 .env
- 在 Code Buddy CN AI 对话框中输入:
BASH
# 把下面配置信息写入 .env 配置文件:
1. 前文的 postgres 数据库配置信息
2. 前文的 qwen API Key 配置- 如果有弹出对话框要求同意执行脚本的,如图中方框2,点同意即可
- AI 会创建本地 .env 配置文件,如图中方框3

- 创建成功后,在 Project 目录中会找到 .env 文件,如图中方框1,以及数据库和 AI 的连接配置,如图中方框2

第六步:运行示例 web app
- 在 Code Buddy CN AI 对话框中输入:
BASH
run the app- 如果有弹出对话框要求同意执行脚本的,如图中方框2,点同意即可
- AI 会连接千问大模型,创建本地数据库表,启动 web server,成功后会告诉你结果,如图中方框3

- 打开浏览器,输入 AI 给你的链接(一般是以下链接,注意如果启动多个服务器实例,端口号会改变)
BASH
http://localhost:3000- 现在示例 web app “AI 故事接龙” 就成功运行起来了

