# game-asset-maker

**Repository Path**: lyq617/game-asset-maker

## Basic Information

- **Project Name**: game-asset-maker
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Game Asset Maker

跨平台游戏资产制作工具，支持 AI 图像生成、裁剪、抠图、雪碧图切割和动画导出。

## 技术栈

- 前端：React + TypeScript + Vite + Tailwind CSS + Zustand
- 桌面端：Tauri + Rust
- 图像处理：image-rs
- AI 接口：OpenAI 兼容图片生成接口

## 安装依赖

```bash
npm install
```

## 启动方式

### 1. 推荐：一条命令启动桌面版

```bash
npm run tauri dev
```

这条命令会：

- 自动启动 Vite 开发服务器
- 再启动 Tauri 桌面窗口

不需要手动打开浏览器。

### 2. 前端单独调试

```bash
npm run dev -- --host 127.0.0.1
```

然后在浏览器打开：

```text
http://127.0.0.1:5173
```

### 3. 如果你要手动用 `cargo run`

`cargo run` 只负责启动 Tauri 桌面程序，本身不会启动 Vite。

所以必须先开一个终端启动前端：

```bash
npm run dev -- --host 127.0.0.1
```

再开第二个终端启动桌面程序：

```bash
cargo run
```

如果你只执行了 `cargo run`，这时再去浏览器访问 `localhost:5173` 或 `127.0.0.1:5173`，会看到 `ERR_CONNECTION_REFUSED`，这是正常现象，因为前端开发服务器还没启动。

## 常用命令

```bash
# 前端开发
npm run dev

# 前端构建
npm run build

# Rust 检查
cargo check

# Tauri 开发
npm run tauri dev

# Tauri 打包
npm run tauri build
```

## 常见问题

### `ERR_CONNECTION_REFUSED`

原因通常是你打开了浏览器地址，但 Vite 开发服务器没有启动。

处理方式：

1. 桌面版开发：直接用 `npm run tauri dev`
2. 浏览器调试：先执行 `npm run dev -- --host 127.0.0.1`
3. 手动 `cargo run`：必须先启动 Vite，再启动 Tauri

### `libpng warning: iCCP: cHRM chunk does not match sRGB`

这是 PNG 元数据告警，不是启动失败，一般可以忽略。

## 系统要求

- Node.js 18+
- Rust stable
- Windows 10 及以上 / macOS 10.15+ / 常见 Linux 桌面发行版