# x-deepseek

**Repository Path**: chain-engine/x-deepseek

## Basic Information

- **Project Name**: x-deepseek
- **Description**: 一个完整的 DeepSeek 学习与实践项目
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# x-deepseek

`x-deepseek` 是一个完整的 DeepSeek 学习与实践项目，旨在帮助开发者快速上手和深入了解 DeepSeek AI 模型的使用方法。

## 项目结构

```
x-deepseek/
├── examples/         # 示例代码
│   ├── Integrate.py  # DeepSeek Chat 集成示例
│   └── list.py       # 模型列表查询示例
├── .env              # 环境变量配置文件
├── .gitignore        # Git 忽略文件
├── pyproject.toml    # 项目配置和依赖管理
├── .python-version   # Python 版本指定
└── README.md         # 项目说明文档
```

## 功能特性

- 📚 完整的 DeepSeek API 使用示例
- 🔧 环境变量管理，保护 API Key 安全
- 🛠️ 基于 uv 的现代化 Python 包管理
- 📖 详细的代码注释和使用说明
- 🚀 快速上手的示例代码

## 技术栈

- Python 3.11+
- OpenAI SDK
- python-dotenv
- uv (Python 包管理器)

## 快速开始

### 1. 安装依赖

```bash
# 安装 uv (如果未安装)
pip install uv

# 使用 uv 安装项目依赖
uv install
```

### 2. 配置环境变量

复制 `.env` 文件并填写你的 DeepSeek API Key：

```bash
# .env 文件内容
DEEPSEEK_API_KEY=sk-你的API密钥
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_BASE_URL_V1=https://api.deepseek.com/v1
```

### 3. 运行示例

#### 查询可用模型

```bash
python examples/list.py
```

#### 聊天示例

```bash
python examples/Integrate.py
```

## 示例代码说明

### 1. 模型列表查询 (list.py)

- 展示如何连接 DeepSeek API 并获取可用的模型列表
- 适用于了解 DeepSeek 提供的模型种类

### 2. 聊天集成 (Integrate.py)

- 展示如何使用 DeepSeek Chat 模型进行对话
- 包含完整的消息格式和参数配置
- 可作为实际应用的基础模板

## 学习资源

- [DeepSeek 官方文档](https://platform.deepseek.com/docs)
- [OpenAI SDK 文档](https://platform.openai.com/docs/quickstart)
- [Python 官方文档](https://docs.python.org/3/)

## 贡献指南

欢迎提交 Issue 和 Pull Request 来改进这个项目！

## 许可证

MIT License