路由台 · 面向 Clash Verge / mihomo 的本地可视化规则工作台
看清每一次访问的「域名 → 规则 → 出口 → 节点」,把复杂的分流配置变成可观察、可拖拽、可校验的工作流。
演示数据均为假节点。链路编辑器生成的是独立节点,不会改变中转和落地节点原本的流量。
本地 Web 工作台与 Windows 桌面版均已可用。桌面版由 Tauri 2 + Rust 驱动,不启动 Node 服务,不使用 Electron 或 Node sidecar。当前安装包未做代码签名,Windows SmartScreen 可能提示未知发布者。
Clash 的规则通常散落在订阅、策略组、rule-providers 和多份 YAML 中。改一条规则往往要猜:它是否命中、指向哪个出口、最后走了哪个节点。
Clash RuleVis 是一个只在本机运行的可视化路由工作台。它连接正在运行的 mihomo 控制器,实时展示访问路径,并允许你直接拖拽域名生成规则、管理出口、整理规则顺序,最后导出或应用一份经过校验的完整 YAML。
默认使用安全模式,这也是产品的核心约束:
- 不修改 Clash Verge 的配置或 profile
- 不触发内核配置重载
- 导出文件只写入本工具目录,由你手动导入 Verge
- 控制器密钥与订阅信息只保存在本机
如果你确实想让规则直接生效,可以在桌面版手动开启实时模式,再点击顶栏的「应用到 Clash Verge」。实时模式使用一个专用的本地 profile,写入前自动备份,绝不修改你的订阅 profile。
截图使用 demo/workspace.json 中的演示数据,不包含真实订阅或节点地址。
- 通过 WebSocket 实时展示活跃连接、速率、流量和进程信息
- 展开任意一条连接,查看「域名 → 命中规则 → 出口策略组 → 最终节点」
- 支持同一域名的多个规则变体与命中次数
- 把域名直接拖到右侧出口或节点上,生成一条目标明确的新规则
- 暂停 / 继续实时流收在 STREAM 状态旁,不占用页面标题区
- 出口/节点标签和搜索固定,目标列表独立滚动
- 内置 MetaCubeX
meta-rules-dat的全量规则目录:1920 条 geosite + 260 条 geoip - 常用服务、平台和地区提供中文名与简短说明
- 12 组推荐组合:AI、流媒体、海外社交、开发工具、Google、Telegram、国内直连、广告拦截、游戏平台、私有网络、Apple、微软
- 支持中文/英文/域名搜索、分类筛选、批量选择和指定目标出口
- 规则目录按需加载,不进入首屏主包
- 从节点工具栏的「添加来源」打开单层弹窗;一次可以添加多条来源,每行自动识别订阅链接、YAML 配置或节点链接,点下方 + 继续加
- 在空输入框里直接粘贴节点链接或配置会自动识别并导入,「粘贴并添加」按钮也可直接读取剪贴板
- 支持直接粘贴节点分享链接并自动识别:
ss://(含百分号编码用户信息)、ssr://、vmess://、vless://、trojan://、hysteria2://、tuic://、socks5:// - 仍支持本地 YAML / 文本文件与直接读取 Clash Verge 当前配置
- Reality、obfs 等常用高级参数会随链接一并保留
- 默认点击节点行不会勾选;点工具栏「选择」进入批量模式后,点击节点行即可勾选,顶部批量栏支持启用、禁用、加标签、加入出口和全选
- 直链添加的节点统一归入「节点链接」来源;删除来源最后一个节点时来源一起移除
- 节点批量启用/禁用、标签管理、按来源筛选;关闭节点会自动从出口的直接成员中移除,避免阻塞导出
- 标签、来源筛选控件保持固定宽度,搜索框不会随筛选出现/消失而伸缩
- 单节点测速与全部测速;失败/禁用/重复节点组合筛选,支持一键合并重复配置
- 一键刷新全部订阅与 Verge 来源;显示最近更新、剩余流量和到期时间
- 最近一次测速结果保存在本地,刷新页面后仍可查看
- 独立的「链路」页面:左侧选中转、右侧选落地,最右侧输入新节点名
- 节点可按来源(订阅、文件、节点链接等)筛选和搜索
- 生成的是一个新的独立节点,使用 mihomo
dialer-proxy指向前置中转;不会修改中转、落地节点的原有流量 - 新节点自动出现在节点池,可被出口和规则直接引用
- 中转节点失效或禁用时,导出校验会阻止继续导出
- 已生成的链路可单独删除,删除链路不会影响中转和落地节点
- 出口对应 mihomo 策略组,支持
select、url-test、fallback、load-balance - 成员可以手选节点、按标签、按名称正则,或嵌套其他出口
- 出口编辑器支持「批量选节点」,一次把多个已有节点加入当前出口;节点页的批量栏也可以把选中节点直接加入现有出口
- 模板菜单显示每个模板当前匹配的节点数;没有匹配的模板会打开编辑器并提示批量选节点,另有「自选节点」模板可直接从已有节点开始
- 出口行悬停可直接删除;引用它的规则/嵌套成员会一并处理,并自动创建可撤销快照
- 导出时静态展开成员,行为可预期,不依赖内核版本对 filter 语法的支持
- 规则优先级统一在一个列表中管理:拖动排序,单条规则、规则集和订阅规则按顺序匹配
- 支持按来源折叠、组内筛选、批量启用/停用/删除
- 规则集行内展示最近命中的域名和最终节点,可展开查看命中详情
- 支持筛选目标已失效或内核累计零命中的规则,一键清理失效目标
- 实时连接右键可快速生成「直连 / 拒绝 / 走收藏出口」规则
- 自动合并 Verge 当前运行时基础设置(端口、DNS、TUN、sniffer 等),排除控制器与密钥
- 导出前进行引用、空出口、重复/遮蔽规则检查
- 可用
verge-mihomo -t对完整配置做真实内核语法校验 - 生成完整 YAML、与上次导出的 diff、历史快照与一键恢复
- 历史快照收进顶栏下拉:选择快照、查看恢复前后差异、底部一键恢复
- 校验失败时自动打开导出详情并高亮错误
- YAML 占满工作区,代码区域独立滚动
- 导出前弹窗确认文件名,确认后才写入;完成后可直接导入 Clash Verge 或复制临时订阅地址
- 设置内显示导出文件数量与占用,可清理 30 天前且未被历史引用的 YAML
- 默认仍是安全模式;只有你主动切换并确认后才会进入实时模式
- 创建一个专用本地 profile「Clash RuleVis 实时」,保留当前节点、策略组与排序,不改订阅 profile
- 修改规则后不会逐条自动写入;点击顶栏「应用到 Clash Verge」才会合并当前配置
- 应用前自动备份旧 profile,并在 mihomo 可用时校验完整配置;应用时会重载内核,可能短暂断线
- 内核未连接时禁止应用;Verge 当前 profile 被切走时会暂停并提示
- 关闭实时模式会切回原 profile 并恢复进入实时模式前的配置
- 实时模式复制的是当前节点与规则快照;订阅更新后需在节点页刷新并重新应用
实时模式只在手动点击「应用到 Clash Verge」时写入专用本地 profile。
Ctrl / Cmd + K全局命令面板,可跳转节点、出口、链路、规则、历史版本和设置- 添加来源收进节点工具栏;单层弹窗内用多行输入批量添加,每行自动识别类型,导入完成即回节点表
- 无大标题、无大卡片,桌面与移动端都保持紧凑布局
- 长列表统一在内部滚动,页面本身不跟随列表滚动
- 页面切换使用轻微上浮淡入和顶栏页名过渡;单色黑白灰界面通过实心块、描边、虚线、反色和字号字重表达层级,面板、工具栏、表头、按钮与输入框保留分层阴影、细边框和内高光
- 工作区 JSON 备份 / 恢复(包含订阅地址与节点凭据,请只保存在本机)
- 本地会话 Cookie、Origin 白名单、仅监听
127.0.0.1
flowchart LR
V[Clash Verge Rev / mihomo] -->|Named pipe / TCP controller| B[Fastify service<br/>127.0.0.1:4780]
B -->|REST + WebSocket| U[React workspace<br/>Vite]
U -->|导入 / 编辑 / 导出| D[(./data<br/>local only)]
B -->|verge-mihomo -t| K[Kernel validation]
- 前端:React 19、TypeScript strict、Vite 8、Zustand、dnd-kit、TanStack Virtual
- 后端:Fastify 5、WebSocket、YAML parser、undici
- 数据:本机 JSON 工作区 + 文件系统历史快照,不依赖数据库
- 内核:Windows 下自动枚举 mihomo 命名管道,也支持手动 TCP controller
rust/rulevis-core 是桌面版的内核地基,目前已经完成:
- Workspace v2 的 serde 模型与工作区规范化(手动来源合并、链路
dialer-proxy同步、禁用节点成员清理、内置出口与 MATCH 修复)。 - YAML 生成器:节点、出口、规则集 provider、规则优先级、同名/空出口/嵌套环/覆盖规则等校验,issues 与 counts 和 TypeScript 版一致。
- 8 种分享链接解析:SS / SSR / VMess / VLESS / Trojan / Hysteria2 / TUIC / SOCKS5,包含 percent-encoded SS、Reality、ws/grpc、obfs 等参数。
- CLI:
check、generate、normalize、parse-link。
Web 端仍使用 Fastify;桌面端通过 Tauri IPC 直接调用 Rust,不启动本地 HTTP 服务,也不带 Node sidecar。parity 测试以 fixtures 为语言无关契约,YAML 比较的是解析后的语义结构而非缩进。
cd rust
cargo fmt --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo run -p rulevis-core -- check ../demo/workspace.jsonGitHub Actions 会运行 Rust 核心与桌面 API 测试,并在 Windows runner 上检查 Tauri 壳编译。npm run desktop:build 会生成 release 二进制与 NSIS 安装包。Windows 构建前置条件是 MSVC Build Tools、Windows SDK 和 WebView2。
从 GitHub Releases 下载最新的 Clash.RuleVis_x.x.x_x64-setup.exe(NSIS,当前用户安装)。安装包未签名,SmartScreen 可能提示未知发布者;Release 页面会提供 SHA256,可自行校验。
桌面数据保存在 %APPDATA%\io.github.youbilin.clash-rulevis(可用 CRS_DATA_DIR 覆盖),与 Web 版的 data/ 相互独立。首次使用可在设置中导入 Web 版工作区 JSON 备份。
桌面版保留同一套 React UI,由 Rust 负责本地 API:
- 独立工作区存储、版本冲突、历史快照/恢复与工作区备份导入。
- 订阅链接、YAML 粘贴、本地文件和 Verge 当前 profile 导入;来源刷新、流量/到期信息。
- 手动节点链接、节点与出口编辑、链式代理、规则库批量添加、规则集文件/URL 检查与刷新。
- mihomo 控制器自动发现:TCP controller 与 Windows 命名管道;连接设置、重新探测、节点/出口测速。
- 实时连接聚合:域名、规则命中、出口/节点、进程、速率与历史曲线。
- 完整 YAML 预览、diff、真实
verge-mihomo -t校验、安全导出与历史恢复。 - 一键导入 Clash Verge:导出后生成本机临时订阅地址,并调用
clash://install-config触发 Verge 导入;也可复制地址手动添加。 - 只读读取 Verge 当前 profile 的端口 / DNS / TUN 等基础设置。
- 实时模式:创建并切换到专用本地 profile,手动应用当前配置,写入前备份、应用后重载内核,可一键切回原 profile;工作区改动后顶栏会提示有未应用更改。
- 系统托盘与单实例:关闭窗口时选择最小化到托盘或直接退出;再次启动会聚焦已有窗口。最小化后暂停后台实时轮询,恢复窗口后继续,托盘菜单可重新打开主窗口或退出。
npm run desktop:dev # 启动 Tauri 窗口 + Vite
npm run desktop:check # Rust 编译检查
npm run desktop:build # 构建 release + NSIS 安装包Windows 构建前置:Rust stable、MSVC Build Tools 的 C++ 工作负载、Windows SDK 10、WebView2 Runtime;运行实时功能需要 Clash Verge Rev / mihomo。
安全边界:默认安全模式不直接写入 Verge 配置文件、不重载内核;只有你主动开启实时模式并点击应用时,才会写入专用本地 profile 并重载内核,写入前会备份到应用数据目录。订阅信息和控制器密钥不会出现在导出 YAML。桌面版平时只使用 Tauri IPC;点击「导入到 Clash Verge」时才会在 127.0.0.1 随机端口临时提供当前导出的 YAML,使用随机 token、30 分钟过期,随后点击/复制地址由 Verge 完成导入。当前安装包未签名,自动更新与代码签名属于下一阶段。
- Node.js 22+
- Windows 10/11(当前 Verge 命名管道探测以 Windows 为主;TCP 控制器可跨平台)
- Clash Verge Rev / mihomo(可选,离线也能编辑配置)
npm install
npm run demo访问 http://127.0.0.1:4781。演示使用独立的 .demo-data 和 demo/workspace.json,不会读写你的 data/,也不会上传任何信息。
npm install
npm run dev- Web UI:http://127.0.0.1:5273
- 本地 API:http://127.0.0.1:4780
npm run build
npm start生产模式由 Fastify 托管 dist/,访问 http://127.0.0.1:4780。
默认数据保存在项目下的 data/:
data/
├── workspace.json # 工作区
├── history/ # 历史快照
├── exports/ # 导出的 YAML
└── rule-sets/ # 本地规则集缓存
可以通过环境变量 CRS_DATA_DIR 指定其他本地目录。data/ 已在 .gitignore 中排除。
- 导入节点:订阅、YAML、节点链接,或直接读取 Verge 当前配置。
- 建立出口:把节点按用途组合成出口,例如「家宽」「AI 服务」「看视频」。
- 添加规则:从中文规则库选择组合,或在实时连接页把域名拖到出口/节点。
- 整理优先级:拖动排序,批量启停或删除,按来源折叠检查。
- 导出或应用:安全模式导出完整 YAML 后手动导入;实时模式在桌面版顶栏点击「应用到 Clash Verge」,写入专用本地 profile 并重载内核。
npm run dev # 同时启动 Fastify 与 Vite
npm run demo # 构建后用演示数据启动生产版,访问 :4781
npm run dev:server # 仅启动本地 API
npm run dev:web # 仅启动前端
npm run typecheck # 前端 + 后端类型检查
npm test # 40 项单元测试
npm run test:e2e # 构建后用临时数据目录跑 Playwright 冒烟
npm run build # 类型检查 + 生产构建
npm start # 运行生产服务
npm run rust:test # Rust 核心 + 桌面 API 测试
npm run rust:lint # Rust fmt + clippy
npm run desktop:dev # Tauri 2 桌面版
npm run desktop:check # 桌面壳编译检查
npm run desktop:build # release + NSIS 安装包test:e2e 会使用系统临时数据目录和本机 Chrome 跑一次完整冒烟,不触碰当前 data/;如果 Chrome 不在默认位置,可设置 CHROME_PATH。
src/
├── components/ # 公共组件、导入器、规则目录、命令面板
├── pages/ # 实时连接、节点、出口、链路、规则集、导出
├── store/ # 工作区、实时数据、UI 状态
├── lib/ # 节点链接解析、撤销、格式化
├── data/ # 生成的 MetaCubeX 规则目录
└── styles/ # Design tokens 与最终样式层
server/
├── app.ts # API 与 WebSocket
├── aggregator.ts # 连接流聚合
├── kernel.ts # mihomo 控制器适配
├── exporter.ts # YAML 导出
├── mihomo-validator.ts# 真实内核校验
├── generator.ts # 配置生成与校验
└── tests/ # node:test 单元测试
tests/e2e/ # Playwright 临时目录冒烟测试
demo/ # 无敏感数据的演示工作区
docs/assets/ # README 截图与演示 GIF
shared/ # 前后端共享类型与解析模型
scripts/ # 规则目录、演示与截图脚本
rust/rulevis-core/ # 工作区规范化、YAML 生成、链接解析
rust/rulevis-app/ # 桌面存储、历史、导出与 API(可独立测试)
src-tauri/ # Tauri 2 壳,仅负责窗口与 IPC
fixtures/ # TypeScript ↔ Rust 的 parity 契约
- v0.2:本地 Web 工作台、完整规则/出口/链路/导出闭环、自动刷新与备份。
- v0.3:Tauri 2 + Rust 桌面版;订阅/YAML 导入、内核 TCP/命名管道、实时连接、测速、规则集、mihomo 校验与 NSIS 安装包全部落地。
- v0.6.0(当前):桌面单实例、实时模式未应用更改提示、最小化到托盘后暂停后台实时轮询;保留 0.5.0 的单色视觉系统。
- Rust 地基:
rulevis-core与rulevis-app共 33 项自动化测试,覆盖 fixture 语义对齐、桌面 API、实时 profile 合并/恢复、工作区指纹与内核重载请求;另有 1 项可选的真实控制器冒烟测试。 - 下一步:代码签名、自动更新、多跳链路与 Proxy Provider。
- 边界:安装包目前只提供 Windows x64;不会用 Electron 或 Node sidecar 冒充桌面版。
- 再评估:只有在 WebView 被证明是瓶颈时,才考虑用 Rust 重写 UI;纯 Rust UI 不是当前目标。
- 默认安全模式只生成配置,不自动写入 Verge 或重载内核;实时模式也必须手动点击应用,且只写 Clash RuleVis 专用本地 profile。
- 实时模式会快照开启时的节点与规则,订阅更新不会自动同步进实时 profile;请在节点页刷新后重新应用。
- Verge 界面可能需要重启后才能显示新的当前 profile;内核与本地 profile 文件会立即更新。
- 订阅不会在后台持续自动刷新;可手动刷新单个来源或一键刷新全部。
- 链路编辑器当前生成单跳链式节点,不支持把链式节点再次作为中转或落地。
- Windows 命名管道自动发现优先支持 Clash Verge Rev;其他内核可通过 TCP controller 手动连接。
- 规则目录来自 MetaCubeX,冷门条目可能保留上游英文名。
- Windows 安装包目前未签名,且只提供 x64;实时连接、测速需要本机运行 Clash Verge Rev / mihomo。
- 所有数据、订阅地址、节点信息与控制器密钥都只保存在本机。
- Web 服务仅监听
127.0.0.1,并使用本地会话 Cookie 与 Origin 白名单;桌面版平时只用 Tauri IPC,导入 Verge 时才临时监听随机回环端口。 - 临时分享链接使用随机 token,30 分钟有效,仅提供当前导出的 YAML。
- 不发送遥测,不接入第三方分析服务。
- 导出的 YAML 不包含
external-controller与secret。 - 桌面版工作区、历史、导出和密钥设置保存在应用数据目录,请按敏感数据保管。
- 实时模式的 profile 备份位于应用数据目录的
verge-backups/,包含节点凭据与完整配置,同样属于敏感文件。
- 代码以 MIT 许可发布。
- 安全报告请走 SECURITY.md,不要在公开 issue 粘贴真实订阅、节点凭据或控制器 secret。
- 开发约定和本地检查见 CONTRIBUTING.md,版本变化见 CHANGELOG.md。
- linux.do — 中文技术社区,感谢社区提供的交流、反馈与推广支持
- MetaCubeX/meta-rules-dat — geosite / geoip 规则数据
- MetaCubeX/mihomo — 内核与控制器 API
- Clash Verge Rev — 运行时配置与使用场景
- React、Vite、Fastify、dnd-kit、TanStack Virtual、lucide-react
如果这个项目对你有帮助,欢迎 Star、提 Issue 或提交 PR。安全、本地优先的 Clash 工具值得被更多人看见。






