技术方案
这一组文档偏技术选型、实现路线和外部产品形态拆解。
文档列表
- 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 首版接口边界。 - 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-authrefresh cookie 适配设计，冻结 cookie 配置结构、读取规则与api-server最小读取链路。 - PLATFORM_AUTH_JWT_ADAPTER_DESIGN_2026-04-21.md：
platform-auth首版 JWT 适配设计，冻结JwtConfig、claims 结构、HS256签发/校验、api-serverBearer 中间件与内部验收路由边界。 - 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重写后端的目标架构、模块映射、数据分层、迁移顺序与验收标准。 - 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边界。 - 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 新增角色/地点后草稿作品卡数量统计与测试断言的语义对齐说明。
- 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/一起看，更容易判断先后顺序。