367 Commits

Author	SHA1	Message	Date
suzmii	2c07396ef7	补充 AGC 复用网页端美术画布组件的跨端依赖排障记录 ... - pitfalls 新增一条：AGC 引 src/components/image-editor 组件会经 ImageCanvasGenerationModel 的 ApiClientError 值导入链到 src/services/apiClient.ts 与 host-bridge/hostBridge.ts，而它读的 wx / ReactNativeWebView / WeixinJSBridge 只在主仓 vite-env.d.ts 声明 - 记录处置口径：在 apps/ai-game-creator-shell/src/vite-env.d.ts 的 Window 上补同名同形字段（纯类型声明零运行时影响），不要关闭 AGC 的 noImplicitAny，也不要另写平行组件 - 记录已核实的运行时结论：hostBridge.ts 模块作用域只有常量与缓存声明、无导入即执行副作用，window.wx 仅在函数体内访问且有 typeof window 守卫，故该依赖链编入 AGC bundle 是惰性的	2026-09-10 14:56:45 +08:00
suzmii	48700083a3	补齐 AGC V3 资源口径与环境约束的权威文档 ... - PRD §5.4 版本记录补充"只允许追加"的唯一例外：用户显式确认的连带删除，并写明放行集合按写入前 manifest 求值、被放行版本不得进入追加段 - decision-log 新增三条 2026-09-10 定稿：版本绑定恒等化并撤回运行期资源观察侧车；素材删除新口径（三分支 + 可选连带删除版本）；资源画布交互 1:1 复刻美术画布（取消资源详情面板与全屏编辑路由、复用共享组件以可选 prop opt-in、AGC 宿主自备 chrome 样式） - pitfalls 新增四条：新工作树的 cargo 必须在 npm ci 之后跑；残留 dev stack 会拖死 Rust 门禁；改共享美术画布组件时 AGC 门禁覆盖不到它自己的测试；AGC 侧没有 image-canvas-editor__* chrome 样式	2026-09-10 14:26:57 +08:00
suzmii	3f5d3b43af	合并最新 master 到 AGC V3 资源画布分支 ... - 合入 origin/master 6 个提交（#313 项目写锁残留回收与启动诊断、#315 AGC Ctrl+C 残留后端修复） - 冲突解决：decision-log.md 保留 V3 两条 2026-09-09 决策与 master 的写锁回收条目 - 冲突解决：pitfalls.md 保留 V3 转场经验条目与 master 的 Ctrl+C 后端残留条目	2026-09-09 21:46:09 +08:00
suzmii	c936268337	Merge branch 'feat/agc-canvas-real-flip' into feat/agc-canvas-resource-workbench-v3	2026-09-09 21:40:37 +08:00
suzmii	4a5b2ad524	修复返回总览时非活动栏目标题栏从屏幕外飞入 ... - begin 只记录当时可见的节点：不可见节点（内联 opacity 0）的屏幕矩形不是可信的 First - 非活动栏目标题栏在子画布态保留总览布局坐标，却被子画布 world 变换推到屏幕外，返回总览时不再以它作为动画起点 - 没有 First 的节点只走淡入，位置保持不动；活动栏目标题栏仍按原有观感收回到总览位置 - 进入栏目方向不受影响：标题栏当时可见，仍钉在原地淡出 - 新增回归用例：不可见标题栏几何首末相等、活动标题栏仍有几何动画、进入方向标题栏原地淡出 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 21:39:20 +08:00
suzmii	4582231b78	合并 C3：资源画本转场改为真实元素 FLIP ... - 合入 feat/agc-canvas-real-flip（resourceBookController 重写为同节点 FLIP、新增 sync 可中断重基、删除 ResourceBookTransitionLayer） - 冲突解决：index.tsx 的 resourceBookLayout 导入取 C3 版（buildResourceBookScenePlan 等），去掉已被收进内部的旧 helper 导入避免未使用 - 冲突解决：资源自由画板文档的验证命令合并两侧并去掉已删除的 assetCanvasSurface.test.tsx	2026-09-09 21:24:13 +08:00
suzmii	4c935ba219	同步 asset-canvas 退役后的文档现状并迁移仍有效合同 ... - 新增 docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md，承接阶段一合同第 16 节与第 5 节的现役条款，改写为 derive + editKind='image-reference' 口径 - 图片画布编辑器前端拆分计划新增"共享画布合同"一节，承接共享包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期 - GameAgent资源自由画板与快速编辑删除精修草稿、最终图事务、精修来源规范化、事务恢复对账、批量导入与失败任务归档等退役章节，改写目标与操作边界，新增"编辑结果投影与焦点竞态"一节，并更新验证命令 - App实施计划删除阶段一至五的草稿画布描述，改写为共享画布源码与资源派生闭环现状，修正主视窗状态、适配器与派生提交条款 - 项目开发工作台 PRD 更新主视窗状态机与 ProjectWorkbenchViewState，移除 asset-canvas 状态 - decision-log 追加 2026-09-09 asset-canvas 整体退役决策（含保留项、路由口径、临时白名单与存量数据处置） - pitfalls 删除草稿 CAS、素材保存区、正式素材提交原子性、生成账本与 upload ticket 五条退役条目，修正仍有效条目的关联文件与 legacyPrefix 描述	2026-09-09 20:28:22 +08:00
suzmii	4fb0de2c94	C3 资源画本转场改为真实元素 FLIP ... - resourceBookController 重写为真实元素 FLIP：begin 在提交前记录 First，play 测 Last 后给同一节点加反向 transform，sync 按布局签名做可中断重基 - 转场进行中重基用剩余时长（下限 80ms），空闲布局变化用完整 420ms，预览图尺寸晚到的二次布局变化不再瞬移 - 宿主节点几何基准改存 world 局部坐标，平移和缩放不会让上一次的干净矩形过期 - 不可见节点钉在 First 淡出、挂载节点淡入；搜索/排序导致的卸载保留一帧淡出；返回总览时源栏目未回到摞上的卡片按子画布布局淡出 - 新增 buildResourceBookScenePlan 渲染计划，渲染、转场签名与淡出集合共用同一份数据 - 删除 ResourceBookTransitionLayer 与克隆快照逻辑，清理 styles.css 的转场层和 data-book-motion 隐藏规则 - 重写 resourceBookController.test.ts，补 resourceBookLayout/resourceBookModel 用例与 appSurface 同节点断言 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 20:24:10 +08:00
suzmii	a1b9b24891	修复 AGC Ctrl+C 残留上个工作树后端导致切换工作树复用旧后端 (#315) ... closes #314 ## 现象 `npm run agc` 按 Ctrl+C 后有概率残留上个工作树的 `api-server.exe` / SpacetimeDB，切换 worktree 再启动时 AGC 复用旧后端，改过数据库 / schema 的工作树会串库。 ## 根因 1. Windows 下长驻服务都经 Node `shell: true` 的 `cmd.exe /d /s /c` 包装层启动，Ctrl+C 先杀包装层（`0xC000013A`）；`dev.mjs` 的 `stopProcess` 见到直接子进程已退出就 return，`taskkill /PID <已退出 PID> /T /F` 也只会失败，深处的 `cargo → api-server.exe` 无人清理。 2. 按根 PID 遍历依赖快照里的父子链，中间层先消失时链断，只能拿到根 PID。 3. 复用判据只看 `.app/dev-stack.json` status 与 `/healthz`、`/readyz`、`/v1/ping`，不校验端口上的进程属于哪个工作树，残留后端照样被判为健康并复用。 ## 改动 - 新增 `scripts/dev-windows-process.mjs`：按根 PID 遍历 + 按身份匹配（`server-rs/target/debug/api-server.exe` 绝对路径、SpacetimeDB `--data-dir`）两条独立清理路径，带 1s 快照缓存避免清理被拖慢。 - `scripts/dev.mjs`：直接子进程已退出时仍按记录 PID 清理后代；退出时按身份兜底清扫本工作树后端（复用他人 standalone 时跳过）；启动前清理旧 api-server 保留 `Wait-Process` 语义，避免 `failed to remove file`。 - `apps/ai-game-creator-shell/scripts/start-dev-stack.mjs`：复用前校验端口监听进程归属，无法证明归属就不复用、改为启动本工作树后端并允许端口漂移；信号与 `finally` 各兜底清扫一次；`taskkill` 失败时降级按 PID 遍历；等待就绪时输出归属校验失败原因，避免静默超时。探测不可用时退化为旧行为，不阻断本地启动。 - 测试与文档：新增 `scripts/dev-windows-process.test.ts`、扩充 AGC 复用门禁用例；同步 `docs/project-memory/shared-memory/pitfalls.md` 与本地开发运维文档。 ## 验证 - 伪造 `api-server.exe` 进程：按身份精确命中并杀掉（`matched=[17284] stopped=[17284]`）。 - 3 个真实监听进程下归属判定：`owned` / `api-server-owner-mismatch` / `spacetime-owner-mismatch` 均正确。 - `npx vitest run scripts/dev.test.ts scripts/dev-windows-process.test.ts scripts/dev-stack-port-utils.test.ts apps/ai-game-creator-shell/tests/...`：119 passed（唯一失败为 Windows 文件权限用例，已确认在合并基线 `origin/master` 上同样失败）。 - `node --check`、`eslint --max-warnings 0`、`prettier --check`、`npm run check:encoding`、`git diff --check` 全部通过。 ## 备注 Rust 侧 `api-server` 的 `with_graceful_shutdown` 没有超时上限，是「有概率」的来源之一；本次只在 Node 侧收口，是否给优雅退出加 deadline 可另行评估。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/315 Co-authored-by: Suzumiya <suzmii@qq.com> Co-committed-by: Suzumiya <suzmii@qq.com>	2026-09-09 20:08:04 +08:00
suzmii	c0ef876b14	修复 AGC 项目写锁回收的并发删除竞争与启动诊断死路径 ... - 锁文件回收改为单次快照解析：payload 只解析一次，删除前重新核对字节，内容已被并发方替换或文件已消失时返回 false 并重试 create_new，不再无条件 unlink，也不再把 remove_file 的 NotFound 当成硬失败 - mtime 读取失败改用 Option 区分“未知”与“纪元 0”：未知年龄不回收，未知锁创建时间不做 PID 复用推断，避免把保守判定反转成抢走活持有者 - 新增并发替换/已消失、旧格式活持有者、存活未知、mtime 未知四条回归用例 - 启动日志槽优先用已经生效的配置目录（含 --config-dir），否则退到平台配置根（APPDATA / Application Support / XDG_CONFIG_HOME） - 日志路径未知时 StartupLogSlot::fail 仍然给出用户可见提示，四处 inspect_err 不再被路径判空挡掉 - 同步 check-config 守卫、decision-log、pitfalls 与技术方案文档的用例数与新判据	2026-09-09 19:44:46 +08:00
suzmii	1abbbadb07	合并最新 master 到 AGC V3 资源画布分支 ... - 合入 origin/master 67 个提交（含 #285 无限画布图标模糊修复、#307 客户端常用设置读写卡顿修复等） - index.tsx 冲突按 V3 画本结构解决：保留 resourceBook 画布场景，未采用 master 的 CanvasWorld 包装 - 原因：game-resource-page-world 现仅承载依赖连线层，CanvasWorld 使用固定 12000 世界尺寸，会破坏按内容自适应的边界 - 保留 AtSign 图标导入（V3 引用输入区使用） - 合并后 npm run ai-game-creator-shell:typecheck 通过	2026-09-09 18:12:09 +08:00
suzmii	b7f27721c5	修复 AGC 项目写锁回收判据的跨平台 PID 边界 ... - 项目写锁存活判定把平台不可能分配出的进程号（0 或超出平台 pid 宽度）判为持有者不存在并直接回收，不再落回 600 秒保守分支 - 回归用例的死进程 PID fixture 由 0xFFFF_FFF0 改为 i32::MAX - 1，同时落在两个平台进程号空间之外且在 Unix 有符号 32 位范围内 - 新增 project_write_lock_reclaims_unrepresentable_owner_pid 用例，覆盖 u64::MAX 非法进程号残留锁 - 修正 project_lock_recovery 头部注释，说明这些用例是回归护栏而不是待修缺陷 - 同步 decision-log 的 PID 边界决策与 pitfalls 的跨平台 fixture 经验	2026-09-09 18:00:53 +08:00
lhk229	04128eb661	Merge branch 'master' into feat/design_agent_simple	2026-09-09 16:34:16 +08:00
k88936	7288c6f641	Fix/修复无限画布图标文字模糊 (#285) ... closes #279 closes #284 实现: 从2(暂定)倍放大绘制的画布scale 0.5* 真正的scale before:   after:   svg看起来stroke窄了一点点, 可以接受 Reviewed-on: #285	2026-09-09 16:32:43 +08:00
suzmii	6d3d24df5e	合并 #283 资源画本画布实现 ... 合入 feat/game-agent-canvas-resource-workbench-v2 的完整画布实现：资源画本控制器/模型/视口/布局、转场层、资源分页缓存与自动聚焦修复、资源总览卡片预览懒加载 保留本分支已有的聊天素材引用改动（引用输入区、@ 引用按钮、运行画面点选） 解决 index.tsx 状态声明与 pitfalls.md 文档冲突；styles.css 去重后仅保留一份画本视觉层	2026-09-09 15:43:32 +08:00
lhk229	852d9af483	合并最新 master ... 同步远端主线至 b129589e7 保留当前分支的 V1 清理与主线文档和测试更新	2026-09-09 06:06:35 +00:00
lhk229	08c5917490	修复配置覆盖层写入失败后的部分更新 ... 提前序列化配置变更并在多文件写入失败时逆序回滚 保留单文件保存路径且不增加外部诊断或保存后回读 补充覆盖层写入失败回归测试及配置保存文档	2026-09-09 04:34:57 +00:00
suzmii	0a5080dbd9	Merge remote-tracking branch 'origin/master' into feat/game-agent-canvas-resource-workbench-v2	2026-09-08 10:45:07 +08:00
lhk229	d7a09276e6	合并 origin/master 到 feat/design_agent_simple ... - 合入 AGC 官方 LLM Router 账号链路与流式联网输出（#242） - 新增后台模型别名与对话选择能力及 AGC 模型目录 - 解决 ProjectSupervisorView.tsx 与 decision-log.md 冲突	2026-09-07 03:07:05 +00:00
suzmii	34e3f70409	补充服务启动配置校验并优化模型菜单 ... 启动时校验 LLM Router 地址、模型和相关密钥配置 将刷新操作移入模型展开菜单并修复菜单样式覆盖 更新启动运维文档与定向测试	2026-09-05 19:48:27 +08:00
lhk229	2d7226dad8	修复策划V2修改意见撞项目锁 ... V2 审批、续跑、落盘、失败投影和 GDD 认领改为完整等待窗口 V2 hydrate 改为短窗口等待 前端 V2 hydrate 忽略瞬时锁争用 补充审批、续跑、hydrate 锁等待测试 同步决策、踩坑和技术方案	2026-09-05 11:28:37 +00:00
suzmii	4f3f0f24ff	接入AGC后台模型目录与对话模型选择 ... 新增后台 AGC 模型目录、别名、启停和默认项管理 客户端设置页恢复原状，对话框右下角按别名选择模型 服务端按稳定模型标识映射并校验实际模型白名单 修复 AGC 配套后端端口漂移、启动等待和 SpacetimeDB 版本检查 补充迁移、文档、启动与模型选择测试	2026-09-05 19:10:49 +08:00
lhk229	4127686e18	修复新建项目锁误触发 Windows UAC ... 新建 sidecar 改为本进程收紧 DACL，不再因继承 ACE 自动提权。 项目锁先写入并释放独占句柄后再 harden，回读内容校验，不再对这把新锁走 prepare_for_read。 提权 ArgumentList 改为一条按 Windows 规则加引号的字符串，避免含空格路径被拆开。 补充含空格项目根取锁与 quoted ArgumentList 定向测试。 同步 ACL 提权边界、决策记录和排障记录。	2026-09-05 10:53:15 +00:00
suzmii	cd17ae8123	修复资源主画布无限平移与滚轮交互 ... 分离固定交互视口与可平移缩放的内容层 支持主画布滚轮平移并保留缩放及主子画布视口记忆 补充越界拖动和滚轮回归测试并同步技术文档	2026-09-05 11:41:16 +08:00
suzmii	ba718e3d4b	重构资源画本独立转场与中断处理 ... 使用独立FLIP快照层和Web Animations统一动画收尾 统一分类导航并保留滚轮节流和各画布视口 修复快照缩放与悬停导致的终点偏移 补充动画回归测试并更新资源画本技术文档	2026-09-05 11:21:17 +08:00
lhk229	ca62243628	修复策划 V2 孤儿 GDD 无法恢复 ... 把 gdd.vN.json 创建成功当作提交点 persist、hydrate 与回合启动认领下一连续版本并补投影 重试不再用新 UUID 覆盖同一版本 补充孤儿认领与下一版本分配测试	2026-09-04 10:47:17 +00:00
lhk229	c1d967b17d	将策划 V2 输出从正文 JSON 改为协议工具 ... 挂 plan_ask_question / plan_submit_gdd，tool_choice 固定 auto 删除正文 JSON 解析、骨架提示词和入参 schemaVersion 必填 形状改由工具 schema 承担，既有校验门禁与落盘 plan-gdd.v2 不变 同步技术方案、决策记录和 DeepSeek thinking 排障	2026-09-04 10:10:50 +00:00
kdletters	8ed0626627	恢复预览环境本地配置注入 ... 恢复 API 与 worker 的 .env.local BuildKit secret 挂载 补齐 Jenkins 固定文件校验与预览文档 增加双配置文件构建门禁	2026-09-03 11:38:40 +08:00
k88936	422c8931d6	Feat/AGC错误报告 (#240) ... 实现: 在rust内存里维护错误事件队列, webview调用tauri command传入, 后台任务agent工具等直接插入 把rust , webview console的日志统一写到AppData文件夹下的(滚动保存的)日志文件. rust对传入的错误进行筛选,脱敏, 防抖,后通知前端提醒用户. 用户提醒是一个不阻塞的小UI, 展开后可以选择错误上报, 可以附加文字描述 上传时附带最近日志, 错误堆栈等信息 元数据存在数据库, 考虑到字符串信息很难查询, 所以在api server打包成zip存在OSS. 管理页面新增错误报告的查看页面     --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/240 Co-authored-by: 王德宇 <kvtodev@outlook.com> Co-committed-by: 王德宇 <kvtodev@outlook.com>	2026-09-03 10:02:05 +08:00
k88936	6fe91a169c	移除 AGC Skill 受控引用读取工具 ... 删除 agc_read_skill_resource 的实现、MCP 暴露、审计分支与专用测试 将内置 Skill references 改为 Codex 原生相对路径读取 同步 Skill manifest 指纹、Runtime 提示词与 AGC 项目文档 保留既有 references 安装与隔离 HOME 校验	2026-09-02 19:00:31 +08:00
kdletters	fe35fcf264	修复 AGC Windows NSIS 打包工具缓存 ... 启用 Tauri 项目级 NSIS 工具缓存，避开 Jenkins systemprofile AppData。 补充 Windows 配置门禁，防止 useLocalToolsDir 回退。 增强 Jenkins 预检与失败诊断，记录实际用户和 makensis 路径。 同步 AGC 发布文档与 NSIS 排障记忆。	2026-09-02 15:24:07 +08:00
kdletters	071faa482c	统一 Rust 与 TypeScript 格式化门禁 ... 纳入 AGC Cargo workspace 的统一 rustfmt 检查与格式化入口 完成项目 TypeScript/Prettier 与 Rust 全量格式化 修复 Pingora expected executable 门禁的空白敏感误报 同步开发运维文档与 AGC skill pack 格式化忽略规则	2026-09-01 16:28:34 +08:00
kdletters	58db9fa637	后台详情弹窗展示原图 ... 素材查询详情弹窗并列展示原图与当前结果 精选审核详情弹窗保留原有元信息并补充原图 管理快照与后台 DTO 传递源资源媒体字段 限制源资源字段仅在后台审核读取路径回填 更新后台素材预览的架构踩坑说明	2026-08-28 21:36:22 +08:00
lhk229	e31d8a2a5b	修复链路上存在的若干阻塞性漏洞 (#199) ... Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/199 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-08-28 17:09:02 +08:00
kdletters	9476ff7648	迁移仓库工具资源到 Codex 并固化执行边界 ... 将 .hermes 工具资源迁移至 .codex 同步代码、文档与 RAG 路径引用 补充任务范围、验收与时间盒执行规则	2026-08-27 13:55:25 +08:00
kdletters	c7442663f2	修复原生壳CI的Cargo依赖锁定 ... Native shell job 预取 server-rs、桌面壳和 AGC 壳依赖 AGC 的 platform-llm、shared-contracts 与壳测试统一使用 --locked 补充 workflow 回归断言及 CI 排障文档	2026-08-26 15:53:51 +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
wuxiangwanzi	5802048c30	Codex/agent chat layout fix (#193) ... Co-authored-by: kdletters <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/193 Co-authored-by: 五香丸子 <15518898337@163.com> Co-committed-by: 五香丸子 <15518898337@163.com>	2026-08-25 12:36:51 +08:00
lhk229	3d8e0211db	5分钟策划agent (#159) ... Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/159 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-08-24 21:44:44 +08:00
suzmii	532c6d51fd	完善 Game Agent 资源画布与图片精修生成事务 (#181) ... ## 背景 本合并请求整合 Game Agent 资源管理的栏目分页自由画布，以及图片持续精修、候选生成和本地恢复事务。 当前远端比较基线： - base：`master` @ `b00a3f80576949567bf3320f0c6c92b4ed0a649d` - head：`codex/game-agent-resource-section-pages` @ `5795d2f9b8797c342dcf2920ccefec2a3ff3f472` - 相对 base：28 commits、33 files（`+3746 / -1333`） ## 主要改动 ### 资源管理分页自由画布 - 固定展示“设计文档 → 美术资源 → 音乐音效 → 游戏代码 → 项目版本”五个栏目；空栏目仍可从悬浮 Dock 打开空画布。 - `按依赖` 与 `按类型` 共用栏目分页画布；每个“排序模式 + 栏目”组合独立保存 viewport。 - 普通滚轮使用有界意图队列切换栏目；Ctrl/Meta + 滚轮以指针为锚点缩放；空白拖拽可沿 x/y 无限平移，不以资源 extent 作为导航边界。 - 资源卡支持拖拽布局与一次 CAS 持久化；切页、排序切换和卸载会统一取消拖拽及 pointer capture。 - 资源详情为非模态独立卡片：打开、切换或关闭详情不卸载背景画布、资源卡或依赖连线，也不重置 viewport、搜索或排序状态。 - 顶部已移除“生成视频 / 生成音效 / 生成背景音乐 / 新增 UI 设计”的手动入口；保留播放、未完成编辑恢复、排序和画布复位，以及资源详情中的既有编辑动作。 ### 图片持续精修与生成事务 - 图片资源可进入唯一活动精修草稿，支持原生批量导入、图片下方快速编辑卡、候选图层、任务侧栏和“设为最终图”。 - 生成成功只合并候选图层和 generation 权威事实，不以全量 hydrate 覆盖生成期间的本地编辑。 - 候选媒体、图层和公开 generation 记录写入并回读成功后，才推进私有 `candidate-ready`。 - 候选确认接入 Surface 保存 FIFO 与重新打开 hydrate；revision-sensitive 操作等待确认屏障。 - 失败归档和正式图提交采用可恢复中间态，避免中断后出现幽灵任务、重复 revision 或不一致的正式资产。 ### 合同与文档 - `acknowledgeCandidateLayers`、`importLocalImages`、`archiveFailedGeneration` 为必选 Host Port；不支持的宿主返回结构化 `unsupported-capability`。 - 同步更新 TypeScript / Rust 合同、Tauri command 可达性、PRD、技术方案与项目共享记忆。 - 明确资源栏目无限画布合同：普通平移不夹取；资源 extent、图片测量、布局变更和 resize 不得重置用户 viewport；仅首次可测量布局与显式复位按真实卡片包围盒适配内容。 ## 验证 CI run [#1290](https://git.genarrative.world/git/GenarrativeAI/Genarrative/actions/runs/1290) 针对当前 head 已完成且四项均成功： - [x] Repository checks - [x] Frontend tests（235 test files、3166 tests passed；App Surface 410 tests） - [x] Backend tests - [x] Native shell tests 另有本地定向检查： - [x] `npm run agc:typecheck` - [x] 资源画布、App Surface、Asset Canvas 与资源实时集成定向回归 - [x] Rust 候选确认、候选中断恢复、失败归档与恢复定向测试 - [x] `cargo fmt --check` - [x] `npm run check:encoding` - [x] `git diff --check` ## 评审 provenance - review #247、#248、#252 都针对旧 head，当前在 Gitea 中均标记为 stale；不将其写作“已处理 #247”或当前 head 的评审结论。 - review #253 针对旧 `5456a1d…` head，提出 PRD 退役入口、共享 pitfalls 的 extent 旧合同和 PR 正文事实更新三项 P2；对应文档已在 `5795d2f…` head 修复并推送。 - 早期由 PR #176 引入的候选持久化、归档、Host Port 与快速编辑卡问题，当前已在 base/head 中具备对应修复，不作为本轮重复阻断项。 - 当前 head 仍需新的、针对最新提交的审批；历史 stale review 不能替代当前 head approval。 ## 影响范围 - 修改 AI 游戏创作 App 的资源管理、图片精修、Tauri 本地持久化与恢复语义，以及共享合同和权威文档。 - 会调整本地资源布局、精修 draft 和私有 generation ledger 的状态机。 - 不修改 SpacetimeDB schema，不新增或变更 `/api/external/v1` 路由。 --------- Co-authored-by: kdletters <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/181 Co-authored-by: suzmii <suzmii@qq.com> Co-committed-by: suzmii <suzmii@qq.com>	2026-08-24 20:42:58 +08:00
suzmii	15a524e6e0	Feat: 完善 Game Agent 资源画板与图片精修链路 (#176) ... ## 摘要 本 PR 将 Game Agent 资源管理页升级为真实自由画板，并打通图片资源的快速编辑、候选生成、导入、失败归档与正式图提交流程。 同时补齐图片精修的事务恢复、候选身份校验、生成中任务恢复、鉴权重试，以及“设为最终图”后游戏运行资源的稳定刷新链路。 ## 主要变更 ### 1. 资源管理页自由画板 - “按依赖”视图改为统一自由画板： - 支持指针拖拽平移 - 滚轮平移 - `Ctrl / Meta + wheel` 以指针为锚点缩放 - 支持复位和全量资源适配 - 增加隐藏导航边界： - 边界由全量资源世界范围加安全留白决定 - 搜索过滤不会缩小边界 - 用户不能把全部资源拖出可视区域 - 图片资源卡按真实宽高比展示： - 预览读取真实 `pixelWidth / pixelHeight` - 布局碰撞、世界范围、依赖连线共同消费同一资源矩形 - 非图片资源保持固定卡片尺寸 - 点击资源改为非模态详情卡： - 背景画板不卸载 - 顶部工具栏、搜索、排序、缩放状态不重置 - 图片详情不再进入全屏页 ### 2. 图片资源快速编辑与精修画布 - 点击图片资源后直接显示快速编辑卡。 - 图片精修顶栏收敛为紧凑操作： - 返回 - 导入 - 定位当前最终图 - 撤销 / 重做 - 删除、修改、设为最终图进入选中图片的上下文卡片。 - 快速编辑生成不再阻塞整张画布： - 立即创建生成占位卡 - 占位卡可拖动并持久化位置 - 右上任务列表显示排队 / 生成中 / 完成 / 失败状态 - 任务列表可折叠 - 生成失败只影响当前任务： - 保留失败占位 - 可显式归档失败任务 - `reconciliation-required` 任务不允许删除 - 原生多选图片导入： - 使用 Tauri 原生文件选择 - 后端批量安全读取 - 一次推进草稿 revision - 失败不留下半导入状态 ### 3. 候选图与正式图事务 - 生成成功只加入草稿私有候选层，不直接修改 manifest。 - “设为最终图”是唯一正式资源切换入口。 - refine 保持原 asset ID 和来源身份，不追加新的业务资产身份。 - 正式文件使用不可变路径： ```text assets/canvas/<name>--<commitId>.png --------- Co-authored-by: kdletters <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/176 Co-authored-by: suzmii <suzmii@qq.com> Co-committed-by: suzmii <suzmii@qq.com>	2026-08-24 16:27:33 +08:00
kdletters	2449e77461	修复切换账号后画布资源不可编辑 (#182) ... ## 变更 - 新增按服务 origin、平台 userId / Developer Key 摘要和本地 projectId 分区的 External Editor 项目绑定 - 新增按当前 principal、远端项目、本地 assetId、源 SHA-256、媒体类型和 canonical kind 分区的资源绑定 - manifest 中的 canvasProjectId / resourceId / assetObjectId 仅保留来源信息，不再作为当前账号的可编辑授权 - 切换账号后从本地正式资源重新上传、confirm、登记；图片、视频、角色动画、素材画布参考、art-spec 派生和 Direct 恢复统一使用当前账号绑定 - prepared / accepted / running 账本继续冻结原 principal；账号变化或远端结果不确定时停止补偿并保留现场等待对账 - 同步技术方案、decision log 和 pitfalls ## Review 结论 - 两路独立代码 review 均未发现剩余 P0-P2 - Review 发现并关闭了 max-pass 测试误放宽问题，恢复为绑定最大轮次的强断言 - 首轮 CI 暴露两处本 PR import 排序错误，已在独立提交 09486f142 中修复并复核 ## 验证 - Rust 完整测试：2301 passed，0 failed，16 ignored - Rust 集成与构建测试：5 + 2 + 14 passed - repository-ci 本地同构门禁通过：lint、typecheck、139 表 SpacetimeDB schema guard、403 个 appSurface 测试、web/admin-web build - External Editor procedure 真实 smoke 通过：精确重放、冲突、删除 fail-close、并发和孤儿检查 - Encoding check：5594 files - git diff --check 通过 - Gitea Project CI run 1253：Repository checks、Frontend、Backend、Native shell tests 全部通过 - 当前 head a0b8415be 已合并 origin/master 44ee28c43，PR 无冲突 ## 后续依赖 PR #176 暴露了这一公共账号身份缺陷。该 PR 合并后，#176 需要 rebase，并删除或接入其局部 canonical cache，不能保留第二套账号绑定系统。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/182 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-08-24 11:33:37 +08:00
kdletters	0b546c9e4c	完善AGC受控客户端能力 ... 补齐美术复用与显式重生成模式、稳定回合身份和幂等补偿恢复 收紧付费授权、四切片资源身份及告警投影边界 限制Direct Codex仅写真实game目录并接入受控联网搜索 持久化Direct用户与助手消息并修复同进程恢复竞争 同步审核Skill、技术文档、项目记忆和回归测试	2026-08-23 22:34:16 +08:00
kdletters	1a909704aa	预览镜像同时内置本地环境配置 ... 预览 API 与 worker 通过 BuildKit secret 内置 .env.local 补齐预览控制面固定 .env.local 校验与文档 更新 Docker 构建边界测试	2026-08-23 14:29:46 +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
JenkenB	b7a6f853d5	修复 AGC 内置 Skill 内容指纹 (#175) ... ## 变更 - 重算并修正三项内置 AGC Skill 的内容指纹 - 将审核 Skill Pack 版本提升至 2026-08-22.2 - 补充指纹回归防范记录 ## 验证 - AGC Skill Pack Rust 单测 4/4 通过 - npm run check:encoding 通过 - git diff --check 通过 --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/175 Co-authored-by: 高物 <253518756@qq.com> Co-committed-by: 高物 <253518756@qq.com>	2026-08-22 16:53:36 +08:00
kdletters	8cc1432b86	修复完整容器数据库内存上限 ... 将完整容器 SpacetimeDB 内存上限提升到 2 GiB 增加基础 Compose 内存门禁 同步容器运维文档与项目长期记忆	2026-08-22 16:22:55 +08:00
kdletters	d631253c34	将预览密钥内置到API镜像 ... 固定Jenkins预览密钥宿主路径并收紧文件校验 通过BuildKit secret向API和工作进程镜像安装密钥文件 增加摘要缓存门禁和普通无密钥构建兼容验证 同步预览部署文档、安全边界与排障记忆	2026-08-22 15:45:40 +08:00
kdletters	27de28a487	迁移 npm workspaces 统一依赖边界 ... 根目录统一管理九个 workspace 与唯一 lockfile 迁移 CI、Jenkins 和容器的根目录单次 npm ci 补齐 hoist 兼容、版本校验与 workspace 门禁 同步依赖边界方案、运维文档和长期记忆	2026-08-22 13:17:26 +08:00