从源码构建和改客户端

说明 界面负责交互，Tauri 和 Rust 连接系统和本地文件，Mihomo 负责代理与路由。客户端通过内核的控制接口读写运行状态。出了问题，先分清是界面、桌面层，还是内核。

注意 Linux 上的包名会变。当前贡献文档用 Ubuntu 举例，列出了 WebKitGTK、Ayatana AppIndicator、librsvg 和 patchelf。Windows ARM 还需要 LLVM 或 clang。以仓库里最新的 CONTRIBUTING.md 为准。

1. 克隆仓库

   克隆之后进入项目目录。

2. 安装前端依赖

   仓库用 pnpm。换成 npm 或 yarn，锁文件很容易冲突。

3. 准备内核和运行文件

   运行项目的 prebuild，下载当前系统要用的 Mihomo，以及 service、sidecar 这些运行文件。

4. 启动开发模式

   pnpm dev 是平时的开发命令。要直接跑 Tauri 的开发模式，用仓库里的 pnpm dev:tauri。

5. 生成当前平台构建

   pnpm build 打出当前系统的安装包。仓库里的 pnpm build:fast 可以用来做更快的本地测试包。

# 1. 克隆仓库
git clone https://github.com/clash-verge-rev/clash-verge-rev.git
cd clash-verge-rev

# 2. 启用包管理器并安装依赖
corepack enable
pnpm install

# 3. 下载 Mihomo 内核与运行时资源
pnpm run prebuild
# 需要重新下载时：
# pnpm run prebuild --force

# 4. 启动 Clash Verge 开发环境
pnpm dev
# 可选：pnpm dev:tauri

# 5. 构建当前平台
pnpm build
# 快速测试构建：pnpm build:fast

说明 这个仓库用 pnpm 管前端依赖。开发前先执行 pnpm run prebuild，把内核和服务文件准备好。命令以后可能改，所以同时核对 package.json 与 CONTRIBUTING.md。

clash-verge-rev/
├─ src/                    # React + TypeScript 前端
├─ src-tauri/              # Tauri 2 + Rust 桌面应用层
│  ├─ src/                 # Rust 业务与系统集成代码
│  ├─ resources/           # 应用运行资源
│  ├─ sidecar/             # Mihomo 等外部二进制资源
│  ├─ Cargo.toml           # Rust 依赖
│  └─ tauri.conf.json      # Tauri 构建、应用标识与打包配置
├─ scripts/                # prebuild、版本与发布辅助脚本
├─ .github/                # CI / GitHub Actions
├─ package.json            # 前端依赖与 pnpm scripts
├─ CONTRIBUTING.md         # 官方贡献与开发环境说明
└─ UPDATELOG.md            # 版本更新记录

说明 目录会随分支变，上面只帮你建立层级。改之前直接看当前仓库。改界面文案时，把各语言文件一起改，并跑项目要求的格式和检查。

import { invoke } from "@tauri-apps/api/core";
import { listen } from "@tauri-apps/api/event";

// 调用 Rust 侧已经注册的 Tauri 命令
const result = await invoke("command_name", {
  payload: { key: "value" },
});

// 监听 Rust 侧事件
const unlisten = await listen("event-name", (event) => {
  console.log(event.payload);
});

// 页面或组件卸载时取消监听
unlisten();

// 示意：Rust 侧通过 #[tauri::command] 暴露命令
#[tauri::command]
fn command_name(payload: serde_json::Value) -> Result<serde_json::Value, String> {
    Ok(payload)
}

fn main() {
    tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![command_name])
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

注意 上面的代码只说明 Tauri 的 invoke 和事件的通信方式，不是当前项目里的真实命令名。做具体功能时，从界面上的调用追到 src-tauri 里真正注册的命令和事件。

# 示例地址：请替换为 Clash Verge 当前实际的 external-controller
BASE=http://127.0.0.1:9090
AUTH="Authorization: Bearer 你的-secret"

# 读取 Mihomo 版本与当前配置
curl -H "$AUTH" "$BASE/version"
curl -H "$AUTH" "$BASE/configs"

# 修改运行模式：rule / global / direct
curl -X PATCH -H "$AUTH" -d '{"mode":"rule"}' "$BASE/configs"

# 查看代理与策略组
curl -H "$AUTH" "$BASE/proxies"

# 查看活动连接
curl -H "$AUTH" "$BASE/connections"

# 实时流量与日志可使用 GET / WebSocket
# ws://127.0.0.1:9090/traffic?token=你的-secret
# ws://127.0.0.1:9090/logs?level=info&token=你的-secret

注意 例子里的端口只是演示。Clash Verge 实际端口以当前配置为准。 external-controller 这个接口权限很高。调试时尽量只监听本机，并设置一串可靠的 secret。

说明 应用标识写在 src-tauri/tauri.conf.json 里，但真实路径仍可能因系统和构建渠道不同。调试时优先用客户端里的「应用目录 / 日志目录」入口，改文件之前先备份。

1. 先说清楚要改什么

   改动大、或者会改变行为时，先在 Issue 或 Discussion 里对齐。修一个已经说清楚的问题，也要带上原来的讨论。

2. 从自己的分支改

   一个分支只做一件事，名字能看出意图，例如 fix/tray-menu-crash。

3. 跑检查，并在本地验证

   前端跑 pnpm lint，Rust 侧跑 cargo clippy-all，再用 cargo fmt / pnpm format 把格式对齐。

4. 提交需要签名

   贡献说明要求提交经过签名。说明写清楚，一次提交尽量只做一件事。

5. 在 PR 里写你怎么验证的

   写上系统环境、改了什么、怎么验证的。改了界面就附截图。改了行为就写复现步骤和测试方法。

注意 项目是 GPL-3.0。提交代码，就是按同一协议授权。新增依赖时，在 PR 里说明为什么需要，以及协议是否兼容。

说明 GitHub Releases 是公开发布的地方。自己编译的包要写清来源和构建环境。在客户端里切换 Mihomo 稳定版或 Alpha，不是在换 Clash Verge 的发布渠道。