687 Commits

Author	SHA1	Message	Date
lhk229	ded9f13f02	Fix Issue 549 (#573) ... 账户素材超过 500 项时，AGC 曾在筛选和分页前直接拒绝整个素材库，导致查询、预览和指定 ID 导入不可用。本 PR 移除账户素材总量及账户分页 offset=500 的客户端限制，允许大库继续使用现有客户端筛选分页。 Closes #549 ## 实现范围 - 移除账户素材库原始条数超过 500 的拒绝，以及 MCP schema、桥接、Runtime 执行层和原生函数 strict schema 的账户分页 offset 上限。 - 保留单页最多 100 项、导入批次数量与下载体积、媒体类型、账号归属、权限及会话校验。项目文件查询的 offset 上限和绑定项目画布资源的数量上限保持原有契约。 - 账户素材 UI 列表、预览及指定 ID 导入同步恢复可用。 - 修复真实账户导入时，在持有身份租约期间重复读取会话互斥锁造成的自锁；写入前校验和覆盖写入过程的身份租约继续保留。 - 同步工具说明、技术方案与排障记录。服务端仍返回全库，传输和解析开销另由 #574 跟进，不作为本 PR 的验收前置条件。 ## 验收 以下已完成项表示本地自动化与代码核查通过，不代表线上真实账号验收。 - [x] 覆盖 500/501 项素材库解析；503 张静态图片及 1 项不支持媒体的模拟素材库可正常工作。 - [x] MCP 查询支持 limit=1、folderId、query 和 offset>500；nextOffset、末页、越界空页及默认每页 100 项符合现有契约。 - [x] 直接调用 Runtime 执行层时 offset=501 可查询；MCP schema 与参数校验一致，仍拒绝负数、非整数 offset 和 limit>100。这项不覆盖 Runtime 下发给模型的原生函数 schema。 - [x] Runtime 原生函数 asset.library.list 的 strict schema 允许 offset>500；实际下发的完整函数参数已验证 offset=501/600/10000、null 可用，负数/非整数偏移及超界页长拒绝。补丁已提交并推送：41e2cc0b5。 - [x] 共用读取链路的 UI 素材列表和预览在大库场景可用。 - [x] 指定有效 assetId 完成实际下载、本地文件写入及 manifest/revision 更新；重复导入保持幂等。 - [x] 模拟素材库中的不存在 ID 和不支持媒体被拒绝，且不改变 manifest；返回 Agent 的当前页元数据不泄露媒体地址、对象键或凭据。 - [x] 会话退出、账号切换、凭据刷新、身份租约和取消写入相关定向测试通过。 - [x] 工具说明、技术方案和共享排障文档已同步；项目文件与画布资源原有独立边界已核对保留。 - [ ] 真实平台账号联调：超过 500 项素材时查询、预览和导入，以及实际删除、跨账号、无权限素材的拒绝行为。 ## 验证证据 - 账户素材、导入、参数校验、项目文件、取消写入与平台会话定向 Rust 测试：33 项通过。 - runtime_prompt_bundle_build：17 项通过；prompt_source_boundaries：6 项通过。合计 56 项通过。 - Rust 格式检查、npm run check:encoding、npm run check:doc-index、git diff --check 通过。 - 以上 Rust 测试在快进 master 前运行；快进至 44f415d05 后已核对本次代码及工具文本与已测试版本一致，并再次通过编码、文档索引、差异检查和提交时 Rust 格式检查。 - 未运行全量测试，未做真实线上账号或付费操作验证。 初次修复提交：697f421e570606d0519f952a0a5689b5f639f902；原生函数 schema 审查补丁：41e2cc0b57b7f9f5faf06546c1f6108e88380ac3（已推送）。 - 审查补丁验证：24 项定向 Rust 测试通过，覆盖全部 agent_native_tools 测试、大库查询/导入和修正后的旧流式结果测试；格式、编码、文档索引、差异检查、提交及推送检查通过。本轮未重复全量测试，未做真实模型或线上账号调用。 Reviewed-on: #573	2026-10-01 20:55:28 +08:00
kdletters	1aa457c36b	Merge branch 'master' of https://git.genarrative.world/git/GenarrativeAI/Genarrative	2026-10-01 19:45:43 +08:00
lhk229	3193182665	修复 AGC 测试编译并保留 CI 编译诊断 ... 删除 Claude 流式结果测试中已失效的回合参数 分片运行器使用 Cargo 渲染诊断并保留 JSON 产物发现 新增编译失败诊断回归测试并更新排障文档	2026-10-01 11:42:48 +00:00
kdletters	d1f789cc10	AGC 支持 Anthropic 独立网关路由与后台协议选项 ... 新增平台 Anthropic 网关路由 /api/llm/anthropic/{*path}，复用账号 Router 凭据边界 OpenAI 侧规范路径改为 /api/llm/v1/responses 与 /api/llm/v1/chat/completions，旧路径保留兼容 baseUrl 不再携带路由与版本段，统一由协议自己拼 v1/<op> cc 执行器改走平台网关，ANTHROPIC_AUTH_TOKEN 复用平台会话，不再直连 Router 后台模型目录 agentMode 增加 anthropic，管理页与客户端契约同步 补齐三条路由埋点与静态段白名单，新增三条回归测试 同步后端架构文档、模型别名文档与排障记忆	2026-10-01 19:41:08 +08:00
kdletters	44f415d057	合并 origin/master（58 个提交）：生产 Nginx 模板收敛与记录同步 ... - 合并 origin/master 58 个提交，解决 2 处文件冲突：决策记录与踩坑记录均按两侧新增条目并存处理 - claude_code_cli.rs 自动合并通过：本机 Claude sidecar 诊断改动与上游 sidecar 归位并存，无重复函数定义、无冲突残留 - 保留本地未推送提交：AGC Claude 执行认证与错误诊断、Claude sidecar 超时诊断 - 本次推送主体内容不变：生产 Nginx 模板收敛、host-only snippet 与运维/踩坑/决策文档同步	2026-10-01 18:38:56 +08:00
kdletters	ac4148d24b	生产 Nginx 收敛到仓库模板并同步生产机 host-only 覆盖 ... - 主模板 http 段新增 genarrative_gallery_rps 限流 zone，供公开作品架与自定义世界画廊读取接口使用 - 新增 deploy/nginx/snippets/genarrative-host-extras.conf：内部工具页、公开画廊读取 location、主站官网首页入口 - 主模板改为 include host-only snippet，线上 vhost 以仓库模板为唯一来源 - Server-Provision 安装、备份并回滚 genarrative-host-extras.conf，补充 require_path 与临时文件清理 - 生产运维护栏新增 host-only snippet 安装断言 - 运维文档补充主站 SPA 白名单与 host-only 覆盖小节及生效配置核对命令 - 踩坑记录新增线上手工维护漂移条目：/profile 刷新 404 与 client_max_body_size 停在 64m - 决策记录新增生产 vhost 单一来源、host-only 独立成 snippet、退役路由不做显式 404 的长期口径	2026-10-01 18:37:46 +08:00
JenkenB	97617608ba	修正 Web 预检错误分流	2026-10-01 17:54:53 +08:00
kdletters	127def0a8a	修复 AGC Claude 执行认证与错误诊断 ... 官方 Claude 模型复用当前平台会话令牌 保留 Claude 失败终态摘要并增加回归测试 补充 AGC 排障记忆	2026-10-01 13:21:57 +08:00
k88936	cdb2223140	Merge branch 'master' into refactor/remove-toolcall.jsonl-legacy	2026-10-01 12:58:04 +08:00
k88936	719db293d2	退役 DirectProject 工具调用与回合流账本 ... - agent/direct_tool_calls.rs、agent/direct_turn_stream.rs：整体删除，agent.rs 去掉模块声明与导出 - direct_runtime/mod.rs：删 DirectToolCallCollector、回合流节流器与全部落盘/发射调用点，observer 只回填 update_active_turn - codex_app_server/mod.rs：删 DirectCodexTurnObservation::ToolCall，AgentMessageSegment 结构体变体简化为元组变体，direct_tool_call_turn_id / direct_tool_call_now_ms 改名 - claude_code_cli.rs：删 tool_use / tool_result 采集分支与 DirectToolCall 构造 - main.rs、runtime_driver/entrypoints.rs：删 GameCreatorDirectTurnUpdateEvent 与 game-creator-direct-turn-update 事件，emit 收缩为 (status, activity) - thread_manager/wire.rs：新增 direct_now_ms，替代随 direct_tool_calls 删除的时钟函数 - docs：ADR、工具调用卡片技术方案、DirectProject 聊天真相源收敛里程碑与实施计划、pitfalls 旧路径同步到当前状态，decision-log 新增 2026-09-30 退役条目 - 未修（另开）：redact_absolute_path_tokens 的无语境绝对路径扫描仍会误伤 HTML 结束标签与嵌套 JSON 转义 - 验证：cargo test --bin genarrative-ai-game-creator-shell agent::（929 passed / 0 failed / 5 ignored）、npm run check:encoding、npm run check:doc-index、git diff --check	2026-09-30 19:42:13 +08:00
suzmii	8be75e8e15	合并 origin/master（33 个提交）：DirectProject 入队化与事件投影 ... - 合并 origin/master（425fbcf63..9ee34809b），唯一冲突是共享决策日志两侧各插条目，取「两侧并存」 - 本轮 master 未触及随包资源声明、准备步骤与三份 tauri 配置，build.rs 只读校验保持不变 - 决策日志与踩坑记录同步两侧条目；docs/README.md 与项目索引按 master 收敛 - 构建期重新生成的 ts-rs 绑定经 prettier 归一后与 master 逐字节一致（合并未丢类型） - 校验：cargo test --no-run 全 target 通过、AGC 应用 vitest 191 files / 1889 tests passed、check-package-layout、prepare-bundled-resources 18 passed、check-config、check:encoding、prettier、cargo fmt --check 全绿	2026-09-30 17:38:35 +08:00
suzmii	b5a143c04f	合并 origin/master：随包资源仍由准备步骤生成，Claude Agent SDK sidecar 按同一架构归位 ... - 合并 origin/master（140 个提交），解决 4 处冲突：build.rs 取只读校验分支、package.json 同时保留 bundled-resources:test 与 check:generated-bindings、决策日志与踩坑记录两侧条目并存 - master 的构建期 staging（stage_bundled_claude_agent、prune_stale_codex_components）不进构建脚本；sidecar 改由声明与准备步骤产出 - package-layout.json 新增 claudeAgent section（锁定版本、sidecar 入口、上游 SDK 与平台原生运行时目标表、复制跳过规则），layoutVersion 递增到 2 - prepare-bundled-resources.mjs 新增 sidecar 整目录原子替换与缓存 key，复制规则按 section 参数化，Windows 真机 24 个文件、复跑命中缓存零写入 - package_layout.rs 新增 sidecar 只读校验（入口与仓库源码逐字节一致、上游包版本、可执行位、白名单外文件）与声明钉住用例 - build.rs 调用 sidecar 校验并导出 AGC_CLAUDE_AGENT_SDK_VERSION；claude_code_cli.rs 的 sidecar 身份串改用声明版本 - resources/claude-agent 映射从基线 tauri.conf.json 移到 windows/macos 平台配置，check-config.mjs 增加「基线不得声明 resources/**」守卫 - 修正 package_layout 的 Windows 路径期望用例（期望值改与实现同形，原用例在 Windows 必红） - 同步技术方案 §4.5/§4.9、共享决策日志与踩坑记录	2026-09-30 17:23:04 +08:00
k88936	8a4e3cbcdd	Merge remote-tracking branch 'origin/master' into feat/msg-queue-to-rust	2026-09-30 16:55:37 +08:00
kdletters	110f088d41	修复 Jenkins 发布流水线与 macOS 包门禁 ... - 转义 Stdb Publish GString 内的 shell 命令替换，避免 Jenkinsfile 加载时 Groovy 编译失败 - 为 Stdb Publish 暂存清理命令补充生产运维回归门禁 - 抽离 macOS 包内容策略并放行随包 Claude Agent SDK 的受控 node_modules - 违规资源现在会输出具体相对路径，并补充包内容白名单单测与排障记录	2026-09-30 16:01:21 +08:00
k88936	888c249ffd	Merge branch 'master' into feat/msg-queue-to-rust	2026-09-30 14:37:25 +08:00
k88936	a7caaa6ade	Merge remote-tracking branch 'origin/master' into style/game-play ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-09-30 13:38:14 +08:00
k88936	d538c6e9c9	Merge remote-tracking branch 'origin/master' into feat/msg-queue-to-rust	2026-09-30 13:37:14 +08:00
k88936	131026795a	合并 origin/master：待发消息队列归宿主叠加 master 的 active-turns 广播与保活下沉 ... - direct_runtime/mod.rs：保留本分支「Thread Manager 是活动回合唯一事实源」（direct_active_turn_id_at）， 丢掉 master 的 DirectTaonierActiveInvocationGuard 第二份进程内表；master 的美术背景路由改动全部保留 - direct_thread_manager.rs：双方都保留——本分支的待发队列 / 容量上限 / 残留回合兜底释放， 与 master 的 emit_direct_active_turns_changed 广播、unsubscribe、update_active_turn 返回「是否真的变了」 - useDirectProjectChatController.ts：保留本分支入队化逻辑，采纳 master 的 rawMessage 小重构与保活下沉 - direct_turn_dispatch.rs：会话保活改挂放行占用（DirectTurnReservation._session_keepalive）， 随占用释放即停，等价承接 master 放在调用身份守卫里的保活意图 - 保留本分支对 direct-execution-production-fixture.mjs 的删除（--direct-codex-chat CLI 已退役，夹具无入口） - 连带退役 scripts/run-agc-direct-execution-fixture.mjs 与 npm run check:agc-direct-execution-fixture（只服务该夹具） - 文档同步：ADR / 09-24 实施计划 / decision-log 记录上述退役，09-16 与 09-18 里程碑、pitfalls 的夹具命令标注为已退役	2026-09-30 13:35:14 +08:00
k88936	0619903e3f	修复游玩页面板不滚动规则被 workbench 祖先规则压掉 ... - .platform-tab-panel--game-play 覆盖带上 .platform-desktop-shell--workbench 祖先，压过 overflow: auto - E2E 游玩页断言补整页与面板的横向溢出测量，避免面板 overflow-x: hidden 静默裁切漏检 - 修正 E2E 探针里重复的 panelOverflowY 键名，拆成 panelOverflowY 与 panelOverflowStyle - 同步里程碑文档与 pitfalls 同日条目（单类名覆盖被祖先规则压掉、守卫实际为空）	2026-09-30 13:24:55 +08:00
k88936	e976a69f9f	详情页返回按来源回到上一页并改用浏览器原生返回 ... - GameDetailPage 左上角「返回游戏广场」简化为「返回」，不再写死跳广场 - 详情/游玩页返回优先 window.history.back()，由 popstate 还原真实来源页（我的游戏/广场） - activeAppPageRoutes 给应用历史条目补深度标记并新增 hasAppHistoryBackEntry() - 深链直开等无可回退条目时用 replaceAppHistoryPath 兜底回广场或详情 - 新增 activeAppPageRoutes 深度语义用例与 PlatformEntryActiveFlowShell「游戏详情返回」两条用例 - 同步里程碑文档 2026-09-30 与 pitfalls 同日条目	2026-09-30 13:05:55 +08:00
k88936	baca440c5d	对齐页签面板左右留白，修掉移动端右侧贴边 ... - 删除 .platform-tab-panel 里写死的 padding-right: 0.25rem：它是不分层规则，优先级高于 Tailwind @layer utilities 的 padding-inline，把右内边距钉成 0 - 同时删除 @media (max-width: 639px) .platform-tab-panel 与 .platform-desktop-shell--workbench .platform-tab-panel 里各自重复的 padding-right: 0 - 左右留白统一交给使用处的 px-3 / sm:px-6；没有 px 类的舞台（创作主页、我的、游玩页）保持 0/0 - 实测：390 下面板 12/12、列表左右留白 28/28；820 下 24/24、44/44（改前为 12/0、28/16 与 24/0、44/20），横向溢出仍为 0 - pitfalls 与里程碑文档同步该根因（unlayered 覆盖 Tailwind 层级）与测量结论	2026-09-30 12:52:15 +08:00
k88936	3bb1c28a51	修复我的游戏页移动端列表横向溢出并与画廊统一布局口径 ... - .my-game-list 改 grid-template-columns: minmax(0, 1fr)，单列 auto 轨道不再被内容最小宽度撑开 - .my-game-card 加 min-width: 0 与 overflow: hidden，卡片可被压缩并裁掉溢出，与 .game-card 同口径 - .my-game-card__title 加 min-width: 0 与 overflow-wrap: anywhere，长标题不撑宽标题行 - pitfalls 记录该机制（auto 轨道最小尺寸 = 内容最小宽度 + nowrap 简介 + 缺 min-width:0）与 Chromium 夹具判据 - 里程碑文档补上该修复与 390/360 视口的测量结论	2026-09-30 12:44:08 +08:00
k88936	e405a4f36f	修复游玩页启动面板居中溢出导致顶部内容滚不到 ... - .game-player-launch 纵向对齐由 center 改为 safe center（保留 center 作旧浏览器回退），溢出时退回 start，不再把标题裁到 scrollTop=0 也够不到的位置 - 同步修正 ≤820px 与 max-height:26rem 两处媒体查询里的 align-content - 把 overflow-y: auto 提到 .game-player-launch 基础规则，启动卡片成为唯一的内部滚动兜底，页面与 .platform-tab-panel 仍保持 overflow:hidden - pitfalls 记录该故障模式（居中溢出叠加内部滚动会让负方向那半不可达）与真实 Chromium 夹具判据 - 里程碑文档补上 safe center 口径与取证说明	2026-09-30 12:04:26 +08:00
kdletters	39823b05c1	修复Jenkins release渠道测试环境污染 ... 固定发布构建单测使用dev渠道，避免继承Jenkins的release环境变量。 记录Mac构建在Windows目标测试中读取NSIS配置失败的根因与排障口径。	2026-09-30 12:00:13 +08:00
kdletters	b7862288d0	移除AGC正式渠道产品名后缀 ... - release 渠道复用正式产品名陶泥儿，安装包与更新归档不再包含 Release 文本。 - 保留 release identifier 与 release-win/release-mac 更新分区，更新渠道身份回归测试。 - 同步客户端发布、运维与项目记忆文档。	2026-09-30 11:51:03 +08:00
k88936	dfd94c435f	Merge remote-tracking branch 'origin/master' into fix/mobile-style ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-09-30 10:20:58 +08:00
lhk229	6d8969a6fa	清理过期共享记忆与固定文案检查 ... 移除运维和原生壳对记忆文案的固定措辞检查，保留实际契约与权限验证 清理过期决策和踩坑流水账，保留当前兼容约束与未完成验证边界 明确共享记忆维护规则，并同步修正游戏发行计划的现行入口说明	2026-09-29 15:04:32 +08:00
kdletters	8315d5660a	后台公共组件收口到共享组件库并统一列表实现 ... - packages/shared/src/components/admin/ 新增 16 个后台共享组件（AdminPage/AdminPanel/AdminButton/AdminAlert/AdminTable/AdminField/AdminInfoList/AdminTagList/AdminPagination/AdminListPanel/AdminDialog 等）与随组件的 admin.css，经 @genarrative/shared/components 导出 - AdminListPanel 统一列表外壳：columns + renderRow、加载两口径（empty/line）、空态三态（state/text/row）、toolbar 与 pagination 槽位、showEmpty 判据、surface=plain（弹窗内列表） - AdminListPanel 新增列头排序（sortable/sortValue/sortDescription）：正序→倒序→不排序循环、同步 th[aria-sort]、稳定排序 - AdminDialog 统一弹窗外壳（遮罩/标题行/关闭动作/role=dialog/aria-modal/Esc/点遮罩关闭/初始聚焦/as=form），12 处各页自写弹窗全部改用它 - AdminFormat 新增 formatAdminDateTime/formatAdminDate，删除 7 份重复的本地时间格式化实现，修掉列表里裸 ISO 时间 - 21 个文件里 26 处列表全部迁到 AdminListPanel（24 处 columns 形态、2 处弹窗内 plain），页内已无手写表头或 AdminTable 当 children 的写法；累计 45 个可排序列 - 页面壳归一：错误报告补 AdminPage wide + AdminPageHeading，详情弹窗移出列表面板；模板管理列表从共享 ui Table 换成 AdminTable - 样式收口：公共组件规则随组件进入共享 styles，清理 admin.css 重复按钮/面板规则，.admin-tag 与 .admin-table th 改 nowrap，埋点用户列参考按钮紧跟本行并留行距，错误报告修版心 - 新增 scripts/admin-web-fake-api.mjs 本地假 API（含 overview/dashboard/tracking/error-reports/feature-gates/邀请码/兑换码/任务/充值/项目工程/AGC 模型与模板/游戏/账号/用户详情夹具），用于本地核对渲染 - docs 同步：共享基础组件库与展示页（后台组件层/列表排序/收敛范围/本地核对）、decision-log 与 pitfalls 记录迁移口径、排序边界与踩坑 - 验证：npm run admin-web:typecheck、npx vitest run apps/admin-web packages/shared/src/components/admin（26 files / 244 tests）、npm run check:encoding、git diff --check、prettier、eslint 全部通过	2026-09-29 22:39:41 +08:00
suzmii	2cc7df8074	修复 DirectProject 流式正文逐 delta 脱敏吃掉段尾换行导致 Markdown 结构损坏 ... - prompt_context.rs：sanitize_error_context 改为 split_inclusive('\n') 逐段处理并原样保留行终止符，「逐段脱敏」与「整段脱敏」同形（CRLF 仍归一成 LF，私钥块整行吞掉的旧口径不变） - codex_app_server/mod.rs：新增 direct_thread_delta_sanitization_preserves_line_breaks，钉住逐段脱敏 == 整段脱敏，去掉 split_inclusive 即红 - pitfalls.md：记入本次排障（含 chunk 起点路径误判这一同源未修缺陷）	2026-09-29 21:30:44 +08:00
lhk229	0dacfec429	修复 Game Agent 项目外读取的父目录链接绕过 ... 文件读取和目录列表逐段拒绝符号链接及 Windows 重解析点 新增受保护目录别名与文件链接回归测试，保留普通外部读取 同步技术方案与排障记录，明确真实路径要求	2026-09-29 13:34:59 +01:00
lhk229	59966b55c0	放开 Game Agent 读取工具的绝对路径和项目外路径 ... - agc_read_project_context 与 agc_list_project_files 改走 resolve_game_agent_read_path，绝对路径和离开项目的 .. 可以读 - 落在项目内的路径仍按项目相对路径处理，继续拒绝 .agent、凭据文件名、符号链接和硬链接 - 项目外读取同样拒绝这些受保护名字和链接，目录列表标记为未登记且不可导入 - agc_write_file、agc_apply_patch、素材导入和共享 normalize_relative_path 仍限定在当前项目 - Codex 进程沙箱仍是 read-only，提示词未改 - 决策记录、实施计划和 pitfalls 同步该口径	2026-09-29 12:18:11 +01:00
kdletters	30a190d183	修复 AGC NSIS 安装钩子在模板常量与插件目录之前编译导致的出包失败 ... - installer-hooks.nsh 顶层收敛为 !define / Var / !macro：迁移逻辑改成 !macro AgcMigrateLegacyIdentity，由 !macro NSIS_HOOK_POSTINSTALL 在模板插入点（Section Install，addplugindir 之后）展开，避免 include 时 INSTALLMODE 未定义走错分支、nsis_tauri_utils 插件目录还没 add 导致 makensis 报 Plugin not found 中断 - 旧展示名改走运行期变量 $AgcLegacyIdentity（替换 Push/Pop + Function），去掉 section 上下文里不可用的 Return 提前返回，清理与补建语义保持不变 - 文件头补编译期位置纪律：模板在 installer.nsi 第 28 行 include 本文件，早于 !define INSTALLMODE / MAINBINARYNAME 与 !addplugindir，顶层只能放声明 - build-release.test.mjs 新增守卫用例：顶层不得出现 Function、插件调用、模板常量引用或裸可执行语句（对修复前形态命中 36 条，含第 68 行顶层插件调用） - pitfalls 与 decision-log 记录该踩坑、根因、本机逐字复现与处理口径 - AGC 渠道安装身份隔离里程碑补 2026-09-29 钩子编译位置修正小节与本机探针取证	2026-09-29 18:00:03 +08:00
lhk229	06f7f145b8	Remove Absolute and External Path Restrictions of Design Agent. Fix mac runtime failure (#528) ... Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: #528 Co-authored-by: lhk <ink29535@proton.me> Co-committed-by: lhk <ink29535@proton.me>	2026-09-29 17:15:28 +08:00
suzmii	1099b2dad4	记录 M3 Windows 打包一致性验收结论与两条排障经验 ... - M3 里程碑补「验收记录（2026-09-29）」：准备步骤连续三次复跑 32 个文件内容与 mtime 不变；NSIS 包内 plugins/ 与 resources/plugins 逐文件 sha256 完全一致；运行时三个相对路径与声明必需产物 17 项在包内全部命中 - 与迁移前两份对照（本机 2026-09-24 已安装包、合并基线 8f59c034f 的 build.rs 产物）逐项比对：路径集合与源码派生内容、Unity/Godot 产物一致 - 记录两条已定性差异：Cocos payload 只构建 windows-injection（导出面与迁移前相同）、MSVC 链接产物不可字节复现 - 记录新风险：准备步骤与应用构建共用 target/<triple>/<profile>/deps/cocos_editor_bridge.dll - 定性 CI 唯一红项 background_agent_runtime_can_write_memory_and_project_files 与本 PR 无关：合并基线同样失败，本机实测第二个 follow-up 请求 5.18s/4.87s 而预算 2s - pitfalls 新增 2026-09-29 条目：随包资源编译产物摘要不可复现与共用输出路径的核对口径	2026-09-29 13:42:26 +08:00
kdletters	80bf54c39d	修复 AGC dev 渠道改名后旧快捷方式仍指向旧安装 ... - 新增 src-tauri/windows/installer-hooks.nsh：安装结束时按旧展示名（陶泥儿、Genarrative AI Game Creator）清理旧快捷方式（先用 IsShortcutTarget 校验目标）、旧安装目录与旧卸载项 - 同一钩子在用户原本就有旧桌面图标时补建当前身份的桌面图标、并始终补建开始菜单图标，解决 /UPDATE 下模板不创建快捷方式导致「点旧快捷方式→更新→自动启动新版」的循环 - build-release.mjs 只在 dev 渠道 + Windows 目标注入 bundle.windows.nsis.installerHooks，并让 node runtime 资源映射与钩子共存 - build-release.test.mjs 新增用例：只有 dev+Windows 注入、钩子文件存在且旧身份表完整、JSON Merge Patch 后钩子不被资源映射顶掉 - pitfalls 与 decision-log 记录改名迁移口径、删除边界与「再改展示名必须追加旧身份」的纪律 - AGC 渠道安装身份隔离里程碑补 2026-09-29 修正小节与真机升级验收项	2026-09-29 12:23:14 +08:00
kdletters	02c6d33e9c	把两条路由门禁串进 npm run lint 并用 guardrail 锁住接线 ... - 根因：check:nginx-spa-routes 与 check:pingora-route-parity 从来没有自动调用方（只有切换期聚合门禁 check:pingora-release-readiness 含 parity，而它不在 CI 里跑），所以红了一个月也没人看见 - package.json 的 lint 链在 check:maintenance-page 之后接入 check:nginx-spa-routes 与 check:pingora-route-parity，因此 check:repository-ci、CI 与 pre-push 都会执行 - check-production-ops 新增两条 guardrail：断言 package.json 的 lint 链里必须出现 npm run check:nginx-spa-routes / npm run check:pingora-route-parity，删任一条立刻变红（变异验证已做） - 文档：索引第五节与 Pingora 试点文档更新为「已接进 CI」；pitfalls 新增「为什么以前会漏：加新门禁先问它有没有自动调用方」 - 验证：npm run lint 全绿（含两条新门禁 + eslint + typecheck）、check:production-ops OK、encoding / doc-index / diff / prettier / eslint 通过	2026-09-29 07:42:58 +08:00
kdletters	38eb5b69ed	给路由 parity 门禁补反向覆盖，模板里的 location 必须被矩阵声明 ... - check-pingora-route-parity 新增 validateNginxLocationsAreCovered：两份 Nginx 模板里出现的每条 location 都必须被矩阵某条用例的 nginx 片段（location 前缀）声明，否则判红 - 这条针对的正是 2026-09-29 发行网关路由那类漂移：此前只做正向检查（矩阵片段必须存在于模板），模板单方面加路由时门禁一直是绿的 - 矩阵新增 web_root_spa（samplePath=/ → static/web/spa_fallback，片段 location = / + try_files /index.html =404;）并把三个新 id 列入必查清单；Pingora 试点文档补根路径回退与反向覆盖说明 - 验证：check:pingora-route-parity OK（24 路由）、check:nginx-spa-routes OK（12 路由 / 3 模板）、cargo test -p pingora-gateway 39 passed、check:production-ops、prettier / eslint / encoding / doc-index / diff 全绿；变异验证：往生产模板插一条无矩阵声明的 location → 只有反向覆盖报「production 模板的 location 没有被矩阵覆盖」	2026-09-29 07:29:41 +08:00
kdletters	5fee115f10	实现 Pingora 发行网关路由并关闭两处路由漂移待办 ... - 新增 RouteDecision::ReleaseGateway：/games/game_<32 位小写十六进制 id>/… 重写上游路径到 /api/game-distribution/releases/<gameId><asset>、清空 Cookie、不进 SPA fallback、不套接流保护分组、不受维护闸拦截，与 nginx 同名 location 同口径（只认小写 32 位十六进制） - 路由矩阵新增 games_release_gateway 用例（含 upstreamPath 期望值）与对应断言；parity 门禁支持 release_gateway 并把 games_spa_fallback、games_release_gateway 列入必查清单 - check:pingora-gateway-smoke 新增三条运行时断言：重写到发行网关且上游拿不到 Cookie、/games/detail 仍走 SPA、/games/game/index.html 仍是真实 404 - 文档：Pingora 试点文档补「平台同源发行入口」语义；pitfalls 记录 SPA allowlist 三处真相源与「发行入口不是 SPA」；按 docs/project-memory/README.md 删除两份已关闭待办，关闭记录写入开放事项索引第五节 - 验证：网关 39 passed、check:pingora-route-parity OK（23 路由）、check:nginx-spa-routes OK（12 路由 / 3 模板）、check:pingora-gateway-smoke 通过、cargo fmt --all --check、check:production-ops、encoding / doc-index / diff 检查全绿；变异验证：矩阵 upstreamPath 写错或拿掉 /games/detail 都会立刻变红	2026-09-29 07:24:52 +08:00
kdletters	16ff10111f	限制 dev 发布目录与 Jenkins 构建暂存的历史堆积 ... - production-api-deploy.sh 新增 --keep-releases（默认 2）：发布成功后保留 current 目标与最近 1 个历史 release，只清理同时含 api-server 或 web 标记的旧目录，清理失败只告警、不改变发布结论 - production-api-deploy.sh 新增 prune_old_releases 与参数校验：非整数或小于 1 的 --keep-releases 在任何动作之前失败 - check-production-api-deploy 增加默认值、显式值和非法值三类夹具，并断言非法参数不会提升 release - check-production-ops 增加 release 保留策略与三个部署 Job 暂存清理的合同 - Api Deploy、Web Deploy、Stdb Publish 三个 Jenkinsfile 在部署或发布成功后只保留最近 2 个 build/<version> 暂存，失败时保留暂存便于诊断和重跑 - 内联清理片段避开 Groovy 反斜杠转义，并在 set -euo pipefail 下对空 build 目录安全（if [ -d build ] 守卫加兜底） - 开发运维文档补充 release 与 Jenkins 暂存的保留上限口径 - pitfalls 记录 dev 根盘写满的两处根因（发布与暂存无上限、JNLP 幽灵 agent 刷 syslog）以及 Jenkins 内联 shell 的两个坑	2026-09-29 07:19:00 +08:00
kdletters	d8011a72fa	游戏分发 web E2E 的冷启动假失败改为浏览器级预热 ... - 现象：冷 Vite 下 check:game-distribution-web-e2e 先卡在目录卡片 20 秒等待，重跑又卡在游玩页「开始游戏」15 秒等待；同一时刻公开目录 API 已把该游戏排在第一 - 根因：原先的 fetch 预热只拿到 SPA 外壳（HTML 里没有路由模块），Vite 仍在断言阶段现编译这些模块图 - 修复：改成起浏览器后用一次性 context 真走 /games、/games/detail、/games/play（domcontentloaded + 2 秒 settle，120 秒上限，失败只告警），首个 goto 的 120 秒超时保留 - 复验：重启 dev 栈（冷缓存）→ 24/24 PASS；四条 web E2E（web / publish / publish-recovery / a11y）全部复跑通过 - 文档：里程碑补 2026-09-29 复跑记录，pitfalls 同日条目按实测证据补正	2026-09-29 06:54:47 +08:00
kdletters	198c208172	用已安装包现场取证随包 Codex，并收窄 Windows 验收边界 ... - Mac 客户端随包运行依赖补齐：记录已安装 陶泥儿开发版 0.1.154 的载荷完整性（coding-agent/win-x64 六个组件 SHA-256 与 manifest.json 6/6 一致、codex-cli 0.155.1）与随包 app-server 能在 Windows 起来的现场证据 - 说明该包在第一条 direct 回合报 items must not be empty 是 7ec984d0d 已修缺陷的现场复现（0.1.154 源码不含、0.1.158 源码包含，master 同用例通过），剩余验收收窄为安装器实跑 + GUI/Cocos 回归 - pitfalls 新增「用夹具 --agc-exe 直接验证已安装渠道包里的随包 Codex」的做法与判读口径 - 开放事项索引同步该行	2026-09-29 06:42:08 +08:00
kdletters	3fa4501c68	用 Jenkins 真实证据关闭渠道化第 5 条，并记录 dev-mac 卡在离线 mac 节点 ... - 渠道化里程碑：四渠道全量只读核对（dev-win 0.1.158、release-win 0.1.159、release-mac 0.1.139、dev-mac 0.1.142）与真实 Jenkins 日志/归档取证，条目 5「凭据不落日志、不进归档」勾选关闭 - macOS 里程碑：记录节点 genarrative-agc-macos-01 自 2026-09-24 19:54:51 +08:00 起 ChannelTermination 离线（JNLP 只能在 Mac 本机启动）、离线期间不产出半成品，以及日调度 Job 因此连续失败 - pitfalls：新增「AGC 发布类 Job 变红或卡住先看构建节点在线状态」的排查口径与只读检查命令	2026-09-29 06:18:40 +08:00
kdletters	e6c3729adb	AGC 发布前检查平台包体上限，并把上限单一来源 ... - shared-contracts 新增 GAME_DISTRIBUTION_MAX_PACKAGE_BYTES（200 MiB），服务端 module-game-distribution 保留同值常量并在注释里指明；api-server 新增 publish_package_limit_matches_the_shared_contract 守卫测试把两处锁一致 - AGC project/export 新增 ensure_within_platform_package_limit：读包阶段预检，超限返回「发行包 X MiB 超过平台上限 200 MiB；请精简资源后重新导出再发布」，不再让 200–512 MiB 的包白读盘/暂存后吃服务端 413 - 用例：project::export::npm_export_tests::publish_precheck_rejects_packages_over_the_platform_limit（边界=上限放行、超限文案、本地导出上限确实更宽） - 里程碑 C1 与 pitfalls 记录「本地导出上限 ≠ 平台发布上限」这一口径	2026-09-29 00:36:28 +08:00
kdletters	1951a88fba	网页侧证据复跑并修掉 Vite 冷启动造成的假失败 ... - check-game-distribution-web-e2e：导航前先 fetch 预热 /games、/games/detail、/games/play 三条路由（120s 上限，失败只告警），首个 goto 超时提到 120s，避免 Vite dev 冷启动（实测 /games 首请求 20.2s、warm 后 14ms）被当成页面故障 - 复跑合并 Web 预检改动之后的网页侧四条 E2E：web-e2e 24/24 PASS、web-publish 全过、web-publish-recovery 全过、web-a11y 全过 - 里程碑补「网页侧证据复跑（2026-09-29）」小节；pitfalls 记录冷启动判据与修法	2026-09-29 00:21:43 +08:00
kdletters	f6ccabf425	补客户端更新"校验失败不得当成功"的回归用例 ... - appUpdate.test：新增「签名校验失败时拒绝安装、不重启进程，并保留待装更新供重试」——插件抛 signature verification failed 时断言错误原样上抛、restart_agc_app 未被调用、重试仍走安装链路并在成功后重启 - 变异验证：把 restartAppAfterUpdate() 挪到 await downloadAndInstall 之前，该用例立即以 expected "spy" to not be called with arguments: [ 'restart_agc_app' ] 变红；还原后 7 passed - 客户端更新里程碑补记该覆盖与剩余边界（真机安装闭环与插件侧临时文件清理需真实设备与已发布包）；pitfalls 记录"重启必须排在安装成功之后"	2026-09-29 00:02:17 +08:00
kdletters	a59329995e	真机夹具加 running 用例：进程存活期间宿主可观测到运行中回合 ... - direct-execution-production-fixture：新增 running 场景（工具阻塞期间进程存活），轮询宿主账本抓快照，断言 phase=working、active 里恰好一条 kind=execute 在途许可、executorStopped=false；收尾后 phase=completed、active 清空、executorStopped=true，宿主侧条目顺序不变 - 复验：completed,passes,mcp,mcp-write,native,deadline,restart,running 共 8/8 passed - 记录事实：CLI/无前端宿主既无用户消息也无最终助手回复（前端写入），夹具断言只校验宿主侧条目；宿主侧"正在跑"的可观测事实两路径一致 - 文档：DirectProject 里程碑补该轮核对；pitfalls 扩写 CLI 历史只含宿主侧条目这一坑	2026-09-28 23:39:11 +08:00
lhk229	b0d94ed2d9	Merge branch 'master' into codex/fix-web-preflight-home	2026-09-28 23:37:47 +08:00
kdletters	c388803729	给真机夹具加 restart 用例：回合进行中杀进程后部分历史与宿主事实 ... - direct-execution-production-fixture：新增 restart 场景（契约 → 部分助手文本 + 阻塞原生工具 → 工具真开始后 SIGTERM 杀进程），断言部分文本与工具卡片按顺序落盘、被杀工具卡片是最后一行且无回执行、账本不伪造成 completed/executorStopped - 复验：completed,passes,mcp,mcp-write,native,deadline,restart 共 7/7 passed - 变异验证：把"等 400ms 再杀"改成"等 20s"（让回合自然跑完）后同一条用例立即变红（AGC must be killed mid-turn） - 记录事实：CLI/无前端宿主不写用户消息（GUI 由前端写），夹具断言据此只校验部分文本与工具卡片顺序 - 文档：DirectProject 里程碑补该轮核对与剩余 UI 侧边界；pitfalls 记 CLI 不写用户消息这一坑	2026-09-28 23:32:02 +08:00
lhk229	720498c028	合并最新主分支到 Web 环境预检修复分支 ... 同步远端 master 至 8b67efbcf 保留双方排障记录并解决文档末尾冲突 保留 Web 环境探测隔离与独立测试夹具修复	2026-09-28 23:26:18 +08:00
kdletters	4415c7a5ff	修复宿主自己收尾被记成本轮未完成（CLI 回执不再是通道断开） ... - fail_turn：宿主自己关的连接（is_closed）只把原因追加进终态说明，不再调 session.interrupt，避免把正常收尾改写成 interrupted - direct_execution：新增 ExecutionSession::append_terminal_note，与 interrupt 同款留痕但不改阶段；用户主动终止与真实通道故障保持原口径 - 复验：真 AGC CLI → 真 app-server → loopback Responses 夹具 6/6 passed（原来 6/6 失败）；completed 用例 phase=completed、executorStopped=true，terminalReport 为宿主真实交付报告 - 定向单测 codex_app_server::execution 13 passed（含 host_ended_turn_is_not_a_failure、user_requested_stop_is_not_recorded_as_a_failure）、direct_execution 26 passed - 文档：pitfalls 记录 Killer 定位与修复、decision-log 记该决策与边界、DirectProject 里程碑说明该夹具现为可复跑证路（两条 UI 验收仍需真实客户端窗口）	2026-09-28 23:23:56 +08:00