3a3cc89280e2c4fe29c6debdf0b809b9e908ea4f
Remove backend-assembled raw Prompt and copy action from image info; render a lightweight generationInputs snapshot (user panel inputs + reference thumbnails) stored on canvas layers and shown in the image info dialog. Unify canvas display and info to use originalWidth/originalHeight (Resolution) instead of saved Size and hydrate legacy layout width/height only as fallback. Add model/aspectRatio/imageSize options for character/icon generation (frontend state, tests, and client payloads). Increase Axum JSON body limit for character animation endpoint to 12MB for compatibility and prefer submitting persisted objectKey over large Data URLs. Update tests, docs, and related server/frontend code to reflect these behaviors and validations.
AI Native Visual RPG
一个以“AI 叙事 + 本地规则 + 像素演出”为核心的视觉 RPG 原型。
当前已经具备这些主要能力:
- 世界与角色选择
- AI 剧情推进与流式对话
- 战斗演出、NPC 战斗、切磋
- NPC 交易、送礼、求助、招募
- 宝藏交互
- 同伴跟随与战斗
- 游戏主流程内嵌的角色资产工坊、自定义世界实体编辑与角色形象编辑
- 自动存档与继续游戏
运行
前置条件:
- Node.js
- Rust / Cargo
- SpacetimeDB CLI
安装依赖:
npm install
准备环境变量:
- 复制
.env.example为.env.local - 填入
LLM_API_KEY/ARK_API_KEY - 按需设置
VITE_LLM_MODEL - 如需启用阿里云短信验证码登录,填写
ALIYUN_SMS_ACCESS_KEY_ID、ALIYUN_SMS_ACCESS_KEY_SECRET,并确认SMS_AUTH_PROVIDER="aliyun" - 本地联调短信登录时,建议将
VITE_AUTH_ALLOW_DEV_GUEST设为false,避免开发模式自动进入游客账号而跳过登录页 - 如需打印完整 prompt/output,可把
VITE_LLM_DEBUG_LOG设为true
启动开发环境:
npm run dev
补充说明:
npm run dev会启动 SpacetimeDB standalone、Rustapi-server、主站 Vite 与后台 Vite,适合完整联调。- 主站默认地址是
http://127.0.0.1:3000,后台可从http://127.0.0.1:3000/admin/进入,也可直连http://127.0.0.1:3102。 - 四个模块可独立启动:
npm run dev:spacetime、npm run dev:api-server、npm run dev:web、npm run dev:admin-web。 - 如需自动刷新后端模块,使用
npm run dev -- --watch;其中spacetime-module改动后只会重新发布模块,不会重启 standalone,api-server改动后会重启 Rust 进程。主站和后台前端源码变化交给 Vite 自身 HMR,不由外层 watcher 重启。非 watch 模式下可在npm run dev终端输入rs api-server、rs web、rs admin-web、rs spacetime或rs all,其中rs spacetime也是只重新发布模块。
构建生产包:
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/components/CustomWorldEntityEditorModal.tsx
- src/components/CustomWorldNpcVisualEditor.tsx
- src/components/CustomWorldRoleAssetStudioModal.tsx
核心数据:
- src/data/scenePresets.ts
- src/data/characterPresets.ts
- src/data/monsterPresets.ts
- src/data/npcInteractions.ts
- src/data/treasureInteractions.ts
文档入口
docs/ 已在 2026-05-15 完成压缩整理,旧 PRD、设计、审计、阶段计划和技术流水账不再作为实现依据。当前只读取:
- docs/README.md:当前文档总入口。
- docs/【项目基线】当前产品与工程约束-2026-05-15.md:产品、命名、UI、协作和废弃路线。
- docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md:DDD 边界、API 分组、SpacetimeDB schema 规则和表目录。
- docs/【玩法创作】平台入口与玩法链路-2026-05-15.md:创作入口、草稿架和各玩法当前口径。
- docs/【开发运维】本地开发验证与生产运维-2026-05-15.md:本地启动、检查、部署、埋点和运营查询。
- UI_CODING_STANDARD.md:像素 UI 资产与编码规范。
Description
Languages
Rust
43.3%
TypeScript
40%
Java
7%
Go
5.9%
JavaScript
1.6%
Other
2.1%