76 Commits

Author	SHA1	Message	Date
suzmii	e6849d2a45	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 20:45:21 +08:00
kdletters	d5743cd4b8	资源画布支持引擎资源预览与模型交互预览 (#413) ... ## 目的 资源画布支持引擎（Cocos Creator）资源的**只读预览**：能被发现、登记、进入画布，并按类型出预览。 ## 主要改动 - 发现层识别 Cocos 资源并区分 `model` / `binary` 两个发现类别；`.meta` 等导入侧车文件仍只可发现 - 登记层按扩展名写入**既有** canonical kind（模型/场景/预制体 → `scene`，动画 → `character-animation`，材质/特效 → `code`，图集与容器 → `document`），不新增 manifest 契约字段 - 引擎工程的 `library/` / `temp/` / `profiles/` / `local/` 不再进入发现结果（仅当目录确实是 Cocos 工程），同名目录在非引擎工程里照常列出 - 资源画布新增三个卡面分支：模型缩略图（整页共用一个 WebGL 上下文）、结构摘要（Cocos 序列化资源）、类型卡（客户端解不了的容器） - 新增模型放大预览浮层：左键旋转 / 右键或中键平移 / 滚轮缩放 / 复位视角 - 模型预览上限 32 MiB；缩略图按布局尺寸 2 倍超采样，缓存键改用稳定身份 - 引擎图像容器（tga/tif/tiff/hdr）在原生侧转码成 PNG 后复用既有图片预览链路 - 修复资源卡状态边框吃掉内容盒导致的卡面与角标位移 - 同步 Agent 提示词与 AGC 技能文档，并补里程碑与踩坑文档 ## 验证 - `cargo check`、`cargo fmt --check` - Rust 定向：`cargo test … cocos` 9 条、`resource_inspect::tests` 7 条、`agent_asset_import_tests` 9 条、生成目录过滤用例 - 前端：`resource` + `project` 套件 52 文件 / 546 用例；`appSurface` 450 通过 / 20 跳过；app `tsc --noEmit` - `npm run check:encoding`、`git diff --check`、`npm run check:doc-index` - 真机：在真实客户端内打开本地 Cocos 夹具工程，逐栏核对模型缩略图 / 结构摘要 / TGA 转码 / 类型卡，并量过卡片在指针移开、悬停、选中三态下几何完全一致 ## 未验证 - 模型缩略图与放大预览的真机视觉只覆盖自带夹具工程；多文件 glTF（外部 .bin/贴图）与超大模型仍是类型卡 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/413	2026-09-17 20:28:39 +08:00
suzmii	c329c438d9	修复资源画布PR的CI回归（#410） ... 修复活动回合空快照引用及停用后晚到请求覆盖问题 对齐共享卡片角标与窗口发布次数回归断言 同步原生HTTP权限检查与图集显式切片测试契约 整理菜单组件导入顺序并记录本地验证范围	2026-09-17 20:17:26 +08:00
suzmii	959beebf63	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 19:30:00 +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
suzmii	7edc452c6a	重构AGC资源画布菜单与卡片入口（#409） ... 主菜单保留前五项，其余操作通过向上展开的更多菜单访问 类型与信息入口下沉资源卡片，并复用共享画布角标 补充菜单键盘、滚轮归属、换选及资源操作链路回归 同步方案A规范与待人工验收记录	2026-09-17 18:09:27 +08:00
kdletters	a5fd25f10a	客户端更新切换到官方更新插件并按渠道分发 ... - 客户端接入 tauri-plugin-updater：原生侧注册插件，删除自研更新下载命令、下载进度事件与安装器启动逻辑 - 客户端更新服务与更新提示改走官方插件接口，删除自研清单解析、版本比较与下载实现 - 更新能力只授予客户端主窗口，移除只为自研清单放行的 OSS 白名单与 CSP 连接项 - 新增构建期更新检查开关：开发态默认关闭，agc 启动不请求更新清单、不显示更新入口 - 发布脚本按渠道生成官方更新插件清单与签名，universal macOS 产物同时挂两个平台键，缺签名失败关闭 - 发布脚本按渠道上传安装包、签名与渠道清单，并为 dev-win 生成旧协议 sha256 迁移清单 - 构建期按渠道注入更新端点配置，渠道与目标平台不匹配时发布失败关闭 - Jenkins 流水线新增渠道参数与签名凭据注入，归档补充签名与迁移清单 - 新增发布上传 dry-run 开关，只打印 ossutil 命令且不回显凭据 - 更新技术方案与开发运维文档，登记 macOS 渠道落地待办	2026-09-17 17:56:53 +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
suzmii	036395c6c9	修复历史重读后旧消息追加到末尾的乱序 ... 区分历史回读与实时消息来源，保留运行时所有权语义 防止旧页消息在历史刷新后追加到最新回复末尾 增加重新读取历史后再次翻页的顺序和去重回归 同步对话历史规范与实施计划	2026-09-17 13:54:00 +08:00
suzmii	d1f53fda4d	Merge branch 'master' into fix/agc-canvas-json	2026-09-17 13:05:33 +08:00
suzmii	9d374a57b1	修正运行不可用提示的过期测试契约 ... 恢复运行提示与资源选择解耦的业务逻辑 更新界面源码契约测试，保留资源选中交互回归 补充运行提示及无障碍关联的验收口径	2026-09-17 11:51:14 +08:00
lhk229	16deb0ad61	补齐抠图参数透传与验收 ... 修复flat自动识别门禁并严格校验模式和颜色 保持旧请求幂等指纹并区分客户端抠图意图 同步工具说明和Skill契约并补充定向测试 记录真实BgFilter验证及本地数据库阻塞的待验收项	2026-09-17 00:54:28 +08:00
suzmii	ac8a51ca79	同步master最新基线并准备画布修复PR ... 合入平台会话与主线测试修复 保持画布交互、JSON识别和对话历史分页修复范围不变	2026-09-16 18:59:32 +08:00
suzmii	1b010fb1f8	修复DirectProject对话历史分页卡页 ... 聊天历史按有效消息分页并返回原生游标，保留默认原始切片接口 工具和推理记录不占聊天页名额，逐行过滤避免传回大段工具输出 隔离重新加载和项目切换的迟到响应，补齐单飞、重试与消息去重 补充原生和真实App回归测试，增加人工只读日志重放入口 更新B05状态、规范与PR验收记录，不提交用户原始日志	2026-09-16 18:46:47 +08:00
kdletters	31f83a751a	三维请求自选技术栈，不再固定 Phaser ... - DirectProject 系统提示新增三维请求合同：三维请求不受 Phaser 4.2.1 约束，由 Codex 自选三维技术栈 - 工程合同的 Phaser 固定约束按二维/三维分层，点名引擎的不匹配澄清规则保持不变 - 新增三维意图识别、三维回合合同与首页三维提示；伪 3D、等轴与代码话题不触发 - 补定向用例与里程碑/实施计划文档，并在 decision-log 记录该决策	2026-09-16 18:04:44 +08:00
suzmii	910862fd06	修复AGC画布交互并识别UI设计JSON ... 稳定工作台与窗口标题栏状态同步，消除重复更新循环 支持画布右键平移并保留左键框选及资源拖动，完善中断清理 解耦运行不可用提示与资源选中状态 复用原生UI状态校验区分UI设计JSON和普通JSON，接入现有编辑器与代码预览 补充前端和原生回归测试、规范及待验收记录，明确对话历史分页尚未修复	2026-09-16 17:39:23 +08:00
kdletters	e08171fd2e	补记平台会话身份与凭据分离的规范与记忆 ... - 主规范新增平台会话身份与凭据分离条款，并修正长回合保活的口径 - 共享记忆补充并发生图登录态冲突的排障口径与验证方式 - 决策记录补充身份代次、凭据轮换、刷新失败语义的长期决策 - 新增本次里程碑与实施计划，记录证据与未验证项	2026-09-16 17:08:47 +08:00
suzmii	5cd02aa8b0	统一智能体对话层级并完善素材导出与文档预览 ... 当前Agent与策划Agent共用正文和过程表现组件，统一思考及工具调用的小字号浅色样式 素材工具栏按实际动作分组，导出紧邻删除并修复空分组重复分隔线 文档与代码使用共享Markdown预览和代码高亮，复用按需读取与缓存 移除未调用的活跃回合查询命令，保留正式快照恢复链路 补充回归用例并同步技术方案和团队约定	2026-09-16 03:59:27 +08:00
suzmii	d3c117de01	合并master最新变更 ... 同步主分支的错误反馈重试与工作台入口调整 保留回合流去重、快照落盘收尾与对话输入文案	2026-09-16 03:39:21 +08:00
suzmii	7a7a841733	修复回合重进状态并收起已完成执行过程 ... 活动回合快照与Direct事件统一管理生命周期，避免历史终态回放恢复忙碌态 用户消息显示发送时间，历史信封保存时间并通过独立映射回读 完成后统一折叠中间输出和工具调用，最终回复与失败提示保持可见 同步回归用例与规范文档，保留原生实机验收待办	2026-09-16 02:57:27 +08:00
Git Hooks Test	d650bf9b74	完善项目工作台入口与账户兑换码 ... 修复 DirectProject 提交时的项目快照空值类型错误 将运行中项目列表移入窗口标题栏并支持展开查看 增加项目内打开项目目录按钮 在账户资产条中直接显示兑换码入口并保留兑换弹窗 补充相关测试、类型检查与产品文档	2026-09-16 02:39:12 +08:00
suzmii	09791eb9e4	统一对话回合投影并优化工具命令展示 ... 按回合唯一归属渲染正文与工具，修复完成快照冲刷和历史归并 补齐工具输入输出，Windows命令卡片隐藏PowerShell启动器包装 时间显示精确到秒，结束信息右对齐并调整输入框文案与引用按钮间距 同步回归用例与规范文档，保留实机验收待办	2026-09-16 02:30:28 +08:00
kdletters	01e97d3a02	补齐 Direct 回合跨页面恢复 ... 新增活动 Direct 回合只读快照与状态更新 接入重进项目的忙碌态恢复和运行中项目面板 补充生命周期规范、决策记录与定向测试	2026-09-15 23:38:09 +08:00
kdletters	9a9d1d6b72	补齐 DirectProject 更早历史入口 ... 补充 DirectProject 初始历史 hasMore 时的按钮与滚动入口 修正 rebase 后 Tauri 命令与 Rust 测试辅助函数可见性 同步更新 DirectProject 历史恢复规范与里程碑验收记录	2026-09-15 23:38:09 +08:00
k88936	62466de01a	补充DirectProject事件订阅规范 ... 补充Thread Manager全局事件队列、subscriber cursor与consume契约 补充持久化顺序、队头回收、过期重订阅和历史锚点规则 新增Thread Manager里程碑规范与小步实施计划	2026-09-15 23:38:00 +08:00
k88936	4ed342d882	更新用户 Response item 里程碑进度 ... 标记 canonical、wire 与失败关闭验收项 同步实施计划为进行中状态	2026-09-15 23:37:59 +08:00
k88936	24bbdfda7d	新增 DirectProject 用户 Response item 契约 ... 新增 Rust canonical user item 与 Codex wire 转换模块 增加 ts-rs 绑定目录及生成文件检查边界 更新聊天素材引用规范与里程碑实施计划	2026-09-15 23:37:56 +08:00
kdletters	361daf374d	修复 AGC 统一错误诊断与素材验收 (#376) ... ## 变更内容 - 新增统一 Agent Runtime 错误事件和项目内诊断 sidecar，统一 DirectProject、Agent Runtime、app-server 与 AGC 工具桥的失败记录。 - 失败回执写回 DirectProject 对话历史，下一轮可读取上一轮失败证据；前端支持读取脱敏诊断详情。 - 区分 app-server 终态、空闲/硬超时、工具参数错误和试玩次数越界。 - 素材完成门扫描实际 npm 源码模块，并识别 manifest 中合法的自定义登记素材路径。 - 更新 AGC 技术规范、项目决策记录、里程碑和实施计划。 ## 验证 - cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --tests - 统一错误测试 6/6 通过 - DirectProject 失败诊断测试 4/4 通过 - npm 场景模块素材引用回归测试通过 - npm run --prefix apps/ai-game-creator-shell typecheck - npm run check:encoding - npm run check:doc-index - git diff --check、Rust 格式检查 真实 Provider / 安装包 smoke 尚未在本 PR 中运行。 --------- Co-authored-by: Git Hooks Test <git-hooks-test@example.invalid> Reviewed-on: #376	2026-09-15 20:21:53 +08:00
kdletters	a319a24cba	回退Direct回合生命周期规范提交3dfb8056d ... 回退 3dfb8056d：删除新增的《Direct回合跨页面生命周期与运行中项目可见性》里程碑与实施计划两份文档 回退 3dfb8056d：移除 AGC 主规范中的 Direct 回合跨页面生命周期章节及其快照失败重试条款	2026-09-15 15:58:42 +08:00
kdletters	3dfb8056d0	新增Direct回合跨页面生命周期规范并固定快照失败重试3次 ... 新增《Direct回合跨页面生命周期与运行中项目可见性》里程碑与实施计划，约定离开项目页面不终止回合、重新进入需恢复忙碌态与进度并以快照 sequence 续接 主规范补充 Direct 回合跨页面行为合同、左上角运行中项目面板契约与验收标准 读取活动回合快照失败改为最多重试 3 次，3 次全部失败才向用户告知失败原因，且不得改写成业务、权限或审批结论	2026-09-15 15:54:16 +08:00
lhk229	9389c7fff8	修正 AGC 策划补全说明 ... 更新首页启动模式注释以覆盖游戏策划补全分支 同步实施计划与当前测试覆盖边界	2026-09-15 12:26:57 +08:00
lhk229	fbf8d34f45	新增 AGC 首页策划补全入口 ... 首页做游戏入口增加策划补全勾选项 勾选后复用 planning Agent Runtime 启动模式 补充首页启动模式回归测试与实施计划	2026-09-15 12:14:03 +08:00
lhk229	9aa6f5efea	解决platform-llm和策划agent reasoning问题，并修复若干bug (#350) ... Reviewed-on: #350	2026-09-15 00:50:36 +08:00
kdletters	4e553bb15d	收窄项目写锁同进程复用判据为同线程重入 ... - 修复 write_lock.rs：advisory 复用判据从「本进程持锁」收窄为「同一线程重入或自主流水线」，新增按锁路径登记真实持锁线程的 PROJECT_WRITE_LOCK_THREAD_OWNERS，登记在 create_new 成功处、在 guard Drop 里按路径注销（guard 会被移到别的线程再 Drop） - 恢复本进程其它线程写通道的串行化：一致快照读、project.diff / action_history、command.output_read、steer 序号分配、项目 revision 侧车、pending sidecar 复核与恢复安装重新等待并保持终态占用 - 调整 tests/project_tools.rs 的 agent_runtime_file_write_lock_failure_redacts_project_path：改为在另一条线程持锁，保持「别的写者持锁时 file.write 失败关闭且脱敏」的断言语义 - 调整 ui_editor/persistence.rs 的 recovery_install_respects_the_project_write_lock：同样改为在另一条线程持锁，保持占用失败断言 - 同步技术方案「2026-09-14 项目客户端占用锁收敛」段落，以及里程碑和实施计划的目标、验收标准、修改顺序、验证命令与未决事项 - 在 decision-log 记录复用判据收窄为同线程重入，并在 pitfalls 记录「同进程复用判据不能只看 pid」的现场、原因、处理与易错点 - 回答 AGC 生命周期文档「同 PID advisory guard 是否放过并行写」的未决项：确认会放过并行写，已收窄 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 15:41:17 +08:00
kdletters	0f829cd252	完成 DirectProject Phaser 迁移闭环 (#353) ... ## 变更 单 HTML → Phaser 4 + Vite 的迁移链路现在有明确且可执行的工程合同：Phaser/npm 目标固定走 DirectProject，旧 JSON Generator 继续只处理单文件 HTML。 - 新增受控 `project.bootstrap`，仅允许项目内 `game` 目录执行无参数 `npm install`，校验 package/lock、路径、npm 管理器并记录依赖指纹。 - `project.verify` 支持相对 `cwd`，构建前诊断缺失依赖，`cwd=game` 的 build 必须产出 `game/dist/index.html`。 - npm bootstrap 使用受控网络沙箱；通用 `command.exec npm install` 仍被拒绝。 - 同步 Runtime 工具广告、执行分发、审计、权限策略、DirectProject/Generator 提示、前端权限面板、TypeScript/Rust 契约和项目文档。 - Phaser 迁移提示覆盖 Scene、输入、敌人/守卫、波次、胜负、重开和桌面/移动双视口验收。 ## 验证 - `npm run ai-game-creator-shell:typecheck` - `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` - `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check` - `cargo test --locked -p shared-contracts --manifest-path server-rs/Cargo.toml game_creation_app` - 定向 `project.verify` Rust 测试 - `npm run check:encoding` - `npm run check:doc-index` - `git diff --check` - 真实 DirectProject：`npm install`、`npm run build` 成功，`game/dist/index.html` 存在。 - 浏览器试玩：桌面视口画布非空；移动视口触摸开火、键盘换道和重开逻辑均已观察确认。 真实项目没有纳入仓库提交；PR 只包含客户端合同、Runtime 能力和验证门禁。 Reviewed-on: #353	2026-09-14 13:57:24 +08:00
kdletters	818cfdba50	收敛项目客户端占用锁语义 (#344) ... 本 PR 收敛项目锁的同进程重入语义，避免客户端内部调用等待自身持有的 `.agent/project.lock`。 变更： - 同进程嵌套项目锁返回 advisory guard，不删除真实持有者锁。 - 跨进程占用、残留回收和权限分类保持不变。 - 增加回归测试与锁收敛里程碑/实施计划文档。 验证： - 定向 Rust 锁测试通过。 - Runner owner 定向测试通过。 - cargo fmt --check 通过。 - npm run check:encoding 通过。 - git diff --check 通过。 后续里程碑：Runner 的 `.agent/runtime/execution-owner.lock` 迁移到统一项目占用锁仍需单独完成跨进程生命周期验证。 Reviewed-on: #344	2026-09-14 13:56:23 +08:00
kdletters	969dcc0272	整理项目文档并统一当前口径 ... - 删除过时 PRD、设计、计划和退役文档 - 收口文档索引、产品基线、玩法链路和共享记忆 - 清理历史决策重复内容、断链和本机路径 - 更新 AGC Runtime、Provider、后端与运维当前约束	2026-08-26 10:11:46 +08:00
kdletters	c09a511aaa	Codex/fix pr188 191 ci (#194) ... Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/194 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-08-25 15:41:55 +08:00
kdletters	9f8a24fc23	解锁AGC直连Codex原生工具 ... 精简DirectProject系统提示词与浏览器证据回传 开放受沙箱约束的原生文件搜索命令和Skill 通过本地凭据代理隔离Provider真实密钥 保留agc_tools账本与Runtime持久化权威 同步更新AGC技能包指纹和架构文档	2026-08-24 22:21:23 +08:00
kdletters	d8a7e814f2	实现AGC直连增量进度反馈 ... 新增 direct turn update 事件与安全活动、正文增量、序号及终态生命周期 接入 Codex app-server 活动观察并限制高频活动通知 在 AGC 项目聊天渲染过程卡并保护项目与回合隔离、乱序门禁和自动跟随 补齐 direct 增量反馈的前端、Rust 回归测试与 Direct Interaction Event v1 文档	2026-08-23 01:54:28 +08:00
Git Hooks Test	32da013545	修复AGC Skill跨平台指纹漂移 ... 统一以UTF-8 LF规范化内容计算Skill与清单指纹 安装隔离Skill时写入规范化文本避免Windows混合换行 增加LF与CRLF等价及安装结果回归测试 同步Skill Pack版本与实施文档、技术方案和踩坑记录	2026-08-23 01:20:28 +08:00
Git Hooks Test	d83551dd65	恢复AGC首页三类创作入口 ... 恢复做游戏、做素材、做方案的类型状态与分类提示 将受限 creationType 作为结构化首轮上下文传入项目内 Codex，保持用户原文不变 修正三项内置 Skill 指纹并补齐前端、Rust 与文档回归	2026-08-22 10:46:33 +08:00
Git Hooks Test	2d99a12196	修正首页自动建项目后进入项目对话 ... 恢复首页自动项目创建并移除无项目对话入口 首条正文与附件在新项目工作台内交给直连 Codex 补充 Tauri 命令、配置门禁、AppSurface 测试与迁移计划	2026-08-21 17:48:01 +08:00
kdletters	e8d9367df7	修复AGC依赖锁文件缺失 (#174) ... ## 问题 合并后的 `master` 连续暴露了三个既有的 AGC 原生构建 blocker： 1. `npm ci --prefix apps/ai-game-creator-shell` 因 lockfile 缺少 `@emnapi/core` / `@emnapi/runtime` 嵌套节点而失败。 2. 修复安装后，Linux Tauri build 又因通用配置无条件引用未生成的 Windows Codex 侧车而失败。 3. Native shell 全量测试继续暴露三项内置 Skill 指纹从初次提交起即与最终文件字节不一致，以及 Linux 会把 Windows 路径语法误判为普通相对路径。 这些问题都在画布优化合并前的 AGC 集成提交中已经存在；画布优化未修改 AGC manifest、lockfile、Tauri 配置或 Skill Pack。 ## 修复 - 使用子包 manifest 重新生成独立 package-lock 元数据 - 恢复 Tailwind oxide WASM bundled `@emnapi` 节点并保留 npm 元数据规范化 - 把 Codex Windows x64 侧车映射从通用配置迁到 `tauri.windows.conf.json` - 配置门禁同时约束通用配置无 Windows resource、Windows 配置保留完整白名单 - 重算三项内置 Skill 内容指纹并提升审核包版本 - Skill 引用路径按平台无关规则拒绝反斜杠、盘符、UNC、绝对路径和父目录段 - 补充 MCP 回归，并同步技术方案、迁移计划和长期排障记录 ## 验证 - npm 10.9.7 / npm 9.2.0：`npm ci --prefix apps/ai-game-creator-shell` 通过 - Linux：`npm run ai-game-creator-shell:build -- --no-bundle` 通过 - Skill 指纹 5/5 复算匹配；Skill / MCP 定向测试通过 - `npm run check:native-shells` 完整通过：AGC Rust `2159 passed / 0 failed / 15 ignored`，最终输出 `[check:native-shells] OK` - `npm run check:encoding`、`npm run check:rustfmt`、本次目标文件 Prettier、`git diff --check` 通过 - AGC、desktop、server-rs Cargo.lock 与两份 package-lock 均无漂移 Reviewed-on: #174 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-08-21 17:38:58 +08:00
Git Hooks Test	9d73f9a157	修复直连 Codex 长任务验收等待 ... 扩大 DirectProject 基础、MCP 与整回合有界等待并统一工具超时 明确禁用 shell 时使用文件快照和结构化试玩证据，避免误报能力阻断 同步真实陶泥儿生图、幂等复用与双视口浏览器验收记录	2026-08-21 13:30:06 +08:00
Git Hooks Test	bacd7a9da7	完成 AGC 直连 Codex 与审核 Skill 工具链 ... 收口首页和项目聊天为唯一 Direct Codex thread 内置五项审核 Skill Pack 与受控 MCP、浏览器及美术工具桥 补齐 Codex Windows 侧车组件、Provider 代理和凭据幂等边界 同步客户端资源投影、交互测试及技术文档	2026-08-20 23:55:00 +08:00
kdletters	4bf6c50a56	修复AGC开发者凭据目录权限初始化 ... 允许客户端自动收紧当前用户持有目录的继承 ACL 保留 foreign owner 与异常路径的失败关闭边界 补充 Windows 回归测试并同步实施决策文档	2026-08-20 14:11:59 +08:00
kdletters	bdf7ed288a	放宽直连游戏验收并增加运行时素材证据 ... - 将固定四切片与固定 drawImage 降为推荐路径 - 在导航前注入 Canvas/WebGL 平台素材运行时观测 - 对缺少核心素材渲染证据的 desktop/mobile 视口回灌同一 Codex thread 整改 - 补充直连验收、浏览器脚本与真实 Chrome fixture 测试 - 同步 AGC 直连 Runtime 实施计划	2026-08-18 13:14:45 +08:00
kdletters	94200a3cdb	修复AGC直连聊天持久化与生成竞态 ... 持久化直连用户消息和最终安全回复，并在重开项目时恢复 补充直连聊天与工作台验收回归测试 直连美术生成和版本登记等待项目写锁，避免首轮生成被聊天保存阻断 同步直连 Runtime 实施计划	2026-08-17 20:11:22 +08:00