使用指南

Profiles Enhanced Mode 增强模式

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

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 配置变更：

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 这些增强配置，且已经启用了，则会按顺序进行链式处理。即前一个处理的结果作为下一个处理的输入。