# gold-detection

**Repository Path**: AnotherJ_admin/gold-detection

## Basic Information

- **Project Name**: gold-detection
- **Description**: 基于金价网（https://www.jinjia.com.cn）的金价查看器
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-02
- **Last Updated**: 2025-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 金价监控工具

这是一个简单的工具，用于从金价网（https://www.jinjia.com.cn）自动获取实时金价信息。它会抓取国际金价、国内金价以及银行金价数据，并定期自动保存为Excel文件。

## 功能特点

- 获取实时金价数据（国内、国际、银行金价）
- 可配置的数据获取间隔
- 将数据保存为Excel格式
- 提供图形界面查看和控制
- 详细的日志记录

## 安装依赖

使用pip安装所有依赖：

```
pip install -r requirements.txt
```

## 使用方法

### 配置文件

程序使用`config.ini`文件进行配置，首次运行时会自动创建默认配置文件。您可以根据需要修改以下配置：

```ini
[Settings]
# 数据获取间隔（分钟）
fetch_interval_minutes = 5

# 数据保存路径
data_save_path = gold_data

# 数据源网站
data_source_url = https://www.jinjia.com.cn/

[Logging]
# 日志级别: DEBUG, INFO, WARNING, ERROR, CRITICAL
log_level = INFO

# 日志文件名
log_file = gold_tracker.log

# 日志文件最大大小（字节）
log_max_size = 5242880

# 保留的日志文件数量
log_backup_count = 3
```

### 启动方式

#### 方式一：使用图形界面（推荐）

1. 运行以下命令启动图形界面：

```
python gold_price_viewer.py
```

2. 在图形界面中，点击"启动金价监控"按钮即可开始采集数据

图形界面提供以下功能：
- 实时查看最新金价数据
- 启动/停止数据采集
- 每30秒自动刷新数据显示
- 查看历史数据记录
- 数据按标签页分为国内金价、国际金价和银行金价

#### 方式二：命令行方式

直接运行Python脚本开始数据采集：

```
python gold_price_tracker.py
```

程序运行后将：
1. 立即获取一次金价数据
2. 之后根据配置文件中设置的间隔时间（默认5分钟）自动获取
3. 所有数据保存在配置的目录下，默认为`gold_data`
4. 按`Ctrl+C`可以终止程序

### 数据查看

#### 方法一：使用图形界面查看器

如果数据采集已经在运行，可以单独运行图形界面查看数据：

```
python gold_price_viewer.py
```

#### 方法二：直接查看Excel文件

所有数据文件保存在配置的目录下（默认为`gold_data`），文件名格式为`gold_price_日期_时间.xlsx`，可以直接使用Excel或其他电子表格软件打开查看。

### 日志记录

程序运行过程中会记录详细的日志，默认保存在`gold_tracker.log`文件中。日志文件会自动轮转，防止单个文件过大。

日志级别可以在配置文件中设置，包括：
- DEBUG：详细的调试信息
- INFO：一般操作信息
- WARNING：警告信息
- ERROR：错误信息
- CRITICAL：严重错误信息

## 数据格式

生成的Excel文件包含以下工作表：

- **国内金价**：包含各类国内金价信息
- **国际金价**：包含各类国际金价信息
- **银行金价**：包含各大银行的金条价格信息
- **数据信息**：包含数据获取时间、来源信息和程序版本

## 项目结构

```
金价监控工具/
├── gold_price_tracker.py  # 主程序，用于获取金价数据
├── gold_price_viewer.py   # 图形界面，用于查看数据和控制采集
├── config.ini             # 配置文件
├── requirements.txt       # 项目依赖
├── README.md              # 说明文档
├── gold_tracker.log       # 程序日志
└── gold_data/             # 数据保存目录
    └── gold_price_*.xlsx  # 金价数据文件
```

## 版本历史

### v1.1.0 (当前版本)
- 添加配置文件支持，可配置数据获取间隔
- 添加详细的日志记录功能
- 优化代码结构和错误处理
- 在Excel数据文件中添加程序版本信息
- 支持通过图形界面启动数据采集

### v1.0.0
- 首次发布
- 支持获取国内金价、国际金价和银行金价数据
- 提供图形界面查看数据
- 自动保存数据到Excel文件