Quantumult 是一个功能强大的自动化工具，适用于软件开发、测试、部署等多个场景。以下是一些常见的配置教程，帮助你快速上手 Quantumult

安装 Quantumult

1 安装 Java

Quantumult 是基于 Java 的工具，所以首先需要安装 Java Development Kit (JDK)。

• 下载 Java JDK：访问 Oracle官方网站 或 Java 11+ 开源镜像.
• 安装 Java：

  # Linux/macOS
  sudo ln -s /path/to/jdk-11.x/bin/java /usr/bin/java
  # Windows
  C:\> cd "C:\Program Files\Java\jdk-11.x\bin"

• 验证 Java 版本：

  java -version

2 安装 Quantumult

• 下载 Quantumult 的最新版本：访问 Quantumult 官方网站.
• 安装 Quantumult：
  • Linux/macOS：

    sudo ln -s /path/to/quantumult-1.x.. /usr/bin/quantumult

  • Windows：

    双击安装文件,按照提示完成安装。

• 验证 Quantumult 是否安装成功：

  quantumult -version

3 配置环境

• 编辑 quantumult.properties：

  # 示例配置文件
  quantumult.java.home=/path/to/jdk-11.x
  quantumult.base.dir=/path/to/your/project
  quantumult.default.encoding=UTF-8

基本使用

1 创建项目

• 在 Quantumult 中，右键新建文件：
  • File Type：选择 Quantumult File。
  • Content：输入你的自动化任务代码（如 Groovy、Python、JavaScript）。
• 保存文件到项目目录中。

2 配置依赖

• 添加 Maven 依赖：
  • 在文件的顶部添加：

    import org.quantumult.*
    @QuantumultConfig(
        tools: ["maven"],
        maven.home: "/path/to/maven"
    )

  • 如果需要其他依赖，添加到 dependencies 列表中。

3 运行任务

• 右键项目文件，选择 Run with Quantumult。
• 在 Quantumult 界面中，设置任务参数（如工作目录、环境变量等），然后点击 Run。

高级配置

1 自定义规则

• 在项目文件中，使用 Quantumult 的规则定义自动化任务。

  import org.quantumult.*
  @QuantumultConfig(
      tools: ["ssh"],
      ssh.exec.command: "your_command"
  )
  def task = {
      input:
          from: "local",
          into: "file.txt"
      }
      output:
          to: "remote",
          file: "file.txt"
  }

• 保存文件后，右键项目文件选择 Run with Quantumult,即可执行任务。

2 集成到 IDE

• IntelliJ IDEA：
  • 安装 quantumult-idea 插件。
  • 在 IDEA 中，选择 File > Settings > Plugins，搜索 quantumult-idea,安装插件。
• Eclipse：
  • 安装 quantumult-eclipse 插件。

3 输入输出处理

• 在项目文件中，设置输入和输出路径：

  @QuantumultConfig(
      tools: ["scp"],
      input.file: "file.txt",
      output.file: "file.txt"
  )

• 输入可以是文件、目录或 URL，输出支持多种格式（如文件、FTP、SFTP）。

4 错误处理

• 在项目文件中，使用 try-catch 处理错误：

  @QuantumultConfig(
      tools: ["ssh"],
      ssh.exec.command: "your_command"
  )
  def task = {
      try {
          input: from: "local", into: "file.txt"
          output: to: "remote", file: "file.txt"
      }
      catch (e) {
          println "错误信息：${e.message}"
      }
  }

常见问题与故障排除

1 Java 环境不正确

• 检查 quantumult.properties 中的 quantumult.java.home 是否正确。
• 确保 JDK 版本与 Quantumult 匹配（如 Quantumult 1.x 需要 JDK 11+）。

2 依赖加载失败

• 检查项目文件中的依赖配置是否正确。
• 确保 Maven/其他工具的路径正确。

3 权限问题

• 如果使用 SSH/SCP 任务,检查服务器端的权限是否正确。
• 确保本地用户有权限访问文件或目录。

Quantumult 是一款功能强大的自动化工具，通过合理配置，可以实现各种自动化场景，如果有具体需求，可以参考 Quantumult 官方文档 或社区资源（如 Stack Overflow）获取更多帮助。