374 Commits

Author	SHA1	Message	Date
k88936	fd48829c24	3D 生成请求落点改为平坦可选字段并复用统一落点预检 ... - shared-contracts 的 text-to-model / image-to-model 请求用平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel 取代 tagged enum target，删除 Model3dGenerationTarget 及其契约测试。 - 同步 ts-rs 生成绑定：新增四个可选字段并移除 Model3dGenerationTarget.ts 与 barrel 导出。 - api-server 校验层改按「项目资源 / 素材库二选一」校验，缺失、冲突与空白值都返回 400 并点名具体字段。 - 落点预检改用其它付费编辑器生成共用的 preflight_editor_generation_target_and_return，素材库落点不再读整库。 - worker 按平坦字段落库，素材名缺省回落到 MODEL3D_DEFAULT_ASSET_LABEL。 - 定向验证：cargo test -p shared-contracts 与 cargo test -p api-server tripo3d:: 全绿（54 passed）。	2026-09-23 14:02:44 +08:00
k88936	ee4a9434fa	后台定价读取带版本、保存整段必填并做事务内乐观锁 ... - shared-contracts 新增定价版本冲突标记，module 与 api-server 共用一处声明 - SpacetimeDB upsert input 增加期望版本，事务内比对不一致即整笔拒绝（种子写入显式不比对） - 定价 store 记录当前版本，读取路径带出 updated_at 微秒值 - 后台 GET 返回 models / 3D 两段 / updatedAtMicros，POST 要求两段显式给出且带期望版本 - 缺 3D 段 400、版本不匹配 409，退役 with_previous_model3d 与「省略即沿用」用例 - 绑定按 input 新字段重新生成，模块补乐观锁比对用例	2026-09-23 11:38:23 +08:00
k88936	62bf602fb1	多视图请求 DTO 补齐字段级说明并重生成绑定 ... - Model3dMultiviewToModelRequest 每个字段补一行中文语义说明与取值范围 - 结构体补严格反序列化与组合校验归属的说明 - 重新生成 ts-rs TS 绑定，注释同步进 Model3dMultiviewToModelRequest.ts	2026-09-22 16:48:57 +08:00
k88936	2348315dba	3D 结果打标契约测试补齐 preview 与 imageToModel 分支 ... - textToModel 用例补 preview 产物的相等断言 - 新增对称的 imageToModel 用例，守住 tag 路由与分支字段 - 裸字符串 source 的负例改为点名 Model3dGenerationSource 并单独反序列化 source 值	2026-09-22 16:46:19 +08:00
k88936	48cde9624c	operation_kind 白名单改为两 crate 共用的共享常量 ... - 白名单常量迁到 shared-contracts 并从 crate 根导出 - spacetime-module 的原子落库事务改为引用该常量，删除本地重复定义 - api-server 的登记测试不再解析对方源码文本，改为直接断言常量内容 - 后端架构文档补上白名单常量的位置与共用口径	2026-09-22 16:30:28 +08:00
k88936	9800477c7c	模型版本清单从声明表派生避免漏加新版本 ... - Model3dModelVersion 的变体、线上值与 ALL 改为由 model3d_model_versions! 单一声明表生成 - ALL 类型改为 &'static [Self]，新增版本只需在声明表加一行 - 定价校验与测试的遍历改用 iter().copied()	2026-09-22 16:03:55 +08:00
k88936	10e63ecb6b	合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... - server-rs/Cargo.toml：删除与 workspace git 固定重复的 registry `ts-rs = "12.0.1"`，保留固定 commit 并写明「ts-rs 一律常开、绑定命令固定为 cargo test -p shared-contracts export_bindings」 - server-rs/crates/shared-contracts/Cargo.toml：删除 master 侧新增的 `ts-bindings` feature，`ts-rs` 保持常开依赖 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：去掉 `cfg_attr(feature = "ts-bindings", …)` 门控，derive 与字段级 `ts(...)` 无条件展开 - apps/ai-game-creator-shell/src-tauri/Cargo.toml：shared-contracts 依赖去掉 `features = ["ts-bindings"]`，继续保留本分支的 ts-rs git 固定 - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按上述依赖变更同步（shared-contracts 指向 git 源 ts-rs） - docs：同步 5 处绑定生成命令（去掉 `--features ts-bindings`），并在 decision-log 记本次合并的决策、代价与验证 - 其余暂存改动为 origin/master 带入的内容，冲突按两侧目的逐一合并 验证：cargo metadata --locked（server-rs 与 AGC 两个 workspace）、cargo test -p shared-contracts（119 + 5 + 5 + 2 + 2 全绿且无告警）、npm run contracts:model3d:generate 后 packages/shared 零 diff、cargo check -p spacetime-module --target wasm32-unknown-unknown、npm run check:encoding、npm run check:rustfmt、npm run check:spacetime-schema、git diff --check、暂存集 eslint / prettier 全过	2026-09-22 13:12:28 +08:00
k88936	3af0d3d90b	契约枚举的线上取值只由serde定义 ... - shared-contracts 新增 wire_str 与 wire_str_lossy：线上取值只从 serde rename / rename_all 取，不再维护第二份字面量 - 删除模型版本、纹理质量、纹理版本、纹理对齐、几何质量、输入方向、导出方向、压缩共 8 个枚举上手工维护的 as_str - platform-tripo 新增 common/wire.rs 负责契约枚举到 provider 请求字符串的转换，三个入口的 to_sdk_params 改走它并把失败归一成 provider 错误 - api-server 的定价文案与 job 模型版本取值改用 serde 取值，job 的 model_version 由 &'static str 改为 String - 取值来源只剩 serde 一处，改 rename 不会再静默分叉	2026-09-21 19:46:43 +08:00
k88936	c0d6531e92	三个入口的seed参数在TS契约里改用bigint ... - seed 是 i64，JS number 表示不了全部取值却又没有范围校验，客户端传 64 位值会被静默舍入 - text_to_model / image_to_model / multiview_to_model 的 image_seed、model_seed、texture_seed 由 number|null 改为 bigint|null - 同步重新生成的 ts-rs 绑定，仅这三个字段变化	2026-09-21 19:38:47 +08:00
kdletters	4951b71d71	项目快照按渠道分区，后台项目工程支持渠道筛选与游标分页 ... 项目快照对象键升级为 agc/project-snapshots/v2/{channel}/{user}/{project}/，渠道取部署配置 GENARRATIVE_AGC_PROJECT_SNAPSHOT_CHANNEL（缺省沿用客户端下载渠道），非法渠道在写入处失败关闭 后台新增渠道列表接口，项目工程列表与下载接受 channel，游标绑定渠道并拒绝跨渠道复用 后台项目工程用户列改为素材查询口径：昵称 + 陶泥号 + 用户详情入口，由 api-server 解析作者信息 后台项目工程改为游标分页：每页 20/50/100、上一页/下一页与当前页提示，翻页失败保留当前页 部署环境示例补充快照渠道配置，并同步运维、技术方案、里程碑与决策记录文档	2026-09-21 16:57:16 +08:00
kdletters	4863c8c066	后台模板上传（后端）：新增批量导入接口与存储/领域支持 ... - shared-contracts 新增导入 manifest、逐条与结果 DTO（camelCase，拒绝未知字段） - module-assets 新增 prepare_template_import：新 ID 默认上架，已存在条目就地更新并保留上架状态与未知扩展字段；同一 ID 同版本字节不同时按 CLI 同一句文案拒绝，字节一致时按内容复用既有对象 - platform-oss 为 application/zip 放宽单对象上限到 64 MiB（图片与元数据仍 5 MiB），测试替身同步该口径 - api-server 新增 POST /admin/api/agc-templates/import：multipart（manifest + zip_N/cover_N），逐项校验归档安全性、entry 存在性与封面（按字节嗅探格式，仅 PNG/JPEG/WebP）后才取发布锁 - 锁内流程：CAS 校验 revision → 内容寻址写入 zip/封面/元数据并回读 → 一次提交清单 → 释放锁；断连由独立任务持有，不确定结果保留锁并返回 503 - 路由挂 require_admin_auth 与 200 MiB body 上限，页签权限矩阵与路由契约测试同步 - 新增用例：清单与文件字段校验、归档越界与符号链接拒绝、内容寻址键与封面嗅探、zip 内容类型存储上限 - 新增「后台模板上传」里程碑与实施计划文档 - 验证：cargo test（module-assets 11 项、platform-oss 12 项、api-server 定向 4 项）、cargo fmt --check、check:doc-index、check:encoding、git diff --check	2026-09-21 16:06:23 +08:00
k88936	aebbd3bb99	多视图输入变体字段统一按camelCase序列化 ... - Model3dMultiviewInputs 的 serde 属性补 rename_all_fields = camelCase，结构体变体字段不再逐字段手工 rename - TaskId 变体去掉冗余的 taskId 显式 rename，序列化结果与生成绑定均无变化	2026-09-21 15:20:36 +08:00
k88936	d4af6802fb	补多视图请求契约的全字段往返用例 ... - 新增全字段往返：钉住 camelCase 字段名、各枚举线上取值与 Option 的可省略写法 - 新增显式 null 往返：确认可选字段回写时仍是 null 而不是整字段消失 - 补用例后字段改名或可空性漂移会被测试拦住，不再是只在 TS 绑定里可见	2026-09-21 15:16:06 +08:00
kdletters	02a7abeb3f	新增后台 AGC 模板管理与模板库内容寻址落库 ... - 后台新增「模板管理」页：按权限查看并编辑模板名称/简介/标签/封面，支持上架与下架；路由、侧栏、tab 权限、API 客户端与 DTO 同步接入 - api-server 新增 /admin/api/agc-templates 读取与更新路由，复用现有后台鉴权与 tab 权限校验，权限不足按既有失败关闭口径拒绝 - module-assets 收敛模板库纯规则（active/inactive 投影、索引 schema 与重复项校验、ZIP 大小与摘要核对），platform-oss 承担对象存储读写、不可变对象复用与发布互斥锁 - shared-contracts 补后台模板 DTO；spacetime-module 账号存储适配保持既有 schema 不变 - AGC 壳内置模板索引与建项读取改为内容寻址对象，补模板安装、越界归档、索引不匹配等用例 - 模板库发布脚本支持定向发布与上架/下架合并、内容地址复用与锁语义，CLI 守卫用例同步；jenkins 两条客户端打包管线统一触发邮件通知 Job 并传递首装包链接 - 内置 5 个 Cocos 官方模板载荷与索引 fixture（内容地址对象，共 90 个文件） - 补「后台模板管理」里程碑与实施计划，更新模板库技术方案、开发运维文档与共享记忆 - 验证：admin-web 39 项用例与 typecheck、发布脚本 25 项用例、api-server 与 AGC 壳编译、模板库定向 Rust 用例（AGC 壳 18 项、module-assets/platform-oss 16 项、后台权限 1 项）、check:encoding / check:doc-index / check:production-ops / rustfmt 全部通过	2026-09-21 13:56:20 +08:00
k88936	8f6458ffe2	新增api-server Tripo3D模块与泥点定价结构 ... - 新增 tripo3d/pricing.rs，底价按 endpoint × 模型版本 × 是否有贴图，add-on 按固定键表叠加 - 定价段加载即校验全部底价与 add-on 键，缺键即配置非法；缺段代表未配置，查价直接拒绝 - editor_generation_config 挂载可选 model3d 段并提供 fail-closed 查价入口 - 后台记录形状尚不支持 3D 段，暂由文件配置提供并留下同步待办 - model_version 增加 ALL 与排序，供定价表枚举校验	2026-09-21 12:53:02 +08:00
k88936	e0108f7d57	分层Tripo生成的provider参数与平台API请求契约 ... - common 新增 Model3dGenerationSource、Model3dGenerationTarget、Model3dGenerationTargetRef 与产物元数据 - text/image 各自的参数类型独立成 params，API 请求为 generation + 平台字段 + target - 图片输入只接受站内引用，input 由服务端解析后注入 provider - 删除宽松的作业与结果占位 DTO，改为按端点的严格结果与端点 tagged enum - 新增契约严格性测试，覆盖分支必填字段、图片输入歧义与顶层未知字段	2026-09-21 12:38:46 +08:00
k88936	93306952d9	把画布占位载荷移出受feature门控的assets模块 ... - 新增 shared-contracts::editor_canvas，承载画布占位与回填载荷并接入 ts-rs 生成 - assets 模块改为内部引用该类型，不再自带定义 - api-server 七处引用改到新模块路径	2026-09-21 12:38:28 +08:00
kdletters	429f991bde	回滚误入 master 的游戏分发 WIP（夹带在 OSS v1 签名提交里） ... - 撤销 39aed2e48 夹带的游戏分发前后端、SpacetimeDB 绑定、主站路由、后台审核页、文档与 nginx 改动，master 恢复可编译状态 - 保留该提交自身的 AGC 发号改动：agc-global-version.mjs 与其参数构造单测 - 恢复被误删的 output 产物，避免把无关清理混进该提交 - 补回两篇技术文档在 docs/README.md 的索引（它们属于后续两个补提交文档，不属于游戏分发） - 游戏分发完整实现保留在 codex/game-distribution 分支继续开发	2026-09-20 20:52:24 +08:00
kdletters	39aed2e486	OSS 写入显式使用 v1 签名 ... ossutil v2 默认 v4 签名，缺 region 会直接失败\n总号写入与回读统一走 buildOssutilArgs，默认 --sign-version v1，可切 v4 并配合 AGC_OSS_REGION\n补充参数构造单测	2026-09-20 18:33:02 +08:00
kdletters	5822b64d7c	合并 Godot 编辑器插件与常用操作指导到主分支 ... 接入 Godot 原生桥、受控执行、Runner 回执与编辑器操作指南 保留主分支 Cocos 和 Unity 跨工程能力及外置提示词结构 解决插件生命周期、工具目录、前端启动和文档合并冲突	2026-09-20 17:38:48 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
lhk229	70271b408e	删除策划agent v2，与退役功能解耦 (#355) ... Reviewed-on: #355 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-20 14:49:57 +08:00
kdletters	15774a1c02	修复项目自动上传并增加后台完整工程下载 ... 接入真实项目打开、切换和关闭生命周期并修复退出等待竞态 新增后台项目列表及按原目录校验导出的 ZIP 下载 补充快照完整性元数据、后台权限和取消清理 固定默认 AGC 存储目标并支持空文件与特殊字符路径 补充自动化测试及真实 OSS 只读导出验证 记录本地数据库 404 导致完整 HTTP 联调和安装版实机验证待补	2026-09-20 10:07:31 +08:00
k88936	c48f0627cf	修复 ts-rs 对 enum 级 deny_unknown_fields 的解析告警并保留契约严格性 ... - 把 server-rs 与 apps/ai-game-creator-shell/src-tauri 两个 workspace 的 ts-rs 从 registry 固定到上游修复 commit fd8679ef20f866f747c046b30bd29c15e3d7a003（PR #491：已发布版 12.0.1 的 EnumAttr 不识别 deny_unknown_fields，只有 StructAttr 会静默忽略它），两个 Cargo.lock 同步改成 git 源 - 说明固定原因与退出条件：crates.io 最新仍是 12.0.1、GitHub 最新 tag 仍是 v12.0.0，等发布 > 12.0.1 后改回 registry 版本并删除 commit 固定 - 明确不使用 ts-rs 的 no-serde-warnings feature 消警：它会连同 deserialize_with 这类真实未支持的 serde 属性一起静默，掩盖 Rust 与 TS 绑定的漂移 - 保留 shared-contracts 的 Model3dMultiviewInputs enum 级 deny_unknown_fields（该属性一直由 serde 生效，告警只来自 ts-rs 的属性解析），注释改为写明不要为消警删属性、也不要改用 no-serde-warnings - 新增契约测试 tests/model3d_multiview_request_contract.rs：钉住 views/taskId 变体内部与请求体顶层拒绝未知字段，并覆盖 kind 与 camelCase 字段名解析 - 记录排障经验与决策：pitfalls.md 说明无 span 的告警不代表属性失效，decision-log.md 记录固定 commit、影响面与回退条件 - 验证：cargo check -p shared-contracts 与该 crate 的 cargo test 不再出现 deny_unknown_fields 告警且全绿；cargo test --locked -p shared-contracts model3d 加 prettier 后 packages/shared 的 model3d 绑定零 diff；AGC 的 cargo check --locked --bin genarrative-ai-game-creator-shell 不再出现该告警（AGC 侧仍保留 1 条既有的 deserialize_with 告警，与本改动无关）；npm run check:encoding、npm run check:doc-index、git diff --check、cargo fmt --all --check 通过	2026-09-19 16:56:24 +08:00
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +08:00
k88936	1392303f1c	请求契约把 model 改为必填字段 ... 三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定 validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family 三个 client 的 to_sdk_params 改为直接提交模型版本字符串 冒烟示例与技术方案文档同步为必填写法	2026-09-19 14:16:39 +08:00
k88936	12512f26b2	multiview 输入拒绝未知字段 ... Model3dMultiviewInputs 增加 deny_unknown_fields，与 Model3dMultiviewToModelRequest 的严格反序列化保持一致 未知视图键（例如拼写错误的 righ）不再被静默丢弃，避免用少于调用方预期的视图提交任务 ts-rs 12 不支持 enum 级该属性，构建时会打印一条可忽略的告警，已在代码注释说明	2026-09-19 14:14:55 +08:00
k88936	800da43a8d	说明生成结果 DTO 的 number 精度边界 ... 为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示 重新生成 TypeScript 绑定，把上述说明同步为 JSDoc 技术方案补充同一说明，明确不做 bigint/string 特殊处理	2026-09-19 14:14:14 +08:00
k88936	950209f038	为 model3d 请求契约的可选字段补充 ts(optional) ... 为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable) multiview 视图分支的 left、back、right 同步标记为可选 重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段	2026-09-19 13:07:41 +08:00
k88936	42a5929a73	清理 model3d 请求契约中冗余的 serde(default) ... 移除 image_to_model、multiview_to_model、text_to_model 三个请求结构体 Option 字段上的 serde(default) 同步移除 multiview 视图分支中三个可选视图的 serde(default) serde 对 Option 字段本身即按 None 处理缺失字段，生成的 TypeScript 绑定保持不变	2026-09-19 13:07:41 +08:00
k88936	eda9da4d8d	单点维护 model3d 的 ts-rs 导出根目录 ... 在 model3d/mod.rs 新增 model3d_ts_export_dir 宏，集中定义仓库相对导出根路径 common、image_to_model、multiview_to_model、text_to_model 改为调用宏并只声明各自子目录名	2026-09-19 13:07:41 +08:00
k88936	48caa23997	收紧AGC资源kind枚举边界 ... canvas生成与运行时统一使用共享GameCreationAppAssetKind 删除平台kind兼容映射与退役kind拒绝测试 更新资源kind审计里程碑与绑定文档	2026-09-19 01:28:27 +08:00
k88936	5be4a51ac1	完善Tripo枚举与参数组合校验 ... 按提供的 Tripo 文档补齐 compression、texture quality 与 texture version 枚举 移除未在三个生成接口出现的 style 占位字段并同步 Rust/TypeScript contracts 增加模型版本、纹理版本、生成部件、quad、smart-low-poly 与 face limit 的副作用前校验 同步 Provider 技术方案和 ADR	2026-09-18 17:23:55 +08:00
k88936	0d5940433d	删除资源 kind 兼容白名单 ... 服务端图片快速编辑改用共享枚举静态图片判定 移除退役 kind 的兼容放行与冗余回归测试 清理客户端恒假 art-spritesheet 判断并统一远端 kind 解析 同步 AGC kind 里程碑、实施计划与决策记录	2026-09-18 17:09:36 +08:00
k88936	1c4009ea3b	建立3D生成目录化契约 ... 新增 model3d common、text-to-model、image-to-model、multiview-to-model Rust contracts 通过 ts-rs 按目录生成 TypeScript bindings，移除依赖 barrel 的组织方式 增加 model3d contracts 定向生成脚本	2026-09-18 15:59:19 +08:00
k88936	e5fd454bb3	收紧 AGC 资源 kind 类型边界并统一族判据 ... - 将 manifest 与本地导入回执的资源 kind 改为 ts-rs 生成绑定 - 集中音频与视觉资源族判据并复用 Rust 枚举方法 - 放宽 Unknown 未解析语义并清理上传类型墓碑注释 - 标记共享生成绑定并同步项目决策与实施计划	2026-09-18 15:21:19 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
k88936	3d4c7929c3	统一画布生成 kind 为共享枚举 ... 工具白名单与 schema 改用 GameCreationAppAssetKind canonical 输入在生成适配边界映射旧账本值	2026-09-17 22:52:38 +08:00
kdletters	1a7abfd059	AGC 项目定时快照上传（目标 OSS agc-dev） (#400) ... ## 交付内容 - 客户端新增 `project_snapshot` 模块：项目扫描与排除口径、增量索引、差异对比、上传编排、状态查询。 - 触发：工作区窗口存活期间的周期定时器 + 工作区窗口关闭（`CloseRequested`）；应用退出只在有界预算内等待在途同步收尾，不重复发起。 - 服务端新增两条登录态路由 `POST /api/agc/project-snapshots/files` 与 `/manifest`，由 api-server 用服务端凭据写入私有前缀 `agc/project-snapshots/v1/{user}/{project}/`；客户端不持有 OSS 凭据、不直连 OSS。 - `platform-oss` 新增内部对象精确写入与探测、项目快照对象键构造；修复 `head_internal_object` 读 HEAD 响应长度恒为 0（会导致服务端"已存在即跳过"永不生效）。 - `shared-contracts` 新增 `agc_project_snapshots` DTO 与项目 ID、相对路径、摘要校验。 - 真实 OSS 存储层冒烟示例 + 客户端真实链路冒烟用例（`#[ignore]`，env 驱动）。 - 登记 `check-config.mjs` 的 native-only 命令白名单，恢复 `npm run agc` 可启动。 ## 验证证据 - 存储层：`cargo run -p platform-oss --example agc_project_snapshot_live_smoke` 对真实 `agc-dev` 完成写入 → 读回（contentLength 32）→ 清单写入 → 探针清理。 - HTTP 层：登录态下 7 项校验（401 无 token、400 路径穿越/长度不一致/非法摘要/空正文/重复路径清单）全部符合预期且不写对象。 - 客户端链路（真实项目 gameagent-033b6cf3…）：第一次 `synced uploaded=6 uploadedBytes=36694 remoteSkipped=6`，紧接着第二次 `no-op uploaded=0`。 - GUI 触发：`trigger=periodic ... uploaded=6`；把周期设为 600 秒排除干扰、改一个文件后关窗得到 `trigger=project-close ... revision=2 uploaded=1`，索引摘要由 `28d837cd84f8ab62` 推进到 `bff34e2e336d901f`（同步在进程退出前完成）。 - 门禁：AGC `project_snapshot` 14 passed（+1 ignored live）、api-server `project_snapshots` 3 passed、platform-oss 39 passed、shared-contracts 87 passed、`cargo fmt --check`（两处）、`check:encoding`、`check:doc-index`、`git diff --check`、`check-config.mjs` 全部通过。 ## 已知未决（不阻塞本里程碑） - 远端对象只增不减：没有删除路径，也没有 bucket 生命周期规则；要收口需要先定保留语义（清单引用 GC 还是 OSS 生命周期）。 - 部署环境需确认 `GENARRATIVE_AGC_PROJECT_SNAPSHOT_OSS_*` 或回退的 `ALIYUN_OSS_*` 具备目标 bucket 私有前缀的 `PutObject` 权限；未配置时接口返回 503、客户端失败关闭（不推进索引）。 - 缺少按用户/项目的配额与限流（error_reports 有每小时提交上限的先例，本功能没有）。 - 没有界面入口与状态可见性：`read_local_project_snapshot_state` 已注册但未接 UI，失败只写本机日志。 ## 不做 - 不做云端下载/恢复、跨设备合并、版本回滚。 - 不改 `/api/external/v1` 与 External OpenAPI，不新增 SpacetimeDB 表。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/400	2026-09-17 18:34:51 +08:00
k88936	796ad7bb51	资源 kind 只保留一个公开解析入口 ... - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：删掉公开的 `from_str_or_unknown()`（`from_str_lossy` 的残留命名），严格匹配降级为私有 `match_canonical()`；`parse_with_context()` 成为唯一公开解析入口，`FromStr`、serde 与所有边界一律走它，认不出 canonical 值只有这一处收口并留痕。 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：词汇表用例改走唯一入口，并断言每个非 canonical 变体都留痕。 - apps/ai-game-creator-shell/src-tauri/src/project/manifest.rs：读侧回捞 legacy kind 时不再调用第二个解析函数，直接用唯一词汇表 `ALL` 判真值（`unknown` 本身是成员，自然跳过）。	2026-09-17 16:27:48 +08:00
k88936	6782d0ea23	GameCreationApp 资源 kind 词汇表收敛为 Rust 单源并接上可注册留痕回调 ... - asset_kind.rs：新增声明宏，由一张 kind 表派生出枚举、线上值 as_str、ALL、严格解析与 ts-rs 绑定，仓库里不再有第二份 kind 列表。 - asset_kind.rs：from_str_lossy 改名 from_str_or_unknown 并去掉 trim / lowercase 归一，parse_with_context 只做严格等值匹配，认不出的原值不查别名、不迁移。 - asset_kind.rs：留痕改为可注册回调 set_non_canonical_asset_kind_reporter，把原始串与调用上下文交给壳层日志，未注册时静默。 - game_creation_app.rs：删除手写 GAME_CREATION_APP_CANONICAL_ASSET_KINDS 与 canonical_game_creation_app_asset_kind 别名表（含 font → document 特例），分类映射表按枚举成员穷举。 - shared-contracts/Cargo.toml：删除 kind-observability feature 与 tracing 依赖，留痕不再靠 tracing。 - api-server/editor_project.rs：图片编辑白名单注释改成「API 兼容面」，不再自称 kind 别名表。	2026-09-17 15:43:51 +08:00
k88936	29ba9a358e	字体 kind 提升为 canonical 并去掉 font 别名 ... - game_creation_app.rs：`GAME_CREATION_APP_CANONICAL_ASSET_KINDS` 加入 `font`（17 → 18 项），分类表补 `font → document`，删除 `"font" => "document"` 别名。 - gameCreationApp.ts：TS 侧同步加入 `font`、删除别名表条目、补 `font: 'document'` 分类，并同步别名表注释。 - 测试：两侧用例改为断言 `font` 是 canonical 成员（大小写仍不敏感）、栏目仍是 document。 - 理由：字体上传写入侧直接落 `font`，再把它当别名会让「落盘值集合」与「canonical 集合」分叉；严格解析下写入侧的值必须本身就是 canonical。	2026-09-17 13:42:05 +08:00
k88936	3ab56e6cfa	非 canonical 资源 kind 严格收口并留痕原始串 ... - manifest.rs：读 manifest 时若存在 `unknown` kind，从原始 JSON 回捞 `assets[].kind` 原值，连同资产 ID、路径写进应用日志；同一原值每进程只记一次，避免刷屏。 - recovery_tests.rs：新增用例钉住回捞范围（只报非 canonical 值，跳过 canonical 与字面 `unknown`；结构异常返回空表）。 - commands.rs：`imported_platform_asset_kind` 收口平台 `assetKind` 时，非 canonical 原值一并留痕，供后续定位平台侧 legacy 写入点。 - shared-contracts/Cargo.toml：`ts-bindings` 不再顺带打开 `kind-observability`，改由 AGC 壳显式声明，日志开关不再随绑定需求被动启停。 - 口径：kind 保持严格解析（无 trim/lowercase、无别名表、无迁移），认不出的值一律收口 `unknown` 并留痕，不做 fallback。	2026-09-17 13:41:41 +08:00
k88936	b96cd4b7c2	ts-rs 绑定统一走 cargo test export_bindings，删除退役类型导出 ... - asset_kind.rs：`GameCreationAppAssetKind` 自带 `#[ts(export, export_to = ../apps/ai-game-creator-shell/src/contracts/generated/)]`，`cargo test export_bindings` 即可复现生成文件 - binding.rs：删除手写的 `exports_ui_editor_types` 测试，不再由测试就地重写生成文件或重建退役类型 - binding.rs：`BindingChange` / `BindingDTO` 去掉 `TS` derive 与 `ts(export_to)`，只作为内部结构使用，不再导出退役的前端绑定 - binding.rs：清理仅为该测试存在的 `ts_rs` / `GameCreationAppAssetKind` 导入 - .prettierignore、.eslintrc.cjs：忽略 `src/contracts/generated/`，保留 ts-rs 原始格式使生成幂等且不污染工作树 - GameCreationAppAssetKind.ts：按生成器原始格式更新（与上述路径一致，无内容漂移）	2026-09-16 19:07:33 +08:00
k88936	55d0c99e2b	修正资源 kind 转义测试期望 ... 转义后的 ui-design 应解析为 UiDesign 枚举。	2026-09-15 20:57:14 +08:00
k88936	040f646480	统一 ts-rs workspace 依赖版本 ... 在 server-rs workspace 集中声明 ts-rs 版本。 shared-contracts 通过 workspace 依赖引用可选 ts-rs。	2026-09-15 19:53:06 +08:00
k88936	3caefd6716	修复资源 kind 转义字符串反序列化 ... 为 AssetKindVisitor 增加 visit_string 转发。 补充 JSON 转义 kind 的反序列化回归测试。	2026-09-15 19:31:21 +08:00
k88936	20b0bf4dd7	补充 AGC manifest 未知 kind 验收 ... 验证旧值读取为 Unknown 且序列化为 unknown 明确不执行 alias 迁移	2026-09-15 17:50:33 +08:00
k88936	b4fd8d9b8b	收紧 AGC manifest 资源 kind 字段 ... 将 manifest 条目 kind 改为 Rust 枚举并把未知值收口为 Unknown 修正字体上传与图集切片的正式资源 kind 保持 source.kind 与 generationKind 等其他字符串字段不变	2026-09-15 17:37:28 +08:00
k88936	fe85fa2a62	建立 AGC 资源 kind Rust 枚举与 TypeScript 绑定 ... 新增 GameCreationAppAssetKind 及 Unknown 解析边界 通过 ts-rs 生成 shell 专属 TypeScript 联合类型 补充未知值上下文日志与 Rust/绑定生成测试	2026-09-15 16:20:52 +08:00