# 切图工具

**Repository Path**: su_xii/qt

## Basic Information

- **Project Name**: 切图工具
- **Description**: 自用,codesign切图工具统一命名 自动解压
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

🛠️ qt — 智能切图工具

一个用于解压并标准化多倍率 PNG 切图包的命令行与 HTTP 服务工具。

专为前端/客户端开发者设计，一键将 CodeSign 等平台下载的 ZIP 切图包转换为标准资源目录。

✨ 功能亮点

- ✅ 自动识别 ZIP 中的三张 PNG：xxx.png、xxx@2x.png、xxx@3x.png
- ✅ 支持两种工作模式：
  - 命令行模式：直接处理本地 ZIP 文件
  - HTTP 服务模式：作为后台服务，供浏览器插件或脚本调用
- ✅ 输出标准切图目录结构：
  name.png
  2.0x/name.png
  3.0x/name.png

🚀 安装

确保已安装 Rust，然后编译项目：

cargo build --release

生成的可执行文件位于：./target/release/qt（Windows 为 qt.exe）

建议将该路径加入系统 PATH，或复制到常用目录以便全局调用。

📌 使用方式

1️⃣ 命令行模式（传统用法）

基本用法：输出到当前目录下的自动命名文件夹
qt input.zip

指定输出文件名
qt input.zip icon.png

指定输出目录（直接写入，不创建子文件夹）
qt input.zip button.png -p ./assets/icons

参数说明
参数   说明
input.zip   必填，包含三张 PNG 的 ZIP 文件（必须含 xxx.png, xxx@2x.png, xxx@3x.png）

[output_name.png]   可选，指定输出基础名（默认使用 ZIP 内图片公共前缀）

-p, --output-dir DIR   可选，指定输出目录（默认在当前目录创建唯一子文件夹）

示例
qt download.zip button.png -p ./res/ui

生成目录结构：
./res/ui/
├── button.png
├── 2.0x/button.png
└── 3.0x/button.png

2️⃣ HTTP 服务模式（插件集成）

启动常驻服务，接收外部请求处理切图任务：

启动服务，输出到当前目录
qt --run

启动服务，指定输出基目录
qt --run -p D:/project/assets

服务启动后，监听 http://127.0.0.1:10222/process，接受 POST JSON 请求：

{
"path": "C:/Users/Name/Downloads/codesign.zip",
"name": "icon.png"
}

💡 配合浏览器插件使用，实现“点击下载 → 输入名称 → 自动切图”一体化流程。

🔧 开发者提示

- ZIP 要求：必须恰好包含 3 个 .png 文件，且命名符合 xxx.png / xxx@2x.png / xxx@3x.png 规范。
- 输出安全：自动避免目录覆盖（如 icon 已存在，则创建 icon-1、icon-2...）。
- 跨平台支持：Windows / macOS / Linux 均可运行。

🎯 典型场景

- 从 CodeSign / 腾讯云控制台 下载切图 ZIP 后快速整理
- 集成到 Edge / Chrome 插件，实现自动化工作流
- 批量处理设计交付资源，统一项目资产结构

简洁 · 高效 · 开箱即用  
让切图不再繁琐！