简介《DeepSeek从入门到精通》是一份由清华大学新闻与传播学院团队出品的国产开源推理模型学习指南面向具备基础AI知识的技术人员、研究者及国产AI爱好者旨在解决“如何高效使用DeepSeek”和“如何从通用模型切换到推理模型”两大问题。全包仅1个PDF文件大小5.35MB内容覆盖智能对话、文本生成、语义理解、计算推理、代码生成补全等核心场景。文档深入对比推理模型与非推理模型的差异区分概率预测与链式推理CoT两条技术路线并结合数学证明、创意写作、代码生成等具体任务讲解指令驱动、需求导向、混合模式、启发式提问等提示语策略与常见误区帮助读者从“下达指令”进阶为“表达需求”掌握模型选型与提示语设计的关键原则。目前已吸引1935人学习是一份覆盖应用、原理与进阶技巧的高密度入门资料适合系统性提升大模型使用能力。1. DeepSeek 是国产开源推理模型里最适合拿来练手的那个DeepSeek 是国产开源推理模型里过去这段时间被讨论最多的一支权重开放、中文效果好、推理链路还看得见。我第一次把 DeepSeek-R1 跑起来时第一反应是这模型怎么这么慢一个问题要转半天才答。后来才理解慢就是这类模型的特性它把思考过程展开再压缩成答案等于把黑匣子掀开一角。你不但能知道它答了什么还能看见它怎么想。这篇文章想解决的问题很直接DeepSeek 这套模型能用在哪些场景本地怎么部署API 怎么接参数怎么调以及真正上线时会踩哪些坑。适合那些想把开源推理模型接到自己的代码库、编辑器或内网服务里的开发者也适合刚开始接触推理模型、想找一条可复现路径的数据工程师。读完你应该能照着步骤跑通一个最小服务并知道下一步往哪加东西。2. 推理模型到底“推理”了什么理解 DeepSeek 的能力边界与选型理由2.1 思维链不是聊天记录推理模型和对话模型的本质差异普通对话模型是接到 prompt 后直接补全答案 token训练目标就是“像人一样回答”。推理模型不同它在给出最终答案之前会先生成一段内部推理链把问题拆解成步骤必要时还会回到上一步重新计算。DeepSeek-R1 属于后者通过强化学习让模型学会长思维链遇到数学、逻辑、代码这类需要多步推导的任务优势非常明显。我在本地跑 R1 时观察到的输出结构一般是两段先是一段带“思考”标记的推理内容然后才是正式回答。这套设计不是花架子。调试时你可以直接看到模型在哪一步开始跑偏。比如一道鸡兔同笼题如果它把“设鸡为 x”这句理解错了你会第一时间看到而不是等它输出一个华丽但错误的答案。这在实际项目里省了大量盲调时间。但也要把话说清楚思维链不等于真正的通用规划能力。它仍然是自回归逐 token 生成不能并行处理多个分支也没有“全局重写”的能力。遇到需要同时约束多个条件的场景它可能在一个分支里走得很深然后忘记另一个约束。我的习惯是凡是超过三步、牵涉多个约束的任务都会在 prompt 里让模型先把约束列成清单再开始解题。2.2 开源权重带来的三种可复现玩法DeepSeek 这类模型能快速被工程圈接受一个重要原因是权重开放。对工程师来说开源意味着三件可落地的玩法。第一是本地私有部署。文档、代码、业务数据如果不想出内网可以把模型用 ollama 或 vLLM 拉起来对外只提供 OpenAI 兼容接口。这样既保留了数据控制权又能把模型接进现有的调用链。和纯云端 API 相比本地部署多了一台 GPU 机器的成本和运维负担但换来的是请求内容不出内网、没有按 token 计费。第二是微调。R1 发布后社区把它的长思维链输出整理成训练数据再用来微调其他模型。开源权重允许你做 LoRA 或全参数微调。常见做法是用几百到几千条领域问答样本把模型的推理风格保留同时把最终回答的格式改成你的业务风格。注意微调不要拿原始数据直接怼按“任务-推理-答案”三段式整理否则模型学到的只是表面措辞不是步骤。第三是蒸馏到小模型。R1 的蒸馏版覆盖了几种常见尺寸我在只有一张消费级显卡的机器上跑过 7B 蒸馏版虽然速度谈不上快但推理逻辑还在。对端侧项目来说这是把推理模型塞进有限显存的主要路径。蒸馏版的特点是保留“先思考再回答”的行为能力上限与大杯模型有差距但胜在能跑。还有一点必须提醒开源不等于无限制。落地商用之前先看模型许可证里关于商用、衍生品、保留声明的条款。这个动作花五分钟能避免后期麻烦。2.3 什么时候不该用 DeepSeek选型红线与替代方案推理模型不是万能药。我归纳了四类不适合硬上 DeepSeek 的场景新手尤其容易踩。第一多模态输入。R1 主线是文本推理图片输入能力很有限。需要识图、读表格截图之类应该选带视觉编码器的多模态模型或者先用 OCR 把图转成文字再交给 DeepSeek。第二高并发低延迟的在线对话。推理模型的生成路径比普通对话模型长首字延迟更高。如果服务是面向 C 端即时聊天建议用基础模型做首轮响应把 R1 留给真正需要深度推理的任务。第三长文档问答。DeepSeek 的输入窗口足够大但大窗口不等于模型自己会做检索。几万字文档塞进去模型很容易“读到后面忘了前面”。更可靠的做法是先用向量库召回相关片段再喂给模型。第四需要严格结构化输出的接口。推理模型倾向于先考虑问题再输出直接要求 JSON 时可能夹杂多余叙述。解决办法是把 JSON Schema 放进 system prompt并开启后端的结构化输出约束而不是靠提示词碰运气。下面是基础模型和推理模型在选型上的差异我通常按这几个维度判断维度基础对话模型DeepSeek 推理模型典型任务摘要、翻译、普通对话数学、代码、多步推理响应速度快首字延迟低慢需要额外思维链 token输出可解释性低直接给结果高思路可见典型调用成本低高因为生成 token 多适合场景高并发、在线服务离线分析、代码审查、深度问答简而言之基础模型当“快助手”推理模型当“思考协作者”两者可以共用同一套调用入口用模型名做路由。3. 本地部署 DeepSeek从 ollama 拉模型到 vLLM 上线的最小可复现路径本地部署是大多数人接触开源推理模型的第一步。部署方式很多我建议不要一上来就编译推理引擎先用 ollama 跑通链路再换 vLLM 提升并发。这套路径从零到服务最多一两个小时。3.1 用 ollama 在本地跑通 DeepSeek 的最小命令ollama 把模型权重、推理运行时和依赖打成一个包安装后两条命令就能跑# 拉取 DeepSeek-R1 的 7B 量化模型到本地 ollama pull deepseek-r1:7b # 直接运行冒号后面是问题 ollama run deepseek-r1:7b 用 Python 写一个读取 CSV 文件并输出统计信息的函数第一条命令会把模型权重下载到本地之后即使断网也能跑。第二条命令进入交互式对话输入问题后就能看到模型先输出一段推理内容再给出最终代码。这个行为特征是“推理模型”很直观的证据。参数这边默认上下文长度可能不够做长文档实验。可以用环境变量改# 将上下文长度提到 32K适合多轮对话或长输入 ollama run deepseek-r1:7b --num-ctx 32768--num-ctx控制模型一次能看到的 token 总数。数值越大占用的内存和计算量越大显存小的机器不要盲目拉到 64K否则会明显变慢。如果只有 CPU 没有 GPU也能跑 7B但生成速度会降到每秒几个 token 甚至更低。建议新手先用 7B 验证效果再决定是否上更大的参数版本。ollama 还自带一个本地服务默认监听 11434 端口。也就是说即使不装 Open WebUI你也已经可以把它当成一个后端服务给后面的工具调用和编辑器插件提供 OpenAI 兼容接口。需要界面时常见做法是再起一个独立的 WebUI 容器把地址指到 ollama 服务即可。3.2 用 vLLM 起一个兼容 OpenAI 的生产服务ollama 适合单机、个人验证。要同时服务多个应用我会用 vLLM 起服务。它最核心的优化是 PagedAttention用类似操作系统分页的方式管理 KV cache显存利用率比传统实现高不少支持连续批处理多路请求进来不会互相阻塞。vllm serve deepseek-ai/DeepSeek-R1-Distill-Qwen-7B \ --served-model-name deepseek \ --port 8000 \ --max-model-len 32768 \ --gpu-memory-utilization 0.9 \ --tensor-parallel-size 1这个命令需要先把vllm装好并保证能从模型源拉取权重。参数说明--served-model-name deepseek对外暴露的模型名后面调用方填这个名字就行。--port 8000HTTP 服务端口。--max-model-len 32768最大输入输出长度决定 KV cache 预留大小。--gpu-memory-utilization 0.9允许 vLLM 使用 90% 显存剩余留给驱动和别的进程。--tensor-parallel-size 1单卡部署填 1多卡填卡数比如 2 张 24G 显存的卡填 2。启动后服务地址是http://localhost:8000/v1/chat/completions与 OpenAI 接口兼容。这一步的意义是后面接 VSCode、Codex 或自研代码都不用改协议只需要换 base_url。3.3 量化等级怎么选Q4、Q8、FP8 与显存上限本地部署最容易纠结的是量化。量化是把模型权重从高精度压缩到低精度换来体积变小、推理变快代价是精度损失。DeepSeek 系列在 ollama 里常见 Q4、Q8vLLM 则支持 FP8、AWQ 等格式。量化等级典型精度优势代价Q4_K_M约 4 bit显存需求低精度损失明显Q5约 5 bit性价比折中仍有一定损失Q8约 8 bit精度接近原始显存需求翻倍FP88 bit 浮点支持较广适合生产依赖新显卡一个可用的显存估算公式模型权重显存约等于参数量乘每参数 bit 数再除以 8。7B 模型用 Q8权重约 7GB加上 KV cache 和激活值建议准备 12GB 以上显存。14B 的 Q8 建议 24GB。如果只能跑 Q4建议优先选效果损控更好的 Q4_K_M不要再用更低的量化。我踩过的一个教训是按“只要能加载就跑最大模型”来选型结果上下文一长就 OOM。正确的顺序是先确定业务需要多长上下文再反推 KV cache最后决定量化等级。下一步我们讲怎么把本地服务接进工作流。4. 把 DeepSeek 接进你的工作流API 调用、VSCode 与 Codex 接入本地服务和 API 的边界在很多团队里是同一件事。无论用 ollama 还是 vLLM对外都是 OpenAI 兼容接口。应用代码只需改一个 base_url 和 model 名就能在本地模型和云端 API 之间切换。下面按调用链路从浅到深走一遍。4.1 先看协议DeepSeek API 如何调用一次 curl 调通先用 curl 打一发请求确认服务存活curl http://localhost:8000/v1/chat/completions \ -H Content-Type: application/json \ -d { model: deepseek, messages: [ {role: user, content: 用 Python 实现冒泡排序并说明时间复杂度} ], max_tokens: 2048, temperature: 0.6 }如果返回 JSON其中choices[0].message.content就是最终答案。对云端 DeepSeek API常见的做法是把地址换成api.deepseek.com的地址并在请求头里加Authorization: Bearer API_KEY。我一般把 base_url 和 key 写进环境变量代码里不落任何明文密钥。返回结构里值得多看两个字段。usage.completion_tokens会告诉你模型这次实际生成了多少 token推理模型经常是你预估的两三倍这是后面压成本的主要依据。choices[0].finish_reason如果是length说明输出被 max_tokens 截断需要调大限额。这里的两个参数是后面调优的起点max_tokens限制生成的最大 token 数。推理模型会在正式答案前生成大量思维链所以这个值尽量给够否则答案会被截断。temperature采样随机性。逻辑题用 0.6 效果较好创意文案类可以提到 0.8 以上但推理任务不建议超过 0.7。4.2 提示词里的推理预算temperature、max_tokens 与思维链的配合刚开始接入的人往往会忽略“推理预算”这回事。普通模型一个 500 token 的问题200 token 就能答完同样问题给推理模型它可能要写 1000 到 2000 token 的推理过程。所以 max_tokens 不能按最终答案长度估要按“推理 答案”的总长度估。我的经验是把推理模型的 max_tokens 设成普通模型的三到五倍。比如代码补全设 2048数学解题至少 4096。多轮对话里还要考虑每轮思维链都累积进上下文越到后面越长。如果发现第二轮响应明显变慢且质量下降多半是上下文接近窗口上限。此时与其继续对话不如让用户起新会话或提前做一轮摘要把历史压短。采样参数方面推理模型的实践一般偏向低 temperature。原因很简单推理任务需要确定性和可复现性温度太高会放大思维链里的随机分支导致同一题两次结果不同。我通常固定 temperature0.6 并关闭 top_p 的额外调整只在创意任务里才放开。还有一个容易忽略的点不要用 top_p 和 temperature 同时猛调两个一起动输出更不可控排错也更难。如果你做的是 RAG 问答不要把整篇文档塞进对话历史。推理模型擅长的是在给定材料上做推导不是在海量材料里找答案。正确做法是先用检索把相关段落截出来再把“检索片段 问题”拼成一段 prompt。这样既能控制上下文长度也能降低“读漏关键段”的概率。4.3 VSCode / Codex 接入 DeepSeek配置文件的三个关键点代码编辑器接 DeepSeek是很多人一开始就想做的事。原理都是把编辑器里的 AI 插件指向一个 OpenAI 兼容端点。以 Codex 等 CLI 工具为例常见配置长这样model deepseek model_provider deepseek [model_providers.deepseek] name DeepSeek Local base_url http://localhost:8000/v1VSCode 里的 Continue、Cline 这类插件设置界面通常有“OpenAI 兼容 / 自定义 Provider”选项填三项base_url、API key 和 model 名。本地服务 API key 可以随便填一个占位符云端则填真实 key。这里三个关键点提醒一下。第一base_url 不要带/chat/completions写到/v1或域名根即可插件会自动拼路径。第二model 名必须和服务端--served-model-name完全一致不一致会报 404 或 model not found。第三插件默认的请求参数不一定适合推理模型很多插件会用偏小的 max_tokens导致长推理被截断。此时去插件配置里把 max tokens 调大或关掉自动递减。如果接入后报连接失败先看服务是否存活再看模型名是否对上最后再看插件日志里的实际请求 URL。三步排查比瞎改配置快得多。5. 避坑本地部署与推理调参的 5 个高频问题这一章是给已经动手的人看的。以下问题是我在本地部署 DeepSeek 和接 API 时反复踩过的每条按现象、原因、解决来写。5.1 生成结果被截断思维链吃光了 token 预算现象模型先输出一大段思考内容然后正式回答停在半句或者干脆报finish_reason: length。回头翻返回体发现usage.completion_tokens正好撞在max_tokens上。原因推理模型的思维链消耗 token 量远超预期。很多人按普通模型的经验把 max_tokens 设成 512 或 1024思维链一长答案连开始的机会都没有。更麻烦的是这种情况不会报错只会静静地把回答截断观感上就是“模型变笨了”。解决把 max_tokens 提到 2048 以上复杂任务给 4096。如果用的是云端 API还要注意部分接口要求用max_completion_tokens而不是max_tokens字段写错会被忽略看起来就像模型压根没收到长度限制。通用排查顺序是先看返回里的finish_reason再看实际生成的 usage 数字最后决定加多少。5.2 显存明明够vLLM 却报 CUDA OOM现象nvidia-smi显示显存还有空闲但 vLLM 启动或推理时直接 OOM进程被杀掉或者容器直接被重启。原因vLLM 启动时会根据--max-model-len和--gpu-memory-utilization预分配 KV cache预分配其实占掉了一大块显存。你看到的“空闲显存”并不等于 vLLM 可用的显存它可能已经提前把那部分空间圈走了。解决把--max-model-len降到实际业务需要的长度比如 16384 而不是 32768把--gpu-memory-utilization从 0.9 降到 0.7给其他进程留空间。还有一个容易忽略的点如果机器里还有别的进程占显存vLLM 不知道同样会崩。启动前用nvidia-smi --query-compute-appspid,used_memory --formatcsv查一遍比较稳妥。5.3 工具调用报错“messages tool calls need immediate results”现象DeepSeek 通过 API 做工具调用时本地推理服务返回错误提示工具调用后必须立刻有结果消息不能插入其他类型的消息。这类报错在网上经常被描述成“本轮运行失败”其实不是模型不行是消息顺序不对。原因协议要求模型发起 tool call 后下一条必须是由请求方构造的role: tool结果消息。很多封装代码在拿到 tool call 后先插一条role: assistant或role: user的说明顺序就错了。推理模型对顺序更敏感它已经按协议生成了调用请求结果你反而插了无关消息它就只能报错。解决严格按顺序追加消息。模型发出 tool call你马上把工具执行结果作为 tool 消息追加再发起下一次补全。示例逻辑如下messages.append({ role: assistant, tool_calls: [tool_call] # 保留模型发起的调用 }) messages.append({ role: tool, tool_call_id: tool_call[id], # 关联到对应的调用 content: json.dumps({status: ok, data: result}) }) response client.chat.completions.create( modeldeepseek, messagesmessages )这里的两个关键点是tool_call_id必须原样回传它相当于工具调用和结果之间的关联键content用可被 JSON 解析的字符串不要塞自然语言描述。检查 message 顺序时最容易出问题的是少了 assistant 这条或者 tool_call_id 对不上。5.4 量化后模型“像变笨了”不全是量化的锅现象同一个问题Q4 量化模型的推理结果明显不如 Q8有时连简单的逻辑判断都会出错让人怀疑模型是不是下错权重。原因量化有精度损失但更大的坑在参数配置。Q4 模型在长思维链任务里需要更多 token而 max_tokens 没同步调大导致每一步都草草收尾。另外上下文长度设置不同也会让长对话质量明显下降。也就是说你看到的劣化是“量化 上下文 长度限制”三个变量叠加的结果不能全怪量化。解决先做控制变量。固定 prompt、固定上下文长度只改量化等级跑同一批测试题。如果 Q4 和 Q8 差得不多说明问题在别处如果差很多再考虑换 Q8 或 FP8。补充一点蒸馏小模型对量化的容忍度不如大模型7B 蒸馏版已经压缩过一轮再用 Q4 压损失会被放大优先给这类模型配 Q8。5.5 同一提示词结果不稳定采样器实现差异现象同一个请求在 ollama 和 vLLM 上返回结果差异很大甚至在同一个框架里两次请求结果不同。调了半天参数感觉像是玄学。原因不同框架对 temperature、top_p、重复惩罚的默认值和实现方式不同。有些框架对温度有隐式的最小值约束有些框架的重复惩罚会改写采样分布让“生成长推理”和“防止重复”互相打架。这些差异在普通模型上不明显在生成上千 token 思维链的推理模型上会被放大。解决跨框架对比前先把采样参数全部显式固定temperature0、top_p1、不做重复惩罚。temperature0 时多数框架走贪心解码输出基本可复现。如果业务必须用高温度就固定用同一个框架不要在生产环境和测试环境混用两套推理引擎。把框架版本也记录下来升级 vLLM 或 ollama 后输出变了这就是优先怀疑对象。6. 进阶把 TTFT、工具调用与 harness 做成你的三层验收基准模型接上之后不能凭感觉说“效果还行”。我现在的验收习惯是三层指标首字延迟 TTFT、工具调用成功率、标准评测集分数。这三层分别回答快不快、能不能正确干活、和公开基线差多少。首字延迟是推理模型最容易被人诟病的指标DeepSeek 这类长思维链模型尤其要测。流式请求里从发出请求到收到第一个 token 的时间就是 TTFT。一次简单的 Python 计时如下import time import requests url http://localhost:8000/v1/chat/completions payload { model: deepseek, messages: [{role: user, content: 11? 一步一步想}], stream: True, max_tokens: 128, } t0 time.perf_counter() with requests.post(url, jsonpayload, streamTrue) as resp: for line in resp.iter_lines(): if line and bchoices in line: print(fTTFT: {(time.perf_counter() - t0) * 1000:.0f} ms) break这个脚本没有解析完整 SSE 协议只验证收到首个响应体的延迟。TTFT 受输入长度、排队请求数和显存状态影响我一般连续测 20 次取 P95比单个平均值更有意义。第二层是工具调用成功率。给模型一个需要调用搜索或数据库的任务跑 50 次统计“正确发起了 tool call”和“最终答案正确”的比例。为了避免依赖外部服务我通常用模拟返回工具接口只返回固定数据专门验证模型的调用顺序和参数构造。第三层是标准评测集。社区里常用的做法是 lm-evaluation-harness 配合 vLLM 加载本地模型。运行前先在小样本上跑通lm_eval --model vllm \ --model_args pretraineddeepseek-ai/DeepSeek-R1-Distill-Qwen-7B,base_urlhttp://localhost:8000/v1 \ --tasks gsm8k \ --limit 20--limit 20是关键先在 20 道上验证链路再跑全量避免一跑就是几小时才发现配置错误。这三层跑完模型能不能上线、需要怎么调参数基本就有了依据。我现在每换一个量化版本或上下文长度都会先跑一轮 TTFT 和一小批评测把数字记录在配置文件旁边。这个习惯帮我挡掉了不少“感觉变快了”的错觉。希望帮到你。本文还有配套的精品资源点击获取