修复资源登记把任意图片写成 ui 类型

停用本地导入图片的 ui 默认 kind：agent_local_project_file_type 的图片扩展名分支改写 canonical image（派生 unclassified，落「待归类」），并注明不许把 ui 当图片默认值及其不可恢复原因——读时自愈只在落盘 category 为 unclassified 时触发，kind 本身写错时自愈只会把错值放大成 ui-interaction
账户素材导入改用平台真实类型：新增 imported_platform_asset_kind，账户素材库记录自带的 assetKind 不再被常量 ui 顶掉，缺失才退回中性 image
平台素材导入改用响应里的 assetKind：网页项目画布与平台素材导入同样走 imported_platform_asset_kind，不再写死 ui
上传素材按内容证据推导 kind：upload_local_asset_at 不再把来源词 uploaded 当类型，改由 uploaded_asset_kind 按 mediaType 与扩展名推导 audio/video/image/document/code，判不出才用中性 asset；同一命令也收 .wav 与 .md，因此不能一刀切成 image
补 4 处回归与反查用例：本地导入与上传断言落盘 kind 与 category 且不得出现 ui、ui-interaction、uploaded；两处平台导入的 kind 解析加纯函数单测与调用点反查门禁；变异把错值改回来必须变红（M1/M2/M3 实测 4 个用例全红，还原后 diff 与基线逐字节一致）
覆盖边界：账户素材库与平台素材导入是异步 HTTP 路径，仓库内没有可复用的端到端夹具，这两条覆盖是纯函数单测加调用点反查门禁，不是端到端断言；本地导入与上传是读落盘 manifest 的行为级断言
后续事项：ImportedAsset.asset_kind 仍返回平台原始值（缺失为 none），与已落盘 kind 可能不一致，本次未改动

.claude/settings.local.json

@@ -1,15 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm test:*)",
-      "Bash(netstat -ano)",
-      "Bash(npm run:*)",
-      "Bash(findstr :8081)",
-      "Bash(taskkill:*)",
-      "Bash(findstr LISTENING)",
-      "Bash(npx tsc:*)",
-      "Bash(lsof -ti:8081)",
-      "Bash(curl -s http://localhost:8081/health)"
-    ]
-  }
-}

.cloudbase/container/debug.json

@@ -1 +1 @@
-{"containers":[],"config":{}}
+{ "containers": [], "config": {} }

.codex/README.md

@@ -0,0 +1,16 @@
+# Genarrative Codex 项目工具
+
+`.codex/` 是仓库级 Codex 工具目录，保存项目共享的 skills、插件资源、hooks 和相关配置模板。它只描述如何协作和加载工具，不承载项目业务知识。
+
+## 目录约定
+
+- `.codex/skills/` 是项目专属 skill 根目录。每个 skill 以目录中的 `SKILL.md` 为入口，配套的参考资料和脚本放在同一目录下。
+- `.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/` 冲突，以代码和最新文档为准，并修正过期工具说明。

.codex/hooks/post-edit-codegraph-sync.mjs

@@ -7,23 +7,33 @@ import { fileURLToPath } from 'node:url';
 const scriptDir = dirname(fileURLToPath(import.meta.url));
 const repoRoot = resolve(scriptDir, '..', '..');
 const logDir = resolve(repoRoot, '.codex', 'logs');
-const hasCodegraphConfig = existsSync(resolve(repoRoot, '.codegraph', 'config.json'));
+const hasCodegraphConfig = existsSync(
+  resolve(repoRoot, '.codegraph', 'config.json'),
+);
 const npmCommand = process.platform === 'win32' ? 'cmd' : 'npm';
 
 if (!hasCodegraphConfig) {
-  console.log('[codex-hook] 未发现 .codegraph/config.json，跳过 CodeGraph 同步。');
+  console.log(
+    '[codex-hook] 未发现 .codegraph/config.json，跳过 CodeGraph 同步。',
+  );
   process.exit(0);
 }
 
-const result = spawnSync(npmCommand, process.platform === 'win32' ? ['/d', '/s', '/c', 'npm run codegraph:sync'] : ['run', 'codegraph:sync'], {
-  cwd: repoRoot,
-  shell: false,
-  encoding: 'utf8',
-  env: {
-    ...process.env,
-    NO_COLOR: process.env.NO_COLOR ?? '1',
+const result = spawnSync(
+  npmCommand,
+  process.platform === 'win32'
+    ? ['/d', '/s', '/c', 'npm run codegraph:sync']
+    : ['run', 'codegraph:sync'],
+  {
+    cwd: repoRoot,
+    shell: false,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      NO_COLOR: process.env.NO_COLOR ?? '1',
+    },
   },
-});
+);
 
 mkdirSync(logDir, { recursive: true });
 if (result.stdout) {
@@ -44,7 +54,9 @@ if (result.signal) {
 }
 
 if ((result.status ?? 0) !== 0) {
-  console.error('[codex-hook] CodeGraph 同步失败，请手动运行 npm run codegraph:sync 查看详情。');
+  console.error(
+    '[codex-hook] CodeGraph 同步失败，请手动运行 npm run codegraph:sync 查看详情。',
+  );
   process.exit(result.status ?? 1);
 }
 

.codex/hooks/pre-submit-compile-check.mjs

@@ -14,20 +14,40 @@ if (hookInput && !isGitCommitCommand(extractShellCommand(hookInput))) {
 }
 
 const validationSteps = [
+  {
+    label: 'Rust format check',
+    command: npmCommand,
+    args:
+      process.platform === 'win32'
+        ? ['/d', '/s', '/c', 'npm run check:rustfmt']
+        : ['run', 'check:rustfmt'],
+  },
   {
     label: 'TypeScript typecheck',
     command: npmCommand,
-    args: process.platform === 'win32' ? ['/d', '/s', '/c', 'npm run typecheck'] : ['run', 'typecheck'],
+    args:
+      process.platform === 'win32'
+        ? ['/d', '/s', '/c', 'npm run typecheck']
+        : ['run', 'typecheck'],
   },
   {
     label: 'Admin web typecheck',
     command: npmCommand,
-    args: process.platform === 'win32' ? ['/d', '/s', '/c', 'npm run admin-web:typecheck'] : ['run', 'admin-web:typecheck'],
+    args:
+      process.platform === 'win32'
+        ? ['/d', '/s', '/c', 'npm run admin-web:typecheck']
+        : ['run', 'admin-web:typecheck'],
   },
   {
     label: 'Rust api-server compile check',
     command: 'cargo',
-    args: ['check', '-p', 'api-server', '--manifest-path', 'server-rs/Cargo.toml'],
+    args: [
+      'check',
+      '-p',
+      'api-server',
+      '--manifest-path',
+      'server-rs/Cargo.toml',
+    ],
   },
 ];
 
@@ -66,7 +86,9 @@ function runStep(step) {
   }
 
   if (result.error) {
-    console.error(`[codex-hook] ${step.label} 启动失败：${result.error.message}`);
+    console.error(
+      `[codex-hook] ${step.label} 启动失败：${result.error.message}`,
+    );
     return { ok: false, status: 1 };
   }
 
@@ -104,12 +126,15 @@ function extractShellCommand(input) {
     input?.command,
   ];
 
-  const command = candidates.find(value => typeof value === 'string' && value.trim().length > 0);
+  const command = candidates.find(
+    (value) => typeof value === 'string' && value.trim().length > 0,
+  );
   if (command) {
     return command;
   }
 
-  const shellCommand = input?.tool_input?.cmd ?? input?.toolInput?.cmd ?? input?.arguments?.cmd;
+  const shellCommand =
+    input?.tool_input?.cmd ?? input?.toolInput?.cmd ?? input?.arguments?.cmd;
   if (Array.isArray(shellCommand)) {
     return shellCommand.join(' ');
   }

.codex/plugins/game-studio/.codex-plugin/plugin.json

@@ -0,0 +1,41 @@
+{
+  "name": "game-studio",
+  "version": "0.1.0",
+  "description": "Design, prototype, and ship browser games with guided 2D and 3D workflows, asset pipelines, and playtesting support.",
+  "author": {
+    "name": "OpenAI",
+    "email": "support@openai.com",
+    "url": "https://openai.com/"
+  },
+  "homepage": "https://openai.com/",
+  "repository": "https://github.com/openai/plugins",
+  "license": "MIT",
+  "keywords": [
+    "games",
+    "phaser",
+    "threejs",
+    "react-three-fiber",
+    "gltf",
+    "rapier",
+    "webgl",
+    "sprites",
+    "playtest"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Game Studio",
+    "shortDescription": "Design, prototype, and ship browser games",
+    "longDescription": "Plan, prototype, and build browser games with guided workflows for gameplay systems, UI, asset pipelines, and playtesting across 2D and 3D projects.",
+    "developerName": "OpenAI",
+    "category": "Coding",
+    "capabilities": ["Interactive", "Write"],
+    "websiteURL": "https://openai.com/",
+    "privacyPolicyURL": "https://openai.com/policies/privacy-policy/",
+    "termsOfServiceURL": "https://openai.com/policies/terms-of-use/",
+    "defaultPrompt": ["Design a browser game and plan the core loop"],
+    "brandColor": "#0F766E",
+    "composerIcon": "./assets/game-studio.svg",
+    "logo": "./assets/app-icon.png",
+    "screenshots": []
+  }
+}

.codex/plugins/game-studio/__init__.py

@@ -1,8 +1,8 @@
-"""Hermes wrapper for the OpenAI Codex Game Studio plugin.
+"""Metadata bridge for the bundled Codex Game Studio project plugin.
 
-This plugin was imported from a Codex curated plugin cache. It exposes the
-plugin's bundled SKILL.md files as Hermes plugin skills using qualified names
-like `game-studio:phaser-2d-game`.
+The manifest and bundled ``SKILL.md`` files are the source of truth. This
+module only exposes their descriptions to a compatible plugin host and keeps
+the project resource bundle free of runtime-specific behavior.
 """
 
 from __future__ import annotations

.codex/plugins/game-studio/plugin.yaml

@@ -0,0 +1,7 @@
+name: game-studio
+version: 0.1.0
+description:
+  Design, prototype, and ship browser games with guided 2D and 3D workflows,
+  asset pipelines, and playtesting support.
+author: OpenAI
+kind: standalone

.codex/plugins/game-studio/references/gltf-loading-starter.md

@@ -0,0 +1,43 @@
+# GLB Loading Starter
+
+Use this as the canonical minimal pattern for loading shipped 3D content.
+
+## Vanilla Three.js
+
+```ts
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
+
+const draco = new DRACOLoader();
+draco.setDecoderPath('/draco/');
+
+const gltfLoader = new GLTFLoader();
+gltfLoader.setDRACOLoader(draco);
+
+gltfLoader.load('/assets/hero.glb', (gltf) => {
+  const root = gltf.scene;
+  root.traverse((node) => {
+    if ('castShadow' in node) {
+      node.castShadow = true;
+      node.receiveShadow = true;
+    }
+  });
+  scene.add(root);
+});
+```
+
+## React Three Fiber
+
+```tsx
+import { useGLTF } from '@react-three/drei';
+
+function HeroModel() {
+  const gltf = useGLTF('/assets/hero.glb');
+  return <primitive object={gltf.scene} />;
+}
+```
+
+## Notes
+
+- Default shipping format is GLB or glTF 2.0.
+- Keep optimization upstream in the asset pipeline; loader code should stay boring.

.codex/plugins/game-studio/references/rapier-integration-starter.md

@@ -5,12 +5,14 @@ Use this as the smallest canonical pattern for adding physics without letting it
 ## Vanilla Three.js
 
 ```ts
-import RAPIER from "@dimforge/rapier3d-compat";
+import RAPIER from '@dimforge/rapier3d-compat';
 
 await RAPIER.init();
 
 const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });
-const body = world.createRigidBody(RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 2, 0));
+const body = world.createRigidBody(
+  RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 2, 0),
+);
 world.createCollider(RAPIER.ColliderDesc.cuboid(0.5, 0.5, 0.5), body);
 
 renderer.setAnimationLoop(() => {
@@ -24,7 +26,7 @@ renderer.setAnimationLoop(() => {
 ## React Three Fiber
 
 ```tsx
-import { Physics, RigidBody } from "@react-three/rapier";
+import { Physics, RigidBody } from '@react-three/rapier';
 
 <Physics gravity={[0, -9.81, 0]}>
   <RigidBody colliders="cuboid">

.codex/plugins/game-studio/references/react-three-fiber-starter.md

@@ -12,7 +12,7 @@ src/
 ## `src/App.tsx`
 
 ```tsx
-import { Canvas } from "@react-three/fiber";
+import { Canvas } from '@react-three/fiber';
 
 function Spinner() {
   return (
@@ -27,7 +27,7 @@ export default function App() {
   return (
     <div className="app-shell">
       <Canvas camera={{ position: [0, 1.5, 4], fov: 60 }}>
-        <color attach="background" args={["#101418"]} />
+        <color attach="background" args={['#101418']} />
         <ambientLight intensity={0.7} />
         <directionalLight position={[4, 6, 3]} intensity={1.2} />
         <Spinner />

.codex/plugins/game-studio/references/threejs-vanilla-starter.md

@@ -12,12 +12,17 @@ src/
 ## `src/main.ts`
 
 ```ts
-import * as THREE from "three";
+import * as THREE from 'three';
 
 const scene = new THREE.Scene();
-scene.background = new THREE.Color("#101418");
+scene.background = new THREE.Color('#101418');
 
-const camera = new THREE.PerspectiveCamera(60, window.innerWidth / window.innerHeight, 0.1, 200);
+const camera = new THREE.PerspectiveCamera(
+  60,
+  window.innerWidth / window.innerHeight,
+  0.1,
+  200,
+);
 camera.position.set(0, 1.5, 4);
 
 const renderer = new THREE.WebGLRenderer({ antialias: true });
@@ -32,11 +37,11 @@ scene.add(light);
 
 const mesh = new THREE.Mesh(
   new THREE.BoxGeometry(1, 1, 1),
-  new THREE.MeshStandardMaterial({ color: "#3dd9b8" }),
+  new THREE.MeshStandardMaterial({ color: '#3dd9b8' }),
 );
 scene.add(mesh);
 
-window.addEventListener("resize", () => {
+window.addEventListener('resize', () => {
   camera.aspect = window.innerWidth / window.innerHeight;
   camera.updateProjectionMatrix();
   renderer.setSize(window.innerWidth, window.innerHeight);