GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 22 Pull Requests 6 Actions Packages Projects 1 Releases Wiki Activity
4,840 Commits 27 Branches 4 Tags
3ab7b386f17dc6142fc4abfeebf8eacd231dfd0d
Commit Graph

4840 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
k88936 5aeaf38112 删除 project-development 用例里空的用户面边界注册函数 
- 删除 apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts 里空的 registerUserSurfaceBoundaryTests
- apps/ai-game-creator-shell/tests/appSurface.test.ts 去掉对应 import 与调用
- 它注册 0 条用例，留着只会让人以为用户面边界仍有覆盖
 2026-09-19 23:19:58 +08:00
k88936 6f5ca47385 删除空的 run-trace 用例文件与其注册 
- 删除 apps/ai-game-creator-shell/tests/appSurface/project-preview/run-trace.suite.ts（只剩一个空的 registerProjectRunTraceTests）
- apps/ai-game-creator-shell/tests/appSurface/project-preview.suite.ts 去掉对应 import 与调用
- 说明：该文件被清空后 parseAgentRunTrace 与 formatAgentRunStatus 已没有用例覆盖，重新补测属于后续单独任务，本提交只清理空壳
 2026-09-19 23:19:34 +08:00
k88936 3e3c3df41f 删除空的 run-status 用例文件与其注册 
- 删除 apps/ai-game-creator-shell/tests/appSurface/project-preview/run-status.suite.ts（只剩一个空的 registerProjectRunStatusTests）
- apps/ai-game-creator-shell/tests/appSurface/project-preview.suite.ts 去掉对应 import 与调用
- 空注册函数挂在测试入口上会让人以为运行状态还有用例覆盖，实际一条都没有
 2026-09-19 23:19:29 +08:00
k88936 051c21d97f 删掉立项策划用例里传给 App 的无效 agentDockVisible prop 
- apps/ai-game-creator-shell/tests/appSurface/plan-gdd.suite.ts 三处 React.createElement(App, {...}) 不再传 agentDockVisible
- 同 design-agent.suite：该 prop 属于 ProjectDevelopmentView，AppProps 未声明，传入不影响任何渲染，只会误导读者以为 Agent dock 被隐藏
 2026-09-19 23:18:49 +08:00
k88936 21382926dc 删掉设计 Agent 用例里传给 App 的无效 agentDockVisible prop 
- apps/ai-game-creator-shell/tests/appSurface/design-agent.suite.ts 四处 React.createElement(App, {...}) 不再传 agentDockVisible
- agentDockVisible 是 ProjectDevelopmentView（工作台）的 prop，AppProps 里没有它，传了也不会生效；它替换掉的旧 orchestrationMode/projectSupervisorOnly 曾经是真实的 App prop，留着会让人误以为这里会隐藏 Agent dock
 2026-09-19 23:18:39 +08:00
k88936 62f1ec83bf 让工作台壳写入的运行态提示不被通用错误兜底覆盖 
- apps/ai-game-creator-shell/src/features/agent-runtime/model.ts 的 projectRuntimeVisibleError 公共文案白名单补上「待回答问题已变更，请刷新策划状态」「需要在 Tauri App 内运行。」「请先初始化本地项目」
- 这三条是 App.tsx setProjectChatError 直接写入的给用户看的动作指引，此前不在白名单，经策划运行态窄条渲染时会被替换成通用的「策划 Agent 执行失败，请稍后重试」
 2026-09-19 23:17:30 +08:00
k88936 263588af6a 把运行中回合的秒级计时下移到耗时文案组件 
- apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectConversation/DirectProjectConversation.tsx 新增 DirectTurnElapsed，自己持有 1 秒 tick 与已耗时渲染
- apps/ai-game-creator-shell/src/view/project-development/chat/DirectProjectChatView.tsx 删除 turnUsageNow state 与其 interval，不再把每秒 tick 传给会话区
- 原先每秒 tick 触发的是整个聊天视图重渲染（含 Markdown 回合列表、工具调用组与队列芯片），现在只重渲染耗时那一小块
 2026-09-19 23:16:42 +08:00
k88936 49b6451548 补充Tripo下载器迁移待办 
记录Provider侧流式下载与第三方SDK保持原样的边界

增加等待上游SDK原生stream能力后的替换TODO
 2026-09-19 23:16:02 +08:00
k88936 50291a5e77 订阅过期恢复后补跑被搁置的 consume 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectThreadChatSubscription.ts 在 consume 的 finally 之后补一次 consumeAgain 重排
- SUBSCRIPTION_EXPIRED 恢复期间到达的通知会因 consuming 仍为 true 只置位 consumeAgain，而 do/while 已因异常退出，原先这批事件要等下一次通知才会被消费
 2026-09-19 23:15:48 +08:00
k88936 8aa737e032 「显示更早」读取失败时补上项目路径守卫 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts 的历史分页 catch 在写 statusNotice 前先比对 projectPathRef.current
- 与成功路径和首个屏幕加载一致；原先切换项目后旧项目在飞读取的失败会显示成新项目的错误
 2026-09-19 23:15:15 +08:00
k88936 9243bb42a1 去掉 Direct 回合成功后多余的第二次清单刷新 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts 的 runTurn 不再在成功路径刷新清单，统一由 startTurn 的 finally 刷新
- 原先一轮成功会先后调用两次 get_local_game_manifest，finally 那次已覆盖成功与报错路径
 2026-09-19 23:14:51 +08:00
k88936 67252d36b2 修掉写权限门拒绝后 Direct 发送队列永久卡住的问题 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts 在 ensureConversationWriteAllowed 返回 false 且未重跑时，主动放下忙态并继续 dispatchNextQueuedTurn
- 该轮已由 dispatchNextQueuedTurn 出队，原先 finally 只在 invoked 为真时继续出队，导致后续排队消息再也不发送且提示/队列芯片一直显示
 2026-09-19 23:14:18 +08:00
k88936 188614d5d2 改用Provider流式下载Tripo产物 
保持第三方SDK不变并在Provider侧读取签名模型URL

逐块暴露模型响应并校验Content-Length，smoke示例改为异步落盘

为未来SDK原生stream能力保留迁移TODO
 2026-09-19 23:14:00 +08:00
k88936 97fc1918c4 给 Direct 回合的前置步骤补上错误出口 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts 在 startTurn 的异步 IIFE 里加 catch，按项目路径守卫后把错误交给 onRuntimeError
- 原先只有 try/finally：写权限门 rejection 会成为未处理拒绝，回合静默失败且已乐观追加的用户消息没有解释
 2026-09-19 23:13:53 +08:00
k88936 034c369b88 排队发送后不再立刻抹掉「已加入发送队列」提示 
- apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts 拆出 clearDraftInput（只清输入与附件），排队成功分支改用它
- 原先同一事件里先 enqueueTurn 写提示、紧接着 clearPendingInput 把 composerNotice 置空，React 批处理下用户永远看不到队列确认文案
 2026-09-19 23:13:13 +08:00
k88936 884aabe6d7 Direct 聊天权限门改为必填，去掉默认放行 
- apps/ai-game-creator-shell/src/view/project-development/chat/DirectProjectChatView.tsx 删除 ALLOW_CONVERSATION_ACCESS 及两个权限门 prop 的默认值，改为必填
- 原先缺省实现恒返回 true，调用方漏传等于静默跳过工作台壳的读写权限判定；唯一调用方 App.tsx 本来就会传入两个门
 2026-09-19 23:12:28 +08:00
k88936 f58249a75e 给 clientTurnId 的回退生成补上随机熵 
- apps/ai-game-creator-shell/src/view/project-development/chat/conversation/directCodexConversation.ts 在无 crypto.randomUUID 的回退分支追加 Math.random 派生的随机串
- 原先只有时间戳 + 页内序号，多个 WebView 在同一毫秒创建首轮会得到同一个 clientTurnId，而 Rust 侧用它做项目级唯一校验与历史关联键
- 结果仍是 ASCII 字母数字与连字符组成、长度在 6..160 之间，满足 native 校验
 2026-09-19 23:12:02 +08:00
k88936 38fb9aa7ac 删除 Direct 输入区发送按钮里不可达的忙态分支 
- apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectComposer/DirectProjectComposer.tsx 发送按钮只在非 busy 分支渲染，去掉 '思考中' 文案、Loader2 转圈与 disabled 里的 busy 条件，并移除不再使用的 Loader2 import
- busy 时仍由既有 ComposerStopButton 承担停止入口，渲染结果不变
 2026-09-19 23:11:14 +08:00
k88936 b5e10f3851 合并 Direct 输入区来自同一模块的两条 type import 
- apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectComposer/DirectProjectComposer.tsx 把 gameCreationApp 的 GameCreationAppAssetManifestEntry 与 GameIterationVersion 合并成一条 import type
- 不涉及任何运行时行为
 2026-09-19 23:10:51 +08:00
k88936 c4e2793db1 把回合执行过程渲染的两层三目抽成 renderTurnProcess 
- apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectConversation/DirectProjectTurn.tsx 新增 renderTurnProcess，负责空过程、运行中平铺与结束后折叠三种分支
- 组件主体不再嵌套三目，渲染结果与 data-testid="turn-process" 等 DOM 结构保持不变
 2026-09-19 23:10:35 +08:00
k88936 79cb510891 把排队消息标题的嵌套三元改成提前返回 
- apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectComposer/chatComposerQueue.ts 的 queuedChatTurnLabel 先处理空文本再判断截断
- 返回值不变
 2026-09-19 23:10:01 +08:00
k88936 3160131889 给澄清问答卡提交路径补上 rejection 兜底 
- apps/ai-game-creator-shell/src/view/project-development/planning/PlanningUserInputCard.tsx 在 Promise.resolve(onSubmit(...)).finally(...) 之间加 .catch(() => undefined)
- onSubmit 的契约允许返回 rejected promise，原先只挂 finally 会把 rejection 变成未处理拒绝；与 GddApprovalCard 的处理口径一致
 2026-09-19 23:09:38 +08:00
k88936 c46687f0ef 把澄清问答卡提交按钮文案的嵌套三元改成顺序分支 
- apps/ai-game-creator-shell/src/view/project-development/planning/PlanningUserInputCard.tsx 把 answerPrepared / controlBusy||submitting 的嵌套三元改成先取默认值再覆盖的 submitLabel
- 文案取值不变
 2026-09-19 23:09:20 +08:00
k88936 137533484b 抽出策划视图共用的 Design 模式判据与回调兜底 
- apps/ai-game-creator-shell/src/view/project-development/planning/PlanningChatView.tsx 新增 designMode、designActionsBusy 与三个 Design 回调兜底常量
- DesignAgentPhaseStatus（顶部）与 DesignAgentPendingActions（底部）原先各自重复 designView||onDesignApprove、controlBusy||planGddDecisionBusy 和 ?? (()=>undefined)，现在共用同一份取值
 2026-09-19 23:09:00 +08:00
k88936 00063ba882 抽出策划输入区与提交按钮共用的禁用判据 
- apps/ai-game-creator-shell/src/view/project-development/planning/PlanningChatView.tsx 新增 composerDisabled，替换 ResourceReferenceInput 与提交按钮上逐字重复的四条件表达式
- 判据取值不变，后续改条件时不会只改到其中一处
 2026-09-19 23:08:02 +08:00
k88936 cb3d452a44 把策划输入框提交按钮文案的嵌套三元改成顺序分支 
- apps/ai-game-creator-shell/src/view/project-development/planning/PlanningChatView.tsx 的 submitLabel 改为先给默认值再按 needsUserInput / controlBusy 覆盖
- 取值结果不变，只是去掉三层嵌套三元表达式
 2026-09-19 23:07:42 +08:00
k88936 257e407df7 策划会话 GDD 展示的 agentId 改用 PLANNING_SESSION_AGENT_ID 常量 
- apps/ai-game-creator-shell/src/view/project-development/planning/planningSessionV2.ts 的 gddDisplayFromArtifact 不再写死 'planning-agent-v2' 字面量
- 与同结构里的 rootAgentId 共用 planningSessionContract.ts 的常量，避免 id 变更时要改两处
 2026-09-19 23:07:25 +08:00
k88936 0d3ab25499 删除输入区里只会在挂载时跑一次的草稿清空 effect 
- apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx 删除依赖只有 resetPromptPolish（稳定 useCallback）的 effect
- 该 effect 读 liveDraftRef.current 却把它排除在依赖外，实际只在挂载时执行一次；清空草稿时重置润色状态的逻辑已由 OnChangePlugin 内联承担
 2026-09-19 23:07:02 +08:00
k88936 2a8063a83a 让技能清单查询失败后可以重试 
- apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx 在 list_agc_skill_catalog / list_client_extensions 的 catch 里放开 skillCatalogRequestedRef
- 原先标记在调用前就置位且失败时不回退，一次瞬时失败会让该输入区此后不再拉取技能候选
 2026-09-19 23:06:05 +08:00
k88936 37c7477068 修正草稿文本把附件引用误回读成 $名称的问题 
- apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx 的 readDraftFromNodes 改为按 part.type 显式分支：附件引用回读为 @名称，技能引用回读为 $名称，未知类型返回空串
- 该 text 会被受控同步比较（对照 directCodexContentToPromptText 展开的 value），附件口径不一致会让受控输入区每次都判定草稿变化而重建编辑器
- 顺带去掉该处嵌套三元，与 resourceReferences.ts 的渲染口径对齐
 2026-09-19 23:05:34 +08:00
k88936 e259106267 拆出引用草稿键与 token 的取值 helper 消除嵌套三元 
- apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx 新增 referenceDraftKey/referenceDraftToken，替换 readDraftFromNodes 里构造 labels 时的嵌套三元表达式
- 行为与原先一致，只是把「resource 取 id、skill 取 name、其余取 label」的规则收敛到一处
 2026-09-19 23:04:47 +08:00
k88936 7a89a119d9 校正 check-config 免调用白名单中三条命令的说明 
- apps/ai-game-creator-shell/scripts/check-config.mjs 为 delete_local_game_memory、delete_local_project_file、pick_local_file 补写准确的剩余调用方说明（前两条只剩 Rust 测试直接调用命令函数，pick_local_file 前端与 Rust 均无调用方）
- 修正原先「命令由 native Runtime、CLI swarm 与 Rust 测试使用」这一对三条命令不成立的笼统说明
 2026-09-19 23:03:51 +08:00
k88936 57b28ce5cd 删除 ts-rs 生成器漂移产生的 DirectCodexUserMessageEnvelope 死文件 
- 删除 apps/ai-game-creator-shell/src/view/project-development/chat/generated/DirectCodexUserMessageEnvelope.ts
- 该文件是 ts-rs 导出按本机依赖版本漂移时多出来的产物，前端无任何引用，按 project-memory/pitfalls.md 的口径不提交
 2026-09-19 23:03:27 +08:00
k88936 4c7fd968dd 明确Tripo模型流式下载边界 
记录SDK与Provider只提供分块模型下载流

约定未来OSS上传直接消费数据流而不缓存完整模型
 2026-09-19 22:20:23 +08:00
k88936 876529e668 删除 Project Supervisor 前端链路并将项目对话收敛到 DirectProject 与立项策划 
- 删除 ProjectSupervisorView、SupervisorChatOnlyView、ProjectWorkspaceChatPane、AgentConversationOverlay、DeveloperProjectPanels、DeveloperRuntimePanels 与 features/agent-runtime/panels.tsx
- 删除 Supervisor 独立调试窗口：windows.rs 的 supervisor_chat_window_url / open_project_supervisor_chat_window、main.rs 的 invoke 注册、?supervisor-chat 与 ?agent-chat 前端入口、developer.json capability 和对应 Rust 用例
- 删除工作台壳的开发者 Agent 面板：DeveloperAgentPanel、useDeveloperAgentPanel、useDeveloperAgentState、developerAgentControls
- App.tsx 删除只服务退役面板的 state/ref/effect/handler（agentConversation*、文件/记忆/资产/画板/预览面板处理、commandLog、llmConfigStatus、editorBaseUrl、回放历史与 trace 面板状态、selectedAgent 等）以及由此产生的空分支，并把 requestRuntimeConfigOpen 接回本地 RuntimeConfigDialog
- 立项策划独立成模块：Design Agent 与 Planning V2 的容器和表现移到 view/project-development/planning/（PlanningChatView、PlanningUserInputCard、GddApprovalCard、DesignAgentSurface、PlanningLaneRuntimeStrip、planningLane、planningSessionV2、planningSessionContract）
- 改名到中性概念：ProjectSupervisorComponentProps→ProjectChatComponentProps、WorkspaceLauncherShellProps.ProjectSupervisor→ProjectChat、ProjectDevelopmentView.supervisor→chat、orchestrationMode→agentDockVisible、initialSupervisorMessageClaims→initialTurnClaims、ProjectManifestSnapshotSource 'supervisor'→'chat'、CSS project-supervisor-*/project-planning-*→project-chat-*
- 删除 PROJECT_SUPERVISOR_AGENT_ID 与 PROJECT_SUPERVISOR_PLAN_SOURCE 常量
- 工作台壳自己订阅 game-creator-manifest-invalidated，用 revision→清单→revision 配对读（source: asset-event）并入 currentProjectContext，且不重新检查项目目录；测试夹具改为按监听器集合广播该事件
- 删除只钉住退役界面的 appSurface 用例（旧调试窗口、开发者面板、Agent 对话浮层、运行历史面板）
- 同步文档：ADR、DirectProject 聊天模块抽离实施计划与里程碑、Provider 推理里程碑、策划会话 RuntimeV2、AI 游戏创作实施计划，并在 decision-log 新增 2026-09-19 条
- 删除随退役面板失去调用方的模块与导出：projectSummaryCommands.ts（1054 行旧 Supervisor 斜杠命令处理器）、AGENT_RUN_HISTORY_* 常量、agent-runtime/model.ts 与 project-summary/agentPresentation.ts 里的死导出，以及 agentRunTrace / memoryCommands / projectCommandPolicy 中无调用方的校验与解析函数
- 更新 scripts/check-config.mjs 与 scripts/check-native-shells.mjs 的窗口与命令守卫
 2026-09-19 21:59:44 +08:00
suzmii b1cadd0cc8 Mac 渠道接入更新包签名、OSS 上传与渠道清单
Project CI / AI game creator shell Rust shard 4/4 (pull_request) Successful in 7m17s
Details
Project CI / AI game creator shell Rust shard 1/4 (pull_request) Successful in 7m25s
Details
Project CI / AI game creator shell Rust shard 3/4 (pull_request) Successful in 7m26s
Details
Project CI / AI game creator shell Rust shard 2/4 (pull_request) Successful in 7m34s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 2m9s
Details
Project CI / AI game creator shell Rust crates (pull_request) Successful in 3m17s
Details
Project CI / Backend tests (pull_request) Successful in 11m30s
Details
Project CI / Repository checks (pull_request) Successful in 11m36s
Details
Project CI / Frontend tests (pull_request) Successful in 13m46s
Details
Project CI / Native shell tests (pull_request) Successful in 16m19s
Details
Project CI / AI game creator shell web tests (pull_request) Successful in 5m31s
Details 
问题：mac 侧此前只有 archive-only 构建，dev-mac 渠道不产出更新包、不上传、无渠道
清单，客户端拿不到 macOS 更新（里程碑曾因签名/公证凭据未就绪而暂缓）。

改动：
- build-macos-ci.mjs 改为 dev-mac 发布入口：开启 createUpdaterArtifacts 产出
  .app.tar.gz + .sig，生成 universal DMG 与渠道清单 latest.json，构建后用产物内
  烘焙的公钥复核签名，再按 AGC_RELEASE_DRY_RUN 决定是否上传 OSS
- 新增 verify-updater-signature.mjs（minisign ED 预哈希校验）+ 单测：验签失败或
  keyId 不一致立即失败关闭，绝不写 OSS
- Jenkinsfile：新增 AGC_RELEASE_VERSION / AGC_RELEASE_DRY_RUN（默认开启）/
  AGC_UPDATE_RELEASE_NOTES / OSSUTIL_BIN 参数；withCredentials 注入
  AgcUpdaterSigningKey(+密码) 与 AliyunAccessKeyId/Secret；归档补 latest.json、
  .sig 与更新摘要
- 既有单测口径更新：archive-only → 发布型，并新增「必须先验签再上传」守卫
- 文档：技术方案、里程碑、运维文档同步；Apple 签发与公证暂缺显式记录为
  未验证项（--no-sign、appleSigned=false、notarized=false）

验证：单测 11/11 + 42/42；Jenkinsfile 四个 sh 块语法通过；伪造 bundle 端到端
验证清单（两平台同 URL/同签名、universal 首装包被正确选中）、真实 Tauri 签名
验签通过、错钥匙报 keyId 不一致、篡改报校验失败、dry-run 上传计划顺序正确。
 2026-09-19 17:49:25 +08:00
suzmii 261228ed3f 修复 universal 首装 DMG 选择以兼容主线新增校验
Project CI / AI game creator shell Rust shard 3/4 (pull_request) Successful in 7m38s
Details
Project CI / AI game creator shell Rust shard 1/4 (pull_request) Successful in 7m46s
Details
Project CI / AI game creator shell Rust shard 4/4 (pull_request) Successful in 7m49s
Details
Project CI / AI game creator shell Rust shard 2/4 (pull_request) Successful in 7m57s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 1m59s
Details
Project CI / AI game creator shell Rust crates (pull_request) Successful in 3m20s
Details
Project CI / Repository checks (pull_request) Successful in 7m8s
Details
Project CI / Native shell tests (pull_request) Successful in 13m34s
Details
Project CI / Frontend tests (pull_request) Successful in 12m58s
Details
Project CI / Backend tests (pull_request) Successful in 14m59s
Details
Project CI / AI game creator shell web tests (pull_request) Successful in 5m8s
Details 
合并 origin/master 后，e3682fd06 新增的 selectFirstInstallArtifact 对
universal-apple-darwin 会推导出架构 x64，匹配不到本管线产出的
陶泥儿_<version>_universal.dmg，createUpdateManifest 直接抛
「首装 DMG 必须唯一匹配本次版本 x 和架构 x64，找到 0 个」。

- build-release.mjs：为 universal-apple-darwin 增加分支，按
  _<version>_universal.dmg 唯一匹配（与 build-macos-ci.mjs 的命名一致）
- build-release.test.mjs：createDmgFixture 支持 universal 命名；universal 用例
  补首装包断言，锁定两个平台键共用同一个 DMG

验证：管线同款 node --test 33/33 通过（合并前 32/33）；prepare-macos-codex
与 release-oss 用例同跑通过。
 2026-09-19 17:03:18 +08:00
suzmii 8c17e40d7d 合并 origin/master 并解决 pitfalls.md 冲突 
- 冲突仅 1 处：踩坑文档顶部双方各新增条目（本次合并相对 master 落后 88 个提交）
- 解决方式：保留 master 的 2026-09-19 / 2026-09-17 两条在前，分支的
  「universal 主程序必须配套双架构原生依赖」在后；另补齐标题前缺失的空行
- 本次提交内容为上游已合入 master 的文件，跳过 lint-staged/Husky，
  避免对 master 侧 99 个 js/ts 文件重新格式化产生无意义改动
 2026-09-19 17:01:57 +08:00
k88936 c48f0627cf 修复 ts-rs 对 enum 级 deny_unknown_fields 的解析告警并保留契约严格性 
- 把 server-rs 与 apps/ai-game-creator-shell/src-tauri 两个 workspace 的 ts-rs 从 registry 固定到上游修复 commit fd8679ef20f866f747c046b30bd29c15e3d7a003（PR #491：已发布版 12.0.1 的 EnumAttr 不识别 deny_unknown_fields，只有 StructAttr 会静默忽略它），两个 Cargo.lock 同步改成 git 源
- 说明固定原因与退出条件：crates.io 最新仍是 12.0.1、GitHub 最新 tag 仍是 v12.0.0，等发布 > 12.0.1 后改回 registry 版本并删除 commit 固定
- 明确不使用 ts-rs 的 no-serde-warnings feature 消警：它会连同 deserialize_with 这类真实未支持的 serde 属性一起静默，掩盖 Rust 与 TS 绑定的漂移
- 保留 shared-contracts 的 Model3dMultiviewInputs enum 级 deny_unknown_fields（该属性一直由 serde 生效，告警只来自 ts-rs 的属性解析），注释改为写明不要为消警删属性、也不要改用 no-serde-warnings
- 新增契约测试 tests/model3d_multiview_request_contract.rs：钉住 views/taskId 变体内部与请求体顶层拒绝未知字段，并覆盖 kind 与 camelCase 字段名解析
- 记录排障经验与决策：pitfalls.md 说明无 span 的告警不代表属性失效，decision-log.md 记录固定 commit、影响面与回退条件
- 验证：cargo check -p shared-contracts 与该 crate 的 cargo test 不再出现 deny_unknown_fields 告警且全绿；cargo test --locked -p shared-contracts model3d 加 prettier 后 packages/shared 的 model3d 绑定零 diff；AGC 的 cargo check --locked --bin genarrative-ai-game-creator-shell 不再出现该告警（AGC 侧仍保留 1 条既有的 deserialize_with 告警，与本改动无关）；npm run check:encoding、npm run check:doc-index、git diff --check、cargo fmt --all --check 通过
 2026-09-19 16:56:24 +08:00
suzmii 237e440057 Mac Jenkins节点接入sccache编译缓存 
原因：macOS universal 构建此前在 Jenkinsfile 与 build-macos-ci.mjs 两处把
RUSTC_WRAPPER 清空，依赖 crate 每次从零编译且双架构各编译一遍，逼近 90 分钟超时。

改动：
- Jenkinsfile 对齐 Linux 生产管线：RUSTC_WRAPPER=sccache、CARGO_INCREMENTAL=0、
  SCCACHE_CACHE_SIZE=20G，SCCACHE_DIR 固定到稳定缓存根
  ${HOME}/caches/genarrative-jenkins/agc-macos/sccache（可用
  GENARRATIVE_AGC_MACOS_CACHE_ROOT 覆盖），并输出 sccache --show-stats 供判断命中率。
- build-macos-ci.mjs 不再清空 RUSTC_WRAPPER，wrapper 由管线显式声明。
- 保留 CARGO_TARGET_DIR 指向 workspace 内 target，跨构建继续复用增量产物。
- 文档补充缓存根、覆盖变量与回退语义。

验证：sh -n/bash -n 通过；管线同款 node --test 34 项全通过；本地探针证明空缓存
首次 miss 编译、清空 target 后再次构建命中缓存不再编译。
 2026-09-19 16:55:00 +08:00
kdletters e3682fd06f 固定客户端dev服务并支持官网多平台下载
Project CI / AI game creator shell Rust shard 4/4 (push) Successful in 7m31s
Details
Project CI / AI game creator shell Rust shard 1/4 (push) Successful in 7m32s
Details
Project CI / AI game creator shell Rust shard 3/4 (push) Successful in 7m33s
Details
Project CI / AI game creator shell Rust shard 2/4 (push) Successful in 7m40s
Details
Project CI / AI game creator shell Rust smoke (push) Successful in 2m21s
Details
Project CI / AI game creator shell Rust crates (push) Successful in 3m11s
Details
Project CI / Native shell tests (push) Successful in 16m15s
Details
Project CI / Frontend tests (push) Successful in 14m57s
Details
Project CI / Repository checks (push) Successful in 14m48s
Details
Project CI / Backend tests (push) Successful in 20m7s
Details
Project CI / AI game creator shell web tests (push) Successful in 6m20s
Details 
移除服务器选择并按来源隔离登录凭据
新增官网客户端下载入口和匿名平台聚合接口
根据发布清单自动展示Windows与macOS首装包
补齐Mac首装元数据和上传顺序校验
同步定向测试与下载发布规范
 2026-09-19 16:19:28 +08:00
k88936 092bca7444 更新Tripo 3D模型Provider集成文档覆盖三个生成入口 
文档改名为「Tripo 3D模型Provider集成」，H1 同步去掉“文本到”前缀，并更新 docs/README.md 链接
目标段改为三个入口共用 TripoProviderClient，列明 submit / submit_image_to_model / submit_multiview_to_model
新增「三个入口的输入」小节，记录 prompt 长度上限、image input 裸字符串引用、multiview views 与 taskId 二选一及视图数量要求
新增「任务查询与下载」小节，记录 TripoTaskSnapshot、TripoDownloadedModel 与必须重复取 task 的原因
补充契约分层说明：产品级结果契约目前只服务 text-to-model，image 与 multiview 结果仍在 provider 层
非目标标注前端查看器由 packages/model3d-viewer 独立实现、本阶段不接 UI 链路，验收补上输入校验与 smoke 行为
 2026-09-19 16:19:05 +08:00
k88936 b0054fd51c 新增 3D 模型查看器独立包 
- 新增 packages/model3d-viewer（@genarrative/model3d-viewer），含 Model3DViewer、scene、loader、framing、status 与 index
- 组件只走 WebGL2 单一路径渲染 glb、单文件 gltf 与 fbx，未承诺格式或超过 32 MiB 时只渲染一行状态文案
- 取景按真实顶点做投影拟合，与模型尺度无关，复位回到打开时的取景
- 新增 framing 与 loader 的纯函数单测
- 根 package.json 的 workspaces 增加 packages/model3d-viewer
- scripts/check-npm-workspaces.mjs 与 scripts/check-npm-workspaces.test.mjs 同步工作区清单
- vitest.config.ts 增加新包测试匹配
- 同步 package-lock.json 的工作区链接
 2026-09-19 16:13:55 +08:00
k88936 99be1d76fe 抽离 DirectProject 独立聊天容器并删除工作台壳 Direct 状态 
- 新增 view/project-development/chat 模块：DirectProjectChatView 自己持有项目清单订阅、首屏锚点、历史分页、发送队列、附件、终止、草稿与本地消息
- DirectProjectChatView 入参收窄为项目路径、入口首轮需求（canonical content[]）和两条权限门，Direct 状态不再穿过 App.tsx
- 线程订阅与聊天 reducer 提成 useDirectThreadChatSubscription：subscribe/consume/notify 单飞循环、订阅欠账、SUBSCRIPTION_EXPIRED 重订与 DirectThreadChatState
- chat/components 按「一个组件一个目录、逻辑与表现同目录」重组（ChatHeader、Composer、Conversation、SettingsDialog、ToolCallGroup）
- DirectProjectChatView 拆成聊天头、会话区、回合、输入盒四个组件
- App.tsx 删除 Direct 专属 state/ref/effect/handler 与 directCodex 分支，首轮需求按 canonical content 交给聊天
- 工作台级动作（运行本地预览等）经 DirectProjectChatHandle.announce 交给聊天自己的本地消息流
- Direct 首轮认领记录提成 app/initialSupervisorMessageClaims，供各入口共用
- Rust 侧 Direct 契约 ts-rs 导出目录改到 chat/generated
- 补齐 direct_codex_user_item/wire.rs 既有的 rustfmt 空格漂移
- 同步 ADR、实施计划、decision-log、pitfalls 与 Direct 技术文档
 2026-09-19 15:08:31 +08:00
k88936 0c4b1c34d9 标注模型下载的重复 task 查询
Project CI / AI game creator shell Rust shard 2/4 (pull_request) Successful in 7m17s
Details
Project CI / AI game creator shell Rust shard 3/4 (pull_request) Successful in 7m19s
Details
Project CI / AI game creator shell Rust shard 4/4 (pull_request) Successful in 7m31s
Details
Project CI / AI game creator shell Rust shard 1/4 (pull_request) Successful in 7m39s
Details
Project CI / Backend tests (pull_request) Failing after 10s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 2m3s
Details
Project CI / Repository checks (pull_request) Failing after 10s
Details
Project CI / AI game creator shell Rust crates (pull_request) Successful in 2m36s
Details
Project CI / Native shell tests (pull_request) Failing after 11m43s
Details
Project CI / AI game creator shell web tests (pull_request) Failing after 10m21s
Details
Project CI / Frontend tests (pull_request) Successful in 12m23s
Details 
在 download_model 增加 TODO，说明 SDK 只提供 download_model(&Task) 因而必须再取一次 task

若将来 SDK 支持按 URL 下载，可直接使用 snapshot 中的模型 URL 省掉这次请求
 2026-09-19 14:17:31 +08:00
k88936 3c1059aa39 移除 TripoUrl 的 Display 实现 
删除 TripoUrl 的 Display，避免 `{}` 这类通用格式化输出带签名的完整 URL

完整 URL 仍可通过 as_str() 显式读取，日志与调试统一走 redacted() 或脱敏后的 Debug

技术方案文档补充该收敛说明
 2026-09-19 14:17:00 +08:00
k88936 1392303f1c 请求契约把 model 改为必填字段 
三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定

validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family

三个 client 的 to_sdk_params 改为直接提交模型版本字符串

冒烟示例与技术方案文档同步为必填写法
 2026-09-19 14:16:39 +08:00
k88936 12512f26b2 multiview 输入拒绝未知字段 
Model3dMultiviewInputs 增加 deny_unknown_fields，与 Model3dMultiviewToModelRequest 的严格反序列化保持一致

未知视图键（例如拼写错误的 righ）不再被静默丢弃，避免用少于调用方预期的视图提交任务

ts-rs 12 不支持 enum 级该属性，构建时会打印一条可忽略的告警，已在代码注释说明
 2026-09-19 14:14:55 +08:00
k88936 800da43a8d 说明生成结果 DTO 的 number 精度边界 
为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示

重新生成 TypeScript 绑定，把上述说明同步为 JSDoc

技术方案补充同一说明，明确不做 bigint/string 特殊处理
 2026-09-19 14:14:14 +08:00
k88936 b703f0c374 同步Tripo集成文档的契约导出与脱敏说明 
补充 TripoUrl 脱敏输出与 as_str 读取完整 URL 的说明

补充请求可选字段在 TypeScript 绑定中为 field?: T | null 及 model3d barrel 导出入口

补充 ts-rs 生成后需 prettier 格式化再提交的流程说明
 2026-09-19 13:17:58 +08:00