Skip to content

Repository files navigation

ImageCraft 开发指南

快速开始

1. 环境准备

确保已安装以下环境:

  • Node.js >= 18.x
  • Rust >= 1.70
  • npmpnpm

2. 安装依赖

cd imagecraft
npm install

3. 开发模式运行

npm run tauri dev

首次运行会下载并编译 Rust 依赖,可能需要 5-10 分钟。

4. 生产构建

npm run tauri build

构建完成后,安装包位于 src-tauri/target/release/bundle/ 目录。

项目特点

🎨 精美 UI

  • 深色主题设计
  • 玻璃拟态风格
  • 橙色渐变强调色
  • 流畅的动画过渡

⚡ 高性能

  • Rust 后端处理
  • 异步处理不阻塞 UI
  • 内存高效管理

🔧 核心功能

  1. 加水印

    • 文字水印
    • 5 种位置选择
    • 自定义字体大小、颜色、透明度
  2. 去水印

    • 基于图像修复算法
    • 边缘保持平滑
  3. 格式转换

    • PNG、JPG、WebP、GIF、BMP
    • 保持原始质量
  4. 图片裁剪

    • 自定义区域
    • 正方形预设
  5. 图片压缩

    • 质量调节
    • 尺寸限制
    • Lanczos3 算法

扩展开发

添加新功能

  1. 后端 (src-tauri/src/commands.rs)
#[tauri::command]
pub async fn my_new_function(input: String) -> Result<String, String> {
    // 处理逻辑
    Ok("result".to_string())
}
  1. 注册命令 (src-tauri/src/main.rs)
.invoke_handler(tauri::generate_handler![
    // ...
    my_new_function,
])
  1. 前端调用 (src/App.tsx)
const result = await invoke<string>('my_new_function', { input: 'data' })

自定义主题

编辑 src/index.csstailwind.config.js

:root {
  --primary-color: #FB923C; /* 主题色 */
}
// tailwind.config.js
theme: {
  extend: {
    colors: {
      primary: '#FB923C',
    }
  }
}

常见问题

Q: 首次编译很慢?

A: Rust 首次编译需要下载并编译所有依赖,这是正常的。后续编译会快很多。

Q: 如何处理大图片?

A: 图片处理使用流式处理,内存占用可控。对于超大图片,建议先压缩。

Q: 支持哪些操作系统?

A: Windows、macOS、Linux 均支持。Tauri 会自动构建对应平台的安装包。

技术支持


Happy Coding! 🚀

About

ImageCraft 是一款基于 Tauri 开发的跨平台桌面图片处理工具,提供加水印、去水印、格式转换、裁剪、压缩等核心功能

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages