WIP: 重构/拆分directproject聊天组件 #420

Draft

k88936 wants to merge 116 commits from refactor/split-direct-project into master

pull from: refactor/split-direct-project

merge into: GenarrativeAI:master

GenarrativeAI:master

GenarrativeAI:codex/agc-project-upload-download

GenarrativeAI:feat/jenkins-mac-build

GenarrativeAI:feat/gptimage2to2.5

GenarrativeAI:feat/tribo3d-integeration

GenarrativeAI:feat/agc-organize-assetkind

GenarrativeAI:feat/mac-universal-package

GenarrativeAI:feat/ui-editor-v3

GenarrativeAI:fix/agc-acceptance-followup

GenarrativeAI:feat/agc-canvas-acceptance

GenarrativeAI:fix/ref-persistent

GenarrativeAI:feat/more-ref

GenarrativeAI:feat/bgfilter-api

GenarrativeAI:fix/ci

GenarrativeAI:codex/platform-session-identity-credential-split

GenarrativeAI:fix/chat-state

GenarrativeAI:feat/Crt_Ws

GenarrativeAI:codex/fix-model-refresh

GenarrativeAI:feat/smart-ref-ui-res

GenarrativeAI:codex/preview-llm-router-config

GenarrativeAI:fix/stroke-width-regression-from-285

GenarrativeAI:agent-organize

GenarrativeAI:feat/expose-image2edit

GenarrativeAI:feat/game-agent-canvas-resource-workbench-v2

GenarrativeAI:feat/agc-new-workflow

GenarrativeAI:fix/agc-release-version-sync

GenarrativeAI:codex/shared-components-followup

GenarrativeAI:codex/agc-runtime-generation-reliability

GenarrativeAI:codex/game-agent-runtime-interaction-design

GenarrativeAI:feat/spine-sequence-export-v2

GenarrativeAI:codex/agc-platform-account-editor-api

GenarrativeAI:codex/game-agent-run

GenarrativeAI:codex/ui-spritesheet-durable-transaction-latest

GenarrativeAI:feat/art-agent-more-tools

GenarrativeAI:codex/editor-canvas-null-source-repair

GenarrativeAI:hotfix/editor-layout-2mib

GenarrativeAI:codex/showcase

Conversation 2 Commits 116 Files Changed 69

+3597 -1810

k88936 commented 2026-09-18 17:08:10 +08:00

Member

Copy Link

Copy Source

close #418 #365 #364

close #418 #365 #364

k88936 added 114 commits 2026-09-18 17:08:10 +08:00

新增 DirectProject 用户 Response item 契约 ... dfd6fadedf

新增 Rust canonical user item 与 Codex wire 转换模块

增加 ts-rs 绑定目录及生成文件检查边界

更新聊天素材引用规范与里程碑实施计划

重构 DirectProject Agent 深模块 ... 948a80fc49

将 direct_runtime 与 codex_app_server 改为目录模块

拆分 user item 的模型、校验与 wire 投影文件

抽离 DirectProject 历史注入载荷构造 seam

抽离 DirectProject 身份解析模块 ... 5ec40c8b83

将项目 canonical identity 与 digest 放入独立文件

保持 Codex app-server 线程池调用接口不变

严格使用 DirectProject Response item 历史 ... 7e35d7c344

移除 game-creator-conversation.v1 读取 fallback

历史注入前逐项投影 canonical user item 为 Codex message

无效 item 在持久化前失败关闭

补齐 Response item 严格合同测试 ... 9e83f1d88c

拒绝资源引用额外身份字段与未知 content part

补充历史 item wire 投影边界测试

同步 DirectProject 历史文档为无 fallback 合同

删除旧 DirectProject 引用协议 ... 7d5b9071e7

移除 DirectCodexTurnReference 平行 DTO 与渲染路径

将引用数量上限收回 canonical user item 校验模块

补充前端用户 Response item 契约测试 ... 2b38eaafba

覆盖 Lexical 文本与引用交错顺序

验证资源引用只发送稳定 resourceId

更新用户 Response item 里程碑进度 ... ba3aa3ccdb

标记 canonical、wire 与失败关闭验收项

同步实施计划为进行中状态

接入前端 canonical 用户 Response item ... 9ad66a67a3

按 Lexical 顺序构造 message.content

DirectProject payload 改为发送 userItem

策略重试保留同一 canonical item

收紧历史测试与注释口径 ... 17716347e2

移除 legacy 投影描述

将历史测试统一为 Response item 合同

修正 Response item content 类型投影 ... 3353906e6f

区分 turn/start 的 text 与历史 message 的 input_text

将 AGC 私有引用转换为标准 input_text

新增回归测试避免未知 variant text

移除 DirectProject 回合输入的重复赋值 ... 2c623bb577

删除已在对象初始化时设置的 userItem 重复赋值。

复用资源引用的统一内容映射 ... f213987f9a

让 Lexical 草稿读取复用 chatReferenceToContentPart，避免引用字段映射分叉。

拆开聊天草稿内容分支判断 ... a543b75cf7

将资源草稿转换的三种回退路径改为显式分支，保持现有优先级并提升可读性。

清理策划模式提交后的聊天草稿 ... c266ae7b50

规划 V2 提交时同步清空资源引用和 canonical content，避免切回 DirectProject 后复用旧输入。

避免 DirectProject 回合输入的无必要克隆 ... 22e830ff93

在互斥的观察器分支中移动 optional user item，避免深层 JSON 克隆。

移除未使用的 DirectProject 输入信封类型 ... cd2edd6966

删除未被调用且未生成到前端绑定的 DirectCodexUserMessageEnvelope，收窄内部 API。

避免重复校验 DirectProject 用户输入 ... 1da106af7d

复用 canonical 到 prompt 投影函数中的校验，删除不可达空 prompt 分支。

按运行模式创建 DirectProject 回合输入 ... b3b5d77990

仅在 DirectCodex 产品运行时生成 direct clientTurnId 和 user item，避免旧 Supervisor 与策划链路复用错误身份。

复用 DirectProject 用户输入校验读取的 manifest ... f2030a616f

让校验返回已读取的 manifest，wire 投影复用同一份数据，避免一次输入重复读取项目清单。

过滤 DirectProject 编辑器的空白内容 part ... 3c7b02b9f8

跳过纯空白文本节点并合并相邻文本，避免引用后的分隔空格和换行触发 Rust 空输入校验。

过滤 canonical 草稿中的空白输入 part ... 35733f0e33

在统一 user item 转换入口移除纯空白 input_text，覆盖恢复草稿和所有提交路径。

抽取通用富文本输入组件 ... ec286b3480

新增可复用的 RichTextInput Lexical 输入外壳。

让首页输入与资源引用输入共享编辑器、回车提交和禁用状态。

保留首页附件与图片粘贴节点能力，并移除 DirectProject 草稿 legacy fallback。

统一聊天草稿 canonical content 状态并更新资源引用测试。

收敛输入编辑器单一状态并补齐附件投影 ... 87b798322e

聊天与快速编辑输入统一由 Lexical 编辑器持有唯一当前状态

App 通过输入句柄读取草稿，移除跨视图 EditorState 和字符串镜像

DirectProject 将附件与图片 sidecar 投影纳入 prompt，支持附件-only 输入

迁移润色测试并更新 DirectProject 里程碑验收记录

合并主线并保留 DirectProject 输入行为 ... 5fb3db662b

合并主线回合队列、工具流展示与活动回合管理

保留 Lexical 单一输入状态及附件图片 sidecar 投影

收敛 DirectProject user item 校验、历史恢复与图片预算

同步输入链路里程碑和历史异常恢复文档

内联 DirectProject 附件与图片内容 ... 46e3cd9744

新增附件与图片 canonical content part 及 ts-rs 绑定

移除 DirectProject Tauri 附件 sidecar 追加路径

修正前端引用字段与生成类型适配

补充附件图片顺序投影测试并同步里程碑文档

修复总控草稿恢复后被清空 ... b607501916

- 仅在非纯聊天模式清空聊天编辑器

- 保留纯聊天模式恢复的会话草稿

修复建议命令草稿残留引用 ... 30e27abc60

- 准备命令草稿前先清空编辑器

- 避免提交用户上一轮选择的素材引用

修复快速编辑润色结果未回填 ... d5c4e0e780

- 为快速编辑输入区绑定编辑器句柄

- 润色回调同时更新面板状态与编辑器文本

修复润色按钮无法感知输入 ... 0b9d16e8f1

- 用 React 状态同步编辑器当前文本

- 让按钮禁用态随用户输入即时更新

修复空初始草稿吞掉首次编辑 ... 645d806fed

- 仅在初始内容实际非空时跳过初始化回调

- 保证快速编辑首次输入同步到宿主状态

修复清空草稿后润色状态残留 ... 64a52005f8

- 在编辑器发出空草稿时重置润色结果

- 清除本轮发送提醒确认标记

避免总控草稿初始化误删 ... fa99d9ad62

- 编辑器尚未恢复时跳过空草稿持久化

- 保留已有会话草稿等待输入区完成恢复

避免快速编辑润色回填重复更新 ... fc0fd846f9

- 回填前比较编辑器当前文本

- 防止输入区 onChange 与宿主回调形成循环

补充DirectProject canonical内容严格边界计划 ... f4b496caca

- 明确 content-only 输入与最终空内容校验

- 规划删除 userItem 兜底并修正 Direct caller

统一 DirectProject 运行态条目的合并身份 ... 721e45f01b

- Thread Manager 事件新增 callId，条目身份统一为 callId 优先、其次 itemId
- 工具条目按 callId 归并 started/completed，不再留下永远收不到完成事件的幽灵活跃条目
- 历史锚点仍取 response item id，保证分页锚点能在 project.jsonl 中命中
- 补充跨 id 空间归并的单元测试

修复DirectProject canonical内容边界（review 第 8 条） ... 41366dd71d

- 移除 chatComposerDraftToDirectCodexUserItem 对纯空白 input_text 的预过滤，原样传递 draft.content
- ChatComposerDraft 只保留 canonical content，删除 text / references 旧字段
- 新增 directCodexContentToPromptText、hasMeaningfulDirectCodexContent、directCodexUserItemFromContent 供 caller 与展示派生
- 删除 executeChatAgentReply 的 userItem 兜底分支，首页首轮、队列出队、普通提交与策略重试显式构造 canonical user item
- QueuedChatTurn 只保存 clientTurnId 与 userItem，队列 chip 文案由 content 派生
- 旧 Planner / legacy Supervisor caller 显式构造纯文本 item 并留下迁移 TODO
- 资源输入区对外只暴露 canonical content，内部文本草稿改为文本 → content 重建
- 迁移草稿、润色、队列与 appSurface 测试 fixture 到 content-only
- 更新 canonical content 里程碑与实施计划文档结论

运行态事件与历史切片共用聊天条目投影 ... 29d0cbb4df

- 新增 direct_chat_entry 深模块，把原始 response item 与 app-server item 投影成同一聊天条目
- item.started/item.completed 载荷改为完整条目，前端不再需要按 itemId 取快照
- 原始 function_call 与 function_call_output 按 callId 并成一张卡片，文本与明细统一脱敏截断
- 历史切片新增 entries 与 first_item_id，分页锚点不再依赖是否出现可显示条目

新增 DirectProject 聊天 reducer 深模块 ... ae0f9376c9

- directThreadChat 把运行态事件与历史切片归并成同一份聊天条目，活动回合只由 turn.started/turn.completed 判定
- item.delta 载荷补 kind，reducer 不再靠 itemId 猜条目类型
- bootstrap 原子替换运行态并保留历史窗口，历史与运行态按 callId ?? itemId 去重合并
- 新增 5 条 reducer 单测

固化 DirectProject 聊天真相源契约 ... 2938a49cac

- 主规范新增首屏锚点、生命周期锚点必进 bootstrap、事件自足与不提供单点快照四条契约
- 新增 ADR 记录单一事实源取舍、删除清单与待验证的 id 空间风险
- 新增里程碑与实施计划，CONTEXT.md 补项目对话历史/运行态事件/聊天投影词条
- 目标文档合同与文档索引同步

移除前端 consume 轮询兜底 ... 0ec1179bf1

- 唤醒只由 notify 驱动，bootstrap 后立刻 consume 一次补齐竞态窗口
- 定时 tick 无法自举：判断活动回合本身依赖事件，唤醒丢失时定时器不会启动
- 主规范、ADR 与实施计划同步删除该条款

删除 DirectProject 图片专用 content part ... aa9076c95c

- 移除 DirectCodexUserContentPart 的 agc_image_reference 分支与对应 ts-rs 绑定
- Rust 校验与 Codex wire 投影只保留 agc_attachment_reference
- 更新附件顺序投影测试的用例名、输入与断言
- 同步聊天素材功能说明、用户 Response item 里程碑与实施计划
- 在决策日志记录上传文件统一走附件 part、不保留图片兼容分支

把 DirectProject 聊天条目的投影从前端收口，Rust 只搬运脱敏原始条目 ... 656c89e4b2

新增 agent/direct_thread_raw_item.rs：把 Codex 原始 response item 与 app-server item 收敛成同一形状的脱敏原始条目，只做挑字段、脱敏、截断，不再生成卡片的 kind / 标题 / 折叠摘要
删除 agent/direct_chat_entry.rs：工具卡片形状不再由 Rust 生产
历史切片改为返回脱敏原始条目列表，不再在 Rust 侧合并 function_call 与 function_call_output
新增前端 directThreadItemProjection.ts：工具卡片 kind / 标题 / 摘要 / 状态与可见性判定全部在前端完成
directThreadChat reducer 改用同一投影函数处理运行态事件，新增 mergeDirectHistoryItems 走同一份投影与合并规则
DirectThreadHistorySlice 去掉 entries 与 itemTimestamps，改为 items + firstItemId

修复独立总控聊天窗口未发送草稿的恢复 ... 423f2d7184

- App.tsx 增加 supervisorChatDraftHydratedRef 守卫的挂载水合：独立总控聊天窗口挂载走 loadProjectConversation，不经过 openWorkspace，此前 sessionStorage 里的草稿只写不读，重载后为空
- 仅在 supervisorChatOnly、存在持久化草稿且输入框已挂载时回填一次，避免覆盖用户后续输入

修正 Godot 直接回合用例对 canonical content 的断言 ... edfd1f9143

- appSurface Godot 用例不再断言被裁剪过的纯文本，改为断言编辑器实际提交的 canonical content（Shift+Enter 与组合态 Enter 插入的换行原样保留）

按 grill 结论修正 DirectProject 聊天真相源收敛计划 ... 42b702d362

里程碑与实施计划改定边界：Thread Manager 只搬运脱敏原始条目，不生成卡片形状与可见性
条目身份归一为 call_id ?? id，Thread Manager 与前端不再暴露第二个 id 概念，分页锚点仍取文件里的原始 item id
合并规则收敛为"先到定形、后到补空白"，删除逐字段优先级表
主规范补充条目形状三条职责边界，并说明思考正文流式下发不放宽可见范围
ADR 同步：DirectRuntime 自己的进度事件与投影文件保留，前端删除的是 DirectProject 的读路径
失败与中止说明只在运行期显示；历史切片改为从文件尾反向扫描；未知 item 类型透传并加 TODO

修正 DirectProject 订阅语义：bootstrap 事件就是当前要处理的事件 ... 09ad0073fe

subscribe 已在同一边界把游标钉在队尾，因此前端直接 reduce bootstrap 事件，不再补一次 consume
主规范、ADR 与实施计划同步删除"竞态窗口"说法，notify 仍是唯一唤醒来源

DirectProject 聊天事件改用 ts-rs 导出的 tagged enum 并删掉 turn id ... 2748468d12

- 新增 direct_thread_wire.rs：DirectThreadItem / DirectThreadEvent / 订阅与历史切片全部改成 ts-rs 导出的 tagged enum，取代原大而全的可空结构体
- 删除 direct_thread_raw_item.rs，模块注册与直通引用改到 direct_thread_wire
- 条目身份只看一个 itemId：工具条目的第二个 id 在 Rust 边界归一，不再对外暴露
- 删除 DirectProject 聊天事件里的 turn id：生命周期用无载荷的 turn.started / turn.completed{status} 表示
- append 直接接收 DirectThreadEvent 并返回同一事件，队列内部自算 seq
- 请求事件改为携带 DirectThreadRequestKind，去掉字符串中转
- 思考增量走 ReasoningDelta 通道，与正文增量共用 item.delta
- at 用 #[ts(as = "f64")] 对齐 Tauri JSON 通道的 number
- 用 cargo test export_bindings 重新生成 project-workspace/generated 绑定

前端聊天投影按 ts-rs 生成类型收口，删掉 callId 与回合身份 ... fdc48fe725

- directThreadItemProjection.ts 直接消费生成的 DirectThreadItem，工具卡片 kind / 标题 / 摘要 / 状态与可见性判定都在这里
- directThreadChat.ts 聊天条目只留一个 itemId：去掉 callId 概念，去掉 deltaText 缓冲，增量直接追加到运行态条目正文
- 合并规则收成先到者赢、后到只补空：正文只增不减、工具状态允许从 running 升级到终态
- 回合结束把运行态条目并入历史并清空 live，条目既不消失也不重复
- directThreadEvents.ts 改为转发 ts-rs 绑定，只保留历史条目转消息的过渡函数
- ToolCallGroup 与 toolCallGroupPresentation 改用去掉回合身份的 DirectChatToolCard
- generated/index.ts 补上 DirectThread* 绑定导出
- 回退本仓库其它模块仍在改的 DirectCodexUser* 绑定重新生成（避免误改他人进行中的契约）
- 两个 vitest 用例文件按新 API 重写，11 条用例通过

文档先行：把 DirectProject 聊天真相源收敛的文档改到当前实现状态 ... ed3369a494

- 主规范把事件模型写成 ts-rs 导出的 tagged enum，说明 seq 不下发、事件不带回合身份，并补上 ts 绑定生成与 f64 时间戳约定
- ADR 补上 tagged enum 绑定、turn id 删除、正文只增不减与回合回收、前端卡片去掉 turnId、未知类型前端丢弃
- 里程碑与实施计划同步：文件改名到 direct_thread_wire.rs，新增删回合身份与生成绑定两步，验证命令加上 export_bindings
- 工具卡片技术方案在文首加修订段：数据来源层作废，表现层契约仍然有效，DirectRuntime 的 tool-calls.jsonl 写入保留
- 对话回合唯一投影里程碑改为 superseded，列出仍然有效与已作废的分界

DirectProject 历史切片改为从文件尾回扫并删掉聊天框只读命令 ... 3c6e084a41

- 新增 DirectProjectHistoryReverseLines：按块从文件尾逐行回读 project.jsonl
- 幂等回扫与"读一屏"共用这一套尾部回读，不再各自从文件头读到尾
- read_direct_project_history_items_slice_at 语义不变仍返回元组，新增第四项为本屏最老的 itemId 作分页锚点
- 分页锚点只按归一身份 itemId 匹配，不再接受第二个 id
- read_direct_project_last_item_id_at 改为尾部回扫读一行，不再读整份历史
- 删除只服务聊天框回读的 read_direct_tool_calls / read_direct_turn_stream 命令与注册
- 保留 list_game_creator_direct_active_turns：它服务首页跨页面"运行中的项目"，不是聊天框读路径
- 补历史切片尾部回扫与分页锚点两条用例

修复 DirectProject 输入草稿丢掉引用后的换行（review 第 1 条） ... 280a2dc5d1

- ResourceReferenceInput 的草稿投影改为「向前合并」：上一 part 是引用 chip 时先把待写文本攒在 pendingText 上，等下一个文本 part 到来再合并，段落分隔符与软换行不再被 trim() 丢掉
- 攒到最后仍只有空白的文本不入 content，避免产出 Rust validate_direct_codex_user_item 会拒绝的空 input_text
- 新增 resourceReferenceInput 用例「引用后面的段落分隔不会被吞掉」，钉住 chip 后一段的 content part、派生文本与「不产生纯空白 part」
- 同步更新 canonical content 严格边界里程碑的实现结论与证据，并在 shared-memory/pitfalls 记录该缺陷的现象、原因、处理与验证

修复排队消息 chip 的 @ 引用露出内部 resourceId（review 第 2 条） ... 869abad879

- queuedChatTurnLabel 增加 assets 入参并透传给 directCodexContentToPromptText，@ 引用按 manifest 显示名展开，与聊天输入区文案口径一致
- ComposerTurnQueue 增加 assets 属性，ProjectSupervisorView 把 chatProjectAssets 传下去
- chat-composer 用例新增「队列 chip 的 @ 引用按 manifest 显示名展开」，钉住显示名文案与不传清单时的稳定 id 兜底

修复快速编辑提示词把 @ 引用写成内部 id（review 第 3、4 条） ... e469831543

- applyResourceQuickEditPrompt 与 applyResourceQuickEditDraft 改用 directCodexContentToPromptText(content, manifest.assets)，并在 useCallback 依赖里加上 manifest.assets
- 两处必须同口径：比较用的草稿文本与落进 quickEditPanel.prompt 的文本都按显示名展开，出站 derive_local_project_resource 的 prompt 与聊天 @ 逐字一致，也不会每次输入都重跑 replaceText
- 补充两处注释说明素材清单口径，shared-memory/pitfalls 记录「派生文本漏传 manifest.assets」的现象、原因、处理与验证

DirectProject 回合事件补齐用户条目与终态兜底 ... bf8f96c115

- 新增 direct_thread_id_for_project：订阅、回合事件写入与兜底释放共用一个线程身份
- 订阅命令改用同一个身份函数，删掉命令层自己那套路径归一
- 用户消息落盘后立刻作为 item.completed 下发，前端用同一个 itemId 合并乐观气泡与历史条目
- 采集终态事件是否已经下发，缺失时按成功 / 失败补一条 turn.completed，避免前端永远停在运行中
- 取消回合的 Stale 分支补一条 turn.completed(aborted)

DirectProject 聊天框改用线程订阅作为唯一运行态来源 ... 33ddb5de27

- App.tsx 删除 Direct 回合事件订阅、turn-stream/tool-calls 读取、活动回合快照接管与瞬时应答文本
- 新增 game-creator-direct-thread-notify 唤醒的 subscribe/consume 单飞循环，过期时重订一次
- 通知先于订阅回执到达时记一笔欠账，回执到达后补一次 consume，避免回合尾部事件卡在队列里
- 历史切片并入同一个 reducer，聊天条目只由 selectDirectChatEntries 投影
- ProjectSupervisorView 改为渲染用户气泡 / 执行过程折叠区 / 最终回复，运行态只保留一个 turnRunning
- directTurnPresentation 重写为条目分区：连续工具合块、本地运行期说明只作最终提示
- 测试改按订阅事件与历史条目断言，补回执竞态、持久化工具卡片、空对话首轮三条用例

补齐 DirectProject 聊天真相源收敛的文档结论 ... 5eba53a5cc

- 主规范：运行态事件改为下发与历史切片同形的脱敏原始条目，不再只给类型与身份
- 主规范与 ADR 写清回执竞态：回执前到达的通知只能记欠账，回执到达后必须补一次 consume
- ADR 与实施计划说明 list_game_creator_direct_active_turns 有意保留，服务首页运行中项目列表
- 里程碑验收标准按自动化证据勾选，运行时验收与已知环境缺口单独标注
- 实施计划补 export_bindings 后需 prettier 生成目录、测试文件更名与竞态风险项

补记 Node 26 下 vitest jsdom 用例的 localStorage 坑 ... d874a13a92

- pitfalls 记录：Node 26 的实验性 globalThis.localStorage 会顶掉 jsdom 的 Storage，导致只声明 jsdom 的用例读到 undefined
- 给出跑法：NODE_OPTIONS=--localstorage-file=… 后 clientApi 与 chatPromptPolish 共 26 项转绿
- 里程碑证据更新为全量结果：125 files / 1676 passed / 17 skipped，tsc exit 0

清理 DirectProject 回合结束后丢弃回复正文的死语句 ... ff8e517c8e

- App.tsx 不再绑定 chat_with_game_creator_direct_codex 的返回值，删掉 void reply
- 保留说明：回复正文按条目身份从线程事件 / 历史切片进聊天，本地不再补第二条

测试骨架不再重复下发 turn.started ... 1b3a3b003f

- harness.ts 记录运行态"最新回合是否在跑"，emitDirectThreadEvents 只在生命周期事件上更新
- completeDirectThreadTurn 仅在回合没在跑时补 turn.started，避免与用例先发的事件重叠

测试骨架的 subscribe bootstrap 按生产口径过滤 ... 6a4cb2bc18

- harness.ts 记录未完成条目集合、事件序号与最新生命周期锚点
- subscribe 只回放未完成条目与最新生命周期锚点，已完成条目与增量正文不再补发
- 去掉已下发事件的序号记录，避免序号表无限增长

测试骨架的历史切片按 limit 与锚点分页 ... 64bd006981

- harness.ts 的 read_direct_project_history_slice 按生产口径从队尾取一屏、锚点条目不进窗口
- 按本屏最老一条算 firstItemId，收满一屏后再有条目才算 hasMore
- project-development.suite.ts 补一条用例：26 条历史只显示尾部 20 条，点「显示更早的对话」按锚点取回前 6 条后按钮消失

首屏历史切片改到 staleness 守卫之后再并入聊天 reducer ... e17af3008e

- loadProjectConversation 不再在 read_direct_project_history_slice 的 then 回调里直接写 directThreadChat
- 切片先暂存，等 loadVersion / localProjectPathRef 守卫通过后再与 hasMore、锚点一起落到状态
- 现有 launcher 按项目路径 key 重挂载 App，跨项目污染暂不可复现；本次只是让这条写入与其它状态写入的时序一致

分页切片开头的前导条目并进后面那个回合 ... 098693636a

- buildDirectChatTurns 先攒住第一个用户条目之前的过程条目，交给后面那个回合
- 不再渲染没有用户气泡的孤儿回合；整份历史都没有用户条目时仍保留一个回合
- directTurnPresentation 单测补一条分页切片从半截回合开头的情形

删掉聊天 reducer 里没人读的订阅身份与首屏锚点 ... 1b40f030e7

- DirectThreadChatState 去掉 subscriptionId 与 lastCompletedItemId 两个只写不读的字段
- resolveDirectThreadBootstrap 只把 bootstrap 事件 reduce 进状态，不再顺带写入这两个字段
- directThreadChat 单测改成断言聊天状态里不再出现这两个字段（bootstrap 载荷本身不变）

终止按钮改按综合繁忙信号判定 ... 975a2e577c

- handleCancelDirectCodexTurn 的守卫改用 supervisorChatBusy，与「终止」按钮的可见条件对齐
- 刚提交、turn.started 还没到达的窗口里点击终止不再回"当前没有正在运行的回合"
- chat-composer 用例补一条：生命周期事件缺席时也能发出 cancel_direct_codex_turn

回扫的 terminated 改成按真实换行结尾判定 ... ad19c9475e

- DirectProjectHistoryReverseLines 增记 saw_delimiter，第一段按"文件是否以换行结尾"判定，之后的行按已切掉的分隔符判定
- 尾部残行（上一行完整、这一行没有换行）解析失败时改为跳过继续回扫，不再报错、也不再就地结束丢掉更早的完整历史
- 换行结尾的坏行（含文件第一段）与顺序读取保持一致地失败关闭
- 补两条回扫用例：尾部残行不丢更早条目、坏掉的第一段必须失败关闭（都按旧实现变异验证过）

分页锚点改用文件里的原始 item id ... da2ad83c3b

- 新增 direct_project_history_anchor_id：优先取 project.jsonl 原始 id，缺 id 时退回归一身份兜底
- read_direct_project_history_items_slice_at 的锚点匹配与 first_item_id 都改用原始 id
- 工具条目的调用与输出共用 call_id，按归一身份当锚点会先跳过 output 再把上一屏的 function_call 带回来
- 原分页用例更名 history_window_paginates_upwards_by_item_id_anchor
- 新增 pagination_anchor_uses_raw_item_id_for_tool_call_pairs，旧实现下会返回 call-1 而非 fc-1（已做变异验证）

思考正文改走生产路径的 ReasoningDelta 通道 ... e640219243

- 新增 direct_codex_reasoning_delta_event，两条 reasoning 增量通知只在这一处分类
- 生产 stdout 读取器改用该函数，并跳过「preparing 活动」的降级与活动节流（活动节流会按类别吃掉逐段正文）
- 旧分类函数 direct_codex_notification_event 同步改用它，避免两份实现再次分叉
- 单测 direct_reasoning_deltas_stream_text_while_plan_and_command_output_stay_activity 取代原先断言 Activity 的旧用例
- 新增 E2E codex_app_server_streams_reasoning_deltas_without_activity_fallback：把读取器的路由关掉即转红（已做变异验证）

线程 id 只按路径归一，不再受 manifest 可读性影响 ... d348cf9064

- direct_thread_id_for_project 改用 resolve_direct_codex_project_authority（存在/是目录/canonicalize）
- 不再读 .agent/manifest.json：那次读取是连接池权威身份的要求，线程 id 只是路径 key
- 否则 manifest 在订阅时读失败、跑回合时读成功，会让符号链接等非 canonical 调用方路径算出两个线程 id，订阅绑到空线程
- 新增 direct_project_thread_id_ignores_manifest_readability，旧实现下会退回调用方原始字符串（已做变异验证）

通知分类收敛成生产读取器与单测共用的唯一实现 ... 9993b2feb5

- direct_codex_notification_event 收编 resolution / request / item / rawItem / Terminal 全部分支，并接收 turnId
- 读取器删掉自己那份内联分类，只保留「必须有 turnId 才处理」与活动/正文节流
- agentMessage 缺 itemId 的告警与 direct-missing-item:{turnId} 兜底身份原样保留，避免行为变化
- 新增 direct_notification_classification_covers_the_reader_branches 钉住各分支；E2E 假 app-server 用例继续覆盖读取器

放宽 DirectProject content 校验为「整条判定」并按逐字投影（review 第 1 条，① 口径） ... b543a060b7

- Rust validate_direct_codex_user_item 改为只判整条 content：有一段非空白文本或任意非文本 part 即有效，单个纯空白 input_text（段落分隔 / 软换行 / chip 后的分隔空格）合法，不再逐个 part 拒绝空文本
- 新增 content_has_meaningful_input，并与前端 hasMeaningfulDirectCodexContent 同口径；wire.rs 的「不能转换为空 prompt」只作兜底
- ResourceReferenceInput 的投影层原样透传编辑器节点：不做空白过滤、也不与相邻 part 合并，删掉 appendInputText 与中间版本的「向前合并」收集器
- 按逐字投影更新资源输入、Godot 回合用例的 canonical content 断言
- 同步里程碑实现结论与证据、pitfalls 条目；Rust validation/wire 新增「单个纯空白 part 通过、整条全空白拒绝」用例

收敛 content→可读文本为单一口径并强制传 manifest（review 第 2、3 条） ... 6eed6bd13f

- directCodexContentToPromptText 的 assets 改为必填，去掉 = [] 默认值：漏传素材清单从运行期文案退化变回编译期错误
- queuedChatTurnLabel 的 assets 与 ComposerTurnQueue 的 assets 属性同样必填，队列 chip 与消息正文共用同一个派生（chip 只多做压单行与限长）
- 断言改为显式传 [] 或 manifest：resourceReferences、chat-composer 用例按新签名收敛
- 更新 pitfalls 条目与 decision-log（canonical content 有效性只判整条 content、投影逐字透传、可读文本单一口径必填 assets）

重新生成 ts-rs 前端绑定并让前端按 null 语义构造运行时区段 ... 0caf998227

- 跑 export_bindings 后 prettier 格式化：DirectCodexUser* 5 个文件内容更新，新增 DirectCodexUserMessageEnvelope.ts 与 ui-editor 的 BindingChange/BindingDTO
- DirectCodexUserRuntimeRegionPart 的可选字段由 `?:` 变成 `T | null`（Rust Option 会显式序列化成 null，不是省略键）
- chatReferenceToContentPart 改用 `?? null`，消息条目的 satisfies 目标改为 DirectCodexUserItem（type:'message' 归到信封类型）
- ResourceReferenceInput 不再复制一份区段字面量，改为复用 chatReferenceToContentPart
- 验证：tsc --noEmit 通过；resourceReferences 等 5 个用例集 81 passed；appSurface 452 passed / 17 skipped（连跑两次）

Revert "修复历史重读后旧消息追加到末尾的乱序" ... dd339638cc

This reverts commit 036395c6c9.

Revert "修复DirectProject对话历史分页卡页" ... b37d91882c

This reverts commit 1b010fb1f8.

DirectProject 不再把 Codex 回显的用户消息下发给聊天 ... 63c495dab0

- 运行态条目投影新增回显过滤 direct_thread_visible_item，item/started 与 rawResponseItem/completed 两条路径共用
- is_direct_project_codex_user_item 提升为 pub(crate)，落盘侧与运行态侧共用同一判据
- 新增 E2E direct_project_turn_does_not_forward_codex_user_echo_as_chat_items：修复前事件流会多出两条同文本用户条目（已做变异验证）
- 同步 ADR 与 shared-memory decision-log：回显过滤必须同时覆盖落盘与运行态两侧

文档先行：定死 DirectProject 历史分页连拉的可见性口径 ... 459f8a60e5

把「可显示」判据明确为合并后聊天投影出现新回合，并写清每操作 5 页上限与锚点不前进即停
里程碑把原第 56 条按后端锚点回扫与前端连拉拆成两条独立验收项，前端那条先留待补证据
实施计划第 6 步同步口径，并把新分页单测加入验证命令
决策记录新增 2026-09-17 条目，记下落点、上限粒度、失败与竞态边界

新增 DirectProject 历史分页连拉模块与单测 ... 1ae6c6cd06

directHistoryPaging 按「合并后聊天投影回合数增加」判断可见反馈，出现新回合或 hasMore=false 即停
连拉上限 DIRECT_HISTORY_MAX_PAGES_PER_ACTION 放进 app/constants，每个操作最多 5 次请求
锚点未推进（items 为空 / firstItemId 为 null 或原地打转）时立即停手并收口 hasMore
某页读取失败不丢已取到的页，返回 error 交给调用方报错
directThreadChat 抽出 projectDirectHistoryItems，让分页判据与视图共用同一份投影

App 聊天历史分页改走连拉循环 ... 37ae7508b8

首屏与「显示更早」共用 readDirectHistoryPages，不再各自单发一页
首屏基线取空并在守卫后一次性并入聊天 reducer，失败仍按原有语义抛出
「显示更早」按当前视图条目判断新回合，取到多页一次性并入并推进锚点
连拉中途失败保留已取到的页，报错统一走同一个出口

补跨页同回合的历史分页回归用例 ... e382d23892

用 51 条历史复现用户报的现象：20 条工具条目整屏落进同一个折叠的执行过程
断言一次点击连拉两页拿到新用户气泡，并按 process-31 / process-11 两次锚点推进
断言连拉插入旧内容后视口仍停在原处，不被拉回列表底部

补 DirectProject 历史分页连拉的实现证据 ... 0a9cdf6395

里程碑前端连拉那条转成已验收，证据指向新单测与跨页同回合集成用例
证据要求补上本轮实跑结果与变异验证现象，避免再出现打勾但只覆盖一半
决策记录把验证口径写成具体条数与变异验证结论

Merge branch 'master' into fix/chat-status-lost ... cb840c6e8c

# Conflicts:
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md

Merge remote-tracking branch 'origin/master' into fix/chat-status-lost ... b7622f4a24

# Conflicts:
#	docs/project-memory/shared-memory/pitfalls.md

合并 DirectProject 聊天真相源与 canonical content 行为 ... b1e82d64cb

- 统一历史切片与 Thread Manager 事件投影，保留 DirectProject 单一聊天事实源

- 保留 canonical content 严格校验、资源显示名派生、附件引用与队列语义

- 修复首页首轮缺失 canonical user item 的真实回归并完成定向验证

解决 DirectProject 合并冲突 ... ecea7b4ad3

合并双方 DirectProject 历史分页、锚点闸门与订阅竞态处理。

保留 canonical content 输入、聊天 reducer、附件发送和历史分页行为。

合并 Codex 用户回显过滤、增量脱敏及 Direct 回合完成状态处理。

补齐历史截断、损坏行 fail-closed、首屏 anchor 与 appSurface 定向测试。

同步合并应用壳层、后端绑定和项目文档变更。

清理资源引用标签的重复分支 ... 06004bfeea

移除相同结果的死三元分支。

保持资源与运行区域引用均使用统一的 @标签 文本。

修复附件场景下历史命令识别 ... b73a329b2c

使用不含附件的文本输入判断 /history 命令。

避免待发送附件把 canonical prompt 拼成长文本后绕过历史记录加载。

移除队列标签不可达兜底分支 ... 4ae5ab14fa

队列标签统一复用 canonical content 的文本派生。

删除不会被现有引用类型触发的附件和素材兜底文案。

延后资源草稿直到素材索引可用 ... 6e63a118e0

避免初始编辑器挂载时 assetsById 为空导致资源引用永久丢失。

保留 Lexical 节点自行解析资产名称的后续 TODO。

移除 DirectProject 入口的重复回合审计 ... faed0ec251

DirectProject 继续以 project.jsonl 作为完整回合记录。

入口不再创建 DirectCodexTurnAudit，保留底层可选审计接口供独立测试和其它路径使用。

保留聊天草稿中的附件引用节点 ... d8af0fa882

为 agc_attachment_reference 增加 Lexical 附件节点与可移除 chip。

恢复初始 canonical content 时不再静默丢弃附件，并让编辑器读回完整附件 part。

移除草稿转换的文本引用回退 ... 840baf208f

将 ChatComposerDraft.content 设为必填的 canonical 唯一来源。

删除 text 与 references 重建 DirectCodexUserItem 的兼容分支及其无效空值兜底。

Merge remote-tracking branch 'refs/remotes/origin/master' into fix/ref-persistent 2e78cbf152

清洗附件摘要元数据 ... 70fa160819

wire 投影复用附件名称与媒体类型的安全清洗。

附件项目路径输出归一化结果，避免原始控制字符进入模型提示。

限制 DirectProject inline 附件数量 ... 50204ff7aa

为 canonical 附件增加独立的八个条目上限。

补充超限附件拒绝测试，避免绕过素材引用数量门禁。

校验已导入附件的项目路径 ... bc1dc868a1

imported 附件必须携带有效非空的项目相对路径。

failed 附件仍允许无路径，并补充状态路径组合测试。

限制附件元数据格式与长度 ... 75ec3361dc

校验 inline 附件名称和媒体类型的控制字符、格式与长度。

共享附件清洗上限常量并补充异常元数据拒绝测试。

补充DirectProject Skill提及输入规范 ... 64ad24ac77

更新聊天输入主规范并增加 Skill 提及边界

新增 Skill 提及里程碑与小切片实施计划

增加输入框Skill提及候选 ... aaecb82622

扩展聊天引用模型支持 Skill 节点与 canonical content

复用 Lexical typeahead 增加 $Skill 候选和芯片展示


 Conflicts:

	apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx


 Conflicts:

	apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx


 Conflicts:

	apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx

	apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts

校验Skill提及用户输入 ... 774710452f

为 canonical Skill part 增加名称边界校验

将 Skill 提及保留为 Codex 可识别的 $name 文本

接入客户端已启用Skill候选 ... 1e27cd229d

从扩展索引读取启用状态并合并内置 Skill 清单

输入提示只展示可用 Skill 并保持取消安全

接通Skill提及Codex输入 ... 1bfdc3a760

将 canonical Skill part 按原顺序转换为 type skill 输入项

沿用客户端隔离 Skill root 解析受控路径

更新Skill提及里程碑状态 ... c3a17a6efc

标记输入提示实现进入进行中阶段

整理引用芯片标题分支 ... c1482012c6

提取资源、Skill 与运行区域标题计算 helper

移除 ResourceReferenceChip 的嵌套三元表达式

复用引用节点插入逻辑 ... 382b925ab9

统一资源与 Skill 候选的 Lexical 节点插入流程

避免两个选择处理器在删除查询和关闭菜单行为上漂移

移除未使用的 JSON 类型导入 ... 3a57d9fbdf

删除 codex_app_server 中未被直接引用的 serde_json::Value 导入

展开引用列表指纹分支 ... 5f5aa17152

将资源、Skill 与运行区域 key 生成改为显式分支

移除 chatReferenceListKey 的嵌套三元表达式

按字符数限制 Skill 名称 ... 273f12633c

使用 Unicode 字符数量而非 UTF-8 字节长度执行 120 字符上限

让多字节 Skill 名称与资源 ID 的长度校验口径一致

拒绝保留路径段的 Skill 名称 ... f7cba30b6b

在 DirectProject Skill 校验中拒绝 . 与 ..

阻止 Skill 路径解析通过父目录段逃逸配置根目录

复用已校验的项目清单 ... 34b3af1d2a

DirectProject wire 转换只读取一次项目 manifest

避免每个素材引用重复 I/O 与解析并缩小校验到解析之间的竞态窗口

复用 DirectProject 引用摘要构造 ... c047543825

提取素材与运行区域摘要 helper

让历史投影和 turn 输入转换共用同一份摘要逻辑

通过 Tauri command 提供 Skill 候选 ... 71000b6df1

从已校验的 AGC Skill manifest 派生 list_agc_skill_catalog 命令

移除前端内置 Skill 名称硬编码并增加读取命令测试

修复 DirectProject 校验清单合并 ... ade1b7803e

让校验函数返回已读取的项目清单

补齐附件在 Codex 输入转换中的分支；图片 part 已退役，只保留附件 part

k88936 referenced this pull request 2026-09-18 17:09:18 +08:00

fix/引用持久化 #365

k88936 changed title from WIP: Refactor/split direct project to WIP: 重构/拆分directproject聊天组件 2026-09-18 17:12:01 +08:00

lhk229 commented 2026-09-18 18:43:25 +08:00

Owner

Copy Link

Copy Source

#355

#355

k88936 added 2 commits 2026-09-18 22:32:20 +08:00

拆分 DirectProject 聊天架构文档 ... 65f8e44a88

记录 DirectProject 独立聊天容器与工作台钱包布局决策

更新实施里程碑、计划和项目上下文，明确 DirectProject 固定属于项目开发工作台

记录代码与生成契约迁移的验收边界

抽离项目开发 DirectProject 聊天模块 ... 38ad2ce256

将 DirectProject 表现与 controller 移到 view/project-development/chat

删除运行时 Direct feature flag 与 ProjectSupervisorView 的 Direct 行为分支

迁移 ts-rs 生成契约并删除无意义 generated/index.ts

将钱包入口提升到工作台布局并保留现有 Direct 测试覆盖

k88936 commented 2026-09-19 12:51:53 +08:00

Author

Member

Copy Link

Copy Source

so how

so how

Some checks are pending

Hide all checks

Project CI / AI game creator shell Rust shard 1/4 (pull_request) Failing after 5m42s

Details

Project CI / AI game creator shell Rust shard 3/4 (pull_request) Successful in 5m31s

Details

Project CI / AI game creator shell Rust shard 2/4 (pull_request) Successful in 6m9s

Details

Project CI / Backend tests (pull_request) Failing after 30s

Details

Project CI / AI game creator shell Rust crates (pull_request) Successful in 2m16s

Details

Project CI / AI game creator shell Rust smoke (pull_request) Successful in 2m54s

Details

Project CI / Repository checks (pull_request) Failing after 10s

Details

Project CI / AI game creator shell Rust shard 4/4 (pull_request) Successful in 5m32s

Details

Project CI / Frontend tests (pull_request) Failing after 16m6s

Details

Project CI / Native shell tests (pull_request) Successful in 24m45s

Details

Project CI / AI game creator shell web tests (pull_request) Failing after 24m28s

Details

This pull request has changes conflicting with the target branch.

• apps/ai-game-creator-shell/src-tauri/src/agent/direct_codex_user_item/wire.rs
• apps/ai-game-creator-shell/src/App.tsx
• apps/ai-game-creator-shell/src/features/project-workspace/ProjectSupervisorView.tsx

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin refactor/split-direct-project:refactor/split-direct-project

git checkout refactor/split-direct-project

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

Compat/Breaking

Breaking change that won't be backward compatible

Kind/Bug

Something is not working

Kind/Documentation

Documentation changes

Kind/Enhancement

Improve existing functionality

Kind/Feature

New functionality

Kind/Security

This is security issue

Kind/Testing

Issue or pull request related to testing

Priority

Critical

1

The priority is critical

Priority

High

2

The priority is high

Priority

Low

4

The priority is low

Priority

Medium

3

The priority is medium

Reviewed

Confirmed

1

Issue has been confirmed

Reviewed

Duplicate

2

This issue or pull request already exists

Reviewed

Invalid

3

Invalid issue

Reviewed

Won't Fix

3

This issue won't be fixed

Status

Abandoned

3

Somebody has started to work on this but abandoned work

Status

Blocked

1

Something is blocking this issue or pull request

Status

Need More Info

2

Feedback is required to reproduce issue or to continue work

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

HuangJiaJia JenkenB k88936 (王德宇) kdletters (段舒康) laura2008 (王乐) lhk229 (孔令弘) Loer (农洛儿) loong suzmii (董羽秦) taobaisu (叶东旭) wuxiangwanzi (王子民) YixuanLiu ziyu

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#420