--- title: "Code Story · Promise of the Star Lantern" url: "https://aigamehub.app/en/games/code-village-0ae33d" source: "https://github.com/YajunMonk/code-village" source_type: "github" play_url: "https://buxiangai.com/game/" platform: "both" login_required: false pricing: "free" origin: "original" ai_tools: [] game_languages: ["zh-cn"] author: "YajunMonk" author_handle: "YajunMonk" category: "Adventure" categories: ["adventure", "casual", "puzzle"] tags: ["browser-game", "chinese", "educational", "narrative", "pixel-art", "vibe-coding"] added: "2026-10-19T13:22:37.792Z" updated: "2026-10-19T13:22:37.793Z" locale: "en" content_locale: "en" --- # Code Story · Promise of the Star Lantern Code Story is a Chinese pixel narrative adventure web game and a playable vibe coding introductory tutorial. Players and AI partner Xiao A complete a commission in Star Lantern Town to fix the milk tea shop's ordering system, experiencing dialogue, exploration, and 44 interactive exercises across five chapters and 27 main areas, learning concepts in the development process. Single-player, Simplified Chinese, supports PC and mobile, no account required, can save locally and export/import progress. ## Description Code Story · Promise of the Star Lantern is a Chinese pixel narrative adventure and also a playable vibe coding introductory tutorial. The story follows Buxiang, who can't write code, and AI partner Xiao A as they take on the "Fix Guanfan" commission to repair the milk tea shop's ordering system: clarify the owner's needs, straighten out the kitchen steps, investigate orders that can't be delivered, and let customers outside town open the ordering page. The game includes maintenance commissions spanning five chapters, from Idea Workshop, Network Town, AI Research Institute, Engineering Workshop to Launch Pad, with 27 main areas linking the development process; 44 sets of interactive exercises and challenges cover arranging recipes, organizing requirements, checking messages, simulating terminals, determining permissions, etc.; 42 main terms and 6 hidden terms are collected in the encyclopedia as the story progresses. Star Lantern Town has 18 enterable interiors, 12 original residents, and 54 object stories, plus about 190 light interactions along the way such as cats, chickens, ducks, butterflies, flower beds, and benches. The code, orders, terminals, and deployments in the game are all teaching simulations; playing does not require connecting to AI services or providing an API Key. For controls, on PC use arrow keys or WASD to move, Shift to run, Space or Enter to talk/confirm, Q/C to open the travel journal and encyclopedia, Esc to pause and save; on mobile use the arrow keys, A button, and run button, with handheld-style buttons in portrait mode. Progress is saved on the current device and browser, and you can manually save, export, and import JSON backups to migrate to another device. Supports Simplified Chinese, single-player, no account required, available on PC and mobile. ## Original post 代码物语｜在像素小镇里学习氛围编程的中文叙事冒险。与不响和 AI 搭档小 A 修好一家店，支持电脑、手机与本地存档。 A pixel adventure about building with AI. Topics: ai-assisted-development, browser-game, canvas, chinese, educational-game, indie-game, javascript, mobile-game, pixel-art, vibe-coding

小 A 捧光 · 游戏图标

代码物语 · 星灯之约

和 AI 搭档修好一家小店，在像素小镇里完成你的第一次开发冒险。

A story-driven pixel adventure about building with AI.

立即游玩 · 下载游戏 · 游戏画面 · 本地运行 · 反馈问题

![代码物语首页：不响与小 A 望向星灯镇](docs/images/title.png) ## 今晚，星灯镇需要你 灯会就要开场，奶茶店的点单系统却坏了。 不会写代码的不响，和 AI 搭档小 A 接下了这份“修好管饭”的委托。你要问清店主的要求，理顺后厨的步骤，查明送不到的订单，再让镇外的客人也能打开点单页面。 《代码物语》是一款**中文像素叙事冒险，也是一份可以玩的氛围编程入门教程**。你会在对话、探索和小挑战里认识开发中的概念，练习向 AI 讲清需求、核对它的回答，以及把一个小想法逐步做成能用的东西。 **单人 · 简体中文 · 浏览器游戏 · 电脑与手机 · 无需账号** ## 你会玩到什么 - **一条贯穿五章的维修委托。** 从想清楚要做什么，到网页、网络、AI、工程和上线，27 个主线区域把开发流程串成一段旅程。 - **44 组互动练习与挑战。** 排菜谱、整理需求、核查消息、模拟终端、判断权限……42 个主线术语和 6 个隐藏术语随剧情收入图鉴。 - **可以进去的小镇。** 18 处室内、12 位原创居民、54 段物件故事。有人修灯，有人记账，也有人出门了，只留下一张纸条。 - **路上也有回应。** 猫、鸡、鸭、蝴蝶、花圃和长椅等 190 处轻互动，让赶路之间也有值得停下来的片刻。 - **一段随时可以接着走的冒险。** 本机自动存档、手动保存、JSON 导出与导入，支持把进度带到另一台设备。 游戏中的代码、订单、终端和部署是教学模拟。游玩不需要连接 AI 服务或提供 API Key；它帮助你理解开发过程，实际项目仍需要在开发工具中动手练习。 ## 游戏画面 以下画面均截自仓库中的实际游戏。 | 灯会前的委托 | 在街道上寻找下一站 | | --- | --- | | ![不响与小 A 收到委托](docs/images/opening.png) | ![星灯镇街道与池塘](docs/images/village.png) | | 推开门，看看小镇的日常 | 把开发概念变成可以操作的练习 | | --- | --- | | ![可探索的室内与物件](docs/images/interior.png) | ![排列步骤的游戏挑战](docs/images/exercise.png) |
手机竖屏：保留掌机式操作

手机使用方向键、A 键和跑步键；竖屏提供鼠尾草绿掌机底座，横屏使用轻量触屏按键。

手机竖屏游戏界面与掌机式按键
## 从点子工坊到发射台 | 章节 | 旅途中的问题 | | --- | --- | | 第一章 · 点子工坊 | 先做什么？怎样把需求说清楚，做出第一个小版本？ | | 第二章 · 网络小镇 | 网页、后厨和仓库怎样分工，消息又怎样送达？ | | 第三章 · AI 研究所 | 怎样给 AI 上下文，核对答案，安排它能做的事？ | | 第四章 · 工程工坊 | 怎样保存版本、使用依赖、处理错误和合并冲突？ | | 第五章 · 发射台 | 本地页面怎样成为网址，上线后又怎样接住问题？ | 主线之外，可以通过旅途手记回访地点、认识居民、查看图鉴和重看已解锁的剧情。 ## 开始游玩 直接打开 **[buxiangai.com/game/](https://buxiangai.com/game/)**。原来的 [GitHub Pages 地址](https://yajunmonk.github.io/code-village/) 也提供同一版本。 | 操作 | 电脑 | 手机 | | --- | --- | --- | | 走动 / 跑步 | 方向键或 WASD / Shift | 方向键 / 跑步键 | | 对话、进屋、确认 | 空格或 Enter | A 键，或点附近人物、房门 | | 对话翻页 | 空格或 Enter | 点对话框 | | 室内探索 | 方向键、Tab / C 选物件 | 点地板、物件标记或人物 | | 旅途手记 / 图鉴 | Q / C | 菜单中的手记 / 右上角图鉴 | | 暂停、保存、设置 | Esc | 右上角菜单 | 故事可以慢慢读。部分挑战有局部计时，失败后可以重试。 ### 存档与换设备 进度保存在**当前设备、当前浏览器、当前网站地址**中，手机和电脑各自保存。 换设备时，在「设置与存档」中**导出备份**，把 JSON 文件传到另一台设备，再选择文件、核对预览并确认导入。导入前会保留一份旧进度，可从同一面板恢复。不同网址之间也可以这样迁移。 完整说明见 [存档与常见问题](docs/SAVES.md)。当前没有账号、云端自动同步或完整 PWA 离线安装。 ## 本地运行 已经提交可运行的网页包，**游玩不需要 Node.js、npm 或构建工具**。安装 Python 3 后： ```sh git clone https://github.com/YajunMonk/code-village.git cd code-village python3 scripts/serve.py --open ``` Windows 可以将最后一行的 `python3` 换成 `py -3`；macOS 也可以双击 `启动代码物语.command`。打开 **http://127.0.0.1:4173/** 即可。 想下载而不克隆仓库，可在 [Releases](https://github.com/YajunMonk/code-village/releases/latest) 获取网页包或离线单文件