# KoishiAiMix

[![npm](https://img.shields.io/npm/v/koishi-plugin-koishiaimix?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-koishiaimix)

基于AiHubMix API的Koishi插件，提供AI对话和绘图功能。

## 功能特性

- 🤖 **AI对话**: 支持多种AI模型的智能对话
- 🎨 **AI绘图**: 支持文生图和图文生图功能
- 🖼️ **图片编辑**: 支持基于描述的图片编辑
- 💬 **上下文管理**: 智能的多轮对话上下文管理
- ⚙️ **灵活配置**: 可配置API密钥、模型选择、参数设置等
- 📝 **丰富指令**: 提供友好的指令系统

## 安装方法

1. 确保已安装Koishi框架
2. 将插件放置在`external`目录下
3. 在Koishi配置中启用`koishiaimix`插件
4. 配置AiHubMix API密钥

## 使用方法

### AI对话

```
aimix 你好，请介绍一下自己
ai 今天天气怎么样？
```

支持图文混合对话，可以发送图片并询问相关问题。

### AI绘图

```
aimix.draw 一只可爱的小猫
draw 夕阳下的城市 -s 1536x1024 -q high
paint 科幻风格的机器人 --size=1024x1536 --quality=high --count=2
```

#### 绘图参数
- `-s, --size`: 图片尺寸
- `-q, --quality`: 图片质量
- `-n, --count`: 生成数量（1-4）

### 图片编辑

```
aimix.edit 把背景改成蓝天白云
```

需要先上传要编辑的图片。

### 其他指令

```
aimix.clear          # 清除对话上下文
aimix.config         # 查看配置信息
aimix.test           # 测试API连接
aimix.help           # 显示帮助信息
```

## API密钥获取

1. 访问 [AiHubMix官网](https://aihubmix.com)
2. 注册账号并登录
3. 前往 [API密钥页面](https://aihubmix.com/token)
4. 创建新的API密钥
5. 将密钥配置到插件中

## 配置说明

### 必需配置

- `apiKey`: AiHubMix API密钥（必填）

### 可选配置

#### API配置
- `baseUrl`: API基础URL（默认: `https://aihubmix.com/v1`）
- `timeout`: 请求超时时间，单位秒（默认: `60`）
- `retryCount`: 重试次数（默认: `2`）

#### 对话配置
- `chatModel`: 对话模型（默认: `gpt-3.5-turbo`）
- `maxTokens`: 最大token数（默认: `2048`）
- `temperature`: 温度参数，0-2（默认: `0.7`）

#### 绘图配置
- `imageModel`: 绘图模型（默认: `gpt-image-1`）
- `imageSize`: 图片尺寸（默认: `1024x1024`）
- `imageQuality`: 图片质量（默认: `medium`）

#### 功能开关
- `enableChat`: 启用AI对话功能（默认: `true`）
- `enableImage`: 启用AI绘图功能（默认: `true`）

## 支持的模型

### 对话模型
- `gpt-3.5-turbo`、`gpt-4`、`gpt-4-turbo`
- `claude-3-sonnet`、`claude-3-haiku`
- 更多模型请查看AiHubMix官方文档

### 绘图模型
- `gpt-image-1`: OpenAI官方绘图模型
- `gpt-4o-image`: GPT-4o绘图（逆向）
- `gpt-4o-image-vip`: GPT-4o绘图VIP版本

## 常见问题

### Q: API密钥无效怎么办？
A: 请检查API密钥是否正确，确保以`sk-`开头且长度足够。

### Q: 请求超时怎么办？
A: 可以增加`timeout`配置值，或检查网络连接。

### Q: 绘图失败怎么办？
A: 检查描述是否包含敏感内容，避免使用在世艺术家名称。

### Q: 如何清除对话历史？
A: 使用`aimix.clear`指令清除当前用户的对话上下文。

## 相关链接

- [AiHubMix官网](https://aihubmix.com)
- [AiHubMix文档](https://docs.aihubmix.com)
- [Koishi官网](https://koishi.chat)
- [Koishi文档](https://koishi.chat/zh-CN/guide/)

---

如果这个插件对您有帮助，请考虑给项目点个⭐️！