DeepSeek Harness

在 DeepSeek Harness 中使用 LongCat 模型进行 AI 编程

概述

DeepSeek Harness 是 DeepSeek 开源的 Agent Harness 桌面应用（macOS / Windows），采用插件化架构。LongCat 系列模型支持在 DeepSeek Harness 中使用，本文档介绍如何将 DeepSeek Harness 与 LongCat API 开放平台对接。

使用前准备

1. 安装 DeepSeek Harness

在 DeepSeek 下载页 获取桌面端安装包：

• macOS（Apple 芯片，macOS 13 或更高版本）：下载 .dmg
• Windows（64 位）：下载 .exe

安装后启动应用即可。桌面端支持后台运行，可通过应用菜单「Check for Updates」检查更新。

2. 获取 LongCat API Key

在 LongCat 开放平台 获取您的 API Key，并在用量信息页面中确认账户内的 Token 额度充足。

LongCat API 开放平台目前提供以下模型：

模型名称	API格式	描述
LongCat-2.5	OpenAI/Anthropic	高性能Agentic模型

配置 LongCat API

DeepSeek Harness 的模型配置在「设置 → 模型」中完成，改动在下一次请求时生效，无需重启应用。

由于内置提供商目录中不含 LongCat，请通过「自定义模型 API」方式添加：

1. 打开设置

点击主界面左下角「更多」，在弹出菜单中选择「设置」。

2. 添加模型提供商

在设置左侧选择「模型」，点击「+ 添加模型提供商」，并切换到「自定义模型 API」标签页。

3. 填写提供商信息

按下表填写：

配置项	填写内容
Provider ID	longcat（小写字母开头，在请求中唯一标识该提供商，保存后不可修改）
显示名称	自定义名称，如 LongCat
API 地址	https://api.longcat.chat/openai/v1
API 协议	OpenAI Chat Completions
API 密钥	您的 LongCat API Key

API 密钥为只写保存，保存后页面只显示脱敏信息，密钥存储在本地凭据文件中。

4. 添加模型

在「模型目录」中点击「获取可用模型」，工具会使用当前填写的地址、协议和密钥拉取模型列表（LongCat 提供 /models 列表接口），勾选 LongCat-2.5 后添加。模型条目会自动带出上下文窗口（1048576）、最大输出 token 数（262144）等参数。若探测失败，也可以手动输入模型 ID LongCat-2.5，效果相同。

在模型条目的「输入类型」中勾选「图片」后，即可在会话中发送图片（LongCat-2.5 支持图片理解）。

5. 选择模型

保存后，在会话输入框的模型选择器中选择 LongCat-2.5。选择模型会同时将其设为新会话的默认模型。

进阶配置（可选）

进阶配置通过修改配置文件完成，路径为 ~/.dsh/profiles/desktop/cordis.patch.yml（$DSH_HOME/profiles/desktop/ 下，$DSH_HOME 默认为 ~/.dsh），保存后下一次请求时生效。也可以点击设置页右上角的「打开配置文件」直接打开。

注意：配置覆盖会替换对应提供商的完整条目，编辑已有条目时请保留其他原有字段。

开启图片输入

LongCat-2.5 支持图片理解（参见视觉理解文档）。直接在模型条目的「输入类型」中勾选「图片」即可（见上方配置步骤），无需修改配置文件。

如果习惯直接编辑配置文件，等效写法如下：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      longcat:
        api: openai-completions
        apiKeyEnv: LONGCAT_API_KEY
        baseURL: https://api.longcat.chat/openai/v1
        models:
          - id: LongCat-2.5
            input: [text, image]

关闭思考模式

LongCat-2.5 默认开启思考，API 通过请求体中的 thinking 字段控制：{"type":"enabled"} 开启、{"type":"disabled"} 关闭。

注意：LongCat API 仅支持开启/关闭思考，不支持思考等级（reasoning_effort 字段不生效）。推理档位中的 low/medium/high 配置后无效果，仅 off（关闭思考）有效。

在模型条目上打开「推理等级」开关即可配置推理档位；其中「关闭思考」档位还需配合 compat.thinkingFormat: deepseek（目前在配置文件中设置），之后在选择器中将推理等级切到 off 即会发送 thinking: {"type":"disabled"} 关闭思考；不切换则保持默认开启：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      longcat:
        api: openai-completions
        apiKeyEnv: LONGCAT_API_KEY
        baseURL: https://api.longcat.chat/openai/v1
        models:
          - id: LongCat-2.5
            compat:
              thinkingFormat: deepseek
            reasoningEfforts:
              off:

请求兼容性修正

LongCat 端点兼容标准 OpenAI 格式，一般无需额外配置。如果遇到端点拒绝请求的情况，可在提供商配置中尝试以下兼容性开关（路由级 compat 为模型默认值，模型自身的 compat 逐字段覆盖）：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      longcat:
        api: openai-completions
        apiKeyEnv: LONGCAT_API_KEY
        baseURL: https://api.longcat.chat/openai/v1
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
        models:
          - id: LongCat-2.5

使用 DeepSeek Harness

1. 配置完成后，点击「选择工作区」，添加你的项目目录并选中（选中工作区前会话输入框不可用）。
2. 在会话输入框中确认模型为 LongCat-2.5，输入问题即可开始对话。

常见问题

问题	解决方法
报错 MISSING_CREDENTIAL	在「设置 → 模型」中重新保存 API Key
推理等级 low/medium/high 设置后无效果	LongCat 不支持思考等级（reasoning_effort 不生效），仅 off（关闭思考）有效
报错 UNKNOWN_MODEL	在模型选择器中改选已配置的模型，或为提供商添加缺失的模型 ID
「获取可用模型」返回 401 或无列表	检查 API Key 是否正确；探测失败时可手动输入模型 ID，效果相同
会话中无法发送图片	在模型条目的「输入类型」中勾选「图片」（或按「进阶配置」声明 input: [text, image]）
修改 cordis.patch.yml 后配置丢失	配置覆盖会替换完整条目，编辑已有条目时需保留原有 provider 和字段

上一页

WorkBuddy 配置