# AI-Spirit

**Repository Path**: kaoroujuan/AI-Spirit

## Basic Information

- **Project Name**: AI-Spirit
- **Description**: 一个基于 Tauri + Vue 3 + Live2D 构建的桌面 AI 宠物应用，让你的桌面有一个可爱的 AI 伙伴。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Spirit - 桌面 AI 宠物

一个基于 Tauri + Vue 3 + Live2D 构建的桌面 AI 宠物应用，让你的桌面有一个可爱的 AI 伙伴。

## 功能特性

- **Live2D 虚拟形象** - 支持多个 Live2D 模型，可自由切换角色形象
- **AI 对话功能** - 支持多种 AI 模型（DeepSeek、OpenAI、Claude 等），与你的桌面宠物聊天
- **桌面宠物** - 可拖拽移动，不影响其他窗口操作
- **系统托盘** - 最小化到托盘，不占用任务栏空间
- **开机自启** - 支持开机自动启动
- **角色定制** - 可自定义角色名称和性格设定

## 软件截图

### 主界面
![主界面](screenshot/主界面.png)

### 配置界面
![配置界面](screenshot/配置界面.png)

### AI 对话界面
![AI对话界面](screenshot/AI对话界面.png)

## 技术栈

- **前端**: Vue 3 + TypeScript + Vite + Pinia
- **后端**: Tauri 2.0 (Rust)
- **Live2D**: pixi.js + pixi-live2d-display (Cubism 4)
- **AI**: 支持 DeepSeek / OpenAI / Claude API

## 安装使用

### 环境要求

- Node.js 18+
- Rust (最新稳定版)
- Windows 10/11

### 开发环境

```bash
# 克隆仓库
git clone https://gitee.com/your-username/ai-spirit.git

# 安装依赖
npm install

# 开发模式运行
npm run tauri:dev

# 构建生产版本
npm run tauri:build
```

### 配置 AI

首次使用需要在配置界面设置 API Key：

1. 点击托盘图标，选择 "AI 配置"
2. 选择 AI 服务商（DeepSeek / OpenAI / Claude）
3. 输入对应的 API Key
4. 选择喜欢的角色形象
5. 点击保存即可开始对话

## 支持的 AI 服务

| 服务商 | 模型 | 说明 |
|--------|------|------|
| DeepSeek | deepseek-chat | 国内服务，性价比高 |
| OpenAI | gpt-4o / gpt-3.5-turbo | 国际服务 |
| Claude | claude-3-5-sonnet | Anthropic 服务 |

## 目录结构

```
ai-spirit/
├── src/                  # Vue 前端源码
│   ├── components/       # 组件
│   ├── composables/      # 组合式函数
│   ├── stores/           # Pinia 状态管理
│   ├── views/            # 页面视图
│   └── services/         # 服务层
├── src-tauri/            # Tauri Rust 后端
│   ├── src/              # Rust 源码
│   ├── icons/            # 应用图标
│   └── tauri.conf.json   # Tauri 配置
├── public/               # 静态资源
│   ├── live2d/           # Live2D 模型文件
│   └ assets/             # 其他资源
├── screenshot/           # 软件截图
└── scripts/              # 构建脚本
```

## 开源协议

MIT License

## 致谢

- [Tauri](https://tauri.app/) - 跨平台桌面应用框架
- [pixi-live2d-display](https://github.com/avg-sky/pixi-live2d-display) - Live2D 显示库
- Live2D 模型来源：[Live2D 官方示例](https://www.live2d.com/en/download/sample-data/)