# aquatic-export-compare

**Repository Path**: cy23/aquatic-export-compare

## Basic Information

- **Project Name**: aquatic-export-compare
- **Description**: Hermes根据需求做的 水产出口对比
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🐟 水产出口月度对比工具

读取海关统计数据查询平台导出的CSV/Excel，按指定15个商品编码提取出口量和金额，自动完成今年 vs 去年的同比对比分析。

## 使用方式

### 方式一：Web界面（推荐给同事用）

```bash
cd /home/cy23/aquatic-export-compare
source stock-venv/bin/activate
streamlit run customs_export_app.py --server.port=8503 --server.headless=true
```

打开浏览器访问 `http://IP:8503`，上传两个文件即可。

### 方式二：命令行

```bash
python customs_export_compare.py 今年数据.csv 去年数据.csv 输出结果.xlsx
```

## 数据处理流程

1. **读取文件** — 自动识别海关导出CSV的列（商品编码、商品名称、第一数量、美元），支持CSV(GB18030)和Excel格式
2. **按15个指定编码过滤** — 只保留目标水产商品，其余数据丢弃
3. **汇总** — 同编码商品跨贸易伙伴/注册地的数量和金额累加
4. **单位转换** — 第一数量(千克) ÷ 1000 → **吨**；美元 ÷ 10000 → **万美元**
5. **同比计算** — (今年 - 去年) ÷ 去年 × 100%
6. **大类汇总** — 按蟹/蛤仔/海蜇/扇贝/牡蛎五大类求和
7. **输出** — 一个Excel两张sheet：**明细表（15小类）** + **汇总表（5大类）**

## 输出结果

### 明细表（Sheet 1）- 15小类
| 列名 | 说明 |
|:---|:---|
| 商品编码 | 海关8位HS编码 |
| 商品名称 | 中文商品名称 |
| 出口量（吨） | 今年出口量 |
| 出口金额（万美元） | 今年出口金额 |
| 出口额同比(%) | 今年 vs 去年金额变化百分比 |
| 今年出口额(万美元) | 今年金额 |
| 去年出口额(万美元) | 去年金额 |

### 汇总表（Sheet 2）- 5大类
| 列名 | 说明 |
|:---|:---|
| 类别 | 大类名称（蟹/蛤仔/海蜇/扇贝/牡蛎） |
| 出口量（吨） | 该类下所有编码出口量汇总 |
| 出口金额（万美元） | 金额汇总 |
| 出口额同比(%) | 类级别同比 |
| 今年出口额(万美元) | 今年金额 |
| 去年出口额(万美元) | 去年金额 |

## 5大类别分
| 类别 | 包含商品编码 |
|:---|:---|
| 蟹 | 03063391 |
| 蛤仔 | 16055610, 03077191, 03077200, 03077900 |
| 海蜇 | 03083090, 16056300 |
| 扇贝 | 03072191, 03072210, 03072910, 16055200 |
| 牡蛎 | 03071190, 03071200, 03071900, 16055100 |

## 15个目标商品编码

| 编码 | 商品 | 类别 |
|:---|:---|:---|
| 03063391 | 中华绒螯蟹（活/鲜/冷） | 蟹类 |
| 03077191 | 蛤（活/鲜/冷） | 蛤类 |
| 03077200 | 冻的蛤、鸟蛤及舟贝 | 蛤类 |
| 03077900 | 干/盐腌/熏制的蛤等 | 蛤类 |
| 16055610 | 制作或保藏的蛤 | 蛤类 |
| 03083090 | 海蜇（冻/干/盐腌等） | 海蜇 |
| 16056300 | 制作或保藏的海蜇 | 海蜇 |
| 03072191 | 扇贝（活/鲜/冷） | 扇贝类 |
| 03072210 | 冻的扇贝 | 扇贝类 |
| 03072910 | 干/盐腌/熏制的扇贝 | 扇贝类 |
| 16055200 | 制作或保藏的扇贝 | 扇贝类 |
| 03071190 | 牡蛎（活/鲜/冷） | 牡蛎类 |
| 03071200 | 冻牡蛎 | 牡蛎类 |
| 03071900 | 其他牡蛎 | 牡蛎类 |
| 16055100 | 制作或保藏的牡蛎 | 牡蛎类 |

## 输入文件格式要求

海关平台导出设置：
- 进出口类型：**出口**
- 币制：**美元**
- 起止时间：**1月 ~ 当前月**
- 分组字段1：**商品**
- 分组字段2：**贸易伙伴**
- 分组字段3：**收货人注册地** → 编码 **21**（辽宁）

导出的CSV包含列：
`商品编码, 商品名称, 贸易伙伴编码, 贸易伙伴名称, 注册地编码, 注册地名称, 第一数量(千克), 第一计量单位, 第二数量, 第二计量单位, 美元`

## 输出结果列

| 列名 | 说明 |
|:---|:---|
| 商品编码 | 海关8位HS编码 |
| 商品名称 | 中文商品名称 |
| 出口量（吨） | 今年出口量（汇总后转为吨） |
| 出口金额（万美元） | 今年出口金额 |
| 出口额同比(%) | 今年 vs 去年金额变化百分比 |
| 今年出口额(万美元) | 今年金额（与第4列相同，方便左右对照） |
| 去年出口额(万美元) | 去年金额 |

## 文件说明

- `customs_export_compare.py` — 核心处理脚本
- `customs_export_app.py` — Streamlit Web界面

## 注意事项

- 未匹配到的编码（数据中不存在）自动输出 **0.0**
- 海蜇皮（16056300）等季节性产品可能在某些月份无数据
- CSV编码为 **GB18030**，脚本自动识别
- 美元金额中的逗号自动去除后转数值