# DOC 202：给 AI Agent 的 DeepSeek Harness 插件安装操作稿

更新：2026-10-13

请在我这台 Windows 电脑上完成 DeepSeek Harness（DSH）的插件安装与验证。目标是在 DSH 中使用我的 WorkBuddy 账号可用的模型，并用 Tavily 免费额度完成联网搜索。请检查已有环境、安装和配置两个插件、验证实际对话与工具调用；需要账号登录或输入密钥时，打开对应页面，让我自己完成后再继续。

## 一、检查环境并安装 DSH

优先复用已安装的 DeepSeek Harness 和已有配置，不覆盖已有账号、模型、凭据或工作区。缺少桌面端时，从官网 https://deepseek.com/harness/ 下载与本机架构匹配的官方安装包，完成安装并启动。

先检查 DSH 版本及插件页是否可用。教程基于 2026-10-13 的插件源码，界面如有变化，以当前版本实际显示的设置和插件说明为准。

检查本机 7863、8787 端口及对应进程。已有相同服务时检查来源和状态后复用；其他程序占用时先定位，不要按端口直接杀进程，也不要结束所有 node.exe。只使用本机回环地址；如代理影响本机接口，请保留原设置并让 localhost、127.0.0.1、::1 绕过代理。

不要购买套餐或充值，不要把密钥、登录凭据打印到聊天、写入 Git 或放进交付文件。只使用我自己账号已有的权限与额度。账号登录和密钥输入由我在对应页面完成。

## 二、在插件页面安装两个包

在 DSH 左侧打开“插件”，点击右上角“添加插件”，安装源选择“npm 官方源”，分别输入以下包名，点击“安装”：

```text
@zhiqiangme/dsh-autostart-workbuddy
```

```text
@zhiqiangme/dsh-tavily-search
```

确认两个插件均已启用，并能打开各自详情页的配置卡片。已经安装时先检查，不要重复安装或直接覆盖配置。配置卡片没有出现时，确认没有任务在运行后完全退出并重启 DSH。

本次通过插件页面完成，不要再手动克隆、解压 WorkBuddy 或 MiMo 的 GitHub 反代项目，不要另写 Start All / Stop All 脚本。WorkBuddy 后端由插件自身的“后端版本”功能管理。

## 三、配置 WorkBuddy 连接启动

1. 进入“插件 → WorkBuddy 连接启动”。首次使用时，在“后端版本”区域点击“安装”，等待插件下载并安装后端。已经安装则检查运行状态，不必重装。
2. 点击插件卡片里的“后端面板”链接，默认 http://127.0.0.1:7863/panel/ 。如果要求访问密钥，用卡片中的“复制访问密钥”，由我粘贴进面板，不要把密钥回显到聊天。
3. 在后端面板点击“添加账号”，按我账号所属的 CN 或国际版打开登录流程，让我在浏览器完成登录。确认账号及额度状态。
4. 回到插件卡片，点击“刷新”，读取后端真实模型列表。让我选择需要的模型；没有指定时可以先用账号中有额度的模型做短测试。保留模型的完整 ID，不要把显示名称当 API 模型 ID。
5. 开启“同步到 DSH 模型列表”，勾选模型并点击“保存并同步”；较早版本可能显示为“保存”。同步默认关闭，仅安装插件不会自动生成模型列表。一个都不勾选表示白名单为空，会同步后端全部模型。
6. 进入“设置 → 模型 → WorkBuddy”，检查协议为 OpenAI Chat Completions，Base URL 默认 http://127.0.0.1:7863/v1/ 。后端若启用了网关鉴权，把与后端面板一致的访问密钥保存到该提供商的 API Key（引用名为 WORKBUDDY_PROXY_KEY）。模型同步并不会自动保存这项凭据。不要选择 OpenAI Responses。
7. 新建对话，检查模型菜单。按该模型支持的档位选择推理等级；需要最大档时选择 Max，不要强行为上游不支持的模型添加档位。已有对话可能保留以前的选择。

插件随 DSH 启动后端，退出时只停止自己拉起的进程；已有外部服务不会被它停止。更新后端与更新插件是两个不同操作，分别在卡片对应区域完成。

## 四、配置 Tavily 联网搜索

DSH 默认的搜索接口需要付费，本次将搜索接入 Tavily 免费额度。Tavily 当前免费账户每月有 1,000 API credits，无需信用卡；不是无限量搜索。不同请求类型消耗不同额度，以 https://www.tavily.com/pricing 和账户后台为准。

1. 打开 https://app.tavily.com/home ，让我注册或登录并获取自己的 API Key。
2. 进入“插件 → Tavily 联网搜索”，让我在“添加 Tavily API Key”中填写并点击“添加”。密钥存入 DSH 凭据库，页面只显示末尾几位，不要将完整密钥写进设置文件或测试报告。
3. 确认“搜索接口”显示“运行中”，地址默认 http://127.0.0.1:8787/v1 。点击“测试搜索”，确认返回真实结果。
4. 在“网页搜索接入”区域点击“接入网页搜索”，确认变成“已接入”，内置网页搜索的接口地址改为 http://127.0.0.1:8787/v1 。
5. 如果卡片提示内置“网页搜索”页的 API Key 为空，进入“插件 → 网页搜索”，在它自己的 API Key 字段填非空占位值，例如 tavily-local。真正的 Tavily API Key 只放在 Tavily 插件中，不能替换内置网页搜索的密钥引用；恢复默认后该字段会被用于请求 DeepSeek 官方接口。
6. 确认内置网页搜索插件已启用；新建对话，要求 AI 联网查找一条信息并给出来源链接，验证实际工具调用。

插件支持最多 10 个我有权使用的 Tavily API Key，请按实际需要添加。多个 Key 在请求间轮流使用；某个 Key 失效、限流或额度用尽时，会尝试下一个。网络错误或上游故障需要另行排查。免费额度耗尽时停止该项测试，告诉我等待重置或自行决定是否升级，不自动付费。

“恢复默认”会把搜索切回 DeepSeek 官方接口，之后不再使用 Tavily 的免费额度。

## 五、验证与交付

不要只看模型列表或接口状态就宣称完成。按以下顺序做必要的短测试：

- 在 DSH 新建对话，选一个有额度的 WorkBuddy 模型，获得真实回复。
- 在独立测试目录中让 AI 读取一个小文件，再创建一个简单文本文件并回读，确认工具可用；不要改我的已有项目。
- 在 Tavily 插件卡片中点击“测试搜索”，确认成功。
- 在 DSH 对话中真正调用网页搜索，确认结果包含可访问的来源链接。
- 没有任务在运行时正常退出并重启 DSH，检查后端自动启动、模型选择和 Tavily 接入仍然有效。

失败时先定位具体原因：插件是否启用、后端是否安装、账号是否登录、密钥是否配置、模型同步是否开启、接口是否已接入、端口是否被占用、代理是否正常、额度是否可用。需要我处理登录或账号资格时，明确待处理项，继续其他能够完成的步骤。

交付只列实际安装版本、完成的配置和测试结果，明确仍待处理的事项；不输出任何密钥。后续维护用各插件卡片中的“检查更新”；当前安装来源不支持一键更新时，按插件说明处理，更新后重启 DSH。

参考说明：

- WorkBuddy 插件：https://github.com/zhiqiangme/dsh-plugins/tree/main/dsh-autostart-workbuddy
- Tavily 插件：https://github.com/zhiqiangme/dsh-plugins/tree/main/dsh-tavily-search