在 Web 控制台完成 DeepSeek API 密钥配置并选择模型提供方，成功发起一次模型响应。
上一课在 http://127.0.0.1:3080 验证了本地控制台的首屏：preview 提示、API 密钥入口，以及工作区、模型、预设控件都已就位。先立一个前提：浏览器能看到界面，不代表模型在你机器上运行。默认的 DeepSeek 提供方会把请求发往远程 API，远程服务只认凭据。接下来的顺序是四步：在 DeepSeek 账户生成 API 密钥，把密钥填进控制台，选择模型提供方，再发一条消息验证。控制台返回一条模型回复，配置链路才算生效。控制台在本地，模型在远端——这个边界决定了每一步都要先有凭据，再谈模型。
核心概念
API 密钥
类比：API 密钥像一张绑定你账户的银行卡——服务方用它识别你是谁，每次推理费用都记在你名下，泄露了它别人就能替你花钱。技术定义：API 密钥是服务方签发的一串凭据字符串，调用远程模型 API 时用于鉴权与计费归属。DeepSeek Harness 要求先有密钥才运行 Agent 任务：未配置时多数功能保持锁定。密钥只能从你的 DeepSeek 账户的 API keys 区域生成，控制台只负责保存并在调用时发送，不能替你创建。鉴权通过后，请求才被受理并产生账单；鉴权失败则请求被拒绝。
核心概念
模型提供方
类比：模型提供方像手机运营商——手机负责界面与拨号，但通话服务由运营商提供，账单也来自运营商。技术定义：模型提供方是提供模型推理 API 的服务方。DeepSeek Harness 内置预设提供方，默认的 DeepSeek 路由指向 DeepSeek 兼容的远程 API，调用时必须携带凭据；自托管服务或公司网关只要暴露兼容端点，就能作为自定义提供方接入。推理费用按你选定的提供方计费。从提供方选中的模型会成为新会话的默认模型。预设提供方开箱即用，自定义提供方需要你提供端点信息——两者都走同一条鉴权与计费链路。
密钥在 DeepSeek 账户侧生成，不在控制台里创建。登录 DeepSeek 账户，进入 API keys 区域，生成一个新密钥，然后把密钥交给控制台。账户层级决定你能用哪些模型版本：同一把密钥可能同时解锁 Flash 与 Pro 两档模型，可按任务或会话切换——重活交给 Pro，轻量任务换 Flash，成本更可控。首次启动控制台时，界面先显示预览提示，再引导你填写密钥。
配置密钥并完成首次模型响应
- 1
确认
dsh web仍在运行；浏览器没有自动打开时，手动访问默认地址。texthttp://127.0.0.1:3080 - 2
登录你的 DeepSeek 账户，进入 API keys 区域，生成一个新的 API 密钥。
- 3
回到控制台：首次启动会先显示预览提示，随后引导填写 DeepSeek API 密钥，把刚生成的密钥粘贴进去。
- 4
跳过了首次引导也没关系，可以稍后在 Settings → Models 里补配密钥。
- 5
选择一个 workspace；控制台在选定 workspace 之前会禁用会话输入框。
- 6
从已配置的提供方中选择一个模型，该选择会成为新会话的默认模型。
- 7
选择一个 Agent 预设并查看权限模式，然后发送一个有边界的任务，例如：
textSummarize this repository and identify its main packages. - 8
若出现写文件或执行 shell 命令的审批请求，先审查再允许。
你应该看到
控制台内成功返回一条模型回复。回复出现即证明：密钥有效、提供方可达、计费链路已生效。若迟迟没有回复，回到 Settings → Models 核对密钥，并确认已选定 workspace。
控制台是你操作 Agent 的界面，不代表模型在你机器上运行。默认的 DeepSeek 提供方把请求发往 DeepSeek 兼容的远程 API，必须持有有效密钥；每次推理按所选提供方计费。界面在本地，算力在远端，账单归提供方。
自托管服务或公司网关只要暴露 DeepSeek 兼容端点，就能作为自定义提供方接入，控制台照常使用。预设与自定义提供方的完整清单见官方文档 https://deepseekplugin.com/docs/providers；名称与字段以该页为准，别照抄旧教程的截图。
API 密钥等同于账户的支付凭据。不要把它写进代码、提交到版本库或贴进公共对话；配置后由控制台保管并在调用时发送。怀疑泄露时，尽快回到 DeepSeek 账户的 API keys 区域重新生成密钥。
收到模型回复后，把它当作验收单：内容贴合任务、无报错，说明密钥与提供方链路正常。此后新会话默认使用你选中的模型；想换提供方或换模型，回到 Settings → Models 调整。权限边界也要看牢：默认权限预设是 workspace-write 并带审批提示；danger-full-access 会绕过文件系统隔离，不要随意启用。切模型时留意：不同模型版本的计费与能力不同，按任务量选择，别让轻量任务跑贵模型。
遇到问题：在控制台里无法发起对话：输入框不可用，或消息发出后迟迟等不到回复。
可能原因
- 没有选择 workspace——控制台在选定 workspace 之前会禁用会话输入框。
- 没有配置 API 密钥——Harness 要求先有密钥才运行 Agent 任务，未配置时多数功能保持锁定。
- 密钥不正确——粘贴了截断或写错的字符串，鉴权不通过。
排查步骤
- 先选择一个 workspace，再尝试发送消息。
- 进入 Settings → Models 补配密钥，或重新走首次启动的密钥引导。
- 回到 DeepSeek 账户的 API keys 区域核对或重新生成密钥，再更新到控制台。
自检：浏览器能打开本地控制台，是否说明模型已经在你机器上运行、可以免费使用？为什么？
不是。控制台只是操作界面，不表示本地推理。默认 DeepSeek 提供方把请求发送到 DeepSeek 兼容的远程 API，必须配置 API 密钥；推理费用按所选提供方计费。看到一条成功的模型回复，才证明凭据与提供方链路生效。