连接 AI 文档

Appearance

DeepSeek Harness 接入 ​

DeepSeek Harness 的自定义模型入口是 Settings → Models → Add model provider → Custom model API。它不是 Claude Code 的 settings.json，也不是 WorkBuddy 的 models.json。

第 1 步：准备 Key 与 Harness ​

在 连接AI主站 创建可访问目标 DeepSeek 模型的 Key。使用网页版：先安装 Node.js，再在终端运行 npx @deepseek-ai/dsh web，按提示在浏览器打开；已经全局安装 dsh 的用户也可以运行 dsh web。使用桌面版：从 DeepSeek Harness 官方 Releases 安装并启动一次。两种版本的配置目录不同，快速导入时要选自己实际运行的版本。

在连接AI主站创建 DeepSeek Harness 专用 Key 的完整画面

打开原尺寸截图

图中是实际主站的完整画面；名称对应 DeepSeek Harness，分组为“DeepSeek（官Key）”。

方式 A：快速导入 ​

回到主站的 Key 列表，点击 快速导入 → DeepSeek Harness。复制命令并在运行 Harness 的电脑上执行。脚本默认加入当前分组的全部适用对话模型。导入器会检查 ~/.dsh/profiles/：只找到 web 或 desktop 中的一种时，自动写入对应版本的 cordis.patch.yml；两种都存在时，终端会先请你输入 web 或 desktop，确认自己实际使用的版本后再输入。这个选择发生在兑换一次性配置码之前。导入器会保留原有配置并加入 lianjieai 服务，结束时提示恢复文件位置。

DeepSeek Harness 自动导入全部适用模型的主站完整视口

打开原尺寸截图

这是已登录主站的真实完整视口。当前无需先选模型；不要把短时配置码分享给别人。

快速导入会把这把 Key 写入本机所选版本的配置文件。不要把该文件上传到仓库或发给他人；如果希望 Key 由 Harness 的凭据库保存，请按下方界面方式添加。

如果你使用 web、desktop 以外的自定义 profile，请按下面的界面方法添加。已有其他 llm-pi-ai 服务时，快速导入会尝试保留它们；若终端提示配置结构不兼容，也请改用界面添加。

方式 B：手动配置 ​

在主站点击这把 Key 的 快速导入 → DeepSeek Harness → 手动配置，确认当前使用的是 Web 还是 Desktop profile。页面默认勾选当前分组的全部适用模型，也允许取消部分勾选；将生成内容合并到页面标出的 cordis.patch.yml，保留原有 entries。这个文件含完整 Key，不要上传仓库。你也可以按下方步骤在客户端界面逐项填写；界面添加单个模型时，需要重复添加你想使用的其他模型。

DeepSeek Harness 模型多选、Profile 和配置文件的主站完整视口

打开原尺寸截图

截图中的完整 Key 已遮挡；请从自己登录后的主站复制实际配置内容。

在客户端界面中填写 ​

  1. 打开 Harness 的 Settings → Models。
  2. 点击 Add model provider，切换到 Custom model API。
  3. Provider ID 填 lianjieai，显示名称填“连接AI”，API 地址填 https://lianjieai.top/v1。
  4. API protocol 选择 OpenAI Chat Completions。
  5. 粘贴你在连接AI创建的 Key。Model ID 填该 Key 可用的完整文本模型 ID。
  6. 保存，打开模型选择器，选择 lianjieai 下的模型。

DeepSeek Harness 自定义模型 API 表单的本机完整视口

打开原尺寸截图

这张图来自本机 DeepSeek Harness 0.2.1-rc.2 的真实界面。API 密钥留空，YOUR_MODEL_ID 只是字段示意；请在自己的界面填入刚创建的 Key 和该 Key 实际可用的完整模型 ID，再点击“创建提供商”。

Harness 支持在界面中 Fetch available models。若列表读取失败，可以按 Key 实际可用模型手动添加 ID；保存后用下一步验证。

第 3 步：验证 ​

新建 Harness 会话，选择刚添加的模型，发送：

text
请只回复：连接AI配置成功

若提示 401，核对 Key；若提示模型不存在，核对 Key 分组及完整模型 ID；若仍指向 DeepSeek 官方地址，检查导入时选择的 web 或 desktop 是否正是当前运行的 profile。

桌面版的 desktop profile 由桌面应用管理。不要用 dsh --profile desktop 在终端验证，它会提示该 profile 只由 Electron 应用管理；请完全退出并重新打开桌面应用，再从模型选择器和测试消息确认结果。网页版则在浏览器中的 Harness 页面验证。官方桌面架构说明解释了两种运行入口的配置归属。

若 Key、地址和模型都正确，发送消息仍报请求格式错误，可打开当前 profile 的 cordis.patch.yml，在已有的 llm-pi-ai → config → providers → lianjieai 配置下增加以下两项，然后保存并重试。保留该提供商原有的 baseURL、headers 或 apiKeyEnv、models 字段。本页 DeepSeek 分组的快速导入会自动写入这两项。

yaml
compat:
  supportsDeveloperRole: false
  maxTokensField: max_tokens

官方配置结构与 UI 路径见 DeepSeek Harness 模型配置说明。