企业官网建设流程全解析

awesome-deepseek-agent 实战指南：在 Factory AI Droid 中配置 DeepSeek V4 模型

【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent

本指南源自本仓库的 docs/deepseek-droid-guide-zh.md，完整讲解如何将 DeepSeek V4 Pro / V4 Flash 通过settings.json接入 Factory AI Droid。文章覆盖可用模型与 Base URL、customModels完整配置（Anthropic 与 OpenAI 两套兼容写法）、missionModelSettings的 Mission Model 设置、三种 Provider 类型的选型依据，以及常见故障排查方法。读完本文，你将能独立完成 Droid 的模型接入、默认 worker/validation 模型切换与 API 认证配置。

Factory AI Droid 与 DeepSeek V4 接入概览

Factory AI Droid 是一个支持自定义模型的 AI Agent 工具，其模型配置全部集中在用户目录的~/.factory/settings.json（旧版格式为config.json）中。接入 DeepSeek 的核心思路是：在配置文件的customModels数组中追加自定义模型条目，声明模型名、Base URL、API Key 与 Provider 类型，Droid 启动后即可在模型选择器中看到并使用这些模型。

本仓库（awesome-deepseek-agent）是一个 DeepSeek 模型接入指南合集，README.zh-CN.md 收录了 Cherry Studio、Claude Code、Cline、DeepSeek-TUI 等二十余款工具的接入指南，本文则是其中面向 Factory AI Droid 的一篇。仓库 CONTRIBUTING.md 同时确认了当前正确的模型命名为deepseek-v4-pro与deepseek-v4-flash（旧版deepseek-chat/deepseek-reasoner等 V3 名称已弃用），下文所有配置均遵循这一命名规范。

可用模型与 Base URL 一览

DeepSeek V4 系列在 Droid 中有两种 API 接入形态，对应两套不同的 Base URL：

• Anthropic 形态：走 DeepSeek 的 Anthropic 兼容端点/anthropic，API 格式为 Anthropic Messages API，适合习惯 Anthropic 生态（如 Claude Code）的接入方式；
• OpenAI 形态：走 DeepSeek 标准端点https://api.deepseek.com，API 格式为 OpenAI Responses API。

Pro 与 Flash 两个模型均同时支持上述两种 Provider 类型，你可以根据 Droid 的接入习惯任选其一。

配置文件位置与结构

配置写入用户主目录下的~/.factory/settings.json。文件不存在时自行创建即可，核心结构为：

• customModels数组：声明所有自定义模型，每条记录定义一个模型；
• missionModelSettings对象（可选）：指定默认的 worker / validation 模型。

注意：旧版 Droid 使用config.json，如果找不到settings.json，请检查旧版配置文件；无论哪种格式，更改都会被 Droid 通过文件监视自动检测，无需手动重启即可生效（详见下文故障排除一节）。

配置 Anthropic 兼容模型

在~/.factory/settings.json的customModels数组中追加以下两个条目，即可接入 Anthropic 形态的 DeepSeek V4 Pro 与 V4 Flash：

{ "model": "deepseek-v4-pro", "id": "custom:deepseek-v4-pro---Anthropic", "index": 1, "baseUrl": "https://api.deepseek.com/anthropic", "apiKey": "<your DeepSeek API Key>", "displayName": "DeepSeek V4 Pro", "maxOutputTokens": 384000, "noImageSupport": false, "provider": "anthropic" }, { "model": "deepseek-v4-flash", "id": "custom:deepseek-v4-flash---Anthropic", "index": 2, "baseUrl": "https://api.deepseek.com/anthropic", "apiKey": "<your DeepSeek API Key>", "displayName": "DeepSeek V4 Flash", "maxOutputTokens": 384000, "noImageSupport": false, "provider": "anthropic" }

配置 OpenAI 兼容模型

若希望走 OpenAI 形态（标准端点），则将baseUrl改为https://api.deepseek.com，provider改为openai，并调整id与displayName以示区分：

{ "model": "deepseek-v4-pro", "id": "custom:deepseek-v4-pro---OpenAI", "index": 1, "baseUrl": "https://api.deepseek.com", "apiKey": "<your DeepSeek API Key>", "displayName": "DeepSeek V4 Pro (OpenAI)", "maxOutputTokens": 384000, "noImageSupport": false, "provider": "openai" }, { "model": "deepseek-v4-flash", "id": "custom:deepseek-v4-flash---OpenAI", "index": 2, "baseUrl": "https://api.deepseek.com", "apiKey": "<your DeepSeek API Key>", "displayName": "DeepSeek V4 Flash (OpenAI)", "maxOutputTokens": 384000, "noImageSupport": false, "provider": "openai" }

注意：两套配置中的index都是从 1 开始的，若你在同一份配置中同时启用 Anthropic 与 OpenAI 两套模型，需要手动错开index值——Model indices 在所有 custom models 中必须保持唯一。

customModels 字段详解

结合上面两份配置，对每个字段逐一说明（其中字段语义为结合字段命名、取值与 Droid 配置惯例的理解，具体以实际生效行为为准）：

使用环境变量注入 API Key（推荐）

为避免把密钥明文写进配置文件，Droid 支持环境变量语法。将配置中的apiKey字段改写为：

"apiKey": "${DEEPSEEK_API_KEY}"

并在启动 Droid 之前，在终端中设置环境变量：

export DEEPSEEK_API_KEY=your_key_here

这样密钥只存在于当前 shell 会话（或你的 shell 启动脚本）中，配置文件可以安全地提交到版本库或与他人共享。

将 DeepSeek 设为 Mission Model（可选）

Mission Model 是 Droid 在自主任务（mission）中使用的默认 worker / validation 模型。要将 DeepSeek 设为默认，在同一份settings.json中更新missionModelSettings：

"missionModelSettings": { "workerModel": "custom:deepseek-v4-pro---Anthropic", "workerReasoningEffort": "none", "validationWorkerModel": "custom:deepseek-v4-flash---Anthropic", "validationWorkerReasoningEffort": "none", "skipUserTesting": true, "skipScrutiny": true }

字段说明：

补充说明：本仓库 CONTRIBUTING.md 指出 DeepSeek V4 Pro 支持max/high等多档推理强度，官方推荐在编码等复杂任务中启用更强思考以获得最佳体验。missionModelSettings中的workerReasoningEffort: "none"是追求吞吐与成本的默认选择；若你的自主任务对推理质量要求更高，可以尝试调整为 Droid 实际支持的更高档位并实测效果，具体取值以 Factory AI Droid 的文档与实测为准。

了解 Provider 类型：决定 API 兼容性的关键

Factory 支持三种 Provider 类型，它们决定了 Droid 以何种 API 协议与上游服务通信：

DeepSeek V4 Pro 和 V4 Flash 支持anthropic与openai两种 Provider 类型（如上文两套配置所示）；generic-chat-completion-api适用于通过 OpenRouter 等第三方聚合网关接入 DeepSeek 的场景——此时模型名与 Base URL 需改为对应网关的取值。

选择 Provider 类型的核心原则：Base URL 指向哪套 API 端点，provider就必须匹配对应的协议格式，三者交叉使用会导致请求失败。

DeepSeek V4 的模型能力背景

为便于理解maxOutputTokens等取值，这里补充本仓库确认的模型能力事实（见 CONTRIBUTING.md）：

• 1M 上下文窗口：DeepSeek V4 系列模型原生支持最高 100 万 token 的上下文窗口。Droid 的maxOutputTokens字段控制的是单次输出上限（配置为 384000），输入侧上下文能力则由模型本身提供；
• 多档推理强度：V4 Pro 支持max/high等推理强度档位，在 Anthropic 形态下可配合 thinking 相关配置使用，在 OpenAI 形态下可携带reasoning_effort参数（以 Droid 实际透传能力为准）。

这些背景有助于你理解为何配置中采用 384000 这一较大的输出上限，以及为何 Mission Model 可以显式声明推理强度。

故障排除

模型未出现在选择器中

• 检查~/.factory/settings.json（或旧版格式的config.json）中的 JSON 语法是否合法——多余逗号、未闭合括号是最常见原因；
• 设置更改通过文件监视自动检测，保存文件后稍候即可在 Droid 中刷新，无需手动重启；
• 验证所有必需字段（model、id、index、baseUrl、apiKey、provider等）都存在且取值完整。

"Invalid provider" 错误

• provider必须恰好是anthropic、openai或generic-chat-completion-api三者之一；
• 检查拼写并确保大小写正确，例如anthropic不能写成Anthropic。

认证错误

• 验证你的 API Key 有效且账户有可用配额；
• 检查 API Key 是否具有相应权限（在 DeepSeek 平台创建并正确复制）；
• 确认 Base URL 与所填 Provider 类型的协议文档匹配，即 Anthropic 形态用/anthropic端点、OpenAI 形态用标准端点。

速率限制或配额错误

• 检查 Provider 的速率限制与配额，V4 Flash 与 V4 Pro 的消耗不同，长任务请留意累计用量；
• 通过 Provider 的仪表板（DeepSeek 平台用量页）监控使用情况，必要时调整 Mission Model 中的推理强度或校验频率。

延伸阅读

• README.zh-CN.md：本仓库全部工具的 DeepSeek 接入指南索引，可对比 Claude Code、Cherry Studio、DeepSeek-TUI 等工具的配置差异；
• docs/claude_code.zh-CN.md：Anthropic 兼容端点在终端编程助手场景下的配置示例，与本文的anthropicProvider 形态互相印证；
• CONTRIBUTING.md：模型命名、1M 上下文、推理强度等接入规范的权威说明，接入任何新工具前建议先阅读。

【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent