尧图网站建设 
桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载导读本文基于specs/QUALITY-768/TECH.md的实现级技术规范剖析 WarpWarp is an agentic development environment, born out of the terminal在重启后恢复编排orchestration会话状态时暴露出的四类缺陷以及对应提交中的五项代码级决策。阅读完本文你将掌握编排子会话在启动路径上如何被急切水合eager hydration、远程子会话转录如何合并到本地占位符、磁盘持久化如何以整棵树为原子单位进行清理tree-aware prune以及共享会话查看器在快照/恢复循环中如何保住云端形态。背景重启后编排会话的四种损坏形态Warp 的编排功能允许一个 Agent父会话派生出多个子 Agent 会话形成一棵编排树。这些会话会以agent_conversations与agent_tasks两张表持久化到本地 SQLite。重启 Warp 后系统需要把这棵树从磁盘读回内存并重新挂到 UI 上而 QUALITY-768 之前这个恢复过程存在四个独立的损坏形态本地-本地编排重启后子 Agent 的 pill bar会话状态胶囊栏丢失send_message_to_agent/messages_received行把子 Agent 渲染成Unknown agent。本地-远程编排占位子 Agent 窗格被恢复成空的New agent conversationshell而不是服务端仍在流式输出的云端 transcript。本地无 harness 的 Oz 子会话约一半部分 trace 中会在读取阶段被静默丢弃。云端父会话本地为共享会话查看器窗格第一次重启能存活第二次快照会丢失云端模式形态——第二次重启后父窗格退化为普通本地终端云会话的 env-setup 块被重放且没有任何编排 UI。规范明确指出了一个底层共性磁盘上的逐行 FIFO 清理策略会把编排树拆散导致即使读路径本身健康下一次启动也会重新遭遇半棵树状态。因此修复必须同时覆盖读路径与写路径。数据模型与相关代码定位四类缺陷横跨持久化层与 UI 层先厘清关键代码位置持久化表结构crates/persistence/src/schema.rs定义agent_conversationsconversation_id、conversation_data、last_modified_at、summary与agent_tasksconversation_id、task_id、task、last_modified_at两张表其中agent_conversations的行通过parent_conversation_id存于 conversation_data JSON表达父子关系。磁盘侧写入与清理app/src/persistence/agent.rs中的upsert_agent_conversation与select_conversations_to_evict。启动时恢复路径app/src/ai/blocklist/history_model/conversation_loader.rs的initialize_historical_conversations与统一转换入口convert_persisted_conversation_to_ai_conversation_with_metadata。一次性启动存储app/src/ai/restored_conversations.rs的RestoredAgentConversationstake-once 语义。可恢复性判定crates/persistence/src/model.rs的AgentConversation::is_restorable。读取侧容量上限app/src/ai/blocklist/history_model.rs的MAX_HISTORICAL_CONVERSATIONS。窗格侧app/src/pane_group/mod.rs的child_agent_panes索引、PendingRemoteChildHydration/RemoteChildHydrationAction/decide_remote_child_hydration_action以及app/src/pane_group/child_agent/hydration.rs的水合实现。下文按原规范的顺序展开五项变更并用仓库源码逐条印证。变更 1在initialize_historical_conversations中急切水合编排子会话问题启动时initialize_historical_conversationsapp/src/ai/blocklist/history_model/conversation_loader.rs:489只把编排子会话索引进children_by_parent和agent_id_to_conversation_id真正插入conversations_by_id被推迟到父会话的隐藏子窗格物化materialize之后。因此 pill barapp/src/ai/blocklist/agent_view/orchestration_pill_bar.rs的OrchestrationPillBar::pill_specs和名称解析app/src/ai/blocklist/block/view_impl/orchestration.rs的participant_for_agent_id在窗格物化前找不到子会话从而渲染出Unknown agent。修复loader 通过resolved_parent_conversation_id_from_persisted_data识别编排子会话并急切地把完整反序列化的AIConversation插入conversations_by_id源码conversation_loader.rs:558-573附近复用现成的convert_persisted_conversation_to_ai_conversation_with_metadata转换入口。关键约束有三点不发出RestoredConversations事件不注册live_conversation_ids_for_terminal_view条目不构造任何 AI block。这样后续由懒物化lazy pane materialisation触发的restore_conversations会幂等地覆盖这个急切条目不会产生重复。从测试可验证其精确行为app/src/ai/blocklist/history_model_tests.rs的test_initialize_historical_conversations_eagerly_hydrates_orchestration_children断言——子会话在conversations_by_id中父会话不被急切加载子 run-id 能通过conversation_id_for_agent_id解析子会话元数据不进入导航all_conversations_metadata。取舍规划阶段曾考虑从急切路径发出RestoredConversations事件让下游订阅者对称处理但被否决——那会迫使每个订阅者处理没有终端视图的情况而真正需要子会话的表面pill bar、名称解析本就直读conversations_by_id。急切插入也仅限编排子会话非编排的历史会话仍走懒路径。变更 2直接检查AmbientAgentTask完成远程子会话转录水合问题远程子会话local-remote 编排在本地只有占位符真实转录仍在云端。重启后占位符窗格被恢复成空的New agent conversationshell。修复原方案想走AgentConversationsModel::resolve_open_action但一旦变更 1 让占位符进入conversations_by_id解析器会返回RestoreOrNavigateToConversation——把导航到本地会话与把云转录水合到本地占位符折叠成单一结果会迫使所有导航点处理新变体。因此改为让隐藏窗格水合直接检查AmbientAgentTask并把分发逻辑抽成纯函数app/src/pane_group/mod.rsenum RemoteChildHydrationAction { LiveAttach, LoadTranscript { server_token: ServerConversationToken, task_is_terminal: bool }, Fallback { task_is_terminal: bool }, } fn decide_remote_child_hydration_action(task: AmbientAgentTask) - RemoteChildHydrationAction { ... }函数在处理 token 前用task.conversation_id().map(str::trim).filter(|t| !t.is_empty())过滤空/空白 tokentask_is_terminal matches!(live_session_state, Inactive)只计算一次让LoadTranscript与Fallback共享同一个终态判定。hydrate_task_backed_hidden_child_pane的流程是先创建隐藏窗格并在child_agent_panesHashMapAIConversationId, PaneId中以占位符本地 id 注册任务数据已缓存则同步调用attempt_remote_child_hydration否则在pending_remote_child_hydrations: HashMapAmbientAgentTaskId, PendingRemoteChildHydration注册待AgentConversationsModelEvent::TasksUpdated事件重试。内部幂等守卫保证占位符已存在 live 跟踪窗格时直接返回避免第二次restore_missing_child_agent_panes_for_parent调用在转录合并前插入重复隐藏窗格并孤立第一个。LoadTranscript分支路由到hydrate_remote_child_transcript_in_place经BlocklistAIHistoryModel::load_conversation_by_server_token拉取云端转录再经hydrate_remote_child_placeholder_with_cloud_transcriptapp/src/ai/blocklist/history_model.rs:2949合并到占位符。合并保留占位符的本地AIConversationId、父链接parent_conversation_id、agent_name、run_id 与is_remote_child标志若占位符已被移出conversations_by_id则返回anyhow::Error调用方据此回退到 live-attach tombstone 分支。tombstone 语义统一attach_ambient_session_and_maybe_tombstone先调用apply_existing_ambient_task_to_pane然后仅在task_is_terminal true时插入会话结束 tombstone。四个分支LoadTranscript合并成功、合并出错、非 Oz 载荷/拉取失败回退、Fallback都汇聚到这个 helper从而ActiveUnattachable任务在转录拉取失败、返回非 Oz 载荷或根本没有 server token 时不再获得误导性的会话已结束tombstone。并发安全ctx.spawn内的异步续体守卫要求child_agent_panes[child_id] pane_id且窗格终端视图的active_conversation_id Some(child_id)才允许改动 UI 状态防止竞态导航或竞争性水合覆盖过期目标。取舍曾考虑扩宽resolve_open_action暴露HydrateRemoteChildPlaceholder变体被否决也曾考虑把分发逻辑内联在attempt_remote_child_hydration中改为抽成自由函数是为了让决策Attachable、ActiveUnattachabletoken、Inactivetoken、Inactive无token、ActiveUnattachable无token以及空 token 过滤情形无需搭建PaneGroup即可单元测试。对应测试位于app/src/pane_group/mod_tests.rs六种用例覆盖上述全部决策分支包括空 token 回退decide_remote_child_hydration_empty_token_falls_back。变更 3乐观存根处理已由上游 PR #11814 取代问题本地无 harness 的 Oz 子会话在 spawn 时会持久化两个根形任务——一个 spawn 时创建的 38 字节零载荷乐观存根optimistic stub以及一个携带真实消息的升级根。AgentConversation::is_restorable看到两个根形任务就拒绝整行会话在进入initialize_historical_conversations时被静默丢弃——这正是约一半子会话被丢弃的根因。修复本 PR 早期版本实现了读时存根过滤器task_is_root_shaped、optimistic_stub_task_id、tasks_for_restore、into_tasks_for_restore及七个单元测试但 rebase 到上游后被PR #11814QUALITY-774Fix optimistic-root persistence breaking conversation restore取代并删除。上游在两层协同修复Task::source_for_persistence对Optimistic(Root)返回None不再写入新的存根行AIConversation::new_restored对多根载荷去重优先选择无父且messages非空的任务真实服务端根AgentConversation::is_restorable放宽为接受[stub real]多根形态让遗留 DB 行仍能走恢复路径本地 DB 转换入口调用new_restored_synthesizing_on_empty当持久化任务列表为空时合成全新乐观根。源码印证crates/persistence/src/model.rs:989的tasks_are_restorable明确列出可恢复规则——单任务或更少、恰有一个无父root任务、或有多个无父任务但仅一个有非空messages容忍 QUALITY-774 之前的乐观根写坏形态。app/src/ai/agent/conversation.rs:521的严格new_restored对空任务列表返回NoRootTask而new_restored_synthesizing_on_emptyconversation.rs:541对空任务列表绕过derive_status_from_root_task避免把无交换的根误判为 Success直接构造Optimistic(Root)任务并置ConversationStatus::InProgress。多根去重在 conversation.rs:585-616 通过收集parentless_candidates后position(|(task, _)| !task.messages.is_empty())确定性挑选真实根回归测试test_new_restored_prefers_parentless_task_with_messages_over_empty_stubapp/src/ai/agent/conversation_tests.rs用 50 次迭代的 HashMap 顺序回归验证其确定性。变更 4树感知的持久化会话清理问题upsert_agent_conversationapp/src/persistence/agent.rs:60-118原来的逐行 FIFO LRU 清理会拆散编排树——父行被清掉而子行留存或反之下一次启动读到的就是残缺的半棵树。修复select_conversations_to_evictapp/src/persistence/agent.rs:152完全重写为树感知把每个持久化行按parent_conversation_id上溯到根聚合成树JSON 解析失败的行自成一棵根声明父但父不在行集内的孤儿引用同样自成一棵根find_root还带环防御成环条目自成一棵根。树按max(member.last_modified_at)新鲜度降序排序并列时按root_id升序打破确定性。贪心保留循环无条件保留最新鲜的树完整保留——即使它单独就超过MAX_PERSISTED_CONVERSATION_COUNT随后每棵树原子性保留直到累计保留数达到上限一旦某棵树超出预算所有更老的树也一并清除hard-stop 语义。容量上限从 100 提升到 200MAX_PERSISTED_CONVERSATION_COUNTapp/src/persistence/agent.rs:45读取侧镜像上限MAX_HISTORICAL_CONVERSATIONSapp/src/ai/blocklist/history_model.rs:65同步升到 200并以内联注释说明读取上限当前形同虚设因为磁盘侧清理已把持久化集合压在窗口内。实现上用iter.next()无条件保留最新鲜树、再for遍历余下部分避免在循环体内维护first: bool标志。取舍新鲜树例外严格上限会连新鲜树也清可能把活跃编排会话在磁盘上劈成两半回归到促使本次改动的半棵树故障模式故拒绝无界新鲜树场景作为已知限制记录见下文风险。常量漂移两个文件两个const usize是软漂移隐患但crates/persistence在工作区依赖图中位于warp上游不能反向 import注释已说明读取上限仅在≥磁盘上限时成立。解析失败处理conversation_dataJSON 解析失败的行自成一棵根而非被静默挂进其他树磁盘行保持原样。测试app/src/persistence/agent_tests.rs八例用例断言要点prune_is_no_op_when_under_limit行数未超限时不清理keeps_fresh_tree_atomically_and_evicts_older_singletons新鲜树整棵保留旧单例行被清child_kept_drags_parent_along新鲜子行拖着陈旧的父行一起保留parent_kept_drags_child_along新鲜父行拖着陈旧的子行一起保留orphan_with_missing_parent_is_its_own_tree声明父缺失的孤儿自成一棵根single_tree_larger_than_limit_is_kept_in_full单棵树超过上限仍完整保留parse_failure_row_is_treated_as_root_and_can_be_referenced_by_others解析失败行自成一棵根且可被其他行引用eviction_is_deterministic相同输入两次产生相同输出并列按 root_id 升序变更 5云端模式共享会话查看器的快照/恢复闭环变更 1–4 修复的是编排子会话还有一个独立潜在缺陷影响编排树中本身就是云 Agent 的父会话——其本地窗格是附着到云会话的共享会话查看器而恢复 → 快照 → 恢复循环在第二圈丢失云端形态。根因restore_pane_leaf的LeafContents::AmbientAgent → AmbientRestoreKind::SharedSession分支调用create_shared_session_viewer(session_id, …)其内部shared_session::viewer::TerminalManager::new非延迟构造器在委托new_internal时硬编码is_cloud_mode false导致生成的TerminalView没有ambient_agent_view_modelapp/src/terminal/view.rs的TerminalView::new仅在is_cloud_mode true时构造该模型。第一次重启后 pill bar 与 transcript 仍能渲染是因为JoinedSuccessfully查看器网络处理器无论is_cloud_mode都会拉起OrchestrationViewerModel但app/src/pane_group/pane/terminal_pane.rs的TerminalPane::snapshot依据view.ambient_agent_view_model()决定输出LeafContents::AmbientAgent { task_id }还是空LeafContents::Terminal——模型为None时每次关闭都落成空 Terminal 形态task_id丢失第二次重启后窗格退化为普通本地终端共享原 UUID、重放云会话的 env-setup 块无编排 UI。修复显式把is_cloud_mode: bool参数贯穿create_shared_session_viewer→viewer::TerminalManager::new→new_internal。两个 ambient-agent 恢复调用点restore_pane_leaf的SharedSession分支、process_pending_ambient_restorations的OpenOrAttachAmbientAgentConversation分支现在传is_cloud_mode: true恢复出的视图自带ambient_agent_view_model既有JoinedSuccessfully处理器的enter_viewing_existing_session(task_id)路径生效下次快照正确输出LeafContents::AmbientAgent并携带task_id。另外两个调用点保持falseensure_shared_session_viewer_child_pane每子窗格查看器隐藏子窗格按设计不进入快照树与new_for_shared_session_viewer导航到共享会话入口——存在同样的潜在问题但超出本 PR 范围见 Follow-ups。源码印证app/src/pane_group/mod.rs:6213的create_shared_session_viewer已带is_ambient_agent: bool参数并根据ambient_agent_view_model().is_some()决定是立即wire_ambient_agent_session_events还是在SessionJoined时经begin_viewing_ambient_session懒创建。取舍曾考虑仅快照回退方案——ambient_agent_view_model缺失时从 liveOrchestrationViewerModel读task_id被否决因为这会保留运行时形态不一致新建的云模式窗格有模型恢复的没有任何未来依赖ambient_agent_view_model的特性在重启后才悄悄出错。让恢复走云模式构造器恢复窗格的形态与新建窗格完全一致。测试app/src/pane_group/mod_tests.rs的create_shared_session_viewer_with_cloud_mode_populates_ambient_agent_view_model断言恢复视图ambient_agent_view_model().is_some()保证下次关停快照路径可达LeafContents::AmbientAgent分支与create_shared_session_viewer_without_cloud_mode_does_not_populate_ambient_agent_view_model钉住非云模式行为未来翻转默认值会响亮失败。端到端启动流程一次启动贯穿上述四项变更上游 PR #11814 的存根处理在它们上游因果链如下变更 5 正交只涉及父窗格快照形态上游 PR #11814 位于所有其他变更上游它决定哪些行能通过恢复、从而哪些行进入RestoredAgentConversations与initialize_historical_conversations。急切子会话水合让子会话足够早地进入conversations_by_id供 pill bar / 名称解析读取也正是它制造了解析器冲突场景才引出隐藏窗格水合路径上的直接AmbientAgentTask检查。树感知清理反馈到下一次启动若清理拆散树无论内存侧接线多好读路径不变量都会被破坏。测试与验证单元测试按模块分布树感知清理app/src/persistence/agent_tests.rs八例见变更 4 表格。存根/多根恢复上游 PR #11814 的is_restorable_*crates/persistence/src/model.rs五例覆盖单根、多根含一个真实根、多根含多个真实根、多根无真实根、空/单任务与test_new_restored_prefers_parentless_task_with_messages_over_empty_stubapp/src/ai/agent/conversation_tests.rs的去重循环。急切子会话水合app/src/ai/blocklist/history_model_tests.rs的test_initialize_historical_conversations_eagerly_hydrates_orchestration_children断言子会话在conversations_by_id、父会话不被急切加载、子 run-id 经conversation_id_for_agent_id解析、子元数据排除在导航外以及test_initialize_historical_conversations_resolves_parent_agent_id_children_via_seeded_run_ids覆盖父解析旁路。远程子会话水合分发app/src/pane_group/mod_tests.rs的decide_remote_child_hydration_action六例LiveAttach / LoadTranscript终态 / LoadTranscript活跃不可附着 / Fallback终态 / Fallback活跃不可附着且不标记结束 / 空 token 回退。LoadTranscript→合并集成app/src/ai/blocklist/history_model_tests.rs的hydrate_remote_child_placeholder_with_cloud_transcript_preserves_placeholder_identity——构造带parent_conversation_idagent_namerun_idis_remote_child的占位远程子会话用带非空标题与一条用户查询交换的云转录驱动合并断言合并结果保留占位符本地 id 与编排链接并浮现云转录内容第二段断言对未知占位符调用合并返回Err。云端模式查看器快照契约app/src/pane_group/mod_tests.rs两个配套用例见变更 5。手动验证矩阵每个变更在重启上端到端覆盖本地-本地重启pill bar 正确渲染 agent 名称无Unknown agent回退多根存根形态被上游恢复去重静默修复会话列表 UI 完整。树感知清理编排树在磁盘上跨上限保持完整。本地-远程重启云转录合并到本地占位符New agent conversation占位符缺陷消失活跃运行继续附着。云端父会话连续两次重启远程编排父会话跨两次 Warp 重启正确恢复不回退为带 env-setup 重放的游离本地终端。基线单会话恢复无回归。验证命令来自规范原文cargo fmt -p warp -p persistence cargo clippy -p warp --all-targets --features local_fs -- -D warnings cargo clippy -p persistence --tests --all-features -- -D warnings cargo nextest run # 覆盖 pane_group::、persistence::agent::tests、ai::blocklist::history_model::tests、persistence::model::tests延后覆盖断言select_conversations_to_evict永不产生拆散编排树的清理清单的属性测试当前由用例测试推断。用 mock 云拉取驱动hydrate_remote_child_transcript_in_place的端到端 PaneGroup 重启测试现有测试直接覆盖了更小的接缝。风险与缓解无界新鲜树select_conversations_to_evict始终完整保留最新鲜的树单个超大编排会话可把磁盘行数推到 200 以上。缓解下一次会话的清理会清掉所有更老的树稳态行数仍保持在上限内除非每个会话都衍生上百个子会话若真成问题可用树内优先清理最老成员策略替代新鲜树例外但会重新引入半树故障模式故刻意延后。MAX_PERSISTED_CONVERSATION_COUNT与MAX_HISTORICAL_CONVERSATIONS软漂移两常量分属不同文件、不同 crate当前恰好一致读取侧上限的注释记录了不变量读取上限仅在磁盘上限 ≤ 它时形同虚设。缓解注释、测试覆盖的对称性、以及将来单一常量重构见 Follow-ups。急切水合排序窗口不对称initialize_historical_conversations按last_modified_at新鲜度优先遍历、以MAX_HISTORICAL_CONVERSATIONS截断原则上新鲜子会话可能落入窗口而其陈旧父不在。缓解树感知磁盘清理让父保持足够新鲜该情形尚未观测到父解析路径在父不在conversations_by_id时回退到children_by_parent。共享AgentConversationsModel订阅承载两张 pending 表ensure_pending_ambient_restoration_subscriptionapp/src/pane_group/mod.rs同时驱动pending_ambient_agent_conversation_restorations与pending_remote_child_hydrations。缓解两张表保持独立可见树的replace_pane流程不会误换隐藏子窗格成本小且受恢复的 ambient 窗格数量约束。后续工作一旦读取上限有可能被独立调高例如未来的历史视图想展示超过磁盘上限的会话数应把保留常量在crates/persistence与warp之间共享为单一事实来源当前读取上限形同虚设独立常量可接受。增加属性测试断言select_conversations_to_evict永不返回跨越 kept/evicted 边界拆散编排树的清理清单现有用例测试覆盖了实质性形态属性测试在生成输入下补强。针对未来 schema 升级新增的AmbientAgentLiveSessionState变体收紧decide_remote_child_hydration_action——当前显式匹配Attachable与Inactive新变体会依据是否持有 server token 落入LoadTranscript/Fallback决策cfg门控的穷尽性断言可在编译期捕获新变体。new_for_shared_session_viewer存在与变更 5 修复路径相同的潜在快照/恢复循环。它是用户在会话列表打开共享会话时使用的独立入口不属于编排恢复流程故延后修复形态一致——确认非恢复打开也期望云模式行为后从该调用点传is_cloud_mode: true。小结QUALITY-768 的修复本质上回答了一个问题编排树在重启后必须作为一棵树整体复原。读路径上急切水合让子会话尽早进入conversations_by_id直接检查AmbientAgentTask让远程子会话按任务状态分派LiveAttach / LoadTranscript / Fallback并统一 tombstone 语义写路径上树感知清理让磁盘永远不拆散树父会话侧is_cloud_mode参数的贯穿修复了共享会话查看器第二次重启丢失云端形态的闭环缺陷。上游 PR #11814 则在更上游的层消除了乐观存根对恢复的破坏。四类损坏形态——丢 pill bar、占位符 shell、静默丢会话、云端父退化本地终端——分别由上述决策对应闭合且每个决策都附有独立的单元测试与可复现的手动验证矩阵。赞分享桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载相关推荐KeystoneJS Relationship字段实战如何在MongoDB中优雅解决多对多关系难题KeystoneJS Relationship字段实战如何在MongoDB中优雅解决多对多关系难题 在构建博客、电商等 Node.js 项目时 Keysto桌面应用开发者工具人工智能AI 应用AI Agent代码智能体libsignal协议状态机会话状态的持久化与恢复libsignal协议状态机会话状态的持久化与恢复 概述 在Signal的端到端加密通信中会话状态管理是确保消息安全传输的核心机制。libsignal协议通Devon会话管理持久化存储与状态恢复机制Devon会话管理持久化存储与状态恢复机制 引言为什么需要智能会话管理 在AI编程助手的使用过程中开发者经常面临这样的痛点 长时间编码会话突然中断导致上一篇在 OpenDesign 中落地 NVIDIA 风格设计系统Design Token、组件规范与 Agent 提示词实战指南下一篇ESPnet2 中文普通话 ASR 实战基于 zh_openslr38 语料库的 Conformer 与 HuBERT SSLR 基线复现指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Warp 编排会话状态恢复：四项核心修复与树感知持久化清理
桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载导读本文基于specs/QUALITY-768/TECH.md的实现级技术规范剖析 WarpWarp is an agentic development environment, born out of the terminal在重启后恢复编排orchestration会话状态时暴露出的四类缺陷以及对应提交中的五项代码级决策。阅读完本文你将掌握编排子会话在启动路径上如何被急切水合eager hydration、远程子会话转录如何合并到本地占位符、磁盘持久化如何以整棵树为原子单位进行清理tree-aware prune以及共享会话查看器在快照/恢复循环中如何保住云端形态。背景重启后编排会话的四种损坏形态Warp 的编排功能允许一个 Agent父会话派生出多个子 Agent 会话形成一棵编排树。这些会话会以agent_conversations与agent_tasks两张表持久化到本地 SQLite。重启 Warp 后系统需要把这棵树从磁盘读回内存并重新挂到 UI 上而 QUALITY-768 之前这个恢复过程存在四个独立的损坏形态本地-本地编排重启后子 Agent 的 pill bar会话状态胶囊栏丢失send_message_to_agent/messages_received行把子 Agent 渲染成Unknown agent。本地-远程编排占位子 Agent 窗格被恢复成空的New agent conversationshell而不是服务端仍在流式输出的云端 transcript。本地无 harness 的 Oz 子会话约一半部分 trace 中会在读取阶段被静默丢弃。云端父会话本地为共享会话查看器窗格第一次重启能存活第二次快照会丢失云端模式形态——第二次重启后父窗格退化为普通本地终端云会话的 env-setup 块被重放且没有任何编排 UI。规范明确指出了一个底层共性磁盘上的逐行 FIFO 清理策略会把编排树拆散导致即使读路径本身健康下一次启动也会重新遭遇半棵树状态。因此修复必须同时覆盖读路径与写路径。数据模型与相关代码定位四类缺陷横跨持久化层与 UI 层先厘清关键代码位置持久化表结构crates/persistence/src/schema.rs定义agent_conversationsconversation_id、conversation_data、last_modified_at、summary与agent_tasksconversation_id、task_id、task、last_modified_at两张表其中agent_conversations的行通过parent_conversation_id存于 conversation_data JSON表达父子关系。磁盘侧写入与清理app/src/persistence/agent.rs中的upsert_agent_conversation与select_conversations_to_evict。启动时恢复路径app/src/ai/blocklist/history_model/conversation_loader.rs的initialize_historical_conversations与统一转换入口convert_persisted_conversation_to_ai_conversation_with_metadata。一次性启动存储app/src/ai/restored_conversations.rs的RestoredAgentConversationstake-once 语义。可恢复性判定crates/persistence/src/model.rs的AgentConversation::is_restorable。读取侧容量上限app/src/ai/blocklist/history_model.rs的MAX_HISTORICAL_CONVERSATIONS。窗格侧app/src/pane_group/mod.rs的child_agent_panes索引、PendingRemoteChildHydration/RemoteChildHydrationAction/decide_remote_child_hydration_action以及app/src/pane_group/child_agent/hydration.rs的水合实现。下文按原规范的顺序展开五项变更并用仓库源码逐条印证。变更 1在initialize_historical_conversations中急切水合编排子会话问题启动时initialize_historical_conversationsapp/src/ai/blocklist/history_model/conversation_loader.rs:489只把编排子会话索引进children_by_parent和agent_id_to_conversation_id真正插入conversations_by_id被推迟到父会话的隐藏子窗格物化materialize之后。因此 pill barapp/src/ai/blocklist/agent_view/orchestration_pill_bar.rs的OrchestrationPillBar::pill_specs和名称解析app/src/ai/blocklist/block/view_impl/orchestration.rs的participant_for_agent_id在窗格物化前找不到子会话从而渲染出Unknown agent。修复loader 通过resolved_parent_conversation_id_from_persisted_data识别编排子会话并急切地把完整反序列化的AIConversation插入conversations_by_id源码conversation_loader.rs:558-573附近复用现成的convert_persisted_conversation_to_ai_conversation_with_metadata转换入口。关键约束有三点不发出RestoredConversations事件不注册live_conversation_ids_for_terminal_view条目不构造任何 AI block。这样后续由懒物化lazy pane materialisation触发的restore_conversations会幂等地覆盖这个急切条目不会产生重复。从测试可验证其精确行为app/src/ai/blocklist/history_model_tests.rs的test_initialize_historical_conversations_eagerly_hydrates_orchestration_children断言——子会话在conversations_by_id中父会话不被急切加载子 run-id 能通过conversation_id_for_agent_id解析子会话元数据不进入导航all_conversations_metadata。取舍规划阶段曾考虑从急切路径发出RestoredConversations事件让下游订阅者对称处理但被否决——那会迫使每个订阅者处理没有终端视图的情况而真正需要子会话的表面pill bar、名称解析本就直读conversations_by_id。急切插入也仅限编排子会话非编排的历史会话仍走懒路径。变更 2直接检查AmbientAgentTask完成远程子会话转录水合问题远程子会话local-remote 编排在本地只有占位符真实转录仍在云端。重启后占位符窗格被恢复成空的New agent conversationshell。修复原方案想走AgentConversationsModel::resolve_open_action但一旦变更 1 让占位符进入conversations_by_id解析器会返回RestoreOrNavigateToConversation——把导航到本地会话与把云转录水合到本地占位符折叠成单一结果会迫使所有导航点处理新变体。因此改为让隐藏窗格水合直接检查AmbientAgentTask并把分发逻辑抽成纯函数app/src/pane_group/mod.rsenum RemoteChildHydrationAction { LiveAttach, LoadTranscript { server_token: ServerConversationToken, task_is_terminal: bool }, Fallback { task_is_terminal: bool }, } fn decide_remote_child_hydration_action(task: AmbientAgentTask) - RemoteChildHydrationAction { ... }函数在处理 token 前用task.conversation_id().map(str::trim).filter(|t| !t.is_empty())过滤空/空白 tokentask_is_terminal matches!(live_session_state, Inactive)只计算一次让LoadTranscript与Fallback共享同一个终态判定。hydrate_task_backed_hidden_child_pane的流程是先创建隐藏窗格并在child_agent_panesHashMapAIConversationId, PaneId中以占位符本地 id 注册任务数据已缓存则同步调用attempt_remote_child_hydration否则在pending_remote_child_hydrations: HashMapAmbientAgentTaskId, PendingRemoteChildHydration注册待AgentConversationsModelEvent::TasksUpdated事件重试。内部幂等守卫保证占位符已存在 live 跟踪窗格时直接返回避免第二次restore_missing_child_agent_panes_for_parent调用在转录合并前插入重复隐藏窗格并孤立第一个。LoadTranscript分支路由到hydrate_remote_child_transcript_in_place经BlocklistAIHistoryModel::load_conversation_by_server_token拉取云端转录再经hydrate_remote_child_placeholder_with_cloud_transcriptapp/src/ai/blocklist/history_model.rs:2949合并到占位符。合并保留占位符的本地AIConversationId、父链接parent_conversation_id、agent_name、run_id 与is_remote_child标志若占位符已被移出conversations_by_id则返回anyhow::Error调用方据此回退到 live-attach tombstone 分支。tombstone 语义统一attach_ambient_session_and_maybe_tombstone先调用apply_existing_ambient_task_to_pane然后仅在task_is_terminal true时插入会话结束 tombstone。四个分支LoadTranscript合并成功、合并出错、非 Oz 载荷/拉取失败回退、Fallback都汇聚到这个 helper从而ActiveUnattachable任务在转录拉取失败、返回非 Oz 载荷或根本没有 server token 时不再获得误导性的会话已结束tombstone。并发安全ctx.spawn内的异步续体守卫要求child_agent_panes[child_id] pane_id且窗格终端视图的active_conversation_id Some(child_id)才允许改动 UI 状态防止竞态导航或竞争性水合覆盖过期目标。取舍曾考虑扩宽resolve_open_action暴露HydrateRemoteChildPlaceholder变体被否决也曾考虑把分发逻辑内联在attempt_remote_child_hydration中改为抽成自由函数是为了让决策Attachable、ActiveUnattachabletoken、Inactivetoken、Inactive无token、ActiveUnattachable无token以及空 token 过滤情形无需搭建PaneGroup即可单元测试。对应测试位于app/src/pane_group/mod_tests.rs六种用例覆盖上述全部决策分支包括空 token 回退decide_remote_child_hydration_empty_token_falls_back。变更 3乐观存根处理已由上游 PR #11814 取代问题本地无 harness 的 Oz 子会话在 spawn 时会持久化两个根形任务——一个 spawn 时创建的 38 字节零载荷乐观存根optimistic stub以及一个携带真实消息的升级根。AgentConversation::is_restorable看到两个根形任务就拒绝整行会话在进入initialize_historical_conversations时被静默丢弃——这正是约一半子会话被丢弃的根因。修复本 PR 早期版本实现了读时存根过滤器task_is_root_shaped、optimistic_stub_task_id、tasks_for_restore、into_tasks_for_restore及七个单元测试但 rebase 到上游后被PR #11814QUALITY-774Fix optimistic-root persistence breaking conversation restore取代并删除。上游在两层协同修复Task::source_for_persistence对Optimistic(Root)返回None不再写入新的存根行AIConversation::new_restored对多根载荷去重优先选择无父且messages非空的任务真实服务端根AgentConversation::is_restorable放宽为接受[stub real]多根形态让遗留 DB 行仍能走恢复路径本地 DB 转换入口调用new_restored_synthesizing_on_empty当持久化任务列表为空时合成全新乐观根。源码印证crates/persistence/src/model.rs:989的tasks_are_restorable明确列出可恢复规则——单任务或更少、恰有一个无父root任务、或有多个无父任务但仅一个有非空messages容忍 QUALITY-774 之前的乐观根写坏形态。app/src/ai/agent/conversation.rs:521的严格new_restored对空任务列表返回NoRootTask而new_restored_synthesizing_on_emptyconversation.rs:541对空任务列表绕过derive_status_from_root_task避免把无交换的根误判为 Success直接构造Optimistic(Root)任务并置ConversationStatus::InProgress。多根去重在 conversation.rs:585-616 通过收集parentless_candidates后position(|(task, _)| !task.messages.is_empty())确定性挑选真实根回归测试test_new_restored_prefers_parentless_task_with_messages_over_empty_stubapp/src/ai/agent/conversation_tests.rs用 50 次迭代的 HashMap 顺序回归验证其确定性。变更 4树感知的持久化会话清理问题upsert_agent_conversationapp/src/persistence/agent.rs:60-118原来的逐行 FIFO LRU 清理会拆散编排树——父行被清掉而子行留存或反之下一次启动读到的就是残缺的半棵树。修复select_conversations_to_evictapp/src/persistence/agent.rs:152完全重写为树感知把每个持久化行按parent_conversation_id上溯到根聚合成树JSON 解析失败的行自成一棵根声明父但父不在行集内的孤儿引用同样自成一棵根find_root还带环防御成环条目自成一棵根。树按max(member.last_modified_at)新鲜度降序排序并列时按root_id升序打破确定性。贪心保留循环无条件保留最新鲜的树完整保留——即使它单独就超过MAX_PERSISTED_CONVERSATION_COUNT随后每棵树原子性保留直到累计保留数达到上限一旦某棵树超出预算所有更老的树也一并清除hard-stop 语义。容量上限从 100 提升到 200MAX_PERSISTED_CONVERSATION_COUNTapp/src/persistence/agent.rs:45读取侧镜像上限MAX_HISTORICAL_CONVERSATIONSapp/src/ai/blocklist/history_model.rs:65同步升到 200并以内联注释说明读取上限当前形同虚设因为磁盘侧清理已把持久化集合压在窗口内。实现上用iter.next()无条件保留最新鲜树、再for遍历余下部分避免在循环体内维护first: bool标志。取舍新鲜树例外严格上限会连新鲜树也清可能把活跃编排会话在磁盘上劈成两半回归到促使本次改动的半棵树故障模式故拒绝无界新鲜树场景作为已知限制记录见下文风险。常量漂移两个文件两个const usize是软漂移隐患但crates/persistence在工作区依赖图中位于warp上游不能反向 import注释已说明读取上限仅在≥磁盘上限时成立。解析失败处理conversation_dataJSON 解析失败的行自成一棵根而非被静默挂进其他树磁盘行保持原样。测试app/src/persistence/agent_tests.rs八例用例断言要点prune_is_no_op_when_under_limit行数未超限时不清理keeps_fresh_tree_atomically_and_evicts_older_singletons新鲜树整棵保留旧单例行被清child_kept_drags_parent_along新鲜子行拖着陈旧的父行一起保留parent_kept_drags_child_along新鲜父行拖着陈旧的子行一起保留orphan_with_missing_parent_is_its_own_tree声明父缺失的孤儿自成一棵根single_tree_larger_than_limit_is_kept_in_full单棵树超过上限仍完整保留parse_failure_row_is_treated_as_root_and_can_be_referenced_by_others解析失败行自成一棵根且可被其他行引用eviction_is_deterministic相同输入两次产生相同输出并列按 root_id 升序变更 5云端模式共享会话查看器的快照/恢复闭环变更 1–4 修复的是编排子会话还有一个独立潜在缺陷影响编排树中本身就是云 Agent 的父会话——其本地窗格是附着到云会话的共享会话查看器而恢复 → 快照 → 恢复循环在第二圈丢失云端形态。根因restore_pane_leaf的LeafContents::AmbientAgent → AmbientRestoreKind::SharedSession分支调用create_shared_session_viewer(session_id, …)其内部shared_session::viewer::TerminalManager::new非延迟构造器在委托new_internal时硬编码is_cloud_mode false导致生成的TerminalView没有ambient_agent_view_modelapp/src/terminal/view.rs的TerminalView::new仅在is_cloud_mode true时构造该模型。第一次重启后 pill bar 与 transcript 仍能渲染是因为JoinedSuccessfully查看器网络处理器无论is_cloud_mode都会拉起OrchestrationViewerModel但app/src/pane_group/pane/terminal_pane.rs的TerminalPane::snapshot依据view.ambient_agent_view_model()决定输出LeafContents::AmbientAgent { task_id }还是空LeafContents::Terminal——模型为None时每次关闭都落成空 Terminal 形态task_id丢失第二次重启后窗格退化为普通本地终端共享原 UUID、重放云会话的 env-setup 块无编排 UI。修复显式把is_cloud_mode: bool参数贯穿create_shared_session_viewer→viewer::TerminalManager::new→new_internal。两个 ambient-agent 恢复调用点restore_pane_leaf的SharedSession分支、process_pending_ambient_restorations的OpenOrAttachAmbientAgentConversation分支现在传is_cloud_mode: true恢复出的视图自带ambient_agent_view_model既有JoinedSuccessfully处理器的enter_viewing_existing_session(task_id)路径生效下次快照正确输出LeafContents::AmbientAgent并携带task_id。另外两个调用点保持falseensure_shared_session_viewer_child_pane每子窗格查看器隐藏子窗格按设计不进入快照树与new_for_shared_session_viewer导航到共享会话入口——存在同样的潜在问题但超出本 PR 范围见 Follow-ups。源码印证app/src/pane_group/mod.rs:6213的create_shared_session_viewer已带is_ambient_agent: bool参数并根据ambient_agent_view_model().is_some()决定是立即wire_ambient_agent_session_events还是在SessionJoined时经begin_viewing_ambient_session懒创建。取舍曾考虑仅快照回退方案——ambient_agent_view_model缺失时从 liveOrchestrationViewerModel读task_id被否决因为这会保留运行时形态不一致新建的云模式窗格有模型恢复的没有任何未来依赖ambient_agent_view_model的特性在重启后才悄悄出错。让恢复走云模式构造器恢复窗格的形态与新建窗格完全一致。测试app/src/pane_group/mod_tests.rs的create_shared_session_viewer_with_cloud_mode_populates_ambient_agent_view_model断言恢复视图ambient_agent_view_model().is_some()保证下次关停快照路径可达LeafContents::AmbientAgent分支与create_shared_session_viewer_without_cloud_mode_does_not_populate_ambient_agent_view_model钉住非云模式行为未来翻转默认值会响亮失败。端到端启动流程一次启动贯穿上述四项变更上游 PR #11814 的存根处理在它们上游因果链如下变更 5 正交只涉及父窗格快照形态上游 PR #11814 位于所有其他变更上游它决定哪些行能通过恢复、从而哪些行进入RestoredAgentConversations与initialize_historical_conversations。急切子会话水合让子会话足够早地进入conversations_by_id供 pill bar / 名称解析读取也正是它制造了解析器冲突场景才引出隐藏窗格水合路径上的直接AmbientAgentTask检查。树感知清理反馈到下一次启动若清理拆散树无论内存侧接线多好读路径不变量都会被破坏。测试与验证单元测试按模块分布树感知清理app/src/persistence/agent_tests.rs八例见变更 4 表格。存根/多根恢复上游 PR #11814 的is_restorable_*crates/persistence/src/model.rs五例覆盖单根、多根含一个真实根、多根含多个真实根、多根无真实根、空/单任务与test_new_restored_prefers_parentless_task_with_messages_over_empty_stubapp/src/ai/agent/conversation_tests.rs的去重循环。急切子会话水合app/src/ai/blocklist/history_model_tests.rs的test_initialize_historical_conversations_eagerly_hydrates_orchestration_children断言子会话在conversations_by_id、父会话不被急切加载、子 run-id 经conversation_id_for_agent_id解析、子元数据排除在导航外以及test_initialize_historical_conversations_resolves_parent_agent_id_children_via_seeded_run_ids覆盖父解析旁路。远程子会话水合分发app/src/pane_group/mod_tests.rs的decide_remote_child_hydration_action六例LiveAttach / LoadTranscript终态 / LoadTranscript活跃不可附着 / Fallback终态 / Fallback活跃不可附着且不标记结束 / 空 token 回退。LoadTranscript→合并集成app/src/ai/blocklist/history_model_tests.rs的hydrate_remote_child_placeholder_with_cloud_transcript_preserves_placeholder_identity——构造带parent_conversation_idagent_namerun_idis_remote_child的占位远程子会话用带非空标题与一条用户查询交换的云转录驱动合并断言合并结果保留占位符本地 id 与编排链接并浮现云转录内容第二段断言对未知占位符调用合并返回Err。云端模式查看器快照契约app/src/pane_group/mod_tests.rs两个配套用例见变更 5。手动验证矩阵每个变更在重启上端到端覆盖本地-本地重启pill bar 正确渲染 agent 名称无Unknown agent回退多根存根形态被上游恢复去重静默修复会话列表 UI 完整。树感知清理编排树在磁盘上跨上限保持完整。本地-远程重启云转录合并到本地占位符New agent conversation占位符缺陷消失活跃运行继续附着。云端父会话连续两次重启远程编排父会话跨两次 Warp 重启正确恢复不回退为带 env-setup 重放的游离本地终端。基线单会话恢复无回归。验证命令来自规范原文cargo fmt -p warp -p persistence cargo clippy -p warp --all-targets --features local_fs -- -D warnings cargo clippy -p persistence --tests --all-features -- -D warnings cargo nextest run # 覆盖 pane_group::、persistence::agent::tests、ai::blocklist::history_model::tests、persistence::model::tests延后覆盖断言select_conversations_to_evict永不产生拆散编排树的清理清单的属性测试当前由用例测试推断。用 mock 云拉取驱动hydrate_remote_child_transcript_in_place的端到端 PaneGroup 重启测试现有测试直接覆盖了更小的接缝。风险与缓解无界新鲜树select_conversations_to_evict始终完整保留最新鲜的树单个超大编排会话可把磁盘行数推到 200 以上。缓解下一次会话的清理会清掉所有更老的树稳态行数仍保持在上限内除非每个会话都衍生上百个子会话若真成问题可用树内优先清理最老成员策略替代新鲜树例外但会重新引入半树故障模式故刻意延后。MAX_PERSISTED_CONVERSATION_COUNT与MAX_HISTORICAL_CONVERSATIONS软漂移两常量分属不同文件、不同 crate当前恰好一致读取侧上限的注释记录了不变量读取上限仅在磁盘上限 ≤ 它时形同虚设。缓解注释、测试覆盖的对称性、以及将来单一常量重构见 Follow-ups。急切水合排序窗口不对称initialize_historical_conversations按last_modified_at新鲜度优先遍历、以MAX_HISTORICAL_CONVERSATIONS截断原则上新鲜子会话可能落入窗口而其陈旧父不在。缓解树感知磁盘清理让父保持足够新鲜该情形尚未观测到父解析路径在父不在conversations_by_id时回退到children_by_parent。共享AgentConversationsModel订阅承载两张 pending 表ensure_pending_ambient_restoration_subscriptionapp/src/pane_group/mod.rs同时驱动pending_ambient_agent_conversation_restorations与pending_remote_child_hydrations。缓解两张表保持独立可见树的replace_pane流程不会误换隐藏子窗格成本小且受恢复的 ambient 窗格数量约束。后续工作一旦读取上限有可能被独立调高例如未来的历史视图想展示超过磁盘上限的会话数应把保留常量在crates/persistence与warp之间共享为单一事实来源当前读取上限形同虚设独立常量可接受。增加属性测试断言select_conversations_to_evict永不返回跨越 kept/evicted 边界拆散编排树的清理清单现有用例测试覆盖了实质性形态属性测试在生成输入下补强。针对未来 schema 升级新增的AmbientAgentLiveSessionState变体收紧decide_remote_child_hydration_action——当前显式匹配Attachable与Inactive新变体会依据是否持有 server token 落入LoadTranscript/Fallback决策cfg门控的穷尽性断言可在编译期捕获新变体。new_for_shared_session_viewer存在与变更 5 修复路径相同的潜在快照/恢复循环。它是用户在会话列表打开共享会话时使用的独立入口不属于编排恢复流程故延后修复形态一致——确认非恢复打开也期望云模式行为后从该调用点传is_cloud_mode: true。小结QUALITY-768 的修复本质上回答了一个问题编排树在重启后必须作为一棵树整体复原。读路径上急切水合让子会话尽早进入conversations_by_id直接检查AmbientAgentTask让远程子会话按任务状态分派LiveAttach / LoadTranscript / Fallback并统一 tombstone 语义写路径上树感知清理让磁盘永远不拆散树父会话侧is_cloud_mode参数的贯穿修复了共享会话查看器第二次重启丢失云端形态的闭环缺陷。上游 PR #11814 则在更上游的层消除了乐观存根对恢复的破坏。四类损坏形态——丢 pill bar、占位符 shell、静默丢会话、云端父退化本地终端——分别由上述决策对应闭合且每个决策都附有独立的单元测试与可复现的手动验证矩阵。赞分享桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载相关推荐KeystoneJS Relationship字段实战如何在MongoDB中优雅解决多对多关系难题KeystoneJS Relationship字段实战如何在MongoDB中优雅解决多对多关系难题 在构建博客、电商等 Node.js 项目时 Keysto桌面应用开发者工具人工智能AI 应用AI Agent代码智能体libsignal协议状态机会话状态的持久化与恢复libsignal协议状态机会话状态的持久化与恢复 概述 在Signal的端到端加密通信中会话状态管理是确保消息安全传输的核心机制。libsignal协议通Devon会话管理持久化存储与状态恢复机制Devon会话管理持久化存储与状态恢复机制 引言为什么需要智能会话管理 在AI编程助手的使用过程中开发者经常面临这样的痛点 长时间编码会话突然中断导致上一篇在 OpenDesign 中落地 NVIDIA 风格设计系统Design Token、组件规范与 Agent 提示词实战指南下一篇ESPnet2 中文普通话 ASR 实战基于 zh_openslr38 语料库的 Conformer 与 HuBERT SSLR 基线复现指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考