补充AGC资源kind词汇审计清单

记录 manifest kind 的 Rust 写入边界与 TypeScript 消费方。

区分资源 kind 与 source/generation/workflow 等字符串领域。

标注 font、audio、sound-effect、background-music 及旧值的生产状态。

通过文档索引、编码与 diff 检查。

docs/project-memory/plans/【里程碑】AGC资源kind枚举化Rust绑定与内部收紧-2026-09-15.md

@@ -31,7 +31,7 @@
 
 ## 验收标准
 
-- [ ] Rust enum 与生成的 TS 绑定值逐项一致，JSON 使用 kebab-case。
+- [ ] Rust enum 与生成的 TS 绑定值逐项一致，JSON 使用 kebab-case；正式资源成员为当前 17 个 canonical kind 加 `font`，另有 `Unknown` 解析成员。
 - [ ] 未知输入得到 `Unknown`，日志包含原始值与调用上下文。
 - [ ] 生产 writer 不再接受裸 `string` 作为 GameCreationApp kind。
 - [ ] `font`、`audio`、`sound-effect`、`background-music` 均有真实生产路径或明确的测试证据。

docs/project-memory/todos/【待办】AGC资源kind枚举化扫描清单-2026-09-15.md

@@ -84,3 +84,88 @@
 - [ ] 逐处确认 `ui` / `ui-prototype` 是否仍有生产 manifest writer。
 - [ ] 确认 `Unknown` 的 tracing 字段和 writer 禁止规则。
 - [ ] 确认 ts-rs 生成文件的实际路径、生成命令和 CI verify 实现。
+
+## 已确认的 manifest kind 入口（M0 审计结果）
+
+下列位置已经确认直接承载或生产 `GameCreationAppAssetManifestEntry.kind`，后续迁移必须逐项完成：
+
+| 位置 | 当前事实 | 后续动作 |
+| --- | --- | --- |
+| `src-tauri/src/assets.rs:584-604` | `register_local_asset_at` 以 `&str` 接受 kind 并转交登记 | 参数改为 Rust enum；边界字符串集中解析 |
+| `src-tauri/src/assets.rs:563-566` | 普通上传根据内容推断 kind 后登记 | 推断函数返回 enum；无法判断返回 `Unknown` 并 trace，禁止 `asset` fallback |
+| `src-tauri/src/assets.rs:791-806` | 画板导出图层登记资源 | 推断结果直接使用 enum |
+| `src-tauri/src/assets.rs:916-934` | 平台资源同步从 payload `assetKind` 登记 | 入口解析成 enum；未知值 `Unknown` + trace |
+| `src-tauri/src/assets.rs:1871-1916` | manifest 新增/更新资产并写入 kind | 禁止裸字符串和隐式 alias/fallback |
+| `src-tauri/src/commands.rs:2094-2129` | Tauri `register_local_asset` 接收外部 kind | 解析边界收紧为 enum/Unknown |
+| `src-tauri/src/commands.rs:2672-2711` | 字体导入生产路径登记 `"font"` | 正式保留 `Font` enum variant |
+| `src-tauri/src/commands.rs:2784-2803` | 字体登记测试/辅助路径 | 与生产字体 kind 一致 |
+| `src-tauri/src/project/resource_editor.rs:3806-4065` | 资源派生/替换构造 manifest asset | `source_subtype` / `asset_kind` 只在确认是 manifest kind 时改 enum；operation 临时类型另行排除 |
+| `src-tauri/src/ui_editor/workflow.rs:687-749` | UI 设计文档与图片资源登记 | `ui-design-doc` / `ui-design` 使用 enum |
+| `src-tauri/src/ui_editor/resource_bridge.rs:121-139` | UI 设计文档生产登记 | 使用 `UiDesignDoc` enum variant |
+| `src-tauri/src/agent/direct_runtime.rs:2462-2469` | 恢复图集登记仍传 `"art-spritesheet"` | manifest 写入改为 `IconSpritesheet`；恢复协议字符串单独审计 |
+| `src-tauri/src/agent/generation/canvas_generation.rs:6816-6828` | 切片 manifest 条目仍写 `"art-spritesheet-slice"` | manifest 写入改为 `Icon`；切片协议标识不自动替换 |
+| `src-tauri/src/agent/direct_tool_bridge.rs:1126-1183` | Agent 资源投影读取 manifest kind | 改为消费 enum，序列化边界仍输出 kebab-case |
+| `src-tauri/src/agent/direct_codex_references.rs:107-199` | Agent 引用和展示读取 manifest kind | 改为 enum 展示/比较 |
+
+## 已确认的 shell TS 消费方
+
+这些文件目前通过 `packages/shared/src/contracts/gameCreationApp.ts` 或手写 `string` 消费资源 kind，需迁入 shell 生成绑定：
+
+- `src/features/project-workspace/resourceReferences.ts`
+- `src/features/project-workspace/ResourceReferenceInput.tsx`
+- `src/features/project-workspace/SupervisorChatOnlyView.tsx`
+- `src/features/project-workspace/ProjectSupervisorView.tsx`
+- `src/features/project-workspace/ProjectWorkspaceChatPane.tsx`
+- `src/view/project-development/index.tsx`
+- `src/view/project-development/ResourceClassificationPanel.tsx`
+- `src/view/project-development/ResourceRenameDialog.tsx`
+- `src/view/project-development/resourceProjectionModel.ts`
+- `src/features/resource-canvas/resourceCanvasBottomToolbarModel.ts`
+- `src/features/resource-canvas/resourceCanvasGenerationPanelView.tsx`
+- `src/features/resource-canvas/ResourceCanvasAssetGenerationPanelView.tsx`
+- `src/features/resource-canvas/resourceVersionReplacementModel.ts`
+- `src/components/AssetImporter/utils.ts`
+- `src/components/AssetImporter/index.tsx`
+- `src/components/AssetImporter/settings.ts`
+- `src/services/clientApi.ts`
+- `src/view/ui-editor/useUiEditorPage.ts`
+- `src/features/ui-editor/uiDesignResourceBridge.ts`
+
+其中 `resourceCanvasBottomToolbarModel.ts:243,258` 和 `resourceProjectionModel.ts:326` 已明确出现 `art-spritesheet` / `ui-prototype`，需回到调用链判断它们是 manifest kind 还是生成入口协议值，不能文本全局替换。
+
+## 旧值生产状态初判
+
+| 值 | 已发现位置 | 初判 |
+| --- | --- | --- |
+| `font` | `commands.rs:2672,2787`；UI Editor 字体登记 | 正式 manifest kind，保留 |
+| `audio` | `assets.rs:495`；上传推断与本地文件类型 | 正式 manifest kind，保留 |
+| `sound-effect` | `direct_tool_bridge.rs:104-116`；Agent 音频工具 | 正式 manifest kind，保留 |
+| `background-music` | `direct_tool_bridge.rs:104-116`；Agent 音频工具 | 正式 manifest kind，保留 |
+| `asset` | `assets.rs:537` 未知上传兜底；`assets.rs:1882` 空 kind 兜底 | 错误 fallback，改为 Unknown/显式失败后删除 |
+| `art-spritesheet` | `direct_runtime.rs:2465`；canvas generation 多处 | 既有 manifest/协议混用，逐处拆开 |
+| `art-spritesheet-slice` | `canvas_generation.rs:6818`；direct runtime 多处 | manifest kind 改为 `icon`，协议标识另留 |
+| `game-background` | canvas generation 选项与 runtime 阶段 | manifest kind 改为 `scene`，阶段标识另留 |
+| `game-art` | canvas generation 默认值/测试 | manifest kind 改为 `image`，生成请求字段另审 |
+| `illustration` | direct runtime 测试/恢复路径 | manifest kind 改为 `image`，其他用途另审 |
+| `character-art` | manifest/API 白名单与测试 | manifest kind 改为 `character`，API 参考不改 |
+| `ui-prototype` | UI workflow 检查、资源 bridge、TS 画布选项 | manifest kind 改为 `ui-design`；workflow 输入另审 |
+| `ui` | 旧 bridge/测试与外部输入 | 不再 alias；未知值进入 `Unknown`，逐处确认生产残留 |
+| `animation` | 旧映射及文本/阶段判断 | 不再 alias；仅 manifest kind 的位置改为 `character-animation` |
+| `game-entry` / `game-script` / `game-style` | runtime 代码文件登记 | manifest kind 改为 `code`；文件阶段标识不改 |
+
+## 本轮明确排除的同名字段
+
+以下命中不属于本 PR 的 `GameCreationAppAssetKind`，只记录边界，不修改：
+
+- `source.kind`：`Uploaded / Generated / Canvas`，表达资源来源。
+- `source.generationKind`：包含 `ui-workflow.completed`、`project-file`、`icon-spritesheet` 等工作流/生成标识。
+- `mediaType`、MIME、扩展名和文件分类器。
+- Agent group、task kind、workflow stage、路径/目录名、tracking scope、插件 kind。
+
+## 下一步审计动作
+
+- [ ] 为每个“旧值生产状态初判”补充真实调用链和测试证据。
+- [ ] 将 manifest kind 与 generation/request kind 的复用关系改为显式转换，不共享裸字符串。
+- [ ] 确认 `Unknown` 在上传推断、外部 payload、manifest 读取三条入口的日志字段。
+- [ ] 完成 `packages/shared` import 使用方迁移清单，确认删除文件不会留下跨包引用。
+- [ ] 完成后更新本文件，关闭 M0 里程碑，再创建代码里程碑的实施计划。