Files
Genarrative/.codex
kdletters 1e0aeb95b0 后台表查询枚举列按 schema 展示变体名,不再只看数值
- 新增按 SpacetimeDB schema 解析枚举展示名的实现:读取 typespace.types 与表的 product_type_ref,为每个「Sum 且变体全为单元变体」的列建立按变体索引排列的展示名,变体名归一到 snake_case
- 支持 Option<枚举> 列:标记 optional,[0, [索引, []]] 出变体名、[1, []] 仍是空值;Option<普通值> 与带载荷的 Sum 继续走通用解码,单变体枚举同样出名字
- 删除只覆盖 profile_recharge_order.kind / status 的硬编码映射 normalize_admin_database_known_enum
- 枚举展示名同时作用于行的 cells 与 raw,关键词搜索、结构化筛选和稳定排序都按展示名生效
- 表查询行解析与行构建改为接收枚举映射,schema 夹具用例覆盖直接枚举、Option 枚举、单变体枚举与未知表
- 同步开发运维文档的表查询口径段、后台 skill 的 SATS 展示参考与决策记录
- 验证:cargo test -p api-server --manifest-path server-rs/Cargo.toml --bin api-server admin(139 passed / 0 failed / 1 ignored);cargo check -p api-server;cargo fmt --all --check;npm run check:encoding;npm run check:doc-index;git diff --check;本地 dev schema 回放同一算法,85 张表 32 个直接枚举列 + 2 个 Option 枚举列全部解析出展示名、0 残留
2026-09-23 20:52:00 +08:00
..
2026-05-21 20:21:32 +08:00

Genarrative Codex 项目工具

.codex/ 是仓库级 Codex 工具目录,保存项目共享的 skills、插件资源、hooks 和相关配置模板。它只描述如何协作和加载工具,不承载项目业务知识。

目录约定

  • .codex/skills/ 是项目专属 skill 根目录。每个 skill 以目录中的 SKILL.md 为入口,配套的参考资料和脚本放在同一目录下。
  • spec-driven-development 负责跨模块、公开契约、SpacetimeDB、AGC/Runtime 和复杂 UI 任务的规范先行与逐里程碑验收;具体规则以 docs/ 下的 SDD 工作流和模板为准。
  • .codex/plugins/ 保存随仓库分发的项目插件资源及其参考资料。当前的 game-studio 插件提供浏览器游戏设计、原型、2D/3D 技术栈、素材管线和 playtest 工作流;是否启用遵循当前 Codex 的插件加载机制,不依赖旧工具的环境变量或个人配置脚本。
  • .codex/hooks/.codex/environments/ 等目录保存项目工具链所需的 hooks 和环境模板;它们不替代项目代码中的运行时配置。
  • 长期有效的产品、架构、接口、排障和协作知识统一放在 docs/docs/project-memory/,不复制到本目录。

使用边界

进入仓库后先读根目录 AGENTS.md,再按任务路由读取对应 skill。SpacetimeDB 的通用概念、Rust 服务端、CLI、TypeScript 客户端和 MCP 用法由已安装的官方插件提供;项目约束和入口由 .codex/skills/genarrative-spacetimedb/SKILL.md 统一编排。

个人 ~/.codex 配置、凭据、会话、环境变量和本地路径不得复制到仓库。若本目录内容与当前代码或最新 docs/ 冲突,以代码和最新文档为准,并修正过期工具说明。