ADV.JS

面向 AI 时代的 Markdown 文字冒险游戏引擎。用 Agent 生成标准项目，在本地 Editor 精修、试玩和构建，再直接部署为可分享的 Web 游戏。

支持 JavaScript / TypeScript 模块化编程与按需组装：既能制作完整文字冒险游戏，也能作为剧情运行时嵌入已有 Web 游戏。

• 文档：advjs.org
• 在线 Editor：editor.advjs.org
• 源码协议：MPL-2.0

产品定位

产品	定位	首要用户
advjs	核心引擎、编译器与 CLI	引擎集成者和项目工具链
@advjs/editor	针对 PC 创作优化的本地/在线编辑器，可接入 Skills、MCP 和其他 Agent	专业创作者、团队与 ToB 工作流
@advjs/studio	针对移动端 AI 流程优化的账号型 SaaS，承接公共 AI 积分与轻量创作	个人创作者与 ToC 用户
ADV.JS Skills	Agent 可安装的生成、调试、审查、美术和改编工作流	Codex、Claude Code、Cursor 等 Agent

Editor 和 Studio 使用同一套 Markdown 项目与 Runtime，不是两套内容格式。首发闭环以本地 Editor 为准；Studio 的账号、计费和移动端云流程独立演进。

模块化与嵌入

编译器、运行时、客户端和主题可以按项目需要组合。已有游戏可在构建阶段编译 .adv.md，在交谈时按需加载轻量运行时与剧本 JSON，沿用自己的场景、UI、输入和存档；任务、小游戏与 AI 服务通过宿主活动接入。

设计特点见功能与设计特点，SDK 打包、多剧本编排和版本边界见轻量运行时与 Web 游戏嵌入。轻量子入口已在当前工作区实现，正式使用应检查目标发行物的导出并固定已验证版本。

快速开始

推荐使用当前 Node.js LTS；发布包的最低运行版本与 Vite 对齐（^20.19.0 || >=22.12.0）。安装固定版本的 CLI 与 MCP Server：

npm install --global advjs@0.1.4 @advjs/mcp-server@0.1.4
adv init rain-letter --template default --name 雨夜来信 --json
cd rain-letter
adv agent install --client codex --skills default --mcp --json
adv doctor . --client codex --json

让 Agent 使用 adv-create 创建或修改 Markdown 内容，然后执行：

adv check --json
adv editor .
adv build --json
adv deploy --provider cloudflare-pages --project rain-letter --json

第一次部署会使用固定版本的 Wrangler 完成 Cloudflare 登录；后续部署复用 .advjs/deploy.json 中不含凭据的项目 ID。完整解释见快速开始。

仓库开发

pnpm install
pnpm build
pnpm test
pnpm typecheck
pnpm demo
pnpm editor

demo/starter 是最小可复制项目，demo/hamster 是覆盖多章节、资源和插件活动的完整回归项目。详见 Demo 与 Examples。

浏览器与平台

首发支持 Chromium Stable。Ubuntu 执行完整 journey；macOS 和 Windows 执行安装、CLI、Editor 生命周期与构建 smoke。Firefox 和 Safari 尚未进入首发支持矩阵。