98 KiB
Right Surface 统一承载实施进度
更新时间:2026-06-23
状态:历史实施记录。2026-10-14 起 Files 的 current renderer 为 ReviewThreadSidePanelTab,直接复用 canonical changeView 与 ChangesPanel;原 WorkspaceFilesSurface 已删除。当前目标、写集、测试与 Gate B 结果统一见 Codex GUI 对齐计划,下方阶段结果仅说明当时验证范围。
背景
Right Surface 的产品目标见 internal/roadmap/rightsurface/README.md。本实施计划只跟踪工程落地进度:把 Workspace 右侧的专家信息、画布、文件、Shell、Harness 等能力收敛到同一套可互斥、可调度、可被 Skills / MCP tools 调用的 surface 承载层。
当前用户反馈的直接问题是:点击抓夹 / 画布入口时,原右侧专家栏没有关闭,导致两个右侧表面并存冲突。第一阶段必须先解决专家栏与画布互斥,再继续做 objectCanvas、Cameo 类空间交互和工具调度开放。
目标
- 专家信息不再作为
WorkspaceShellScene.rightRailNode外层右栏存在。 - 专家信息进入统一 Right Surface / canvas panel 承载层。
- 打开画布、Shell、未来 objectCanvas 等右侧表面时,专家信息收缩到顶部按钮列,不与当前右侧表面并存。
- 用户点击专家按钮时,可以主动关闭当前画布布局并展开专家信息。
- 后续 surface registry 可扩展给 Skills / MCP tools 调度,但第一阶段不实现复杂 objectCanvas。
范围
本阶段包含:
src/components/agent/chat/workspace/right-surface/**WorkspaceMainArea的rightSurfaceContent承载能力WorkspaceConversationScene与useWorkspaceConversationSceneRuntime的透传AgentChatWorkspace的专家栏互斥状态机- 相关 Vitest 回归
本阶段不包含:
- 完整 objectCanvas / Cameo 类空间应用
- Skills / MCP tools 自动打开 surface 的协议实现
- Surface 权限、审计、跨 session 恢复
- GUI smoke / Playwright 全链路闭环之外的产品打磨
当前状态
整体目标完成度:99%
口径:以完整 Right Surface 平台化目标计,当前完成第一阶段的专家栏统一承载、互斥行为和视觉修复,完成 P2 surface registry / controller / state resolver 骨架,补上 P3 Skills / MCP 调度的前端 command + scheduler + intent queue + launcher projection 模型,并已把 launcher projection 接入真实 TaskCenterUtilityToolbar props、Harness runtime pending badge adapter、文件预览 / skill result pending intent adapter、MCP shell 输出 / objectCanvas 候选 intent helper,以及 Browser Assist 候选 -> objectCanvas renderer 接线;Harness、Files、objectCanvas 都已进入 Right Surface definitions,并修正专家 / Harness / Shell / Files / objectCanvas / 工作台互斥接线。旧 GeneralWorkbenchHarnessDialogSection 外层弹窗 fallback 已删除,Harness 不再通过 WorkspaceMainArea 额外渲染第二条右侧展示路径。App Server workspaceRightSurface/request、workspaceRightSurface/pending/list、workspaceRightSurface/pending/consume、workspaceRightSurface/pending/dismiss 与 workspaceRightSurface/pendingChanged 已进入 current JSON-RPC contract、Rust / TS client、renderer API 网关、治理 catalog 和 contract guard。App Server pending metadata 已接入 AgentChatWorkspace:pending files/objectCanvas 请求现在既能进入 toolbar badge,也能让对应 surface 变为可点击并展示 metadata;用户打开对应 surface 时会 consume,用户显式关闭 / 忽略对应 surface 时会 dismiss;request / consume / dismiss 已能通过现有 App Server JSON-RPC notification 管道发出 pendingChanged。pending 请求已具备 AppDataSource / Local SQLite 最小持久化恢复骨架。renderer 侧已有共享 AppServerEventBus,Right Surface pending runtime 与 Agent Runtime drain router 订阅同一条 drain loop,避免多个消费者直接竞争 app_server_drain_events。objectCanvas 已从临时 renderer 升级为独立 board / object / edge model + view model 骨架,覆盖 browserSession 对象类型、来源、facts、connecting / ready / pending / failed 阶段、metadata 裁剪、主动作投影、edit / replay / persist 请求事件 schema,以及 persistRequested / replayRequested -> workspaceRightSurface/request 的 App Server pending owner flow。persistRequested 已从纯 pending metadata 升级为 App Server 内部 workspace_object_canvas_snapshots store 第一刀:RuntimeCore 识别 metadata.objectCanvas.event.kind=persistRequested / owner=appServer 后写入 AppDataSource,Local SQLite 懒建 snapshot 表保存 boardId、revision、persistenceKey、object facts 和原始 snapshot JSON。replayRequested 已完成 RuntimeCore parser / selector / readiness projection 与 dry-run audit event 骨架:RuntimeCore 能从 objectCanvas pending metadata 中投影 boardId、revision、objectId、replayTarget、完整 board snapshot、missingFields、execution blocker,并生成 object_canvas.replay.dry_run 审计事件;真实回放执行、正式 migration 治理和 GUI 视觉矩阵仍未完成,三个事件契约当前全部 disabled。
本轮阶段完成度:100%
口径:以“完成 P4 objectCanvas replayRequested Runtime dry-run / audit 骨架”为本轮目标。RuntimeCore 已能从 current workspaceRightSurface/request 产生的 objectCanvas pending metadata 中筛出 replayRequested / runtime,生成 readiness projection,并进一步生成 object_canvas.replay.dry_run RuntimeEvent 审计投影;executionEnabled=false 且 blocker 固定为 runtime_replay_execution_not_implemented,不声明真实回放执行已完成。
阶段计划
| 阶段 | 状态 | 内容 | 退出条件 |
|---|---|---|---|
| P0 文档基线 | 已完成 | 形成 Right Surface 架构文档与远期 Cameo / objectCanvas 方向 | internal/roadmap/rightsurface/README.md 存在并可作为路线图入口 |
| P1 专家栏统一承载 | 已完成 | 专家信息进入内层 Right Surface,外层 rightRailNode 不再承载专家栏 |
定向测试与 GUI smoke 已通过;根 typecheck 长耗时转独立诊断项 |
| P2 Surface registry | 已完成骨架 | 定义 workbench / expertInfo / objectCanvas / files / shell / harness 的统一注册、优先级和互斥策略 | active surface 选择已走 registry/controller;显式 source=user/route/runtime 有单测 |
| P3 Skills / MCP 调度入口 | 已完成前端骨架、renderer 接线、App Server contract/API 骨架、pending list/consume/dismiss、pendingChanged renderer 消费、pending 持久化恢复与共享 renderer event bus 骨架 | 让 runtime / skills / MCP tools 能以受控 command 请求打开或更新 surface | 前端 command / scheduler / intent queue / launcher projection / runtime adapter 模型已落地;toolbar 已消费 projection;Harness、最小 Files、最小 objectCanvas 已进入 Right Surface renderer;App Server workspaceRightSurface/* current contract 已接入;pending/list 可驱动 toolbar badge 和 metadata 最小打开,用户打开对应 surface 时会 consume 同类 pending;用户显式关闭 / 忽略对应 surface 时会 dismiss 同类 pending;request / consume / dismiss 已发出 workspaceRightSurface/pendingChanged notification,renderer pending runtime 已通过共享 AppServerEventBus 消费 requested / consumed / dismissed 增量;pending request 已能通过 AppDataSource / Local SQLite 最小落盘恢复 |
| P4 objectCanvas 原型 | 已完成最小 Browser Assist / App Server pending 候选 renderer、view model、board / object / edge model 第一刀骨架、edit / replay / persist 事件 schema 骨架、persistRequested / replayRequested pending owner flow、persistRequested -> AppDataSource snapshot store 第一刀、replayRequested -> RuntimeCore readiness projection,以及 replay dry-run audit event 骨架;完整原型未开始 | 参考 Cameo 类交互,只做最小空间对象原型 | 已有 browserSession board、primary object、source、facts、connecting / ready / pending / failed 阶段、metadata 裁剪、主动作投影、三类请求事件契约、persist / replay pending request builder、App Server 内部 snapshot store、Runtime replay readiness parser 和 object_canvas.replay.dry_run 审计事件;编辑、真实回放执行、正式 migration 治理与 GUI 视觉矩阵仍未完成 |
| P5 GUI 产品闭环 | 已开始,Expert Skills Runtime 子路径与 Harness fallback 清理已通过 | Playwright / GUI smoke 覆盖顶部按钮、专家展开、画布互斥、窗口尺寸 | Expert Skills Runtime deterministic Electron fixture 已通过;Harness 旧外层弹窗 fallback 已删除并通过 renderer smoke build;完整专家 / Files / objectCanvas 视觉矩阵仍未完成 |
已落地变更
- 新增 Right Surface 类型和状态入口:
src/components/agent/chat/workspace/right-surface/rightSurfaceTypes.tssrc/components/agent/chat/workspace/right-surface/rightSurfaceState.tssrc/components/agent/chat/workspace/right-surface/RightSurfaceHost.tsxsrc/components/agent/chat/workspace/right-surface/index.ts
WorkspaceMainArea新增rightSurfaceContent:- 有 Right Surface 内容时强制进入
chat-canvas - 使用 Right Surface 内容替换原 canvas content
- 有 Right Surface 内容时强制进入
WorkspaceConversationScene/useWorkspaceConversationSceneRuntime透传rightSurfaceContentAgentChatWorkspace:- 专家面板通过
RightSurfaceHost渲染到内层 surface WorkspaceShellScene.rightRailNode传null- 离开
chat布局时收起专家面板 - 从画布回到聊天时不自动恢复专家面板,必须用户点击专家按钮展开
- 专家面板通过
- 测试夹具补充专家按钮能力:
src/components/agent/chat/index.testFixtures.tsx
- 页面级回归更新:
- 打开画布后专家面板消失
- 回到聊天后仍保持收起
- 点击专家按钮后再展开
- 专家面板视觉修复:
ExpertInfoPanel外层容器从旧 right rail 窄卡片改为right-surface-full- 面板宽高占满
layout-canvas-panel,不再使用clamp(280px, 22vw, 328px)固定宽度 - 去掉外层圆角、阴影和 1180px 以下隐藏规则,避免右侧 surface 内出现悬浮窄卡片
- P2 registry 骨架:
- 新增
rightSurfaceRegistry.ts - 登记
workbench / expertInfo / objectCanvas / files / shell / harness - 统一记录
slot / exclusiveGroup / openSources / collapseTarget AgentChatWorkspace的专家 surface definitions 改为通过 registry builder 生成
- 新增
- P2 controller / state resolver 骨架:
- 新增
rightSurfaceController.ts,统一处理 open / close 与 source 许可判断 resolveWorkspaceRightSurfaceState改为消费 controller,不再直接散落拼 active surface- 支持显式
requestedSurface与source=user|route|runtime currentState进入解析输入后可保留previousSurfacecanvaslayout 映射为canvasFirst,为后续 full canvas / objectCanvas 留出布局语义
- 新增
- P3 command 前端骨架:
- 新增
rightSurfaceCommand.ts - 定义
WorkspaceRightSurfaceCommand与WorkspaceRightSurfaceCommandOrigin - 将
skill/mcpToolorigin 收敛为受控runtimesource - 命令执行仍复用
openWorkspaceRightSurface/closeWorkspaceRightSurface,不绕过 registry source 规则
- 新增
- P3 scheduler 前端骨架:
- 新增
rightSurfaceScheduler.ts - 固化
accepted / rejected / deferred / ignored决策结果 - 后台
skill/mcpTool请求默认不抢占当前用户正在看的 surface userLockedSurface时非用户请求延后,后续可接 pending badge / tool result intent 队列
- 新增
- P3 intent queue / adapter 骨架:
- 新增
rightSurfaceIntentQueue.ts - runtime / skill / MCP tool result 后续只需要生成
WorkspaceRightSurfaceIntent accepted更新 surface 并清理同 id pending intentdeferred进入 pending queue,重复 id 覆盖旧请求rejected / ignored不入队- TTL prune 已有纯函数,后续可接 pending badge 清理
- 新增
- P3 launcher projection 骨架:
- 新增
rightSurfaceToolbarProjection.ts - 从统一
surfaceState + pendingIntents生成顶部按钮 projection - 固定
active / disabled / pendingCount / collapseTarget TaskCenterUtilityToolbar已优先消费 projection,不再只靠散落布尔 props 推断专家 / 工作台 / Harness active 和 badge 状态
- 新增
- P3 launcher projection 接线:
AgentChatWorkspace基于rightSurfaceState生成rightSurfaceLaunchersuseWorkspaceConversationSceneRuntime与WorkspaceConversationScene透传rightSurfaceLaunchersTaskCenterUtilityToolbar继续保留旧 props fallback,避免尚未迁入 Right Surface 的 Shell / Harness 局部状态被误收敛
- P3 runtime pending badge adapter:
- 新增
rightSurfaceRuntimeAdapter.ts - 现有 Harness pending 数量会转换为统一
WorkspaceRightSurfaceIntent preferredServiceSkillResultFileTarget会转换为filessurface pending intent,为文件预览 / skill result 进入 Right Surface 调度链做准备- MCP shell 输出可通过
buildWorkspaceRightSurfaceMcpShellOutputIntents转换为shellsurface pending intent - objectCanvas 候选可通过
buildWorkspaceRightSurfaceObjectCanvasCandidateIntents转换为objectCanvassurface pending intent - Browser Assist launching 已作为真实前端来源接入
objectCanvaspending intent 聚合,但 objectCanvas launcher 仍保持 disabled - 新增
workspaceRightSurfaceRuntimeProjection.ts,统一汇总 runtime pending intents 与 launcher available surface 规则 AgentChatWorkspace不再向 launcher projection 传空 pending intentsTaskCenterUtilityToolbar已覆盖 projection 单独驱动 Harness badge 的回归filesAvailable已由真实preferredServiceSkillResultFileTarget驱动,避免没有目标文件时暴露假入口
- 新增
- P3 Harness renderer 接入:
WorkspaceHarnessDialogs.tsx新增GeneralWorkbenchHarnessSurfaceSection- Harness surface 复用现有
HarnessStatusPanel layout="dialog",先完成承载迁移,不重写 Harness 内部信息架构 AgentChatWorkspace的rightSurfaceDefinitions已登记harnessrenderer- 旧
GeneralWorkbenchHarnessDialogSection外层弹窗 fallback 已删除,不再通过WorkspaceMainArea渲染第二条 Harness 展示路径 - 专家按钮、Shell 按钮、工作台按钮和 Harness 按钮都会收敛到统一 Right Surface 互斥状态,避免两个右侧表面并存
- 修复
useWorkspaceExpertAgentLaunchSyncRuntime在sessionId初始化前执行导致AgentChatWorkspace挂载失败的问题
- P3 Files renderer 接入:
- 新增
WorkspaceFilesSurface.tsx,只承载当前结果文件目标和“打开文件”动作,暂不扩展成完整文件管理器 AgentChatWorkspace在preferredServiceSkillResultFileTarget存在时登记filesrenderer,并通过setManualRightSurface("files")与专家 / Harness / Shell / 工作台互斥WorkspaceConversationScene/useWorkspaceConversationSceneRuntime透传rightSurfaceFilesOpen与onToggleRightSurfaceFilesTaskCenterUtilityToolbar新增fileslauncher 按钮,active / disabled / pendingCount 均读取统一 projectionfiles当前只对已有结果文件目标开放,避免无目标时出现假入口
- 新增
- P4 objectCanvas 最小 renderer 接入:
- 新增
WorkspaceObjectCanvasSurface.tsx,只承载 Browser Assist 候选的 title / url / session / profile / target / transport / control 等最小信息 - 新增
workspaceObjectCanvasModel.ts,定义 board / primary object / edge / source / facts / capability 骨架;当前只启用browserSession单对象 board workspaceObjectCanvasModel.ts已定义editRequested / replayRequested / persistRequested三类事件 schema,分别归属renderer / runtime / appServerowner,并记录 required / optional request fields、accepted object kinds 和退出信号- 当前事件 schema 仍受
canEdit / canReplay / canPersist控制为 disabled,后续 Skills / MCP tools 可读取契约,但本阶段不开放编辑、回放或正式持久化 - 新增
workspaceObjectCanvasPersistence.ts,把persistRequested投影为workspaceRightSurface/request参数,metadata 中同时保留现有 pending objectCanvas renderer 可读字段和objectCanvas.eventtyped payload requestWorkspaceObjectCanvasPersist(...)只通过src/lib/api/workspaceRightSurface.ts进入 App Server current method,不在组件里直接safeInvoke,也不新增 parallel JSON-RPC method- 新增
workspaceObjectCanvasReplay.ts,把replayRequested投影为workspaceRightSurface/request参数,metadata 中记录runtimeowner、replayTarget和 board / object facts requestWorkspaceObjectCanvasReplay(...)同样只通过src/lib/api/workspaceRightSurface.ts进入 App Server current method,为后续 RuntimeCore 消费 pending metadata 预留单一入口- App Server
RuntimeCore已在workspaceRightSurface/request内识别objectCanvas.event.kind=persistRequested/owner=appServermetadata,并投影为内部WorkspaceObjectCanvasSnapshot RightSurfaceAppDataSource新增WorkspaceObjectCanvasSnapshot与 snapshot list 参数,Local SQLite 数据源新增workspace_object_canvas_snapshots懒建表,保存board_id / revision / persistence_key / object_id / object_kind / snapshot_json- persist / replay metadata 均新增
objectCanvas.snapshot完整 board 快照;objectCanvas.board继续作为轻量 summary,避免后续 Runtime consumer 只能从 summary / primary object facts 反推对象图 - snapshot store 不新增 JSON-RPC method,不改变 renderer UI 能力,不把
canPersist=false伪装成已启用;当前只证明 renderer persist owner flow 可以真实落到 App Server fact source RuntimeCore新增内部WorkspaceObjectCanvasReplayReadiness/WorkspaceObjectCanvasReplayReadinessListParams,从 pending objectCanvas 请求中过滤replayRequested / runtimemetadata- replay readiness projection 会保留 request scope、boardId、revision、objectId、objectKind、replayTarget、source、facts、完整 board snapshot 和 missingFields
- replay readiness 当前固定
executionEnabled=false,blocker 为runtime_replay_execution_not_implemented,只给后续 Runtime executor 提供真实输入,不启动回放执行 RuntimeCore::dry_run_workspace_object_canvas_replay(...)已把 replay readiness 投影为object_canvas.replay.dry_runRuntimeEvent 审计事件,payload 包含 request scope、metadata status、missingFields、execution blocker、blockingReasons、source / facts / boardSnapshot- dry-run audit 不 consume pending、不调用浏览器、不启动回放执行;完整 metadata 与缺字段 metadata 都会输出
audit.decision=blocked,用于后续 executor 启用前的审计证据 - 新增
workspaceObjectCanvasViewModel.ts,把 Browser Assist / App Server pending metadata 投影为browserSession对象、阶段、摘要、元数据和主动作 workspaceObjectCanvasViewModel.ts已改为消费workspaceObjectCanvasModel.ts,不再自行解析 lifecycle 或持有对象事实源workspaceObjectCanvasModel.unit.test.ts覆盖 board id、primary object、source、facts、capabilities、stage 解析和空字段裁剪- 新增
workspaceObjectCanvasViewModel.unit.test.ts,覆盖 ready / connecting / failed / pending fallback 和元数据裁剪 WorkspaceObjectCanvasCandidate类型事实源收敛到 model 文件,WorkspaceObjectCanvasSurface不再 re-export 候选类型,避免渲染组件成为领域模型事实源WorkspaceObjectCanvasSurface.test.tsx覆盖 ready / connecting / failed 三种阶段、对象类型、阶段徽标、metadata 行和打开浏览器工作台动作- 五语言
workspace.browserAssistRenderer.objectCanvas.*文案已覆盖 object kind、stage、summary、status 和主动作 AgentChatWorkspace基于browserAssistSessionState/ launching state 计算objectCanvasCandidateId,有候选信息时才把objectCanvas标为 availableobjectCanvasrenderer 已登记进rightSurfaceDefinitions,并通过setManualRightSurface("objectCanvas")与专家 / Harness / Shell / Files / 工作台互斥TaskCenterUtilityToolbar新增objectCanvaslauncher 按钮,active / disabled / pendingCount 均读取统一 projectionWorkspaceConversationScene/useWorkspaceConversationSceneRuntime透传rightSurfaceObjectCanvasOpen与onToggleRightSurfaceObjectCanvas- 本轮只做 Browser Assist / pending metadata 的对象投影骨架,不实现完整 Cameo 对象模型、编辑流、回放和持久化
- 新增
- P3 App Server contract / API 骨架接入:
- 新增 App Server current methods:
workspaceRightSurface/requestworkspaceRightSurface/pending/listworkspaceRightSurface/pending/consumeworkspaceRightSurface/pending/dismiss
- 新增 Rust DTO 与 schema:
WorkspaceRightSurfaceRequestParamsWorkspaceRightSurfacePendingListParamsWorkspaceRightSurfacePendingConsumeParamsWorkspaceRightSurfacePendingDismissParamsWorkspaceRightSurfacePendingRequestWorkspaceRightSurfaceRequestResponseWorkspaceRightSurfacePendingListResponseWorkspaceRightSurfacePendingConsumeResponseWorkspaceRightSurfacePendingDismissResponse
RuntimeCore当前以内存right_surface_pending保存 pending 请求,并支持 workspace / session / surfaceKind / limit 过滤workspaceRightSurface/pending/consume可按requestId/requestIds删除内存 pending 请求,并返回 consumed / missing request id 列表workspaceRightSurface/pending/dismiss可按requestId/requestIds删除内存 pending 请求,并返回 dismissed / missing request id 列表;reason当前只作为协议字段进入请求,不做持久审计app-server-protocolmethod catalog、schema export registry、schema fixtures、app-server-clientRust typed helper 已同步packages/app-server-client已同步 method 常量、generated protocol types、request builder、connection wrapper 与 npm client 测试src/lib/api/appServer.ts已暴露 renderer-safe alias 与AppServerClient.requestWorkspaceRightSurface(...)/listWorkspaceRightSurfacePending(...)/consumeWorkspaceRightSurfacePending(...)/dismissWorkspaceRightSurfacePending(...)- 新增
src/lib/api/workspaceRightSurface.ts独立网关,业务层后续应从这里进入,不直接散落safeInvoke src/lib/governance/agentCommandCatalog.json新增appServerWorkspaceRightSurfaceMethodsscripts/check-app-server-client-contract.mjs新增 Right Surface current contract guard
- 新增 App Server current methods:
- P3 App Server pending 前端消费接线:
- 新增
useWorkspaceRightSurfacePendingRuntime.ts,通过src/lib/api/workspaceRightSurface.ts查询workspaceRightSurface/pending/list - 查询范围优先使用
workspaceId / workspaceRoot,缺少 workspace 时才退到sessionId - bridge 不可用或查询失败时 fail closed,不保留旧 pending
- pending 请求投影为统一
WorkspaceRightSurfaceIntent,并补出pendingFileTarget/pendingObjectCanvasCandidate AgentChatWorkspace合并 App Server pending intents 到 toolbar projection,pending files/objectCanvas 请求会显示 badgeAgentChatWorkspace使用 pending files metadata 作为WorkspaceFilesSurface兜底 target;没有真实handleOpenServiceSkillResultFile时只展示 surface,打开文件按钮保持禁用AgentChatWorkspace使用 pending objectCanvas metadata 作为WorkspaceObjectCanvasSurface兜底 candidate;没有 Browser Assist candidate 时不展示“打开浏览器工作台”动作- 本地 runtime pending intent 不重复包装 App Server pending metadata,避免 toolbar badge 双计数
- 新增
- P3 UI 自动消费第一刀:
useWorkspaceRightSurfacePendingRuntime新增consumePendingRequestsForSurface(surfaceKind)- bridge 不可用或 Right Surface pending runtime disabled 时不消费,避免浏览器 / 测试夹具误报成功
- 只消费当前
pendingRequests中status === "pending"且surfaceKind匹配的 request id - 调用
workspaceRightSurface/pending/consume后只移除 App Server 返回的consumedRequestIds - consume 失败时保留 pending,并把错误写入
lastError AgentChatWorkspace已在用户打开expertInfo / files / shell / objectCanvas / harness时触发自动消费;UI 展开不等待 consume 成功
- P3 UI 显式 dismiss 第一刀:
useWorkspaceRightSurfacePendingRuntime新增dismissPendingRequestsForSurface(surfaceKind, reason?)- bridge 不可用或 Right Surface pending runtime disabled 时不 dismiss,避免浏览器 / 测试夹具误报成功
- 只 dismiss 当前
pendingRequests中status === "pending"且surfaceKind匹配的 request id - 调用
workspaceRightSurface/pending/dismiss后只移除 App Server 返回的dismissedRequestIds - dismiss 失败时保留 pending,并把错误写入
lastError AgentChatWorkspace已在用户显式关闭expertInfo / files / shell / objectCanvas / harness或从右侧 surface 切回工作台时触发 dismiss;自动 availability cleanup 不触发 dismiss,避免把运行时临时无候选误判为用户忽略
- P3 App Server pendingChanged notification 骨架:
- 新增 current notification method:
workspaceRightSurface/pendingChanged - 新增 Rust DTO / schema:
WorkspaceRightSurfacePendingChangedParams RpcDispatch从response + AgentEvent扩展为response + AgentEvent + JsonRpcNotification,保留agentSession/event原链路不变workspaceRightSurface/request成功后附带changeType=requestednotification,并携带 request id 与 pending request 快照workspaceRightSurface/pending/consume成功后附带changeType=consumednotification,并携带 consumed / missing request id 列表workspaceRightSurface/pending/dismiss成功后附带changeType=dismissednotification,并携带 dismissed / missing request id 列表packages/app-server-client/src/protocol.ts新增workspaceRightSurfacePendingChangedNotification(...)/isWorkspaceRightSurfacePendingChangedNotification(...)- Electron host
initialize.capabilities.eventMethods已声明workspaceRightSurface/pendingChanged src/lib/api/workspaceRightSurface.ts已新增readWorkspaceRightSurfacePendingChangedNotification(...)与drainWorkspaceRightSurfacePendingChangedNotifications(...),只从 App Server drain 消息中过滤 Right Surface notificationuseWorkspaceRightSurfacePendingRuntime已新增 pendingChanged drain loop,默认每 250ms drain 一次,消费requested / consumed / dismissed增量更新本地 pending;pending/listpolling 仍保留为一致性兜底
- 新增 current notification method:
- P3 共享 renderer event bus 骨架:
- 新增
src/lib/api/appServerEventBus.ts,集中调用AppServerClient.drainEvents()并把 JSON-RPC notification 广播给 renderer 订阅者 src/lib/api/workspaceRightSurface.ts新增subscribeWorkspaceRightSurfacePendingChangedNotifications(...),Right Surface pending runtime 默认走订阅式事件消费,旧drainWorkspaceRightSurfacePendingChangedNotifications(...)仅保留为测试 / 过渡注入AppServerAgentSessionEventDrainRouter不再自建 renderer drain loop,改为订阅同一个 event bus,保留 route register、fallback event name、sequence 排序、terminal event 关闭 route 和 fast-first drain 策略- event bus 会在 notification 分发后重新计算下一轮间隔,确保 Agent Runtime 首事件后从
24ms / limit=1恢复到250ms / limit=50 resetDefaultAppServerEventBusForTests()用于 Vitest 隔离,避免默认 singleton 在测试之间保留订阅或 fake timer 状态
- 新增
验证记录
已通过:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/workspace/useWorkspaceConversationSceneRuntime.test.ts" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:5 个测试文件通过,60 个测试通过。
P2 registry 骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:5 个测试文件通过,37 个测试通过。
补充视觉修复回归:
npx vitest run \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:3 个测试文件通过,24 个测试通过。覆盖专家面板 data-layout="right-surface-full"、Right Surface 替换画布内容,以及页面级专家入口路径。
P2 controller / state resolver 与 P3 command / scheduler / intent queue / launcher projection 前端骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:11 个测试文件通过,69 个测试通过。覆盖 registry/controller/state/command/scheduler/intent queue/launcher projection 纯逻辑、Right Surface 替换画布内容、专家 full surface 视觉标记,以及页面级工作台回归。
P3 launcher projection 接入真实 toolbar props 回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:12 个测试文件通过,98 个测试通过。覆盖 Right Surface 纯逻辑、toolbar projection 消费、Workspace 透传、专家 panel 和页面级工作台回归。
P3 runtime pending badge adapter 接线回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRuntimeAdapter.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:13 个测试文件通过,102 个测试通过。覆盖 runtime / skill / MCP open signal -> intent adapter、Harness pending -> Right Surface badge intent、toolbar projection 单独驱动 Harness badge、Workspace 透传与专家 full surface 回归。
P3 文件预览 / skill result pending intent adapter 接线回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRuntimeAdapter.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:13 个测试文件通过,104 个测试通过。覆盖文件预览路径归一化、空目标不入队、文件预览目标进入 files surface pending intent、Right Surface projection、toolbar、Workspace 透传与专家 full surface 回归。
P3 MCP shell / objectCanvas 候选 helper 回归:
npx vitest run \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRuntimeAdapter.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts"
结果:8 个测试文件通过,42 个测试通过。覆盖 runtime adapter、command/controller/queue/scheduler/registry/state/projection 的 Right Surface 纯逻辑主链。
P3 Browser Assist -> objectCanvas 候选接线回归:
npx vitest run \
"src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRuntimeAdapter.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceCommand.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceController.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceIntentQueue.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRegistry.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceScheduler.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceState.unit.test.ts" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceToolbarProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/experts/ExpertInfoPanel.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:14 个测试文件通过,111 个测试通过。覆盖 Browser Assist launching -> objectCanvas pending intent、objectCanvas launcher pendingCount 但 disabled、Right Surface 纯逻辑、toolbar、Workspace 透传与页面级工作台回归。
P4 objectCanvas 最小 renderer / toolbar / scene 接线回归:
npx vitest run \
"src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" \
"src/components/agent/chat/workspace/ReviewThreadSidePanelTab.test.tsx" \
"src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx"
结果:5 个测试文件通过,59 个测试通过。覆盖 objectCanvas 最小 renderer、打开浏览器工作台回调、objectCanvas available/disabled projection、顶部按钮 active / badge / disabled 状态、Workspace scene 透传和 Files 回归。
P4 objectCanvas view model / renderer 骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" \
"src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" \
"src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" \
"src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx"
结果:5 个测试文件通过,46 个测试通过。覆盖 objectCanvas candidate -> browserSession object projection、connecting / ready / pending / failed 阶段、metadata 裁剪、主动作投影、组件渲染、pending metadata 兜底和 Workspace scene 透传。观察到既有 react-i18next:: NO_I18NEXT_INSTANCE 测试环境警告,测试通过。
P4 objectCanvas board / object / edge model 骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" \
"src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" \
"src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" \
"src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" \
"src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx"
结果:6 个测试文件通过,50 个测试通过。覆盖 objectCanvas board / primary object / source / facts / capabilities、view model 消费 model、renderer、runtime projection、App Server pending metadata 兜底和 Workspace scene 透传。观察到既有 react-i18next:: NO_I18NEXT_INSTANCE 测试环境警告,测试通过。
P4 objectCanvas renderer smoke build 回归:
npm run build:renderer:electron:smoke
结果:通过。覆盖真实 Electron renderer bundle 构建,验证 workspaceObjectCanvasModel、workspaceObjectCanvasViewModel、WorkspaceObjectCanvasSurface、AgentChatWorkspace 与 pending runtime import 能进入 renderer 产物。过程中观察到既有 Vite oem-runtime-config.js bundling 提示和 Browserslist 数据提示,未阻塞构建。
P4 objectCanvas GUI smoke 回归:
npm run verify:gui-smoke
结果:通过。覆盖 verify:app-version、renderer electron smoke build、packages/app-server-client build、typecheck:electron、Electron host build、desktop assets、App Server sidecar assets,以及 Electron smoke 的 renderer loaded、app-server initialized、Claw workbench shell ready、memory settings ready。过程中观察到既有 Vite oem-runtime-config.js bundling 提示、Browserslist 数据提示和 Electron GPU mailbox 日志,未阻塞 smoke。
P4 board / object model 后 GUI smoke 补跑:
npm run verify:gui-smoke
结果:通过。首次补跑失败在 src/components/agent/chat/components/ThinkingBlock.tsx 的翻译调用语法解析,已把三个 t(...) 调用整理为普通两参数写法后重跑通过。最新 smoke 覆盖 renderer loaded、app-server initialized、Claw workbench shell ready、memory settings ready。
页面级工作台挂载回归:
npx vitest run "src/components/agent/chat/index.workbench04.test.tsx"
结果:1 个测试文件通过,7 个测试通过。覆盖 Browser Assist 相关页面级主路径,确认 AgentChatWorkspace objectCanvas 接线未破坏通用工作台挂载。
P3 App Server contract / API 骨架定向回归:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-client
cargo run --manifest-path "lime-rs/Cargo.toml" -p app-server-protocol --bin write_schema_fixtures
npm run generate:protocol-types
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/lib/api/appServer.test.ts"
npm --prefix "packages/app-server-client" test
npm run check:protocol-types
node "scripts/check-app-server-client-contract.mjs"
结果:Rust App Server Right Surface 定向测试、Rust app-server-client、schema fixture/type generation、renderer API 定向测试、npm app-server-client 测试、protocol type drift check 与 App Server client contract guard 均通过。覆盖 workspaceRightSurface/request、workspaceRightSurface/pending/list 与 workspaceRightSurface/pending/consume 的 current contract。
P3 App Server contract / API 组合门禁:
npm run test:contracts
git diff --check
结果:通过。覆盖 protocol types drift check、App Server client contract guard、command contracts、harness contracts、modality contracts、scripts governance、Electron release workflow guard、harness cleanup report check、docs boundary,以及工作树 diff 空白检查。
P3 App Server pending 前端消费骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" \
"src/components/agent/chat/workspace/right-surface/rightSurfaceRuntimeAdapter.unit.test.ts" \
"src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" \
"src/components/agent/chat/index.workbench04.test.tsx"
结果:6 个测试文件通过,76 个测试通过。覆盖 App Server pending/list hook、pending intent 投影、files/objectCanvas metadata 兜底 target/candidate、toolbar badge、Workspace scene 透传与页面级 Browser Assist 工作台回归。
P3 UI 自动消费第一刀回归:
npx vitest run \
"src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" \
"src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" \
"src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx"
结果:3 个测试文件通过,56 个测试通过。覆盖打开某类 surface 后只消费对应类别 pending、bridge 不可用时不消费、consume 失败保留 pending 并记录错误,以及 toolbar / scene 回归。
P3 UI 显式 dismiss / ignore 第一刀回归:
cargo run --manifest-path "lime-rs/Cargo.toml" -p app-server-protocol --bin write_schema_fixtures
npm run generate:protocol-types
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-client workspace_helpers_use_current_methods
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/appServer.test.ts"
npx vitest run "packages/app-server-client/tests/client.test.mjs"
node "scripts/check-app-server-client-contract.mjs"
npm run test:contracts
git diff --check
npx vitest run "src/components/agent/chat/index.workbench04.test.tsx"
结果:通过。覆盖 workspaceRightSurface/pending/dismiss 的 Rust protocol / schema export / RuntimeCore / processor dispatch / Rust app-server-client / TS app-server-client / renderer API 网关 / hook /治理 catalog / contract guard。Rust App Server Right Surface 定向测试 10 个通过;Rust app-server-client workspace helper 测试 1 个通过;renderer API + hook + App Server client Vitest 47 个通过;npm app-server-client 52 个测试通过;test:contracts 完整契约门禁通过;git diff --check 通过;页面级 index.workbench04 7 个测试通过。
页面级工作台回归:
npx vitest run "src/components/agent/chat/index.workbench04.test.tsx"
结果:1 个测试文件通过,7 个测试通过。覆盖 AgentChatWorkspace 接入 pending consume 后页面级工作台主路径仍可挂载。
P3 contract guard 拆分口径回归:
node "scripts/check-app-server-client-contract.mjs"
npm run test:contracts
结果:通过。app-server-client-contract 当前为 282 项检查通过,并且完整 contract 门禁覆盖 protocol types、App Server client contract、command contracts、harness contracts、modality contracts、scripts governance、Electron release workflow guard、harness cleanup report check 和 docs boundary。该回归证明拆分后的 packages/app-server-client/src/index.ts barrel、request-client* / connection* / sidecar* / agent-runtime.ts,以及 renderer src/lib/api/appServer* split owner 仍被 contract guard 覆盖。
P3 pendingChanged notification 骨架回归:
cargo run --manifest-path "lime-rs/Cargo.toml" -p app-server-protocol --bin write_schema_fixtures
npm run generate:protocol-types
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-protocol app_server_method_catalog_keeps_request_and_notification_methods_together
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-client reexports_protocol_method_catalog_for_consumers
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface
npx vitest run "packages/app-server-client/tests/client.test.mjs"
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/lib/api/appServer.test.ts"
node "scripts/check-app-server-client-contract.mjs"
cargo fmt --manifest-path "lime-rs/Cargo.toml" --all
npm run test:contracts
git diff --check
结果:通过。覆盖 workspaceRightSurface/pendingChanged 的 Rust method catalog notification 分类、schema / generated TS 类型、processor response 后 notification 输出、Rust app-server-client re-export、TS app-server-client method catalog / parser、renderer constants/types、Electron host eventMethods、治理 catalog 和 contract guard。app-server workspace_right_surface 当前 10 个 Right Surface 测试通过,其中 processor 测试断言 requested / consumed / dismissed notification 均跟随 response 输出;packages/app-server-client/tests/client.test.mjs 当前 53 个测试通过;renderer API 2 个测试文件 / 36 个测试通过;完整 test:contracts 通过。
P3 共享 renderer event bus 骨架回归:
npx vitest run \
"src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" \
"src/lib/api/workspaceRightSurface.test.ts" \
"src/lib/api/agentRuntime/threadClient.test.ts"
git diff --check
结果:通过。3 个测试文件 / 66 个测试通过,覆盖 Right Surface pending runtime 默认订阅共享 event bus、旧 direct drain 过渡分支、workspaceRightSurface API notification parser、Agent Runtime drain router 订阅同一 bus、fast-first limit=1 / 24ms 与首事件后 limit=50 / 250ms 恢复。git diff --check 通过。本轮没有新增 App Server JSON-RPC method 或 command catalog 变更,因此未重复跑完整 npm run test:contracts。
Agent Runtime current fixture 补充验证:
npm run smoke:agent-runtime-current-fixture
结果:未完全通过。已通过 history/cache hydration、stream completion、Claw 终态 UI跳过段、Electron fixture guard、Coding Workbench Electron fixture、cancel-then-continue、Skills Runtime natural / explicit / workspace try、MCP structuredContent、Expert Skills Runtime declared / selected / invoked;最终失败在 Claw Expert Plaza Skills Runtime click-through Electron fixture。失败 summary:.lime/qc/gui-evidence/claw-chat-current-fixture/claw-chat-current-fixture-expert-plaza-skills-runtime-regression-summary.json,GUI 显示 技能还不能运行,原因是 Expert Plaza catalog 注入的 skill:capability-report 没有 workspace SkillCatalog locator,expertPlazaSkillsRuntimeCatalog.workspaceSkillCatalog=null。当前判断为 Expert Plaza / Skills Runtime fixture 映射缺口,非本轮共享 event bus 直接回归失败;已登记,不在本轮扩写集修复。
GUI smoke 回归:
npm run verify:gui-smoke
结果:通过。覆盖 verify:app-version、renderer electron smoke build、packages/app-server-client build、typecheck:electron、Electron host build、desktop assets、App Server sidecar assets,以及 Electron smoke 的 renderer loaded、app-server initialized、Claw workbench shell ready、memory settings ready。
已观察但未在本轮处理:
react-i18next:: useTranslation: NO_I18NEXT_INSTANCE:现有测试环境警告,相关测试通过。Browserslist: caniuse-lite is 6 months old:依赖数据提示,非本轮阻塞。Maximum update depth exceeded:出现在index.workbench04的既有自动发送测试场景;本轮收紧专家栏 effect 后仍出现,说明不是 Right Surface 新状态机直接引入。后续若进入 GUI smoke 前仍存在,应独立定位。Maximum update depth exceeded:本轮接入 App Server pending metadata 后仍只在index.workbench04的既有自动发送测试场景出现,相关测试通过;已把 pending hook fail-closed 空状态更新改为幂等,但告警未完全消失,后续应独立定位自动发送测试的 effect 依赖。
未完成:
npm run typecheck:本轮曾有一次全仓 typecheck 通过,但在最后一次删除 transition 旧逻辑和更新页面级测试后,重复 typecheck 单进程运行超过 15 分钟仍未退出且无错误输出,已中断;当前无残留 typecheck 进程。下一刀应加--extendedDiagnostics或拆分 TS project 定位耗时来源。npm run verify:gui-smoke:已重跑通过。
GUI smoke 记录:
- 最新通过:
npm run verify:gui-smoke- renderer loaded
- app-server initialized protocol=
appserver.v0version=1.76.0 - claw workbench shell ready
- memory settings ready
- 已通过:
verify:app-version - 已通过:
build:renderer:electron:smoke - 已通过:
electron:build:host - 已通过:
electron:build:assets - 已通过:
electron:build:app-server-assets - 已通过:Electron smoke 主路径,包含 renderer loaded、app-server initialized、claw workbench shell ready、memory settings ready
TypeScript 诊断记录:
npm run typecheck -- --extendedDiagnostics --pretty false:超过 15 分钟仍无输出,已中断;该入口在完成前不会给 diagnostics,无法直接定位耗时文件。- 已通过:
npm --prefix "packages/app-server-client" run build - 已通过:
npm run typecheck:electron - 当前判断:长耗时集中在根
tsconfig.json的 renderer /src全仓检查,不在 app-server client 或 Electron host 边界。
视觉复核记录:
- 已尝试用 Playwright MCP 打开
http://localhost:4567。 - 阻塞:Playwright MCP 的 Chrome profile 已被现有浏览器占用,
browser_navigate和browser_tabs list均返回Browser is already in use。 - 处理方式:未强行关闭现有浏览器会话;下一刀应使用独立 Playwright profile 或复用真实 Electron fixture 截图。
进度日志
2026-06-22
- 建立 Right Surface 第一阶段代码骨架。
- 将专家信息面板从外层 right rail 迁入内层 Right Surface 承载层。
- 补充
WorkspaceMainArea、WorkspaceConversationScene、useWorkspaceConversationSceneRuntime、index.workbench04回归。 - 明确互斥策略:打开画布时收起专家,回到聊天后不自动恢复,点击专家按钮才展开。
- 清理重复 / 残留 typecheck 进程。
- 新增本进度计划文件。
- 继续尝试最终验证:
npm run typecheck长耗时未退出,已中断;npm run verify:gui-smoke在 app-server sidecar build 阶段被 Cargo artifact lock 阻塞。 - 根据截图反馈修复专家面板视觉形态:专家信息现在作为完整右侧 surface 填满右侧 panel,不再以窄卡片悬在右侧空白区。
- Cargo lock 释放后重跑
npm run verify:gui-smoke并通过;再次运行npm run typecheck超过 15 分钟无错误输出且未退出,已中断并确认无残留进程。 - 进一步运行 typecheck 诊断:
--extendedDiagnostics同样超过 15 分钟无输出;拆分验证packages/app-server-client与 Electron host TypeScript 均通过,剩余耗时集中在 renderer 根 tsconfig。 - 尝试 Playwright 视觉复核,受已有 Chrome profile 占用阻塞,未强行关闭用户 / 其他 agent 浏览器会话。
- 停止继续深挖全仓 typecheck 细节,将其登记为回头诊断项;优先完成 P2 registry 骨架。
- 新增 Right Surface registry 骨架并让专家 surface definitions 走 registry builder,避免后续 surface 继续散落在
AgentChatWorkspace。 - 完成 P2 controller / state resolver 骨架:active surface 打开/关闭统一走 registry source 规则,显式
requestedSurface支持user / route / runtime,并记录previousSurface。 - 完成 P3 command 前端骨架:
skill/mcpToolorigin 统一映射到runtimesource,未来工具调度不能绕过 registry/controller。 - 完成 P3 scheduler 前端骨架:后台工具请求不会抢占当前 surface,用户锁定时非用户请求延后,source 不允许时 rejected。
- 完成 P3 intent queue / adapter 骨架:deferred 请求进入 pending queue,accepted 同 id 请求可清理 pending,rejected 不入队,TTL prune 已有纯函数。
- 完成 P3 launcher projection 骨架:统一输出 toolbar launcher 的 active / disabled / pendingCount / collapseTarget。
- 完成 P3 launcher projection 接线:
TaskCenterUtilityToolbar已接入rightSurfaceLaunchers,专家 / 工作台按钮优先读 projection,旧 props 保留为过渡 fallback。 - 重跑 Right Surface + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 9 个测试文件 / 60 个测试。 - 重跑
npm run verify:gui-smoke并通过,覆盖 Electron renderer、App Server sidecar、Claw workbench shell 和 memory settings 主路径。 - 新增 intent queue 后重跑 Right Surface + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 10 个测试文件 / 66 个测试。 - 新增 launcher projection 后重跑 Right Surface + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 11 个测试文件 / 69 个测试。 - 接入真实 toolbar props 后重跑 Right Surface +
TaskCenterUtilityToolbar+ Workspace + ExpertInfoPanel +index.workbench04定向组合回归,通过 12 个测试文件 / 98 个测试。 - 新增 P3 runtime pending badge adapter:把 Harness pending 数量转换为统一 Right Surface intent,
AgentChatWorkspace的 launcher projection 不再传空pendingIntents。 - 补充 adapter 单测和 toolbar Harness badge projection 回归;重跑 Right Surface + toolbar + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 13 个测试文件 / 102 个测试。 - 重跑
npm run verify:gui-smoke并通过,覆盖 Electron renderer、App Server sidecar、Claw workbench shell 和 memory settings 主路径。 - 扩展 P3 runtime adapter:把
preferredServiceSkillResultFileTarget转换为filessurface pending intent,先接调度数据,不把filessurface 标为可用,避免未迁 renderer 的假入口。 - 重跑 Right Surface + toolbar + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 13 个测试文件 / 104 个测试。 - 重跑
npm run verify:gui-smoke并通过;期间 Cargo artifact lock 等待后释放,最终覆盖 Electron renderer、App Server sidecar、Claw workbench shell 和 memory settings 主路径。 - 补齐 MCP shell 输出和 objectCanvas 候选的 runtime adapter 命名 helper,只进入 intent / projection 数据层,不接 renderer、不新增按钮、不改 App Server contract。
- 重跑 Right Surface 纯逻辑回归,通过 8 个测试文件 / 42 个测试;本刀未触碰渲染接线,未重复跑 GUI smoke。
- 新增
workspaceRightSurfaceRuntimeProjection.ts聚合 runtime pending intents 和 available surfaces,AgentChatWorkspace改为通过该 projection 汇总 Right Surface launcher 输入。 - 接入真实 Browser Assist launching 作为 objectCanvas 候选 pending intent;objectCanvas 仍 disabled,不新增按钮和 renderer。
- 重跑 Right Surface + runtime projection + toolbar + Workspace + ExpertInfoPanel +
index.workbench04定向组合回归,通过 14 个测试文件 / 111 个测试。 - 重跑
npm run verify:gui-smoke并通过,覆盖 Electron renderer、App Server sidecar、Claw workbench shell 和 memory settings 主路径。 - 完成 objectCanvas 最小 renderer 接入:Browser Assist 候选信息可进入 Right Surface,顶部 objectCanvas 按钮读取统一 projection,点击后与专家 / Harness / Files / Shell / 工作台互斥,并可打开浏览器工作台。
- 补齐 objectCanvas 五语言文案:
zh-CN / zh-TW / en-US / ja-JP / ko-KR的 agent 顶部按钮文案与 workspace renderer 字段文案。 - 重跑 objectCanvas / Files / projection / toolbar / scene 定向回归,通过 5 个测试文件 / 59 个测试。
- 完成 App Server pending 前端消费骨架:
useWorkspaceRightSurfacePendingRuntime通过 renderer API 网关查询workspaceRightSurface/pending/list,把 pending 请求投影为 Right Surface intent 和 files/objectCanvas metadata target。 AgentChatWorkspace已合并 App Server pending intents 到 toolbar projection,并用 pending files/objectCanvas metadata 兜底 surface availability 与 renderer target/candidate,完成request -> pending/list -> toolbar badge -> surface open最小闭环。- 对 App Server pending files 请求,只有 metadata target 时可打开 Files surface,但没有真实文件打开 handler 时按钮保持禁用,避免伪造文件能力。
- 对 App Server pending objectCanvas 请求,只有 metadata candidate 时可打开 Object Canvas surface,但没有 Browser Assist candidate 时不展示“打开浏览器工作台”动作,避免伪造 runtime 能力。
- 收紧 pending hook 的 fail-closed 空状态更新,避免 bridge 不可用或空 pending 时反复写入新空数组。
- 重跑 App Server pending hook / runtime adapter / projection / toolbar / Workspace scene / 页面级工作台定向回归,通过 6 个测试文件 / 76 个测试。
- 重跑
index.workbench04页面级工作台挂载回归,通过 1 个测试文件 / 7 个测试。 - 重跑
npm run verify:gui-smoke并通过,覆盖 Electron renderer、App Server sidecar、Claw workbench shell 和 memory settings 主路径。
2026-06-23
- 完成 Right Surface App Server current JSON-RPC 骨架:
workspaceRightSurface/request、workspaceRightSurface/pending/list和workspaceRightSurface/pending/consume已进入 Rust protocol、method catalog、schema export、RuntimeCore、processor dispatch、Rust app-server-client、TS app-server-client 与 renderer API 网关。 - 新增
src/lib/api/workspaceRightSurface.ts,后续 Skills / MCP tools / 对话侧调度右侧 surface 应优先经该网关进入 App Server current method,不在组件中直接safeInvoke。 - 同步
src/lib/governance/agentCommandCatalog.json的appServerWorkspaceRightSurfaceMethods,并在scripts/check-app-server-client-contract.mjs增加 Right Surface contract guard。 - 补充回归:
src/lib/api/workspaceRightSurface.test.ts覆盖 request / pending list / pending consume current method、默认空参数和 fail-closed shape validationsrc/lib/api/appServer.test.ts覆盖 rendererAppServerClient通过app_server_handle_json_lines调用 Right Surface methodspackages/app-server-client/tests/client.test.mjs覆盖 method builder、method catalog 与isAppServerRequestMethod
- 已通过:
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/lib/api/appServer.test.ts"、npm --prefix "packages/app-server-client" test、npm run check:protocol-types、node "scripts/check-app-server-client-contract.mjs"。 - 已通过:
npm run test:contracts、git diff --check。这次组合门禁证明 Right Surface App Server current contract/API 骨架没有破坏协议生成、命令目录、治理守卫、脚本治理、release workflow 守卫和文档边界。 - 代码体量债登记:
packages/app-server-client/src/index.ts与src/lib/api/appServer.ts均已超过 1000 行。本轮只做 contract 薄接线,未追加业务状态机;后续应拆分 app-server-client workspace/right-surface 子模块和 renderer App Server domain aliases,退出条件是新增 method 不再直接膨胀巨型 facade。 - 完成 UI 自动消费第一刀:
useWorkspaceRightSurfacePendingRuntime返回consumePendingRequestsForSurface(surfaceKind),AgentChatWorkspace在用户打开expertInfo / files / shell / objectCanvas / harness时调用workspaceRightSurface/pending/consume,只清理同类 pending 请求。 - 自动消费策略保持非阻塞:surface 展开不等待 consume 成功;consume 失败时 pending 保留并记录错误,避免 UI 因 App Server 临时失败丢失调度意图。
- contract guard 拆分口径已收口:
scripts/check-app-server-client-contract.mjs支持packages/app-server-client与 renderersrc/lib/api/appServer*拆分 owner,并接受 current method spec 安装方式,不再要求旧单体 facade 中出现所有手写 wrapper。 - MCP contract guard 同步支持 app-server-client split owner,避免 MCP current contract 检查误判拆分后的
request-client.ts/connection-methods.ts。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" "src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx",3 个测试文件 / 56 个测试通过。 - 已通过:
npx vitest run "src/components/agent/chat/index.workbench04.test.tsx",1 个测试文件 / 7 个测试通过。 - 已通过:
node "scripts/check-app-server-client-contract.mjs",app-server-client-contract282 项通过。 - 已通过:
npm run test:contracts,完整契约门禁通过。 - 完成 P3 显式 dismiss / ignore 语义骨架:新增
workspaceRightSurface/pending/dismiss,同步 Rust protocol、method catalog、schema export、RuntimeCore、processor dispatch、Rust app-server-client、TS app-server-client、renderer API 网关、治理 catalog 和 contract guard。 useWorkspaceRightSurfacePendingRuntime新增dismissPendingRequestsForSurface(surfaceKind, reason?),只 dismiss 同类 pending 请求,只按 App Server 返回的dismissedRequestIds本地移除;失败时保留 pending 并记录错误。AgentChatWorkspace已把用户显式关闭路径接到 dismiss:再次点击同一 surface 入口关闭、Shell 内部关闭按钮、从右侧 surface 切回工作台;自动 availability cleanup 暂不 dismiss。- 刷新 schema fixtures 与 TS generated protocol types,新增
WorkspaceRightSurfacePendingDismissParams.json/WorkspaceRightSurfacePendingDismissResponse.json及对应 generated TS interface。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface,10 个 Right Surface server 测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-client workspace_helpers_use_current_methods,1 个 Rust app-server-client workspace helper 测试通过。 - 已通过:
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/appServer.test.ts",3 个测试文件 / 47 个测试通过。 - 已通过:
npx vitest run "packages/app-server-client/tests/client.test.mjs",1 个测试文件 / 52 个测试通过。 - 已通过:
node "scripts/check-app-server-client-contract.mjs",app-server-client-contract282 项通过;已通过:npm run test:contracts、git diff --check与npx vitest run "src/components/agent/chat/index.workbench04.test.tsx"。 - 完成 P3 pendingChanged notification 骨架:新增
workspaceRightSurface/pendingChangedcurrent notification method 与WorkspaceRightSurfacePendingChangedParams,同步 Rust protocol、schema export、processor dispatch、Rust app-server-client、TS app-server-client、renderer constants/types、Electron host capability、治理 catalog 和 contract guard。 RpcDispatch已支持通用JsonRpcNotification,Right Surface request / consume / dismiss 会在 response 后附带requested / consumed / dismissednotification;Agent session event 仍保持原agentSession/event路径。- 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-protocol app_server_method_catalog_keeps_request_and_notification_methods_together,1 个 protocol catalog 测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server-client reexports_protocol_method_catalog_for_consumers,1 个 Rust client catalog 测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface,10 个 Right Surface server 测试通过。 - 已通过:
npx vitest run "packages/app-server-client/tests/client.test.mjs",1 个测试文件 / 53 个测试通过。 - 已通过:
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/lib/api/appServer.test.ts",2 个测试文件 / 36 个测试通过。 - 已通过:
node "scripts/check-app-server-client-contract.mjs",app-server-client-contract282 项通过;已通过:cargo fmt --manifest-path "lime-rs/Cargo.toml" --all、npm run test:contracts与git diff --check。 - 完成 P3 pendingChanged renderer 订阅消费骨架:
workspaceRightSurfaceAPI 网关新增 notification parser 与drainWorkspaceRightSurfacePendingChangedNotifications(limit),业务 hook 不直接散落 JSON-RPC method 判断。 useWorkspaceRightSurfacePendingRuntime新增 pendingChanged drain loop:requested会按当前 workspace/session 查询范围 upsert pending,consumed / dismissed会按服务端确认 ids 移除 pending,missingRequestIds不会被当作已变化请求处理。- pendingChanged drain 失败时只记录
lastError,不清空 polling 得到的 pending;pending/listpolling 保留兜底,避免全局 drain 队列被其他 renderer 消费者抢走后 UI 永久不刷新。 - 已通过:
npx vitest run "src/lib/api/workspaceRightSurface.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/appServer.test.ts",3 个测试文件 / 54 个测试通过。 - 完成 P3 pending 持久化恢复骨架:新增
RightSurfaceAppDataSource,RuntimeCorerequest/list/consume/dismiss 接入 AppDataSource;Noop 数据源保持内存行为,Local SQLite 数据源开启持久化恢复。 workspaceRightSurface/request先保存 pending 到 AppDataSource,再加入 RuntimeCore 内存;pending/list会合并内存与持久化 pending,并在持久化可用时按当前查询 scope 清理已被其他 core 消费 / dismiss 的陈旧内存 pending。pending/consume与pending/dismiss会删除持久化 pending,并同步删除当前 core 内存 pending;同一个测试 AppDataSource 下,core1创建 pending、core2恢复并 consume 后,core1/core2再 list 均为空。- Local SQLite 骨架使用
workspace_right_surface_pending_requests懒建表保存 request JSON 与 workspace/session/surface/status 索引;本轮暂不升级为正式 migration 文件,后续若产品级长期表治理打开,应补 schema/migration 入口。 - 已通过:
cargo fmt --manifest-path "lime-rs/Cargo.toml" --all。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server workspace_right_surface,11 个 Right Surface server / processor 测试通过。 - 已通过:
git diff --check。 - 完成 P3 共享 renderer event bus 骨架:新增
AppServerEventBus作为 renderer 内唯一AppServerClient.drainEvents()消费入口,并支持订阅者声明limit / intervalMs / shouldDrain。 - Right Surface pending runtime 默认通过
subscribeWorkspaceRightSurfacePendingChangedNotifications(...)订阅共享 event bus;旧drainWorkspaceRightSurfacePendingChangedNotifications(...)保留为测试 / 过渡注入,生产默认路径不再直接抢 drain 队列。 - Agent Runtime
AppServerAgentSessionEventDrainRouter改为订阅同一个 event bus,不再自建 drain loop;保留路由注册、fallback event name、sequence 排序、terminal route 关闭和 fast-first 策略。 - 修正共享 bus 的下一轮间隔计算:首事件 drain 前仍使用
limit=1 / 24ms,首事件分发后重新计算并恢复limit=50 / 250ms,避免过度快速轮询。 - 为
threadClient.test.ts增加resetDefaultAppServerEventBusForTests()的 before/after 隔离,避免 singleton bus 与 fake timer 跨用例污染。 - 已通过:
npx vitest run "src/lib/api/agentRuntime/threadClient.test.ts",39 个测试通过。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/workspaceRightSurface.test.ts" "src/lib/api/agentRuntime/threadClient.test.ts",3 个测试文件 / 66 个测试通过。 - 已通过:
git diff --check。 - 补跑
npm run smoke:agent-runtime-current-fixture:聚合入口未完全通过;前置 history/cache、stream completion、Electron fixture guard、Coding Workbench、cancel-then-continue、Skills Runtime、MCP structuredContent、Expert Skills Runtime 均通过,最终失败在 Expert Plaza click-through Electron fixture。 - Expert Plaza 失败证据显示
skill:capability-report缺少 workspace SkillCatalog locator,GUI 停在“技能还不能运行 / no SkillCatalog locator”;该缺口属于 Expert Plaza / Skills Runtime fixture 映射链,已登记为非本轮 event bus 主线阻塞。 - 真实 live Provider 验证收敛:
scripts/agent-runtime/expert-skills-live-runner.mjs不再只消费外部 summary 或 fixture evidence,已补--execute-live-runtime前置的 workspace-localcapability-reportSkill 包、harness.workspace_skill_runtime_enablemetadata、完整evidence/exportevents 读取,以及失败态 / Provider 错误的 summary 判定;避免把failed或 free text 误判成 completed / tool evidence。runner 新增--completion-grace-ms,避免真实 turn 在 timeout 边界刚完成时写不出 summary。 - 修复 Expert Skills Runtime live selector 主缺口:expert-bound / workspace runtime enable 候选不再被当成已显式选择的
SKILL.mdbody 注入;只有$skill/ catalog scene / implicit 高置信且无 expert/runtime enable 时才注入 selected body。expert 候选提示明确要求skill_search -> Skill。selected_agent_skill_allowed_tools_for_turn也改为只读取实际 body selection,避免allowed_tools: Read把 live turn 裁成tools=1并隐藏skill_search/Skill。 - 已通过:
npx vitest run "scripts/agent-runtime/expert-skills-live-runner.test.mjs",8 个测试通过;已通过:cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server runtime_backend::agent_skills_context -- --nocapture,9 个测试通过;已通过:cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server runtime_backend::agent_skills_telemetry -- --nocapture,4 个测试通过;已通过:cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server session_config_does_not_project_expert_runtime_enable_allowed_tools_to_turn_scope -- --nocapture,1 个测试通过;已通过:cargo test --manifest-path "lime-rs/Cargo.toml" -p lime-agent tools::skill_search_tool -- --nocapture,3 个测试通过;已通过:cargo test --manifest-path "lime-rs/Cargo.toml" -p lime-agent tools::skill_tool_gate -- --nocapture,11 个测试通过。 - 真实 live Provider 结果:
deepseek / deepseek-v4-flash:真实到达 Provider,但返回402 Payment Required: Insufficient Balance。siliconflow-cn / deepseek-ai/DeepSeek-V4-Flash:真实到达 Provider,但返回403 Forbidden: account balance is insufficient。custom-6afceaf4-3287-4848-b8a0-2d2d25e738f7 / kimi-for-coding:真实到达 Provider,但返回401 Unauthorized。custom-f74b38b5-6d3f-44ef-aa0f-99d70c3482ed / sensenova-6.7-flash-lite:真实完成 turn,后端真实记录 expert skillRefs、SKILL.mdbody read、Skill gate;模型没有发起skill_search/Skill,仅文本说明或直接Read。custom-cb381b4f-d2fa-4eff-ba22-c867c38ba8d3 / gpt-5.4:第一轮真实完成 turn,后端真实记录 expert skillRefs、SKILL.mdbody read、Skill gate,并真实调用Skill(project:capability-report);缺skill_searchbeforeSkillordering,live gate 未通过。修复后第二轮真实 turn 在 runner timeout 后几秒完成,late export 显示tools=37、skill_search结构化调用在Skill(project:capability-report)前出现,Skill调用、SKILL.mdbody read 与 Skill gate 均真实发生,expert-skills-live-runner-summary.json归一化为ok=true。
- 当前真实状态:Expert Skills Runtime live 主链已跑通,不再是 mock / fixture 结论;通过证据在
.lime/qc/expert-skills-live-runner-summary.json与.lime/qc/expert-skills-live-runner-late-evidence-export.json。剩余缺口是 runner 原命令在 180s 边界超时,已补--completion-grace-ms,仍需用新 runner 再跑一次端到端自动写 summary 验证。 - 完成 Expert Skills Runtime 双门验证收口:
- 修复 deterministic Electron fixture 顶部 Harness 按钮可见但点击 no-op 的问题:
AgentChatWorkspace的 Harness Right Surface 可用条件收敛到!suppressHomeNavbarUtilityActions && showHarnessToggle,避免 toolbar 显示入口但 handler 因isThemeWorkbench直接返回。 - 刷新 Electron smoke renderer 产物:
npm run build:renderer:electron:smoke通过,确保真实 fixture 加载的dist/index.html使用新接线。 - 修复 fixture 对 Right Surface Harness 的旧 dialog 假设:导出证据包后,如果 Harness 已作为
workspace-right-surface-host[data-surface="harness"]打开,脚本会点击顶部专家按钮切回expertInfosurface,再等待专家面板 Evidence Pack 复盘卡。 - 对齐专家面板补目录映射断言:当前产品语义是把待映射
skill:code-review替换为可运行skill:local:capability-report,因此 deterministic gate 校验替换后的 expert skillRefs 到达 backend,不再要求旧待映射 ref 同时保留。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" "src/components/agent/chat/components/TaskCenterUtilityToolbar.integration.test.tsx" "src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx",3 个测试文件 / 54 个测试通过。 - 已通过:
npx vitest run "scripts/agent-runtime/claw-chat-current-fixture-smoke.test.mjs" "scripts/agent-runtime/expert-skills-live-gate.test.mjs" "scripts/agent-runtime/expert-skills-live-runner.test.mjs",3 个测试文件 / 28 个测试通过。 - 已通过:
CARGO_TARGET_DIR=".lime/qc/cargo-target-app-server-smoke" npm run smoke:claw-chat-current-fixture -- --scenario expert-panel-skills-runtime --evidence-dir ".lime/qc/gui-evidence/claw-chat-current-fixture" --prefix "claw-chat-current-fixture-expert-panel-skills-runtime-regression" --timeout-ms 240000。summary 为.lime/qc/gui-evidence/claw-chat-current-fixture/claw-chat-current-fixture-expert-panel-skills-runtime-regression-summary.json,ok=true,liveProviderNotUsed=true,覆盖专家广场启动、专家面板补技能、第二轮 backend turnStart、read model completed、Harness Right Surface 证据导出和专家面板复盘摘要。 - 已通过:
node scripts/agent-runtime/expert-skills-live-gate.mjs --live-summary ".lime/qc/expert-skills-live-runner-summary.json",输出EXPERT_SKILLS_LIVE_GATE_RESULT=pass与deterministic=pass live=pass。
- 修复 deterministic Electron fixture 顶部 Harness 按钮可见但点击 no-op 的问题:
- 完成 Harness 旧外层弹窗 fallback 清理:
- 删除
GeneralWorkbenchHarnessDialogSection组件出口,不再保留 Right Surface 之外的 Harness 外层弹窗展示路径。 - 删除
AgentChatWorkspace中的旧 dialog 构造,以及useWorkspaceConversationSceneRuntime/WorkspaceConversationScene/WorkspaceMainArea的generalWorkbenchHarnessDialog透传和渲染。 - 保留
GeneralWorkbenchHarnessSurfaceSection作为 current Right Surface renderer;保留GeneralWorkbenchDialogSection作为现有输入区 / 工作台弹窗,不属于本轮清理对象。 - 已通过残留扫描:
rg -n "GeneralWorkbenchHarnessDialogSection|generalWorkbenchHarnessDialog" "src/components/agent/chat"无命中。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/WorkspaceHarnessDialogs.test.tsx" "src/components/agent/chat/workspace/WorkspaceMainArea.test.tsx" "src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx" "src/components/agent/chat/workspace/useWorkspaceConversationSceneRuntime.test.ts",4 个测试文件 / 59 个测试通过。 - 已通过:
npm run build:renderer:electron:smoke,Electron renderer smoke bundle 成功产出。 - 已通过:
git diff --check。
- 删除
- 完成 P4 objectCanvas view model / object projection 第一刀:
- 新增
workspaceObjectCanvasViewModel.ts,把 Browser Assist / App Server pending metadata 投影为browserSession对象、阶段、摘要、metadata 和主动作。 WorkspaceObjectCanvasSurface改为消费 view model,组件只保留渲染和打开浏览器工作台动作接线;WorkspaceObjectCanvasCandidate不再从组件 re-export。WorkspaceObjectCanvasSurface.test.tsx覆盖 ready / connecting / failed 阶段、对象类型、阶段徽标、metadata 行和打开动作;测试 mock 中清理旧 renderer 文案 key。- 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" "src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" "src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx",5 个测试文件 / 46 个测试通过。 - 已通过:
npm run verify:gui-smoke,真实 Electron / App Server smoke 覆盖 renderer loaded、app-server initialized、Claw workbench shell ready、memory settings ready。 - 已通过:
git diff --check。
- 新增
- 完成 P4 objectCanvas board / object / edge model 第一刀:
- 新增
workspaceObjectCanvasModel.ts,定义 board、primary object、edge、source、facts、capabilities 骨架;当前只生成单个browserSessionprimary object,edge 为空。 canEdit / canReplay / canPersist明确为false,避免把最小 Browser Assist renderer 误判为完整 Cameo 原型。workspaceObjectCanvasViewModel.ts改为消费 model,stage / facts / capabilities 的事实源迁出展示投影。- Browser Assist 候选标记
sourceKind="browserAssist";App Server pending 候选标记sourceKind="rightSurfacePending"与sourceRequestId,为后续 replay / persist 保留来源边界。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" "src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" "src/components/agent/chat/workspace/workspaceRightSurfaceRuntimeProjection.unit.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/components/agent/chat/workspace/WorkspaceConversationScene.test.tsx",6 个测试文件 / 50 个测试通过。 - 已通过:
npm run build:renderer:electron:smoke,Electron renderer smoke bundle 成功产出。 npm run verify:gui-smoke首次补跑暴露ThinkingBlock.tsx翻译调用语法构建阻塞;已最小整理调用写法,不改变展示逻辑。- 已通过:
npm run verify:gui-smoke,真实 Electron / App Server smoke 覆盖 renderer loaded、app-server initialized、Claw workbench shell ready、memory settings ready。
- 新增
- 完成 P4 objectCanvas edit / replay / persist 事件 schema 骨架:
workspaceObjectCanvasModel.ts新增WorkspaceObjectCanvasEventSchema、request schema、exit condition 和 owner 类型。editRequested归属renderer,以boardRevisionAdvanced作为退出信号;replayRequested归属runtime,以runtimeReplayStarted作为退出信号;persistRequested归属appServer,以boardSnapshotPersisted作为退出信号。- 三类事件当前均由
canEdit / canReplay / canPersist显式控制为 disabled,不改变 UI 动作和 Browser Assist 打开工作台能力。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" "src/components/agent/chat/workspace/WorkspaceObjectCanvasSurface.test.tsx" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx",4 个测试文件 / 31 个测试通过。
- 完成 P4 objectCanvas
persistRequestedApp Server owner flow 第一刀:- 新增
workspaceObjectCanvasPersistence.ts,把 board、primary object、persist event schema、request payload、persistence key 和 pending renderer 字段投影为workspaceRightSurface/request参数。 requestWorkspaceObjectCanvasPersist(...)通过src/lib/api/workspaceRightSurface.ts调用 App Server currentworkspaceRightSurface/request,真实进入 Right Surface pending / notification / 持久化恢复链路;本轮不新增 JSON-RPC method。metadata.objectCanvas.event.enabled继续跟随canPersist=false,用于声明契约和 owner flow,不把正式 snapshot 持久化伪装成已启用。- 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasPersistence.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/workspaceRightSurface.test.ts",5 个测试文件 / 39 个测试通过。 - 已尝试:
npx tsc --noEmit --project "tsconfig.renderer.json",60 秒无输出后中断;该问题与既有 renderer/root typecheck 长耗时风险一致,继续登记为诊断项。 - 已通过:
npm run build:renderer:electron:smoke,Electron renderer smoke bundle 成功产出;已通过:git diff --check。
- 新增
- 完成 P4 objectCanvas
replayRequestedRuntime owner flow 第一刀:- 新增
workspaceObjectCanvasReplay.ts,把 board、primary object、replay event schema、request payload、replayTarget和 pending renderer 字段投影为workspaceRightSurface/request参数。 requestWorkspaceObjectCanvasReplay(...)通过src/lib/api/workspaceRightSurface.ts调用 App Server currentworkspaceRightSurface/request,真实进入 Right Surface pending / notification / 持久化恢复链路;后续 RuntimeCore 应消费metadata.objectCanvas.event.kind === "replayRequested"执行回放。metadata.objectCanvas.event.enabled继续跟随canReplay=false,用于声明 Runtime owner flow,不把回放执行伪装成已启用。- 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasReplay.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasPersistence.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasViewModel.unit.test.ts" "src/components/agent/chat/workspace/useWorkspaceRightSurfacePendingRuntime.unit.test.tsx" "src/lib/api/workspaceRightSurface.test.ts",6 个测试文件 / 42 个测试通过。 - 已通过:
npm run build:renderer:electron:smoke,Electron renderer smoke bundle 成功产出,耗时约 2 分 48 秒;已通过:git diff --check。
- 新增
- 完成 P4 objectCanvas
persistRequested正式 snapshot store 第一刀:RightSurfaceAppDataSource新增内部WorkspaceObjectCanvasSnapshot/WorkspaceObjectCanvasSnapshotListParams,供 RuntimeCore、LocalAppDataSource 和后续 replay consumer 共享同一事实源。RuntimeCore::request_workspace_right_surface继续复用 currentworkspaceRightSurface/request,仅在surfaceKind=objectCanvas且 metadata 为persistRequested / appServer时抽取 boardId、revision、persistenceKey、candidateId、objectId、objectKind 与原始 snapshot JSON。- Local SQLite 数据源新增
workspace_object_canvas_snapshots懒建表和 workspace/session/persistenceKey 索引;本刀不新增 JSON-RPC method,不触碰协议四侧,也不新增用户可见 UI 文案。 - renderer persist / replay metadata 已同时携带轻量
objectCanvas.boardsummary 和完整objectCanvas.snapshotboard 快照,App Server snapshot store 会保存完整 metadata JSON,为后续 RuntimeCore replay consumer 提供真实输入。 - 已通过:
npx vitest run "src/components/agent/chat/workspace/workspaceObjectCanvasModel.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasPersistence.unit.test.ts" "src/components/agent/chat/workspace/workspaceObjectCanvasReplay.unit.test.ts",3 个测试文件 / 11 个测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server local_data_source::tests::right_surface_object_canvas_snapshot_persists_in_local_sqlite_data_source -- --nocapture,1 个真实 Local SQLite 测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server runtime::tests::right_surface -- --nocapture,11 个 Right Surface Runtime 测试通过。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server right_surface -- --nocapture,14 个 Right Surface Runtime / processor / Local SQLite 测试通过。 - 已通过:
npm run build:renderer:electron:smoke,Electron renderer smoke bundle 成功产出,验证新增 TS metadata 字段能进入真实 renderer bundle。
- 完成 P4 objectCanvas
replayRequestedRuntime consumer 骨架第一刀:- 新增 RuntimeCore 内部
WorkspaceObjectCanvasReplayReadiness/WorkspaceObjectCanvasReplayReadinessListParams,不新增 JSON-RPC method,不触碰协议四侧。 list_workspace_object_canvas_replay_readiness(...)会基于 current pending/list 事实源读取 objectCanvas pending request,并筛选metadata.objectCanvas.event.kind=replayRequested / owner=runtime。- readiness projection 会投影 boardId、revision、objectId、objectKind、replayTarget、source、facts、完整
objectCanvas.snapshot、missingFields、metadataReady 和 execution blocker;完整 metadata 标记metadataReady,缺 objectId / snapshot 时标记metadataIncomplete。 - 回放执行仍显式禁用:
executionEnabled=false,executionBlocker=runtime_replay_execution_not_implemented。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server right_surface -- --nocapture,16 个 Right Surface Runtime / processor / Local SQLite 测试通过。
- 新增 RuntimeCore 内部
- 完成 P4 objectCanvas
replayRequestedRuntime dry-run / audit 骨架:- 新增
RuntimeCore::dry_run_workspace_object_canvas_replay(...),复用 readiness list,不新增 JSON-RPC method,不触碰协议四侧。 - 新增
object_canvas.replay.dry_runRuntimeEvent 审计投影,payload 固化schemaVersion=object-canvas.replay.dry-run.v1、request scope、boardId、objectId、metadata status、missingFields、execution blocker、blockingReasons、source / facts / boardSnapshot。 - 完整 metadata 会生成 dry-run audit 事件但仍
execution.wouldExecute=false,原因是 Runtime replay executor 尚未实现;缺字段 metadata 会把缺失字段与 executor blocker 一并放入audit.blockingReasons。 - 非 replay pending 不会产生 dry-run event;dry-run 不 consume pending、不调用浏览器、不启动实际回放。
- 已通过:
cargo fmt --manifest-path "lime-rs/Cargo.toml" --all。 - 已通过:
cargo test --manifest-path "lime-rs/Cargo.toml" -p app-server right_surface -- --nocapture,19 个 Right Surface Runtime / processor / Local SQLite 测试通过。
- 新增
下一刀
- 继续 P5:用独立 Playwright profile 或真实 Electron fixture 截图复核专家 / Files / objectCanvas full right surface 的视觉效果,确认没有右侧空白和文本挤压。
- 回头补正式持久化表治理:如果 Right Surface pending / objectCanvas snapshot 进入长期产品路径,把当前懒建表收敛进统一 schema / migration 事实源。
- 后续 P4:在 dry-run audit 通过后再接真实 Runtime replay executor;启用前保持
canEdit / canReplay / canPersist=false,不要在AgentChatWorkspace堆新 layout 分支。 - 回头诊断 renderer 根
typecheck长耗时;不要让它阻塞 Right Surface 骨架推进。
风险与约束
- 当前工作树存在大量并行改动;后续只应触碰 Right Surface、Workspace 接线、相关测试和本计划文件。
- 不要恢复外层
WorkspaceShellScene.rightRailNode专家栏。 - 不要让专家栏从 layout 切换后自动反弹展开。
- 不要把最小 Browser Assist objectCanvas renderer 当成完整 Cameo 原型;完整对象模型属于 P4 后续。
workspaceObjectCanvasModel.ts当前只有 browserSession 单对象 board;事件 schema 已定义,persistRequested / replayRequested已能生成 App Server pending request,persistRequested已能写入 App Server snapshot store,replayRequested已能生成 RuntimeCore readiness projection 与 dry-run audit event,但canEdit / canReplay / canPersist明确为 false,后续启用前必须补真实 Runtime replay executor、回放回归和正式 migration 治理。- 新增用户可见文案必须走五语言 i18n;objectCanvas 顶部按钮与 renderer 字段已覆盖五语言。
- Right Surface App Server contract 当前仍是骨架:pending request 已有 AppDataSource / Local SQLite 最小恢复能力;UI consume / dismiss / pendingChanged renderer 消费只覆盖“用户打开对应 surface 后清理同类 pending”“用户显式关闭 / 忽略后 dismiss 同类 pending”和“notification 增量刷新本地 pending”。共享 renderer event bus 已完成骨架收敛,但不等于正式 migration 治理或完整对象模型完成。
packages/app-server-client/src/index.ts与src/lib/api/appServer.ts已超过 1000 行;后续新增业务逻辑必须拆分,不能继续把状态机或投影逻辑塞进 facade。