DeepSeek API Toolkit

提供DeepSeek API接入方案、成本优化建议、Prompt优化及模型选型，助力高效集成与成本控制。

DeepSeek API 开发工具箱 — 成本优化、Prompt工程、集成模板一站式搞定

什么时候用这个 Skill？

当用户提到以下任何情况时激活：

• 使用 / 接入 DeepSeek API
• DeepSeek 模型（V3、V4 Pro、Reasonix、R1）
• AI API 成本优化
• 国产大模型集成
• 对比 DeepSeek vs OpenAI / Claude
• DeepSeek Prompt 优化

使用模式

模式 1：API 接入指南 🔌

用户想接入 DeepSeek API，提供完整接入方案。

执行步骤：

1. 读取 deepseek-api-guide.md 获取最新 API 端点和参数
2. 根据用户的技术栈（Python/Node.js/Java/curl）生成对应代码
3. 包含错误处理、重试逻辑、流式输出
4. 提供 API Key 配置最佳实践

输出格式：

markdown

## DeepSeek API 接入方案

### 端点信息
- Base URL: https://api.deepseek.com
- 模型选择: [根据需求推荐]
- 预估成本: [token 计算]

### 代码示例
[对应语言的完整代码]

### 注意事项
[错误处理、限流、最佳实践]

模式 2：成本优化顾问 💰

用户想降低 DeepSeek API 使用成本。

执行步骤：

1. 读取 cost-optimization.md 获取成本优化策略
2. 分析用户当前使用场景
3. 从 5 个维度给出优化建议：

维度	策略
模型选择	V4 Pro vs V3 vs R1，按任务类型推荐
Prompt 缓存	利用 DeepSeek 的前缀缓存机制
批处理	合并请求、减少 API 调用次数
Token 管理	精简 Prompt、控制系统输出长度
上下文优化	多轮对话的上下文裁剪策略

输出格式：

markdown

## 成本优化报告

### 当前方案分析
- 月调用量: [估算]
- 月成本: [估算]
- 主要成本来源: [分析]

### 优化建议（按收益排序）
1. [最大收益的优化]
2. [次要优化]
3. [长期优化]

### 优化后预估
- 月成本: [新估算]
- 节省比例: [百分比]

模式 3：Prompt 工程专家 🎯

用户想优化给 DeepSeek 的 Prompt。

执行步骤：

1. 读取 prompt-engineering.md 获取 DeepSeek 特有的 Prompt 技巧
2. 分析用户当前 Prompt 的问题
3. 应用 DeepSeek 优化框架：

text

原 Prompt → 问题诊断 → 优化 Prompt → 效果对比

DeepSeek Prompt 优化要点：

• DeepSeek 对 system prompt 的响应比 ChatGPT 更敏感
• 中文场景用中文 system prompt 效果更好
• V4 Pro 的推理能力可通过"思考链"提示充分激活
• R1 系列自带推理，不需要额外的 CoT 提示
• 利用 JSON mode 获取结构化输出

模式 4：模型选型顾问 🔍

用户不确定该用 DeepSeek 哪个模型。

执行步骤：

1. 读取 model-comparison.md 获取模型对比数据
2. 了解用户的使用场景
3. 给出推荐方案

决策树：

text

需要推理/数学/编码？
  ├─ 是 → Reasonix（最强推理）或 R1（轻量推理）
  └─ 否 → 需要最高质量？
              ├─ 是 → V4 Pro（综合最强，降价后性价比极高）
              └─ 否 → V3（最便宜，日常对话/翻译/摘要够用）

文件结构

text

deepseek-toolkit/
├── SKILL.md                    # 本文件 — 使用指南
├── deepseek-api-guide.md       # API 端点、参数、代码模板
├── cost-optimization.md        # 成本优化策略库
├── prompt-engineering.md       # Prompt 工程技巧
├── model-comparison.md         # 模型对比与选型指南
└── README.md                   # 产品介绍

注意事项

1. API 价格动态变化 — DeepSeek 的定价策略更新频繁（2025年5月 V4 Pro 降价 75%），每次使用时提醒用户确认最新价格
2. 兼容性 — DeepSeek API 兼容 OpenAI SDK 格式，可以复用大部分 OpenAI 生态工具
3. 限流策略 — DeepSeek 有请求频率限制，高并发场景需要做队列和重试
4. 数据合规 — DeepSeek 服务器在中国大陆，涉及敏感数据时需评估合规性
5. 缓存利用 — DeepSeek 的 Prompt 缓存命中率直接影响成本，优化 system prompt 结构可显著降低费用