# Agnes Studio

**Repository Path**: antonetwo_admin/agnes-studio

## Basic Information

- **Project Name**: Agnes Studio
- **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-07-01
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

========================================
  Agnes Studio - 功能说明文档
========================================

项目简介：
---------
Agnes Studio 是一款基于 Tauri 框架开发的桌面端 AI 创作工具，
集成了对话、图片生成、视频生成等多种 AI 能力。

技术栈：
-------
- 前端：HTML + CSS + JavaScript（原生）
- 后端：Rust + Tauri 2.x
- AI 接口：Agnes API（兼容 OpenAI 格式）

========================================
  功能模块总览
========================================

1. 对话功能
2. 生图修图（文生图 + 图生图）
3. 生视频（文生视频 + 图生视频 + 多图视频）
4. 批量生成
5. 历史记录
6. 设置

========================================
  详细功能说明
========================================

--- 1. 对话功能 ---

功能描述：
  与 AI 大模型进行自然语言对话。

支持模型：
  - agnes-2.0-flash
  - agnes-1.5-flash

功能特点：
  - 多模型切换
  - 支持 Ctrl+Enter 快捷发送
  - 流式对话体验
  - 自动保存对话历史

截图位置：screenshots/01-chat.png


--- 2. 生图修图 ---

包含两个子功能：文生图、图生图

支持模型：
  - agnes-image-2.1-flash
  - agnes-image-2.0-flash

2.1 文生图
  功能描述：
    根据文字描述生成图片。

  可配置参数：
    - 提示词（正向）
    - 负面提示词
    - 图片尺寸（7种规格：1024×1024 / 1024×768 / 768×1024 /
                1280×720 / 720×1280 / 1792×1024 / 1024×1792）
    - 生成数量（1张 / 2张 / 4张）

  截图位置：screenshots/02-image-generate.png

2.2 图生图（图片编辑）
  功能描述：
    上传一张原图，根据提示词对图片进行修改/重绘。

  可配置参数：
    - 原图上传（支持本地文件，自动转 Base64）
    - 编辑提示词
    - 负面提示词
    - 图片尺寸
    - 重绘强度（0.1 - 1.0 可调）

  使用说明：
    - 必须先上传原图才能点击"执行修图"按钮
    - 重绘强度越高，图片变化越大；越低，保留原图细节越多

  截图位置：screenshots/03-image-edit.png


--- 3. 生视频 ---

包含三个子功能：文生视频、图生视频、多图视频

支持模型：
  - agnes-video-v2.0

3.1 文生视频
  功能描述：
    根据文字描述生成视频。

  可配置参数：
    - 提示词（正向）
    - 负面提示词
    - 分辨率档位（480p / 720p / 1080p）
    - 画面比例（16:9 / 9:16 / 1:1 / 4:3 / 3:4）
    - 视频时长（3秒 / 5秒 / 8秒 / 10秒 / 15秒 / 18秒）
    - 帧率（12fps / 24fps / 30fps / 60fps）
    - 随机种子（留空则随机）
    - 推理步数（10 - 100 步）

  截图位置：screenshots/04-video-text.png

3.2 图生视频
  功能描述：
    上传一张图片或输入公网图片URL，根据提示词让图片动起来生成视频。

  图片输入方式（二选一即可）：
    - 上传本地图片（自动转换为 Base64 格式）
    - 输入公网可访问的图片 URL（推荐）

  可配置参数：
    - 图片（上传或 URL）
    - 运动提示词
    - 负面提示词
    - 分辨率档位
    - 画面比例
    - 视频时长
    - 帧率
    - 随机种子
    - 推理步数

  使用说明：
    - 上传图片 或 输入URL，任一方式有效即可启用生成按钮
    - 同时有上传文件和URL时，优先使用上传的文件

  截图位置：screenshots/05-video-image.png

3.3 多图视频 / 关键帧动画
  功能描述：
    通过多张图片生成视频，支持两种模式：
    - ti2vid（文/图生视频）：基于多张图片和文字生成视频
    - keyframes（关键帧动画）：在多张关键帧之间生成平滑过渡动画

  可配置参数：
    - 提示词
    - 负面提示词
    - 图片URL列表（每行一个URL）
    - 生成模式（ti2vid / keyframes）
    - 分辨率档位
    - 画面比例
    - 视频时长
    - 帧率
    - 随机种子
    - 推理步数

  注意事项：
    - 多图视频仅支持公网图片URL，不支持本地图片上传

  截图位置：screenshots/06-video-multi.png


--- 4. 批量生成 ---

功能描述：
  批量文生图，一次输入多个提示词，自动批量生成图片。

支持模型：
  - agnes-image-2.1-flash
  - agnes-image-2.0-flash

可配置参数：
  - 批量提示词（每行一个提示词）
  - 图片尺寸

使用说明：
  - 在输入框中每行输入一个提示词
  - 点击"批量生成"后自动依次生成所有图片

截图位置：screenshots/07-batch.png


--- 5. 历史记录 ---

功能描述：
  查看所有生成历史，包括对话、图片、视频记录。

功能特点：
  - 按时间倒序展示所有历史记录
  - 支持刷新历史记录
  - 支持一键清空所有历史
  - 数据存储在本地 LocalStorage

截图位置：screenshots/08-history.png


--- 6. 设置 ---

功能描述：
  配置 API Key、接口地址和默认模型。

6.1 API Key 管理
  - 支持添加多个 API Key（带名称标识）
  - 可选择当前使用的 API Key
  - API Key 加密存储在本地

6.2 API 地址配置
  - 可自定义 Base URL
  - 默认地址：https://apihub.agnes-ai.com/v1

6.3 默认模型设置
  - 对话模型默认选择
  - 图像模型默认选择
  - 视频模型默认选择

截图位置：screenshots/09-settings.png


========================================
  项目文件结构
========================================

tauri/
├── index.html          # 主页面
├── style.css           # 样式文件
├── app.js              # 主应用逻辑
├── api.js              # API 接口封装
├── config.js           # 配置文件
├── read.txt            # 本文档
├── screenshots/        # 功能截图
│   ├── 01-chat.png
│   ├── 02-image-generate.png
│   ├── 03-image-edit.png
│   ├── 04-video-text.png
│   ├── 05-video-image.png
│   ├── 06-video-multi.png
│   ├── 07-batch.png
│   ├── 08-history.png
│   └── 09-settings.png
└── src-tauri/          # Rust 后端代码
    ├── Cargo.toml
    ├── src/
    └── tauri.conf.json


========================================
  快速开始
========================================

1. 配置 API Key
   - 打开左侧菜单"设置"
   - 在"API Key 管理"中添加你的 API Key
   - 选择当前使用的 Key

2. 开始使用
   - 对话：左侧菜单"对话"，选择模型后开始聊天
   - 生图：左侧菜单"生图修图"，输入提示词生成图片
   - 生视频：左侧菜单"生视频"，支持文生/图生/多图三种模式

3. 查看历史
   - 左侧菜单"历史记录"可查看所有生成记录


========================================
  开发说明
========================================

本地开发运行：
  cd src-tauri && cargo tauri dev

构建生产版本：
  cd src-tauri && cargo tauri build

注意：
  - 本项目使用 Tauri 2.x 框架
  - 前端使用原生 HTML/CSS/JS，无需构建工具
  - 所有数据存储在本地，不上传服务器

========================================