# QuantX
**Repository Path**: zhull_313/quant-x
## Basic Information
- **Project Name**: QuantX
- **Description**: Android平台QuantX - AI基金分析助手.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# QuantX - 智能基金分析助手
**个人学习项目** · AI 驱动的基金分析 Android 应用
⚠️ **声明**: 本项目仅供个人学习和技术探索使用，不建议作为专业投资工具。
---
## 📱 项目简介
QuantX 是我个人开发的一个 **Android 学习项目**，主要目的是探索和实践以下技术：
- 🤖 **AI Agent 架构**在移动端的应用
- 💬 **DeepSeek API** 集成与对话系统
- 🎨 **Jetpack Compose** 现代化 UI 开发
- 💾 **Room 数据库** 本地数据持久化
- 🏗️ **Clean Architecture** 架构设计实践
这是一个**个人爱好项目**，用于学习新技术和实验新想法。虽然实现了基金查询、AI 对话等功能，但**不建议在实际投资中使用**。
---
## ✨ 功能特性
### 核心功能
- 🔍 **基金查询**: 输入基金代码或名称，获取基本信息
- 🤖 **AI 对话**: 基于 DeepSeek 的智能问答（支持多轮对话）
- 📝 **历史记录**: 保存和查看查询历史
- ⚙️ **模型配置**: 自定义 API 参数（温度、Token 数等）
### 技术亮点
- 模块化 Agent 技能系统
- Markdown 格式化的 AI 回复
- Material Design 3 设计规范
- 深色主题自动适配
---
## 🛠️ 技术栈
- **语言**: Kotlin 1.9.10
- **UI**: Jetpack Compose + Material 3
- **数据库**: Room + KSP
- **网络**: Retrofit + OkHttp
- **异步**: Coroutines + Flow
- **构建**: Gradle 8.7
完整依赖列表请查看 [libs.versions.toml](gradle/libs.versions.toml)
---
## 🚀 快速开始
### 前置要求
- Android Studio Hedgehog (2024.1.1) 或更高版本
- JDK 17+
- Android SDK API 34+
- **DeepSeek API Key**（需要自行申请）
### 运行步骤
#### 1. 克隆项目
```bash
git clone https://github.com/yourusername/QuantX.git
cd QuantX
```
#### 2. 配置 API Key
首次运行需要在应用的"设置"页面配置：
- **API Key**: 你的 DeepSeek API 密钥
- **Base URL**: `https://api.deepseek.com/v1/`
- **模型**: `deepseek-v4-flash` 或 `deepseek-v4-pro`（推荐）
> 💡 提示: API Key 仅保存在本地，不会上传到任何服务器。
#### 3. 构建运行
在 Android Studio 中：
1. 打开项目
2. 点击 `Run` 按钮 (▶️)
3. 选择设备/模拟器
或使用命令行：
```bash
.\gradlew.bat clean
.\gradlew.bat installDebug
```
---
## 📸 应用截图
（待添加截图）
---
## ⚠️ 重要声明
### 这不是一个专业的投资工具！
- ❌ **不保证数据准确性**: AI 生成的内容可能存在错误
- ❌ **不提供投资建议**: 所有分析仅供参考和学习
- ❌ **不承担投资风险**: 请勿基于本应用的输出做出投资决策
- ✅ **仅用于学习**: 适合对 Android 开发和 AI 应用感兴趣的开发者学习参考
**投资有风险，入市需谨慎。** 如需专业的投资分析，请咨询持牌金融机构。
---
## 📚 学习资源
如果你也对这些技术感兴趣，可以参考：
- [Jetpack Compose 官方文档](https://developer.android.com/jetpack/compose)
- [DeepSeek API 文档](https://platform.deepseek.com/docs)
- [Room 数据库教程](https://developer.android.com/training/data-storage/room)
- [Kotlin Coroutines](https://kotlinlang.org/docs/coroutines-overview.html)
---
## 🤝 欢迎交流
这是一个个人学习项目，如果你：
- 💡 发现了 Bug
- 🎯 有更好的实现建议
- 📖 想讨论相关技术
欢迎提 Issue 或 Pull Request！一起学习交流～
---
## 📄 开源协议
MIT License - 详见 [LICENSE](LICENSE) 文件
---
**感谢阅读！如果这个项目对你有帮助，欢迎 ⭐️ Star 支持！**
Made with ❤️ for Learning