# AutoReportV3 配置文件标准格式指南


## 1. 完整配置示例

### 示例1: 最小配置（仅UAV数据）

```json
{
  "data_root": "./AutoReportResults",
  "visualization_mode": "quantitative",
  "company_info": {
    "file_url": "D:\\data\\uav_data.zip",
    "north_east": "114.26,30.12",
    "south_west": "114.18,30.09",
    "south_east": "114.18,30.12",
    "north_west": "114.26,30.09"
  }
}
```

### 示例2: 完整配置（含采样数据和历史数据）

```json
{
  "data_root": "./AutoReportResults",
  "visualization_mode": "qualitative",
  "company_info": {
    "name": "无锡谱视界科技有限公司",
    "logo_path": "D:\\resources\\logo.png",
    "satellite_img": "D:\\data\\satellite.jpg",
    "wayline_img": "D:\\data\\wayline.jpg",
    "file_url": "D:\\data\\uav_data.zip",
    "measure_data": "D:\\data\\samples.csv",
    "kml_boundary_url": "D:\\data\\boundary.kml",
    "bin_url": "D:\\models\\water_quality.bin",
    "historical_data": [
      "D:\\history\\2023_data.h5",
      "D:\\history\\2024_data.h5"
    ],
    "north_east": "114.26520719343515,30.1216601533293",
    "south_west": "114.18517714804297,30.085906060008792",
    "south_east": "114.18517714804297,30.1216601533293",
    "north_west": "114.26520719343515,30.085906060008792",
    "watermark_config": {
      "enabled": true,
      "text": "无锡谱视界科技有限公司",
      "size": 65,
      "color": [200, 0, 0],
      "diagonal": true,
      "use_spire": true
    }
  }
}
```


## 2. 输出路径和报告模式
### `data_root` (必需)
- **类型**: 字符串（路径）
- **默认值**: `"./AutoReportResults"`
- **作用**: 所有输出文件的基础目录
- **说明**: 系统会自动创建带时间戳的子目录，格式: `report_YYYYMMDD_HHMMSS`

### `visualization_mode` (必需)
- **类型**: 字符串
- **允许值**: `"quantitative"` | `"qualitative"`
- **默认值**: `"quantitative"`
- **作用**: 地图可视化模式
  - `quantitative`: 连续色彩映射（基于数值大小）
  - `qualitative`: 分类色彩映射（按水质等级：GB 3838-2002标准）

---


## 3. `company_info` 配置块

### 3.1 公司基本信息（可选）

```json
"company_info": {
  "name": "无锡谱视界科技有限公司",
  "address": "江苏省无锡市新吴区菱湖大道200号E2-111",
  "email": "company@specvision.com.cn",
  "phone": "0510-85290662",
  "profile": "公司简介文本..."
}
```

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `name` | 字符串 | "无锡谱视界科技有限公司" | 公司名称（1-200字符） |
| `address` | 字符串 | "江苏省无锡市..." | 公司地址（1-500字符） |
| `email` | 字符串 | "company@specvision.com.cn" | 公司邮箱（需含@和.） |
| `phone` | 字符串 | "0510-85290662" | 公司电话（1-50字符） |
| `profile` | 字符串 | 长篇幅公司简介 | 公司介绍（显示在报告中） |

### 3.2 资源路径配置（可选但重要）

```json
"company_info": {
  "logo_path": "D:\\path\\to\\logo.png",
  "satellite_img": "D:\\path\\to\\satellite.png",
  "wayline_img": "D:\\path\\to\\wayline.png",
  "file_url": "D:\\path\\to\\data.zip",
  "measure_data": "D:\\path\\to\\measure.csv",
  "kml_boundary_url": "D:\\path\\to\\boundary.kml",
  "bin_url": "D:\\path\\to\\model.bin",
  "historical_data": ["D:\\path\\to\\history1.h5", "D:\\path\\to\\history2.h5"]
}
```

| 参数 | 类型 | 说明 | 格式 |
|------|------|------|------|
| `logo_path` | 字符串(URL/路径) | 公司Logo | PNG/JPG，本地路径或HTTP(S)链接 |
| `satellite_img` | 字符串(URL/路径) | 卫星影像 | PNG/JPG/TIFF图像 |
| `wayline_img` | 字符串(URL/路径) | 无人机航线影像 | PNG/JPG图像 |
| `file_url` | 字符串(URL/路径) | **UAV数据文件** | ZIP格式，包含 INDEXS.CSV, POS.TXT, REFL文件 |
| `measure_data` | 字符串(URL/路径) | 人工采样数据 | CSV格式（可选，不提供时只处理UAV数据） |
| `kml_boundary_url` | 字符串(URL/路径) | 边界定义文件 | KML格式（可选，不提供时自动检测边界） |
| `bin_url` | 字符串(URL/路径) | 预训练模型 | .bin格式的加密模型文件（可选） |
| `historical_data` | 字符串数组 | 历史数据集 | HDF5格式文件路径数组（可选，支持多文件） |

### 3.3 地理边界坐标（必需）

```json
"company_info": {
  "north_east": "114.26520719343515,30.1216601533293",
  "south_west": "114.18517714804297,30.085906060008792",
  "south_east": "114.18517714804297,30.1216601533293",
  "north_west": "114.26520719343515,30.085906060008792"
}
```

| 参数 | 格式 | 说明 |
|------|------|------|
| `north_east` | "经度,纬度" | 东北角坐标（WGS84） |
| `south_west` | "经度,纬度" | 西南角坐标（WGS84） |
| `south_east` | "经度,纬度" | 东南角坐标（WGS84） |
| `north_west` | "经度,纬度" | 西北角坐标（WGS84） |

**说明**:
- 用于定义UAV数据的地理范围
- 坐标格式: `经度,纬度`（WGS84）
- 如果提供了 `kml_boundary_url`，优先使用KML中的边界

### 3.4 水印配置（可选）

```json
"company_info": {
  "watermark_config": {
    "enabled": true,
    "text": "无锡谱视界科技有限公司",
    "size": 65,
    "color": [200, 0, 0],
    "diagonal": true,
    "use_spire": true
  }
}
```

| 参数 | 类型 | 默认值 | 范围 | 说明 |
|------|------|--------|------|------|
| `enabled` | 布尔 | `true` | - | 是否启用水印 |
| `text` | 字符串 | "无锡谱视界..." | 0-100字符 | 水印显示文本 |
| `size` | 整数 | `65` | 10-200 | 水印字体大小（磅） |
| `color` | RGB数组 | `[200, 0, 0]` | [0-255, 0-255, 0-255] | 水印颜色（RGB格式） |
| `diagonal` | 布尔 | `true` | - | 是否使用对角线布局 |
| `use_spire` | 布尔 | `true` | - | 是否使用Spire.Doc库 |

---
