lhk229
4ccfdc68f6
判据是 status === 'generating' && !perfectPixelOperation，而 perfectPixelOperation 要到源图解析/直传完成后才写入。未登记的本地图片要走 ticket → PUT → confirm， 预算上限 90 秒；这段窗口里占位是 generating、只有 requiresLiveSession、没有账本， 判据返回 true——用户删一个免费操作会被告知「已消耗的泥点不会返还」，与「完美像素 任何状态直接删、不弹确认」的决策直接矛盾。 perfectPixelOperationId marker 从占位创建那一刻就写上（operationId === dialogId 在创建时已知），判据改看 marker。marker 的语义也因此更准确：它表示「这个占位属于 一次完美像素操作」，而不是「账本已存在」。 未采纳「删掉弹窗入口」：删除入口全仓只有 requestRemoveCanvasGenerationDialog 一条， 右键、Delete、工具栏全部汇入，完美像素没有自己的删除路径可摘。「从本链路删入口」 等价于「让判据认得出本链路」，绕不开识别问题。 未采纳新增计费字段（今天唯一生产者只有完美像素，属过度设计），也未采纳判据加 requiresLiveSession（那只是换一个代理，而用短寿命字段的存在性判断长期属性正是本 缺陷的成因模式）。 连带影响已核：会话内到期清理不受影响（看的是 perfectPixelOperation 而非 marker）； 只有加载时的快照清理会豁免源准备阶段的占位，使其显示为可删的失败卡而非被静默清掉， 这与「系统不替用户删」一致。 测试夹具原本带着 perfectPixelOperation，编码了与判据相同的错误假设，结构上覆盖不到 这个窗口。夹具补上 marker 还原真实形状，并新增「只有 marker、尚无账本」用例，回退 判据后报 expected true to be false。 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 资产与编码规范。