DeepSeek Harness 小白入门 18：max_tokens 为什么必须显式设置？新手最容易漏的护栏

DeepSeek Harness 小白入门 18：max_tokens 为什么必须显式设置？新手最容易漏的护栏

[!NOTE]
这是第二阶段 · 协议护栏的第 18 课。本文面向第一次接触 Agent Harness 的读者，目标是：为每次请求设置可解释的输出预算。真实练习场景是：给分类、问答、代码生成分配不同上限。全文基于deepseek-harness 0.2.0、项目仓库与 DeepSeek 官方 API 文档，在 2026-08-14 完成事实核验。

边界声明：deepseek-harness是第三方 MIT 开源项目，不是 DeepSeek 官方产品。DeepSeek 官方只对其 API 文档与服务负责；第三方仓库的实现、探针结论和后续维护需要使用者自行复核。

一、先把这节课讲明白

1.1 小白最容易混淆的地方

学习输出上限时，很多人第一反应是复制一段代码，只要控制台出现文字就认为成功。这个判断少了三层证据：请求是否按当前协议发送、返回是否完整、结果是否经过应用侧验证。Harness 的意义，就是把这些容易散落在业务代码里的适配逻辑收拢起来。

本课的核心结论是：max_tokens 同时影响成