一、简介DeepSeek Harness 是什么DeepSeek Harness 是一个在本机运行的工具用来调用 DeepSeek 的 Agent 服务。装好之后你只需要一个 API Key就能在浏览器里使用 DeepSeek 的智能体能力不需要自己搭建复杂的服务端。本教程的目标跟着下面的步骤从零开始完成「注册平台 → 创建 Key → 安装环境 → 启动服务 → 开始使用」全流程。所有操作都是复制粘贴命令零基础也能完成。 一句话总结先在 DeepSeek 平台拿到一把钥匙API Key再在本机装一个门Harness钥匙插进门里就能用了。二、准备工作开始前先收藏以下两个网站网站地址用途DeepSeek 开放平台https://platform.deepseek.com/sign_in注册账号、充值、创建 API KeyDeepSeek Harness 项目https://github.com/deepseek-ai/deepseek-harness官方源码与文档遇到问题可查 Issues三、整体流程先看全貌再动手注册登录DeepSeek 开放平台并完成充值调用服务需要账户余额打开API Keys菜单创建 API Key在本机安装 Node.js 22Windows / macOS 二选一见下文用一条命令启动 DeepSeek Harness在浏览器里填入 API Key开始使用⚠️重点提醒必看API Key 创建成功后只能查看一次页面之后无法再次显示。请创建后立刻保存到记事本或密码管理器万一丢了只能删除后重新创建。四、环境要求安装 DeepSeek Harness 之前电脑需要先安装Node.js 22 或更高版本。 如果不想用下面的版本管理器fnm也可以直接到 Node.js 官网nodejs.org下载22.x LTS安装包双击安装即可效果一样。下文给出的是更规范的 fnm 方式便于以后切换版本。五、Windows 系统安装请右键以管理员身份打开 PowerShell依次执行以下步骤。1. 一键安装 fnm Node.js 22 国内镜像源winget install Schniz.fnm fnm env--use-on-cd|Out-String|Invoke-Expressionfnm install 22 fnm default 22 npm configsetregistry https://registry.npmmirror.com这段命令做了三件事安装fnmNode.js 版本管理器用 fnm 安装并启用Node.js 22把 npm 源切换为国内镜像后续下载依赖更快更稳2. 验证是否成功输出 v22.x.x 即成功node-v npm-v npm config get registrynode -v显示v22.x.x→ Node.js 安装成功npm -v显示版本号 → npm 正常最后一行显示镜像地址 → 镜像配置成功六、macOS 系统安装打开终端依次执行以下步骤。1. 一键安装 fnm Node.js 22 国内镜像源curl-fsSLhttps://fnm.vercel.app/install|bash\exportPATH$HOME/.local/share/fnm:$PATH\eval$(fnmenv--use-on-cd)\fnminstall22\fnm default22\npmconfigsetregistry https://registry.npmmirror.com2. 写入 shell 配置永久生效echoexport PATH$HOME/.local/share/fnm:$PATH~/.zshrcechoeval $(fnm env --use-on-cd)~/.zshrc写入后以后每次打开终端都能直接使用fnm、node命令无需重复配置。3. 验证是否成功node-vnpm-vnpmconfig get registry看到v22.x.x即安装成功。七、启动 DeepSeek HarnessNode.js 装好后在Windows 的 CMD或macOS 的终端中执行npx deepseek-ai/dsh webnpx会自动下载并运行工具不需要手动全局安装一条命令搞定。启动成功后在浏览器中访问http://127.0.0.1:3080即可打开 DeepSeek Harness 的网页界面。八、配置 API Key在浏览器中打开http://127.0.0.1:3080进入设置页面填入第二步创建的 API Key保存后即可直接调用 DeepSeek 的接口开始使用九、相关页面截图官网地址注册、充值、创建 Key 的入口API 页面工具页面十、常见问题与注意事项API Key 是敏感信息相当于你账户的钥匙不要泄露给他人也不要在公开截图里露出完整 Key。Key 创建后只能看一次忘记保存只能重新创建建议创建后立刻存入密码管理器。调用服务需要余额建议先小额充值测试确认可用后再按需充值。本机服务只在本机可访问http://127.0.0.1:3080只有你自己能访问这是限制也是安全保证。安装失败怎么办先检查 Node.js 版本是否 22node -v安装类报错大多可以在 GitHub 仓库的 Issues 或搜索引擎中找到答案。不想用 fnm直接安装 Node.js 官网的 22.x LTS 安装包同样可以跳过 fnm 相关命令即可。
