Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

VibeGuide 🎮✨

一款像素风 RPG 冒险游戏,带你从零开始学会 Vibe Coding。

不会编程?没关系。你只需要会说话。

License: MIT Electron Vibe


🧙 故事开始了

在遥远的数字大陆上,人们用"代码语言"构建网站、应用和游戏——但这门古老的语言只有少数人能掌握。

直到有一天,AI 精灵苏醒了。它们能理解人类的自然语言,将想法直接转化为代码,让每一个人都拥有了「创造」的力量。

现在,数字大陆需要新的建造者。

勇者,你准备好了吗?


🤔 等等,这游戏是干嘛的?

VibeGuide 不是模拟器——你在游戏里做的每件事都是真的。

安装 IDE ✅ 创建项目 ✅ 启动预览 ✅ 部署上线 ✅

全是真实操作,NPC 一步步带你做。通关时你会拥有一个真正上线的个人网站。

别的游戏通关给你一张 CG。我们通关给你一个网站。


🗺️ 冒险路线图

🏕️ 起源村          选一个很酷的名字和职业
       │
       ▼
⚒️ 工具锻造谷      锻造你的武器(安装 AI 编程 IDE)
       │
       ▼
🛕 觉醒神殿        第一次和 AI 精灵对话(比你想的简单)
       │
       ▼
🏗️ 创造平原        用 AI 造出一个真正的网站!
       │
       ▼
🗼 传送灯塔        把你的网站传送到全世界(GitHub Pages 部署)
       │
       ▼
🎉 通关!          你现在是 Vibe Coder 了

⚔️ 选择你的职业

"你的职业不决定你的能力,只决定你和 AI 说话的风格。"

职业 风格 擅长
📋 产品策划师 "我要一个有导航栏的页面" 把想法变成精确的 AI 指令
⚡ 开发工程师 "用 flexbox 居中这个 div" 理解 AI 生成的代码并微调
🎨 美术设计师 "背景要渐变色,卡片要圆角阴影" 用语言描述一切视觉效果

👥 你会遇到的 NPC

NPC 身份 性格
🧔 加尔德 铁匠 话不多,但他推荐的武器不会错
🧙‍♀️ 艾拉 祭司 耐心到你想成为她的朋友
👷 洛恩 建筑师 严谨,"先画蓝图再动工"
🧙 赫尔墨斯 灯塔守卫 负责把你的作品传送到全世界

💡 Vibe Coding 三原则

贯穿整个冒险的核心理念:

# 原则 翻译成人话
1 描述你想要什么 不需要先知道怎么做,说出来就行
2 报错贴给 AI 遇到 bug?截图 + 复制错误丢给 AI,它来修
3 一步一步来 别一次提 10 个需求,一次一个,迭代前进

✨ 一些内容

  • 🎵 全程序化 8-bit 音乐 — 零音频文件,BGM 和音效全部用 Web Audio API 实时合成
  • 💥 像素方块粒子特效 — 烟花、爆炸、星芒、升级光柱、彩纸飘落,通关时的烟花能放一整天
  • 🔍 智能检测 — 自动检测你的 IDE、文件、端口,游戏知道你做到哪了
  • 💬 NPC 打字机对话 — 一个字一个字蹦出来,很有氛围
  • 📋 一键复制 AI 咒语 — 游戏给你准备好 Prompt,复制粘贴给 AI 就行
  • 💾 自动存档 — 关了游戏下次接着冒险,不会丢进度
  • 🏆 装备 & 徽章 — 每关通关都有奖励,集齐装备成就感拉满

🚀 开始冒险

方式一:直接玩(推荐)

前往 Releases 下载最新的 .exe,双击启动,开始冒险。

方式二:从源码运行

需要 Node.js 18+。

git clone https://github.com/Damue01/VibeGuideGame.git
cd VibeGuideGame
npm install
npm run dev

打包成可执行文件

npm run build:electron

GitHub Pages 部署

推送到 master 分支会自动触发 GitHub Actions 部署到 GitHub Pages。

首次部署前,需要在仓库中启用 Pages:

  1. 打开仓库 Settings → Pages → Source,选择 GitHub Actions
  2. 或用 GitHub CLI 一条命令搞定:
    gh api repos/{owner}/{repo}/pages -X POST -f build_type=workflow

工作流会尝试自动启用 Pages,但部分仓库权限可能需要手动操作。如果 Actions 运行失败并提示权限不足,请按上述步骤手动开启。


🛠️ 技术栈

层 技术
框架 Electron + React 19 + TypeScript
构建 Vite
状态 Zustand
音频 Web Audio API 程序化合成
粒子 Canvas 2D 自研引擎
检测 chokidar + TCP Socket

⭐ 喜欢这个项目?

给颗星就是最好的支持 —— 点右上角的 Star 按钮,让更多人发现这段冒险。

📄 License

MIT — 随便用,随便改,记得给颗 ⭐~

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages