2992 Commits

Author	SHA1	Message	Date
k88936	e7b067e977	恢复合并时丢掉的 AGC 壳依赖 codex-patch-parser 与 chrono ... - apps/ai-game-creator-shell/src-tauri/Cargo.toml：[dependencies] 补回 master 侧新增的 `codex-patch-parser = { path = "vendor/codex-patch-parser" }` 与 `chrono = { version = "0.4", default-features = false, features = ["std"] }`（冲突解决时随同段落的 ts-rs 一起被丢掉，导致 src/agent/direct_patch.rs 与 src/agent/direct_codex_audit.rs 报 8 条 E0433 / E0432） - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按清单恢复 genarrative-ai-game-creator-shell 条目里的 chrono 与 codex-patch-parser 依赖 - docs/project-memory/shared-memory/pitfalls.md：新增 2026-09-22 条，记录「合并后 CI 报 cannot find module or crate 先查对方新增的依赖行」的判据与踩坑点 - docs/project-memory/shared-memory/decision-log.md：在 2026-09-22 合并条目补记这次丢依赖与验证 验证：cargo metadata --locked（AGC workspace）、cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --no-run（bin + 4 个集成测试目标全部编译）、cargo check --locked --workspace --manifest-path server-rs/Cargo.toml、npm run check:native-shells:agc-rust-crates、npm run check:encoding、npm run check:doc-index、git diff --check	2026-09-22 13:13:00 +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	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	19e1883f71	合并 origin/master：策划附件导入接入策划聊天入口 ... - 保留 DirectProject 独立聊天容器与 Supervisor 退役结果，不为冲突恢复运行时兼容分支 - 策划工作区文件导入接入 PlanningChatView 输入盒，导入期间暂缓发送、阶段批准、澄清与重试 - 工作台壳按项目记录导入进行态，导入未完成时不切换游戏运行态并提示等待 - 首页策划附件导入结果落到工作台 fileImportNotice 提示条，可单独关闭 - 设计态输入盒样式选择器由 project-supervisor-* 收敛为 project-chat-* - 策划导入回归用例适配退役后的 harness 与 chatProps 命名	2026-09-22 02:24:47 +08:00
k88936	5315b233c8	预览激活回接「运行」入口，聊天 @ 清单打开选择器时按需重读 ... - App.tsx 新增 activateRunningPreview，运行入口先问 Rust 要活体预览（activate_local_game_preview），命中就只切客户端运行视图 - App.tsx 的 executeRunLocal 命中活体预览时经 DirectProject 聊天的 announce 播报「已切换到客户端运行视图」，不再重复调用 start_local_game_preview；stopped / 非本项目 / 权限位要求确认一律回落到重新启动 - check-config.mjs 从 native-only 白名单移除 activate_local_game_preview 并同步注释（该门禁要求 App invoke 与白名单互斥） - DirectProjectComposer 新增 onReferencePickerOpen，工具条按钮与附件菜单两处选择器入口打开前先刷新清单 - DirectProjectChatView 用 useDirectProjectManifest 的 refresh 重读聊天自己那份 @ 清单，不新增壳到聊天的清单推送通道 - 新增 tests/previewActivation.test.tsx，钉住切视图不重启 / stopped 回落重启 / 权限确认回落重启三条路径 - decision-log 记录本轮两处回归的背景、决策、取舍与验证方式	2026-09-21 23:09:43 +08:00
k88936	a11cdf13d7	画布生成面板重开草稿与重试身份收敛到 canonical content ... 生成面板 state、重开草稿、重试身份与提交载荷统一为一份 content[] 重试身份改用 directCodexContentKey 内容指纹比对并删除 referenceIdsMatch directCodexContentToLegacyContentDto 只在任务落账的出站边界派生 账本回到草稿的反向翻译收敛为 legacyContentDtoToContent 单一实现 token 扫描从 ResourceReferenceInput 提到 resourceReferences 并两处共用 无法解析的资源引用合成 unknown 占位而不再静默丢弃 出站提示词规范化收敛为 resourceCanvasAssetGenerationPromptText 供两处共用 directCodexContentToPromptText 去掉 trim，空白只在整条 content 上判定 同步决策记录与 canonical content 里程碑落地结果	2026-09-21 22:56:32 +08:00
lhk229	085181c795	修复策划附件导入工作区并解除资源清单耦合 ... 新增策划工作区文件导入命令，支持同名另存并保留文件字节 首页和聊天框附件直接导入策划工作区，脱离游戏资源清单与回合附件 导入期间暂缓发送、阶段操作和游戏制作切换，保留逐文件失败提示 补充导入、刷新与切换回归测试，同步技术方案和共享约定	2026-09-21 22:49:21 +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	8968762274	合并 origin/master：DirectProject 输入校验取回空白片段回归用例 ... - validation.rs 保留本分支的 content_has_meaningful_input 与 Skill/附件独立上限，空输入报错取回 master 的用户可见文案“聊天内容不能为空” - wire.rs 取回 master 新增的 text_projection / user_input_rejects / valid_references / nonempty_text 四条回归用例，测试导入合并两侧 - resourceReferenceInput.test.tsx 取 master 的注释口径：草稿 text 投影会 trim，提交用的 content 保留 chip 后的分隔空格 - pitfalls.md 与《AGC聊天素材引用》改为「任意非文本 part 均算有效内容」，与四类引用的实际校验对齐 - 本地私有改动的 .env 不进入本次合并	2026-09-21 21:42:41 +08:00
k88936	7745264990	同步canonical content里程碑落地结果与润色口径 ... 里程碑与实施计划状态改为 implemented 记录润色按 token 原位恢复引用与附件、被改写 part 末尾补位 记录遗留 TODO：润色删掉 token 时无法反推原位置	2026-09-21 21:23:17 +08:00
k88936	6981648796	合并 origin/master：Supervisor 永久退役，项目对话收敛为 DirectProject 与 Design Agent ... - 解决 refactor/split-direct-project 与 origin/master 在 App.tsx、立项策划聊天视图、Direct composer/引用输入区、styles.css、Rust direct user item 与 appSurface 用例上的冲突，按「Supervisor 永久退役」口径保留 DirectProject 独立聊天容器与 Design Agent 两条产品路径 - 采纳 master 的策划 Agent V1/V2 退役：删除 GDD 审批卡、策划输入卡、planningLane、planningSessionV2、planningSessionContract、规划展示适配与 Rust planning_*_v2 命令、模块、契约及对应用例，不保留兼容别名或双跑路径 - 把 master「折叠思考显示单行预览」的目的落到当前结构：新增共享表现 chat/components/AgentReasoning/AgentReasoning.tsx（折叠态单行纯文本预览 + 箭头、展开态安全 Markdown），DirectProject 回合与策划回合共用，删掉两处写死的 pre 折叠实现 - 把 master「策划入口可选模型 / 推理档」的目的接到当前策划输入盒：复用 ConversationModelSelect 与 ComposerReasoningEffortSelect，配置写回仍走客户端配置通道 - App.tsx 删除只服务退役 Supervisor / 策划 V2 的 state、ref、effect、回调与死参数，并删除两条读路径都退役后的 workspaceProjectKind；openWorkspace 的工程类型入参保留为未使用契约 - Rust 侧保留本分支 canonical→wire 投影、无审计 Direct 回合与 direct user item 严格校验，并入 master 的 prepare_new_web_project_at 前置复核 - 更新 ADR 与 shared-memory 决策记录：策划当前只有 Design Agent、两条路径的共享表现清单，以及本次合并的口径、代价与验证证据 - 验证：AGC 与仓库 typecheck、check:encoding、check:doc-index、git diff --check、改动文件 eslint 0 error；AGC vitest 168 个文件中除 5 个 jsdom localStorage 环境失败文件与本分支既有 resourceTagStatsRefresh 失败外全绿，appSurface 198 passed / 13 skipped；Rust 定向用例 direct_codex_user_item、skill_pack、sessions 全过（整套分片在本容器受 /sbin -> usr/bin 触发沙箱预检失败，与本合并无关）	2026-09-21 21:09:34 +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	14066eea11	产物下载改为按「无数据推进」判超时 ... - artifact reqwest client 不再设包含响应体的总超时，改成 connect_timeout + read_timeout（reqwest 0.12 的「每次读操作」语义，读完自动重置） - 响应头之前没有数据推进时用显式 tokio::time::timeout 兜住，避免连上却不返回响应头时无限挂住 - 新增 TripoProviderClient::artifact_stall_timeout 统一承载三处预算，取值沿用 TripoSettings::request_timeout - 补 3 个 mock TCP 用例：响应头一直不来、传输中途断流按无数据推进失败，慢速但持续的下载必须完整收完（后者能拦住「改回总超时」的回归） - 同步技术方案与后端架构文档里的下载超时口径	2026-09-21 19:54:57 +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
lhk229	e2bdb1105b	合并最新 master 到图片生成 CI 修复分支 ... 合入最新 master 的客户端图标素材描述修复 保留图片生成通知测试的宿主执行会话初始化与失败断言	2026-09-21 11:20:53 +00:00
lhk229	71f5f36764	修复图片生成通知测试缺失宿主执行会话 ... 复用真实宿主执行会话与交付合同夹具，补齐 Direct 工具桥测试前置状态 保留图片资源提交后的刷新通知断言，并核对空提示词拒绝原因 同步更新图片生成集成测试初始化说明	2026-09-21 11:15:39 +00:00
lhk229	f71361c292	修复客户端图标素材生成丢失用户描述 (#450) ... 删除图标生成的固定提示词包装、默认美术说明和两次截断 按服务端单条描述语义校验非空及200个Unicode字符，超限拒绝并保留原文 保留内部换行，直接以单条iconDescriptions提交用户描述 更新前端、原生入口和实际HTTP请求回归测试 同步工具说明、生成契约及项目排障文档 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/450 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-21 19:12:35 +08:00
lhk229	6e9e7edcf8	修复回显测试身份数据与 Linux 条件编译 ... 按实际用户输入生成 SHA-256 请求摘要，保留回显去重与历史记录断言 保留 Windows 安装身份辅助函数的平台限制，补齐两处 AppData 调用分支的条件编译 同步 Direct 回合测试与安装路径策略文档	2026-09-21 10:59:28 +00:00
lhk229	480fe995ed	Merge remote-tracking branch 'origin/master' into codex/fix-agc-command-runtime-ci	2026-09-21 10:43:06 +00:00
lhk229	afd5b8d91f	修复 Linux 命令执行将孤儿僵尸误判为未回收进程 ... 命令主进程退出后区分存活成员与僵尸成员，保留进程组身份校验和失败关闭语义 处理 procfs 扫描期间进程退出及非 UTF-8 进程名，空进程组直接返回 新增隔离 subreaper 回归测试并补全命令 observation 断言诊断 同步 Runtime 技术方案与共享排障记录	2026-09-21 10:30:41 +00:00
kdletters	c60d116af0	合并 codex/agc-godot-templates-20260921 到 master：新增 Godot 模板与按模板建项分流 ... - 新增 Godot 模板源 godot-empty-2d / godot-empty-3d / godot-hello-world / godot-platformer-2d - 按模板建项新增 Godot 分流：改写 project.godot 的 config/name 后走既有 Godot 导入并写入相对根 - Godot 工作区发现放宽：一层多命中按目录名排序取首个，project.godot 允许链接，内置插件行去掉手动启动 - 解决 decision-log.md 冲突：保留渠道安装身份与项目快照按渠道分区两条记录，并合入 Godot 两条记录	2026-09-21 18:17:33 +08:00
kdletters	34b1ad5d5c	新增 Godot 模板并补按模板建项的 Godot 分流 ... - 新增 4 个仓库内手写 Godot 4.7 模板源：godot-empty-2d、godot-empty-3d、godot-hello-world、godot-platformer-2d，entry 统一为 project.godot，各自带 meta.json 与 960×540 封面 - template_library.rs：复制模板后按 project.godot 识别 Godot 模板，改写工程显示名后走既有 Godot 导入并写入 godotProjectRoot，不再落到 Web 占位入口 - manifest.rs：新增 apply_godot_project_display_name，只改 [application] 段的 config/name 一行，其余字节逐字保留 - manifest.rs：放宽 Godot 工作区发现，一层子目录多命中按目录名排序取第一个，project.godot 允许是符号链接 / reparse point / 硬链接 - commands.rs：同步 Godot 导入错误文案，去掉「普通文件」限定 - RuntimeConfigDialog.tsx：内置插件行去掉手动启动 / 停止按钮，启动由前端自动启动承担、停止走该行启用开关 - import_tests.rs 与 tests/project.rs：补显示名改写、多命中确定性、链接标记与错误文案的定向回归 - 同步更新 PRD、模板包组织指南、模板库与模板建项技术方案、AGC Godot 编辑器插件接入方案、实施计划与共享决策记录	2026-09-21 17:25:34 +08:00
kdletters	c52e0814d6	AGC渠道安装身份隔离：不同渠道包体可在同一台设备并存 ... - 新增 channel-identity.mjs 单点定义渠道安装身份，默认渠道保持基线 productName 与 identifier - build-release.mjs 渠道 --config 同批注入 productName、identifier 与 updater 端点 - build-macos-ci.mjs 按发布渠道解析产品名，派生 .app、updater 归档与 DMG 名称 - main.rs 与 windows.rs 窗口标题取构建期产品名，同机并存的渠道客户端可区分 - config.rs 提权 ACL 的 managed 范围按目录名识别基线目录与渠道派生目录 - check-config.mjs 断言基线等于默认渠道身份且非默认渠道身份必须隔离 - build-release.test.mjs 与 prepare-macos-codex.test.mjs 补齐渠道身份与渠道首装包用例 - 更新 AGC 更新主规范、开发运维文档、共享记忆与渠道安装身份隔离的里程碑与实施计划	2026-09-21 17:06:03 +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
lhk229	8520b50c81	修复游戏智能体输入含空白片段时被误判为空 (#449) ... 改为按整条消息判断有效内容，保留空白文本片段及两类引用的原有校验 补充多行文本、纯引用、全空白输入及非法引用的定向回归测试 同步素材引用文档、共享排障记录和过时测试注释 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/449	2026-09-21 16:36:59 +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	b5e1c0f1d6	新增模板包组织规范并接入文档索引 ... - 新增 docs/【模板规范】AGC模板包组织指南-2026-09-21.md：ZIP 根目录契约、html 与 Cocos 工程的建议结构与保留项、禁止放入的内容（.agent/.git/node_modules/dist/密钥/嵌套锁文件）、路径与体积上限、封面要求、元数据字段约束、版本不可变规则与发布前自检清单 - 说明两条发布路径的输入差异（CLI 源目录 vs 后台成品 ZIP 上传）与各自上限，并标注「工具不会自动拦截 .agent/.git」这一已知边界 - 主规范与模板库 README（会发布到 OSS templates/README.md）各加一条指向该指南的入口 - docs/README.md 登记新文档，check:doc-index 通过（194 份）	2026-09-21 16:16:21 +08:00
kdletters	15e7d6065e	记录后台模板上传里程碑的实现与证据 ... - 里程碑 Status 更新为 implemented-awaiting-runtime-acceptance - 补实现与证据表：路由/权限、写入前整批拒绝、批量原子性、版本一致性、CAS 与锁、保留语义、内容寻址与回读、界面用例与静态检查 - 明确仍未执行：真实 dev bucket 的批量写入 smoke（需用户确认，建议两个 smoke-import 模板验证后下架）	2026-09-21 16:10:55 +08:00
kdletters	2e23a54211	后台模板上传（页面）：模板管理页支持批量选择 ZIP 与封面并整批提交 ... - 新增上传模型：文件名派生模板 ID、按同名匹配封面、逐行字段校验与 multipart 组装（标签去重与上限） - 模板管理页新增「上传模板」入口与弹窗：多选 ZIP、按 ID 同名多选封面、逐行编辑 ID/名称/版本/运行时/entry、逐行错误、沿用写入确认与防重复提交 - 失败只在弹窗内交代并区分 409 刷新引导与 503 锁占用提示，401 仍交由会话处理；成功后用服务端快照刷新列表并展示逐条导入结果 - admin API client 支持 multipart 请求（不预设 JSON Content-Type），新增 importAdminAgcTemplates 与对应类型 - 主规范新增「后台模板上传」章节并收口原「不上传 ZIP」表述；决策记录补一条 - 验证：admin-web typecheck、页面/模型/客户端 40 项 vitest、check:doc-index、check:encoding、cargo fmt --check、git diff --check	2026-09-21 16:06:23 +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
kdletters	33036b65fc	修复 AGC Windows 构建的 Tauri NSIS 工具链重复下载与截断失败 ... tauri-bundler 打包时现场从 GitHub 下载 nsis-3.11.zip 与 nsis_tauri_utils.dll 且不重试， Checkout 的 git clean -fdx 又会删掉工作区内的 target/.tauri，于是每个构建都要重下， 响应一旦被截断只会抛 `io: unexpected end of file`，让发布在 Rust 编译数分钟后失败。 - Jenkins Checkout 的 git clean 增加 -e apps/ai-game-creator-shell/src-tauri/target/.tauri，只保留工具缓存 - 新增 nsis-toolset.mjs：按固定 SHA1 预置 target/.tauri/NSIS，带 4 次重试并把原始归档缓存到工作区外 - 新增 ensure-nsis-toolset.mjs 与 nsis:prepare 脚本，作为 Jenkins 预检入口 - buildRelease 在 Windows 目标打包前接入工具链预置，预置失败即失败关闭 - Jenkins 新增 Tauri NSIS toolchain 阶段，在编译前预置、跑回归测试并校验 makensis 可执行 - 新增 nsis-toolset.test.mjs 并补 3 项 build-release 预置接入测试 - 同步开发运维文档与 shared-memory 排障记录	2026-09-21 15:59:30 +08:00
k88936	a4d9418cd3	补记Tripo TS绑定目录化生成的重跑验证 ... - 实施计划进展记录 contracts:model3d:generate 重跑后 packages/shared 无 diff - 验证命令清单补上该生成命令	2026-09-21 15:34:46 +08:00
k88936	7d842f0b15	补记spacetime-client重复副本文件的排障经验 ... - 记录 active.rs 用 path 属性指定真实模块、同名副本不参与编译的现象与原因 - 给出改动前先查 path 属性、只改 active 目录、用编译双绿确认的处理口径	2026-09-21 15:32:30 +08:00
k88936	d6c7a04a1c	同步Tripo3D的worker领取范围与长任务预算口径 ... - worker 领取清单补上 model3d_text_to_model 与 model3d_image_to_model - 长任务预算说明补记两个 3D job kind 在单次 attempt 内轮询 provider 并占用并发位 - worker 化方案补记 Tripo provider 的四个环境变量、默认网关与缺密钥时的 503 口径	2026-09-21 15:31:04 +08:00
k88936	13dfe07f94	补记3D定价在模型定价体系中的例外口径 ... - 模型定价管理方案新增 model3d 段说明：形状、事实源仍为文件配置、后台改价不覆盖 - 说明段缺失即 fail closed，未确认前禁止写入猜测值或 provider credit 数字 - 记录后续把 3D 段迁入 SpacetimeDB 并接后台编辑的收敛路径 - 实施计划补记 spacetime schema guard 通过及其锚点	2026-09-21 15:26:31 +08:00
k88936	03d26d46af	修正provider文档里过期的下载包装类型名 ... - 文档写的 TripoDownloadedModel 已不存在，按当前代码改成 TripoDownloadedArtifact - 上一条文档提交的说明里已提到这处改动，但当时补丁没落上，这次补实	2026-09-21 15:22:08 +08:00
k88936	c0fcb8553d	补Tripo worker纯逻辑定向用例 ... - checkpoint 只在 provider task id 非空且去空白后有效时才算存在，空白等同未提交 - 完成结果按端点严格区分，且序列化后不含 provider、taskId 与带签名的临时地址 - 预览图尺寸必须能真实解码，损坏字节直接失败而不是写占位宽高 - 预检用例去掉多余的通配导入，实施计划进展同步当前通过数	2026-09-21 15:22:01 +08:00
k88936	25ee11771c	同步Tripo provider文档与本次行为修正 ... - 脱敏输出保留原分隔符、带 userinfo 的地址解析即拒绝 - 图片与视图引用提交前 trim；校验原因分 Required / InvalidCombination / OutOfRange - 下载前要求快照为完成态，filename 扩展名收紧为短 ASCII 字母数字 - 顺带把文档里的下载包装类型名改为当前的 TripoDownloadedArtifact	2026-09-21 15:21:12 +08:00
k88936	f732555a44	为Tripo提交路由补应用级验收用例 ... - 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404 - 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400 - 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段 - 实施计划进展补记该组用例与当前全量测试通过数	2026-09-21 15:16:22 +08:00
k88936	63c924dba0	补记Tripo图生3D图片引用提交预检口径 ... - 主规范明确图片引用解析分两步：提交时只做元数据预检，worker 执行时重新确认同一事实 - 主规范新增第 5 条验收标准，验收清单顺延至 12 条，里程碑同步引用范围 - 实施计划把图片输入预检写进固定执行顺序，并记录已改用定点引用查询取代宽查询 - 决策记录新增条目：站内引用禁止在提交路径读正文、调 provider 或列全量工程与素材库	2026-09-21 15:08:01 +08:00
kdletters	f4ebc45612	模板库线上对齐仓库源：递增版本重发并把说明文档纳入发布 ... - 7 个内容已变的模板 templateVersion 升到 0.1.1，blank-2d-canvas 与 blank-web 保持 0.1.0 - 发布脚本把仓库 README.md 覆盖写到 templates/README.md（上限 64 KiB，写在清单之前并回读校验），线上说明文档不再是手工副本 - 修复守卫拒绝时直接 process.exit(1) 触发 libuv 断言崩溃、看不到拒绝原因的问题 - 新增发布用例：说明文档随发布覆盖写且写在清单之前、源目录没有 README 时不写线上文档 - 模板库新增仓库侧 README.md 源文件（发布后与线上逐字节一致） - 技术方案补说明文档契约与 2026-09-21 重发布记录；决策记录与踩坑记录各补一条 - 验证：node --test 27 项、真实发布 28 个对象回读通过、线上清单与 README 核对一致、AGC 壳 3 项线上用例重跑通过、check:doc-index、check:encoding、eslint、git diff --check	2026-09-21 14:51:39 +08:00
kdletters	19ed1776f1	收口 AGC 模板库客户端接入里程碑：补缓存回退与建项失败清理证据 ... - 客户端清单来源抽成可测判定：远端合法正文优先并标 network，远端失败回退本机缓存并标 cache，无缓存时暴露远端错误 - 远端已答话但正文非法（不是合法 UTF-8 或不符合 schema）与缓存自身损坏时一律失败关闭，不用缓存掩盖远端问题 - 补 5 项清单来源判定用例 - 大小 / 摘要不一致与越界归档用例补断言：拒绝后不留安装目录、不产生已下载判据 - 新增建项失败清理用例：复制阶段失败时删除刚创建的项目目录，不留半成品 - 主规范并入清单来源与安装判据口径，并写入 2026-09-21 复核证据 - 里程碑置为 accepted 并补 7 条验收项证据表，按工作流删除对应实施计划 - 验证：cargo test template_library 24 项与 --ignored 线上 3 项、前端 4 个模板用例文件 38 项、appSurface 首页模板 2 项、AGC typecheck、check:encoding、check:doc-index、cargo fmt --check、git diff --check	2026-09-21 14:40:15 +08:00
k88936	8a828a43ba	同步Tripo 3D生成的图片输入与完成结果口径 ... - 主规范明确图片输入先读字节再上传换 file_token，不把带签名的临时地址交给第三方 - 主规范补完成结果读取口径：由既有任务查询的 result 字段返回，标准消费者仅透传调用方显式给出的 result - 实施计划把图片输入步骤改写为 file_token 口径，文件表补 storage.rs - 实施计划新增进展一节，写清已落地步骤、未确认的定价数值与尚未跑通的真实端到端 - 风险一节补 worker 并发位与长任务超时的运维前提	2026-09-21 14:38:20 +08:00
k88936	ec408bfafd	删除 DirectProject 聊天 IPC 的死参数 prompt ... Rust 侧删掉 chat_with_game_creator_direct_codex 的 prompt 入参：回合输入只由 canonical userItem 派生，该参数从未被读取 DirectProjectTurnInput 去掉 prompt 字段，提交与排队派发不再计算 @显示名 投影文本 界面断言改读 userItem.content，并删掉退役的附件 sidecar 用例与只断言「不存在」的终止用例 同步实施计划与附件路径映射两份技术方案里的 Direct 消息契约 共享记忆补记该死参数的口径与成因	2026-09-21 14:27:23 +08:00
kdletters	4d313a44eb	收口后台模板管理里程碑：回填验收证据并删除临时实施计划 ... - 里程碑 Status 从 approved 更新为 implemented-awaiting-runtime-acceptance，并注明按验收口径未对真实 OSS 写入 - 新增验收证据：合同/权限/领域/存储/CLI 五层用例结果，本地 API 健康检查与未授权读取写入失败关闭，授权读取 9 个模板快照，受控浏览器桌面与 390×844 移动端 smoke - 新增复审记录：写路径顺序与 409 语义、后台 DTO 结构上无法改动 ZIP/版本、封面公共域名与单 bucket 合同一致、迟到响应判据的覆盖方式 - 按实施计划第 4 步删除临时实施计划文件，里程碑文档保留为唯一验收依据 - 验证：check:doc-index（192 份）、check:encoding、git diff --check	2026-09-21 14:21:25 +08:00
k88936	ab52805d3c	收口DirectProject输入区canonical content唯一事实源 ... 删除输入区 text/references 双轨草稿状态 Direct 与 Planning 改为从 Lexical content 读取 润色保留 chip 并保护附件 canonical content 增加 legacy content DTO 单向翻译与附件回归测试 补充 DirectProject composer canonical content 实施计划	2026-09-21 14:11:18 +08:00
kdletters	01ed9fadc6	修复手工 release 发布未透传 AGC 渠道 ... 补充手工发布目标到 AGC 更新渠道的踩坑记录 补充 release 客户端包分区与补发流程说明	2026-09-21 14:04:02 +08:00
k88936	931be509f1	补记Tripo model3d的assetKind接入清单对照 ... - 主规范新增 assetKind 接入清单对照表，逐行登记后端-only 类别的触碰点口径 - 主规范明确原子落库 operation_kind 白名单必须新增两个 Tripo job kind，画布回填只走 placement-only - 主规范登记用户标签覆盖、快速编辑与改造 capability 三项结论均为不进入，并写明后续接前端需重评 - 实施计划把 provider 配置文件行更正为 provider.rs，并在产物落库步骤补白名单与 placement 口径验收 - 后端架构文档补充说明：不走编辑器前端的生成类别同样适用清单，不能靠无前端入口跳过	2026-09-21 13:59:53 +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
suzmii	8d0c021126	修正 Mac 发布文档口径：自动触发与描述原文 ... - 运维文档原写「不设置 trigger；不接入现有每小时版本调度」，与现状矛盾：调度 Job 会先发号再把 SOURCE_BRANCH/COMMIT_HASH/AGC_UPDATE_CHANNEL/AGC_RELEASE_VERSION/SKIP_IF_SUPERSEDED 透传给 Mac Job，正常发布不需要手工点构建 - 把 Jenkins Job 描述与节点描述的当前原文（arm64 单架构 + 由调度器自动触发 + dry-run 默认关）写进文档，并要求每次改口径同步 Jenkins 侧描述，避免描述停留在 universal/手动触发的旧口径	2026-09-21 13:50:32 +08:00