234 Commits

Author	SHA1	Message	Date
k88936	ad2b37c6d3	后台模型定价保存去掉版本比对：保存即整段覆盖 ... - shared-contracts：删掉 `EDITOR_GENERATION_PRICING_VERSION_CONFLICT` 常量 - spacetime-module：`EditorGenerationPricingConfigUpsertInput` 去掉期望版本字段，删掉版本比对方法与它的用例，入库只按请求内容整段覆盖 - spacetime-client：重新生成定价 upsert input 绑定（少一个字段），记录映射同步去掉版本 - api-server：进程内缓存去掉版本字段与 409 冲突错误，`editor_generation_pricing()` / `save_editor_generation_pricing()` 只返回配置本身，`EditorGenerationPricingStore::replace` 注释写明「只是缓存刷新、不做版本校验、不是拦截点」 - api-server admin/app：后台 GET 不再返回 `updatedAtMicros`，POST 不再读 `expectedUpdatedAtMicros`，删掉 409 映射与「旧版本被拒」用例，新增「连续保存两次以后一次为准」 - admin-web：定价类型去掉版本字段，保存请求不再回传版本，删掉 409 分支与「重新读取」提示及其用例 - docs：主规范新增「保存语义」段（整段覆盖、同时只有一个管理员在操作、缓存替换不是拦截点），后端数据契约、ADR 0005、里程碑 / 实施计划、决策记录与 pitfalls 同步为删除版本比对	2026-09-24 19:33:41 +08:00
k88936	ff38eb0308	Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-09-24 15:28:01 +08:00
k88936	42c3186e13	3D 生成面板开放模型版本选择，参数按模型能力门禁 ... - Model3dGenerationValidation.ts（新）：前端唯一一份参数校验，逐条复刻 platform-tripo 的 validate_generation_options 与 api-server 的 PricingParamView::validate（模型族能力、分件三个前置条件、face_limit_bounds、平台必显式项），并给出按契约联合类型做键的 MODEL3D_MODEL_TABLE 与禁用原因文案 - Model3dGenerationFormModel：模型版本改为用户可选，可选集只取当前端点有底价的版本；报价与请求体读同一个 resolveModel3dModelVersion；换版本或切档位时按新能力收敛档位与开关并开新一代次；v2.5 的贴图档位不带 textureQuality - Model3dGenerationForm：新增模型版本选择器（照图片面板的浮层选项形态），档位与开关按模型能力禁用并给出 title 原因 - Model3dGenerationModal：定价只读一次，模型选项与报价共用同一份快照 - Model3dGenerationSubmission / useModel3dGenerationTask：提交计划改成 endpoint 判别联合，两个端点各一个收口函数 - editorProjectClient：删掉「endpoint + 联合提交体」的单函数，改为 submitModel3dTextToModelRequest / submitModel3dImageToModelRequest 一个端点一个函数；basePrices 两层键改成契约枚举 - ImageCanvasOptionChoice.tsx（新）：把图片面板的浮层选项行抽成共享组件，3D 面板复用 - 测试：新增 Model3dGenerationValidation.test.ts（12 例），FormModel / Submission / Modal / useModel3dGenerationTask 补组合表与菜单用例，共 75 例通过 - 文档：实施计划与里程碑追加本轮口径与证据，decision-log 与 pitfalls 各记两条	2026-09-24 14:55:06 +08:00
k88936	d1e11c705d	Tripo 配置改为启动期失败关闭，缺网关或密钥的进程拒绝启动 ... - api-server 新增启动期门禁：会提交或会执行 3D job 的角色（api / external-generation-worker / all）缺 TRIPO_BASE_URL 或 TRIPO_API_KEY、值为空白或网关不是合法 HTTP(S) 地址时直接拒绝启动；bgfilter-worker 与 external-generation-controller 不受影响 - 删除内置默认网关常量，AppConfig::default() 的 tripo_base_url 改为空串；请求路径不再把超时静默钳到 .max(1)、重试钳到 .min(10)，坏值原样交给 TripoSettings 并映射 503，作为启动期之后的第二道防线 - 两个运行旋钮仍可缺省（沿用内置 60000 / 2），显式声明时零超时、非数字或重试超过 10 都判启动失败 - .env.example 与 deploy/env/api-server.env.example 补齐 TRIPO_* 必填说明；deploy/container/api-server.env.example 与 container-worker-smoke 生成 env 补占位值，避免容器压测与 Jenkins 分支预览起不来 - 文档：新增 ADR 0006 并登记 docs/README.md，同步外部生成 Worker 化方案、开发运维文档、CONTEXT.md、决策记录、踩坑记录与实施计划	2026-09-24 13:53:43 +08:00
lhk229	ec3a187dd7	处理编译大量warning问题 (#503) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/503 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-24 13:01:31 +08:00
kdletters	efbdf7031e	统一客户端维护态错误弹窗 ... 客户端维护响应统一识别并广播维护事件 AGC 与网页端根部展示维护大弹窗，收口发布、上传、资源换签和登录错误 补充维护态弹窗测试、类型检查与实施计划说明	2026-09-23 23:16:23 +08:00
kdletters	cf19241544	游戏发行入口改为服务端按模板派生 ... - 后台审核页删除「发行入口」输入框与前端 HTTPS 校验，审核请求只提交结论与公开修订号 - api-server 新增 GENARRATIVE_GAME_DISTRIBUTION_RELEASE_ENTRY_TEMPLATE 模板配置，审核通过时读版本取 gameId 并派生该游戏独立来源地址 - 模板缺 {gameId}、生产未配置模板、gameId 非主机安全字符或派生结果非法时审核通过失败关闭，非生产未配置时回落本地回环发行网关 - 同步更新发行来源 nginx 模板与说明、两份 api-server 环境变量样例、平台与运维主规范、发行里程碑实施计划和决策记录 - 真实栈 e2e 脚本不再传 entryUrl，并断言审核结果里的入口为服务端派生值	2026-09-23 21:33:42 +08:00
kdletters	e0c324c0ac	修复游戏封面生成素材 ID 回传 ... 生成游戏封面请求补充 AGC 客户端来源标记，确保队列 worker 返回 result。 补充封面生成请求断言，锁定平台素材 ID 回填链路。 同步记录缺陷根因与修复约定。	2026-09-23 21:29:18 +08:00
k88936	d231cc4602	合并 origin/master：保留 3D 契约与 provider checkpoint，旧玩法表随主线退役 ... - server-rs/crates/shared-contracts/src/lib.rs：采用主线的模块裁剪（删掉 cfg(any()) 遗留模块、补上 agc_analytics 与 game_distribution），同时保留本分支的 editor_canvas、model3d 模块与 EDITOR_GENERATION_OPERATION_KINDS 导出 - server-rs/crates/spacetime-module/src/migration.rs：主线删除的 410 行旧玩法表 normalize 段保持删除，保留本分支的 provider_kind / provider_task_id 兼容段与对应用例 - docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：校验清单同时保留 Tripo 3D 生成任务与 editor_background_music_generation / model3d_text_to_model / model3d_image_to_model - .gitignore：补回本分支新增的 3D 模型文件忽略规则（*.glb / *.gltf 等 12 行），压测数据段随主线一并删除 - 共享记忆：本分支的 3D 决策与踩坑条目保留在主线重排后的 decision-log.md 与 pitfalls.md 中	2026-09-23 19:39:30 +08:00
kdletters	c2c5e1ced5	发行包上限提升到 200 MiB 并支持 AGC 分片续传上传 ... - 发行包上限 100→200 MiB、展开总量 250→500 MiB，整包路由请求体上限继续从包上限派生；发行静态资源进程内缓存预算提到 256 MiB - 反代放行量同步放宽到 210 MiB：Nginx 三份模板的 client_max_body_size、Pingora 网关默认值与 env 样例、路由对照矩阵 - platform-oss 新增内部对象追加写 append_internal_object(_with_retry)，以 OSS 返回的 next-append-position 作为权威已收字节 - api-server 新增 upload-state / chunk / complete / reset 四条分片路由，抽出共享收口 confirm_validated_package；偏移不符返回 409 与权威偏移，校验失败删除半包并落 upload_failed - AGC 新增原生上传器 game_package_upload.rs（内容寻址暂存、分片续传、受控重试、进度事件）与 prepare / upload 两条命令，退役整包回传命令 - 渲染进程改为 prepare → 创建游戏 → 创建版本 → 原生分片上传 → 送审，LocalProjectExportPackagePayload 整包类型退役 - 同时修正 live 用例无法指向本地栈的两处基础设施问题：平台基址按传入 URL 选择，桥接层把 jsdom realm 的 Headers / Blob / FormData 降级成 Node 原生值 - 测试：platform-oss 74、api-server game_distribution 23、AGC 原生 4、发布相关前端 20；live 用例补真实栈「中断 → 续传 → 确认」断言（分片偏移序列 [0, 8388608]） - 文档：玩法创作主规范的上传合同、运维与 Pingora 文档、决策记录、发行里程碑口径，以及新增的续传里程碑与实施计划	2026-09-23 19:06:02 +08:00
kdletters	ebb288a6a4	统一客户端渠道产品名称 ... dev 渠道显示为陶泥儿开发版并保持既有 identifier 与升级链。 将产品名注入 Tauri、原生窗口、前端标题栏和关于页面，统一快捷方式与注册表展示来源。 补充渠道配置门禁、发布脚本测试和渠道身份文档。	2026-09-23 18:53:23 +08:00
k88936	58c59b750e	Merge remote-tracking branch 'origin/master' into feat/smart-paste ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-23 17:52:49 +08:00
k88936	985955205c	把 checkpoint 分支写实为 at-most-once 硬约束而非续跑能力 ... - worker.rs 模块注释明确 Tripo job 固定 max_attempts = 1，崩溃后租约耗尽直接终态失败、不会被重新 claim，因此不存在续跑路径 - worker.rs 说明 existing_checkpoint 是防御性硬约束，checkpoint 的日常用途是人工对账 - 技术方案与 ADR 把「崩溃后重新 claim 只查询」改写为「不重新 claim，带 checkpoint 的路径绝不二次 submit」 - 实施计划与里程碑同步 checkpoint 语义，不再宣称续跑	2026-09-23 17:50:04 +08:00
kdletters	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +08:00
k88936	b33a8a141c	3D 产物下载的重试改为覆盖整个响应体 ... - download_model / download_rendered_image 把「取响应头 + 读完 body」作为一次可重试事务， 每次尝试都重新取响应头并整体重下，不做断点续传 - body 传输失败与长度不一致归一成可重试的传输错误（不再带 HTTP 200），HTTP 状态只留在文案里 - 新增 TripoArtifactBytes（读完的产物）并公开 download_model / download_rendered_image 的 max_bytes 上限； 超限按 OutputSchema 失败且不重试，流式句柄 TripoDownloadedArtifact 收回 crate 内部 - api-server 的 read_artifact 改成对完整产物做落库前校验（只判空），体积上限转由调用方传入 - smoke 示例改为一次写入完整字节；新增「body 中途断开后整体重下成功」与「超限不重试」两个用例 - 同步技术方案与实施计划：把「只重试响应头」的描述改成「重试包住整个 body」	2026-09-23 17:01:40 +08:00
k88936	347d066fc5	3D 允许 projectId 为空的文档与共享记忆同步 ... - 实施计划（API 契约）：交付验收补上「只给 assetFolderId 合法」这一条。 - 里程碑（API 契约）：落点口径写成「两个都给合法、只给 assetFolderId（无画布工程）同样合法」。 - 实施计划（前端入口）：发送门禁改成「两个落点至少给一个」，projectId 可空、缺失时不发该字段，没有工程时结果只落素材库。 - 共享记忆 decision-log：在 G5 条目的「代价与取舍」里把「3D 仍要求 projectId」改成「同日按用户决定改为与其它工具一致」，并追加一条收尾说明（门禁常量改名、canvasCompletion 只随 projectId 下发、无工程时的读回边界）。 - 验证：node scripts/check-doc-index.mjs（221 份 Markdown 通过）、npm run check:encoding、git diff --check 通过。	2026-09-23 16:42:15 +08:00
k88936	825dde6602	3D 落点与结果引用对齐其它生成工具的文档同步 ... - 技术方案：落点改为「至少一个、两个可同给」，补上归一在预检之前完成并写回请求（预检值 = 队列载荷 = 落库值）；完成结果读取补上双落点与平坦引用的说明。 - 技术方案素材库一节改为「素材库行已接 model3d 分支（预览图渲染 + 拖入画布）」，后台 renderer / 精选 read model / 公开 grant 仍未接。 - 里程碑与实施计划（API 契约、前端入口、结果前端预览）同步新口径：两个落点同给合法、前端同时发 projectId + assetFolderId + assetLabel、素材库行已进入。 - 共享记忆 decision-log 追加本次决策（原因、代价、影响面、验证方式），并在旧的「二选一」条目上标注 2026-09-23 追加修正。 - 验证：node scripts/check-doc-index.mjs（221 份 Markdown 通过）、npm run check:encoding、git diff --check 通过。	2026-09-23 15:55:02 +08:00
k88936	1fa413a352	图生 3D 图片输入的失败语义同步到文档 ... - 实施计划写明预检失败的状态码口径：400 只覆盖跨 owner / 未登记 / 已删除 / kind 不符，403 / 409 / 5xx 保留原状态码，缺对象键 502 - 决策记录新增同日条目，说明收窄收敛范围与缺对象键改判 502 的原因、代价与验证方式	2026-09-23 14:59:52 +08:00
k88936	21b9d850c7	3D 落点契约文档同步为平坦可选字段 ... - 技术方案的请求契约段改成平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel，并把「二选一 + 同现拒绝」的口径与落点预检路径写清。 - 里程碑与实施计划把 tagged enum 的表述改成平坦字段与二选一验收口径。 - 前端入口与 Worker 计划的落点表述去掉 target 分支写法，改为只发 projectId / 素材库落点产出 assetId。 - 决策记录补一条：撤销请求侧 tagged enum、复用统一定点预检、素材名缺省回落默认名，并记下未做的目录归一与原因。	2026-09-23 14:03:13 +08:00
k88936	fc39080f27	Merge remote-tracking branch 'origin/master' into fix/clean-history-cmd ... # Conflicts: # CONTEXT.md # apps/ai-game-creator-shell/scripts/check-config.mjs # apps/ai-game-creator-shell/src/App.tsx # apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts # docs/README.md # docs/project-memory/shared-memory/decision-log.md	2026-09-23 13:27:52 +08:00
k88936	28a6fd97f8	修复：润色回写与粘贴共用同一条落点兜底，认不出的引用落文本而不是消失 ... ResourceReferenceInput 新增 mentionTokenOrText：provider 的 mentionToken，答不出来（契约被破坏）时退 contentPartText 的通用文本形态；粘贴插入、润色回写的候选扫描、整根替换的落点共用这一条 润色回写的候选不再跳过「答不出 token 的 part」：这类 part 在回包里没被提到时作为末尾孤儿补回来，而不是在翻译阶段直接消失 applyContentToRoot（初始草稿与润色回写共用）解析不出引用时落文本，不再是整条吃掉 新增两处输入区用例：provider 只答得出引用答不出 token 时润色回写仍保住引用；初始草稿里已解析不出的引用落成 @resourceId 文本。两处去掉兜底即变红 同步 AGC 聊天素材引用功能说明、引用粘贴解析实施计划与决策记录（落点兜底一条，含初始草稿行为变化的记录）	2026-09-23 13:11:17 +08:00
k88936	f138f648e7	修复：粘贴插入解析不出引用时落下文本形态，不再什么都不插 ... resourceReferences.ts 抽出 contentPartToken：part → 正文 token 的逐字投影，不补白、不裁剪（补白只在 joinMentionText 拼整段文本时加）；directCodexContentToPromptText 与新导出 contentPartText 都走这一份 contentPartText 就是单个非文本 part 的文本形态：资源落 @resourceId、Skill 落 $名称、附件落 @附件名、运行区域落 @标签，文本 part 返回 null $insertContentAtSelection 的兜底链改成 provider 的 mentionToken 之外再接 contentPartText，解析不出引用也一定有一段正常文本落到光标处，删掉「两条都答不出来就什么都不插」这条违背「粘贴内容逐字保留」的分支 新增单测覆盖四类 part 的文本形态与文本 part 返回 null；新增输入区集成用例（provider 的 toReference 与 mentionToken 都答不出来时粘贴仍按 @resourceId 落下），去掉兜底即变红 同步 AGC 聊天素材引用功能说明的粘贴解析小节，并在实施计划补记本轮评审的收口	2026-09-23 13:06:43 +08:00
k88936	857acd4190	文档：记录退役收尾删除AGC LLM steer 判定链 ... - ADR 与里程碑的复查收尾改为「steer 命令删除后整条 LLM 判定链一并退役」，去掉“单独评估”的过渡口径 - Runtime V1.1 的 V1.53 与主实施计划的 2026-08-10 节新增 2026-09-23 复查收尾说明，标明判定链已删除、现役只保留 runtime.steer 唤醒 - decision-log 的 2026-08-10 条目补更新说明，并从已知失败基线用例里移除已删除的 runtime_interrupt_for_true_steer_decision_only_interrupts_older_provider_cursor - pitfalls 的「Supervisor steer 不能只有内部排队事件」标注判定链实现已删除 - 里程碑验证段补充本轮 cargo check / typecheck / 编码与文档索引 / 幂等检索的实测结果	2026-09-23 12:35:08 +08:00
k88936	10f2f05437	文档：同步收尾清理里已删除的 Tauri 后台任务命令 ... - ADR 与里程碑的收尾清理段区分已删除的 start_game_creator_agent_runtime_task 与待处置的 steer 命令	2026-09-23 12:11:00 +08:00
k88936	645ef30752	文档：修正AGC斜杠命令与终端swarm chat退役口径并记录收尾清理 ... - 修正 ADR 与里程碑中「agent.compact / agent.resume / agent.run_status 权限门禁消失」的过宽表述，限定为 swarm_cli/input.rs 里那份终端命令校验，现役门禁仍在 - 修正 `GAME_CREATION_APP_COMMANDS`「开发 Agent UI 仍在用」的说法为 App 只消费命令 id 类型与审计粒度 - 里程碑新增「收尾清理」小节，记录配置向导悬空脚本、用户文案、孤儿 prompt 键、harness 死导出与无调用方 Tauri 命令的清理结论 - 里程碑验证段更新为本次实测数据（typecheck、appSurface 211 tests、cargo check、编码与文档索引、harness self-test） - AGC 渠道安装身份隔离实施计划移除已删除的 agent-swarm-test-chat.mjs - pitfalls 去掉 `agc:test:chat` 与 `--configure-only` 的过期表述 - CONTEXT 的「项目命令 id」术语按现役消费方改写 - 主实施计划与 decision-log 中被删 Tauri 后台任务命令名改为现役入口 start_game_creator_agent_background_task_for_session_at	2026-09-23 12:07:20 +08:00
k88936	4e90465c45	修复：素材显示名在词干为空时回退 asset.id，不再产生空引用名 ... resourceDisplayName 在文件名去掉扩展名后为空（`.env` / `.gitignore` 这类整名就是扩展名的文件）时回退 asset.id，回退值同样过 normalizeMentionName；空名字会让 token 退化成只有触发符的裸 `@`，候选菜单里是空芯片、粘贴解析还会认领正文里任何一处裸 `@` normalizeMentionName 的注释改为「只做归一化、不做兜底」，把兜底的落点写明在名字的来源侧 新增用例：`.env` 与 `config/.gitignore` 的显示名回退 asset.id、引用标签不再为空；把该回退去掉后用例变红 同步决策记录（校正「不做 resourceId 兜底」一条）、AGC 聊天素材引用功能说明与引用粘贴解析实施计划	2026-09-23 11:53:14 +08:00
k88936	c5a718ac0e	3D 定价后台可编辑补齐实现状态、验收证据与踩坑记录 ... - 主规范补公开读模型投影口径、覆盖文件缺段补齐、旧形状覆盖文件的发布前置门禁与加价项一致性约束 - 实施计划补实现状态表、逐条判据的验收证据与真实环境待验收项；里程碑标记已实现待验收 - 后端架构文档补 upsert input 的期望版本与事务内 CAS 语义 - pitfalls 补「省略即沿用会静默覆盖」与「公开读模型形状不能跟着存储形状走」两条 - decision-log 补实现期的四个口径：公开投影取文生加价项、CAS 复用 updated_at、覆盖文件缺段按默认补齐、旧形状不兼容改发布门禁	2026-09-23 11:48:30 +08:00
k88936	530538842e	文档：收口退役AGC项目对话斜杠命令与终端swarm chat入口 ... - 新增 ADR：记录斜杠命令与终端 swarm chat 入口整体退役的决策、保留项与影响边界 - 新增里程碑计划：登记删除范围、检查点、验证命令与未做边界 - 更新 decision-log：新增 2026-09-22 决策条目，清理被本次退役取代的历史命令条目 - 更新 pitfalls：移除已退役命令入口的现役表述 - 更新 CONTEXT.md 术语：把「斜杠命令」标为已退役说法 - 更新 docs/README.md：登记新 ADR - 更新 AGC 主实施计划：删除全部「聊天输入 /<cmd>」能力条目与终端聊天入口承诺 - 更新 Agent Runtime V1.1 文档：删除终端 swarm chat 入口整节，控制面统一记为 --agent-* CLI - 更新 DirectProject 里程碑计划：/history 入口表述改为显式重新加载对话	2026-09-23 11:10:55 +08:00
k88936	44148542f1	Merge remote-tracking branch 'origin/master' into feat/smart-paste ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-23 11:04:46 +08:00
k88936	1327cd53b7	3D 生成定价迁移先落文档：两段并列结构、SpacetimeDB 权威与后台编辑 ... - 主规范把 3D 定价改成按端点两段并列结构，事实源改为 SpacetimeDB，补契约归一化、后台保存语义与验收项 - 新增 ADR 0005，记录权威事实源迁移、公开读模型不变的取舍与四条被否决做法 - 新增里程碑规范与实施计划，列出范围、验收标准、文件切分、验证命令与两个回滚点 - 同步 Tripo 技术方案的定价段形状、后端架构表目录的两列说明、CONTEXT.md 术语与决策记录	2026-09-23 10:53:28 +08:00
k88936	5e36b61534	修复：引用名内部空白统一折成 -，粘贴解析不再多插一枚芯片 ... resourceReferences.ts 新增共享 normalizeMentionName：内部空白折 `-`、裁掉首尾，token 层幂等再折一次 素材显示名（resourceDisplayName）、Skill 名（目录读入与 toReference / mentionToken）、附件名（导入映射与 toReference / mentionToken）统一过这一份口径 resourceDisplayName 去掉 `|| asset.id` 兜底：引用名假定非空，不再回退 resourceId 前缀重叠 bug 由此收口：`@hero` 不再命中 `@hero-v2`（后一个字符不是空白），粘贴只剩正确的那一枚芯片 新增用例：素材 / Skill / 附件三类归一化口径、前缀重叠回归、Skill 目录名带空白、附件名带空白；把 normalizeMentionName 变异成恒等函数后新增用例全红 顺带修掉 referenceSourceProviders 用例里重命名遗留的 provider.match 断言与 skill provider 注释里的 match 同步 CONTEXT.md 术语、功能说明、实施计划与决策记录	2026-09-23 10:40:21 +08:00
kdletters	f502829fde	发布灰度默认关闭：修掉客户端“看得到点不动”与后台看不到 key (#482) ... ## 解决什么 你反馈的两个现象都是真问题，这个 PR 一次修掉： 1. **没开灰度也能看到发布按钮**：发布开关此前是「无 gate 行 = 默认开放」，所以没配灰度时后端把 `gameDistributionPublishEnabled` 判成 true，客户端就渲染了发布入口。 2. **按钮点了没反应**：发布动作的提示原先只写 `workspaceStatus`，而普通项目走 `DirectProjectChatView` 时并不渲染工作台状态行，于是「先打开一个项目再发布」「构建失败…」这类信息全都看不见。 3. **后台看不到 key**：预设项此前在未合并的另一个 PR 里，而且后台只列「已创建」的 gate 行。 ## 改成什么 - `is_game_distribution_publish_enabled_for_user` 要求 gate 行存在且 `enabled=true`：**灰度默认关闭**，未登录/无行/`enabled=false` 一律不开放；只有白名单 / 灰度比例 / 用户标签命中才开放。作者写入与新版本激活都按这条判据。 - 新增与作者无关的总开关 `is_game_distribution_publish_open`：管理员审核激活新版本只看「灰度是否开启」，不会因为审核员不在作者白名单里而被挡住（这是合入后立刻发现的回归，已修 + 有用例）。 - AGC 新增 `announcePublishMessage`：发布相关提示同时写工作台状态与 DirectProject 对话，点「发布到游戏广场」不会再像没反应。 - 后台「灰度发布配置」新增「可配置开关」列表：`game-distribution:publish` 等预设即使还没创建行也会显示，点「配置」按默认关闭填表，运营开启后填白名单/比例即可放量。 ## 验证 - `npm run check:game-distribution-media-e2e`（真实 Phaser 构建产物）现在覆盖：灰度关闭 → 作者拿不到入口 + 写入口 503 → 开启灰度 → 真实封面/截图直传 → 创建游戏/版本/上传/送审 → 管理员审核通过 → 网关 index.html 与 bundle 200 → nosniff；全流程通过。 - 后端：`cargo test -p api-server game_distribution` 19 passed（含新增 `game_distribution_publish_open_ignores_author_allowlist_for_activation`）、`frontend_runtime_config` 6 passed。 - 前端：admin 灰度页 10 用例（含「未创建的预设开关可见并可一键配置」）、AGC 聊天头 3 用例、网页发布页 15 用例；三端 typecheck、`check:encoding`、`check:doc-index`、`check:rustfmt`、全量 `npm test`（400 文件 / 4441 用例）与 `check:repository-ci -- origin/master HEAD` 全绿。 ## 上线注意 灰度默认关闭是**刻意**的：合入后到运营在后台把 `game-distribution:publish` 配置并开启之前，作者看不到发布入口、写入口 503；已公开游戏、目录、详情、发行网关、安全下架不受影响。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/482 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-22 21:38:03 +08:00
kdletters	57a72f652c	Phaser 项目一键发布：发布前自动构建与打包 ... - AGC：export_local_project_package 改为发布前构建——已有可玩入口直接打包；否则解析 game/（Phaser 4 + Vite 脚手架）或项目根的 npm build 脚本，缺 game/node_modules 时先跑 project.bootstrap（npm install），再走 project.verify 的受控 npm 运行器执行 npm run build，最后校验入口并打包；安装/构建失败返回带日志尾部的可操作错误。 - 新增 resolve_publish_build_plan 纯函数与用例：game 子工程优先并要求先装依赖、根 npm 工程回退、没有可构建工程时失败关闭。 - 后端：发行网关根路径（含尾斜杠）等价于 index.html，路由级用例覆盖 Cookie 拒绝门与根路径；生产仍由每游戏 origin 把根路径映射到该游戏入口。 - 脚本：check:game-distribution-media-e2e 支持 E2E_PACKAGE_ZIP 直接发布真实构建产物，断言从包内派生入口/资源，本地审核入口改为发行网关路径。 - 文档：玩法链路与实施计划记录「作者不构建、不打 ZIP」的 Phaser 发布口径与验证证据。 - 验证：真实 Phaser 4.2.1 + Vite 7 构建产物（相对引用）经发布链路后网关 index.html 200 / assets 1,388,719 B 200，播放页在 allow-scripts 沙箱 iframe 内渲染 PHASER-PUBLISH-OK 且点击交互生效。	2026-09-22 20:38:00 +08:00
k88936	ec1f207021	重构：引用 provider 的 match / candidates 改名为 fuzzyLookup / lookup，删除 onPasteText ... match(query) 改名 fuzzyLookup(query)：名字写明它是包含匹配 + 截断的模糊菜单查询 candidates() 改名 lookup()：名字写明它是精确查找用的就绪全量候选，不模糊不截断 删除 onPasteText 补读钩子：粘贴只用此刻就绪的候选，不等待、不补读，也不为解析提前读盘 输入区与资源 / Skill provider 同步改名，粘贴接管路径改读 lookup() provider 用例与粘贴集成用例同步：Skill 冷启动改为「保持字面，敲过 `$` 后可解析」 补 jsdom 缺的 Range.getBoundingClientRect 与 ResizeObserver 桩（候选菜单测量用，真实浏览器都有） 同步 ADR 修订、实施计划、功能说明与决策记录	2026-09-22 19:50:42 +08:00
k88936	6950e08506	功能：引用输入区支持粘贴解析 @显示名 / $名称 ... 新增 buildContentFromPastedText：粘贴文本按显示口径反解析，同名多候选与未命中 token 一律按文本保留 ReferenceProvider 增加可选 candidates 与 onPasteText：候选枚举保持纯函数，Skill 目录冷启动时补读一次 资源与 Skill provider 落地新缝，静默 provider（附件 / 运行画面区域）不参与粘贴解析 输入区在 CRITICAL 优先级接管 PASTE_COMMAND，仅解析出引用时插入并打 PASTE_TAG，一次 Ctrl+Z 整体回退 补充粘贴解析规则矩阵、provider 候选枚举与补读、输入区粘贴集成用例 同步 ADR 修订、实施计划、术语表、功能说明与决策记录	2026-09-22 19:06:19 +08:00
k88936	c42e087a30	Merge remote-tracking branch 'origin/master' into refactor/extract-dep-from-ref-inputer ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-22 17:41:24 +08:00
kdletters	e5460280ce	发布入口接入灰度开关 ... - 后端：GET /api/runtime/frontend-config 新增 gameDistributionPublishEnabled，复用 `game-distribution:publish` 判据（未配置或 enabled=false 时对已登录作者默认开放，显式收紧后只放行白名单/灰度命中用户，匿名恒为 false），前端入口与写入口共用同一事实源。 - 后端用例：新增 frontend_runtime_config_game_distribution_publish_is_scoped_to_authenticated_gate，覆盖默认开放、enabled=true 无白名单、白名单命中、deny 名单、enabled=false 回退与 rolloutPercent=100。 - 网页：平台壳按灰度隐藏「发布游戏 / 发布新版本」入口；/games/publish 直接访问时渲染「发布功能正在灰度中」并提供重新检查；读取失败按放行处理，由后端写入口把关并返回可读文案。 - AGC：新增 readGamePublishAvailability（同一运行时配置字段），只有命中才把发布回调交给 DirectProject 聊天头；字段缺失或读取失败按不开放处理。 - 文档：玩法链路、后端数据契约与实施计划记录灰度口径、入口行为与验证命令。	2026-09-22 17:12:04 +08:00
kdletters	1bd5fe9ff0	合并 master：AGC 项目快照整目录上传 ... - 合并 origin/master（bba4f0eb2：项目快照整目录上传 .agent，保留项目身份与 Agent 历史）。 - 自动合并无冲突；共享记忆与实施计划文档经复核保留双方条目，游戏分发功能面未受影响。 - 同步目的：Gitea PR 门禁要求 PR head 包含目标分支最新提交，合并后重新推送触发 Project CI。	2026-09-22 16:59:05 +08:00
kdletters	d047b16b91	合并 master：DirectProject 回合三态与 AGC release 每日调度 ... - 合并 origin/master 11 个提交（DirectProject 回合三态与投影 memo、宿主崩掉后的回合收口、权限拒绝后的忙态、策划对话布局修复、AGC release 每日调度）。 - 本次自动合并无冲突；游戏分发发布入口（App 的 requestGamePublish、DirectProjectChatView 透传、聊天头「发布到游戏广场」按钮）在新聊天状态机下保持接线。 - 验证：root / AGC / admin-web 三端 typecheck、全量 vitest、游戏分发 Rust 测试、encoding、doc-index、rustfmt 与 SpacetimeDB schema guard。	2026-09-22 16:54:38 +08:00
kdletters	f1b282f3cd	合并 master 并接入 DirectProject 新聊天架构 ... - 合并 origin/master（304 个提交：DirectProject 聊天容器重构、Project Supervisor 退役、策划附件导入、CI 隔离编译缓存等）。 - 接受 master 对 ProjectSupervisorView / SupervisorChatOnlyView 的退役与预览快捷测试收敛；发布入口改由 DirectProject 聊天头承载。 - DirectProjectChatHeader 新增「发布到游戏广场」入口（无回调不渲染、回合忙态禁用），DirectProjectChatView 透传 onRequestGamePublish。 - App.tsx 继续由工作台壳持有试玩包导出与 GameDistributionPublishPanel，沿用 project.export_package 权限确认队列；check-config 把该命令从 native-only 清单移回 App invoke。 - 后台游戏审核 API / 类型 / 路由测试与 master 新增的 AGC 模板管理按双方保留合并，并修掉拼接造成的接口与用例闭合缺陷。 - 修正 master 自带的 viteProxyConfig 断言：/api/creation-entry 属退役路由，测试改为断言不进入代理。 - 记录合并踩坑：语法结构内部的冲突不能简单按「双方保留」拼接，必须按某一侧骨架重建并跑 tsc 与单文件测试。 - 验证：全量 vitest 393 文件 / 4374 用例通过，root / AGC / admin-web 三端 typecheck，cargo check 与游戏分发 Rust 测试，encoding、doc-index、rustfmt、SpacetimeDB schema guard。	2026-09-22 16:45:29 +08:00
kdletters	bba4f0eb24	项目快照整目录上传 .agent，保留项目身份与 Agent 历史 ... - 新增 should_skip_project_snapshot_sync_path：快照同步放行 .agent 组件，并放行其中 .db / .db-wal / .db-shm 的 Agent 状态数据库 - 组件与后缀排除表提取为常量；should_skip_project_snapshot_path 行为不变，项目索引、checkpoint、Agent 上下文与 git 检查继续排除整个 .agent - project_snapshot 扫描入口切到新口径，.agent 的 manifest、agent.db、会话、日志、checkpoint、workbench 与 project.lock 全部参与同步 - 新增整目录扫描用例与策略用例，覆盖 .agent 内凭据、.env、版本库与构建目录仍被排除 - 主规范更新上传内容边界与后台归档范围：工程 ZIP 可用于还原项目身份与 AGC 对话历史 - 里程碑、实施计划与共享记忆决策记录同步 .agent 全量口径、真实上传与后台 ZIP 的运行时验证证据，以及 v1/v2 键布局边界	2026-09-22 16:39:12 +08:00
k88936	a6a938d5cc	文档：新增引用输入区重构与宿主注入的实施计划 ... - 记录一句话交付、五条验收判据、六个提交切分与验证方式 - 追加执行状态：六项已落地内容、顺带清理、验证结果（全绿门禁与定向用例）与未完成项（CSS 类名重命名、真机手感、粘贴解析）	2026-09-22 16:07:06 +08:00
k88936	10e63ecb6b	合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... - server-rs/Cargo.toml：删除与 workspace git 固定重复的 registry `ts-rs = "12.0.1"`，保留固定 commit 并写明「ts-rs 一律常开、绑定命令固定为 cargo test -p shared-contracts export_bindings」 - server-rs/crates/shared-contracts/Cargo.toml：删除 master 侧新增的 `ts-bindings` feature，`ts-rs` 保持常开依赖 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：去掉 `cfg_attr(feature = "ts-bindings", …)` 门控，derive 与字段级 `ts(...)` 无条件展开 - apps/ai-game-creator-shell/src-tauri/Cargo.toml：shared-contracts 依赖去掉 `features = ["ts-bindings"]`，继续保留本分支的 ts-rs git 固定 - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按上述依赖变更同步（shared-contracts 指向 git 源 ts-rs） - docs：同步 5 处绑定生成命令（去掉 `--features ts-bindings`），并在 decision-log 记本次合并的决策、代价与验证 - 其余暂存改动为 origin/master 带入的内容，冲突按两侧目的逐一合并 验证：cargo metadata --locked（server-rs 与 AGC 两个 workspace）、cargo test -p shared-contracts（119 + 5 + 5 + 2 + 2 全绿且无告警）、npm run contracts:model3d:generate 后 packages/shared 零 diff、cargo check -p spacetime-module --target wasm32-unknown-unknown、npm run check:encoding、npm run check:rustfmt、npm run check:spacetime-schema、git diff --check、暂存集 eslint / prettier 全过	2026-09-22 13:12:28 +08:00
k88936	61fe4c48af	图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... - 后端资源投影按 asset_kind 分叉，新增 project_editor_client_media_src 与 EDITOR_MODEL3D_ASSET_KIND：model3d 只投影预览图，模型本体只留 objectKey，预览缺失才回落历史口径 - tripo3d 存储新增按字节魔数识别模型 content_type 与扩展名映射，不采信 provider 声明与下载响应头 - editor_project_storage 把 model3d 加入 EDITOR_CANVAS_ASSET_KINDS 白名单 - 前端 CanvasAssetKind 与 image-canvas-core 类型新增 model3d：画布卡片渲染预览图或 3D 占位，类型角标新增「3D模型」，覆盖资格只在它与空类别之间成立 - 新增 model3d-preview 子目录（Model3dViewerModal / Model3dViewerModel），Tailwind 内联、不新增 CSS，失败原因分超限 / 格式不可识别 / 无 WebGL2 三类展示 - 选中工具条新增只读 preview-model3d 能力位，仅 objectKey 为空时置灰；打开预览同时选中图层并暂停画布快捷键与舞台交互 - 查看器包源对象 format 改为可选，新增「声明 Content-Type → 字节魔数 → 地址扩展名」三级格式判定并导出支持格式清单 - 导出工作流新增 3d_models/ 目录，模型下载按真实响应头 MIME 定扩展名、对象键扩展名兜底 - 新增 3D 生成入口：底部工具栏浮动子选项与文生 / 图生 3D 面板，落 projectResource + canvasCompletion，复用占位框与任务侧栏 - 3D 定价只读实时定价查询，段缺失即入口不可提交；幂等键由前端铸造，用户重试必须换键 - 新增 ADR 0003 / 0004 与实施计划、里程碑文档；更新 Tripo 技术方案、后端架构、CONTEXT 术语、decision-log 与 pitfalls - .gitignore 忽略仓库根目录手工下载的 3D 样例模型	2026-09-22 10:10:00 +08:00
k88936	a11cdf13d7	画布生成面板重开草稿与重试身份收敛到 canonical content ... 生成面板 state、重开草稿、重试身份与提交载荷统一为一份 content[] 重试身份改用 directCodexContentKey 内容指纹比对并删除 referenceIdsMatch directCodexContentToLegacyContentDto 只在任务落账的出站边界派生 账本回到草稿的反向翻译收敛为 legacyContentDtoToContent 单一实现 token 扫描从 ResourceReferenceInput 提到 resourceReferences 并两处共用 无法解析的资源引用合成 unknown 占位而不再静默丢弃 出站提示词规范化收敛为 resourceCanvasAssetGenerationPromptText 供两处共用 directCodexContentToPromptText 去掉 trim，空白只在整条 content 上判定 同步决策记录与 canonical content 里程碑落地结果	2026-09-21 22:56:32 +08:00
k88936	9fc55a5cac	写入Tripo 3D泥点默认价并锁定credit换算口径 ... - 受控默认配置新增 model3d 段：底价按端点 × 模型版本 × 是否有贴图，add-on 六项独立计价 - 换算口径固定为泥点 = ceil(0.8 × Tripo 官方 credit)，H 系列 10/20 与 20/30、P1 30/40 与 40/50、P2 100/110 - editor_generation_config 定向用例按 credit 表反算默认泥点价，改价必须先改 credit 表 - 段缺失语义改为显式摘段验证，仍保持 fail closed 不扣费不入队 - 主规范、里程碑、实施计划与定价管理方案同步默认价已确认与部署侧 override 风险	2026-09-21 22:07:55 +08:00
k88936	8968762274	合并 origin/master：DirectProject 输入校验取回空白片段回归用例 ... - validation.rs 保留本分支的 content_has_meaningful_input 与 Skill/附件独立上限，空输入报错取回 master 的用户可见文案“聊天内容不能为空” - wire.rs 取回 master 新增的 text_projection / user_input_rejects / valid_references / nonempty_text 四条回归用例，测试导入合并两侧 - resourceReferenceInput.test.tsx 取 master 的注释口径：草稿 text 投影会 trim，提交用的 content 保留 chip 后的分隔空格 - pitfalls.md 与《AGC聊天素材引用》改为「任意非文本 part 均算有效内容」，与四类引用的实际校验对齐 - 本地私有改动的 .env 不进入本次合并	2026-09-21 21:42:41 +08:00
k88936	7745264990	同步canonical content里程碑落地结果与润色口径 ... 里程碑与实施计划状态改为 implemented 记录润色按 token 原位恢复引用与附件、被改写 part 末尾补位 记录遗留 TODO：润色删掉 token 时无法反推原位置	2026-09-21 21:23:17 +08:00
k88936	6981648796	合并 origin/master：Supervisor 永久退役，项目对话收敛为 DirectProject 与 Design Agent ... - 解决 refactor/split-direct-project 与 origin/master 在 App.tsx、立项策划聊天视图、Direct composer/引用输入区、styles.css、Rust direct user item 与 appSurface 用例上的冲突，按「Supervisor 永久退役」口径保留 DirectProject 独立聊天容器与 Design Agent 两条产品路径 - 采纳 master 的策划 Agent V1/V2 退役：删除 GDD 审批卡、策划输入卡、planningLane、planningSessionV2、planningSessionContract、规划展示适配与 Rust planning_*_v2 命令、模块、契约及对应用例，不保留兼容别名或双跑路径 - 把 master「折叠思考显示单行预览」的目的落到当前结构：新增共享表现 chat/components/AgentReasoning/AgentReasoning.tsx（折叠态单行纯文本预览 + 箭头、展开态安全 Markdown），DirectProject 回合与策划回合共用，删掉两处写死的 pre 折叠实现 - 把 master「策划入口可选模型 / 推理档」的目的接到当前策划输入盒：复用 ConversationModelSelect 与 ComposerReasoningEffortSelect，配置写回仍走客户端配置通道 - App.tsx 删除只服务退役 Supervisor / 策划 V2 的 state、ref、effect、回调与死参数，并删除两条读路径都退役后的 workspaceProjectKind；openWorkspace 的工程类型入参保留为未使用契约 - Rust 侧保留本分支 canonical→wire 投影、无审计 Direct 回合与 direct user item 严格校验，并入 master 的 prepare_new_web_project_at 前置复核 - 更新 ADR 与 shared-memory 决策记录：策划当前只有 Design Agent、两条路径的共享表现清单，以及本次合并的口径、代价与验证证据 - 验证：AGC 与仓库 typecheck、check:encoding、check:doc-index、git diff --check、改动文件 eslint 0 error；AGC vitest 168 个文件中除 5 个 jsdom localStorage 环境失败文件与本分支既有 resourceTagStatsRefresh 失败外全绿，appSurface 198 passed / 13 skipped；Rust 定向用例 direct_codex_user_item、skill_pack、sessions 全过（整套分片在本容器受 /sbin -> usr/bin 触发沙箱预检失败，与本合并无关）	2026-09-21 21:09:34 +08:00
kdletters	c52e0814d6	AGC渠道安装身份隔离：不同渠道包体可在同一台设备并存 ... - 新增 channel-identity.mjs 单点定义渠道安装身份，默认渠道保持基线 productName 与 identifier - build-release.mjs 渠道 --config 同批注入 productName、identifier 与 updater 端点 - build-macos-ci.mjs 按发布渠道解析产品名，派生 .app、updater 归档与 DMG 名称 - main.rs 与 windows.rs 窗口标题取构建期产品名，同机并存的渠道客户端可区分 - config.rs 提权 ACL 的 managed 范围按目录名识别基线目录与渠道派生目录 - check-config.mjs 断言基线等于默认渠道身份且非默认渠道身份必须隔离 - build-release.test.mjs 与 prepare-macos-codex.test.mjs 补齐渠道身份与渠道首装包用例 - 更新 AGC 更新主规范、开发运维文档、共享记忆与渠道安装身份隔离的里程碑与实施计划	2026-09-21 17:06:03 +08:00