AI Native Visual RPG

一个以“AI 叙事 + 本地规则 + 像素演出”为核心的视觉 RPG 原型。

当前已经具备这些主要能力：

• 世界与角色选择
• AI 剧情推进与流式对话
• 战斗演出、NPC 战斗、切磋
• NPC 交易、送礼、求助、招募
• 宝藏交互
• 同伴跟随与战斗
• 预设编辑器 / NPC 视觉编辑器 / 行为编辑器
• 自动存档与继续游戏

运行

前置条件：

• Node.js

安装依赖：

npm install

准备环境变量：

• 复制 .env.example 为 .env.local
• 填入 LLM_API_KEY / ARK_API_KEY
• 按需设置 VITE_LLM_MODEL
• 如需打印完整 prompt/output，可把 VITE_LLM_DEBUG_LOG 设为 true

启动开发环境：

npm run dev

构建生产包：

npm run build

常用检查

类型检查：

npm run lint

编码检查：

npm run check:encoding

内容引用校验：

npm run check:data

编辑器 override 校验：

npm run check:overrides

关键内容 smoke 检查：

npm run check:smoke

一键内容检查：

npm run check:content

主要结构

主运行时：

• src/App.tsx
• src/components/GameShell.tsx
• src/hooks/useCombatFlow.ts
• src/hooks/useStoryGeneration.ts

编辑器：

• src/components/PresetEditor.tsx
• src/components/NpcVisualEditor.tsx
• src/components/StateFunctionEditor.tsx

核心数据：

• src/data/scenePresets.ts
• src/data/characterPresets.ts
• src/data/monsterPresets.ts
• src/data/npcInteractions.ts
• src/data/treasureInteractions.ts

文档入口

开发经验沉淀：

• docs/PROJECT_DEVELOPMENT_EXPERIENCE.md
• docs/FUNCTION_SCRIPT_CATALOG_2026-04-04.md

移动端与 UI 经验：

• docs/MOBILE_UI_DEV_EXPERIENCE.md
• docs/AGENT_UI_CHANGELOG.md
• UI_CODING_STANDARD.md

优化路线图：

• docs/PROJECT_OPTIMIZATION_AND_FEATURE_ROADMAP.md

切磋状态机说明：

• AGENT_SPAR_STATE_MACHINE_GUIDE.md