---
url: https://clashvergerev.com/guide.md
description: >-
  Clash Verge Rev的使用指南包括Profiles Enhanced
  Mode（增强模式），支持远程配置、本地配置、合并处理和脚本处理等配置文件类型。你可以通过创建和编辑配置文件来导入配置、刷新配置和修改配置，按照指定的处理流程进行配置操作。
---

# 使用指南

## Profiles Enhanced Mode 增强模式

目前支持 4 种类型的配置文件，分别是 `Remote`、`Local`、`Script`、`Merge`。其中，`Remote` 和 `Local` 类型为 **主配置文件**，`Script` 和 `Merge` 类型为 **增强配置文件**，用于修改主配置文件的。点 `新建` 可以创建这些配置文件（如下图），对于 `Remote` 类型的，也可以直接输入 URL 后导入即可。 （备注：该模式主要参考了 CFW 的实现）

![image](/assets/3.png)

### Remote 远程配置

目前仅支持 clash 格式的配置链接，即响应体数据是符合 clash 配置格式的（utf8 编码）。如果响应头中存在 `Subscription-Userinfo` 字段，则其对应的流量信息会展示出来。远程配置可以点击右上角的更新按键自动更新。

### Local 本地配置

新建本地配置之后，`右键 \- 打开文件` 即可打开对应的本地配置文件（默认会用 VScode 打开，如果找不到执行程序则用默认编辑器打开）。在编写完本地配置之后`右键 \- 使用` 即可刷新该配置。

### Merge 合并处理

该配置类型用于对主配置进行字段增加的操作，文件格式是 ·yaml·。该 idea 源于 CFW 配置预处理中的简便方法。目前仅支持 6 种操作类型。启用方法：`右键 \- 启用`，在修改了文件之后，点击刷新触发配置变更。

* prepend-rules：类型和 `clash rules` 配置一致，内容合并到 rules 前
* append-rules：类型和 `clash rules` 配置一致，内容合并到 rules 后
* prepend-proxies：类型和 `clash proxies` 配置一致，内容合并到 proxies 前
* append-proxies：类型和 `clash proxies` 配置一致，内容合并到 proxies 后
* prepend-proxy-groups：类型和 `clash proxy-groups` 配置一致，内容合并到 proxy-groups 前
* append-proxy-groups：类型和 `clash proxy-groups` 配置一致，内容合并到 proxy-groups 后
* 其他 clash 的字段：5 个默认使用的字段(`rules`, `proxies`, `proxy-groups`, `proxy-providers`, `rule-providers`)以及其他 clash-meta 支持的字段，直接设置这些字段将直接覆盖 profile 对应字段的内容。

### Script 脚本处理

该配置类型提供编写 JS 脚本修改配置的能力，JS 运行时为 `quickjs`。该 idea 源于 CFW 配置预处理中的 Mixin/parser。启用方法：`右键 \- 启用`，在修改了文件之后，点击刷新重置配置文件。

脚本中需要声明一个 main 函数，函数签名为 `main(params: object): object;`。函数入参为序列化为 js object 的 clash 配置，务必返回处理后的 js object。

如果脚本中存在异常未处理，处理程序将跳过该脚本所做的操作，并且对应的 profile 项将变红和报错提示。

脚本执行环境采用 quickjs 实现，不能执行如文件系统访问等操作。

例如，处理 ws 配置变更：

```javascript
function main(config) {
  if (!config.proxies) return config;

  config.proxies.forEach((proxy) => {
    if (proxy.network === "ws" && (proxy["ws-path"] || proxy["ws-headers"])) {
      const opts = proxy["ws-opts"] || {};

      opts.path = proxy["ws-path"];
      opts.headers = proxy["ws-headers"];

      delete proxy["ws-path"];
      delete proxy["ws-headers"];
    }
  });

  return config;
}
```

### Profiles 的处理流程

首先选择一个主配置文件，如果没有就是默认的空配置。其次如果存在 `Script` 和 `Merge` 这些增强配置，且已经启用了，则会按顺序进行**链式处理**。即前一个处理的结果作为下一个处理的输入。
