前言¶
在 DeepSeek Harness 里接 WorkBuddy、TRAE / TRAE CN、Qoder 等模型时，常见做法是手动填 OpenAI 兼容代理地址和 API Key，并在多个提供商之间切换配置。本机若已运行 AI-Toolkit 的本地代理，这些凭据和端口往往已在桌面应用与系统凭据库里维护，与 Harness 再抄一遍既重复，也容易和 AI-Toolkit 侧不同步。
下面介绍社区插件 DSH Connect AI-Toolkit（仓库 whyfail/dsh-connect-ai-toolkit）：在 DSH 中自动读取本机 AI-Toolkit 的代理设置与密钥，通过 GET /v1/models 发现可用模型，配置页只保留「新会话默认模型」一项，把新会话默认值写回 DSH 自带的默认模型服务。
这是什么¶
DSH Connect AI-Toolkit 由维护者 whyfail 发布，在 SkillHub 社区目录中归类为模型推理。插件供应商标识为 ai-toolkit-connect，在 Harness 中显示为 AI-Toolkit（自动连接），可与已有的 ai-toolkit 通用代理配置共存。
它解决的是：Harness 与 AI-Toolkit 同机、同系统账号运行时，免手工填写代理 URL 与 API Key，并在插件设置里为之后的新会话选定默认模型；已有会话仍使用原模型，需在会话内自行切换。
核心功能¶
自动连接与凭据¶
插件只读查询当前用户 ~/.ai-toolkit/ai-toolkit.db 中的本地代理端口，并通过操作系统凭据库读取代理 API Key。连接信息只保存在 DSH 宿主进程内存中，不写入插件配置、不返回浏览器、不写入插件日志。账号登录、余额与积分领取仍在 AI-Toolkit 的「积分与代理」中完成。
未安装 AI-Toolkit、应用未打开或代理未开启时，配置页下拉框会说明如何恢复并提供下载链接；点击下拉框可重新检测。DSH 与 AI-Toolkit 应使用同一系统账号、在同一台机器运行；插件配置页须在本机访问该 DSH 宿主。
模型发现与界面¶
模型目录来自 AI-Toolkit 代理的 GET /v1/models。连接正常时每 30 秒同步，断线时检查恢复；界面每 5 秒读取宿主状态。配置页仅有一个「新会话默认模型」下拉框，选项保留完整模型 ID 与来源；全部模型仍出现在 DSH 会话自身的模型选择器中，插件不会过滤目录或改写调用 ID。
选择模型后会显示对应平台 Logo。提交后通过 DSH 公开的模型解析与默认模型服务保存并读回确认；保存失败或模型失效时会明确报错。
推理与能力范围¶
模型调用走 AI-Toolkit 的 OpenAI Chat Completions 代理，保留流式响应与 DSH 工具调用。目录接口不包含积分余额、价格倍率或完整能力参数，插件不展示或推断这些数据。无元数据时使用明确的客户端预算默认值：上下文 32,768 Token、最大输出 4,096 Token，图片输入默认关闭。
插件不修改 AI-Toolkit 源码、账号记录或代理配置；SQLite 使用只读连接与 query_only。
安装与启用¶
兼容 DSH 0.2.1-rc.3 / 0.2.1-rc.5。先安装桌面版 Harness 并至少打开一次；执行安装命令前完全退出 Harness。公开安装包当前版本见 Releases（资料中 package 版本为 0.2.4）。须使用桌面版自带的 CLI 管理 desktop profile；单独通过 npm 安装的 DSH CLI 不能管理该 profile。
macOS 桌面版¶
复制并在终端执行：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "https://github.com/whyfail/dsh-connect-ai-toolkit/releases/latest/download/dsh-connect-ai-toolkit.tgz"
Windows 桌面版¶
已将 Harness 桌面版自带 CLI 加入 PATH 时，在 PowerShell 执行：
dsh.cmd plugin --profile desktop add "https://github.com/whyfail/dsh-connect-ai-toolkit/releases/latest/download/dsh-connect-ai-toolkit.tgz"
命令完成后重新打开 Harness，在 插件 → dsh-connect-ai-toolkit 中启用插件。
手动安装包¶
也可直接下载安装包，在 Harness 的 插件 → 添加插件 中填写下载文件的绝对路径，安装并启用。下载受限或没有桌面 CLI 时适用此方式。版本记录及 SHA-256 校验文件见 Releases 页面。
DSH 当前没有网页直接安装协议；上述「一键安装」指终端一条命令完成下载安装，启用仍由用户在应用中确认。
典型用法¶
经过上面的安装与启用，可按 README 中的顺序使用：
- 打开 AI-Toolkit，在「积分与代理」中连接账号、同步模型目录并开启本地代理。
- 在 DSH 安装并启用本插件，打开 插件 → DSH Connect AI-Toolkit 配置页。
- 在「新会话默认模型」中选择模型；选择结果会保存到 DSH 实际的默认模型配置，用于之后的新会话。
系统首次读取凭据可能要求授权，允许后点击下拉框重试。若凭据访问被拒绝，插件会暂停自动授权重试；允许访问后同样通过点击下拉框再试。
Web 侧开发调试时，README 给出通过 CLI 添加本地 pack 的示例（路径需改为本机绝对路径）：
dsh plugin --profile web add /absolute/path/dsh-connect-ai-toolkit-0.2.4.tgz
Electron 桌面的 desktop profile 由桌面应用管理，请通过桌面插件界面或上文桌面 CLI 安装。
适用场景与注意¶
适合谁： 已在同一台机器上使用 AI-Toolkit 本地代理，并希望在 Harness 里用 WorkBuddy、TRAE / TRAE CN、Qoder 等经该代理暴露的模型，且只想维护「新会话默认模型」、不想重复填 URL 与 Key 的开发者。
运行与权限： 插件以当前 DSH 宿主进程权限运行，会读取 ~/.ai-toolkit/ai-toolkit.db 与系统凭据库。安装前应自行查看仓库源码与 MIT 许可证（见 THIRD_PARTY_NOTICES.md）。
生态说明： DeepSeek Harness 的理念是「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，不要将其等同于官方应用商店。
开发环境： 若从源码构建，README 要求 Node.js 24.9 至 24.x；公开包通过 GitHub Releases 提供，尚未发布到 npm。
结尾¶
DSH Connect AI-Toolkit 把本机 AI-Toolkit 代理与 Harness 的默认模型配置接在一起：自动发现模型、界面极简，推理仍经 AI-Toolkit 调度。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
