lhk229
9a3b9dce15
两条都是 run 17（571 字完整需求走生产链路）实测撞出来的，都在既有代码里， 都比刚修的台账约束更早触发。 N1 —— round=0 决定被钉死成 default_pending。用户一次把需求说全时全部决定都是 round=0，于是没有任何决定可能成为 prototype_pending；而 validate_decisions 的双射 又要求 prototypeValidationItems 逐项对应 prototype_pending 决定，结果首次 plan.submit_gdd 必被预检拒收，这份稿子也永远不可能带上原型验证项。实测子 Agent 读懂了拒绝理由，代价是把「触控手感」「30 回合是不是真的 8-12 分钟」这类没人验证过 的假设一律标成「默认，待确认」——那是在说谎，它们不是默认值。 round=0 真正要守的是「从未提问过的决定不得声称任何用户权威」，即 answerSource 必须是 default，而不是把状态钉死。改成允许 default_pending 与 prototype_pending 两种，answerSource 仍强制 default，confirmed 照旧拒。双射保持 严格不动——Agent 现在有合法途径同时给出决定和验证项。 N2 —— AGC_NEEDS_USER_INPUT_V1 的解析在 build_static_delegate_structured_result_at 里 `?` 往外传，而这个函数跑在投递回执时，子 run 已经 idle/completed，没有任何一轮 可以把解析错误回灌回去。实测一次 option 多写 `id` 字段就让整条委派 result_failed、 父 Supervisor 直接 needs-reconciliation 停下等人。不是预算设成 0，是结构上没地方 重试；对照原型，它在 run 循环内解析、坏了注入 INJ_ENVELOPE_REJECTED 重试 3 次。 信封格式属于「本次 Provider 输出写错」，与 plan.submit_gdd 的业务拒绝同类，不是 durable 权威损坏。降级成 needs-repair，并把解析失败在哪当返工理由带上（而不是把 那段无法解析的原文照抄回去，那对子 Agent 没有可操作信息）。Supervisor 用既有的一次 返工额度即可自愈。 role brief 补上 prototypeValidationItems：schema 把它列为 required，brief 此前 一个字没提它、也没提双射，模型只能靠撞。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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、独立bgfilter-worker、Rustapi-server、主站 Vite 与后台 Vite，适合完整联调；内部 worker ready 后才启动 API。- 主站默认地址是
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:bgfilter-worker、npm run dev:web、npm run dev:admin-web；其中dev:api-server会安全带起同 runner 的 BgFilter worker 依赖。 - 如需自动刷新后端模块，使用
npm run dev -- --watch；其中spacetime-module改动后只会重新发布模块，不会重启 standalone，Rust 源码改动会把api-server与bgfilter-worker作为一个组合单元重启。主站和后台前端源码变化交给 Vite 自身 HMR，不由外层 watcher 重启。非 watch 模式下可在npm run dev终端输入rs api-server、rs bgfilter-worker、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 资产与编码规范。