DeepSeek Harness 保姆级安装教程：从环境配置到实战

DeepSeek Harness 作为一款可以在本地终端调用 DeepSeek 模型完成任务的工具，近期在国内开发者社区热度持续上升。但不少新手卡在环境配置、API Key 申请和工作区设置等环节。本文根据一份 B 站精选的实操教程整理成文字版流程，帮你把每个关键步骤走通，避免反复踩坑。

第一步：安装 Node.js 运行环境

DeepSeek^广告 Harness 依赖 Node.js 环境运行，所以安装它是整个流程的前提。打开浏览器搜索 Node.js，进入官网后点击 Download，选择左侧的 Windows Installer 下载主安装包。下载完成后双击打开，一路点击「下一步」即可完成安装，过程中无需做特殊配置。

安装完成后需要验证是否成功。按 Win+R（教程中口述为「Win 加 2」，实际应为运行窗口）输入 cmd 回车打开命令行窗口，输入版本查询命令并回车。如果终端返回类似 v20.x.x 这样的版本号格式，说明 Node.js 已正确安装；如果报错，则建议卸载后重新安装一遍。

第二步：通过命令行安装 Harness 本体

环境就绪后，就可以安装 DeepSeek Harness 本体。进入 DeepSeek 官网，点击右上角切换中文，在下拉菜单中找到 Harness 相关入口，页面会提供一条用于安装的命令。

复制该命令后，回到命令行窗口粘贴执行。执行过程中会提示输入 Y 确认，输入后回车即可开始下载。这一步会拉取较多依赖，耗时可能较长——部分大文件可能卡住几分钟，属于正常现象，耐心等待即可。

下载完成后，终端会提示一个 HTTP 本地链接，按住 Ctrl 并用鼠标左键点击即可打开，或手动复制到浏览器地址栏访问。打开后阅读提示信息，点击 Continue 继续。

第三步：申请并配置 API Key

Harness 本身不包含模型推理能力，需要调用 DeepSeek 的在线 API，因此必须配置 API Key。

回到 DeepSeek 网站，打开 API 开放平台，用手机账号登录。这里有一个关键前提：账户需要有足够余额，首次使用需要充值。教程提到如果使用频率不高，10 元额度能用很久，但具体消耗取决于你调用的模型和任务量。

登录后点击左侧的 API Keys，再点击 Create New API Key，给它取一个好记的名字，然后复制生成的密钥。注意：API Key 通常只在创建时完整显示一次，务必及时保存。

将复制的密钥粘贴回 Harness 配置页面即可完成授权。

API Key（应用程序编程接口密钥）是一种身份凭证字符串，用于向服务提供方证明调用者的身份并追踪用量计费。DeepSeek 的 API 采用按 Token 计费的方式——Token 可以粗略理解为文字片段，中文约 1.5–2 个字符对应一个 Token。不同模型的单价差异显著：V3-Flash 等轻量模型价格极低，而旗舰版 V3/R1 的价格则高出数倍到数十倍，因此日常测试建议优先选用 Flash 系列模型以控制成本。API Key 一旦泄露，他人可以用你的额度进行调用，因此不要将密钥提交到 GitHub 等公开代码仓库，也不要通过聊天软件明文发送。

第四步：创建工作区与选择模型

Harness 以 Workspace（工作区）为单位管理项目，建议一个项目使用一个独立文件夹，避免文件混乱和误操作。在合适的位置右键新建文件夹，取一个好记的名字，然后在配置中选择该文件夹作为工作区。

接下来是运行参数配置：

• 工作模式：教程中选择了「创造模式」
• 模型：选择 V4-Flash 模型（轻量快速，适合日常任务）
• 权限范围：选择 Workspace Write，可以把它的修改权限限制在工作区文件夹内，这是一个重要的安全设置，防止它误改工作区外的文件

配置完成后可以做一个简单测试，比如让它做个自我介绍，验证整条链路是否打通。需要特别提醒：运行 Harness 的命令行窗口在使用过程中不能中途关闭，否则会话会中断。

Workspace Write 权限是一种沙箱式的访问控制机制。当 Harness 以 AI Agent 模式运行时，它有能力自主读写文件系统——若权限范围不加限制，模型在执行任务时可能意外修改或删除工作区之外的文件（包括系统文件或其他项目）。将权限锁定在 Workspace 文件夹内，相当于给 AI 划定了一个「操作沙盒」，即便任务执行出现偏差，影响范围也被严格控制在该目录下。这一设计思路与容器化技术中的最小权限原则一脉相承，是使用任何具备文件操作能力的 AI 工具时都值得养成的安全习惯。

第五步：制作桌面快捷方式（可选）

每次都通过命令行手动启动比较繁琐，可以做一个桌面快捷方式简化流程。

在桌面空白处右键，选择「新建-快捷方式」，粘贴之前用于安装的那条命令（它同时也是启动 Harness 的命令），同样在后面加上空格和 --verbose 参数，点击下一步并命名，比如叫「DeepSeek Harness」或简写「DH」。

创建完成后，先退出之前的命令行窗口，再双击新建的快捷方式。启动后同样会显示一个 HTTP 链接，按住 Ctrl + 鼠标左键打开即可。这就是后续日常启动 Harness 的标准流程。

进阶：自定义快捷方式图标

如果想让快捷方式更美观，可以替换为 DeepSeek 的 Logo 图标。先打开 DeepSeek 官网下拉到 API 文档页面，右键左上角的 Logo，选择「将图像另存为」保存 PNG 图片。

由于 Windows 快捷方式图标需要 ICO 格式，搜索「PNG 转 ICO」在线工具，上传刚保存的 PNG 完成转换后下载 ICO 文件。回到桌面右键快捷方式，依次点击「属性-更改图标-浏览」，选中 ICO 文件确认即可。

小结：几个容易踩坑的点

整体来看，DeepSeek Harness 的安装门槛并不高，但新手最容易在以下几处卡住：

1. Node.js 验证失败，往往是安装不完整或路径问题，重装通常能解决
2. API Key 未保存，密钥只显示一次，错过就得重新生成
3. 账户余额不足，调用 API 需要先充值，否则测试会直接失败
4. 误关命令行窗口，导致会话中断
5. 权限设置过宽，建议始终限定在 Workspace，降低误操作风险

按照上述流程逐步操作，大多数用户都能顺利完成从环境配置到实战运行的全过程。