# CBEC

**Repository Path**: duzicong/cbec

## Basic Information

- **Project Name**: CBEC
- **Description**: CBEC (Cross-Border E-Commerce) 是一个智能物流成本计算系统，旨在帮助跨境电商卖家精确计算物流运输的头程成本。系统结合了大语言模型(LLM)和数据处理能力，能够自动分析产品类别、选择最佳运输渠道并计算准确的物流成本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-07
- **Last Updated**: 2025-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CBEC - 跨境电商物流成本计算系统

CBEC (Cross-Border E-Commerce) 是一个智能物流成本计算系统，旨在帮助跨境电商卖家精确计算物流运输的头程成本。系统结合了大语言模型(LLM)和数据处理能力，能够自动分析产品类别、选择最佳运输渠道并计算准确的物流成本。

## 主要功能

- **参数验证**: 智能验证成本计算所需的参数是否齐全
- **运输渠道推荐**: 根据产品类别自动确定最合适的运输渠道
- **价格表提取**: 从Excel中自动提取并解析价格表数据
- **成本计算**: 基于产品信息和数量计算精确的物流成本
- **AI交互界面**: 通过DeepSeek大语言模型提供智能对话能力

## 系统架构

CBEC系统由以下核心模块组成:

- **Agent模块**: 提供成本计算代理，负责输入验证、运输渠道确定和价格计算
- **LLM模块**: 集成DeepSeek大语言模型，提供自然语言交互能力
- **Excel模块**: 负责从Excel价格表中提取和解析数据
- **Prompt模块**: 为大语言模型提供专业的提示词模板

## 技术栈

- Python 3.9+
- LangChain 框架
- Pandas (Excel数据处理)
- Pydantic (数据验证)
- Requests (API通信)
- DeepSeek API (大语言模型)

## 安装指南

1. 克隆代码仓库:
```bash
git clone https://github.com/yourusername/CBEC.git
cd CBEC
```

2. 安装依赖:
```bash
pip install -r requirements.txt
```

3. 配置API密钥:
在项目根目录创建`.env.local`文件并添加以下内容:
```
DEEKSEEK_API_KEY=your_deepseek_api_key
```

## 使用方法

### 运输成本计算

```python
from cbec.agent.cost import CostAgent
from cbec.excel.extractor import ExcelExtractor

# 初始化Excel提取器
extractor = ExcelExtractor("path/to/price_table.xlsx")

# 初始化成本计算代理
cost_agent = CostAgent(excel_extractor=extractor)

# 计算运输成本
total_cost = cost_agent.calculate_total_cost(
    product_info={"name": "手机配件", "weight": 5.0},
    quantity=100
)

print(f"总运输成本: ${total_cost}")
```

### 与DeepSeek模型交互

```python
from cbec.llm.deepseek import DeekSeek

# 初始化DeepSeek模型
model = DeekSeek()

# 交互对话
response = model.chat("请帮我计算这批商品的物流成本，商品是手机配件，重量5公斤，数量100个")
print(response)
```

## 项目结构

```
cbec/
├── agent/             # 代理模块
│   ├── prompt.py      # 代理提示词
│   └── cost.py        # 成本计算代理
├── excel/             # Excel处理模块
│   └── extractor.py   # 价格表提取器
├── llm/               # 大语言模型接口
│   ├── deepseek.py    # DeepSeek模型接口
│   └── model/         # 模型数据结构
├── prompt/            # 系统提示词
│   └── cost_agent.py  # 成本计算提示词
└── data/              # 数据文件
    └── price_table.xlsx # 价格表
```

## 许可证

[MIT](LICENSE)

## 贡献指南

欢迎提交问题和功能请求。如果您想贡献代码，请先开issue讨论您想更改的内容。

## 联系方式

如有任何问题，请通过[issues](https://github.com/yourusername/CBEC/issues)联系我们。