diff --git a/README.en.md b/README.en.md index 4050420..1aa54f4 100644 --- a/README.en.md +++ b/README.en.md @@ -21,7 +21,7 @@ An OpenClaw memory and evolution management tool — a cross-platform desktop ap ClawScope is a local-first desktop control plane: React renders the memory, configuration, and evolution workspaces; Tauri IPC forwards UI actions into the Rust command layer; and Rust talks to OpenClaw Gateway over WebSocket to access agents, memory, configuration, and evolution targets. Local JSON storage only keeps connection identity, endpoints, audit history, and snapshots for reconnect, traceability, and rollback. -![ClawScope system architecture](public/images/diagrams/clawscope-system-architecture.svg) +![ClawScope system architecture](public/images/diagrams/clawscope-system-architecture-en.svg) ## Quick Start diff --git a/README.md b/README.md index 4050420..1aa54f4 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ An OpenClaw memory and evolution management tool — a cross-platform desktop ap ClawScope is a local-first desktop control plane: React renders the memory, configuration, and evolution workspaces; Tauri IPC forwards UI actions into the Rust command layer; and Rust talks to OpenClaw Gateway over WebSocket to access agents, memory, configuration, and evolution targets. Local JSON storage only keeps connection identity, endpoints, audit history, and snapshots for reconnect, traceability, and rollback. -![ClawScope system architecture](public/images/diagrams/clawscope-system-architecture.svg) +![ClawScope system architecture](public/images/diagrams/clawscope-system-architecture-en.svg) ## Quick Start diff --git a/README.zh.md b/README.zh.md index fe78410..170d9c6 100644 --- a/README.zh.md +++ b/README.zh.md @@ -21,7 +21,7 @@ OpenClaw 记忆与进化管理工具 — 基于 Tauri 2 + Rust 构建的跨平 ClawScope 是一个本地优先的桌面控制面:React 负责记忆、配置、进化等工作视图,Tauri IPC 将界面动作转发到 Rust 命令层,Rust 侧再通过 OpenClaw Gateway 的 WebSocket 协议访问 Agent、记忆、配置与进化目标。本地 JSON 存储只保存连接身份、端点、审计历史与快照,用于重连、追踪和回滚。 -![ClawScope 系统架构图](public/images/diagrams/clawscope-system-architecture.svg) +![ClawScope 系统架构图](public/images/diagrams/clawscope-system-architecture-zh.svg) ## 快速开始 diff --git a/public/images/diagrams/clawscope-system-architecture-en.svg b/public/images/diagrams/clawscope-system-architecture-en.svg new file mode 100644 index 0000000..93bdc49 --- /dev/null +++ b/public/images/diagrams/clawscope-system-architecture-en.svg @@ -0,0 +1,217 @@ + + ClawScope system architecture + ClawScope consists of a React view layer, Tauri command bridge, Rust local capabilities, OpenClaw Gateway, and local JSON state stores. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ClawScope System Architecture + Local-first desktop control plane for OpenClaw memory visualization, configuration management, and evolution audit. + + + + + + + + + + + + + + + + + + + + ClawScope Desktop App / Tauri 2 runtime + + + React UI Layer + + + Rust Core Layer + + + External OpenClaw Runtime + + + + + Operator + Search / Audit / Config + Desktop workbench + + + + + + Shell + Router + Profile / Memory / Config + Evolution views + + + OpenClawContext + Connection / heartbeat / sessions + LAN discovery / saved endpoints + Unified frontend command entry + + + Domain Panels + Memory search / knowledge graph + Agent settings / config schema + Evolution preview + audit report + + + Browser localStorage + URL / auth mode / setup flags + + + + + + Tauri IPC + invoke(...) + gateway_* + evolution_* + + + + + + Gateway Orchestrator + commands + connector + WebSocket RPC / methods + + + Session State + active sessions / snapshots + pending request router + + + Auth + Discovery + device identity / signer + challenge / token fallback + + + Evolution Engine + preview / execute / rollback + + + + + + Gateway Store + id / tokens / endpoints + + + Evolution Store + history / audit / snapshots + + + + + + OpenClaw Gateway + ws://host:18789 + protocol verified endpoint + + + Agent Registry + agents / identity / workspace + + + Memory Runtime + MEMORY.md / daily memory + semantic search / timeline + index + diagnostics + + + Config Surface + agent settings / config schema + + + + + UI + views call context + commands + WebSocket RPC + challenge + signed connect + memory get/set/index + Local JSON state protects reconnect, audit, and rollback + + + Legend + + Frontend + + Rust backend + + Local store + + Security/auth + + IPC/runtime boundary + + Auth flow + + Data/control flow + + Source: README architecture overview, src/app/contexts/OpenClawContext.tsx, src-tauri/src/lib.rs, gateway/*, evolution/* + diff --git a/public/images/diagrams/clawscope-system-architecture-zh.svg b/public/images/diagrams/clawscope-system-architecture-zh.svg new file mode 100644 index 0000000..270c8b0 --- /dev/null +++ b/public/images/diagrams/clawscope-system-architecture-zh.svg @@ -0,0 +1,217 @@ + + ClawScope 系统架构图 + ClawScope 由 React 视图层、Tauri 命令桥、Rust 本地能力、OpenClaw Gateway 与本地 JSON 状态存储组成。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ClawScope 系统架构 + OpenClaw 记忆可视化、配置管理与进化审计的本地桌面控制面 + + + + + + + + + + + + + + + + + + + + ClawScope 桌面应用 / Tauri 2 运行时 + + + React 界面层 + + + Rust 核心层 + + + 外部 OpenClaw 运行时 + + + + + 操作者 + 搜索 / 审计 / 配置 + 桌面工作台 + + + + + + 外壳与路由 + Profile / Memory / Config + 进化视图 + + + OpenClawContext + 连接状态 / 心跳 / 会话列表 + 局域网发现 / 已保存端点 + 统一前端命令入口 + + + 领域面板 + 记忆搜索 / 知识图谱 / 足迹 + Agent 设置 / 配置 schema + 进化预览与审计报告 + + + 浏览器 localStorage + URL / 认证模式 / 设置标记 + + + + + + Tauri IPC + invoke(...) + gateway_* + evolution_* + + + + + + Gateway 编排器 + 命令与连接器 + WebSocket RPC / 方法 + + + 会话状态 + 活跃会话 / 快照 + 待处理请求路由 + + + 认证与发现 + 设备身份 / 签名器 + challenge / token fallback + + + 进化引擎 + 预览 / 执行 / 回滚 + + + + + + Gateway 存储 + id / tokens / endpoints + + + Evolution 存储 + history / audit / snapshots + + + + + + OpenClaw Gateway + ws://host:18789 + 协议验证端点 + + + Agent 注册表 + agents / identity / workspace + + + 记忆运行时 + MEMORY.md / daily memory + 语义搜索 / 时间线 + 索引与诊断 + + + 配置表面 + Agent 设置 / config schema + + + + + UI + 视图调用上下文 + 命令 + WebSocket RPC + challenge + signed connect + memory get/set/index + 本地 JSON 状态保障离线重连、审计与回滚 + + + 图例 + + 前端 + + Rust 后端 + + 本地存储 + + 认证/安全 + + IPC/运行时边界 + + 认证流 + + 数据/控制流 + + 来源:README 架构说明、src/app/contexts/OpenClawContext.tsx、src-tauri/src/lib.rs、gateway/*、evolution/* + diff --git a/public/images/diagrams/clawscope-system-architecture.html b/public/images/diagrams/clawscope-system-architecture.html index 2d543aa..eff6ba7 100644 --- a/public/images/diagrams/clawscope-system-architecture.html +++ b/public/images/diagrams/clawscope-system-architecture.html @@ -1,384 +1,90 @@ - + - - - - ClawScope System Architecture - - - - - - -
-
-
-
-

ClawScope System Architecture

-
-
- - - -
- -
-
-

OpenClaw 记忆可视化、配置管理与进化审计的本地桌面控制面

-
- -
- - ClawScope 系统架构图 - ClawScope 由 React 视图层、Tauri 命令桥、Rust 本地能力、OpenClaw Gateway 与本地 JSON 状态存储组成。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ClawScope System Architecture - OpenClaw 记忆可视化、配置管理与进化审计的本地桌面控制面 - - - - - - - - - - - - - - - - - - ClawScope Desktop App / Tauri 2 runtime - - React UI Layer - - Rust Core Layer - - External OpenClaw Runtime - - - Operator - 搜索 / 审计 / 配置 - 桌面工作台 - - - Shell + Router - Profile / Memory / Config - Evolution views - - OpenClawContext - 连接状态 / 心跳 / 会话列表 - LAN discovery / saved endpoints - 统一前端命令入口 - - Domain Panels - 记忆搜索 / 知识图谱 / 足迹 - Agent 设置 / 配置 schema - 进化预览与审计报告 - - Browser localStorage - URL / auth mode / setup flags - - - Tauri IPC - invoke(...) - gateway_* - evolution_* - - - Gateway Orchestrator - commands + connector - WebSocket RPC / methods - - Session State - active sessions / snapshots - pending request router - - Auth + Discovery - device identity / signer - challenge / token fallback - - Evolution Engine - preview / execute / rollback - - Gateway Store - identity / tokens / endpoints - - Evolution Store - history / audit / snapshots - - - OpenClaw Gateway - ws://host:18789 - protocol verified endpoint - - Agent Registry - agents / identity / workspace - - Memory Runtime - MEMORY.md / daily memory - semantic search / timeline - index + diagnostics - - Config Surface - agent settings / config schema - - - UI - views call context - commands - WebSocket RPC - challenge + signed connect - memory get/set/index - 本地 JSON 状态保障离线重连、审计与回滚 - - Legend - - Frontend - - Rust backend - - Local store - - Security/auth - - IPC/runtime boundary - - Auth flow - - Data/control flow - Source: README architecture overview, src/app/contexts/OpenClawContext.tsx, src-tauri/src/lib.rs, gateway/*, evolution/* - -
- -
-
-

用户看见的是控制面

-
    -
  • • React 负责 Profile、Memory、Config、Evolution 四类工作视图。
  • -
  • • OpenClawContext 将连接、心跳、会话与发现逻辑收束到一个入口。
  • -
  • • Browser localStorage 只保存界面级配置,不保存 Rust 审计状态。
  • -
-
-
-

本机 Rust 负责可信执行

-
    -
  • • Tauri IPC 将前端动作映射到 gateway_* 与 evolution_* commands。
  • -
  • • Gateway connector 维护 WebSocket 会话、请求路由与协议能力。
  • -
  • • Auth/Discovery 处理设备身份、签名连接、token fallback 与局域网发现。
  • -
-
-
-

进化流程可审计、可回滚

-
    -
  • • Evolution 先读取 MEMORY 文档生成 preview,再进入 execute。
  • -
  • • 本地 history、audit-log 与 snapshots 记录关键决策和恢复点。
  • -
  • • 执行后回写 OpenClaw memory,并触发 index 刷新。
  • -
-
-
- - -
- - - + + + +
+
+

ClawScope 系统架构图预览

+

+ README 使用两张语言专属 SVG:英文版 clawscope-system-architecture-en.svg, + 中文版 clawscope-system-architecture-zh.svg。旧的 + clawscope-system-architecture.svg 保留为英文兼容入口。 +

+
+ +
+

English

+ ClawScope system architecture +
+ +
+

中文

+ ClawScope 系统架构图 +
+
+ diff --git a/public/images/diagrams/clawscope-system-architecture.svg b/public/images/diagrams/clawscope-system-architecture.svg index 577b7c5..93bdc49 100644 --- a/public/images/diagrams/clawscope-system-architecture.svg +++ b/public/images/diagrams/clawscope-system-architecture.svg @@ -1,189 +1,216 @@ - ClawScope 系统架构图 - ClawScope 由 React 视图层、Tauri 命令桥、Rust 本地能力、OpenClaw Gateway 与本地 JSON 状态存储组成。 + ClawScope system architecture + ClawScope consists of a React view layer, Tauri command bridge, Rust local capabilities, OpenClaw Gateway, and local JSON state stores. - - - - - - - - - - - + - + - + + + + + + + + + + + + + + + + + + + - - - + + + + + + ClawScope System Architecture - OpenClaw 记忆可视化、配置管理与进化审计的本地桌面控制面 + Local-first desktop control plane for OpenClaw memory visualization, configuration management, and evolution audit. - - - - - - - - - - - - - - + + + + + + + + + + + + + + - - ClawScope Desktop App / Tauri 2 runtime + + ClawScope Desktop App / Tauri 2 runtime - - React UI Layer + + React UI Layer - - Rust Core Layer + + Rust Core Layer - + External OpenClaw Runtime - - Operator - 搜索 / 审计 / 配置 - 桌面工作台 + + + Operator + Search / Audit / Config + Desktop workbench + - - Shell + Router - Profile / Memory / Config - Evolution views - - - OpenClawContext - 连接状态 / 心跳 / 会话列表 - LAN discovery / saved endpoints - 统一前端命令入口 - - - Domain Panels - 记忆搜索 / 知识图谱 / 足迹 - Agent 设置 / 配置 schema - 进化预览与审计报告 - - - Browser localStorage - URL / auth mode / setup flags + + + Shell + Router + Profile / Memory / Config + Evolution views + + + OpenClawContext + Connection / heartbeat / sessions + LAN discovery / saved endpoints + Unified frontend command entry + + + Domain Panels + Memory search / knowledge graph + Agent settings / config schema + Evolution preview + audit report + + + Browser localStorage + URL / auth mode / setup flags + - - Tauri IPC - invoke(...) - gateway_* - evolution_* + + + Tauri IPC + invoke(...) + gateway_* + evolution_* + - - Gateway Orchestrator - commands + connector - WebSocket RPC / methods - - - Session State - active sessions / snapshots - pending request router - - - Auth + Discovery - device identity / signer - challenge / token fallback - - - Evolution Engine - preview / execute / rollback + + + Gateway Orchestrator + commands + connector + WebSocket RPC / methods + + + Session State + active sessions / snapshots + pending request router + + + Auth + Discovery + device identity / signer + challenge / token fallback + + + Evolution Engine + preview / execute / rollback + - - Gateway Store - identity / tokens / endpoints + + + Gateway Store + id / tokens / endpoints - - Evolution Store - history / audit / snapshots + + Evolution Store + history / audit / snapshots + - - OpenClaw Gateway - ws://host:18789 - protocol verified endpoint - - - Agent Registry - agents / identity / workspace - - - Memory Runtime - MEMORY.md / daily memory - semantic search / timeline - index + diagnostics - - - Config Surface - agent settings / config schema + + + OpenClaw Gateway + ws://host:18789 + protocol verified endpoint + + + Agent Registry + agents / identity / workspace + + + Memory Runtime + MEMORY.md / daily memory + semantic search / timeline + index + diagnostics + + + Config Surface + agent settings / config schema + - + UI views call context commands WebSocket RPC - challenge + signed connect - memory get/set/index - 本地 JSON 状态保障离线重连、审计与回滚 + challenge + signed connect + memory get/set/index + Local JSON state protects reconnect, audit, and rollback Legend - + Frontend - + Rust backend - + Local store - + Security/auth - + IPC/runtime boundary - + Auth flow - + Data/control flow Source: README architecture overview, src/app/contexts/OpenClawContext.tsx, src-tauri/src/lib.rs, gateway/*, evolution/*