805 Commits

Author	SHA1	Message	Date
k88936	c38e4b4175	生成带参考图统一按编辑 concrete model 执行与计价 ... - 新增 editor_image_generation_concrete_model 作为生成类任务选择 concrete model 的唯一入口，dispatch 与计价共用同一判据 - image_generation_mud_points 增加 has_reference_images，命中编辑 concrete model 时改走 image_edit_model_mud_points - editor_project/editor_project_icon 的 provider_model 改用共享解析函数，替换三处重复的带参考图 if 表达式 - character_visual_assets 的角色主形象生成改用共享解析函数 - 图标素材图集、UI 素材提取、图标规范带 referenceId、Agent 生成类工具带 referenceImageIds 的计价同步切到编辑档 - EditImageTool 计价从生成档改为编辑档，与直连快速编辑、raw edit 对齐 - normalize_editor_generation_options 的具体 provider key 改用常量替换字符串字面量 - 补充参考图档位路由与 Agent 工具档位路由单测	2026-09-21 22:00:08 +08:00
k88936	f3c362b1ec	整体删除已退役的 gpt-image-2-c ... - 删除 platform-image 的 GPT_IMAGE_2_C_MODEL 常量、re-export、尺寸语义与审计标签 - 移除 api-server 三处任务边界对 gpt-image-2-c 的兼容解析分支 - 移除主站前端历史模型常量与恢复分支，并同步其测试 - 同步 External v1 OpenAPI 描述、ADR、CONTEXT、pitfalls 与后端/运维文档 - 数据库既有 gpt-image-2-c 审计字符串保持原样，不回写不改写	2026-09-21 20:37:43 +08:00
k88936	8988e91ee9	补全图片 provider 启动报错与日志信息 ... 缺少 BASE_URL / API_KEY 时点名对应环境变量 启动成功时记录 provider、base_url 与超时配置	2026-09-21 20:37:21 +08:00
k88936	4cbbcecaa2	减少图片工具参数归一的冗余 JSON 拷贝 ... normalize_legacy_image_model_args 改为按需返回 Cow 未命中归一时复用原始参数视图，避免多一次深拷贝	2026-09-21 20:37:21 +08:00
k88936	98bfa5efd0	按模型解析图片编辑缺失参考图的 provider ... create_openai_image_edit_with_references_and_model 错误归属与路由一致	2026-09-21 20:37:21 +08:00
k88936	ab472b4562	删除无调用方的旧图片生成封装 ... 移除 create_openai_image_generation 及其未再用到的导入	2026-09-21 20:37:21 +08:00
k88936	1a1f124acd	公开定价投影隐藏旧 GPT Image 2-C 别名 ... public_projection 同步移除 gpt-image-2-c 键	2026-09-21 20:37:21 +08:00
lhk229	a6f99c8871	Merge branch 'master' into feat/gptimage2to2.5	2026-09-21 19:47:37 +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	27e3d9bfd0	Merge remote-tracking branch 'origin/master' into feat/gptimage2to2.5	2026-09-21 14:43:20 +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
kdletters	1cb91f9444	修复画布绑定查询与生成失败归因 ... - 画布绑定前置的项目列表查询改为 view=summary，站内与外部路由统一支持摘要视图（缺省 full 兼容，未知取值 400） - 项目摘要投影收敛到 editor_project，外部 API 与 MCP 复用同一份实现，摘要不做内联媒体修复也不回传画布与全量资源 - 外部编辑器请求失败文案补 kind 语义与底层因链，区分请求超时、正文截断与非法 JSON，不拼接 URL - 远端资源编辑终态文案带出稳定失败码并指向移出恢复队列这一唯一出口，上游原文仍不写入账本 - 补齐站内摘要视图与画布测试夹具的请求断言用例 - 更新共享决策记录与踩坑记录（图集切片上限条目归上游 #442，本提交不重复）	2026-09-21 13:33:23 +08:00
k88936	3b137ca369	合并 master 并保留 GPT Image 2.5 与外置提示词行为 ... 保留编辑器图片工具使用 gpt-image-2.5 业务模型名 保留工具参数说明从 prompts 外置文件读取 同步外置模型与尺寸文案并完成冲突验证	2026-09-21 10:50:32 +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
k88936	3da0936c1f	Merge remote-tracking branch 'refs/remotes/origin/master' into feat/gptimage2to2.5	2026-09-19 15:39:41 +08:00
k88936	c8311a47b0	Merge remote-tracking branch 'refs/remotes/origin/master' into feat/gptimage2to2.5 ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # server-rs/crates/api-server/src/state.rs # src/components/image-editor/ImageCanvasGenerationSubmissionModel.test.ts	2026-09-19 15:37:29 +08:00
k88936	1c1deff732	修复编辑器 LLM mock 用例无法构造 Tiantoken client 的问题 ... - AppConfig 新增 tiantoken_base_url / tiantoken_api_key 字段，from_env 只读 TIANTOKEN_* 环境变量，不回退 VectorEngine 凭据 - AppState 改用配置字段构造编辑器 LLM 与 Tiantoken 图片 client，删除现读环境变量的 config::tiantoken_* 访问器 - editor_background_music_prompt_assist / editor_sound_effect_prompt_assist / sound_effect_translation 三处 mock LLM 夹具改用 tiantoken_* 字段，恢复 28 条失败用例 - config 用例改为断言 from_env 的 Tiantoken 凭据来源，state 用例改名为从 Tiantoken 设置构造编辑器 LLM client - 同步更新后端架构文档与 decision-log 记录	2026-09-19 15:33:14 +08:00
k88936	0459109897	修复 SpacetimeDB 定价 record 缺少历史模型回填的问题 ... - 将 backfill_legacy_gpt_image_2_5_pricing 提升为 pub(crate) 并补充文档说明其覆盖磁盘 override 与 SpacetimeDB record 两条加载路径 - editor_generation_pricing_from_record 在 validate 前先对旧 record 做受控 backfill，避免升级前只写单个 gpt-image-2 key 时被必填校验拒绝 - 新增用例覆盖旧 record 自动补齐两个 GPT Image 2.5 key，以及显式配置不被回填覆盖 - 更新兼容回填的 TODO 注释，说明移除条件还需包含 SpacetimeDB record	2026-09-19 15:18:40 +08:00
k88936	6318baf7c6	修正缺省图片模型校验用例的 fixture 模型 key ... - 将 editor_generation_pricing_rejects_missing_required_image_size 的 fixture 从已退役的 gpt-image-2 换成 gpt-image-2.5-flare-c / gpt-image-2.5-sunburst-c - 同步断言文案为 models.gpt-image-2.5-flare-c 缺少 2K 的泥点配置，使缺档校验仍覆盖真实必填模型	2026-09-19 15:17:45 +08:00
k88936	28e6e67e98	补齐后台定价保存用例的 GPT Image 2.5 档位 ... 后台保存 payload 用 gpt-image-2.5-flare-c 与 gpt-image-2.5-sunburst-c 替换历史单 key，保存重新返回 200 公开定价断言改为读取业务模型名 gpt-image-2.5 的生成档价格，并新增 admin 定价读回具体 key 的断言	2026-09-19 14:23:18 +08:00
k88936	4415723f7f	同步公开定价路由用例到 GPT Image 2.5 公开投影 ... 公开定价断言改为读取业务模型名 gpt-image-2.5 的生成档价格 补充断言公开投影不暴露 gpt-image-2 与两个 provider 具体 key	2026-09-19 14:21:33 +08:00
k88936	fa84a364d6	修正宣发素材生成锁定的模型断言 ... 源码文本断言从 Some(GPT_IMAGE_2_MODEL) 更新为 Some(GPT_IMAGE_2_5_BUSINESS_NAME)，与当前锁定实现一致 用例改名为 publication_material_generation_is_locked_to_gpt_image_2_5	2026-09-19 14:20:29 +08:00
k88936	bd0a06e3d3	兼容图片工具的历史 gpt-image-2 模型别名 ... api-server 的图片类 Agent 工具在反序列化前把 gpt-image-2 / gpt-image-2-c 归一为 gpt-image-2.5，旧持久化工具调用不再被校验直接拒绝 EditImageTool 计价改用 gpt-image-2.5 业务模型常量，并新增别名归一单测、更新受影响的校验与计价断言	2026-09-19 13:55:30 +08:00
k88936	0c54cca81c	修正生成规范缺省模型的计价档 ... spec_model_mud_points 在模型为空时显式回退 GPT Image 2.5 生成档，避免落到 nanobanana 档 补中文注释说明与 normalize_editor_generation_options 的缺省模型保持一致	2026-09-19 13:43:12 +08:00
k88936	1a2e60bf05	修复图片编辑缺少参考图时的 panic ... platform-image 新增 missing_reference_images_error 并在 create_image_edit_with_references_and_model 中复用 api-server 两个多参考图编辑入口在解析 provider 客户端前先校验参考图，返回 400 而不是 panic 恢复 vector_engine_multi_reference_edit_rejects_empty_references 期望的缺少参考图错误	2026-09-19 13:41:21 +08:00
k88936	5ce267ae85	按参考图选择角色主形象的 provider 模型 ... 角色主形象带参考图时走后端编辑端点，模型改用 gpt-image-2.5-sunburst-c 无参考图生成继续使用 gpt-image-2.5-flare-c	2026-09-19 13:37:55 +08:00
k88936	8924bf335e	修正 UI 设计素材提取的编辑模型 ... UI 设计图 spritesheet 提取走后端编辑端点，模型由 gpt-image-2.5-flare-c 改为 gpt-image-2.5-sunburst-c	2026-09-19 13:36:28 +08:00
k88936	ae257a6ff8	按端点选择编辑器生成的 provider_model ... generate_editor_image_for_owner 在参考图存在时改用 gpt-image-2.5-sunburst-c（编辑模型） 无参考图生成继续使用 gpt-image-2.5-flare-c，nanobanana 分支沿用自身模型	2026-09-19 13:36:03 +08:00
k88936	ff4f42d2f2	修正编辑器生成模型归一化注释 ... 注释改为与实现一致：未显式传模型时归一为 gpt-image-2.5，而非继续走 gpt-image-2	2026-09-19 13:35:05 +08:00
k88936	2e2ed47bec	补齐图标 spritesheet 请求的 provider_model ... editor_project_icon 的 EditorImageProviderRequest 增加 provider_model 字段 参考图存在时按编辑模型 gpt-image-2.5-sunburst-c 提交，nanobanana 与无参考图分支分别沿用自身模型	2026-09-19 13:29:11 +08:00
k88936	dedc58cce1	补齐 api-server 的 GPT_IMAGE_2_C_MODEL 重导出 ... openai_image_generation 重新导出 platform_image 的 GPT_IMAGE_2_C_MODEL 修复 editor_project 兼容历史 gpt-image-2-c 时引入的未解析导入与随之产生的模式绑定错误	2026-09-19 13:27:31 +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	1367e9c04e	兼容历史 GPT Image 2-c 提交模型 ... 读取历史 gpt-image-2-c 时按当前 GPT Image 2.5 业务任务处理 保留历史字符串不改写并沿用新的生成与编辑定价路由	2026-09-18 16:50:10 +08:00
k88936	b294cbc3db	接入 GPT Image 2.5 双 provider 启动路由 ... 启动时分别构造 VectorEngine 与 Tiantoken 图片 client 按生成、编辑和 nanobanana 模型选择具体 provider 迁移 api-server、编辑器 Agent 与 raw edit 调用方 拆分 GPT Image 2.5 生成与编辑定价并隐藏 provider 具体值	2026-09-18 16:28:45 +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