DeepSeek Harness（命令名 dsh）是 DeepSeek 开源的编码代理。目前处于 developer preview 阶段，上游配置可能随版本变化——接入前心里要有这个预期。

版本基线 v0.40.12，官方 docs.ollama.com/integrations/deepseek-harness。

一、快速启动

ollama launch dsh

需要时会自动安装 @deepseek-ai/dsh。

二、指定模型

## 本地模型
ollama launch dsh --model qwen3.8

## 云端模型
ollama launch dsh --model deepseek-v4-flash:cloud

只想改配置、不启动：

ollama launch dsh --config

三、联网搜索

默认自动启用。前提有两个：

1. 能访问 Ollama 云端
2. 所选模型支持工具调用

没登录的话先执行 ollama signin。

四、配置文件位置

Ollama 的设置写在：

~/.ollama/launch/dsh/settings.yaml

这个文件的加载顺序是最后加载，用来设定模型、provider 和联网搜索连接。几条行为约定：

• 重复 launch 会保留该文件里的其他设置，不会整体覆盖
• Ollama 不会修改 ~/.dsh/settings.yaml、profiles、sessions 或凭据
• launch 会拒绝额外的 --patch 参数
• 其他 Harness 参数放在 -- 之后：

ollama launch dsh -- --port 3081

这条设计的意图很清楚：把 Ollama 的注入和你自己的 DSH 配置隔离开，避免互相覆盖。

五、手动安装

需要 Node.js：

npm install -g @deepseek-ai/dsh@latest

装完再执行 ollama launch dsh。Windows 上需要安装 Windows 版 Node.js。

六、常见问题

现象	原因	处理
launch dsh 报错找不到命令	未装 Node.js 或 npm	装 Node.js 后重试
联网搜索不可用	未登录 / 模型不支持 tools	ollama signin，换支持 tools 的模型
--patch 被拒绝	launch 不允许该参数	去掉，用 -- 传其他参数
升级后配置失效	preview 阶段上游有变更	按新版文档重配

动手试

## ① 确认 Node 环境
node -v

## ② 启动
ollama launch dsh --model qwen3.8

因为还在 preview，建议先用云端模型跑通链路，再切本地模型验证性能。