# 更新日志

## v1.2 (2025-10-17)

### 新功能

#### 1. 汇率文件支持
- **功能**: 支持从 `exchange_rate.txt` 文件读取汇率
- **优先级**: 文件汇率 > 程序默认汇率
- **使用方法**: 
  ```bash
  echo "7.25" > exchange_rate.txt
  python3 generate_accounting_entries.py
  ```

#### 2. 智能汇率验证
- **范围检查**: 汇率必须在 0.1 ~ 100 范围内
- **格式验证**: 自动检测非数字格式
- **错误处理**: 异常情况自动回退到默认汇率 (7.1072)

#### 3. 详细日志输出
程序运行时会显示汇率来源:
- 从文件读取: `从 exchange_rate.txt 读取汇率: 7.25`
- 文件不存在: `汇率文件 exchange_rate.txt 不存在,使用默认汇率: 7.1072`
- 格式错误: `汇率文件 exchange_rate.txt 中的值无法解析,使用默认汇率: 7.1072`
- 值不合理: `汇率文件中的值 150.0 不合理,使用默认汇率: 7.1072`

### 代码修改

**文件**: `generate_accounting_entries.py`

1. **新增导入**: 
   - `import os` - 用于文件检查

2. **新增函数**: 
   - `load_exchange_rate()` (line 16-52) - 汇率加载和验证逻辑

3. **修改函数签名**:
   - `create_accounting_entries(data, exchange_rate)` - 添加汇率参数

4. **修改 main 函数**:
   - 调用 `load_exchange_rate()` 获取汇率
   - 传递汇率参数到 `create_accounting_entries()`

### 文档更新

1. **User.md**:
   - 更新"汇率配置"章节,添加文件方法说明
   - 更新 Q4 常见问题
   - 更新文件说明表,添加 `exchange_rate.txt`
   - 添加 v1.2 更新记录

2. **CLAUDE.md**:
   - 更新"Exchange Rate"配置章节
   - 添加详细的错误处理说明和示例
   - 更新版本历史

### 测试结果

✅ 正常汇率文件 (7.25): 成功读取  
✅ 文件不存在: 使用默认汇率  
✅ 非数字格式 (abc): 使用默认汇率  
✅ 不合理值 (150): 使用默认汇率

### 向后兼容性

- ✅ 完全向后兼容
- ✅ 不影响现有功能
- ✅ 无 `exchange_rate.txt` 文件时使用程序默认值

### 文件清单

| 文件 | 状态 | 说明 |
|------|------|------|
| `generate_accounting_entries.py` | 已修改 | 添加汇率文件读取功能 |
| `exchange_rate.txt` | 新增 | 汇率配置文件 (可选) |
| `User.md` | 已更新 | 用户文档 |
| `CLAUDE.md` | 已更新 | 开发文档 |
| `CHANGELOG.md` | 新增 | 本文件 |