1904 Commits

Author	SHA1	Message	Date
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
k88936	dc7feec426	文档：DirectProject 队列条目事件投影、resolved_text 持久化与埋点归宿主收口 ... - ADR 状态改为 2026-09-30 落地完成，§2 补入队侧的“用户条目校验与冻结”，§5 埋点段去掉渲染侧 discard 与句柄表措辞 - ADR 词表收口：并发拒单/放行补拒单出口/放行期拒单三处改成入队失败与放行失败口径 - ADR §9 与实施计划同步归位后的符号名：active_turn_id_at、stale_turn_for_release、kick_queue_dispatch、complete_turn - 实施计划状态改为第 0–7 步全部落地，进度表第 6/7 步补落地说明与提交号，新增「2026-09-30 收口记录」 - 实施计划顶部路径口径补 thread_manager 之外去掉 direct_ 前缀的函数改名对照 - decision-log 2026-09-30 条目把“设计稿，尚未实施”换成落地提交链与验证结论，并补 09-24 条目指向落地证据	2026-09-30 16:39:45 +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	2b98b022c2	文档：待发消息条目改为事件投影、引用解析文本随条目持久化、埋点成绩归宿主 ... - ADR §3/§4/§5：在队条目 = 事件窗口里“有 queue.enqueued、没有配对 queue.removed”的折叠；队列事件不带 prompt、不带埋点身份，也没有宿主私有的第二类字段 - ADR §5/§9：引用 part 的解析文本写进自己的 resolved_text 并随条目持久化（缺省合法、旧历史照样解析），放行/历史回读/turn input 共用；放行读 identity_generation、终态比对后直写成绩，删掉候选/settle 两阶段与 attempt id - ADR 备选方案补 6–9 条（条目另存产物、整条 prompt、clientTurnId 兼作埋点身份、保留两阶段）与影响与代价（prompt 块顺序、埋点口径随放行搬家） - 实施计划：新增第 6 步（条目不再另存产物）、第 7 步（埋点成绩归宿主），落地进度表与状态同步；补 2026-09-30 文件路径口径 - decision-log：追加并修正 2026-09-30 条目（resolved_text 持久化、埋点链退役、不用 clientTurnId 兼作身份）	2026-09-30 15:48:38 +08:00
k88936	e70b338900	文档：DirectProject 待发消息条目改为事件投影，prompt 改为条目重投影 ... - ADR §3/§4/§5 与备选方案 6–8、影响与代价：删掉 StoredEvent.pending 的第二份产物，队列成员由事件折出；prompt 只在引用 part 上冻结算不出的片段（to_prompt_cache，宿主内存专用），canonical 形状与 prompt 放行时重投影；analyticsAttemptId 进 queue.enqueued - 实施计划：状态改第 0–6 步、落地进度表补第 6 步、新增「第 6 步：条目不再另存产物」的实现点与验收 - decision-log：追加 2026-09-30 修订条目（背景、三条决策、埋点身份的口径）	2026-09-30 15:20:39 +08:00
k88936	888c249ffd	Merge branch 'master' into feat/msg-queue-to-rust	2026-09-30 14:37:25 +08:00
kdletters	fb130d1847	新增 AGC 模型 Agent 模式与 Claude Agent SDK sidecar ... 后台模型目录增加 codex/cc 执行模式绑定，旧目录缺省兼容 Codex AGC 客户端按模型绑定路由 Codex app-server 或 Claude Agent SDK sidecar 随包携带 Node runtime、Claude Agent SDK 与匹配平台 Claude runtime 补充模型配置、客户端选择、运行时适配、MCP 取消和定向测试 同步 AGC 模型配置规范、里程碑计划与共享决策记录	2026-09-30 14:07: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	354acfd70b	文档：DirectProject 守卫清理落地，ADR 与实施计划标记完成 ... - ADR 状态改为 2026-09-30 落地完成，§9 守卫退役条目改成已落地口径 - 实施计划状态改为第 0–5 步全部完成，进度表第 5 步写成落地说明；第 4 步的 TurnAlreadyRunning 交还给第 5 步 - 09-23 接单化计划加后续注记：接单/拒单词表与 TurnAlreadyRunning 已退役，正文不再回改 - decision-log 的 09-30 条目补落地与验证结果，09-24 条目加落地指向	2026-09-30 10:41:10 +08:00
k88936	41c03d7199	文档：核实删调用身份守卫的前置判据，收敛第 5 步口径 ... - ADR §9 记录核实结论：取消兜底本来就同时释放占用、补写 turn.completed 并踢队列，删守卫不需要新增无条件终态；连接死亡的失败事实由 app-server 连接层落地 - 实施计划第 5 步改写：60 秒启动窗口闸门改挂 Thread Manager 的占用登记年龄，读者改读 direct_active_turn_id_at，TurnAlreadyRunning 一并删 - decision-log 追加 2026-09-30 条目，记录核实过程、决策与影响范围	2026-09-30 10:30:16 +08:00
k88936	25f3e41623	CLI 与夹具退役：DirectProject 只剩入队一个命令入口 ... - cli.rs 删 CliCommand::DirectCodexChat 变体、project_path_mut 分支、--direct-codex-chat 解析与派发 - direct_runtime/mod.rs 删 run_direct_game_creator_turn_at 与 run_direct_game_creator_turn_at_with_creation_type - 删 scripts/direct-execution-production-fixture.mjs（CLI 唯一消费者） - user_input.rs 模块注释改成"唯一的命令入口"，不再承诺 CLI 分工 - 顺带删掉只剩测试在用的 direct_turn_error_boundary_text，判据只剩 direct_turn_enqueue_failure 一处 - 三条命令边界测试改打 direct_turn_enqueue_failure(...).message，覆盖不变 - 文档：09-22 里程碑把 --direct-codex-chat 从"范围外（保留）"改成退役项，两份 Direct 技术方案的 CLI 承诺删掉， 09-23 ADR 的"CLI 保持 await"标为口径反转，decision-log 追加口径修正，实施计划标注第 4 步落地	2026-09-30 10:25:38 +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	68ba4c47d8	将决策记录模板移至项目记忆说明 ... 在项目记忆 README 的使用原则后恢复决策记录格式模板 说明模板按需填写，简单决策无需补齐全部字段 在决策记录文件顶部增加指向模板的链接	2026-09-29 15:05:14 +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	5454062423	合并 origin/master 到 Game Agent 读取路径分支 ... - 决策记录同时保留外壳状态栏浮层与 Game Agent 读取路径两条 2026-09-29 条目	2026-09-29 13:18:48 +01:00
kdletters	1d6cbd4b67	外壳状态栏退役，状态改由浮层提示承载 ... - 首页输入框下方与项目组页面头部那行状态栏退役：status 不再由页面渲染，统一由外壳浮层承载（WorkspaceLauncher 合成粘性状态与一次性提示，渲染 notice ?? statusNotice） - 进行中进度与失败结论走粘性浮层（sticky: true，不自动收起，切页回来仍可见）；成功与取消回显走一次性浮层（成功/取消 2.6 秒、失败 6 秒收起），一次性提示优先显示，收起后粘性状态继续显示 - 粘性状态只挂首页与项目组两个页面，进项目工作台、模板库、帮助页不再飘在界面上；运行/预览提示与取消回显不受该限制 - RunNoticeToast/RunNotice 更名为 LauncherNoticeToast/LauncherNotice，新增 sticky 与 neutral 色调，挂点改为 data-launcher-notice-toast，长文案容器限宽 min(680px, 100vw - 2rem) 并换行 - 收起回调只从 ref 读，不再写进 effect 依赖：此前外壳每次重渲染都会换一个内联箭头函数，把收起计时重新起算，长驻页面上的提示可能永远收不回去 - useHomeProjectCreation 三处取消（非空文件夹确认弹窗、打开项目选目录、新建项目选目录）改为清空状态并弹一次性浮层回显「已取消」，不再往页面上那行写文字 - 删除 HomeView 的 status prop 与状态行节点、ProjectsPage 的 status prop 与 .launcher-project-page-status 节点及对应 CSS 规则 - launcherNoticeToast 用例补粘性不收起、父组件重渲染不重新计时、取消回显短时收起；launcherNoticeShellWiring 用例补进行中状态与取消回显都只走浮层、首页不留那一行、粘性状态不进项目工作台 - appSurface/home.suite 三处取消断言改断浮层挂点；homeWebPreflight 与 designProjectRestore 的 hook 夹具补 showTransientNotice - 技术方案与 decision-log 记录该口径与边界：首页带按钮的「已创建的工作区」提示仍留在页面上	2026-09-29 19:35:49 +08: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	4a0f18e8a2	写明策划工作区是相对路径根目录 ... - system-prompt.md 说明工作区是相对路径根目录 `.`，策划文件仍放在工作区内并使用相对路径 - 技术方案与决策记录同步该句口径	2026-09-29 10:37:20 +01: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	8b305162c1	给宿主收尾修复补阶段回归断言 ... - host_ended_turn_is_not_a_failure 追加断言：宿主自己收尾后账本阶段仍是 Working，不得被改成 Interrupted（这正是 2026-09-28 CLI 回执变成"执行通道已断开"的根因） - 变异验证：临时补回缺陷版本的 self.interrupt(&reason).await 后该断言以 left=Interrupted/right=Working 变红；还原后 codex_app_server::execution 13 passed - decision-log 记录该守卫与变异结果	2026-09-28 23:57:59 +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