Merge pull request '修复 AGC Direct 写通道项目锁零等待与持锁方不可诊断' (#320) from fix/issue-318-direct-write-lock-wait into master

Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/320

.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/plugins/game-studio/.codex-plugin/plugin.json

@@ -28,16 +28,11 @@
     "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"
-    ],
+    "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"
-    ],
+    "defaultPrompt": ["Design a browser game and plan the core loop"],
     "brandColor": "#0F766E",
     "composerIcon": "./assets/game-studio.svg",
     "logo": "./assets/app-icon.png",

.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

@@ -1,6 +1,7 @@
 name: game-studio
 version: 0.1.0
-description: Design, prototype, and ship browser games with guided 2D and 3D workflows,
+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

@@ -5,19 +5,19 @@ 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";
+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/");
+draco.setDecoderPath('/draco/');
 
 const gltfLoader = new GLTFLoader();
 gltfLoader.setDRACOLoader(draco);
 
-gltfLoader.load("/assets/hero.glb", (gltf) => {
+gltfLoader.load('/assets/hero.glb', (gltf) => {
   const root = gltf.scene;
   root.traverse((node) => {
-    if ("castShadow" in node) {
+    if ('castShadow' in node) {
       node.castShadow = true;
       node.receiveShadow = true;
     }
@@ -29,10 +29,10 @@ gltfLoader.load("/assets/hero.glb", (gltf) => {
 ## React Three Fiber
 
 ```tsx
-import { useGLTF } from "@react-three/drei";
+import { useGLTF } from '@react-three/drei';
 
 function HeroModel() {
-  const gltf = useGLTF("/assets/hero.glb");
+  const gltf = useGLTF('/assets/hero.glb');
   return <primitive object={gltf.scene} />;
 }
 ```

.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);