From 7573780956715e205e8045779c3be68c62dfced3 Mon Sep 17 00:00:00 2001 From: Cowork 3P Date: Thu, 4 Jun 2026 06:53:38 +0000 Subject: [PATCH] docs(architecture): fix critical accuracy errors, stale refs, paths MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Accuracy fixes: - app-orchestration.md: remove non-existent constructor params - models-and-config.md: remove wrong multiAgent field from SettingsSnapshot - runtime-contracts.md: add missing multiAgent/collaborationMode/routingHint fields Stale multi-agent refs: - unified-routing-architecture.md: agent/multi-agent → agent (含 bridge 转发) - bridge-runtime-routing-map.md: multi-agent tasks → multi-agent forwarding tasks - cross-repo-task-state-workflow.md: remove multi-agent orchestration from mermaid - runtime-contracts.md, feature-surfaces.md: 多 agent → agent Organization: - Move cloud-session-service and stage4-helper to archive/ - Fix 22 xworkmate/ → xworkmate-app/ paths in archive doc - Fix XWorkmate.svc.plus repo name in simple-theme-default.md - Update README.md index and public-api/README.md coverage stats (132/590) --- docs/architecture/README.md | 8 +++- ...assistant-thread-working-directory-flow.md | 44 +++++++++---------- ...ce-multi-device-architecture-2026-03-30.md | 0 .../stage4-helper-ownership-20260328.md | 0 .../bridge-runtime-routing-map.md | 2 +- .../cross-repo-task-state-workflow.md | 2 - docs/architecture/public-api/README.md | 2 +- .../public-api/app-orchestration.md | 4 +- .../public-api/feature-surfaces.md | 2 +- .../public-api/models-and-config.md | 2 +- .../public-api/runtime-contracts.md | 12 ++++- docs/architecture/simple-theme-default.md | 2 +- .../unified-routing-architecture.md | 4 +- 13 files changed, 47 insertions(+), 37 deletions(-) rename docs/architecture/{ => archive}/cloud-session-service-multi-device-architecture-2026-03-30.md (100%) rename docs/architecture/{ => archive}/stage4-helper-ownership-20260328.md (100%) diff --git a/docs/architecture/README.md b/docs/architecture/README.md index 88a230ff..8e6f9c9e 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -18,7 +18,6 @@ - [任务线程 Session Key 隔离（2026-03-29）](./task-thread-session-key-isolation-20260329.md) - [Task Dialog Provider 选择主线](./task-dialog-provider-selection-mainline.md) - [跨仓库任务状态工作流](./cross-repo-task-state-workflow.md) -- [Cloud Session Service 多设备架构（2026-03-30）](./cloud-session-service-multi-device-architecture-2026-03-30.md) ## 设置与配置 @@ -28,7 +27,6 @@ ## 工程实践 -- [Stage4 Helper 归属映射（2026-03-28）](./stage4-helper-ownership-20260328.md) - [No-part 文件组织 ADR](./refactor-style-no-part-adr.md) - [Simple Theme 默认值记录](./simple-theme-default.md) @@ -46,6 +44,12 @@ 已过时的文档移至 [archive/](./archive/)。 +已归档的文档： + +- [Cloud Session Service 多设备架构（2026-03-30）](./archive/cloud-session-service-multi-device-architecture-2026-03-30.md) — 未实现的目标架构 +- [Stage4 Helper 归属映射（2026-03-28）](./archive/stage4-helper-ownership-20260328.md) — 一次性调研快照 +- [Assistant Thread Working Directory Flow](./archive/assistant-thread-working-directory-flow.md) — workspaceRef/workspaceRefKind/cwd 旧版流转 + --- 维护约定：与当前主线不匹配的文档应及时更新或移至 archive。新增架构文档应在此 README 中注册。 diff --git a/docs/architecture/archive/assistant-thread-working-directory-flow.md b/docs/architecture/archive/assistant-thread-working-directory-flow.md index ab32c984..00dcda38 100644 --- a/docs/architecture/archive/assistant-thread-working-directory-flow.md +++ b/docs/architecture/archive/assistant-thread-working-directory-flow.md @@ -5,7 +5,7 @@ > 已过时：本文记录的是 `workspaceRef / workspaceRefKind / cwd fallback` 主导时期的线程目录流转。 > > 当前实现请优先参考： -> [docs/architecture/task-control-plane-unification.md](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/docs/architecture/task-control-plane-unification.md) +> [docs/architecture/task-control-plane-unification.md](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/docs/architecture/task-control-plane-unification.md) > > 新文档已经把 TaskThread 的主流程图和状态图重画为基于 `workspaceBinding / executionBinding / lifecycleState` 的 Mermaid 版本。 @@ -71,8 +71,8 @@ flowchart LR - 变量：`currentSessionKey` - 作用：决定当前操作命中了哪个任务线程 - 关键位置： - - [runtime_controllers_gateway.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/runtime/runtime_controllers_gateway.dart:96) - - [app_controller_desktop_thread_actions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_actions.dart:208) + - [runtime_controllers_gateway.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/runtime/runtime_controllers_gateway.dart:96) + - [app_controller_desktop_thread_actions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_actions.dart:208) 如果 `currentSessionKey` 没切对，后续 `workspaceRef`、`cwd`、右栏路径都会跟着取错。 @@ -81,7 +81,7 @@ flowchart LR - 变量：`settings.workspacePath` - 作用：线程默认目录的根目录 - 关键位置： - - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:571) + - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:571) 默认线程目录由它派生： @@ -89,15 +89,15 @@ flowchart LR 关键位置： -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:560) -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:576) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:560) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:576) ### 3. 线程自己的目录绑定 - 变量：`assistantThreadRecordsInternal[sessionKey].workspaceRef` - 作用：线程级工作目录的真实绑定值 - 关键位置： - - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:121) + - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:121) 读取优先级： @@ -112,7 +112,7 @@ flowchart LR - `remotePath` - `objectStore` - 关键位置： - - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:133) + - [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:133) 它决定 `workspaceRef` 后续如何参与 cwd 解析。 @@ -125,8 +125,8 @@ flowchart LR 关键位置： -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:560) -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:565) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:560) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:565) ### 2. 线程目录名 @@ -135,7 +135,7 @@ flowchart LR 关键位置： -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:581) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:581) ## 线程初始化时的写入 @@ -146,7 +146,7 @@ flowchart LR 关键位置： -- [app_controller_desktop_workspace_execution.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_workspace_execution.dart:261) +- [app_controller_desktop_workspace_execution.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_workspace_execution.dart:261) 这意味着： @@ -161,7 +161,7 @@ flowchart LR 关键位置： -- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_runtime_coordination_impl.dart:183) +- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_runtime_coordination_impl.dart:183) ### 2. 参与变量 @@ -181,9 +181,9 @@ flowchart LR 关键位置： -- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_runtime_coordination_impl.dart:151) -- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_runtime_coordination_impl.dart:160) -- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_runtime_coordination_impl.dart:183) +- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_runtime_coordination_impl.dart:151) +- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_runtime_coordination_impl.dart:160) +- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_runtime_coordination_impl.dart:183) ## provider 对 cwd 的影响 @@ -193,7 +193,7 @@ flowchart LR 关键位置： -- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_runtime_coordination_impl.dart:206) +- [app_controller_desktop_runtime_coordination_impl.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_runtime_coordination_impl.dart:206) 规则简述： @@ -239,7 +239,7 @@ Single Agent 运行后可能返回： 关键位置： -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:709) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:709) ### 2. 它什么时候会改目录 @@ -253,8 +253,8 @@ Single Agent 运行后可能返回： 关键位置： -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:649) -- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/app/app_controller_desktop_thread_sessions.dart:709) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:649) +- [app_controller_desktop_thread_sessions.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/app/app_controller_desktop_thread_sessions.dart:709) ### 3. 典型迁移触发 @@ -272,11 +272,11 @@ Single Agent 运行后可能返回： 传入位置： -- [assistant_page_state_closure.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/features/assistant/assistant_page_state_closure.dart:317) +- [assistant_page_state_closure.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/features/assistant/assistant_page_state_closure.dart:317) 渲染位置： -- [assistant_artifact_sidebar.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate/lib/widgets/assistant_artifact_sidebar.dart) +- [assistant_artifact_sidebar.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/widgets/assistant_artifact_sidebar.dart) 因此右栏显示“未设置”或显示某个路径，本质上反映的是当前线程记录里到底有没有有效 `workspaceRef`。 diff --git a/docs/architecture/cloud-session-service-multi-device-architecture-2026-03-30.md b/docs/architecture/archive/cloud-session-service-multi-device-architecture-2026-03-30.md similarity index 100% rename from docs/architecture/cloud-session-service-multi-device-architecture-2026-03-30.md rename to docs/architecture/archive/cloud-session-service-multi-device-architecture-2026-03-30.md diff --git a/docs/architecture/stage4-helper-ownership-20260328.md b/docs/architecture/archive/stage4-helper-ownership-20260328.md similarity index 100% rename from docs/architecture/stage4-helper-ownership-20260328.md rename to docs/architecture/archive/stage4-helper-ownership-20260328.md diff --git a/docs/architecture/bridge-runtime-routing-map.md b/docs/architecture/bridge-runtime-routing-map.md index 1f71d189..3a13b189 100644 --- a/docs/architecture/bridge-runtime-routing-map.md +++ b/docs/architecture/bridge-runtime-routing-map.md @@ -35,7 +35,7 @@ flowchart TD ## Routing Rules -- App runtime control-plane requests, agent tasks, multi-agent tasks, OpenClaw gateway tasks, `session.cancel`, and `session.close` use `https://xworkmate-bridge.svc.plus/acp/rpc`. +- App runtime control-plane requests, agent tasks, multi-agent forwarding tasks, OpenClaw gateway tasks, `session.cancel`, and `session.close` use `https://xworkmate-bridge.svc.plus/acp/rpc`. - OpenClaw gateway `session.start` and follow-up `session.message` are identified by routing metadata, not by a separate public path. - Provider and gateway selection are passed as request params, including `provider`, `routing`, and `requestedExecutionTarget`. - Bridge-owned internal routing is opaque to the App; it is not represented as public provider paths. diff --git a/docs/architecture/cross-repo-task-state-workflow.md b/docs/architecture/cross-repo-task-state-workflow.md index 26e38bc6..8e1f5bb8 100644 --- a/docs/architecture/cross-repo-task-state-workflow.md +++ b/docs/architecture/cross-repo-task-state-workflow.md @@ -137,11 +137,9 @@ flowchart TD ORCH --> PROVIDER{"provider compat"} PROVIDER -->|single-agent| SA["codex / opencode / gemini / hermes"] PROVIDER -->|gateway| OCG["OpenClaw runtime"] - PROVIDER -->|multi-agent via /acp/rpc| MA["multi-agent orchestration"] SA --> NORM["normalized result"] OCG --> NORM - MA --> NORM NORM --> OUT["success / status / turnId / output / artifacts / resolved*"] ``` diff --git a/docs/architecture/public-api/README.md b/docs/architecture/public-api/README.md index 87448605..70ba0e94 100644 --- a/docs/architecture/public-api/README.md +++ b/docs/architecture/public-api/README.md @@ -58,7 +58,7 @@ Last Updated: 2026-04-14 ## Coverage Summary -当前生成清单覆盖 `129` 个源码文件、`603` 个公开符号。 +当前生成清单覆盖 `132` 个源码文件、`590` 个公开符号。 | Scope | Files | Public Symbols | Detailed Design Entries | Notes | | --- | ---: | ---: | ---: | --- | diff --git a/docs/architecture/public-api/app-orchestration.md b/docs/architecture/public-api/app-orchestration.md index d5792352..844a374e 100644 --- a/docs/architecture/public-api/app-orchestration.md +++ b/docs/architecture/public-api/app-orchestration.md @@ -17,7 +17,7 @@ | `lib/app/app_controller_desktop_navigation.dart` | 页面切换、settings/detail 导航、语言/主题切换 | | `lib/app/app_controller_desktop_settings.dart` | settings draft、保存、落盘与本地状态清理 | | `lib/app/app_controller_desktop_settings_runtime.dart` | settings 与 runtime 之间的副作用桥接 | -| `lib/app/app_controller_desktop_thread_sessions.dart` | 会话/线程、artifact、多 agent 协作入口 | +| `lib/app/app_controller_desktop_thread_sessions.dart` | 会话/线程、artifact、agent 协作入口 | | `lib/app/app_controller_desktop_workspace_execution.dart` | 执行目标、provider、thread context 主链 | | `lib/app/app_controller_desktop_runtime_coordination_impl.dart` | runtime 能力刷新与任务重算函数 | | `lib/app/workspace_page_registry.dart` | destination 到 page builder 的唯一映射 | @@ -41,10 +41,8 @@ | `initialBridgeProviderCatalog` | `List?` | No | empty | 初始单 agent provider catalog | | `initialGatewayProviderCatalog` | `List?` | No | empty | 初始 gateway provider catalog | | `initialAvailableExecutionTargets` | `List?` | No | empty | 初始可见执行目标 | -| `skillDirectoryAccessService` | `SkillDirectoryAccessService?` | No | platform factory | 技能目录授权能力 | | `accountClientFactory` | `AccountRuntimeClient Function(String)?` | No | default impl | account runtime client 构造 | | `environmentOverride` | `Map?` | No | `null` | 测试/运行时环境覆盖 | -| `singleAgentSharedSkillScanRootOverrides` | `List?` | No | `null` | 共享 skill 扫描根覆写 | | `goTaskServiceClient` | `GoTaskServiceClient?` | No | `DesktopGoTaskService` | 外部 ACP / gateway 任务入口 | ### Returns diff --git a/docs/architecture/public-api/feature-surfaces.md b/docs/architecture/public-api/feature-surfaces.md index e99c10b2..ff1253de 100644 --- a/docs/architecture/public-api/feature-surfaces.md +++ b/docs/architecture/public-api/feature-surfaces.md @@ -120,7 +120,7 @@ ### Main Call Chain - `AppShell` / `WorkspacePageSpec` -> `AssistantPage` -- 页面内部通过 `AppControllerDesktopWorkspaceExecution`、`AppControllerDesktopThreadSessions` 发起执行、切换 provider、加载 artifact、多 agent 协作 +- 页面内部通过 `AppControllerDesktopWorkspaceExecution`、`AppControllerDesktopThreadSessions` 发起执行、切换 provider、加载 artifact、agent 协作 ### Notes diff --git a/docs/architecture/public-api/models-and-config.md b/docs/architecture/public-api/models-and-config.md index 37d3f2a2..be3250be 100644 --- a/docs/architecture/public-api/models-and-config.md +++ b/docs/architecture/public-api/models-and-config.md @@ -24,7 +24,7 @@ | execution/provider fields | `defaultModel`、`defaultProvider`、`assistantExecutionTarget`、`assistantPermissionLevel` | | connection fields | `gatewayProfiles`、`webSessionPersistence` | | integration fields | `ollamaLocal`、`ollamaCloud`、`vault`、`aiGateway` | -| multi-agent fields | `multiAgent`、`authorizedSkillDirectories` | +| skill/permission fields | `authorizedSkillDirectories` | | account fields | `accountBaseUrl`、`accountUsername`、`accountWorkspace`、`accountWorkspaceFollowed` | | desktop/server fields | `acpBridgeServerModeConfig`、`linuxDesktop` | diff --git a/docs/architecture/public-api/runtime-contracts.md b/docs/architecture/public-api/runtime-contracts.md index f79a46d6..5fac5eeb 100644 --- a/docs/architecture/public-api/runtime-contracts.md +++ b/docs/architecture/public-api/runtime-contracts.md @@ -44,6 +44,7 @@ | Param | Type | Required | Meaning | | --- | --- | --- | --- | | `singleAgent` | `bool` | Yes | 是否支持单 agent | +| `multiAgent` | `bool` | Yes | 是否支持多 agent 协作 | | `availableExecutionTargets` | `List` | Yes | 当前 bridge 允许的执行目标 | | `providerCatalog` | `List` | Yes | agent 侧 provider catalog | | `gatewayProviderCatalog` | `List` | Yes | gateway 侧 provider catalog | @@ -61,7 +62,7 @@ - Source: `lib/runtime/gateway_acp_client.dart` - Type: `class` - Responsibility: - XWorkmate 对 ACP JSON-RPC 的 app-side client，负责 endpoint 解析、auth header 注入、capability 拉取、多 agent 事件流转发。 + XWorkmate 对 ACP JSON-RPC 的 app-side client，负责 endpoint 解析、auth header 注入、capability 拉取、agent 事件流转发。 ### Constructor Parameters @@ -94,6 +95,12 @@ - Responsibility: 表示 Go task service 视角下的外部 ACP 能力镜像，主要用于任务路由与执行目标可见性判断。 +### Constructor Parameters + +| Param | Type | Required | Meaning | +| --- | --- | --- | --- | +| `multiAgent` | `bool` | Yes | 是否支持多 agent 协作 | + ## `ExternalCodeAgentAcpRoutingResolution` - Source: `lib/runtime/go_task_service_client.dart` @@ -166,6 +173,9 @@ | `provider` | `SingleAgentProvider` | No | 当前 provider | | `remoteWorkingDirectoryHint` | `String` | No | 远端工作目录 hint | | `resumeSession` | `bool` | No | 是否续跑 | +| `multiAgent` | `bool` | No | 是否多 agent 协作 | +| `collaborationMode` | `GoTaskServiceCollaborationMode` | No | 协作模式 | +| `routingHint` | `String` | No | 路由提示 | ### Returns diff --git a/docs/architecture/simple-theme-default.md b/docs/architecture/simple-theme-default.md index e29e280d..4248eda4 100644 --- a/docs/architecture/simple-theme-default.md +++ b/docs/architecture/simple-theme-default.md @@ -34,5 +34,5 @@ This document records the default `simple` theme token set for `XWorkmate.svc.pl ## Source Of Truth -- theme tokens live in [lib/theme/app_theme.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/XWorkmate.svc.plus/lib/theme/app_theme.dart) +- theme tokens live in [lib/theme/app_theme.dart](/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-app/lib/theme/app_theme.dart) - token family name: `simple` diff --git a/docs/architecture/unified-routing-architecture.md b/docs/architecture/unified-routing-architecture.md index 73efc484..c7b0ef26 100644 --- a/docs/architecture/unified-routing-architecture.md +++ b/docs/architecture/unified-routing-architecture.md @@ -2,7 +2,7 @@ ## 1. 架构概览 (Unified Routing Architecture) -当前系统采用 `xworkmate-bridge.svc.plus` 作为统一入口。App 侧通过 managed bridge ACP 主入口 `/acp/rpc` 处理能力发现、路由解析、agent / multi-agent 任务、OpenClaw gateway 任务和会话控制。Provider runtime 与 gateway runtime 地址仍由 bridge 后端内部拥有，不暴露为 App-facing public mapping。 +当前系统采用 `xworkmate-bridge.svc.plus` 作为统一入口。App 侧通过 managed bridge ACP 主入口 `/acp/rpc` 处理能力发现、路由解析、agent 任务（含 bridge 多 agent 转发）、OpenClaw gateway 任务和会话控制。Provider runtime 与 gateway runtime 地址仍由 bridge 后端内部拥有，不暴露为 App-facing public mapping。 ```mermaid graph TD @@ -39,7 +39,7 @@ graph TD | Bridge-owned mapping | App 侧行为 | 备注 | | :--- | :--- | :--- | -| `/acp/rpc` | 直接调用 | 能力发现、路由解析、agent / multi-agent 任务、OpenClaw gateway 任务、cancel、close | +| `/acp/rpc` | 直接调用 | 能力发现、路由解析、agent 任务（含 bridge 多 agent 转发）、OpenClaw gateway 任务、cancel、close | | provider runtime | 不直连 | Bridge 后端内部解析 provider | | gateway runtime | 不直连 | Bridge 后端内部解析 gateway provider |