第一次接触DeepSeek Harness，容易卡住的地方往往不是安装，而是打开界面后不知道在哪里填密钥、选哪个模型，以及为什么输入框不能使用。金沙token这篇教程就按实际操作顺序来讲：先把工具启动，再接入DeepSeek官网API或金沙API，最后完成一次简单任务。没有写过代码也可以先照着做，遇到报错时，再回头检查对应步骤。
一、安装前准备：先装好Node.js
DeepSeek Harness简称dsh，是DeepSeek开发的开源智能体运行框架，能够围绕工作区读取文件、修改内容和执行命令。使用远程API时，不需要先在电脑里下载DeepSeek模型权重，但需要安装运行工具所需的环境。
第一步：安装Node.js。 打开Node.js官网，选择适合自己系统的安装包。结合当前项目声明的版本要求，新手建议使用Node.js 24 LTS。Windows用户可以按安装向导完成安装，随后重新打开终端，让环境变量生效。
第二步：检查安装结果。 Windows打开PowerShell或命令提示符，macOS打开“终端”，依次输入：
node -v
npm -v两条命令都显示版本号，就可以继续。若提示找不到命令，先关闭终端重新打开；仍不正常，再检查Node.js是否安装完成，以及安装目录是否加入PATH。
二、下载并启动DeepSeek Harness
第三步：准备一个练习文件夹。 比如在电脑上新建dsh-demo，先放一份普通文本文件。Windows可以进入该文件夹，在资源管理器地址栏输入cmd并回车；macOS可以在终端使用cd进入对应目录。
第四步：运行官方启动命令。 在终端输入：
npx @deepseek-ai/dsh web首次运行时，npx会下载所需软件包。如果出现是否安装的询问，核对包名为@deepseek-ai/dsh后继续。下载耗时取决于网络情况，终端仍在处理时，先不要反复执行同一条命令。
正常启动后，本地Web界面默认地址为http://127.0.0.1:3080，本机启动通常会自动打开浏览器。如果没有自动打开，手动访问终端显示的地址即可。使用期间保持启动终端运行；关闭服务后，单独刷新网页并不能重新启动它。下次使用时，进入工作目录，再执行同一条启动命令。
三、选择工作区，完成安装后的基础设置
第五步：添加工作区。 打开界面后，点击 Choose workspace，添加刚才准备的dsh-demo文件夹并选中。当前官方指南说明，新打开的Web界面不会自动选好工作区；即使已经配置API，没有选择工作区，消息输入区域也可能暂时不可用。
工作区就是这次任务主要处理的文件目录。初次使用，选一个内容简单的练习目录会更容易看懂执行结果。接下来配置模型，下面的官网API和金沙API是两条独立接入路线，先完成其中一条即可。
四、DeepSeek Harness怎么接入DeepSeek官网API？
第一步：获取官网密钥。 打开DeepSeek开放平台，登录后进入API密钥管理页面，创建并妥善保存密钥，同时检查API账户是否有可用余额。能够登录网页版聊天，不代表API账户已经具备可用调用额度。
第二步：在Harness里保存密钥。 进入 Settings → Models，找到内置的 DeepSeek 配置卡片，填入刚创建的官网API Key并保存。当前官方配置指南中，这张卡片只需要填写密钥，内置配置会提供对应模型连接信息，新手无需另外编写配置文件。
第三步：选择模型并验证。 返回会话区域，在模型选择器中选择已配置的DeepSeek模型，新建会话，发送“请用一句话介绍你能帮我处理哪些文件任务”。收到正常回复，说明这次基础调用已经成功。模型配置会在后续请求中生效，无需为保存密钥专门重启服务。
若其他软件要求手动填写官网Base URL，DeepSeek官方API文档给出的地址是https://api.deepseek.com。不过，在Harness内置DeepSeek卡片中，直接按上述方式配置即可。
五、DeepSeek Harness接入金沙token API教程
第一步：获取金沙密钥与模型信息。 打开金沙token API文档，登录控制台，在“API密钥”页面新建密钥。随后查看金沙模型页面，确认当前账户可用的模型和准确模型ID。DeepSeek官网密钥与金沙密钥分别对应各自服务，配置时要和接口地址配套使用。
第二步：添加自定义提供商。 在Harness的 Settings → Models 中，点击 Add a custom provider，按下表填写。这里使用金沙文档列出的文本对话接口：
配置项填写内容Provider IDjinsha，使用小写，创建后不可直接改名Display name金沙tokenBase URLhttps://jinshaxinxi.cn/api/v1API protocolopenai-completionsAPI Key金沙控制台生成的密钥Model ID金沙当前提供且账户有权调用的准确模型ID
第三步：添加模型并保存。 在 Model catalog 中点击 Fetch available models，若能拉取列表，勾选需要的模型，再点击 Add selected，最后保存提供商。如果拉取失败，也可以根据金沙模型列表手动添加。Harness的自定义提供商至少需要一个模型，不能照搬金沙文档里其他工具“模型可留空”的说明。
第四步：新建会话测试。 选择金沙token下刚添加的模型，发送一条简短消息。Base URL填写到/api/v1即可，不要再拼接/chat/completions，也不要多加一层/v1。金沙文档给出的完整文本请求路径是/api/v1/chat/completions，后面的请求路径由工具处理。基础回复正常后，再测试读取练习文件；文本对话可用与工具调用可用需要分别确认，具体能力取决于所选模型和接口支持。
六、DeepSeek Harness使用指南：从一件小事开始
第一次运行任务，可以输入：“请读取当前工作区的文件，分别用一句话说明内容，暂时不要修改。”这类任务目标清楚，也方便对照原文件判断结果。读取正常后，再尝试：“请根据这些材料生成一份README草稿，写入新文件，不覆盖原文。”
接下来可以处理更具体的工作，例如整理项目说明、检查文章中的重复段落，或者分析一段代码报错。提问时把文件、目标和限制说清楚，比只输入“帮我优化一下”更容易得到可用结果。界面出现操作审批时，先看清它准备执行的命令或修改内容，再决定是否允许。
切换官网API和金沙API后，建议新建会话再测试。官方指南说明，已经发送过请求的会话会保留自身记录的模型；仅修改新会话默认模型，不能据此认定旧会话也已切换。长任务通常涉及多次模型请求，完成后可以到对应平台查看实际用量。
七、安装或连接失败，按这个顺序检查
命令无法运行： 先检查Node.js版本。如果Windows提示npx.ps1不能加载，可以改用命令提示符，或在PowerShell输入npx.cmd @deepseek-ai/dsh web。网页打不开： 查看启动终端是否仍在运行，以及是否提示端口占用；地址以本次启动输出为准。
401或缺少凭据： 检查密钥是否复制完整、保存成功，以及是否与当前提供商对应。404： 核对Base URL，尤其是金沙地址中的/api/v1，避免重复拼接路径。UNKNOWN_MODEL： 检查模型是否已经添加，模型ID是否与平台一致。
能聊天，但执行任务失败： 查看接口是否支持该模型的工具调用、流式响应和相关参数。如果报错明确指向developer角色或max_completion_tokens，可按Harness模型配置指南检查兼容设置。模型列表拉取失败也不必立刻重装，先手动填写准确模型ID验证调用。
这篇金沙token教程依据DeepSeek Harness官方项目说明、DeepSeek官网API文档和金沙接入文档整理。Harness目前仍处于开发者预览阶段，后续界面和配置可能变化。第一次使用，把工具启动、工作区选好、模型接通，再完成一个能核对结果的小任务，就有了继续上手的基础；之后无论使用官网API还是金沙API，都可以沿着这套顺序检查和调整。