620 Commits

Author	SHA1	Message	Date
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	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	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	2e31a485d8	修复 Stdb publish 事务确认超时被误判为失败 ... - production-stdb-publish 新增 run_spacetime_publish：仅在出现 timeout waiting for transaction confirmation 时重试一次同版本 publish（SpacetimeDB 对已生效的同版本为幂等），重试成功即视为模块已在位，不再把生产留在维护态 - 其它失败原因保持原有失败关闭语义；生产运维门禁断言补上该重试口径	2026-09-21 13:27:37 +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	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
kdletters	0ac86f941c	优化 Gitea CI Rust 分片并发 ... 将四个 AGC Rust shard 合并为两条 lane，减少重复预热与排队 同步 workflow 契约测试、分片说明和运维文档	2026-09-21 07:56:06 +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	d354e5e7c3	修复发号Job未授权调度器读取归档导致整轮调度失败 ... 发号Jenkinsfile显式copyArtifactPermission授权调度管线 生产门禁新增该授权规则避免回归 运维文档补充生产者到调度器的Copy Artifact映射与失败后果	2026-09-20 22:58:39 +08:00
suzmii	dbbbef8a0d	把macOS渠道纳入定时发布并共用总版本号 ... 调度器在发号后同时触发macOS渠道构建，透传同一个总版本号与固定revision macOS Job改为默认真实发布，演练需显式勾选 新增SKIP_IF_SUPERSEDED：节点离线期间排队的旧构建在恢复后自行让位 补充生产门禁规则与回归断言 同步调度与运维文档口径	2026-09-20 22:47:01 +08:00
kdletters	9e0cbc7041	AGC 客户端版本号收敛为单一发号源 ... 新增 OSS agc/global-version.json 发号模块与发号入口脚本\n构建侧优先采用发号 Job 下发的总号，未传入时本地兜底发号\n渠道高水位降级为回退断言，请求号低于渠道清单版本即失败关闭\n新增 Genarrative-Agc-Global-Version-Issue 发号 Job 与 job config\n调度管线与手动管线先发号再透传 AGC_RELEASE_VERSION\n补充单元测试、生产运维门禁、主规范与里程碑文档	2026-09-20 18:13:45 +08:00
kdletters	288e1d4f4a	同步最新主干并修复 Godot 插件启动竞态 ... 合入主干 Rust 1.98.1 工具链及对应 CI 文档更新 Godot 插件先接收受控项目快照再注册命令和连接能力 补充启动竞态回归、失败回执诊断及插件启动合同	2026-09-20 17:46:53 +08:00
kdletters	5822b64d7c	合并 Godot 编辑器插件与常用操作指导到主分支 ... 接入 Godot 原生桥、受控执行、Runner 回执与编辑器操作指南 保留主分支 Cocos 和 Unity 跨工程能力及外置提示词结构 解决插件生命周期、工具目录、前端启动和文档合并冲突	2026-09-20 17:38:48 +08:00
suzmii	a35cdcc68c	同步 CI 镜像 tag 与文档口径，并补上工具链一致性护栏 ... - 将 CI job 镜像默认 tag 从 genarrative/gitea-project-ci:20260807.1 升为 20260920.1 - 将 Dockerfile 两处 org.opencontainers.image.version 统一为 2026.09.20.1（原先一处 2026.07.23.1、一处 2026.08.07.1，后写的覆盖先写的） - 同步 deploy/container/README.md 与开发运维文档中的镜像归档示例名 - 订正 pitfalls.md 中 CI 镜像的 Rust 版本，并记录 number_of_links 在 1.98.1 上实测仍未稳定 - 在 decision-log.md 追加本次 Rust 工具链升级到 1.98.1 的决策条目 - 在 scripts/project-ci-workflow.test.ts 新增一致性用例：镜像版本段、digest 与 tag 必须与 rust-toolchain.toml 及两份运维文档一致	2026-09-20 17:06:49 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
kdletters	97d8a6c39a	清理并统一外置智能体提示词 ... 将智能体系统指令、工具说明和恢复模板集中到外置提示词目录 精简重复否定、历史对照与无关实现说明，保留必要执行约束 扩展提示词构建校验和源码边界检查并接入现有本地与持续集成门禁 同步内置技能、协作规范、技术文档与对应验证断言	2026-09-20 15:32:48 +08:00
kdletters	33f5ad68bf	接入 DotCraft Unity 编辑器插件与受控执行链路 (#423) ... AGC 原有插件系统无法直接操作已打开的 Unity Editor。本变更增加内置 `agc-unity-editor`，在 Windows x64 / Unity Mono 上支持当前项目探测、连接与 C# 执行，不向 Unity 工程安装 UPM 桥接包。 ## 主要变更 - 固定复用 DotCraft.Unity 0.4.3 的 Attach 核心，提供自包含 .NET helper，保留上游许可证、来源及修改记录。 - GUI、Runtime、DirectProject 共用 Runner 执行服务；补齐项目身份、并发、总期限、回执确认与持久不确定状态阻断。 - 现有打开项目入口支持 Unity，按项目类型及开关暴露插件和 Agent 工具。 - Windows 构建准备 helper 并随包分发；插件 JS/Rust 测试接入现有 CI 组，Jenkins 增加 .NET 10 工具链预检。 ## 验证 - .NET helper 27 项测试、自包含发布及最小环境协议 smoke 通过。 - Unity 6000.3.7f1 实机验证通过：连接、C# 执行、编译错误修复、断连重连、Domain Reload 后重新握手；真实 Runner 的 ACK、并发拒绝和跨重启阻断通过。 - 宿主 Unity、PluginHost、Cocos、MCP、工具目录与引擎识别定向回归通过；前端类型检查、插件 JS/Rust、CI 配置、格式、编码和文档门禁通过。 Linux CI 不代替 Windows helper/实机验证；发行安装包 UI smoke、其它 Unity 版本和 Unity CoreCLR 未验证。Unity 演示工程中的场景和组件已撤销，不在此 PR 范围内。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/423	2026-09-19 12:29:27 +08:00
kdletters	133bb2f350	修正 AGC 原生 HTTP 契约守卫与更新摘要证据 ... - 契约守卫不再要求 http 插件放行 OSS 域名：更新清单与安装包下载已改由 tauri-plugin-updater 在原生侧完成 - 主规范回填 0.1.62 自动更新摘要与客户端提示展示的用户实测证据	2026-09-17 21:06:55 +08:00
suzmii	c329c438d9	修复资源画布PR的CI回归（#410） ... 修复活动回合空快照引用及停用后晚到请求覆盖问题 对齐共享卡片角标与窗口发布次数回归断言 同步原生HTTP权限检查与图集显式切片测试契约 整理菜单组件导入顺序并记录本地验证范围	2026-09-17 20:17:26 +08:00
kdletters	5db407c3dc	新增 AGC 模板库与由模板创建项目链路 (#396) ... ## 交付范围 - OSS `agc-dev` bucket 的 `templates/` 前缀作为 AGC 游戏模板库（**去掉 `agc/` 这一层**；`agc/` 继续只放客户端安装包与更新清单）。 - 模板正文改为 zip（zip 根 == AGC 项目根，如 `game/index.html`）；清单补齐 `tags`、封面字段与包大小/摘要，`templateVersion` 用于判断是否需要重下。 - 客户端：Rust 模板库模块、模板库全屏页、首页模板推荐位、左侧导航入口。 ## 客户端行为 - `fetch_game_template_library`：读取并校验清单（≤4 MiB），缓存到 `<app_data>/templates/index.json`；网络失败回退本机缓存并标注 `source=cache`。 - `download_game_template`：按清单下载 zip（≤512 MiB），校验字节数与 SHA-256 后解压到 `<app_data>/templates/installed/<id>/<version>/`，最后写 `installed.json` 作为安装完成标记。 - `create_automatic_local_game_project_from_template`：先把模板文件铺进新项目目录，再走既有 `init_local_game_project_at` 补 `.agent` 清单与标准目录；失败删除半成品目录。 - 解压只接受普通文件与目录（拒绝绝对路径、`..`、盘符、符号链接），安装目录名由标识符白名单拼出；远端只信「受信任 OSS 主机 + 对象键」，清单里的地址字段不参与请求。 - UI：搜索（空白分隔多关键词「与」）、标签/运行时筛选、仅看已下载、封面卡片与已下载徽标；「使用模板」在版本落后时先重下再建项。 ## 文档与脚本 - 主规范 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`；里程碑与实施计划见 `docs/project-memory/plans/`；`decision-log.md` 记录库路径、清单 schema、安装缓存目录与 CSP 约定。 - 发布脚本 `scripts/agc-template-library-publish.mjs`（`--dry-run` 校验 → 上传 → 回读校验）。 - 首页「灵感推荐」替换为模板库推荐位，删除本机灵感图目录与 `InspirationGallery.tsx`；`tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机用于加载封面。 ## 验证 - `cargo test --bin genarrative-ai-game-creator-shell template_library`：9 passed；`--ignored` 真连检查 `fetches_the_live_template_library_index` 通过。 - `npx vitest run src/features/template-library`：9 passed。 - `npm run typecheck`、`cargo fmt --check`、`npm run check:encoding`、`node scripts/check-doc-index.mjs`、`git diff --check` 均通过。 - OSS 侧匿名复核：`templates/index.json`、各 `cover.png` 与 `template.zip` 均返回 200。 ## 未做 / 待确认 - 本轮未做客户端点击级人工验收（下一步单独验证并把结果补进此 PR）。 - 模板封面目前是占位标题卡，正式封面由后续模板包提供。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/396	2026-09-17 17:48:06 +08:00
kdletters	576ff07a5e	新增定时版本调度管线并收回两条下游管线的定时与去重 ... - 新增 Genarrative-Scheduled-Revision-Trigger：每小时用 git ls-remote 解析分支版本，与上一次触发过的 revision 不同才继续 - 触发时把同一个固定 COMMIT_HASH 同时传给 Full Build 与 AGC Windows Build，保证两条管线构建同一个版本 - Full Build 与 AGC Windows Build 去掉自带定时触发器与管线内版本去重 - 新增 scheduled-revision-trigger Job 配置 XML，使用本机 Git 入口与既有 SSH 凭据，定时器留在 Jenkinsfile - 生产运维门禁改为校验调度管线约束，并拦住两条下游管线重新加 cron 或自行去重 - 同步开发运维文档、共享开发工作流与踩坑记录	2026-09-16 10:55:16 +08:00
kdletters	5aa616134c	修复 Hook 链继承仓库定位变量导致真实仓库被夹具污染 ... - .husky/pre-commit 与 .husky/pre-push 入口清除 GIT_DIR/GIT_WORK_TREE/GIT_INDEX_FILE 等仓库定位变量 - scripts/check-repository-ci.sh 增加同样的清理，保证本地门禁与 CI 走同一套隔离 - scripts/git-hooks.test.mjs 夹具 Git 调用前自检仓库归属并禁用 Hook，命令落到外部仓库时直接失败 - 守卫用例的子进程必须真的继承 GIT_DIR，避免隔离断言空转 - 更新开发运维文档与 shared-memory/pitfalls.md，记录链接工作树注入形态与配置修复步骤	2026-09-16 10:35:07 +08:00
kdletters	187b66c3b1	Jenkins 定时构建增加版本未变化去重 ... - Full Build 改为每小时触发，并按已解析 commit 与全部构建参数判断是否重复 - AGC Windows Build 增加每小时触发与同一套去重逻辑，跳过时不再安装依赖、构建和上传 - 跳过记录为 NOT_BUILT，越过跳过记录后最近一次实际构建成功才允许跳过，失败或中断可重试 - 生产运维门禁补充两个 Job 的去重约束与各阶段跳过检查 - 同步开发运维文档与共享开发工作流说明	2026-09-16 10:32:03 +08:00
lhk229	86c92280cf	修正 Windows 平台测试兼容性 ... 按当前发送按钮和画布工具条结构更新契约。 Windows 无法创建符号链接时跳过依赖符号链接权限语义的测试。	2026-09-16 07:09:12 +08:00
lhk229	bcbfe92afa	修正剩余前端与平台测试契约 ... 同步空对话、输入盒、资源删除工具条的当前结构断言。 Windows 无法创建符号链接时跳过仅针对符号链接权限的测试。	2026-09-16 07:05:55 +08:00
kdletters	e72a2da733	修复构建测试隔离并对齐 Direct 消息契约 ... 隔离 Git hook 测试子进程环境并验证外层仓库不变 恢复被测试污染的完整 ESLint 与 Prettier 配置并清除测试产物 撤销无依据的聊天参数和资源初始化时序变更 严格验证 canonical userItem 和现行历史切片契约 同步开发运维文档与共享排障约定	2026-09-16 01:40:58 +08:00
kdletters	eeb0206164	修复 Stdb 发布临时目录权限 ... 将以服务用户执行的 WASM 发布临时目录移到 /var/tmp	2026-09-16 00:03:22 +08:00
kdletters	34db1b6ad1	避免清理失效锁时误删新锁 ... 使用原子重命名隔离失效锁文件	2026-09-15 23:27:37 +08:00
kdletters	6d7b3e74a6	自动清理失效数据库备份锁 ... 失效进程锁自动清理后重试获取 仍存活进程持锁时继续阻断并发备份 补充锁生命周期文档与回归测试	2026-09-15 23:24:36 +08:00
kdletters	2ef9238aa9	修复生产发布备份状态处理 ... 备份锁冲突时写入失败状态 JSON 发布脚本安全解析异步备份状态并保留异常文件 生产发布临时目录统一使用 ~/data/tmp	2026-09-15 22:50:02 +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	0fea75952a	保留显式 sccache wrapper 路径 ... 探测成功后将用户配置的 wrapper 原样交给 Cargo	2026-09-14 18:15:12 +08:00
lhk229	b7100c7188	使用用户配置路径探测 sccache ... Windows wrapper 探测改用显式配置的可执行路径 将 wrapper 路径纳入探测缓存键	2026-09-14 18:15:12 +08:00
lhk229	cf4a275d26	缓存 sccache 探测结果避免重复阻塞 ... 在当前 dev 编排进程内复用 sccache wrapper 探测结果 避免 API 与 worker 重启重复同步等待 同步更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	fed9960684	修正 POSIX sccache 绕过日志 ... 明确记录 Linux 和 macOS 本地开发实际绕过 sccache 补充 POSIX 日志回归测试并更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	a3918c89f0	按显式配置控制 Windows sccache ... 未配置 wrapper 时默认回退到直接 rustc 处理 sccache 探测失败与 wrapper 配置冲突 同步更新开发运维和排障文档	2026-09-14 18:15:12 +08:00
lhk229	f955661146	增强 Windows sccache wrapper 探测回退 ... 使用限时真实 rustc wrapper 探测替代版本检查 探测失败或超时时回退到直接 rustc 同步更新 sccache 故障排障记录	2026-09-14 18:15:12 +08:00
lhk229	5cf5b541af	修正 sccache 测试的平台隔离 ... 为启用 sccache 的用例补充 Windows platform mock 确保 POSIX 环境下测试不会误走 env wrapper 分支	2026-09-14 18:15:12 +08:00
lhk229	dcaa1a2dd5	支持 Windows 本地 sccache 自动回退 ... Windows 本地开发检测可用的 sccache 并启用缓存 未安装或不可执行时清空 Rust wrapper 并回退到 rustc 补充测试并更新开发运维文档	2026-09-14 18:15:12 +08:00
kdletters	2566ae705f	AGC 壳 Rust 套件改为「一片一个 job」，客户端 Rust 关键路径压到 7 分钟以内 ... 上一轮把 2466 条 bin target 单测切成 4 片放在同一个 job 内多进程并行，run 2102 证明这条路 不通：门禁步骤跑满 18 分钟仍未结束，比整套串行的 507 秒还慢——同一容器内这几片共享 HOME、target 目录与固定临时路径，会互相拖慢。这一轮改成按 job 拆分。 - run-rust-shell-test-shards.mjs 新增 --shard-index=<i>：只跑第 i 片，供 CI 的每个分片 job 使用；覆盖自校验（片并集等于 --list 全集且互斥）仍针对全集执行，所以每个 job 都会 发现分片规则改动，不会被"只跑一片"绕过。负例 --shard-index 超出 --shards 立即失败。 不传 --shard-index 时行为不变（一条命令把 N 片放进程里并行），留给本地全量自测。 - project-ci.yml 由 7 个 job 变 11 个：原 AGC Rust job 拆成 AI game creator shell Rust shard 1/4 ~ 4/4 与 AI game creator shell Rust smoke，加上已有的 Rust crates，AGC 相关 门禁共 6 个 job。4 个片 job 只预热 AGC 壳自己那份锁定依赖，且与 smoke、crates 一样都是 纯 cargo 门禁，因此这 6 个 job 都不再执行 npm ci（每个省 1~3 分钟）。 - check-native-shells.mjs 分组由五个变十个：agc-rust-shard-1 ~ agc-rust-shard-4 与 agc-rust-smoke 取代 agc-rust-shell；每个分片分组的命令是 `npm run ai-game-creator-shell:check:rust:shell -- --shard-index=<i>`。 - project-ci-workflow.test.ts 相应更新：11 个 job、6 个 job 免 npm ci、10 个分组各被一个 job 恰好调用一次，并新增「每个分片 job 都落到 --shard-index」「4 个 index 各一次」 「分片运行器保留覆盖自校验」等断言。 - 同步运维文档、development-workflow、decision-log、pitfalls 与 gitea-ci-triage 技能到 job 级分片口径，并记录 run 2102 的反面实验，避免以后又改回单 job 内并行。 验证：npx vitest run scripts/project-ci-workflow.test.ts（12 passed）、eslint、prettier、 check:encoding（13330 文件）、check:doc-index、--groups=contract、mobile check-config 全绿； 分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）验证 --shard-index 四个 index 各自 只跑一片、片 TMPDIR 隔离、无 index 时全量模式不变。Gitea master 分支保护需补 6 个新 context（共十一个），其中含 4 个分片 job、smoke job 与 crates job。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:32:06 +08:00
kdletters	86b830cf2d	AGC 壳 Rust 套件分片并行，客户端 Rust 关键路径压到 7 分钟以内 ... run 2097 显示 AI game creator shell Rust tests 是客户端 CI 的关键路径（15 分 27 秒）： 前置 5 分 30 秒（checkout + npm ci + Cargo fetch）、编译 1 分 39 秒、AGC 壳 bin target 的 2466 条单测一条命令串行 507 秒、agent-run smoke 51 秒。 - 新增 apps/ai-game-creator-shell/scripts/run-rust-shell-test-shards.mjs：cargo test --no-run 编译一次拿到测试可执行文件，用 --list 取全部用例名，排序后按 index % shards 切 4 片，每片作为独立进程执行 <bin> --exact <名单> --test-threads=1，并给每片独立 TMPDIR。片并集必须等于 --list 全集且互斥（assertShardsCoverEveryTest），改分片规则 不会静默漏跑。串行口径只从「整套串行」放宽到「片内串行」：当年 libtest 线程并行会 互相干扰的是进程内后台锁与异步终态，进程分片不共享这些状态，因此不必放宽断言。 - package.json：ai-game-creator-shell:check:rust 拆成 :rust:crates（agent-runtime-core / orchestration / platform-llm / shared-contracts）与 :rust:shell（分片运行器），聚合 脚本保持同序，ai-game-creator-shell:check 与本地全量入口语义不变。 - check-native-shells.mjs：分组由五个变六个（新增 agc-rust-crates、agc-rust-shell， 移除 agc-rust）；smoke 与壳测试同组以共享 AGC 壳的依赖预热。 - project-ci.yml：新增第 7 个 job AI game creator shell Rust crates（预热 server-rs 与 两个无锁独立 crate 后跑四条 crate 测试）；AI game creator shell Rust tests 只保留壳 分片与 agent-run smoke，并只预热 AGC 壳自己那份 manifest（其 Cargo.lock 的 path 依赖 已覆盖 platform-llm / platform-agent / agent-runtime-core / shared-contracts）。 这两个 job 只用 cargo 与 node 内建模块，因此都不再执行 npm ci（各省 1~3 分钟）。 - project-ci-workflow.test.ts：新增纯 cargo job 免 npm ci、分片运行器覆盖校验、crate 级 job 预热顺序等断言；同步运维文档、development-workflow、decision-log、pitfalls。 验证：分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）与 platform-llm（146 条 → 49/49/48）验证分片、--exact 与片 TMPDIR 隔离，参数负例 exit 1；vitest scripts/project-ci-workflow.test.ts 12 passed；contract 分组、AGC 与 mobile 壳 check-config、eslint、prettier、check:encoding（13400 文件）、check:doc-index 全绿。 Gitea master 分支保护需补 Project CI / AI game creator shell Rust crates (pull_request)。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:02:34 +08:00
kdletters	11beb65c36	修复桌面壳对根门禁 label 字面量的断言 ... run 2095 的 Native shell tests 红了，失败点是 desktop-shell 的 typecheck： apps/desktop-shell/scripts/check-config.mjs 断言根门禁脚本必须包含 `console.log('[check:native-shells] desktop-release-binary-artifact')` 字面量， 而拆分时我把 label 挪进了公共打印函数 runNativeShellGate(group, label, gate)， 源码里不再有这个字面量，断言随即报 「root native shell gate must keep desktop release artifact check」。 - runNativeShellGate 收窄为 (group, gate)：label 改回各门禁执行体里的字面量打印， 分组能力、日志格式与 `--groups=` 语义都不变，外部按字面量做的快照断言继续有效。 - 在该函数旁注明不要把 label 抽成变量：apps/desktop-shell 与 apps/mobile-shell 的 check-config 都会读取根脚本源码做字面量断言。 验证：node --check 通过；contract 分组通过（groups=contract + OK）；mobile-shell check-config exit 0；desktop-shell check-config 已越过第 740-777 行的根脚本断言 （本机只卡在本机不存在的 Tauri 生成产物目录，Linux CI 不受影响）； vitest scripts/project-ci-workflow.test.ts 11 passed；eslint 通过。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:26:10 +08:00
kdletters	20f109027a	按门禁组拆分客户端 CI，AGC 的 web / rust 两段并行 ... 原生壳门禁原本挤在同一个 job 里串行执行，跑一遍 18 分 37 秒，其中 AI 游戏创作 壳独占约 15 分钟（壳内 Rust 套件 2451 条用例串行 441 秒），而微信 / 移动 / 桌面 / H5 的全部门禁加起来不到 50 秒。长尾拖住短门禁，runner 也无法并行。 - scripts/check-native-shells.mjs 支持 `--groups=`（contract / shells / agc-web / agc-rust / release）：每个步骤与静态断言归属且只归属一个分组，不带参数时仍按 原顺序串行跑全部分组，本地 `npm run check:native-shells` 语义不变。 - 顺带修掉 H5 HostBridge 调用链扫描在 Windows 上恒红的缺陷：collectFiles 返回 反斜杠路径而期望清单是 POSIX 写法，scannedFiles.has() 永远为假。新增 normalizeScannedFilePath 只统一分隔符（不能复用会去后缀的 normalizeModulePath）， 在 Linux 上是恒等变换。 - package.json 增加 5 个分组脚本，并把 ai-game-creator-shell:check 拆成 :check:web 与 :check:rust；聚合脚本保持 web && rust && agent-run:smoke 同序。 agent-run smoke 会 spawn cargo，因此归入 agc-rust。 - .gitea/workflows/project-ci.yml 拆成 6 个 job：新增 native-shell-tests（contract + shells + release）、ai-game-creator-shell-web-tests、ai-game-creator-shell-rust-tests 三个门禁 job，与 backend-tests / frontend-tests / repository-checks 并列。 - scripts/project-ci-workflow.test.ts 增加 3 条结构测试：分组恰好被一个 job 调用且 与脚本内声明一致、CI 不再调用全量入口、AGC web/rust 拆分与聚合脚本等价、独立 crate 预热必须发生在 AGC Rust 门禁之前。 - 同步运维文档、development-workflow、decision-log、pitfalls。 验证：`--groups=contract` 本地通过；vitest 11 passed；eslint 与 prettier 通过； check:encoding 13329 文件通过；check:doc-index 103 份通过。shells / agc-web / agc-rust / release 分组只能由 Linux CI 执行（Windows 上 spawnSync npm.cmd 报 EINVAL，属既有平台限制，非本次引入）。分支保护需补两个新 required context： `Project CI / AI game creator shell web tests (pull_request)` 与 `Project CI / AI game creator shell Rust tests (pull_request)`。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:13:11 +08:00
kdletters	c146f7f99c	建立 AGC 稳定版生命周期基础合同 (#348) ... ## 变更内容 这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重： - 新增统一 `ClientOperation` 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定； - 认证 refresh 投影 `auth-refresh` operation；登录、401 refresh、退出共用平台 session generation，并由 `auth-transition` 投影 Runner phase/成功/失败/不确定状态； - 首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation； - `.app/dev-stack.json` 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用； - 新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientOperation.test.ts tests/clientApi.test.ts tests/clientHttp.test.ts tests/recentProjectsModel.test.ts tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`（61 passed，2 skipped） - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot`（423/423 passed） - `node --check scripts/dev.mjs` - `node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `scripts/dev.test.ts` 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。 Reviewed-on: #348	2026-09-14 13:56:56 +08:00
lhk229	637bd90073	修复 Windows Git hook 测试链接权限 ... Windows 测试 fixture 使用 junction 创建 node_modules 目录链接 保留 Linux 目录符号链接行为并消除普通权限下的 EPERM	2026-09-13 11:46:45 +00:00
suzmii	840a62f7d0	合并 master：规范化历史文档并合入 AGC 插件宿主能力（#339） ... - 合入 origin/master 96b45e6ff，使 PR 头包含当前 master tip，修 CI comparison base 门禁（15 秒红） - master 侧 28 个文件，零冲突自动合并 - 验证：npm run typecheck exit 0；check:encoding 通过；git diff --check 干净	2026-09-13 17:11:06 +08:00
kdletters	96b45e6ffc	规范化历史文档并合入 AGC 插件宿主能力 (#339) ... ## 变更 - 建立文档生命周期与现状索引，统一 `current`、`historical`、`review`、开放事项和活动计划边界。 - 为历史/待复核文档补充状态头，将有源码与测试证据的专题纳入当前入口。 - 新增规范驱动开发 skill 与 `check:doc-index` 门禁，并接入 `lint`。 - 合入 `origin/master` 的 AGC 通用插件宿主与 Cocos Creator 编辑器能力，并补充父子规范关系和验收范围。 ## 合并说明 - 合入基线：`origin/master` `4a46f89c9`。 - 合并提交：`259134b59`。 - 合并过程无冲突。 ## 验证 - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` - `python -X utf8 C:/Users/kdletters/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/spec-driven-development` - 推送前 pre-push master 门禁通过。 ## CI 请以本 PR 的 Gitea CI 检查为准；提交后持续关注，失败时按失败 job 继续修复。 Reviewed-on: #339 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-13 16:21:34 +08:00