DeepSeek Harness 上手：打开 0.2.1 新增的插件市场，选对四种模式，接入第三方模型

01先确认版本

DeepSeek Harness 是 DeepSeek 开源的 Agent 框架（MIT 许可），模型、工具、界面都以插件形式组合。可以从官网下载桌面版，也可以装好 Node.js 后运行下面的命令启动网页版，默认地址是 http://127.0.0.1:3080（见官方 README）。

npx @deepseek-ai/dsh web

截至 10 月 22 日，npm 上 @deepseek-ai/dsh 的 latest 标签指向 0.2.1-rc.2。项目仍是开发者预览版，官方明确说会有破坏兼容性的变更。本文提到的插件市场和自定义模型推理等级都需要 0.2.1-rc.1 或更新的版本，界面里找不到对应入口时，先检查版本。

02一、打开官方插件市场

0.2.1 的插件市场是一个官方的实验性组合包，名为“自定义插件市场”，默认关闭。按官方插件市场文档，开启步骤如下：

1. 打开左侧的“插件”页面，点击“实验性插件”旁边的“更多”。
2. 在列表里找到“自定义插件市场”，打开开关。这类官方按需插件首次开启时会弹出安装进度，装完即可使用。
3. “已安装”旁边会出现“发现”标签页。进入“发现”，点击“添加索引源”，粘贴一个索引文件的 URL。
4. 列表出现插件卡片就说明成功了。地址读不出来时，到市场菜单里的“管理索引源…”查看每个源最近一次的报错。

需要注意的是，官方提供的只是市场功能本身，DSH 不内置任何索引源，插件列表从哪里来要自己决定。所以“官方已经配好了插件市场”这种说法不准确：开关是官方的，市场里的内容都来自第三方。目前社区里常用的索引有下面两个，它们都不是 DeepSeek 官方提供的：

安装时会先弹出确认框，写明这个版本来自哪个 npm 包或 Git 仓库的哪次提交，确认之后才会安装，并照常做版本兼容检查。卡片默认推荐与当前 DSH 兼容的最高正式版本。官方文档特别说明，插件的标题、描述、作者都由市场自己填写，DSH 只检查格式，不验证内容；只添加你信任的索引源，http 地址在网络上可能被篡改，尽量用 https。市场打开后，创造模式还会多一个只读的 plugin_market 工具，Agent 可以帮你在市场里检索。

团队也可以自己搭市场：索引是一个 JSON 文件，放在任意静态主机上即可。仓库里附带了一个参考生成器，用一份包名列表就能生成索引，格式和命令见上面的官方文档。

03二、社区插件 dshmarket：另一种装插件的方式

在官方市场出现之前，社区已经有了 dsh-market（npm 包名 dshmarket）。这是社区项目，MIT 许可，不属于 DeepSeek 官方。它在 DSH 里加一个可视化插件市场，插件目录来自社区维护的 awesome-dsh-plugin 列表，只允许安装列表里登记过的来源。按它的 README，除了搜索和一键安装，它还提供主题切换、插件分组、更新检查、配置备份与恢复，以及插件加载冲突诊断。

• 桌面版：在“插件”页点“添加插件”，输入包名 dshmarket 安装。dsh-market README 也建议桌面版走应用自己的插件页，不要用命令行，因为应用运行时命令行改不了它的 profile。
• 网页版命令行：运行 dsh plugin --profile web add dshmarket，然后重启 dsh web。
• 入口位置：按其 README，0.2.1 起设置窗口移到了账号菜单里，市场仍在设置中；也可以在“插件”页它的卡片上打开选项，在侧边栏加一个“插件市场”入口。

安装源方面，官方插件管理器首次安装时会同时探测 npm 官方源和 npmmirror 国内镜像，自动选先响应的那个，也可以在对话框里手动改。国内网络下一般保持默认即可。

两者怎么选：只想找插件、装插件，官方“发现”加一个社区索引就够了，少装一个第三方组件；需要主题、备份、批量更新这类管理功能，再考虑 dshmarket。两者可以同时使用。无论哪种方式，装进来的插件都是第三方代码，会在你的电脑上运行，安装前看一眼确认框里的来源仓库。

04三、四种内置模式怎么选

模式（官方也叫 Agent 预设）决定一次任务里 Agent 能用哪些工具、用什么方式调用，并不会换一个更强的模型。新建任务时选择，已经开始的会话保持原来的模式。下表依据 0.2.1-rc.2 的内置预设配置和应用内的模式说明整理。

几点补充。第一，0.2.1 把内置默认模式从 PTC 或极简改成了标准，新手直接用标准即可。第二，PTC 常被说成“更省 token”，官方说明的原话是速度和 token 用量取决于具体任务与结果处理方式，标准模式同样能做批量任务，本站没有做过对比测试。第三，官网对极简模式的描述是“持久 bash 加文件编辑器”，而 0.2.1-rc.2 的预设配置里文件读写编辑都已关闭，只剩 Shell 和读图，文件改动通过终端命令完成，以实际版本为准。第四，如果在设置里关闭了“代码工作工具”，新建任务时只能选标准、创造和自定义模式。

05四、接入第三方模型或自建 API

模型配置都在“设置 → 模型”里，改完下一次请求就生效，不用重启（见官方模型配置文档）。按来源不同有三种做法：

1. DeepSeek 官方 API：在 DeepSeek 卡片里填 API Key 并保存。
2. DSH 自带的第三方提供商：点“添加模型提供商”，默认就是“第三方模型提供商”，从列表里选（列表显示的是提供商 id，例如 anthropic、openai、Kimi 对应 moonshotai、GLM 对应 zai），填 API Key 保存，端点、协议和模型列表会自动带出。
3. 中转站、公司网关、自建服务：把卡片切到“自定义模型 API”，填小写的 Provider ID、基础 URL、API 协议、API Key，再添加至少一个模型。协议只能三选一：OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages，要选网关实际使用的那一种；网关同时支持两种协议的话，需要建两个提供商。

自定义提供商可以点“获取可用模型”，向端点的 /models 接口查询模型列表，勾选后添加。不是所有网关都支持这个接口，探测失败或返回空列表时，手动填模型 ID 效果一样。Provider ID 建好后不能改，会话记录和默认模型都引用它，想改名只能新建一个再删掉旧的。

关于推理等级：0.2.1-rc.1 起，自定义模型 API 可以在界面里设置。编辑提供商，打开“自定义设置”，展开某个模型的“模型选项”，打开“推理等级”，默认带 off、low、medium、high 四档，每档对应发给接口的参数值。自带的第三方提供商则沿用内置目录里的等级，直接在输入框的模型选择器里切换。手动添加的模型没有声明等级时，选择器里不会出现推理等级菜单，这是常见的“找不到思考强度设置”的原因。

密钥填对、地址也通，网关却拒绝每一个请求，多半是请求格式和 OpenAI 有差异。官方文档给出的两个最常见修正，写在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 对应提供商下（用 dsh web 启动时 profile 就是 web；浏览器和服务在同一台机器上时，也可以点设置页顶部的“打开配置文件”）：

- id: llm-pi-ai
  config:
    providers:
      my-gateway:
        apiKeyEnv: GATEWAY_API_KEY
        api: openai-completions
        baseURL: https://gateway.example/v1
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
        models:
          - id: my-model

第一项让系统提示词不再以 developer 角色发送，很多网关不认这个角色；第二项把输出上限字段改成 max_tokens。如果通过 OpenAI 兼容网关调用 DeepSeek V4 这类默认就会思考的模型，off 档关不掉思考，需要给该模型加 compat.thinkingFormat: deepseek。以上示例来自官方文档，my-gateway 等名称要换成你自己的。

密钥保存在 $DSH_HOME/.credentials.yaml，页面只显示脱敏信息。0.2.1-rc.1 还调整了读取顺序：网页版和桌面版优先用已保存的密钥；headless 命令行模式默认读环境变量和 .env 文件，不读已保存的密钥，脚本里跑任务时要单独配置。配置成功的标志是模型出现在输入框的模型选择器里，发一条消息能正常返回。