# Henji-AI
**Repository Path**: chais-flying-up/Henji-AI
## Basic Information
- **Project Name**: Henji-AI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
痕迹AI
一个软件用上各种AI - 聚合多家供应商，一站式生成图片、视频和音频
[](https://space.bilibili.com/39337803)
## 下载
Windows 用户请下载 .msi 文件，macOS 用户请下载 .dmg 文件
Windows 用户如果在启动时遇到了报错，请尝试安装 [WebView2 运行时](https://developer.microsoft.com/zh-cn/Microsoft-edge/webview2#download)
### Github下载
[](https://github.com/henjicc/Henji-AI/releases/latest)
### 网盘下载
**夸克网盘**：[https://pan.quark.cn/s/66bcb08a7713](https://pan.quark.cn/s/66bcb08a7713)
**蓝奏云**：[https://henji.lanzout.com/b01vdihsza](https://henji.lanzout.com/b01vdihsza) 提取码：g90x
## 使用教程
施工中，明天再来看看吧……
## 功能特性
- 多家供应商可选，自由灵活
- 界面简洁美观，基础功能完善
## 适配列表
### 供应商
[派欧云](https://ppio.com/user/register?invited_by=MLBDS6)：访问与充值都比较方便，但 API 更新比较慢，且仅支持国内 AI
[fal](https://fal.ai/)：API 更新快，覆盖面广，但充值可能需要信用卡
[魔搭](https://modelscope.cn/)：免费，但仅支持开源模型
[KIE](https://kie.ai/zh-CN)：充值方便，部分模型有优惠，但某些 API 功能有所缺失
### 图片
| 模型 | 功能 | 供应商 |
|--------|------|------|
| 即梦图片 4.0 | 图片生成、图片编辑 | 派欧云、fal、KIE |
| 即梦图片 4.5 | 图片生成、图片编辑 | fal、KIE |
| Nano Banana | 图片生成、图片编辑 | fal |
| Nano Banana Pro | 图片生成、图片编辑 | fal、KIE |
| 可灵图片 O1 | 图片生成、图片编辑 | fal |
| Grok Imagine 图片 | 图片生成 | KIE |
| Z-Image-Turbo | 图片生成 | fal、魔搭、KIE |
| Qwen-Image | 图片生成 | 魔搭 |
| Qwen-Image-Edit-2509 | 图片编辑 | 魔搭 |
| FLUX.1-Krea-dev | 图片生成 | 魔搭 |
| 魔搭API自定义 | 图片生成、图片编辑 | 魔搭 |
### 视频
| 模型 | 功能 | 供应商 |
|--------|------|------|
| Sora 2 | 文生视频、图生视频 | fal、KIE |
| Veo 3.1 | 文生视频、图生视频、首尾帧、参考生视频 | fal |
| 即梦视频 3.0 | 文生视频、图生视频、首尾帧、参考生视频 | 派欧云、fal、KIE |
| Vidu Q1 | 文生视频、图生视频、首尾帧、参考生视频 | 派欧云 |
| 可灵 2.5 Turbo | 文生视频、图生视频 | 派欧云 |
| 可灵 V2.6 Pro | 文生视频、图生视频 | fal、KIE |
| 可灵 O1 | 图生视频、参考生视频、视频编辑、视频参考 | fal |
| 海螺 Hailuo 2.3 | 文生视频、图生视频 | 派欧云、fal、KIE |
| 海螺 Hailuo-02 | 文生视频、图生视频、首尾帧 | 派欧云、fal、KIE |
| 万相 2.5 Preview | 文生视频、图生视频 | 派欧云、fal |
| Vidu Q2 | 文生视频、图生视频、参考生视频、视频延长 | fal |
| PixVerse V4.5 | 文生视频、图生视频 | 派欧云 |
| PixVerse V5.5 | 文生视频、图生视频、首尾帧 | fal |
| LTX-2 | 文生视频、图生视频、视频编辑 | fal |
| Grok Imagine 视频 | 文生视频、图生视频 | KIE |
### 音频
| 模型 | 功能 | 供应商 |
|--------|------|------|
| MiniMax Speech-2.6 | 语音合成 | 派欧云 |
## 技术栈
- **框架**: [Tauri 2.0](https://tauri.app/) - 基于 Rust 的跨平台桌面应用框架
- **前端**: React 18 + TypeScript
- **构建工具**: Vite 4
- **样式**: Tailwind CSS
- **HTTP 客户端**: Axios
- **图片处理**: Pica
## 项目结构
```
Henji-AI/
├── src/ # 前端源码
│ ├── adapters/ # API 适配器（派欧云、fal、魔搭）
│ ├── components/ # React 组件
│ ├── config/ # 供应商和模型配置
│ ├── services/ # 业务逻辑层
│ ├── types/ # TypeScript 类型定义
│ └── utils/ # 工具函数
├── src-tauri/ # Tauri 后端
│ ├── src/ # Rust 源码
│ ├── icons/ # 应用图标
│ └── Cargo.toml # Rust 依赖
└── .github/workflows/ # GitHub Actions CI/CD
```
## 开发指南
### 环境要求
- **Node.js**: 18+ (推荐使用 LTS 版本)
- **Rust**: 1.70+
- **Windows**: Visual Studio Build Tools (MSVC)
- **macOS**: Xcode Command Line Tools
### 安装依赖
```bash
npm install
```
### 开发模式
**Windows**:
```bash
npm run tauri:dev
```
**macOS**:
```bash
npm run tauri:dev:mac
```
### 构建应用
**Windows** (生成 MSI 安装包):
```bash
npm run tauri:build
```
**macOS** (生成 DMG 安装包):
```bash
npm run tauri:build:mac
```
构建产物位于 `src-tauri/target/release/bundle/`
## 架构说明
### 适配器模式
项目采用适配器模式统一不同 AI 供应商的 API：
```
MediaGenerator → AdapterFactory → 具体适配器 (PPIOAdapter / FalAdapter / ModelscopeAdapter)
```
每个适配器实现统一的接口，支持图片、视频、音频生成。
### 数据存储
- **API Keys**: localStorage
- **历史记录**: AppLocalData (`Henji-AI/history.json`)
- **媒体文件**: AppLocalData (`Henji-AI/Media/`)
- **缓存**: AppLocalData (`Henji-AI/Uploads/`, `Henji-AI/Waveforms/`)
### 跨平台适配
- Windows 和 macOS 使用不同的构建脚本
- 窗口控制自动适配操作系统风格
- 文件路径使用 Tauri API 保证跨平台兼容
## 扩展开发
想要添加新的 AI 模型或供应商？请参考 **[模型与供应商适配指南](docs/model-adaptation-guide.md)**，了解如何：
- 定义新模型的参数 Schema
- 实现后端适配器
- 注册模型到系统中
## 许可证
本项目采用 [Apache License 2.0](LICENSE) 开源许可证。