安装

系统要求

• Rust：1.70 或更高版本
• 操作系统：Linux、macOS、Windows

检查 Rust 环境

首先确保已安装 Rust：

rustc --version
cargo --version

如果未安装，请访问 rustup.rs 进行安装。

安装方式

方式一：从源码编译

# 1. 克隆仓库
git clone https://gitee.com/su_xii/qt-tool.git
cd qt-tool

# 2. 编译发布版本
cargo build --release

# 3. 验证安装
./target/release/qt --version

编译后的可执行文件位于 target/release/qt（Windows 下为 qt.exe）。

添加到 PATH（可选）

为了方便全局使用，可以将可执行文件添加到系统 PATH：

Linux/macOS:

sudo cp target/release/qt /usr/local/bin/

Windows: 将 target/release/qt.exe 复制到某个 PATH 环境变量包含的目录。

方式二：使用 Cargo 安装（即将推出）

cargo install qt-tool

验证安装

安装完成后，运行以下命令验证：

qt --help

你应该看到帮助信息，显示所有可用的命令行选项。

目录结构

克隆后的项目结构：

qt-tool/
├── Cargo.toml              # Rust 项目配置
├── config.toml             # 默认配置文件
├── example_config.toml     # 配置示例
├── src/                    # 源代码
│   ├── main.rs            # 入口文件
│   ├── cli.rs             # CLI 解析
│   ├── server.rs          # 服务器处理
│   ├── handler.rs         # 核心处理逻辑
│   └── ...
└── plug/                   # 浏览器插件
    └── codesign-qt-helper/

配置文件位置

QT Tool 会在以下位置查找配置文件（按优先级）：

1. 通过 --config 参数指定的路径
2. 当前目录下的 config.toml

运行时会创建以下文件：

• ~/.config/qt-tool/record.json - 处理记录
• ~/.config/qt-tool/record.log - 日志文件

下一步

安装完成后，您可以：

• 查看 配置说明 了解如何配置输出规则
• 启动 服务器模式 使用 HTTP API
• 安装 浏览器插件 实现自动化工作流