# git-image2

**Repository Path**: Harin/git-image2

## Basic Information

- **Project Name**: git-image2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GPT Bridge

GPT Bridge 是一个基于 React、Vite、MUI 和 Tauri 2 的桌面/Android 应用，用于接入 OpenAI 兼容接口进行对话与图像生成。

当前应用包名：

```text
com.emmmya.imgage2
```

当前版本：

```text
0.1.1
```

## 功能概览

- 对话工作台：支持 OpenAI 兼容 Chat Completions 接口。
- 图像生成工作台：支持 `gpt-image-2` 等图像模型配置。
- 供应商管理：可配置名称、调用地址、API Key、聊天模型、图像模型。
- 本地记录：对话和图像记录使用 SQLite 保存。
- Android 支持：Tauri Android 工程已生成，可构建 APK。
- 图标资源：应用图标已生成到 `src-tauri/icons` 与 Android mipmap 资源中。

## 技术栈

- Frontend：React 19、TypeScript、Vite 6、MUI 7
- Desktop/Mobile Runtime：Tauri 2
- Rust Backend：Tauri commands、reqwest、async-openai、SQLite plugin
- Android：Gradle、Android SDK、NDK

## 目录说明

```text
src/                         前端源码
src/components/              React 组件
src-tauri/                   Tauri Rust 工程
src-tauri/gen/android/       Tauri Android 工程
src-tauri/icons/             桌面与移动端图标资源
scripts/                     本地开发和打包脚本
assets/                      项目素材源文件
codex-skill/                 Codex image skill
```

## 环境要求

macOS 桌面开发需要：

- Node.js 20+
- npm
- Rust / Cargo / rustup
- Tauri CLI 依赖由项目 `@tauri-apps/cli` 提供

Android 构建需要：

- Android Studio
- Android SDK
- Android Platform Tools
- Android Build Tools
- Android NDK，默认使用 `27.0.12077973`
- Rust target：`aarch64-linux-android`

默认 Android SDK 路径：

```text
~/Library/Android/sdk
```

如你的 SDK 不在默认路径，请提前设置：

```bash
export ANDROID_HOME=/path/to/android/sdk
export ANDROID_SDK_ROOT=/path/to/android/sdk
```

## 安装依赖

执行：

```bash
bash scripts/install-deps.sh
```

这个脚本会做以下事情：

- 检查 `node`、`npm`、`cargo`、`rustup`
- 执行 `npm install`
- 安装当前 macOS 架构对应的 Rust target
- 安装 Android arm64 Rust target
- 检测 Android SDK / NDK / adb
- 如果存在 `sdkmanager`，尝试安装 Android 构建所需包

如果 Android Studio 未安装或 SDK 路径不正确，脚本会给出警告，需要你手动补齐 Android 环境。

## 本地开发

启动 Web 开发服务：

```bash
npm run dev
```

启动 Tauri 桌面应用：

```bash
npm run app
```

前端生产构建：

```bash
npm run build
```

## 打包 Android APK

执行：

```bash
bash scripts/build-android-apk.sh
```

默认构建 arm64：

```bash
bash scripts/build-android-apk.sh aarch64
```

脚本会自动设置：

```bash
ANDROID_HOME
ANDROID_SDK_ROOT
NDK_HOME
```

默认输出路径：

```text
src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
```

## Android 签名

正式包依赖本地签名配置：

```text
src-tauri/gen/android/key.properties
src-tauri/gen/android/keystore/release.jks
```

这些文件已被 `.gitignore` 忽略，不会提交到仓库。

如果缺少签名文件，release 构建可能失败。请在本地准备签名文件后再打正式包。

## 常用命令

```bash
npm run build
npm run app
bash scripts/install-deps.sh
bash scripts/build-android-apk.sh
```

验证 APK 信息：

```bash
$ANDROID_HOME/build-tools/35.0.1/aapt dump badging src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk | sed -n '1,8p'
```

验证 APK 签名：

```bash
$ANDROID_HOME/build-tools/35.0.1/apksigner verify --print-certs src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
```

安装到当前 Android 设备：

```bash
adb install -r src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
```

## 注意事项

- 不要提交 `node_modules`、`dist`、APK、AAB、keystore、`key.properties`。
- Android 网络访问依赖 `INTERNET` 权限，已在 Android Manifest 中配置。
- SQLite 数据库为本地数据，重装应用或清除数据会影响历史记录。
- 如果打包时找不到 NDK，请先运行 `scripts/install-deps.sh` 或在 Android Studio SDK Manager 中安装 NDK。

## 版本记录

- `v1`：基础对话、图像生成、供应商配置、SQLite 记录、Android 打包能力。