移除 UI 文档引用新增测试

删除 Direct Codex UI 文档 fixture 与专门测试用例保留生产引用逻辑和现有业务测试
统一引用 UI 文档资产类型常量
2026-09-14 21:41:53 +08:00 · 2026-09-14 21:36:43 +08:00 · 2026-09-14 21:12:03 +08:00 · 2026-09-14 21:04:08 +08:00 · 2026-09-14 20:45:04 +08:00 · 2026-09-14 20:44:49 +08:00
19 changed files with 307 additions and 81 deletions
@@ -1,4 +1,8 @@
 use super::*;
+use crate::ui_editor::persistence::{
+    generate_ui_design_code_at, GenerateUiDesignCodeInput, UI_DESIGN_DOC_ASSET_KIND,
+    UI_DESIGN_DOC_MEDIA_TYPE,
+};

 pub(crate) const MAX_DIRECT_CODEX_REFERENCES: usize = 32;
 const MAX_DIRECT_CODEX_REFERENCE_ID_CHARS: usize = 200;
@@ -133,7 +137,35 @@ fn validate_resource_reference_id(value: &str) -> Result<String, String> {
    Ok(resource_id.to_string())
 }

+/// Render the prompt context for a UI design asset.
+///
+/// Keep this separate from the generic resource renderer so UI-specific
+/// instructions/metadata can evolve without changing other asset kinds.
+fn render_ui_design_reference_line(
+    root: &Path,
+    manifest: &GameCreationAppManifest,
+    asset: &GameCreationAppAssetManifestEntry,
+    resource_id: &str,
+    label: &str,
+    local_path: &str,
+    source: &str,
+) -> String {
+    let context = match generate_ui_design_code_at(GenerateUiDesignCodeInput {
+        project_path: root.to_string_lossy().into_owned(),
+        expected_project_id: manifest.project_id.clone(),
+        asset_id: resource_id.to_string(),
+    }) {
+        Ok(result) => format!("请先阅读生成的带有文档的代码片段: {}", result.relative_path),
+        Err(error) => format!("生成代码遇到错误{error}"),
+    };
+    format!(
+        "- 素材 ID：{resource_id}；名称：{label}；类型：{}；媒体类型：{}；项目路径：{local_path}；来源：{source}",
+        asset.kind, asset.media_type
+    ) + "\n" + &context
+}
+
 fn render_resource_reference_line(
+    root: &Path,
    manifest: &GameCreationAppManifest,
    reference: &DirectCodexResourceReference,
 ) -> Result<String, String> {
@@ -149,6 +181,19 @@ fn render_resource_reference_line(
        .unwrap_or_else(|| asset_display_label(asset));
    let source = sanitize_reference_source(reference.source.as_deref())
        .unwrap_or_else(|| "unknown".to_string());
+    let is_ui_design =
+        asset.kind == UI_DESIGN_DOC_ASSET_KIND && asset.media_type == UI_DESIGN_DOC_MEDIA_TYPE;
+    if is_ui_design {
+        return Ok(render_ui_design_reference_line(
+            root,
+            manifest,
+            asset,
+            &resource_id,
+            &label,
+            &local_path,
+            &source,
+        ));
+    }
    Ok(format!(
        "- 素材 ID：{resource_id}；名称：{label}；类型：{}；媒体类型：{}；项目路径：{local_path}；来源：{source}",
        asset.kind, asset.media_type
@@ -234,7 +279,7 @@ pub(crate) fn render_direct_codex_references_section(
    for reference in references {
        lines.push(match reference {
            DirectCodexTurnReference::Resource(reference) => {
-                render_resource_reference_line(&manifest, reference)?
+                render_resource_reference_line(root, &manifest, reference)?
            }
            DirectCodexTurnReference::RuntimeRegion(reference) => {
                render_runtime_region_reference_line(&manifest, reference)?
@@ -2144,7 +2144,10 @@ pub(crate) fn create_ui_design_resource(
    let next_index = manifest
        .assets
        .iter()
-        .filter(|asset| asset.kind == "UI")
+        .filter(|asset| {
+            asset.kind == crate::ui_editor::persistence::UI_DESIGN_DOC_ASSET_KIND
+                && asset.media_type == crate::ui_editor::persistence::UI_DESIGN_DOC_MEDIA_TYPE
+        })
        .count()
        + 1;
    let resource_name = format!("UI 设计 {next_index}");
@@ -2178,8 +2181,8 @@ pub(crate) fn create_ui_design_resource(
    let asset = match register_local_asset_at(
        root,
        &relative_path,
-        "UI",
-        "application/json",
+        crate::ui_editor::persistence::UI_DESIGN_DOC_ASSET_KIND,
+        crate::ui_editor::persistence::UI_DESIGN_DOC_MEDIA_TYPE,
        "generated",
        GameCreationAppAssetSource {
            kind: GameCreationAppAssetSourceKind::Generated,
@@ -2031,8 +2031,8 @@ fn register_local_asset_keeps_explicit_category_when_kind_is_unchanged() {
    let registered = register_local_asset_at(
        &root,
        "ui/UI 设计 1.json",
-        "UI",
-        "application/json",
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        "ui-workflow",
        source(),
    )
@@ -2053,8 +2053,8 @@ fn register_local_asset_keeps_explicit_category_when_kind_is_unchanged() {
    register_local_asset_at(
        &root,
        "ui/UI 设计 1.json",
-        "UI",
-        "application/json",
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        "ui-workflow",
        source(),
    )
@@ -2063,7 +2063,10 @@ fn register_local_asset_keeps_explicit_category_when_kind_is_unchanged() {
    let manifest: Value =
        serde_json::from_str(&fs::read_to_string(root.join(".agent/manifest.json")).unwrap())
            .expect("manifest json");
-    assert_eq!(manifest["assets"][0]["kind"], "UI");
+    assert_eq!(
+        manifest["assets"][0]["kind"],
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND
+    );
    assert_eq!(manifest["assets"][0]["category"], "audio");
    assert_eq!(manifest["assets"][0]["tags"], serde_json::json!(["界面"]));

@@ -2074,7 +2077,7 @@ fn register_local_asset_keeps_explicit_category_when_kind_is_unchanged() {
 ///
 /// 这里的字面量与写入侧逐字一致：UI 设计资产是
 /// `ui_editor/resource_bridge.rs` / `workflow.rs` / `persistence.rs` 的
-/// `register_local_asset_at(root, path, "UI", "application/json", ...)`，
+/// `register_local_asset_at` 使用 UI 文档 kind/media 常量，
 /// 字体是 `commands.rs` 字体上传的 `register_local_asset_entry(root, path, "font", ...)`。
 /// 只要别名表漏掉它们，真机资产就会永远停在「待归类」且读时自愈也救不回来。
 #[test]
@@ -2099,8 +2102,8 @@ fn register_local_asset_derives_category_from_real_write_side_kinds() {
    register_local_asset_at(
        &root,
        "ui/UI 设计 1.json",
-        "UI",
-        "application/json",
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        "ui-workflow",
        source(),
    )
@@ -2133,7 +2136,11 @@ fn register_local_asset_derives_category_from_real_write_side_kinds() {
    assert_eq!(
        categories,
        vec![
-            ("UI".to_string(), "ui-interaction".to_string()),
+            (
+                shared_contracts::game_creation_app::GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND
+                    .to_string(),
+                "ui-interaction".to_string(),
+            ),
            ("font".to_string(), "document".to_string()),
        ]
    );
@@ -19,6 +19,10 @@ use std::time::{SystemTime, UNIX_EPOCH};
 use typed_floats::tf32::StrictlyPositiveFinite;

 const UI_DESIGN_STATE_SCHEMA_VERSION: &str = "game-creator-ui-design-state.v1";
+pub(crate) use shared_contracts::game_creation_app::{
+    GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND as UI_DESIGN_DOC_ASSET_KIND,
+    GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE as UI_DESIGN_DOC_MEDIA_TYPE,
+};
 const UI_DESIGN_STATE_MAX_BYTES: usize = 2 * 1024 * 1024;
 const UI_DESIGN_CODE_MAX_BYTES: usize = UI_DESIGN_STATE_MAX_BYTES * 8;
 const UI_DESIGN_STATE_MAX_IMAGES: usize = 4;
@@ -321,7 +325,7 @@ fn ui_design_asset(
        .into_iter()
        .find(|asset| asset.id == asset_id)
        .ok_or_else(|| "UI 设计资源不存在".to_string())?;
-    if asset.kind != "UI" || asset.media_type != "application/json" {
+    if asset.kind != UI_DESIGN_DOC_ASSET_KIND || asset.media_type != UI_DESIGN_DOC_MEDIA_TYPE {
        return Err("目标资源不是 UI 设计 JSON 资产".to_string());
    }
    normalize_relative_path(&asset.local_path)?;
@@ -815,8 +819,8 @@ mod tests {
        let asset = register_local_asset_at(
            directory.path(),
            relative_path,
-            "UI",
-            "application/json",
+            UI_DESIGN_DOC_ASSET_KIND,
+            UI_DESIGN_DOC_MEDIA_TYPE,
            "test",
            GameCreationAppAssetSource {
                kind: GameCreationAppAssetSourceKind::Generated,
@@ -1,4 +1,7 @@
-use crate::ui_editor::persistence::initialize_ui_design_state_with_source_image_at;
+use crate::ui_editor::persistence::{
+    initialize_ui_design_state_with_source_image_at, UI_DESIGN_DOC_ASSET_KIND,
+    UI_DESIGN_DOC_MEDIA_TYPE,
+};
 use crate::{
    acquire_project_write_lock, advance_agent_runtime_project_revision_locked,
    enforce_project_permission_policy, read_existing_manifest_for_project,
@@ -89,8 +92,8 @@ pub(crate) fn ensure_ui_design_resource_for_prototype(
    }

    if let Some(asset) = manifest.assets.iter().find(|asset| {
-        asset.kind == "UI"
-            && asset.media_type == "application/json"
+        asset.kind == UI_DESIGN_DOC_ASSET_KIND
+            && asset.media_type == UI_DESIGN_DOC_MEDIA_TYPE
            && asset.source.reference_resource_ids.iter().any(|reference| {
                source_reference_ids
                    .iter()
@@ -118,8 +121,8 @@ pub(crate) fn ensure_ui_design_resource_for_prototype(
    let asset = match register_local_asset_at(
        root,
        &relative_path,
-        "UI",
-        "application/json",
+        UI_DESIGN_DOC_ASSET_KIND,
+        UI_DESIGN_DOC_MEDIA_TYPE,
        "generated",
        GameCreationAppAssetSource {
            kind: GameCreationAppAssetSourceKind::Generated,
@@ -193,7 +196,9 @@ fn next_ui_design_path(
    let mut index = manifest
        .assets
        .iter()
-        .filter(|asset| asset.kind == "UI")
+        .filter(|asset| {
+            asset.kind == UI_DESIGN_DOC_ASSET_KIND && asset.media_type == UI_DESIGN_DOC_MEDIA_TYPE
+        })
        .count()
        + 1;
    loop {
@@ -281,11 +286,9 @@ mod tests {
        };
        let first = ensure_ui_design_resource_for_prototype(input.clone()).expect("bridge");
        assert!(first.created);
-        assert_eq!(first.asset.kind, "UI");
+        assert_eq!(first.asset.kind, UI_DESIGN_DOC_ASSET_KIND);
        // 写侧 → 分类的端到端断言：这条路径走的是与
-        // `workflow.rs` / `persistence.rs` 完全相同的 `register_local_asset_at(..., "UI", ...)`。
-        // 别名表漏掉大写 `UI` 时，这里会落 unclassified（真机 8 条 UI 资产的表现），
-        // 且派生值本身就是 unclassified，读时自愈也救不回来。
+        // 写侧与 persistence/workflow 共用 UI 文档 kind/media 常量。
        assert_eq!(
            first.asset.category,
            GameCreationAppAssetCategory::UiInteraction
@@ -322,7 +325,10 @@ mod tests {
                .manifest
                .assets
                .iter()
-                .filter(|asset| asset.kind == "UI")
+                .filter(|asset| {
+                    asset.kind == UI_DESIGN_DOC_ASSET_KIND
+                        && asset.media_type == UI_DESIGN_DOC_MEDIA_TYPE
+                })
                .count(),
            1
        );
@@ -7,6 +7,7 @@ use crate::ui_editor::layout::node::{Node, StageStatus};
 use crate::ui_editor::persistence::{
    initialize_ui_design_state_at, load_ui_design_state_at, save_ui_design_state_at,
    LoadUiDesignStateInput, SaveUiDesignStateInput, SaveUiDesignStateResult,
+    UI_DESIGN_DOC_ASSET_KIND, UI_DESIGN_DOC_MEDIA_TYPE,
 };
 use crate::ui_editor::resource::font::FontAsset;
 use crate::ui_editor::resource::sprite::{SpriteAsset, SpriteAssetMetadata, SpriteBorder};
@@ -683,8 +684,8 @@ fn find_page_ui_resource(
    let Some(asset) = matches.into_iter().next() else {
        return Ok(None);
    };
-    if asset.kind != "UI"
-        || asset.media_type != "application/json"
+    if asset.kind != UI_DESIGN_DOC_ASSET_KIND
+        || asset.media_type != UI_DESIGN_DOC_MEDIA_TYPE
        || asset.local_path != workflow_relative_path(source, &page.page_id)
    {
        return Err(format!("页面 {} 的 UI workflow 资源身份冲突", page.page_id));
@@ -748,8 +749,8 @@ fn ensure_page_ui_resource(
        let registered = register_local_asset_at(
            root,
            &relative_path,
-            "UI",
-            "application/json",
+            UI_DESIGN_DOC_ASSET_KIND,
+            UI_DESIGN_DOC_MEDIA_TYPE,
            "ui-workflow",
            GameCreationAppAssetSource {
                kind: GameCreationAppAssetSourceKind::Generated,
@@ -1179,7 +1180,7 @@ fn update_page_manifest_stage(root: &Path, asset_id: &str, stage: &str) -> Resul
            .iter_mut()
            .find(|asset| asset.id == asset_id)
            .ok_or_else(|| format!("UI workflow 资源 {} 未登记", asset_id))?;
-        if asset.kind != "UI" || asset.media_type != "application/json" {
+        if asset.kind != UI_DESIGN_DOC_ASSET_KIND || asset.media_type != UI_DESIGN_DOC_MEDIA_TYPE {
            return Err(format!("UI workflow 资源 {} 类型不匹配", asset_id));
        }
        let next_kind = format!("ui-workflow.{stage}");
@@ -53,6 +53,7 @@ import { createPortal, flushSync } from 'react-dom';
 import { PlatformResourceFilterBar } from '../../../../../packages/shared/src/components/PlatformResourceFilterBar';
 import { PlatformSegmentedTabs } from '../../../../../packages/shared/src/components/PlatformSegmentedTabs';
 import {
+  GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
  type GameCreationAppAssetManifestEntry,
  gameCreationAppAssetTags,
  type GameIterationVersion,
@@ -1253,7 +1254,10 @@ function ResourcePickerThumbnail({
  if (mediaType.startsWith('image/')) {
    return <Loader2 size={18} className="animate-spin" aria-hidden="true" />;
  }
-  if (kind === 'ui' || mediaType === 'application/json') {
+  if (
+    kind === 'ui' ||
+    mediaType === GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE
+  ) {
    return <FileText size={18} aria-hidden="true" />;
  }
  return <ImageIcon size={18} aria-hidden="true" />;
@@ -2,6 +2,10 @@ import type {
  GameCreationAppAssetManifestEntry,
  GameCreationAppManifest,
 } from '../../../../../packages/shared/src/contracts/gameCreationApp';
+import {
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+  GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
+} from '../../../../../packages/shared/src/contracts/gameCreationApp';

 export type UiDesignResourceBridgeResult = {
  asset: GameCreationAppAssetManifestEntry;
@@ -48,8 +52,8 @@ export function findLinkedUiDesignResource(
    manifest.assets
      .filter(
        (asset) =>
-          asset.kind === 'UI' &&
-          asset.mediaType === 'application/json' &&
+          asset.kind === GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND &&
+          asset.mediaType === GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE &&
          asset.source.referenceResourceIds?.some((reference) =>
            referenceIds.has(reference),
          ),
@@ -73,6 +73,10 @@ import type {
  GameIterationVersion,
  ProjectResourceCanvasLayoutMode,
 } from '../../../../../packages/shared/src/contracts/gameCreationApp';
+import {
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+  GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
+} from '../../../../../packages/shared/src/contracts/gameCreationApp';
 import { ImageCanvasCharacterAnimationPanelView } from '../../../../../src/components/image-editor/ImageCanvasCharacterAnimationPanelView';
 import type {
  CanvasLayer,
@@ -5040,8 +5044,8 @@ export default function ProjectDevelopmentView({
        if (canvasOpenEpochRef.current !== openEpoch) return;
        if (
          result.manifest.projectId !== manifest.projectId ||
-          result.asset.kind !== 'UI' ||
-          result.asset.mediaType !== 'application/json'
+          result.asset.kind !== GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND ||
+          result.asset.mediaType !== GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE
        ) {
          throw new Error('UI 编辑资源结果与当前项目不一致');
        }
@@ -5112,8 +5116,8 @@ export default function ProjectDevelopmentView({
    if (uiEditorRoute) return;
    const completed = manifest.assets.find(
      (asset) =>
-        asset.kind === 'UI' &&
-        asset.mediaType === 'application/json' &&
+        asset.kind === GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND &&
+        asset.mediaType === GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE &&
        asset.source.generationKind === 'ui-workflow.completed',
    );
    if (
@@ -6812,7 +6816,7 @@ export default function ProjectDevelopmentView({
    [manifest, selectedResource],
  );
  const selectedResourceOpensUiEditor =
-    selectedResource?.subtype === 'UI' ||
+    selectedResource?.subtype === GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND ||
    selectedResource?.subtype === 'ui-prototype';

  const selectedToolbarStyle = selectedResourceLayer
@@ -4,6 +4,10 @@ import type {
  ProjectResourceCanvasLayout,
  ProjectResourceCanvasPosition,
 } from '../../../../packages/shared/src/contracts/gameCreationApp';
+import {
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+  GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
+} from '../../../../packages/shared/src/contracts/gameCreationApp';
 import { RESOURCE_REFERENCE_INSERT_EVENT } from '../../src/features/project-workspace/resourceReferences';
 import { RESOURCE_BOOK_OVERVIEW_STACK_LIMIT } from '../../src/view/project-development/resourceBookLayout';
 import {
@@ -5908,8 +5912,8 @@ export function registerProjectWorkbenchFoundationTests() {
    manifest.assets = [
      {
        id: 'ui-design-resource',
-        kind: 'UI',
-        mediaType: 'application/json',
+        kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        localPath: 'assets/ui-design.json',
        source: { kind: 'generated' },
      },
@@ -10,6 +10,7 @@ import {
  canonicalGameCreationAppAssetKind,
  GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND,
  GAME_CREATION_APP_CANONICAL_ASSET_KINDS,
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
  type GameCreationAppAssetCategory,
  gameCreationAppAssetCategory,
  gameCreationAppAssetCategoryForKind,
@@ -219,8 +220,13 @@ describe('真机出现的 kind 归类口径', () => {
      canonical: 'icon',
      category: 'ui-interaction',
    },
-    // 现役写入侧的大写字面量与字体 kind，两者都必须落进明确栏目。
+    // UI 文档与字体 kind，两者都必须落进明确栏目。
    { kind: 'UI', canonical: 'ui-design', category: 'ui-interaction' },
+    {
+      kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      canonical: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      category: 'ui-interaction',
+    },
    { kind: 'font', canonical: 'document', category: 'document' },
    // `Object.prototype` 上的键不是别名：TS 侧必须用 `Object.hasOwn` 挡住对象字面量的
    // 原型命中，Rust 侧 match 字面量本来就落 `image`；这类极端输入两侧也必须一致。
@@ -277,13 +283,15 @@ describe('写侧 kind 字面量 → 分类的端到端口径', () => {
    return kinds;
  }

-  test('UI 设计写点仍直接写 `"UI"`，且它落 UI 交互而不是待归类', () => {
-    // 8 条真机 UI 资产是 `kind:"UI"` + `mediaType:"application/json"`：
-    // 该 kind 不在别名表里时派生结果也是 unclassified，读时自愈同样救不回来。
+  test('UI 设计写点统一使用文档资产常量，且它落 UI 交互而不是待归类', () => {
    for (const file of UI_EDITOR_WRITE_SITES) {
-      expect(registeredKindLiterals(file)).toContain('UI');
+      expect(readFileSync(file, 'utf8')).toContain('UI_DESIGN_DOC_ASSET_KIND');
    }
-    expect(gameCreationAppAssetCategoryForKind('UI')).toBe('ui-interaction');
+    expect(
+      gameCreationAppAssetCategoryForKind(
+        GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      ),
+    ).toBe('ui-interaction');
  });

  test('UI 编辑器写点写出的每个 kind 都落明确栏目', () => {
@@ -4,6 +4,10 @@ import type {
  GameCreationAppAssetManifestEntry,
  GameCreationAppManifest,
 } from '../../../packages/shared/src/contracts/gameCreationApp';
+import {
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+  GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
+} from '../../../packages/shared/src/contracts/gameCreationApp';
 import {
  ensureUiDesignResourceForPrototype,
  findLinkedUiDesignResource,
@@ -37,8 +41,8 @@ describe('ui design resource bridge', () => {
    const manifest = manifestWithPrototype();
    manifest.assets.push({
      id: 'unrelated-ui',
-      kind: 'UI',
-      mediaType: 'application/json',
+      kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
      localPath: 'ui/unrelated.json',
      source: { kind: 'generated', referenceResourceIds: ['other'] },
      imageSequenceFrames: null,
@@ -47,8 +51,8 @@ describe('ui design resource bridge', () => {
    expect(findLinkedUiDesignResource(manifest, 'prototype-asset')).toBeNull();
    manifest.assets.push({
      id: 'linked-ui',
-      kind: 'UI',
-      mediaType: 'application/json',
+      kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
      localPath: 'ui/linked.json',
      source: { kind: 'generated', referenceResourceIds: ['prototype-asset'] },
      imageSequenceFrames: null,
@@ -64,8 +68,8 @@ describe('ui design resource bridge', () => {
    manifest.assets[0]!.source.resourceId = 'canvas-resource-1';
    manifest.assets.push({
      id: 'workflow-ui',
-      kind: 'UI',
-      mediaType: 'application/json',
+      kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
      localPath: 'ui/workflow.json',
      source: {
        kind: 'generated',
@@ -85,8 +89,8 @@ describe('ui design resource bridge', () => {
    manifest.assets.push(
      {
        id: 'bridge-ui',
-        kind: 'UI',
-        mediaType: 'application/json',
+        kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        localPath: 'ui/UI 设计 1.json',
        source: {
          kind: 'generated',
@@ -97,8 +101,8 @@ describe('ui design resource bridge', () => {
      },
      {
        id: 'completed-ui',
-        kind: 'UI',
-        mediaType: 'application/json',
+        kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        localPath: 'ui/ui-workflow-page.json',
        source: {
          kind: 'generated',
@@ -118,8 +122,8 @@ describe('ui design resource bridge', () => {
    const manifest = manifestWithPrototype();
    const linked = {
      id: 'linked-ui',
-      kind: 'UI',
-      mediaType: 'application/json',
+      kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+      mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
      localPath: 'ui/linked.json',
      source: {
        kind: 'generated' as const,
@@ -146,8 +150,8 @@ describe('ui design resource bridge', () => {
    const result = {
      asset: {
        id: 'new-ui',
-        kind: 'UI',
-        mediaType: 'application/json',
+        kind: GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        mediaType: GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE,
        localPath: 'ui/UI 设计 1.json',
        source: {
          kind: 'generated' as const,
@@ -0,0 +1,51 @@
+# 【实施计划】UI设计文档引用代码上下文
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1 |
+| Status | ready |
+| Owner | Codex |
+| Milestone | `docs/project-memory/plans/【里程碑】UI设计文档引用代码上下文-2026-09-14.md` |
+
+## 修改边界
+
+允许修改：
+
+- UI Editor persistence/resource bridge/workflow/command 中的 UI JSON 文档 kind 常量与校验。
+- `packages/shared` 的 canonical kind 与 Rust 对应映射。
+- `agent/direct_codex_references.rs` 的 UI 引用 prompt 生成。
+- 相关 Rust、TypeScript 测试和当前 UI workflow/AGC 文档。
+- `decision-log.md` 的长期决策记录。
+
+明确不修改：
+
+- `ui-prototype` 图片生成和图片 workflow 语义。
+- UI State schema、`render_ui_design_state_js` 输出格式和 `ui/generated-*.js` 路径规则。
+- SpacetimeDB schema、External v1 OpenAPI、非 Direct Codex Supervisor 引用行为。
+- 用户已有 `.env` 未提交修改。
+
+## 实现顺序
+
+1. 更新 UI workflow 主规范与项目决策，明确 `ui-design-doc` 与 `ui-prototype` 的身份边界。
+2. 在 persistence 提取并导出 UI 文档 kind/media 常量，替换 Rust UI 文档校验。
+3. 同步所有 UI JSON 资源生产者、workflow 校验、命令筛选、shared contract 与前端 bridge。
+4. 在 Direct Codex 引用渲染中调用 `generate_ui_design_code_at`；成功追加生成文件相对路径，失败追加原始错误并继续发送。
+5. 补充旧 kind、图片、成功、文档错误、多引用和 renderer 输出的测试。
+6. 执行定向验证，复核 diff 中无 fallback、迁移或无关 `.env` 修改。
+
+## 验证命令
+
+1. `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check`
+2. `cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml ui_editor::persistence`
+3. `cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml direct_codex_references`
+4. 相关 shared contract Vitest 测试与前端类型检查
+5. `npm run check:doc-index`
+6. `npm run check:encoding`
+7. `git diff --check`
+
+## 风险与回滚点
+
+- `ui-prototype` 与 UI JSON 文档共用部分分类展示逻辑，需确保分类映射不会让图片进入文档分支。
+- `generate_ui_design_code_at` 会持有项目写锁；多引用必须顺序调用，不能并行写同一项目。
+- 生成失败继续发送是已确认语义；测试必须证明错误文本进入 prompt 而不是被转成聊天失败。
+- 若发现生产者仍写入旧 `UI`，按开发阶段合同直接修生产者和 fixture，不增加运行时兼容分支。
@@ -0,0 +1,49 @@
+# 【里程碑】UI设计文档引用代码上下文
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1 |
+| Status | in-progress |
+| Date | 2026-09-14 |
+| Parent Spec | `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md` |
+
+## 目标
+
+将可编辑 UI JSON 文档统一识别为 `ui-design-doc`，并在 Direct Codex 聊天引用该文档时复用 UI Editor 现有代码导出流程，为 LLM 提供生成的、带文档注释的 JS 代码路径或原始生成错误。
+
+## 范围
+
+- UI JSON 文档资产身份固定为 `kind=ui-design-doc`、`mediaType=application/json`。
+- 复用 `ui_editor::persistence::generate_ui_design_code_at` 读取并校验文档、调用 `render_ui_design_state_js`、写入 `ui/generated-*.js`。
+- Direct Codex 引用文本保留稳定 manifest 元数据，并追加代码路径或 `生成代码遇到错误{error}`。
+- 同步 Rust/TypeScript 的 UI 文档生产者、消费者、分类映射和测试。
+- `ui-prototype` 图片继续作为独立源图片类型。
+
+## 不在范围内
+
+- 不接受旧 `UI`、`ui`、`ui-design` 作为 UI 文档类型。
+- 不增加兼容 fallback、数据迁移或旧数据转换逻辑。
+- 不把 `ui-prototype` 图片当作 UI 文档，不从图片生成替代 JSON 文档代码。
+- 不改变 UI State schema、renderer 输出格式、项目 revision 或 manifest 阶段。
+- 不改变旧 Supervisor 非 Direct Codex 引用链路。
+
+## 依赖与前置条件
+
+- `generate_ui_design_code_at` 已存在并返回 `relative_path`。
+- `render_ui_design_state_js` 已生成包含文档注释的 JS 模块。
+- Direct Codex 结构化引用已传递 `resourceId`，manifest 是资源身份权威。
+
+## 验收标准
+
+- [ ] UI 编辑器 JSON 资源创建、加载、保存、workflow 校验和引用分支均只接受 `ui-design-doc + application/json`。
+- [ ] Direct Codex 成功引用 UI 文档时，prompt 追加 `请先阅读生成的带有文档的代码片段: {relative_path}`。
+- [ ] UI 文档生成失败时，prompt 保留原 metadata 并追加 `生成代码遇到错误{error}`，不走图片或其它文件 fallback。
+- [ ] `ui-prototype` 图片引用不触发 UI 文档代码生成。
+- [ ] 多个引用按顺序处理，单个 UI 文档失败不丢失其它引用。
+- [ ] Rust/TypeScript kind 映射一致，旧 kind 不被隐式迁移。
+
+## 证据要求
+
+- 自动化：persistence、direct_codex_references、shared contract 定向测试；`cargo fmt --check`、`npm run check:encoding`、`git diff --check`。
+- 运行时：不要求真实 Provider；测试验证生成文件路径、renderer 文档注释和 prompt 注入结果。
+- 边界：旧 kind、图片 kind、损坏 JSON、renderer 错误、多引用和路径来源均有测试。
@@ -8677,3 +8677,9 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 - 决策：复用判据收窄为**同一条写调用链（同一线程）重入**——按锁路径登记真实持锁线程，只有当前线程就是持锁线程时才返回 advisory guard；本进程其它线程的争用继续走有界等待与终态占用。自主游戏构建流水线的并行专家动作豁免保持不变；跨进程占用、残留回收、权限分类、等待预算和错误文案不变。
 - 边界：锁定这些不变量的既有用例（`project_tools` / `command_runtime` / `parallel_actions` / `runtime_state` / `response_stream` / `direct_tool_bridge` / `ui_editor::persistence`）不得为了让锁语义通过而改写；用「同线程自持锁」模拟「另一个写者」的两条用例改为**在另一条线程持锁**，断言语义不变。同进程跨线程重入（持锁链在 `await` / `spawn_blocking` 后于其它线程再取锁）仍会等满预算，出现现场时按 2026-08-27 的既有处置改用 `*_locked` 入口，不放宽判据。
 - 关联文档：[项目客户端占用锁收敛里程碑](../plans/【里程碑】项目客户端占用锁收敛-2026-09-14.md)、[踩坑记录](pitfalls.md)。
+
+## 2026-09-14 Direct Codex 引用 UI 设计文档生成代码上下文
+
+- 决策：UI Editor JSON 文档资产唯一使用 `kind:"ui-design-doc"` 且 `mediaType:"application/json"`；`ui-prototype` 保持图片语义，旧 `UI` / `ui` / `ui-design` 不作为该文档分支输入，不做 fallback 或迁移。
+- 决策：Direct Codex 结构化资源引用命中该 kind 时，顺序调用 UI Editor persistence 的 `generate_ui_design_code_at`，生成 `ui/generated-*.js`，并把 `请先阅读生成的带有文档的代码片段: {relative_path}` 追加到当前 prompt。生成失败不阻断本轮引用，追加原始 `生成代码遇到错误{error}`，其它引用继续处理。
+- 原因：复用 `html_renderer/mod.rs` 统一产物，确保 LLM 读取的代码包含 UI 节点元数据和文档注释；严格 kind + mediaType 判定避免图片资产误走代码生成。
@@ -1221,7 +1221,7 @@ game-project/

 ## 2026-08-17 UI Editor 项目资源 State 持久化

- UI 编辑器复用现有 manifest `kind: "UI"`、`mediaType: "application/json"` 资源，不增加平行 asset kind。资源文件固定为严格 `game-creator-ui-design-state.v1` JSON envelope：`projectId`、`assetId`、每资源 `revision` 和 Rust 唯一源 `State`；旧空对象、未知字段、身份错配、超限、无效内部引用和不安全相对路径均失败关闭。内部引用校验同时覆盖 `Image.target_graphic -> sprite_assets` 与 `Text.font -> font_assets`，可选引用非空时必须命中同一 State 内已登记资源。
+- UI 编辑器使用唯一的 manifest `kind: "ui-design-doc"`、`mediaType: "application/json"` 资源，不接受旧 `UI` / `ui` / `ui-design`，也不增加 fallback 或迁移。资源文件固定为严格 `game-creator-ui-design-state.v1` JSON envelope：`projectId`、`assetId`、每资源 `revision` 和 Rust 唯一源 `State`；旧空对象、未知字段、身份错配、超限、无效内部引用和不安全相对路径均失败关闭。内部引用校验同时覆盖 `Image.target_graphic -> sprite_assets` 与 `Text.font -> font_assets`，可选引用非空时必须命中同一 State 内已登记资源。
 - Tauri 专用 load/save command 只接受项目路径、期望项目 ID、manifest asset ID 和（保存时）资源 revision；Rust 按 manifest 解析受控本地路径并在项目写锁内做 CAS。相同 `State` 返回 unchanged 且不推进 project revision；不同内容安装并回读一致后才推进 revision，后续推进失败返回 `reconciliation-required`，不伪装为完整保存。
 - UI 编辑器代码导出仅写入用户项目目录下的 `ui/generated-*.js` 派生文件，绝不推进项目 revision、UI State revision、manifest 阶段或 Runtime 验证门；写入失败只返回生成错误，不得把生成文件写入冒充为项目 mutation。
 - UI State 原子安装保留最近一个可解析、canonical 的 `.previous` 恢复候选，作为最佳努力恢复来源；写入主文件前不把完整 State 语义校验重复执行一遍。主文件损坏时，恢复候选仍必须通过同一严格 schema、project/asset identity、revision、引用和 State 校验后才能安装；恢复安装与保存共用项目写锁，并在持锁后重新读取主文件，已有并发保存的有效新版本时直接返回而不安装旧副本。任一候选均不可信则停在加载错误，前端禁编辑和保存。新建 UI 资源先登记并安装合法 envelope，任一步失败补偿 manifest/文件，避免把空 JSON 留给资源卡。
@@ -2,10 +2,12 @@

 ## 目标

-`ui-prototype` 与 `UI` 是两种不同资源，不能通过修改投影 `subtype` 混为一种资源：
+`ui-prototype` 与 `ui-design-doc` 是两种不同资源，不能通过修改投影 `subtype` 混为一种资源：

 - `ui-prototype`：Agent 生成并登记到画布的界面设计图片。
- `UI`：UI 编辑器使用的 JSON 资源，保存界面图、UI 树、组件绑定和 State revision。
+- `ui-design-doc`：UI 编辑器使用的 `application/json` 资源，保存界面图、UI 树、组件绑定和 State revision。
+
+UI 设计文档资产必须严格满足 `kind=ui-design-doc` 与 `mediaType=application/json`；旧 `UI`、`ui`、`ui-design` 不作为兼容输入，也不提供迁移或图片 fallback。

 自然语言生成链路必须把前者桥接为后者，并持续让 manifest 成为客户端资源投影的权威来源。游戏场景的页面清单由 Runtime 自动发现，Agent 不得凭空猜测页面。

@@ -35,7 +37,7 @@ Agent 通过白名单工具 `ui.workflow.run` 发起工作流。项目路径由

 处理规则：

-1. `prepare` 为每个页面创建确定性的 `kind=UI` JSON 资源，引用源 `ui-prototype` 和页面设计图，载入设计图尺寸与相对路径到 `ui_design_images`，并保存 State。
+1. `prepare` 为每个页面创建确定性的 `kind=ui-design-doc` JSON 资源，引用源 `ui-prototype` 和页面设计图，载入设计图尺寸与相对路径到 `ui_design_images`，并保存 State。
 2. `recognize` 依次执行 Provider 多模态结构识别、现有多树合并器、最多每批 5 项的图片/图标组件绑定，并把已登记字体的安全元数据提供给绑定器；阶段分别持久化为 `structure-ready`、`merge-ready`、`binding-ready`，重复执行从最近真实阶段恢复。
 3. `status` 只回读 State、页面阶段和 blockers，不推进项目 revision。
 4. `finalize` 只接受 `game/` 下的真实 UTF-8 文件，写入与 UI State revision 绑定的应用标记；所有页面通过应用门禁后才返回 `asset-separation` 最终阶段路由。缺少页面、资源、组件或应用标记时拒绝伪造完成。
@@ -61,15 +63,33 @@ UI 编辑器的分离提示会对节点描述和返工备注做长度与控制

 真实 Provider 鉴权失败时，Codex app-server 可能只返回 `codexErrorInfo=other`，而把上游 `401/403` 放在错误正文中。Runtime 必须从受控错误字段识别为 `codex-app-server-error:unauthorized`（公共摘要为 `codex-app-server-unauthorized`），只向公共运行记录暴露错误类别和指纹，不记录 Token 或上游原文。此错误不能伪造为 UI 工作流阶段完成；修复凭据后应从原有 run 的恢复边界重新执行。

+## UI 设计文档代码引用
+
+Direct Codex 聊天引用 `ui-design-doc` 时，复用 `ui_editor::persistence::generate_ui_design_code_at`。该入口只读取被引用的 JSON 文档，调用 `render_ui_design_state_js`，并写入既有 `ui/generated-*.js` 派生文件。
+
+成功时在稳定 manifest 元数据后追加：
+
+```text
+请先阅读生成的带有文档的代码片段: {relative_path}
+```
+
+JSON 文档读取、State 校验或 renderer 失败时，在同一引用后追加原始错误：
+
+```text
+生成代码遇到错误{error}
+```
+
+错误不阻断本轮 Direct Codex prompt，其它引用继续按顺序处理；不从图片或其它文件 fallback，不把生成文件登记为正式 manifest 资产，也不推进项目 revision。
+
 ## 画布跳转与客户端更新

 点击画布中的 `ui-prototype` 时，工作台调用 `ensure_ui_design_resource_for_prototype`：

 - 按 manifest asset id、`source.resourceId`、`source.assetObjectId` 识别已有关联，避免重复创建。
- 没有关联时原子创建 `ui/UI 设计 N.json`，登记 `kind=UI`、`application/json`，并把原型图作为首张页面设计图载入 State。
+- 没有关联时原子创建 `ui/UI 设计 N.json`，登记 `kind=ui-design-doc`、`application/json`，并把原型图作为首张页面设计图载入 State。
 - 成功后通过 `onManifestChange` 更新客户端资源投影，再打开 UI 编辑器；普通桥接从 `reference-analysis` 开始。

-点击已有 `UI` 资源直接打开 UI 编辑器。若 manifest 阶段为 `ui-workflow.completed`，工作台自动打开该资源的 `asset-separation` 阶段（最远步骤为 2），交给用户做最终检查和手动调整。
+点击已有 `ui-design-doc` 资源直接打开 UI 编辑器。若 manifest 阶段为 `ui-workflow.completed`，工作台自动打开该资源的 `asset-separation` 阶段（最远步骤为 2），交给用户做最终检查和手动调整。

 自动切分达到返工上限的 problematic 节点会随分离 DTO 返回每节点的 `problem_history`，并由编辑器回写为 `component_status = NeedReview(...)`。`SeparationOverview` 只读取 UI State 中的状态来计数和定位；该结果仍按“已尽力完成”报告成功并执行既有 finalize，剩余节点由用户在概览定位后手动处理或再次发起分离。

@@ -480,6 +480,12 @@ export interface GameCreationAppAssetManifestEntry {
  tags?: string[];
 }

+/** UI Editor JSON 文档资产的唯一 kind 与媒体类型。 */
+export const GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND =
+  'ui-design-doc' as const;
+export const GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE =
+  'application/json' as const;
+
 export const GAME_CREATION_APP_CANONICAL_ASSET_KINDS = [
  'image',
  'scene',
@@ -489,6 +495,7 @@ export const GAME_CREATION_APP_CANONICAL_ASSET_KINDS = [
  'icon-spritesheet',
  'icon-spec',
  'ui-design',
+  GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
  'publication-material',
  'spec',
  'video',
@@ -542,12 +549,7 @@ const GAME_CREATION_APP_LEGACY_ASSET_KINDS: Record<
 export function canonicalGameCreationAppAssetKind(
  value: string,
 ): GameCreationAppCanonicalAssetKind {
-  /**
-   * kind 词汇大小写不敏感：UI 设计资产的现役写入侧写的是**大写** `"UI"`
-   * （`src-tauri/src/ui_editor/resource_bridge.rs`、`workflow.rs`、`persistence.rs`）。
-   * 只按小写收口会让它落 `image` 兜底、再经 `image → unclassified` 永远停在「待归类」，
-   * 且派生值本身就是 `unclassified`，读时自愈也救不回来。
-   */
+  /** kind 词汇大小写不敏感；UI Editor 文档写入侧使用 UI 文档常量。 */
  const normalized = value.trim().toLowerCase();
  /**
   * `kind` 是外部输入，可能正好是 `Object.prototype` 上的键（`constructor` / `__proto__` /
@@ -594,6 +596,7 @@ export const GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND: Record<
  'icon-spritesheet': 'ui-interaction',
  'icon-spec': 'ui-interaction',
  'ui-design': 'ui-interaction',
+  [GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND]: 'ui-interaction',
  'publication-material': 'unclassified',
  spec: 'document',
  video: 'unclassified',
@@ -5,6 +5,8 @@ pub const GAME_CREATION_APP_MANIFEST_SCHEMA_VERSION: &str = "game-creation-app.m
 pub const GAME_CREATION_AGENT_RUN_SCHEMA_VERSION: &str = "game-creator-agent-run.v1";
 pub const GAME_CREATION_AGENT_RUN_MAX_PASSES: u8 = 3;
 pub const GAME_CREATION_AGENT_TOOL_CALL_MAX: u16 = 128;
+pub const GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND: &str = "ui-design-doc";
+pub const GAME_CREATION_APP_UI_DESIGN_DOC_MEDIA_TYPE: &str = "application/json";

 #[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize)]
 #[serde(rename_all = "snake_case")]
@@ -565,7 +567,7 @@ impl<'de> Deserialize<'de> for GameCreationAppAssetManifestEntry {
    }
 }

-pub const GAME_CREATION_APP_CANONICAL_ASSET_KINDS: [&str; 16] = [
+pub const GAME_CREATION_APP_CANONICAL_ASSET_KINDS: [&str; 17] = [
    "image",
    "scene",
    "character",
@@ -574,6 +576,7 @@ pub const GAME_CREATION_APP_CANONICAL_ASSET_KINDS: [&str; 16] = [
    "icon-spritesheet",
    "icon-spec",
    "ui-design",
+    GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
    "publication-material",
    "spec",
    "video",
@@ -585,11 +588,7 @@ pub const GAME_CREATION_APP_CANONICAL_ASSET_KINDS: [&str; 16] = [
 ];

 pub fn canonical_game_creation_app_asset_kind(value: &str) -> &'static str {
-    // kind 词汇大小写不敏感：UI 设计资产的现役写入侧写的是**大写** `"UI"`
-    // （`apps/ai-game-creator-shell/src-tauri/src/ui_editor/resource_bridge.rs` 的
-    // `register_local_asset_at(..., "UI", ...)`，`workflow.rs` / `persistence.rs` 同），
-    // 只按小写收口会让它落到 `image` 兜底、再经 `image -> unclassified` 永远停在
-    // 「待归类」；且派生值本身就是 unclassified，读时自愈也救不回来。
+    // kind 词汇大小写不敏感；UI Editor 文档写入侧统一使用 UI 文档常量。
    // TS 侧 `canonicalGameCreationAppAssetKind` 用同一口径，由
    // `apps/ai-game-creator-shell/tests/assetKindCanonicalMapping.test.ts` 交叉钉住。
    let normalized = value.trim().to_lowercase();
@@ -640,7 +639,7 @@ pub const GAME_CREATION_APP_ASSET_CATEGORIES: [GameCreationAppAssetCategory; 6]
 ];

 /// canonical kind 到功能分类的默认映射，必须穷举 `GAME_CREATION_APP_CANONICAL_ASSET_KINDS`。
-pub const GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND: [(&str, GameCreationAppAssetCategory); 16] = [
+pub const GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND: [(&str, GameCreationAppAssetCategory); 17] = [
    ("image", GameCreationAppAssetCategory::Unclassified),
    ("scene", GameCreationAppAssetCategory::Scene),
    ("character", GameCreationAppAssetCategory::Character),
@@ -655,6 +654,10 @@ pub const GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND: [(&str, GameCreationAppAsset
    ),
    ("icon-spec", GameCreationAppAssetCategory::UiInteraction),
    ("ui-design", GameCreationAppAssetCategory::UiInteraction),
+    (
+        GAME_CREATION_APP_UI_DESIGN_DOC_ASSET_KIND,
+        GameCreationAppAssetCategory::UiInteraction,
+    ),
    (
        "publication-material",
        GameCreationAppAssetCategory::Unclassified,
Author	SHA1	Message	Date
k88936	70a2246e8b	移除 UI 文档引用新增测试删除 Direct Codex UI 文档 fixture 与专门测试用例保留生产引用逻辑和现有业务测试	2026-09-14 21:41:53 +08:00
k88936	b7e3dac661	统一引用 UI 文档资产类型常量前端入口、资源桥接与引用预览统一使用共享常量 Rust 持久化与测试复用共享契约常量补齐 UI 编辑器入口 fixture 的新资产类型	2026-09-14 21:36:43 +08:00
k88936	2e4a1996c8	同步 UI 编辑器入口测试资产类型将项目开发 UI 编辑器回程测试 fixture 更新为 ui-design-doc	2026-09-14 21:12:03 +08:00
k88936	fe4e952853	更新 UI 文档资源编辑器入口将 ui-design-doc 资源纳入选中资源的 UI 编辑器按钮判定保留 ui-prototype 图片资源的编辑器桥接入口	2026-09-14 21:04:08 +08:00
k88936	18654b6806	同步 UI 文档资产共享契约与前端识别共享契约新增 ui-design-doc 分类及中英文映射前端编辑器与资源桥接严格识别文档资产更新技术方案、实施计划和长期决策记录	2026-09-14 20:45:04 +08:00
k88936	ee7d00c0b1	统一 UI 编辑器文档资产类型新增 ui-design-doc 与 application/json 常量创建、桥接、工作流和持久化统一使用严格资产类型	2026-09-14 20:44:49 +08:00
k88936	9cd1a94369	接入 UI 文档引用代码上下文生成 Direct Codex 引用 ui-design-doc 时生成带文档的 JS 文件生成成功或失败信息追加到当前 prompt 补充成功、失败与 ui-prototype 隔离测试	2026-09-14 20:44:49 +08:00
k88936	470e85c0ff	Add UI-specific prompt rendering for design assets in resource references	2026-09-14 20:44:49 +08:00