794 Commits

Author	SHA1	Message	Date
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	61fe4c48af	图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... - 后端资源投影按 asset_kind 分叉，新增 project_editor_client_media_src 与 EDITOR_MODEL3D_ASSET_KIND：model3d 只投影预览图，模型本体只留 objectKey，预览缺失才回落历史口径 - tripo3d 存储新增按字节魔数识别模型 content_type 与扩展名映射，不采信 provider 声明与下载响应头 - editor_project_storage 把 model3d 加入 EDITOR_CANVAS_ASSET_KINDS 白名单 - 前端 CanvasAssetKind 与 image-canvas-core 类型新增 model3d：画布卡片渲染预览图或 3D 占位，类型角标新增「3D模型」，覆盖资格只在它与空类别之间成立 - 新增 model3d-preview 子目录（Model3dViewerModal / Model3dViewerModel），Tailwind 内联、不新增 CSS，失败原因分超限 / 格式不可识别 / 无 WebGL2 三类展示 - 选中工具条新增只读 preview-model3d 能力位，仅 objectKey 为空时置灰；打开预览同时选中图层并暂停画布快捷键与舞台交互 - 查看器包源对象 format 改为可选，新增「声明 Content-Type → 字节魔数 → 地址扩展名」三级格式判定并导出支持格式清单 - 导出工作流新增 3d_models/ 目录，模型下载按真实响应头 MIME 定扩展名、对象键扩展名兜底 - 新增 3D 生成入口：底部工具栏浮动子选项与文生 / 图生 3D 面板，落 projectResource + canvasCompletion，复用占位框与任务侧栏 - 3D 定价只读实时定价查询，段缺失即入口不可提交；幂等键由前端铸造，用户重试必须换键 - 新增 ADR 0003 / 0004 与实施计划、里程碑文档；更新 Tripo 技术方案、后端架构、CONTEXT 术语、decision-log 与 pitfalls - .gitignore 忽略仓库根目录手工下载的 3D 样例模型	2026-09-22 10:10:00 +08:00
k88936	9fc55a5cac	写入Tripo 3D泥点默认价并锁定credit换算口径 ... - 受控默认配置新增 model3d 段：底价按端点 × 模型版本 × 是否有贴图，add-on 六项独立计价 - 换算口径固定为泥点 = ceil(0.8 × Tripo 官方 credit)，H 系列 10/20 与 20/30、P1 30/40 与 40/50、P2 100/110 - editor_generation_config 定向用例按 credit 表反算默认泥点价，改价必须先改 credit 表 - 段缺失语义改为显式摘段验证，仍保持 fail closed 不扣费不入队 - 主规范、里程碑、实施计划与定价管理方案同步默认价已确认与部署侧 override 风险	2026-09-21 22:07:55 +08:00
k88936	2691ca8aca	补记图生输入的OSS直读待讨论项 ... - api-server 的 image_source 模块头与 platform-tripo 的 upload_image 各留一条 TODO(oss-direct-read)：交签名 URL 或对端直读 OSS 能省掉字节中转，但把私有对象与带时效凭据交给第三方，安全口径与可行性待讨论 - 技术方案文档把图生输入口径更新为当前的 source 站内引用 tagged enum，并补同一条待讨论说明 - 讨论清楚之前保持「api-server 自己读、自己传」的现口径，不改行为	2026-09-21 20:02:18 +08:00
k88936	609b24c779	text-to-model入口的submit改名带端点 ... - TripoProviderClient::submit 改名为 submit_text_to_model，与 submit_image_to_model / submit_multiview_to_model 一致 - 同步 api-server tripo3d worker 与 tripo_generation_smoke example 的调用点 - 同步技术方案文档里写死的 submit 口径，方法名不再与另两个入口分叉	2026-09-21 19:49:31 +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
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	c5afc02e94	模板正文目录门禁：CLI 打包与后台上传统一拒绝身份/版本库/依赖/构建目录 ... - scripts/agc-template-library-publish.mjs：readProjectFiles 增加正文门禁，任意层级拒绝 .agent/.git/.svn/node_modules，根目录拒绝 dist/build/library/temp/local/.idea/.vscode - scripts/agc-template-library-publish.test.mjs：新增夹具源目录与门禁用例，覆盖 13 条拒绝路径及 game/dist/**、game/.gitignore 放行 - server-rs/crates/api-server/src/admin_templates.rs：上传归档校验与 CLI 用同一份段名单，新增 template_import_archive_rejects_identity_and_build_directories - docs/【模板规范】AGC模板包组织指南-2026-09-21.md：已知边界改为「已有机器门禁」，并说明同名目录段只在根目录受限 - docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md：CLI 与后台上传的校验口径补门禁，并追加 2026-09-21 证据（九个模板本地重打包摘要与线上清单逐条一致） - docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md：验收标准 2 补充门禁证据 - docs/project-memory/shared-memory/decision-log.md：新增 2026-09-21 正文目录门禁决策记录	2026-09-21 16:25:35 +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	c0fcb8553d	补Tripo worker纯逻辑定向用例 ... - checkpoint 只在 provider task id 非空且去空白后有效时才算存在，空白等同未提交 - 完成结果按端点严格区分，且序列化后不含 provider、taskId 与带签名的临时地址 - 预览图尺寸必须能真实解码，损坏字节直接失败而不是写占位宽高 - 预检用例去掉多余的通配导入，实施计划进展同步当前通过数	2026-09-21 15:22:01 +08:00
k88936	f732555a44	为Tripo提交路由补应用级验收用例 ... - 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404 - 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400 - 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段 - 实施计划进展补记该组用例与当前全量测试通过数	2026-09-21 15:16:22 +08:00
k88936	eb4256f883	图生3D图片引用改为提交时定点预检 ... - image_source 拆成预检与执行两条路径，预检只做归属、记录类型与对象键校验，不读正文也不调用 provider - 定点解析改用既有 resolve_editor_reference_record_by_id_for_owner，取代列工程与读素材库的宽查询 - image-to-model 路由在扣费与入队前调用预检，跨 owner、未登记、已删除与 kind 不符统一返回 400 - editor_project 把定点引用查询暴露为 crate 内可见，供生成入口复用 - 新增源码钉住用例，防止预检退回宽查询或提前读图片正文	2026-09-21 15:08:46 +08:00
k88936	02ef84d9b6	清理Tripo3D新代码的死代码与无意义断言 ... - 删除 job.rs 中无调用的 is_model3d_job_kind、source_entity_id 与本地 target_source_entity_id - 删除 artifacts.rs 中未被引用的 map_artifact_error 及其 TripoError 导入 - 删除未被引用的 MODEL3D_JOB_MAX_ATTEMPTS 与只被同文件测试断言的 queue source module 常量 - 删除对常量自身取值的恒真断言测试	2026-09-21 14:45:04 +08:00
k88936	29e554a30c	新增api-server Tripo3D worker执行链路与结果落库 ... - 新增 artifacts/result/worker 三个文件：产物读取、严格结果构造与 at-most-once submit 执行链路 - 没有 checkpoint 才 submit；submit 成功后先落 checkpoint 再轮询，checkpoint 写入失败按终态失败，不退回可重试队列 - 模型与预览图分别写入 OSS 并按 operation 稳定 ID 登记 asset_object，预览对象单独登记以便按对象键解析归属 - 落点按 target 分支写入项目资源或账号素材，imageSrc 与 thumbnailSrc 指向预览图，模型本体留在 objectKey - 画布回填只走 placement-only；新增只依赖资源身份与尺寸的占位条目构造函数供 3D 复用 - 标准消费者的队列结果透传调用方显式给出的 result，使 3D 完成结果可从既有任务查询返回 - external_generation_worker 增加两个 job kind 分支并纳入长任务超时，用户可见失败文案收敛为稳定文本	2026-09-21 14:36:59 +08:00
k88936	e809cdd850	新增api-server Tripo3D图片输入解析与产物对象写入 ... - editor_project 暴露按注册 ID 定点解析资源与素材对象键的入口，只认本账号已登记记录 - image_source 把站内引用解析成对象键后读字节并上传 provider 换 file_token，不把签名地址交给第三方 - storage 负责产物 PUT、HEAD 复核与 asset_object 登记，模型与预览图共用同一条链路 - asset_object ID 使用 operation 稳定派生值，避免被生成结果事务的白名单校验拒绝 - 完整字节写入路径留 TODO，等待 platform-oss 提供流式上传	2026-09-21 14:24:41 +08:00
k88936	4edeadae7d	登记Tripo 3D的生成结果operation_kind白名单 ... - SpacetimeDB storage 的编辑器生成白名单加入 model3d_text_to_model 与 model3d_image_to_model - 白名单是原子落库的 operation_kind 门禁，未登记会让整笔结果事务被拒 - api-server 侧按源码钉住两个 job kind 已在白名单内，避免只在运行期才发现	2026-09-21 14:02:58 +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	dd8f48bad9	新增api-server Tripo3D提交路由与入队 ... - tripo3d 目录按 job 身份、provider 配置、错误映射、入队与路由拆分小文件 - 两个内部路由要求 Bearer 与 Idempotency-Key，顺序固定为解析、组合校验、查价、入队 - 入队复用编辑器生成队列的幂等 dedupe key，同键同请求返回原 operation，同键不同请求 409 - Tripo job 走既有 editor-canvas 来源与单次尝试口径，不新建队列、不新增状态 - 提交响应返回 operation、job kind 与既有任务查询状态地址，不暴露 provider 信息 - 补齐 ExternalGenerationJobRecord 测试夹具新增的 checkpoint 字段	2026-09-21 13:46:41 +08:00
kdletters	1cb91f9444	修复画布绑定查询与生成失败归因 ... - 画布绑定前置的项目列表查询改为 view=summary，站内与外部路由统一支持摘要视图（缺省 full 兼容，未知取值 400） - 项目摘要投影收敛到 editor_project，外部 API 与 MCP 复用同一份实现，摘要不做内联媒体修复也不回传画布与全量资源 - 外部编辑器请求失败文案补 kind 语义与底层因链，区分请求超时、正文截断与非法 JSON，不拼接 URL - 远端资源编辑终态文案带出稳定失败码并指向移出恢复队列这一唯一出口，上游原文仍不写入账本 - 补齐站内摘要视图与画布测试夹具的请求断言用例 - 更新共享决策记录与踩坑记录（图集切片上限条目归上游 #442，本提交不重复）	2026-09-21 13:33:23 +08:00
k88936	d012392779	api-server 增加 Tripo 生成的环境配置 ... - AppConfig 新增 tripo_base_url / tripo_api_key / 请求超时 / 重试四个字段 - 默认网关指向 Tripo 官方 v3 地址，可由 TRIPO_BASE_URL 覆盖 - 环境变量沿用 provider 示例的 TRIPO_* 口径，API Key 缺省为空 - 默认值断言补进配置测试	2026-09-21 13:23:18 +08:00
k88936	e105e34f83	新增Tripo生成请求的平台组合校验 ... - 价格相关参数必须显式给出，texture 与 textureQuality、pbr 不能互相矛盾 - 目标落点与图片引用的 ID 不能为空白 - provider 能力组合规则复用 platform-tripo 预检，不维护第二份 - 校验结果直接产出定价输入，路由在扣费与 provider 调用前执行 - api-server 依赖 platform-tripo	2026-09-21 12:53:22 +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	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	623e007fae	完善客户端发布渠道并接入模板库灰度 ... 区分发布渠道与系统，支持 dev、release 和自定义渠道 允许网站通过服务端配置选择客户端下载检测渠道 接入模板库灰度权限并阻断退出和切号后的异步操作 补齐发布、下载、灰度与会话竞态测试及当前规范	2026-09-20 12:12:49 +08:00
kdletters	15774a1c02	修复项目自动上传并增加后台完整工程下载 ... 接入真实项目打开、切换和关闭生命周期并修复退出等待竞态 新增后台项目列表及按原目录校验导出的 ZIP 下载 补充快照完整性元数据、后台权限和取消清理 固定默认 AGC 存储目标并支持空文件与特殊字符路径 补充自动化测试及真实 OSS 只读导出验证 记录本地数据库 404 导致完整 HTTP 联调和安装版实机验证待补	2026-09-20 10:07:31 +08:00
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +08:00
kdletters	5bf036bb81	收敛后端依赖装配与鉴权并完善异步追踪 (#425) ... HTTP 请求取消后，在途计数原先无法释放；项目元数据和 External API 鉴权依赖完整 AppState，相同鉴权和追踪配置也散落在多个入口。本次集中装配这些依赖和横切能力，保持现有公开 API、权限、计费、幂等和事务规则。 ## 修改 - 91 个受保护路由集中应用鉴权；保留方法级 404/405/HEAD/Allow、公开入口、MCP、精选缓存头及 2/4 MiB 请求限制。 - 七个项目元数据入口改用缓存的 EditorProjectState，External/MCP 鉴权改用 ExternalApiAuthState；生产实现复用 SpacetimeClient，媒体修复维持原有上传和登记顺序。 - RAII 覆盖请求 Future 取消和 panic unwind 的计数清理；正常与降级服务复用 TraceLayer，指标采用 MatchedPath 模板及固定兜底。 - LLM 普通与流式调用增加跳过参数的异步 span，保持父上下文、流式回调、错误与重试行为；补充替代依赖测试并同步锁文件和文档。 ## 验证 | 验证面 | 结果 | | --- | --- | | platform-llm 完整本地回归 | 161 个单元测试、3 个集成测试通过；1 个真实 Provider 用例按原配置忽略 | | api-server 完整回归 | 执行时 1075 通过、12 失败、6 忽略；其中 1 个新增公开读取 fixture 断言已修正，14 个路由契约回归随后全部通过；剩余 11 个是下述既有 Windows 失败 | | 窄依赖、取消与追踪 | 元数据 owner/幂等/revision、鉴权及 MCP 错误传播、取消/panic/流式响应、追踪父子关系与敏感参数省略均通过 | | 实际本地服务 | 独立 SpacetimeDB 上 102/102 检查通过，两个动态项目 ID 的路由模板及请求 ID 日志核验 3/3 通过 | | 编译与边界 | api-server cargo check、AGC 锁文件下 platform-llm cargo check、rustfmt、编码、文档索引、DDD 与 diff 检查通过 | | 合入最新 master 后 | 后端源码及锁文件保持已测内容；再次通过 14 个路由契约测试、3 个 Provider 追踪测试及编码/文档/DDD/diff 检查 | 实际服务检查覆盖 health/ready、两账号登录、项目 CRUD、幂等重复、跨 owner 拒绝、revision 冲突、External/MCP 读取、Key 撤销及 404/405。使用既有 test 环境的本地 Router 拒绝 fixture，未调用真实付费 Provider；自建服务已关闭，原开发实例保留。 ## 已知测试限制 API 全量测试尚未全绿：11 个 wallet_refund_outbox 用例在 Windows 的目录同步处失败。其生产文件与变更前内容一致；标准库隔离复现确认 File::open(目录) 返回 OS 5，而普通文件写入、同步及 hard_link 正常。这个已有的目录持久化问题未混入本次重构，也未通过跳过或弱化相关断言掩盖。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/425	2026-09-19 12:29:19 +08:00
k88936	0d5940433d	删除资源 kind 兼容白名单 ... 服务端图片快速编辑改用共享枚举静态图片判定 移除退役 kind 的兼容放行与冗余回归测试 清理客户端恒假 art-spritesheet 判断并统一远端 kind 解析 同步 AGC kind 里程碑、实施计划与决策记录	2026-09-18 17:09:36 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
lhk229	195b7dd5dd	修复抠图401 404问题 (#394) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/394 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-17 21:37:23 +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
kdletters	fc14190f58	图集切片模式改为必须显式声明并补齐决策要求 (#408) ... ## 背景 切图新增基于连通域的切分后，LLM 仍倾向显式传 `sliceMode=grid`：参数只存在于部分 LLM 可见面、带默认值、没有任何决策规则，生成结果也不回显生效模式。 ## 变更 - 平台：`/api/editor/icon-spritesheets/generations` 与 `/api/external/v1/editor/icon-spritesheets/generations` 把 `sliceMode` 改为必填并移除默认值；缺失、空白或未知取值在引用解析、定价与任何 provider / OSS 副作用之前返回 `400`，错误统一带 `field` 与决策要求。 - 契约：`grid` 必须同时提供 `gridX`/`gridY`，`connected-components` 不接受网格尺寸；`sliceCount` 只约束连通域切分，请求与响应的公开上限统一为 `256`；OpenAPI 去掉默认值并补必填与失败语义。 - AGC：MCP 工具说明去掉默认值并补决策要求，桥接层新增可测试的切分声明校验；原生工具 `canvas.asset_generate` 暴露 `sliceMode/gridX/gridY/sliceCount` 并要求图集显式声明；生成结果回显 `sliceMode/gridX/gridY` 与 `slicePaths`；严格图集在本地提交前校验平台回显与请求声明一致。 - 标准美术包：显式声明 `connected-components` 加 `sliceCount=4`，并在四张 canonical 切片用途映射前校验数量，禁止截断或错位。 - 前端与画板：画板 Agent 工具装配与画板提交计划显式声明连通域切分；前端类型要求显式 `sliceMode` 并在本地校验声明自洽。 - 文档与 Skill：主规范、OpenAPI、AGC Skill、外部编辑器 Skill、里程碑与实施计划、共享决策记录同步更新。 - 测试环境：测试构建对提权 Windows 主机上系统临时目录的所有者偏差做一次性所有者初始化重试，临时目录之外的越权所有者继续失败关闭。 ## 兼容性影响 省略 `sliceMode` 的旧调用方（含已发布但未更新的 AGC 客户端与第三方外部 API 调用方）会在图集生成上收到 `400`；这是本次"不允许默认值"的预期结果，仓库内自有调用方已全部改为显式声明。 ## 验证 - 平台：`slice_mode_must_be_declared_*` 与 OpenAPI 契约测试通过；全量 `cargo test -p api-server` 1043 通过 / 11 失败（`wallet_refund_outbox` 临时文件 `拒绝访问`，已在改动前基线复现，属本机环境）。 - AGC：`slice` 30、`spritesheet` 21、`direct_tools_mcp` 23、`agent_native_tools` 16、`canvas_generation_tests` 83、提示词上限与桥接门禁各 1 条、`cargo check --tests` 全部通过。 - 前端：182 条定向测试与 `typecheck` 通过。 - 门禁：`cargo fmt --check`（两个 workspace）、`check:encoding`、`check:doc-index`、`git diff --check` 通过。 - 未验证：真实 Provider 与浏览器试玩、确定性 e2e 车道；整机全量 AGC 单进程运行在本机受提权 shell 的所有者与时序问题影响，不作为门禁信号。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/408	2026-09-17 18:10:34 +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
lhk229	9b6ed8a4cf	整理抠图测试导入并明确对外说明边界 ... 将主站与客户端抠图测试模块的导入统一放到模块顶部 明确 provider 选择与兜底策略仅保留在内部技术方案中	2026-09-17 00:54:28 +08:00
lhk229	16deb0ad61	补齐抠图参数透传与验收 ... 修复flat自动识别门禁并严格校验模式和颜色 保持旧请求幂等指纹并区分客户端抠图意图 同步工具说明和Skill契约并补充定向测试 记录真实BgFilter验证及本地数据库阻塞的待验收项	2026-09-17 00:54:28 +08:00
lhk229	ca761e093c	接通抠图模式到BgFilter队列 ... 透传backgroundMode和screenColor到内部worker 保留auto及省略颜色的下游识别语义	2026-09-17 00:54:28 +08:00
lhk229	a17367112f	增加主站抠图参数归一化 ... 缺省模式兼容为complex并校验颜色格式 将auto颜色原样保留给BgFilter	2026-09-17 00:54:28 +08:00
lhk229	d7a0c3cffd	扩展主站抠图请求契约 ... 增加backgroundMode和screenColor可选字段 同步External v1 OpenAPI抠图模式说明	2026-09-17 00:54:28 +08:00
kdletters	479120d368	修复刷新轮换竞争被放大成登出 ... - refresh 接口的轮换失败不再下发清空 refresh cookie 的响应，避免删掉并发请求刚写入的有效 cookie - 缺少 refresh cookie 的失败保持无副作用，cookie 失效只由吊销、过期或身份变更决定 - 网站前端在刷新返回 401 时先用当前 cookie 收敛重试一次，重试仍被拒绝才判权威失效 - 网站前端只在当前鉴权代次未变化时重试刷新，避免旧账号结论污染新代次 - 更新 api-server 与前端断言，覆盖轮换竞争与收敛重试两条路径	2026-09-16 17:08:47 +08:00
Git Hooks Test	0ce5eb35b0	提升图集切片上限并保留原始告警 ... 图标图集自动、手动和网格切片上限统一提高到 256。 同步 SpacetimeDB 批次与生成结果 item 上限，覆盖 256/257 边界。 严格图集提交校验透传 sliceWarning 原始原因，避免通用文案覆盖根因。 补充 Rust 定向测试、文档和共享决策记录。	2026-09-16 01:06:34 +08:00
kdletters	dd24690b02	新增图集连通域与可配置网格切分 ... 增加 connected-components 与 grid 切分模式 支持 gridX/gridY 并同步 API、MCP、Skill、AGC 客户端 移除固定 2x2 图集切分契约与文档	2026-09-15 20:06:36 +08:00
kdletters	29e84a77d1	切换 Tiantoken 并删除旧 Vidu 音效 ... 新增 TIANTOKEN_BASE_URL / TIANTOKEN_API_KEY 配置并切换文本与图片链路 保留 Suno VectorEngine 路径，删除旧 Vidu submit/poll/builder 实现 同步脚本、文档、测试与运行时 provider 路由	2026-09-15 19:43:35 +08:00
lhk229	9aa6f5efea	解决platform-llm和策划agent reasoning问题，并修复若干bug (#350) ... Reviewed-on: #350	2026-09-15 00:50:36 +08:00
k88936	513c25898c	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation ... # Conflicts: # apps/ai-game-creator-shell/src/view/project-development/index.tsx	2026-09-14 11:32:17 +08:00
k88936	462fc856aa	为原始图片上传解析增加超时 ... 从请求入口开始计算准备截止时间，并限制 multipart 上传解析阶段的最长等待。	2026-09-12 21:33:48 +08:00
k88936	274bb1a3d2	兼容带参数的 PNG 内容类型 ... 解析 multipart Content-Type 的媒体类型部分，接受合法的 image/png 参数。	2026-09-12 21:33:06 +08:00
k88936	a19684a5f5	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-12 19:46:41 +08:00
suzmii	9835bbec9f	修复 PR316 review：shared-contracts 资产级失败关闭 + 快速编辑别名白名单 ... - server-rs/crates/shared-contracts/src/game_creation_app.rs:517 [bug high] 资产级 wire 结构补 deny_unknown_fields：与顶层 GameCreationAppManifest 同一取向，避免「读一次 + 任意一次写」静默抹掉未来新增的 assets[i] 字段；新增契约测试 asset_manifest_entry_rejects_unknown_asset_fields（裸条目 + 顶层 manifest 两条读路径都失败关闭，且已知字段照旧往返）。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:536 [bug medium] 未知 category 从「退回 kind 派生值」改为失败关闭：反序列化结果就是落盘原值、要被整结构体写回，静默替换等于无迁移改落盘数据；缺字段仍按 kind 派生，派生只保留在 game_creation_app_asset_effective_category；原用例改名重写为 asset_manifest_entry_keeps_explicit_category_and_rejects_unknown_category。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:780 [test low] 分区顺序跨语言交叉校验：packages/shared 侧新增解析 Rust PROJECT_RESOURCE_CANVAS_SECTIONS 并与 TS 常量对齐的测试（TS 侧补，见后续提交）。 - server-rs/crates/api-server/src/editor_project.rs:4120 [bug medium] 静态图别名白名单补 "asset"（register_local_asset_entry 空 kind 兜底值，canonical 映射到 image），数组长度 17→18，并在用例里补放行/拒绝两条断言。 - server-rs/crates/api-server/src/editor_project.rs:20747 [test low] AGC 快速编辑回归用例不再自洽：agc_payload 真正反序列化成 EditorImageEditRequest 并由请求体自己的 generationInputs.assetKind 驱动判据，另加源码级闸门断言（resolve_editor_image_edit_source / ensure_editor_image_edit_target_matches_source 体内不得再出现 generation_inputs）。 - TS 侧 gameCreationApp 的口径注释同步为「非法值这一支已不可达」（见后续提交）。	2026-09-12 19:43:19 +08:00