DeepSeek Harness

使用本指南将开源项目 DeepSeek Harness 接入 Felo API Platform 提供的模型。推荐方式是复用 Harness 内置的 deepseek-official 适配器；你也可以在 Web UI 中把 Felo 添加为独立的自定义 OpenAI-compatible provider。

DeepSeek Harness 当前仍处于开发者预览阶段，后续可能出现破坏兼容性的变更。如果选项或界面与本文不同，请同时查看上游项目的最新发布说明。

开始前准备

你需要安装 Node.js，并准备一个 Felo API Platform key。不要把 key 提交到版本控制系统。

export FELO_API_KEY="YOUR_API_KEY"

以下示例使用 deepseek-v4-flash。如需选择其他模型 ID，请先查看模型与价格。

推荐方式：使用内置 DeepSeek 适配器

DeepSeek Harness 通过 DEEPSEEK_API_KEY 读取内置适配器的凭据，通过 DEEPSEEK_BASE_URL 读取 endpoint。

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

打开 http://127.0.0.1:3080，然后：

1. 添加或选择你的项目工作区。
2. 打开设置 → 模型。
3. 选择 deepseek-official provider 和 deepseek-v4-flash 模型。
4. 新建会话并发送一个简单的仓库任务。

不要在 Base URL 后追加 /chat/completions。内置适配器会自行请求 {DEEPSEEK_BASE_URL}/chat/completions。

持久保存环境变量

DeepSeek Harness 可以读取启动目录下的 .env 文件。如果不想每次都执行 export，可以把以下内容保存到不受版本控制的 .env 文件：

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

不要提交该文件。需要用户级配置时，也可以使用 $DSH_HOME 下的 Harness 凭据和设置文件。

备选方式：自定义 OpenAI-compatible Provider

如果希望 Felo 作为独立 provider 显示，而不是覆盖内置 DeepSeek 连接，请使用此方式。

1. 运行 npx @deepseek-ai/dsh web 启动 Web UI。
2. 打开设置 → 模型。
3. 选择添加自定义提供方。
4. 填入下列值并保存。

如果模型发现失败，请手动添加模型 ID。提供方的获取可用模型操作依赖 OpenAI-compatible GET /models 路由，手动配置不要求该操作成功。

验证配置

新建会话并发送：

总结这个仓库，并指出其中的主要 package。

如果会话使用 deepseek-v4-flash 正常完成，并且没有认证或模型不存在错误，说明配置成功。

使用推荐适配器时，也可以在目标工作区运行非交互式检查：

npx @deepseek-ai/dsh --profile headless "列出这个工作区的顶层文件。"

Web Search 说明

以上配置只负责把模型请求路由到 Felo。DeepSeek Harness 内置的 web_search provider 有独立的 endpoint 要求，尽管它默认也使用 DEEPSEEK_API_KEY。除非你接入的是明确兼容的搜索 endpoint，否则不要把 DEEPSEEK_SEARCH_BASE_URL 指向 Felo。需要使用 Felo 搜索时，请单独调用 Felo 的 Chat API 或安装相应 Felo Skills。

故障排查

下一步

• DeepSeek Harness 仓库
• LLM API 参考
• Chat API 参考
• 面向 AI Agent 的 Felo Skills