4481 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
lhk229	55d00eaac9	Merge branch 'master' into fix/empty-input	2026-09-21 16:24:36 +08:00
lhk229	a4d5fcb5fc	修复游戏智能体输入含空白片段时被误判为空 ... 改为按整条消息判断有效内容，保留空白文本片段及两类引用的原有校验 补充多行文本、纯引用、全空白输入及非法引用的定向回归测试 同步素材引用文档、共享排障记录和过时测试注释	2026-09-21 16:23:36 +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
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
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
kdletters	01ed9fadc6	修复手工 release 发布未透传 AGC 渠道 ... 补充手工发布目标到 AGC 更新渠道的踩坑记录 补充 release 客户端包分区与补发流程说明	2026-09-21 14:04:02 +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	6845cdcbc5	修复 Mac 包校验脚本对合法随包 npm 的误判 ... - check-macos-bundle 的「包里不得出现 node_modules」门禁只放行了 game-runtime/node/node_modules/npm，但 recursive readdir 会把目录项 game-runtime/node/node_modules 也列出来，于是合法包必然断言失败 - 这条门禁是 #439 引入的，之后每次构建都死在更早的阶段（staging/测试），直到 2026-09-21 arm64 单架构跑通才第一次走到它：12:58、13:24、13:43 三轮都挂在这里 - 修复：放行 npm 目录自身、其子树与它的上级 node_modules 容器目录；已用真实 arm64 产物跑通完整 smoke（资源、架构、摘要、权限、Codex 正式查找、app-server 握手、缺组件拒绝全部通过）	2026-09-21 13:50:32 +08:00
suzmii	4044ffd89b	修复 Mac 发布 Job 手工触发时 Checkout 因未定义参数失败 ... - 手工「立即构建」不会注入可选参数（COMMIT_HASH / SKIP_IF_SUPERSEDED 未定义而非空值），set -u 下 `[ -n "$COMMIT_HASH" ]` 直接以 unbound variable 退出，Job 2026-09-21 12:54 那一轮就是这样在 Checkout 失败的 - 两段 Checkout 脚本开头统一兜底：SOURCE_BRANCH 默认 master、COMMIT_HASH 默认空、SKIP_IF_SUPERSEDED 默认 false，调度器显式传参时行为不变（仍按 pinned commit 构建并判让位）	2026-09-21 13:50:32 +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
kdletters	1cb91f9444	修复画布绑定查询与生成失败归因 ... - 画布绑定前置的项目列表查询改为 view=summary，站内与外部路由统一支持摘要视图（缺省 full 兼容，未知取值 400） - 项目摘要投影收敛到 editor_project，外部 API 与 MCP 复用同一份实现，摘要不做内联媒体修复也不回传画布与全量资源 - 外部编辑器请求失败文案补 kind 语义与底层因链，区分请求超时、正文截断与非法 JSON，不拼接 URL - 远端资源编辑终态文案带出稳定失败码并指向移出恢复队列这一唯一出口，上游原文仍不写入账本 - 补齐站内摘要视图与画布测试夹具的请求断言用例 - 更新共享决策记录与踩坑记录（图集切片上限条目归上游 #442，本提交不重复）	2026-09-21 13:33:23 +08:00
kdletters	2e31a485d8	修复 Stdb publish 事务确认超时被误判为失败 ... - production-stdb-publish 新增 run_spacetime_publish：仅在出现 timeout waiting for transaction confirmation 时重试一次同版本 publish（SpacetimeDB 对已生效的同版本为幂等），重试成功即视为模块已在位，不再把生产留在维护态 - 其它失败原因保持原有失败关闭语义；生产运维门禁断言补上该重试口径	2026-09-21 13:27:37 +08:00
suzmii	4ad131d74d	Merge pull request 'AGC 画布：锚点让位标题栏、生成浮层贴边、拖动误触点击、读秒 100ms 与图集参考口径' (#448) from fix/agc-canvas-bugfix into master ... Reviewed-on: #448	2026-09-21 13:04:11 +08:00
kdletters	886bdc06ed	去掉渠道环境变量用例里重复的 stageRuntime ... - 两次独立修复（#444 与本仓库 55cb04765）在同一处各加了一个 stageRuntime，合并后成为重复对象键，Web-Build 的 ESLint(no-dupe-keys) 失败 - 保留一条带说明的 stageRuntime stub，用例语义不变	2026-09-21 12:49:34 +08:00
suzmii	562e1ba586	「生成任务」侧栏读秒改为 100ms 粒度：与对话侧共用同一份时钟 ... - ResourceCanvasAssetGenerationTasksPanelView：删掉面板自带的 1000ms interval 与 nowMillis 状态；两条任务行的「已耗时」下沉为叶子组件（AssetGenerationElapsedLabel / ResourceEditElapsedLabel），各自订阅共享 hook useLiveNow（LIVE_TIMER_TICK_MS = 100）。 - 为什么不是面板级时钟：面板上通常同时挂着多条任务，100ms 的 tick 落在面板上等于每 0.1 秒重建整个侧栏；useLiveNow 的注释明确要求调用方是叶子节点。终态行不订阅，已耗时定格在账本给的结束时间上。 - 行为：不足一分钟的耗时本来就显示到 0.1 秒（formatElapsedDuration），现在每 100ms 真的更新一次，不再是「带小数却 1 秒跳一格」。 - 用例：新增「读秒按 100ms 刷新（0.0 → 0.1 → 0.5 秒）」「终态行不再走表，定格在结束时间」「秒表只订在运行中的那一行上（setInterval 只被调用一次）」；把 LIVE_TIMER_TICK_MS 临时改回 1000 时第一条用例即红，粒度确实被钉住。	2026-09-21 12:48:21 +08:00
suzmii	e18067e028	Merge pull request 'macOS 发布改为只出 arm64 单架构（修复 Mac 管线 #7 起连续失败）' (#447) from feat/agc-macos-arm64-only into master ... Reviewed-on: #447	2026-09-21 12:38:03 +08:00
suzmii	613d62fdb2	同步里程碑计划：macOS 清单只登记 darwin-aarch64 ... - docs/project-memory/plans 的渠道化里程碑仍写着 dev-mac universal 同时写两个平台键，与 2026-09-21 的单架构决策冲突，按当前口径更新并指向决策记录	2026-09-21 12:35:36 +08:00
suzmii	b4ce6877c8	修掉「拖动占位卡仍触发点击」的真因：点击抑制的计时起点必须在松手那一刻 ... - useResourceCanvasGenerationPlaceholders：抑制状态在越过拖动阈值时只登记、不起计时器，改到 pointerup 才起 0ms 计时（deferDragClickSuppressionCleanup）；pointercancel 与切项目走 clearDragClickSuppression 立刻收干净。 - 原实现（越过阈值时就起 0ms 计时器）在真实鼠标下不成立：一次拖动里 pointermove 横跨多轮宏任务，计时器早在松手前就把抑制清掉，收尾那次 click 照样生效——jsdom 同步发 move/up 看不见这一档，所以上一版用例是假绿。 - 用例补上真实时序：拖动过程中显式让时钟走一轮宏任务再松手；宿主用例还补上浏览器在 pointerup 之后补发的 lostpointercapture，并断言它不能把这次拖动的抑制一起清掉。 - 敏感性已双向验证：把计时器搬回「越过阈值那一刻」、以及让 lostpointercapture 清抑制，两条用例都会红；改用例前的同步版本对两种错法都会绿（所以上一版没抓住）。 - 注释写明计时起点为什么是松手那一刻，并与资源卡链路的 deferSkippedResourceCardClickCleanup 对齐口径。	2026-09-21 12:34:47 +08:00
suzmii	e53992fdc2	macOS 发布改为只出 arm64 单架构 ... - build-macos-ci 固定 aarch64-apple-darwin：单架构构建、只跑 arm64 隔离 smoke、首装包命名 <产品名>_<版本>_aarch64.dmg，构建清单记录 smokes 与实际清单平台键 - stage-node-runtime 的 universal-apple-darwin 恢复失败关闭并说明原因：随包 Node 只有单架构官方发行版，按宿主架构放行会让 Intel 上这份侧车不可执行，且通用包自检按 process.arch 校验抓不到 - 守卫用例改为断言入口固定 arm64 目标与 _aarch64.dmg 后缀、universal 目标必须抛错 - Jenkinsfile 与三份技术/运维文档同步单架构口径：清单只登记 darwin-aarch64，Intel 非目标，恢复 universal 的前置条件写在文档里 - 共享记忆补 2026-09-21 决策记录，pitfalls 记下「只带宿主架构的通用包」陷阱，避免再次用过渡实现糊过去	2026-09-21 12:30:56 +08:00
suzmii	a5ee06a4c7	Merge pull request '修复macOS主机上AGC发布测试未stub Node运行时staging' (#444) from fix/agc-test-node-runtime-stub into master ... Reviewed-on: #444	2026-09-21 12:23:52 +08:00
suzmii	7b57cba14d	补齐「图集（生成图标素材）为什么没有 @」的当面说明与依据 ... - 生成浮层：不给 @ 选择器的入口新增一段说明行（`data-resource-canvas-generation-reference-free`），讲清「该入口走平台图集通道，参考只有一张权威规范图（图标规范），不支持另挑参考图」——验收现场那条「生成图标素材没法 @」读起来像漏了按钮，原因其实在通道上。 - 样式：说明行允许折行、沿用次要文字色；与既有的「参考图 n/5」计数行区分开。 - 用例：图集入口断言说明行在场；逐条入口断言「说明行」与「@ 选择器」严格互补；原「不呈现参考选择」的判据从按词匹配改成按计数元素/计数值匹配（说明行本身会提到「参考图」三个字）。 - 文档：入口矩阵补「图集为什么没有 @」一条，写明图集走 `icon-spritesheets` 通道、提交体只有 referenceId + iconDescriptions（无 referenceImageSrcs）、结果绑定硬校验参考恰好一张，以及「平台 OpenAPI 该请求 schema 有 referenceImageSrcs 字段，放开属于产品 + 平台口径变更」。	2026-09-21 12:23:32 +08:00
kdletters	55cb047654	支持 macOS 通用包构建时的 Node 运行时暂存 ... - stage-node-runtime 的 targetRuntime 支持 universal-apple-darwin：在 macOS 宿主上按宿主架构暂存官方 Node（通用包自检按 process.arch 校验），非 darwin 宿主仍失败关闭 - 同步 stage-node-runtime 测试期望：darwin 宿主可用、linux 宿主仍拒绝，Universal Node 合并（lipo）留作未完成项 - 共享记忆记录该限制：当前通用包侧车仍是宿主架构，Intel Mac 需等待真正的通用 Node	2026-09-21 12:15:28 +08:00
suzmii	beebcca4de	修复 AGC 画布四项验收问题：锚点让位标题栏、浮层不再撞画布边缘、拖动不再触发点击、图标规范参考口径对齐 ... - 生成任务锚点新增「资源总览」档：资源总览页仍贴画布顶边内缩 0.85rem，资源栏目画布页让开顶部钉住的整宽栏目标题栏（42px + 0.5rem），两档切换走 margin-top 过渡（减动效下关掉）。 - 生成浮层的顶边与可用高度改为按占位卡的真实屏幕位置算（卡下沿到安全底边），不再假设卡片贴在安全带上沿——占位落到下半屏时浮层底边不再越过画布下沿被切掉。 - 生成浮层新增水平收口：按「浮层左右各留 12px」把锚点收进画布可视范围，卡片靠边时浮层不再有一半落到画布之外；宽度口径与面板 CSS 同源（min(560px, 100% - 24px)）。 - 新增画布卡片手势的共享判据 resourceCanvasGestureExceededDragThreshold（阈值仍取 RESOURCE_CANVAS_DRAG_THRESHOLD）：资源卡与生成占位卡共用同一份「拖动还是点击」判断。 - 生成占位卡修掉拖动收尾误触点击：越过阈值才算拖动、登记一次性点击抑制（consumeDragClick）由宿主消费，「拖动中」样式也从越过阈值那一刻起才亮。 - 生成占位卡的删除按钮起手手势不再被当成「点卡片」：按起手点判定，松手落回卡片时不触发开合生成浮层。 - 图标规范面板的参考选择注释按现行判据改写（只有图集 icon-spritesheet 不接受用户参考），入口矩阵文档同步补「参考图（@ 引用）」口径并修掉「本地 IPC 没有参考图入参」的旧说法。 - 补齐回归用例：手势模型判据、占位卡拖动/点击与阈值、宿主级「拖完不弹浮层且普通点击仍开合」、浮层顶边与水平收口、锚点分档与跨文件标题栏高度守卫、逐条生成入口的 @ 与判据一致、图标规范面板的 @ 与提交带引用。 - 共享记忆 pitfalls.md 记录两条排障口径：卡类手势必须只有一份阈值与点击抑制判据；画布浮层几何只能按真实屏幕位置算、分页锚点必须让开钉死的标题栏。	2026-09-21 11:58:13 +08:00
kdletters	9bf35e8745	修复 macOS 构建上的渠道环境变量用例宿主依赖 ... - build-release.test.mjs 的「packaged renderer receives the same channel as the updater manifest」用 windows target 却未注入 stageRuntime，真实 staging 要求宿主 Node 平台/架构与目标一致，导致 macOS(arm64)/Linux 上必然失败 - 该用例只断言传给 spawn 的 VITE_AGC_PLATFORM_CHANNEL，改为注入空 stageRuntime，与同文件其它用例一致	2026-09-21 11:53:32 +08:00
kdletters	90207bc1d5	minimal 备份增加 freeze 副本路径 ... - database-backup-to-oss.mjs 新增 --freeze-dir：minimal 模式先把选中子集 rsync 成冻结副本（保持原始相对路径）再从副本上传，避免热备时最新 commitlog 持续追加触发 stat 漂移失败 - files-minimal systemd 模板与发布前 minimal 备份默认传入 freeze 目录 - 生产运维门禁同步 freeze 口径断言	2026-09-21 11:37:14 +08:00
kdletters	2f248ea0c3	新增 minimal 备份口径并切换 release 定时备份 ... - database-backup-to-oss.mjs 新增 --minimal/--retain-snapshots：按上游 retention 语义只备份最近 N 份 snapshot、覆盖最老保留 snapshot 的 commitlog 边界段及其后全部段，外加身份/配置/控制库/模块字节，且不停止任何服务 - 备份检查脚本补充 minimal 计划用例（保留次新+最新 snapshot、丢弃更早 snapshot 与 clog 段、状态路径齐全、保留数校验） - 发布前备份默认走 minimal 热备（GENARRATIVE_STDB_PUBLISH_BACKUP_MINIMAL=0 可回到冷备），不再需要 44.7GiB 冷备空间 - Server-Provision 新增 DATABASE_BACKUP_PROFILE=files-minimal 与 systemd drop-in，release 推荐使用并继续禁止 files-history - 运维文档与共享记忆记录上游 retention 依据、实测 40G→3.6G 与不停服热备口径	2026-09-21 11:33:39 +08:00
kdletters	117d482f93	发布前备份空间预检前置并支持自动降级 ... - database-backup-to-oss.mjs 新增 --check-space-only：archive 按 data×1.1、files 按 max(data×0.05, 2GiB) 计算门槛，空间不足以退出码 3 返回 - production-stdb-publish.sh 在进入维护与停服务之前先做空间预检，archive 不足时自动降级 files（files 不支持 defer，async 收敛为 sync），可用环境变量关闭 - 尚未开始 publish 的失败自动恢复本次停掉的 API/controller/worker 并退出维护，只有真正开始发布之后的失败才保持维护态 - 备份检查脚本与生产运维门禁补上新口径与执行顺序断言，运维文档与共享记忆记录事故与规则	2026-09-21 10:57:29 +08:00
suzmii	9f15c1c572	修复非Windows主机上AGC发布测试未stub Node运行时staging ... build-release.test.mjs的渠道注入用例漏注入stageRuntime，真实staging会用宿主平台与默认Windows目标做一致性校验 该缺陷在macOS主机上必然失败，卡住macOS渠道构建的测试阶段 补上stageRuntime stub，本机（darwin/arm64）验证37项全通过	2026-09-21 10:35:43 +08:00
suzmii	959d367ed4	Merge pull request '图集切片上限对齐平台契约：客户端结果门 64 → 256' (#442) from fix/spritesheet-slice-limit-256 into master ... Reviewed-on: #442	2026-09-21 10:27:39 +08:00
suzmii	56dcb06fb8	Merge remote-tracking branch 'origin/master' into fix/spritesheet-slice-limit-256 ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-09-21 10:12:01 +08:00
kdletters	f947807fba	修复手动发布的发号 Job Copy Artifact 授权 ... - 发号 Job 的 copyArtifactPermission 补齐手动发布消费者，用户触发的构建不再报 Unable to find project for artifact copy - 同步总版本号技术方案与共享记忆排障记录，写明 SYSTEM 定时构建短路、用户触发按认证用户判权的差异与回写 Job property 的步骤	2026-09-21 08:54:17 +08:00
suzmii	1997dfeb80	图集切片上限对齐平台契约：客户端结果门 64 → 256 ... - 现场（gameagent-6e53c9e8）「AI 生成图标素材」失败：平台已生成并切完图，客户端在绑定结果这一步把整条结果判失败（assetId 为空、付费产物被丢）。 - 根因：同一条链路存在两个上限——平台切分 / Agent 工具 schema sliceCount / 持久化产物批次都是 256，客户端两处结果绑定门仍是 64（external_generation_state.rs、canvas_generation.rs）。 - 修复：两处门统一到 PLATFORM_ART_SPRITESHEET_MAX_SLICES = 256，判据与拒绝文案各只留一份（数字由常量插值），注释点名三处同值权威。 - 用例：新增上限值/边界/文案用例与「64/65/256 片必须能落盘、257 片必须拒」的回归用例；两条都做过变异验证（常量改回 64 即红）。 - 文档：decision-log 与 pitfalls 各补一条（客户端门不得比平台产品上限更严；上限引同一常量）。	2026-09-21 08:31:39 +08:00
kdletters	0ac86f941c	优化 Gitea CI Rust 分片并发 ... 将四个 AGC Rust shard 合并为两条 lane，减少重复预热与排队 同步 workflow 契约测试、分片说明和运维文档	2026-09-21 07:56:06 +08:00
suzmii	3815d00c84	Merge pull request 'AGC 画布三项：生成任务侧栏右上角 / 拖到对话批量引用 / 替换面板画布点选' (#441) from feat/agc-canvas-ux-followups into master ... Reviewed-on: #441	2026-09-21 07:51:07 +08:00
suzmii	4172534bab	Merge branch 'master' into feat/agc-canvas-ux-followups	2026-09-21 07:51:00 +08:00
kdletters	ab9820990c	补充 Windows 构建节点 Python 安装口径 ... - 排障记录写明新节点静默安装 Python 3 的确切命令，并说明 CMake 用 Build Tools 自带版本	2026-09-21 06:58:45 +08:00
kdletters	510e550f19	补充 Windows 构建节点修复的实跑证据 ... - Godot 编辑器插件接入文档记录 Jenkins Windows 节点在本修复分支上的 dry-run 实跑结果：preflight、原生载荷 staging、NSIS 安装包与渠道清单	2026-09-21 06:58:39 +08:00
kdletters	6dadd76c1b	修复 Windows AGC 构建节点的 Godot 原生扩展工具链 ... - AGC_WINDOWS_PATH 增加 Build Tools 自带 CMake 与 Python 3.12 目录，阶段 PATH 不再漏掉 Godot 原生扩展所需工具 - Toolchain preflight 校验 CMake 3.25 及以上、Python 3 和 Visual Studio 17 2022 生成器，缺失时在构建前失败关闭 - 同步 Godot 编辑器插件接入文档与共享记忆排障记录	2026-09-21 06:41:03 +08:00
suzmii	1a507dbf2d	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-ux-followups	2026-09-21 06:21:38 +08:00
suzmii	5467ed6d7b	自查修正：拖到对话落点逐值比较、替换面板锚进画布容器并与任务面板互斥 ... - 拖动落点改逐值比较 sameResourceCardReferenceDrop（条数 + 对话栏矩形四值），指针在对话栏上移动不再每帧 setState、不再每帧重渲染工作台。 - 替换面板从 stage 顶层移进画布容器 .game-resource-book-manager（本身 position: relative），top 3.2rem 排在任务开关下方；相对 stage 写死的偏移会在工具条换行时压上去，与刚修的任务开关是同一类隐患。 - 打开替换会话时收起「生成任务」面板：画布右上角同一时刻只留一块浮层（任务照旧在账本里推进）。 - 面板上方补一行「替换源素材：<显示名>」：非模态之后画布上的源素材光环会被空白点击清掉，源身份得在面板这一侧留一份可读说法。 - 测试：替换用例新增「面板锚在画布容器里、写明源素材、并与任务面板互斥」（20 passed）、落点模型新增逐值比较用例（6 passed）。 - 文档：decision-log 新增本批自查条目、待办文档补登记、验收用例 C9 注脚改为 nonModal 形态。	2026-09-21 06:21:19 +08:00
kdletters	4b788fa73a	修复 Gitea CI 镜像构建并刷新到 1.98.1 工具链 (#438) ... 修复 CI job 镜像无法构建的问题，并换用 Rust 1.98.1 工具链镜像，跑通 PR 门禁。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/438 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-21 06:15:57 +08:00
suzmii	7148ff9eaf	验收修正：任务锚点改挂画布那一格，展开后开关让位 ... - 重叠：右上角锚点不再用 position: absolute + 写死的 top（工具条是 stage 第一行、高度随按钮换行变化），改为 stage 网格里与工作面同一个单元格的条目：grid-row 按 placement 分档 + grid-column 1 + justify-self end + align-self start + margin；同格的三处容器也显式钉住第 1 列，避免画布被自动列放置挤进隐式第二列。 - 并排：开关只在完全收起时渲染（收起动画期间也不画），展开态画布右上角只留面板，收起走面板头部 × 或点画布外部。 - 测试：面板用例新增「展开时开关让位」、计数用例拆成收起查开关 / 展开查面板；样式用例改判网格条目坐标与窄屏 justify-self: stretch；dismiss 用例改走面板 × 收起、收起后开关回来能再打开。 - 文档：PRD 3.10 与更新时间、decision-log 新增 2026-09-21 验收修正条目、待办文档补登记该修正。	2026-09-21 04:33:26 +08:00
suzmii	b20d980ba7	替换点选判据的注释口径跟上新流程 ... - resolveResourceReplacementPick 的注释里「点选态」「点选替换」改为「画布点选」「面板里的当前替换目标」，与退役掉的按钮 / 提示条口径一致；只改注释，行为不变。	2026-09-21 03:53:07 +08:00
suzmii	de502e9bc3	替换面板改为非模态浮层，支持在画布上点选替换目标 ... - 共享选择组件新增 opt-in nonModal：不铺遮罩、不做焦点陷阱、限高 + 内部滚动，Esc 在 document 阶段截断后取消，关掉即卸载；网页端美术画布不传，弹窗行为逐字不变。 - 新增 initialSelectionRevision：面板开着时宿主换了目标才重同步当前选择，面板里的搜索词与分类筛选不被重置。 - AGC 侧把候选面板锚到画布右上角（任务开关下方），壳样式放共享样式表、宿主只负责锚定；面板开着时画布照常可点，点中合法候选落成面板当前选择，写入仍只由「确认」发起。 - 退役旧的「点选替换」按钮、画布提示条与 resourceReplacementPickMode：同一个功能不留两条 UI 路径；合法性判据仍复用 resolveResourceReplacementPick，写入仍是同一个 confirm 函数。 - 确认时用画布点选结果兜底，避免点完当帧按确认误报「请选择一个替换素材」。 - 测试：替换用例 4 条点选路径改写为非模态 + 面板点选（含四类非法目标在面板内报因、Esc 只收面板），新增「画布点选不清掉面板搜索/分类」；共享组件用例新增 nonModal 形态与浮层壳声明级契约。 - 文档：PRD 5.3 / 7.8 第 8 条改写、验收用例 S15a 改写、decision-log 新增 2026-09-21 条目、待办文档登记三项并勾掉对应需求。	2026-09-21 03:48:40 +08:00
suzmii	9639a080c6	资源卡拖到对话栏实现批量 @ 引用 ... - 新增落点模型 resourceCardReferenceDropModel：对话栏矩形量取（0 x 0 判成没有落点，避免画布内拖动被误判）、命中判据、引用构造与落点提示文案。 - 引用构造与工具条「引用」按钮逐字一致（只认已登记 manifest 素材、source 为 resource-card、kind/分类/标签取自资源投影），一条都构造不出来时用提示条说明原因。 - 拖动中指针落到对话栏上即从排版切到引用：卡片不再跟指针走，改铺虚线落点浮层并提示「松手即可 @ 引用 N 项素材」；拖回画布内松手仍是原来的排版语义。 - 批量范围与拖动位移同一个集合（多选整批、单选只引用按住的那张）；新增批量事件 RESOURCE_REFERENCE_INSERT_MANY_EVENT，App 侧一次插入整批并只聚焦一次，空批次不派发。 - 对话栏挂 ref（不 document.querySelector）、落点浮层按对话栏当时的屏幕矩形铺在根节点上，不改对话栏自身的定位与排版。 - 测试：新增落点模型用例 5 条与画布集成用例 4 条（单卡/多选/拖回画布/pointercancel），resourceReferenceInput 新增批量事件与一次插入整批 chip 两条，共 39 条定向全绿。 - 文档：功能说明新增「拖拽引用」一节与完成清单条目、PRD 更新时间、decision-log 新增 2026-09-21 条目。	2026-09-21 03:37:43 +08:00