DeepSeek Harness 上手教程：桌面客户端安装、配置模型、工作区与插件

准备

• 一台能上网的电脑（Windows / Mac 均可；网页版方式另需 Node.js）
• 一个 DeepSeek API Key（在 DeepSeek 开放平台 获取；用第三方免费 Key 的看第 5 步）
• 一个想让 Agent 操作的项目目录（先拿测试目录练手，别直接上重要仓库）

步骤

1. 01

   先弄清 Harness 是什么、现在是什么状态

   DeepSeek Harness（简称 dsh）是 DeepSeek 开源的 agent harness：你说话，它去读写文件、运行命令、维护计划，把活干完。它基于 Cordis 的「一切皆插件」架构，能力靠插件组合扩展；既有桌面客户端，也能用一行命令启动成网页版，全球开放测试、代码同步开源。

   两点先说清楚：① 官方明确这是 developer preview（开发者预览），迭代很快，会有不兼容变更，教程截图和菜单位置以后可能对不上，以你手里的版本为准；② 先读一遍仓库里的安全说明（SAFETY.md），再让 Agent 碰你的文件——这是为你自己的数据负责。

2. 02

   安装桌面客户端（推荐）

   到官网 deepseek.com/harness 或 GitHub 仓库 releases 页 下载对应系统的桌面客户端安装包，正常安装后打开。

   客户端和网页版共用同一套能力：对话、/指令、@文件或对话引用、后台任务、插件扩展，哪个顺手用哪个。下面以客户端界面写步骤，网页版菜单位置基本一致。

3. 03

   （备选）一行命令启动网页版

   不想装客户端、或者要在服务器上跑时，用网页版。先装好 Node.js，然后执行：

   bash复制

   npx @deepseek-ai/dsh web

4. 04

   理解上面那条命令在干什么

   • 执行后默认在本机 http://127.0.0.1:3080 起一个 Web UI，本地启动时会自动用默认浏览器打开；
   • 只想起服务、不自动开浏览器，加 --no-open；
   • 启动命令所在的目录，就是 Agent 默认的文件活动范围——所以一定要 cd 到你的项目目录再启动，别在用户根目录起。

   （进阶）想从源码跑：git clone https://github.com/deepseek-ai/deepseek-harness，然后 pnpm install、pnpm run build、pnpm dsh web。

5. 05

   配置模型：先填 DeepSeek 官方 Key 跑通

   打开设置 → 模型，在 DeepSeek 卡片里输入 DeepSeek 开放平台 的 API Key 并保存。

   三件事记住：① 密钥框是只写的，保存后页面只显示脱敏信息，看不到明文，这是故意的；② 密钥实际存在本机 $DSH_HOME/.credentials.yaml，配置文件里只留引用——别把这个文件发给别人；③ 改完立即生效，不用重启，下一次请求就用新配置。

6. 06

   （省钱关键）把本站领的免费 Key 接进来

   Harness 的模型和 Key 是解耦的：除了 DeepSeek 官方，还可以在同一页添加模型提供商——内置的有 anthropic、openai、Kimi 对应的 moonshotai、GLM 对应的 zai，填 Key 即用。

   本站福利多是 OpenAI 兼容接口的免费额度，正好用「自定义模型 API」接进来：给一个小写 Provider ID，填 Base URL、选 API 协议、填 Key、至少加一个模型 ID。协议必须和网关实际用的一致（三选一：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages），一个提供商只用一种协议，网关两种都给就要建两个提供商——这是新手最容易翻车的地方。

   加完后在模型选择器里选中它，新会话就默认用它跑，Agent 的 Token 就花免费额度了。注意通过 OAuth 登录的提供商（例如 Codex）暂不支持。

7. 07

   选定工作区，再说话

   点击选择工作区，把你的项目目录加进来并选中。没选中工作区之前，对话输入框是不可用的——第一次用的人经常卡在这里找“为什么不能打字”。

   建议：给 Agent 单独建一个目录练手，跑顺了再让它进真正的项目。

8. 08

   跑第一个任务：让它读懂一个仓库

   开一个新会话，直接发一句话，例如：

   > 总结这个仓库的结构，指出它的主要模块，并列出三个最值得先看的文件。

   Agent 会读文件、列计划、动手执行。如果某个操作按当前权限策略需要审批，界面会先弹出来问你，看一眼它要干什么再点同意——尤其是删文件、装依赖、联网发请求这几类。

   任务跑起来后可以点开工具调用详情，看它每一步到底执行了什么、返回了什么。这是判断“它是在干活还是在瞎编”的唯一可靠办法，也是开发者排查问题用的执行轨迹。

9. 09

   日常用法：指令、引用、后台任务

   对话不只是聊天，有四种常用手法：

   • 描述需求：直接说“把这批 CSV 按月份汇总成一张表”，让它规划执行；
   • /调用指令：用斜杠调内置或插件指令，比纯说话更稳；
   • @文件或对话：把某个文件、某段对话点名拽进来当上下文，少废话；
   • 后台任务：耗时任务（跑脚本、批量处理文件）丢给后台执行，随时回来查看进度，不用干等。
10. 10

    装插件扩展能力，重复工作交给自动化

    Harness 的能力是插件拼出来的：需要什么就去装对应的插件；没有现成的，进「创造模式」直接用对话造一个——跟它描述需求，它帮你生成插件。

    有每天/每周都要跑的重复活，启用自动化任务插件，配好计划让它按时执行，你只在关键进展时看一眼。找插件去 GitHub 的 dsh-plugin 话题页，用的人会把自制插件挂在那里。

注意事项

• 预览版，随时可能变：官方说了会有兼容性破坏变更。某天菜单对不上、配置字段改名，先去仓库看最新文档，别硬套本教程。
• 密钥只存本机：$DSH_HOME/.credentials.yaml 别上传网盘、别截图发群；换电脑重新配一遍就行。
• 模型 ID 一字不差：自定义提供商的模型名必须是网关给的准确 ID；配完在模型目录用「获取可用模型」探测一下，列表为空就手动填，效果一样。
• 协议和地址是两大坑：网关连得上但每个请求都被拒，八成是协议选错，或系统提示词角色/输出上限字段和网关不兼容——去官方 providers 指南里按 compat 开关排查。
• Agent 很能花 Token：长任务会连续调很多次模型。先用免费额度跑，顺手了再上付费 Key；计费细则看各模型平台。
• Through SSH 注意地址：远程启动时只打印 host URL（因为转发地址归 SSH 客户端管），按打印的地址自己拼浏览器访问。

常见问题

相关优惠

• 折扣 · DeepSeekDeepSeek 错峰半价空闲时段半价

查看 DeepSeek 的全部福利 →

信息来源

• DeepSeek Harness 官网www.deepseek.com/harness/
• GitHub · deepseek-ai/deepseek-harnessgithub.com/deepseek-ai/deepseek-harness
• GitHub Releases · 桌面客户端下载github.com/deepseek-ai/deepseek-harness/releases
• 官方文档 · Web UI 使用指南（中文）github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.zh.md
• 官方文档 · 模型配置指南（中文）github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/providers.zh.md
• dsh-plugin 话题页github.com/topics/dsh-plugin

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准