DeepSeek Harness：国内 API 上手

DeepSeek Harness（DSH）提供本地 Web 工作台，可以读取项目文件、执行任务并加载插件。本课使用 Windows PowerShell，启动工作台、连接 DeepSeek，然后整理一份 README；开始前需要 Node.js 和 npm。

安装并启动 DSH

本文固定 npm 已发布的 0.1.5-rc.1。DSH 仍是开发者预览，所参考的源码文档已到rc.2，部分界面或参数可能不同。

国内读者可以先用 npm 镜像下载。这里建议准备 Node24.x；发布包没有声明 engines，这不是最低版本要求。打开 PowerShell，创建练习目录并启动：

node --version
npm --version
$work = Join-Path $HOME 'agent-atlas-dsh-lab'
New-Item -ItemType Directory -Force -Path $work | Out-Null
Set-Location $work
npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh@0.1.5-rc.1 web

npx 提示下载时，确认包名和版本后继续。启动后会显示本机地址，默认端口为3080；浏览器没有自动打开时，复制这个地址访问。工作台保持本机访问即可。

--registry 放在包名之前，否则可能被当作 DSH 参数。以后启动仍使用上面的完整命令，保留版本和镜像参数；PowerShell 拦截 npx.ps1 时改用 npx.cmd。

这条 --registry 只对本次命令生效，不修改 npm 全局配置。镜像可能有同步延迟；遇到 ETARGET，先核对包名和版本，官方源可达时把地址换成 https://registry.npmjs.org 重试。镜像不代理 GitHub、官方安装脚本或模型 API，也不代装 Node.js、Git；证书报错时保留 SSL 校验，检查网络和系统证书。

**macOS / Linux：**目录操作使用 mkdir -p ~/agent-atlas-dsh-lab 和 cd ~/agent-atlas-dsh-lab，随后执行同一 npx 命令。

若端口被占用，先确认是哪项已有服务，不要随意结束未知进程。停止工作台回到启动终端按 Ctrl+C；停止进程不会自动撤销 API Key。

获取 DeepSeek API Key

按API 与配置的完整申请流程准备并保管 Key。DSH 特有的模型页面、工作区和协议设置见下一节；Key 不放在公开笔记、仓库、录屏或聊天消息中。

在 DSH 中连接 DeepSeek

**CC Switch v3.20.3 没有 DeepSeek Harness 应用入口。**它给 Claude Code、Codex 或 Pi 配置 DeepSeek 模型，并不是在管理 DSH。这里直接使用 DSH 自带的模型页面；其他工具的配置方法见 CC Switch 教程。

如果已有模型配置，先保留备份。打开设置→模型，在 DeepSeek 卡片填入 Key 并保存。修改会在下次请求时生效，不用重启，也不用手写 YAML。凭据文件和配置备份都不要公开。

添加并选中练习工作区，选择模型，再新建会话。没选工作区时输入框不可用。从当前模型列表中选择，旧教程里的 Flash 名称和价格可能已经变化。

简短验证

选定工作区和模型后，在不含隐私的练习目录让 DSH 只读取 README 并总结，检查工具记录确认没有写入。完整的读取、创建、检查和定向修改流程见第一项任务。

添加其他模型

优先查看“添加提供方”中的已安装目录。目录外服务走自定义 Provider：填写小写ID、真实服务基础URL、密钥与至少一个模型ID。协议必须明确选择：

一个提供方选一种协议；同一网关提供多个接口时分别创建路由。供应商的普通API与Coding Plan、国内与全球入口不能混用。当前官方用户指南写明 OAuth 提供方暂不支持；社区订阅插件属于另一层能力，不能当成内置登录选项。

在 DSH 的模型页面完成添加和编辑即可。新服务使用单独的供应商条目，保留原来的模型。如果服务需要表单之外的兼容参数，再查官方高级配置，不必一开始手写配置文件。

常见问题与恢复配置

401、额度、限流和通用超时按API 与配置的排错表检查。

回滚时停止DSH，逐个恢复备份文件，再重新启动；不要删除整个用户目录。练习文件与配置分别处理。npx 路线没有要求全局安装，不必为了“卸载”删除全部 npm 缓存或其他项目依赖。

升级前保留旧配置

出现问题时记下系统、Node 版本、DSH 版本、模型 ID 和具体错误。说明是在安装、连接模型还是文件操作时出错，截图隐藏密钥。

升级前保留旧版本命令和配置备份，按第一项任务在练习目录复核一次文件任务，再用于真实项目。开发者预览的更新可能改变配置格式。

下一步与参考资料

继续 DSH Skills 与 MCP。学习添加一个本地 Skill 和一个 MCP 记忆服务。

• 菜鸟：安装

• 菜鸟：第一次使用

• 菜鸟：模型配置

• npm rc.1 元数据

• 官方 API 文档

• 官方模型配置

• CC Switch 应用列表

• npmmirror 镜像站

• npm install：registry 与可选依赖

• npx 参数顺序

资料核对：2026-09-15；镜像包元数据已查询，安装、命令和 API 尚未实机测试。