# quickMoltbot

**Repository Path**: lihangsan/quick-moltbot

## Basic Information

- **Project Name**: quickMoltbot
- **Description**: quick-moltbot的测试网站。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuickMoltBot

这是一个基于 Django 的 Molt 机器人项目，用于快速启动和管理 Molt 相关功能，同时集成了贵金属价格图表和 A 股数据功能。

## 功能特性

- **MoltBot 功能**: 提供 Molt 数据的 CRUD 操作和配置管理
- **贵金属图表**: 实时显示黄金、白银的日K线图
- **A 股数据**: 实时获取和展示中国 A 股市场数据及 K 线图
- **RESTful API**: 提供完整的 API 接口
- **交互式图表**: 使用 ECharts 展示动态图表

## 环境设置

### 克隆项目

```bash
git clone <repository-url>
cd startQuickMoltBot
```

### 安装依赖

```bash
# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt
```

### Django 项目设置

```bash
# 运行数据库迁移
python manage.py migrate

# 创建超级用户（可选）
python manage.py createsuperuser

# 启动开发服务器
python manage.py runserver
```

## 应用功能

### MoltBot 应用

#### 模型
- Molt：存储 Molt 数据（标题、内容、创建时间等）
- MoltBotConfig：存储机器人配置信息

#### API 接口
- `/moltbot/api/molts/` - Molt 数据的 CRUD 操作
- `/moltbot/api/config/` - 配置信息的 CRUD 操作

#### 管理后台
- 访问 `/admin/` 可以管理 Molt 和配置数据（需要先创建超级用户）

### 贵金属图表功能

#### 模型
- MetalPrice：存储贵金属价格数据（开盘价、收盘价、最高价、最低价、成交量等）
- MetalInfo：存储贵金属基本信息

#### 图表界面
- 访问 `/precious-metals/` 查看黄金、白银的日K线图
- 支持切换不同金属类型和时间范围
- 提供交互式图表，包括缩放和平移功能

#### API 接口
- `/precious-metals/api/prices/` - 获取贵金属价格数据
- `/precious-metals/api/data/` - 添加或更新价格数据
- `/precious-metals/generate-sample-data/` - 生成示例数据
- `/precious-metals/fetch-real-data/` - 获取真实市场数据

### A 股数据功能

#### 模型
- Stock：存储股票基本信息（代码、名称、交易所、行业等）
- StockPrice：存储股票价格数据（开盘价、收盘价、最高价、最低价、成交量等）

#### 图表界面
- 访问 `/stocks/` 查看 A 股数据仪表板
- 访问 `/stocks/agriculture/` 查看农业相关股票仪表板
- 访问 `/stocks/chart/<股票代码>/` 查看特定股票的 K 线图
- 支持切换不同股票和时间范围
- 提供交互式图表，包括缩放和平移功能

#### API 接口
- `/stocks/api/stocks/` - 获取股票列表
- `/stocks/api/stocks/?sector=agriculture` - 获取农业相关股票列表
- `/stocks/api/stocks/<股票代码>/` - 获取特定股票详情
- `/stocks/api/stocks/<股票代码>/chart/` - 获取股票图表数据
- `/stocks/refresh-data/` - 刷新所有股票数据
- `/stocks/refresh-agriculture-stocks/` - 刷新农业相关股票数据

#### 配置说明
如需获取真实的 A 股数据，需要申请 tushare 账号并设置 token：

```bash
# 设置环境变量
export TUSHARE_TOKEN=your_tushare_token_here
```

### 投资分析功能

#### 分析工具
- `investment_analysis/agriculture_stock_analyzer.py` - 农业股票分析器
- `investment_analysis/china_agriculture_investment_plan.md` - 中国农业投资方案
- `investment_analysis/comprehensive_agriculture_report.md` - 农业投资综合报告

#### 分析内容
- 农业股票表现排名
- 行业板块分析
- 投资策略建议
- 风险提示与控制

## 开发

```bash
# 运行测试
python manage.py test

# 创建新的 Django 应用
python manage.py startapp app_name

# 生成数据库迁移文件
python manage.py makemigrations

# 应用数据库迁移
python manage.py migrate
```

## 许可证

MIT License