Genarrative/docs/technical/README.md

技术方案

这一组文档偏技术选型、实现路线和外部产品形态拆解。

文档列表

• PHONE_SMS_LOGIN_STAGE_A_IMPLEMENTATION_2026-04-21.md：冻结手机号验证码登录第一阶段的真实落地边界，明确游客兜底默认关闭、公开请求不污染登录态，以及 smoke 必须覆盖短信登录主链。
• AUTH_LOGIN_OPTIONS_DESIGN_2026-04-21.md：/api/auth/login-options 首版设计，冻结登录方式列表 contract、配置开关来源与返回顺序。
• AUTH_ME_QUERY_DESIGN_2026-04-21.md：/api/auth/me 首版查询设计，冻结 Bearer JWT 衔接、user + availableLoginMethods 返回 contract，以及用户不存在时的 401 语义。
• AUTH_LOGOUT_ALL_DESIGN_2026-04-21.md：/api/auth/logout-all 全端登出设计，冻结全部 refresh session 吊销、token_version 递增、清 cookie 语义与 Rust 首版接口边界。
• AUTH_SESSIONS_QUERY_DESIGN_2026-04-21.md：/api/auth/sessions 会话列表设计，冻结当前设备识别、多端登录字段映射、clientLabel 兼容策略与 Rust 首版接口边界。
• PHONE_AUTH_AXUM_MINIMAL_FLOW_DESIGN_2026-04-21.md：手机号验证码登录最小闭环设计，冻结 mock 验证码规则、send-code / phone/login contract 与 crate 边界。
• PHONE_AUTH_AXUM_RATE_LIMIT_AND_FAILURE_DESIGN_2026-04-21.md：手机号验证码冷却与失败次数限制设计，冻结同手机号同场景发送冷却、错误次数耗尽、429 与 Retry-After contract。
• WECHAT_LOGIN_AXUM_IMPLEMENTATION_DESIGN_2026-04-21.md：Rust api-server 微信登录实现设计，冻结微信 provider 接入、系统 JWT 签发边界、wechat/start / wechat/callback / wechat/bind-phone 闭环，以及与后续 SpacetimeDB claims 透传的关系。
• WECHAT_LOGIN_REAL_INTEGRATION_RUNBOOK_2026-04-21.md：微信登录从本地 mock 到真实微信开放平台联调的执行手册，覆盖环境变量、回调域名、代理头要求、验证步骤与常见失败排查。
• PASSWORD_ENTRY_FLOW_DESIGN_2026-04-21.md：密码登录与自动建号落地设计，冻结 /api/auth/entry、幂等兼容策略、模块边界以及与 JWT / refresh cookie 的衔接方式。
• MULTI_DEVICE_SESSION_IDENTITY_DESIGN_2026-04-21.md：多端登录会话身份模型设计，冻结浏览器、小程序、微信内 H5 的客户端身份字段、请求头约定与展示名派生规则。
• PLATFORM_AUTH_REFRESH_COOKIE_ADAPTER_DESIGN_2026-04-21.md：platform-auth refresh cookie 适配设计，冻结 cookie 配置结构、读取规则与 api-server 最小读取链路。
• PLATFORM_AUTH_JWT_ADAPTER_DESIGN_2026-04-21.md：platform-auth 首版 JWT 适配设计，冻结 JwtConfig、claims 结构、HS256 签发/校验、api-server Bearer 中间件与内部验收路由边界。
• OIDC_JWT_CLAIMS_DESIGN_2026-04-21.md：面向 Axum、platform-auth 与 SpacetimeDB 身份透传的 OIDC 风格 JWT claims 设计，冻结 iss/sub/sid/provider/roles 等关键字段。
• RUST_SHARED_LOGGING_CRATE_DESIGN_2026-04-21.md：Rust 工作区统一日志模块 shared-logging 的职责边界、API、输出风格与 api-server 迁移规则。
• SPACETIMEDB_WECHAT_AUTH_STATE_TABLE_DESIGN_2026-04-21.md：M2 第七张微信 OAuth 状态表 wechat_auth_state 的字段、过期/消费语义、wechat/start 与 wechat/callback 的单次消费规则，以及多实例下的清理策略。
• SPACETIMEDB_SMS_AUTH_EVENT_TABLE_DESIGN_2026-04-21.md：M2 第六张短信鉴权统计表 sms_auth_event 的事件范围、统计口径、索引与和风控/审计表的协作边界。
• SPACETIMEDB_AUTH_RISK_BLOCK_TABLE_DESIGN_2026-04-21.md：M2 第五张风控状态表 auth_risk_block 的作用域、活跃态、刷新/解除规则与读取派生约束。
• SPACETIMEDB_AUTH_AUDIT_LOG_TABLE_DESIGN_2026-04-21.md：M2 第四张鉴权审计表 auth_audit_log 的事件范围、追加写规则、索引与对外 DTO 派生约束。
• SPACETIMEDB_REFRESH_SESSION_TABLE_DESIGN_2026-04-21.md：M2 第三张会话表 refresh_session 的 cookie/hash 边界、轮换与吊销语义、索引与迁移规则。
• SPACETIMEDB_AUTH_IDENTITY_TABLE_DESIGN_2026-04-21.md：M2 第二张身份表 auth_identity 的 provider 范围、唯一约束、手机号/微信身份写入规则与迁移策略。
• SPACETIMEDB_AUTH_USER_ACCOUNT_TABLE_DESIGN_2026-04-21.md：M2 第一张身份主表 user_account 的职责边界、字段、唯一约束、状态迁移、旧 users 映射与落地约束。
• SPACETIMEDB_AXUM_OSS_BACKEND_REWRITE_DESIGN_2026-04-20.md：基于当前 Node 后端能力清单，设计用 SpacetimeDB + Axum + 阿里云 OSS 重写后端的目标架构、模块映射、数据分层、迁移顺序与验收标准。
• M6_OSS_SERVER_UPLOAD_AND_STS_POLICY_2026-04-21.md：冻结 M6 剩余的 STS 与服务端上传 helper 落地口径，明确当前上传主链为服务器上传 OSS，Web 端只负责签名读下载。
• AXUM_TO_SPACETIMEDB_ASSET_OBJECT_CONFIRM_CALL_DESIGN_2026-04-21.md：冻结 POST /api/assets/objects/confirm 从 Axum 通过 Rust SDK 调用 SpacetimeDB procedure 的最小落地方案，明确本地 server、数据库名、procedure/reducer 分工与 spacetime-client 边界。
• ASSET_ENTITY_BINDING_REDUCER_DESIGN_2026-04-21.md：冻结已确认 asset_object 绑定到业务实体槽位的首版 reducer/procedure、通用 asset_entity_binding 表与 Axum facade。
• FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md：把鉴权、浏览历史、runtime story 快照、NPC 待接委托与正式生成编排继续后移到 Express 后端的实施方案与验收口径。
• REPO_NOISE_CLEANUP_BASELINE_2026-04-19.md：落实工程清理审计第一阶段后的仓库噪音清理范围、忽略规则闭合点与后续约束。
• PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md：后端提示词收口到 server-node/src/prompts/ 的目录方案、兼容策略与后续新增规则。
• CUSTOM_WORLD_DRAFT_GENERATION_FAILURE_ANALYSIS_AND_FIX_2026-04-20.md：世界草稿生成失败后等待页误显示为“卡在编译草稿卡”的根因拆解、主链与增强链路边界，以及本次修复策略。
• CUSTOM_WORLD_AUTO_ASSET_VISIBILITY_FIX_2026-04-20.md：世界草稿里“资产已生成但结果页看不到”的根因拆解，包含角色主形象展示、分幕背景露出和 fallback 资源格式修复。
• CUSTOM_WORLD_PHASE4_COUNT_SEMANTICS_ALIGNMENT_2026-04-20.md：Phase4 新增角色/地点后草稿作品卡数量统计与测试断言的语义对齐说明。
• AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md：阶段一保持结果页深度编辑能力不变，同时把结果页完整世界快照同步回 Agent session 主链的方案说明。
• AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md：阶段二把平台创作入口统一到聚合作品列表，并收紧 Agent 结果页的新增入口职责边界。
• AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md：阶段三继续降级旧 pipeline，让创作中心只认 Agent 草稿与已发布作品，并把 Agent 结果页冻结为预览收口层。
• AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md：修正 Agent 对话框与结果页职责边界，明确 Agent 只收集八锚点，已有底稿的精修进入结果页完成。
• CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 custom-world/sessions 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
• CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md：梳理当前创作入口到结果页自动保存再到进入世界的全链前后端脚本地图，并给出文件级重构拆分方案、目标分层与阶段验收标准。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md：梳理当前 RPG 从平台入口、继续游戏、角色选择到营地开场、冒险运行态与 runtime story 后端结算的全链脚本地图，并给出 RPG 专属命名规范、目标分层和可并行执行的工作包。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md：记录 RPG 进入游戏与运行时链路工作包 A 已完成的新目录骨架、前后端 façade、按域路由 path 常量与兼容仓储入口。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md：记录工作包 B 已完成的前端 RPG 入口壳层真实迁移、rpg-entry 新入口 hooks 收口，以及旧 game-shell / rpg-creation-flow 路径降级为兼容层的状态。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md：记录工作包 C 已完成的 rpg-session 主链迁移、snapshot / save archive client 收口、旧 useGame* 降级为兼容 façade，以及定向回归结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md：记录工作包 D 已完成的前端运行态 shell / stage router / panel router 真实迁移、AdventurePanel section 拆分，以及旧 GameShell* 热点降级为兼容桥的现状。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md：记录 RPG 进入游戏与运行时链路工作包 F 已完成的后端 route 真正拆边界、app.ts 新域挂载、旧 runtimeRoutes / storyActionRoutes 兼容降级，以及定向路由回归验证结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md：记录工作包 E 已完成的前端 runtime story 主链真实迁移、NPC 交互与 gateway/client 收口、旧入口兼容降级，以及定向回归验证结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md：记录工作包 G 已完成的后端 runtime session / action service 物理迁移、新域原语导出、旧热点兼容降级，以及定向 runtime story 回归验证结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md：记录工作包 H 已完成的 RPG 运行时仓储拆分、shared runtime contract 分文件、旧 story.ts façade 兼容与定向回归结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md：对照执行计划逐项复核第一批与第二批并行工作的真实落地状态，记录本轮确认到的测试合流收口遗漏与文档索引补齐结果。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md：记录 RPG 执行计划第三批收口已完成的前端新域主链接回、后端新仓储接线、shared contract 直连收紧、旧兼容脚本物理删除，以及明确未扩到 UI 和无关历史文档的边界。
• RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md：记录 RPG 主链旧 GameShell、useGame*、hooks/story、runtimeRoutes、modules/story/*、contracts/story.ts 脚本的物理删除范围、残留依赖扫描和定向验证结果。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md：记录创作链路重构工作包 A 已落地的 RPG 创作域目录骨架、兼容 façade，以及补齐后的共享契约骨架入口。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md：记录工作包 E 已完成的后端 Agent 编排拆分、executor 物理迁移、发布链切到 CustomWorldAgentPublishingService、checkpoint 真快照、场景资产 coverage 收口，以及 Phase3/Phase5 定向回归结果。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md：记录工作包 H 已完成的共享契约物理拆分、旧命名兼容分文件、统一 fixture，以及 shared contract test / preview compiler / works assembler / works service 回归基建。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md：记录工作包 B 已完成的前端平台壳层编排拆分、平台 hooks / coordinator 接入、旧入口兼容保留，以及交互回归验证结果。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md：记录工作包 F 已完成的后端 session/store/repository 拆分、works 读模型 service 收口、route/context 直接注入新仓储，以及定向 custom world 回归验证结果。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md：记录工作包 D 已完成的前端 custom world client 真正迁出、旧 service 兼容降级，以及平台壳层/结果页测试切换到 rpgCreation 域入口的现状。
• CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md：记录工作包 G 已完成的 runtime profile 目录化、服务端 preview compiler 收口，以及 foundation draft 主生成链与 preview 编译边界的直接拆开。
• CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md#93-工作包-c前端结果页与编辑器拆分：记录工作包 C 已完成的结果页壳层拆分、编辑器目标分发与 mapper 收口、角色资产工坊 section/workflow 拆分，以及仍保留的阶段性 shared 实现边界。
• CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
• TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
• NODE_BACKEND_MODULE_AND_API_INDEX.md：由 server-node/src/manifest/backendCapabilityManifest.ts 生成的 Node 后端模块职责、挂载面与接口索引，后续新增模块/接口时同步更新这一份。
• NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
• EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md：Express 后端当前 contract 冻结版本、热点文件编辑规则与集成窗口清单。
• EXPRESS_BACKEND_WORKSTREAM_AUDIT_2026-04-09.md：按并行工作流文档逐项核对后的完成度审计与剩余收口点。
• EDITOR_ASSET_API_MIGRATION_2026-04-08.md：编辑器写盘、资产生成、任务查询从 Vite 本地插件迁到 Node 后端的接口与工具链清单。
• GO_SERVER_RUNTIME_INTEGRATION_2026-04-07.md：Go 服务端接入、运行时持久化迁移与当前进展记录。
• GO_SERVER_TASKLIST_2026-04-08.md：Go 服务端已完成与未完成事项的执行清单。
• AI_CHARACTER_ANIMATION_TECHNICAL_SOLUTION_2026-04-04.md：AI 生成角色形象与角色动画的技术路线。
• ALIYUN_NPC_IMAGE_ANIMATION_EXPERIMENT_2026-04-07.md：面向编辑器的阿里云 NPC 形象与动作实验方案，按 4 条生成链路对比。
• PIXELMOTION_TECHNICAL_BREAKDOWN_2026-04-04.md：PixelMotion 产品形态与能力拆解。
• SERVER_DEPLOYMENT_AND_CORS_TECHNICAL_SOLUTION_2026-04-05.md：服务端部署、代理层与 CORS 方案。

使用建议

• 做实现选型时，优先看这一组。
• 做阶段排期时，把这一组和 docs/planning/、docs/prd/ 一起看，更容易判断先后顺序。