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模型ProviderBase URLDeepSeek V4 ProAnthropichttps://api.deepseek.com/anthropicDeepSeek V4 FlashAnthropichttps://api.deepseek.com/anthropicDeepSeek V4 Pro (OpenAI)OpenAIhttps://api.deepseek.comDeepSeek V4 Flash (OpenAI)OpenAIhttps://api.deepseek.comAnthropic 形态走 DeepSeek 的 Anthropic 兼容端点/anthropicAPI 格式为 Anthropic Messages API适合习惯 Anthropic 生态如 Claude Code的接入方式OpenAI 形态走 DeepSeek 标准端点https://api.deepseek.comAPI 格式为 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.comprovider改为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 配置惯例的理解具体以实际生效行为为准字段含义与建议取值model上游 API 识别的模型标识填deepseek-v4-pro或deepseek-v4-flash。这是 DeepSeek 平台当前的正式模型名V3 旧名已弃用。idDroid 内部唯一标识采用custom:model---Provider命名约定例如custom:deepseek-v4-pro---Anthropic。该 ID 也是后续missionModelSettings中引用模型的依据。index在模型选择器中的排序序号所有 custom models 中必须唯一。baseUrlAPI 端点地址Anthropic 形态为https://api.deepseek.com/anthropicOpenAI 形态为https://api.deepseek.com。apiKey你的 DeepSeek API Key可硬编码也可使用环境变量语法${DEEPSEEK_API_KEY}见下文。displayName模型在 Droid 界面中显示的名称可自由定制。maxOutputTokens单次输出的最大 token 数本文配置为384000。noImageSupport是否不支持图片输入false表示支持视觉输入两套配置均保持false。providerProvider 类型Anthropic 形态填anthropicOpenAI 形态填openai取值必须精确匹配见了解 Provider 类型一节。使用环境变量注入 API Key推荐为避免把密钥明文写进配置文件Droid 支持环境变量语法。将配置中的apiKey字段改写为apiKey: ${DEEPSEEK_API_KEY}并在启动 Droid 之前在终端中设置环境变量export DEEPSEEK_API_KEYyour_key_here这样密钥只存在于当前 shell 会话或你的 shell 启动脚本中配置文件可以安全地提交到版本库或与他人共享。将 DeepSeek 设为 Mission Model可选Mission Model 是 Droid 在自主任务mission中使用的默认 worker / validation 模型。要将 DeepSeek 设为默认在同一份settings.json中更新missionModelSettingsmissionModelSettings: { workerModel: custom:deepseek-v4-pro---Anthropic, workerReasoningEffort: none, validationWorkerModel: custom:deepseek-v4-flash---Anthropic, validationWorkerReasoningEffort: none, skipUserTesting: true, skipScrutiny: true }字段说明字段作用workerModel自主任务主执行模型此处引用前面定义的custom:deepseek-v4-pro---Anthropic即用 V4 Pro 承担核心工作。workerReasoningEffort主执行模型的推理强度本文取none关闭思考适合追求速度与低成本的自动化循环。validationWorkerModel校验 / 复核模型这里用更轻量的 V4 Flash 做交叉验证兼顾质量与成本。validationWorkerReasoningEffort校验模型的推理强度同样为none。skipUserTesting是否跳过用户测试环节自主任务中不再等待人工确认。skipScrutiny是否跳过审查环节。补充说明本仓库 CONTRIBUTING.md 指出 DeepSeek V4 Pro 支持max/high等多档推理强度官方推荐在编码等复杂任务中启用更强思考以获得最佳体验。missionModelSettings中的workerReasoningEffort: none是追求吞吐与成本的默认选择若你的自主任务对推理质量要求更高可以尝试调整为 Droid 实际支持的更高档位并实测效果具体取值以 Factory AI Droid 的文档与实测为准。了解 Provider 类型决定 API 兼容性的关键Factory 支持三种 Provider 类型它们决定了 Droid 以何种 API 协议与上游服务通信ProviderAPI 格式适用场景anthropicAnthropic Messages API (v1/messages)Anthropic 官方 API 或兼容代理上的 Anthropic 模型。DeepSeek 的/anthropic端点即属此类。openaiOpenAI Responses APIOpenAI 官方 API 或兼容代理上的 OpenAI 模型最新的 GPT-5、GPT-5-Codex 等模型必须使用此类型。generic-chat-completion-apiOpenAI Chat Completions APIOpenRouter、Fireworks、Together AI、Ollama、vLLM 以及大多数开源 Provider。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.md1M 上下文窗口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.mdAnthropic 兼容端点在终端编程助手场景下的配置示例与本文的anthropicProvider 形态互相印证CONTRIBUTING.md模型命名、1M 上下文、推理强度等接入规范的权威说明接入任何新工具前建议先阅读。【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考