DeepSeek Harness 是 DeepSeek 提供的本地开发工具，可以在 Windows 电脑上启动一个本地 Web 界面，用于调用模型。
本文以 Windows 为例，介绍从安装 Node.js 到启动 DeepSeek Harness 的完整流程。整个过程不需要购买服务器，但需要准备一个可用的 DeepSeek API Key。
一、准备工作
开始之前，请准备以下内容：
- 一台 Windows 电脑；
- 稳定的网络连接；
- 一个 DeepSeek 开放平台账号；
- 一个可用的 DeepSeek API Key。
API Key 可以在 DeepSeek 开放平台 创建。API Key 相当于账号凭证，请不要发布到文章、截图、代码仓库或聊天记录中。
二、安装 Node.js
DeepSeek Harness 依赖 Node.js 运行，因此需要先完成 Node.js 安装。
1. 下载 Node.js
打开 Node.js 中文官网，选择 Windows Installer（.msi）安装程序下载。
2. 开始安装
双击下载好的 MSI 安装程序，按照安装向导操作。
第一步直接点击 Next。
阅读许可协议后，勾选同意选项，然后点击 Next。
3. 选择安装路径
如果 C 盘空间充足，建议直接使用默认安装路径并点击 Next。
如果需要安装到其他磁盘，也可以在这里修改路径。不过修改路径后，需要确认 Node.js 的安装目录已经加入系统环境变量 Path。
后续步骤保持默认设置，直接点击 Next。
安装工具选项通常不需要额外勾选，继续点击 Next。
点击 Install 开始安装。
如果系统弹出管理员权限确认窗口，请点击允许。
等待安装完成，最后点击 Finish 退出安装向导。
三、配置环境变量
如果 Node.js 使用的是默认安装路径，安装程序通常会自动配置环境变量，可以直接跳过本节。
如果你将 Node.js 安装到了 D 盘或 C 盘中的其他目录，则需要手动检查并配置 Path。
1. 打开环境变量设置
在 Windows 搜索框中搜索“编辑系统环境变量”，打开对应设置。
点击 环境变量。
2. 添加 Node.js 路径
在“系统变量”区域找到 Path，双击打开编辑窗口。
点击 新建，添加 Node.js 的安装目录，例如：
D:\Program Files\nodejs请以你电脑上的实际安装路径为准，不要直接照抄示例路径。
点击 确定 保存所有设置。
3. 验证 Node.js 是否安装成功
按下 Win + R，输入 cmd，然后按回车打开命令提示符。
在命令提示符中执行：
node -v如果能够正常显示 Node.js 版本号，说明 Node.js 已安装成功，环境变量也配置正确。
四、启动 DeepSeek Harness
1. 获取官方启动命令
打开 DeepSeek Harness，复制页面提供的一键使用命令。
将命令粘贴到刚才打开的命令提示符窗口中。安装过程中如果出现询问，按照提示输入 y 确认。
等待命令执行完成。根据网络情况，这一步可能需要一段时间。
当命令提示符中出现本地 HTTP 地址时，说明 Harness 已经启动成功。
2. 打开本地 Web 界面
在命令提示符中按住鼠标左键，选中完整地址，注意不要漏掉最后的端口号。本文截图中的端口是 3080。
选中后点击鼠标右键，Windows 会自动复制选中的地址。
打开浏览器，访问：
http://127.0.0.1:3080如果终端输出的端口不是 3080，请以终端中显示的实际端口为准。
五、配置 DeepSeek API Key
首次打开 Web 界面时，页面会出现使用许可或配置提示，按照页面提示同意并继续即可。
随后页面会要求填写 API Key。打开 DeepSeek API Keys 页面，创建或复制一个可用的 API Key，粘贴到 Harness 的配置页面中。
API Key 只应填写在本地工具的配置页面中，不要将它提交到 GitHub 或公开发布。
六、选择工作目录
完成 API Key 配置后，选择一个工作目录。建议选择专门用于代码项目的文件夹，避免直接选择整个系统盘或包含大量无关文件的目录。
选择工作目录后，根据自己的需求选择模型。
七、测试对话功能
完成配置后，尝试发送一条简单消息。如果模型能够正常回复，说明 Node.js、Harness 和 API Key 都配置成功。
八、可选：全局安装 DeepSeek Shell
官方一键启动命令通常比较长。如果希望以后直接使用简短命令启动，可以将 DeepSeek Shell 全局安装到系统中。
在命令提示符中执行：
npm install -g @deepseek-ai/dsh等待安装完成。
安装完成后，执行下面的命令启动 Web 界面：
dsh web以后启动 DeepSeek Harness 时，直接执行 dsh web 即可，不需要再次粘贴完整的一键使用命令。
九、常见问题
1. 执行 node -v 没有显示版本号
通常是 Node.js 没有安装成功，或者安装目录没有加入 Path。可以重新打开一个命令提示符窗口，再次执行命令；如果仍然无效，请检查环境变量中的 Node.js 路径是否正确。
2. 浏览器无法打开本地地址
请确认命令提示符窗口仍在运行，并检查地址中的端口号是否与终端显示的一致。关闭命令提示符窗口后，本地 Harness 服务也会停止。
3. API Key 无法使用
请确认 API Key 没有多余的空格或换行，并检查 DeepSeek 开放平台账号是否有可用余额或调用权限。API Key 失效时，应在开放平台重新创建并替换。
总结
通过以上步骤，你就可以在 Windows 上完成 DeepSeek Harness 的安装和配置：
- 安装 Node.js；
- 检查环境变量；
- 使用官方命令启动 Harness；
- 打开本地 Web 界面；
- 配置 DeepSeek API Key；
- 选择工作目录并测试对话；
- 按需全局安装
dsh命令。
如果只是偶尔使用，直接运行官方一键命令即可；如果经常使用，建议全局安装 @deepseek-ai/dsh，以后通过 dsh web 快速启动。
如果内容对你有帮助，欢迎用微信或支付宝请我喝杯咖啡 ☕
评论
评论将由 AI 自动审核；需要人工确认的内容会在审核通过后显示。
正在加载评论……