eb63f44271f7a272139a362aa0f92de8c7fe37fc
b1ef45fbd 把“arguments 非空必须是完整 JSON”同时应用到流式和非流式,
越界了。两者的“参数不完整”语义不同:流式意味着流被截断,是传输层事实;
非流式的外层 body 已经完整,参数半截只说明模型输出有问题,属于内容层事实。
App 早有更好的处理——工具计划格式修复循环把畸形响应回灌给模型重写,比硬
报错再重跑整轮 Provider 有效得多。平台层拦下来会丢掉修复所需的 call id、
函数名和原始参数,导致 background_agent_runtime_repairs_malformed_native_
function_arguments 直接以 kind=deserialize 失败,第二次 repair 请求不再发出。
按流式与非流式区分该校验。b1ef45fbd 的其余部分不变:禁止静默丢弃、id 与
函数名必填、空参数归一为空对象、三协议共用一份策略。
原用例反转为断言原样透传,并补一条成对的流式用例锁住流式仍然报错。
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/image-editor/ImageCanvasEditorView.tsx
- src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
- src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal.tsx
核心数据:
- src/data/scenePresets.ts
- src/data/characterPresets.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
56.1%
TypeScript
24.4%
JavaScript
10%
Java
3.7%
Go
3.1%
Other
2.6%