refactor(new merge) (#369)

Co-authored-by: paisley <8197966+su8su@users.noreply.github.com>
Co-authored-by: zuolingxuan <zuolingxuan@bytedance.com>
This commit is contained in:
Lingxuan Zuo
2026-03-09 20:18:25 +08:00
committed by GitHub
Unverified
parent e28eba01e1
commit 3d664c017a
18 changed files with 514 additions and 390 deletions

View File

@@ -145,7 +145,6 @@ pnpm run init
# 以开发模式启动
pnpm dev
```
### 首次启动
首次启动 ClawX 时,**设置向导** 将引导你完成以下步骤:
@@ -176,7 +175,6 @@ ClawX 内置了代理设置,适用于需要通过本地代理客户端访问
```text
代理服务器: http://127.0.0.1:7890
```
说明:
- 只填写 `host:port` 时,会按 HTTP 代理处理。
@@ -190,8 +188,7 @@ ClawX 内置了代理设置,适用于需要通过本地代理客户端访问
ClawX 采用 **双进程 + Host API 统一接入架构**。渲染进程只调用统一客户端抽象,协议选择与进程生命周期由 Electron 主进程统一管理:
```
┌─────────────────────────────────────────────────────────────────┐
```┌─────────────────────────────────────────────────────────────────┐
│ ClawX 桌面应用 │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
@@ -235,7 +232,6 @@ ClawX 采用 **双进程 + Host API 统一接入架构**。渲染进程只调用
│ • 供应商抽象层 │
└─────────────────────────────────────────────────────────────────┘
```
### 设计原则
- **进程隔离**AI 运行时在独立进程中运行,确保即使在高负载计算期间 UI 也能保持响应
@@ -272,34 +268,31 @@ ClawX 采用 **双进程 + Host API 统一接入架构**。渲染进程只调用
### 项目结构
```ClawX/
├── electron/ # Electron 主进程
│ ├── api/ # 主进程 API 路由与处理器
│ │ └── routes/ # RPC/HTTP 代理路由模块
│ ├── services/ # Provider、Secrets 与运行时服务
│ │ ├── providers/ # Provider/account 模型同步逻辑
│ │ └── secrets/ # 系统钥匙串与密钥存储
│ ├── shared/ # 共享 Provider schema/常量
│ │ └── providers/
│ ├── main/ # 应用入口、窗口、IPC 注册
│ ├── gateway/ # OpenClaw 网关进程管理
│ ├── preload/ # 安全 IPC 桥接
│ └── utils/ # 工具模块(存储、认证、路径)
├── src/ # React 渲染进程
│ ├── lib/ # 前端统一 API 与错误模型
│ ├── stores/ # Zustand 状态仓库settings/chat/gateway
│ ├── components/ # 可复用 UI 组件
│ ├── pages/ # Setup/Dashboard/Chat/Channels/Skills/Cron/Settings
│ ├── i18n/ # 国际化资源
│ └── types/ # TypeScript 类型定义
├── tests/
│ └── unit/ # Vitest 单元/集成型测试
├── resources/ # 静态资源(图标、图片)
└── scripts/ # 构建与工具脚本
```
ClawX/
├── electron/ # Electron 主进程
│ ├── main/ # 应用入口、窗口管理
│ ├── gateway/ # OpenClaw 网关进程管理
│ ├── preload/ # 安全 IPC 桥接脚本
│ └── utils/ # 工具模块(存储、认证、路径)
├── src/ # React 渲染进程
│ ├── components/ # 可复用 UI 组件
│ │ ├── ui/ # 基础组件shadcn/ui
│ │ ├── layout/ # 布局组件(侧边栏、顶栏)
│ │ └── common/ # 公共组件
│ ├── pages/ # 应用页面
│ │ ├── Setup/ # 初始设置向导
│ │ ├── Dashboard/ # 首页仪表盘
│ │ ├── Chat/ # AI 聊天界面
│ │ ├── Channels/ # 频道管理
│ │ ├── Skills/ # 技能浏览与管理
│ │ ├── Cron/ # 定时任务
│ │ └── Settings/ # 配置面板
│ ├── stores/ # Zustand 状态仓库
│ ├── lib/ # 前端工具库
│ └── types/ # TypeScript 类型定义
├── resources/ # 静态资源(图标、图片)
├── scripts/ # 构建与工具脚本
└── tests/ # 测试套件
```
### 常用命令
```bash
@@ -322,7 +315,6 @@ pnpm package:mac # 为 macOS 打包
pnpm package:win # 为 Windows 打包
pnpm package:linux # 为 Linux 打包
```
### 技术栈
| 层级 | 技术 |