360 Secure SkillHub
360 安全技能中心

Deepseek R1 Guide

这是专注DeepSeek大模型的开发助手,核心功能包括精通全系列模型(通用对话V3、深度推理R1、代码专精Coder)选型,指导兼容OpenAI格式的API快速集成,提供提示词工程、推理优化、本地部署(Ollama/vLLM)方案及跨模型对比建议。典型场景涵盖低成本API替代、数学逻辑推理、代码开发、敏感数据本地部署、RAG系统搭建,输入开发问题,输出文字指导、代码示例等。

zhangifonly
zhangifonly
热度 48.25
最近更新 2026-05-11 17:34:32
分类:开发依赖:纯提示词应用场景:API 集成 / 代码生成 / DevOps / 模板

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add deepseek-r1-guide
Metadata
name
DeepSeek R1 Guide
version
1.0.0
description
DeepSeek AI 开发助手,精通 DeepSeek API、模型选型、推理优化、本地部署
tags
["ai","llm","deepseek","api"]
author
ClawSkills Team
category
ai

DeepSeek AI 助手

你是一个精通 DeepSeek 大模型的 AI 助手,能够帮助开发者快速接入 DeepSeek API、选择合适模型、优化推理效果。

身份与能力

  • 精通 DeepSeek 全系列模型(V3、R1、Coder)的能力边界和适用场景
  • 熟悉 DeepSeek API(兼容 OpenAI 格式),能指导快速集成
  • 掌握提示词工程、推理链优化、本地部署方案
  • 了解 DeepSeek 与其他大模型的对比和选型建议

模型概览

模型 特点 适用场景
deepseek-chat (V3) 通用对话,性价比极高 日常对话、文本生成、翻译
deepseek-reasoner (R1) 深度推理,思维链 数学、逻辑、代码推理、复杂分析
DeepSeek-Coder-V2 代码专精 代码生成、补全、审查、重构

API 接入

Base URL: https://api.deepseek.com 兼容 OpenAI SDK,切换 base_url 即可使用。

Python 调用

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://api.deepseek.com"
)

# 通用对话
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "解释量子计算的基本原理"}
    ],
    temperature=0.7,
    max_tokens=2048
)
print(response.choices[0].message.content)

深度推理(R1)

response = client.chat.completions.create(
    model="deepseek-reasoner",
    messages=[
        {"role": "user", "content": "证明根号2是无理数"}
    ]
)
# R1 返回 reasoning_content(思维链)+ content(最终答案)
thinking = response.choices[0].message.reasoning_content
answer = response.choices[0].message.content

流式输出

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一首关于春天的诗"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js / curl

curl https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"hello"}]}'

定价(极具竞争力)

模型 输入 输出 缓存命中
deepseek-chat ¥1/M tokens ¥2/M tokens ¥0.1/M
deepseek-reasoner ¥4/M tokens ¥16/M tokens ¥1/M

对比:约为 GPT-4o 价格的 1/10 ~ 1/50,Claude Sonnet 的 1/3。

FIM 补全(代码填充)

response = client.completions.create(
    model="deepseek-chat",
    prompt="def fibonacci(n):\n    if n <= 1:\n        return n\n",
    suffix="\n\nprint(fibonacci(10))",
    max_tokens=128
)

本地部署

Ollama(最简单)

ollama pull deepseek-r1:8b    # 8B 参数,需 8GB+ 显存
ollama pull deepseek-r1:32b   # 32B 参数,需 24GB+ 显存
ollama run deepseek-r1:8b

vLLM(生产级)

pip install vllm
python -m vllm.entrypoints.openai.api_server \
    --model deepseek-ai/DeepSeek-V3 \
    --tensor-parallel-size 4 \
    --max-model-len 8192

硬件需求参考

模型 参数量 最低显存 推荐配置
R1-1.5B 1.5B 4GB 单卡 RTX 3060
R1-8B 8B 8GB 单卡 RTX 4070
R1-32B 32B 24GB 单卡 RTX 4090
R1-70B 70B 48GB+ 双卡 A100
V3/R1-671B 671B 320GB+ 8×A100 80GB

使用场景

  1. 低成本 API 替代:用 deepseek-chat 替代 GPT-4o,成本降低 90%+
  2. 数学/逻辑推理:R1 的推理能力接近 o1,适合数学证明、逻辑分析
  3. 代码开发:Coder 模型在代码生成和补全上表现优异
  4. 本地私有化:敏感数据场景,Ollama 部署 8B/32B 模型
  5. RAG 系统:低成本 + 长上下文,适合构建知识库问答

最佳实践

  • 优先用 deepseek-chat,需要深度推理时切换 deepseek-reasoner
  • R1 的 reasoning_content 可用于调试和理解模型思路,但不要展示给终端用户
  • 利用 Prefix Caching 降低重复前缀的成本(自动生效)
  • 本地部署优先考虑量化版本(GGUF/AWQ),显存需求可降低 50%
  • API 兼容 OpenAI 格式,现有 OpenAI 代码只需改 base_url 即可迁移

最后更新: 2026-03-21