5216 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
k88936	8dccf04a62	更新导航游戏图标资源	2026-09-30 14:07:06 +08:00
k88936	5e2d47919e	Merge pull request 'Style/game play' (#543) from style/game-play into master ... Reviewed-on: #543	2026-09-30 13:55:57 +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	3b76c2611e	游戏分发四个页面的返回按钮文案统一成「返回」 ... - GamePlayPage 返回详情 → 返回（含启动超时面板里的按钮） - MyGamesPage 与 GamePublishPage（三处分支）返回游戏广场 → 返回 - 目标页仍由各自 onBack 决定，按钮不再承诺可能不对的目的地 - GameDistributionPages.test.tsx 超时用例断言改为 /^返回$/u - 同步里程碑文档与玩法链路文档的返回文案描述	2026-09-30 13:33:02 +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	0d3937b7eb	广场的发布游戏与我的游戏入口上移到 hero 右上角 ... - GameGalleryPage 新增 .game-page-actions 一行，把「发布游戏」「我的游戏」从 hero 下方的工具栏动作区移出，右对齐放在 hero 上方 - 工具栏只保留「游戏广场」标题与搜索框，不再和入口按钮挤在一行 - .game-page-actions 设 flex-end、0.6rem 间距与 1.1rem 底部间距；两个入口都不可用时整行不渲染，hero 位置不变 - 实测 390/360/820 三档：按钮在 hero 之上、与 hero 间距 18px、右边缘与 hero 对齐 - 里程碑文档记录该布局调整	2026-09-30 12:57:00 +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	301f66da2d	游玩页改成固定画布，移动端不再整页可滚 ... - PlatformEntryActiveFlowShell 在 game-play 舞台给页签容器加 platform-tab-panel--game-play，不再挂 overflow-auto，也不再叠加双份内边距 - index.css 新增 .platform-tab-panel--game-play，面板 overflow:hidden 并去掉右侧留白 - gameDistribution.css 让 .game-play-page 改 height:100%/min-height:0、播放器 flex:1 1 auto/min-height:0，删除移动端把页面撑高的 calc(100dvh - 8rem) - 矮视口（max-height:26rem，横屏手机）压扁启动面板并隐藏封面，保证「开始游戏」可达，页面与面板本身仍不滚动 - PlatformEntryActiveFlowShell.test.tsx 双向锁定游玩舞台页签容器不滚动、游戏广场等舞台仍保持滚动 - check-game-distribution-web-e2e.mjs 移动端段新增「移动端游玩页不可滚动（面板与整页都不溢出）」断言 - 里程碑文档补上该修复的根因、口径与验证记录	2026-09-30 11:44:35 +08:00
k88936	055a6d6658	首屏「立即试玩」改为滚动到列表而不是打开第一款游戏 ... - GameGalleryPage 的 hero 按钮不再取 visibleGames[0] 直接开详情，改为把游戏列表滚进视野 - 滚动按平台页签面板（.platform-tab-panel）算相对偏移并走 scrollTo({behavior:'smooth'})，缺少 scrollTo 时退化成直接赋值 - 新增 gameListRef 锚在列表工具栏，退役只服务该按钮的 featuredGame 派生 - GameDistributionPages.test.tsx 新增「首屏「立即试玩」滚动到列表，而不是打开第一款游戏详情」，断言未触发 onOpenDetail 且滚动落在页签面板上 - 里程碑文档新增「网页侧交互修正（2026-09-30）」记录该修正与验证命令	2026-09-30 11:44:26 +08:00
k88936	7b04830a02	Merge pull request '修复移动端顶栏折行与头像裁剪弹窗被底部主菜单遮挡' (#515) from fix/mobile-style into master ... Reviewed-on: #515	2026-09-30 10:29: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	54e534b101	Merge pull request '清理文档' (#535) from opt/prune-docs into master ... Reviewed-on: #535	2026-09-29 23:36:24 +08:00
lhk229	16f507ac15	Merge pull request '隐藏策划资源读取提示中的资源名称' (#534) from opt/hide-docs-name into master ... Reviewed-on: #534	2026-09-29 22:47:03 +08:00
lhk229	716aad24d9	Merge branch 'master' into opt/hide-docs-name	2026-09-29 22:46:45 +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	4cba964234	Merge pull request '修复 DirectProject 流式正文逐 delta 脱敏吃掉段尾换行导致 Markdown 结构损坏' (#533) from fix/direct-delta-markdown into master ... Reviewed-on: #533	2026-09-29 21:49:44 +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	a5664cb1c9	Merge pull request 'Remove Read Tools Path restrictions for gameagent' (#531) from feat/remove-gameagent-path-restrictions into master ... Reviewed-on: #531	2026-09-29 20:35:42 +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
lhk229	68ba4c47d8	将决策记录模板移至项目记忆说明 ... 在项目记忆 README 的使用原则后恢复决策记录格式模板 说明模板按需填写，简单决策无需补齐全部字段 在决策记录文件顶部增加指向模板的链接	2026-09-29 15:05:14 +08:00
lhk229	6d8969a6fa	清理过期共享记忆与固定文案检查 ... 移除运维和原生壳对记忆文案的固定措辞检查，保留实际契约与权限验证 清理过期决策和踩坑流水账，保留当前兼容约束与未完成验证边界 明确共享记忆维护规则，并同步修正游戏发行计划的现行入口说明	2026-09-29 15:04:32 +08:00
lhk229	5452956682	隐藏策划资源读取提示中的资源名称 ... 工具提示不再附加资源 ID，保留文件路径展示和实际读写行为。 同步策划 Agent 技术方案，说明新提示与历史消息的适用范围。	2026-09-29 14:31:27 +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	75ca16739a	修复 AGC 登录丢失会话主体导致的身份无效 ... - auth_session.rs 新增 SessionIdentity：登录主体取自响应用户投影、续期主体取自已持久化凭据文件，漏传主体不再是能写出来的状态 - complete_login 改用 SessionIdentity::Login(payload.user)，删掉原先写死的空 user_id 字符串 - commit_authenticated_session 在写 client-session.json 之前解析并校验主体，空主体失败关闭且不再留下半截会话文件 - 新增 validated_session_user_id：主体 trim 归一化，空值报「登录失败：登录服务未返回用户身份」 - 补 auth_session 定向用例三条：登录响应供主体、续期只带主体、空主体失败关闭	2026-09-29 12:14:59 +08:00
kdletters	c2a3cafe77	把人工门禁的「本机必然红」与「真缺陷」分开并写入索引 ... - 逐条探红：check:nginx-pingora-canary（无 nginx 时明示降级为静态检查）、check:pingora-canary-live-guard、check:pingora-direct-live-guard、check:production-health-patrol-env 全绿 - check:pingora-release-readiness-plan 红：门禁的 assertAbsoluteScriptArg 要求 POSIX 绝对路径（/opt/genarrative/current/scripts/...），Windows 必然失败，属 Linux/CI 专属门禁 - check:api-server-env 红：本机 .env.local 只有 LLM_API_KEY / DASHSCOPE_*，缺 TIANTOKEN_BASE_URL/API_KEY 与阿里云抠图 AccessKey，属本机环境缺口（与 ExternalV1 计划里已记的结论一致），不是代码问题 - 两条结论写入开放事项索引第五节，避免后续重复追查	2026-09-29 07:54:39 +08:00
kdletters	4f47343108	记录 dev 真实部署的发行读取契约与门禁接线审计 ... - 游戏分发里程碑新增「真实部署只读取证（dev 环境）」小节：平台同源入口 /games/<gameId>/ 与直连发行网关路径匿名 200（nosniff、CORP=cross-origin、ACAO=*、发行专用 CSP、cache-control max-age=60）、同路径带 Cookie 403、带 Cookie 走 nginx 映射仍 200（证明 proxy_set_header Cookie "" 生效）；生产 /api/game-distribution/games 当前 0 条已发布 - 索引第三节补该证据；第五节新增 2026-09-29 广度回归（npm test 423 文件 / 4482 passed / 26 skipped）与门禁接线审计（check:* 共 80 个：53 个自动可达、27 个生产/凭据/环境依赖型人工门禁），并给出审计方法 - 一次性审计脚本不入库；接线结论与「加新门禁先问它有没有自动调用方」一起保留在 pitfalls 与索引里	2026-09-29 07:49:18 +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	d67f9e03c0	修正索引第五节的分组数字 ... - 未勾选 11 条的构成更正为 macOS 节点 3 + 桌面会话 6 + 真实 Provider 2（逐份列出对应计划），此前写的 桌面会话 5 / Provider 3 与第二节表不符	2026-09-29 07:36:57 +08:00
kdletters	e34efc4675	按 2026-09-29 的真实状态重新盘点开放事项索引 ... - 第一节：占用锁计划补上 2026-09-28 的实测（write_lock 21 / gui_ 31 / project_execution_owner 8 / owner_diagnostic 4 passed），说明只差真机多窗口运行时表现与第 4 条 A/B 收口决定，并注明它用编号式验收标准、不计入复选框口径 - 第二节：重写为 current 口径——未勾选 11 条、6 份计划，按「macOS 节点 + 真机 / 桌面会话 / 真实 Provider」分组；另列 8 份已无未勾选但仍在等签收或外部环境的计划 - 第三节：游戏分发里程碑从「28 条」更正为剩 4 条，两份实施计划均 0 条；并更正解冻前提——2026-09-28 起发行入口改为平台同源路径，不再要求独立 HTTPS 发行域名与通配证书 - 第五节：补 2026-09-29 重新盘点（81 份计划 / 15 条未勾选 / 8 份文件），把 74 份与 43 条标为历史快照，并把 ``check:nginx-spa-routes``/``check:pingora-route-parity`` 从「仍红」更正为已转绿（含新增反向覆盖与 smoke 断言） - 阶段 A 实施计划：把「本机只到领域单测」更新为已补齐的真实栈证据（13 条 E2E + AGC live 发布 1 passed + 后台列表/ZIP 联调 10/10）	2026-09-29 07:34:14 +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	589f3582ae	补齐 Pingora 网关的 SPA allowlist 并关闭 SPA 路由漂移待办 ... - Pingora MAIN_SPA_PATHS 从 5 条补到 12 条（补 /components、/design-system、/games、/games/detail、/games/mine、/games/play、/games/publish），与前端路由源和 nginx 三份模板逐条一致 - 路由对照矩阵新增 games_spa_fallback（/games/detail → static/web/spa_fallback）并同步 Pingora 试点文档的 SPA allowlist 表，让 cargo test -p pingora-gateway matches_nginx_route_parity_matrix 真正覆盖这条 - 门禁与验证：check:nginx-spa-routes OK（12 路由 / 3 模板）、check:pingora-route-parity OK（22 路由）、网关全量 38 passed、check:production-ops OK、cargo fmt --all --check OK；变异验证：临时拿掉 /games/detail 后矩阵用例以 static mode mismatch 变红；dev 与生产 5 条 /games* 深链实测 200 - 关闭【待办】主站SPA路由白名单与前端路由源不一致 并写入关闭记录；另立【待办】Pingora网关缺发行网关路由（三份 nginx 模板都有 /games/game_<32hex>/ → 发行网关，Pingora 缺这条代理，切流后会 404）	2026-09-29 07:16:00 +08:00
kdletters	9112207089	记录游戏分发 E2E 家族 13 条全绿与 AGC 一键发布客户端取证 ... - 里程碑：新增 2026-09-29 小节，记录其余 9 条 E2E（dto-parity / upload-safety / upload-resume 两段 / package-limits / owner-isolation / sandbox / validation-restart 两段 / media / ops-rollback）全部通过及各自要点 - 证据矩阵：第 1 节补上 AGC 一键提交的客户端侧 live 测试证据（真实 publishLocalProjectGame 打真实后端、分片偏移不重传不跳段、同 localProjectId 复用 gameId），第 3 节补 2026-09-29 复跑耗时 - 开放事项索引：补 2026-09-29 的 13 条 E2E 复跑与 AGC live 证据，瓶颈口径不变	2026-09-29 07:08:30 +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	fdb09db8a3	打通本机 dev 栈的后台工程列表与 ZIP 联调并记录证据 ... - 项目自动上传与后台工程下载：查清「本地数据库 404」的成因是 standalone 未运行（并非库缺失），`npm run dev:spacetime` 启动后自动发布 xushi-p4wfr，`/healthz` 200 且认证投影从 spacetime 表恢复 - 记录联调结果：渠道端点返回 {"channels":["dev","release"]}、未认证 401、游标分页 50+34=84 条、官方门禁 check:agc-project-snapshot-admin-http 对两个真实项目各 10/10 通过（含逐文件 SHA-256 与 .agent 目录还原） - 开放事项索引同步：该计划只剩「新客户端安装版下的隔离实机自动上传」这一条	2026-09-29 06:37:40 +08:00
kdletters	d0b9bdebfe	补齐真机闭环的现场证据，并记下本会话不能跑 GUI 验收的约束 ... - 渠道安装身份隔离：记录本机 dev 0.1.154 与旧身份 陶泥儿 0.1.109 同机并存的真实样本、已装产物内嵌 agc/dev-win/latest.json 且不含 release 端点、两个安装包资源串互不串身份，并写明真机条件已具备 - 更新插件里程碑：写明检查一半已由清单核对脚本覆盖，安装一半在本机只差一次点击，并给出点击前后的取证口径 - DirectProject 两条运行时验收：勾选行注明宿主侧已由真 app-server 夹具取证，剩余部分是界面渲染与用户终止路径 - 记录环境约束：本会话不能启动用户可写目录下的可执行文件，GUI 验收必须在桌面会话执行	2026-09-29 06:27:04 +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