VibeAgent-Camp

欢迎！我们将一起完成基于沐曦算力资源的开发环境搭建，迈出 AI Coding的第一步。

前期准备工作

为了保证活动当天的实操顺畅，请务必自带电脑并提前在电脑上完成以下环境的准备与安装。

1. 基础开发环境

Python 3.11：请确保本地已安装 Python 3.11 版本，并配置好环境变量。
- 检查方式：在终端输入 python --version 或 python3 --version 确认。
**Visual Studio Code (VS Code)**：
- 版本要求：请安装 1.119.0 版本（或兼容的稳定版），以确保与后续插件的最佳适配。
- 下载地址：VS Code 官网
- 插件准备：
  - 安装方法：VS Code左侧边栏，
  - 必装插件：Cline， liver server
Git：官方安装方法 git-scm.com

2. 账号与密钥准备

国产大模型平台账号：请提前注册好Gitee.AI的账号，https://ai.gitee.com/
领取算力券: 在注册成为沐曦开发者，在社区领取算力券，https://developer.metax-tech.com/activities/6 务必提前领取
激活算力：在Gitee.AI上将算力券兑换成沐曦专属资源包，复制API_KEY，或在工作台-左边栏访问令牌中将API_KEY复制并保存

模块一：环境筑基与国产算力初探

最快完成的同学将收获小礼品

任务一：环境准备

在本任务中，我们将新建一个项目，完成准备工作。

步骤1：新建项目

打开VS Code，新建一个项目文件夹

步骤2：测试算力调用

调用一个多模态大模型，尝试生成一张图片

任务二：配置准备开始Vibe Coding

在本任务中，我们将配置 Cline 插件，通过 Serverless API 的方式连接国产大模型，并让它完成一次简单的自我介绍。

步骤 1：配置 Cline 插件

打开 VS Code，点击左侧活动栏的 Cline 图标。
在 Cline 的设置界面，点击右上角 Setting 选项。
配置Cline的大模型API： API Provider选择 OpenAI Compatible ， Base URL填写 https://ai.gitee.com/v1, OpenAI Compatible API Key填写Gitee.AI上获取的个人API_KEY， MODEL ID填写Gitee.AI上的沐曦算力资源包（从https://ai.gitee.com/serverless-api/packages/1492 选择模型名，如DeepSeek-V3）

步骤 2：发起第一次 Vibe Coding 对话

配置完成后，在 Cline 的对话框中输入提示词，测试连接是否成功：

“你好！请简单介绍一下什么是 Vibe Coding”

成功标准

Cline 能够正常思考并输出流式回复。
回复内容逻辑通顺，且没有出现 API 连接超时或鉴权失败的报错。

常见问题排查 (FAQ)

Q: Cline 插件无法加载？
- A: 请确认VS Code 版本是否是否兼容
Q: API 调用有问题？
- A: 请检查 Base URL、API_KEY、Model ID是否正确，以及当前网络环境是否能正常访问该 API 接口。

恭喜你完成了模块一！ 接下来，我们将进入激动人心的模块二，开始动手开发属于你的应用！

模块二：Vibe Coding 上手，人人都是开发者

本模块设置限时1小时创作环节，时间截止后将进入成果展示阶段。参与者可自愿上台进行作品展示，现场嘉宾将根据创意性、完成度及表现力等维度综合评选，最终为最具创意的10位同学颁发定制奖��

Vibe Coding是一种以自然语言为核心、AI 负责具体代码实现的全新编程范式。在 Vibe Coding 中，你更像是一个 “产品经理” 或 “架构师” 。你只需要用自然语言清晰地描述需求、逻辑和想要实现的“氛围”，AI 就会帮你完成绝大部分的编码、调试甚至部署工作。你不再是在“写”代码，而是在 “指挥” 代码。

Vibe Coding 的最佳实践范式

要想真正发挥 Vibe Coding 的威力，而不是让 AI 生成一堆无法维护的“屎山”代码浪费 Token，你需要掌握一套高效的协作范式。

核心秘诀： “明确角色 + 任务拆解 + 闭环验收”
一个Vibe Coding 标准工作流： 1. 角色设定与需求对齐 (The Brief)

不要一上来就写代码，首先给出一个良好的 Prompt，先给 AI 设定一个专业的角色，并把你的需求讲清楚。
错误示范： “帮我写个贪吃蛇游戏。”
Vibe 范式： “你现在是一名拥有10年经验的资深 Python 游戏开发工程师。我们要开发一个复古风格的贪吃蛇游戏。核心玩法是：蛇吃到食物变长、撞墙或撞到自己则游戏结束。请先不要写代码，帮我梳理一下这个游戏的核心功能、使用的技术、数据结构。”

2. 任务拆解与规划 (The Plan)

将一个大需求拆解成 AI 容易执行的小步骤。AI 在执行任务时不可操控性较高，需求和执行步骤拆解得越细，越不容易出错。前期发现问题及时修改，可以大幅提升开发效率。
Vibe 范式： “根据刚才梳理的模块，请把开发过程拆解为几个具体的步骤，并列出每个步骤需要创建的文件名和核心函数。”

3. 迭代式生成与指挥 (The Flow)

按照规划，一步步指挥 AI 生成代码。在这个过程中，你可以随时用自然语言调整“氛围”和细节。
Vibe 范式：“现在的界面太素了，帮我把背景色改成深空灰，蛇的颜色改成霓虹绿，让它看起来更有赛博朋克的感觉。”

4. 自动化测试与审查 (The Review)

代码生成后，不要盲目复制粘贴。让 AI 自己检查自己的代码，或者让它写测试用例。
Vibe 范式：“请检查刚才生成的代码，有没有潜在的 Bug 或逻辑漏洞？如果有，请优化。另外，请帮我写一段测试代码，验证蛇吃到食物后长度是否正确增加。”

5. 报错修复与闭环 (The Fix)

遇到报错是常态。在 Vibe Coding 中，你不需要自己去 Stack Overflow 搜错误，直接把报错信息扔回给 AI。
Vibe 范式：“我在终端运行时报错了，错误信息是 [粘贴报错信息]。请分析原因并给出修复后的完整代码。”

总结：掌握这套流程，你就能像技术负责人一样，轻松驾驭 AI 完成复杂的开发任务！