算力服务配置

算力服务（Compute Service）负责管理 AI 供应商、API Key、模型列表和默认模型映射。智能体需要至少一个可用模型才能理解你的意图、生成回复、调用工具并执行任务；图片、语音、视频、音乐等媒体能力也在这里统一配置。你可以配置自己的供应商，也可以登录后使用官方云端算力。

基本概念

概念	说明
供应商（Provider）	提供模型服务的平台或协议配置，例如 OpenAI、Anthropic、DeepSeek、Ollama、OpenRouter
供应商实例（Provider ID）	某个具体供应商配置的唯一 ID，用于区分同协议或同名模型的多个配置
API Key	供应商颁发的访问密钥，实际值保存在本机受权限保护的 `secrets.json`，配置中只保存引用
模型（Model）	具体模型名称，可用于对话、工具调用、图像、语音、视频或音乐等服务
默认映射	为不同任务用途选择默认模型
官方云端算力	登录后自动绑定的 `desirecore-cloud` provider，按订阅或 credit 使用
服务类型	模型用途，例如 chat、tool use、vision、tts、asr、image_gen、video_gen、music_gen

进入算力服务配置

打开设置 → 算力服务
或进入 资源管理器 → 算力 → AI 服务

支持的供应商

DesireCore 内置多家主流供应商模板，也支持自定义 OpenAI 兼容服务：

类型	示例	适合场景
国际模型供应商	OpenAI、Anthropic、Google、Mistral、Cohere、xAI、Perplexity	通用对话、复杂推理、代码、工具调用
国内模型供应商	DeepSeek、智谱、通义千问、Moonshot、火山引擎、讯飞等	中文任务、国内网络环境、成本控制
聚合平台	OpenRouter、硅基流动等	统一入口管理多家模型，快速切换模型
本地模型	Ollama	本地运行开源模型、数据不出设备、离线或内网场景
自定义供应商	私有部署或公司内部网关	兼容 OpenAI API 的内部模型服务

不同供应商在价格、上下文长度、工具调用、媒体能力、网络稳定性和可用地区上差异很大。常见做法是同时配置多个供应商：日常任务使用低成本模型，复杂推理或关键任务使用质量更高的模型，本地或内网任务使用 Ollama 或自定义供应商。

你也可以添加自定义供应商。自定义供应商通常需要兼容 OpenAI API 格式；如果媒体 API 和文本 API 使用不同端点，可以单独配置媒体 API 地址。

添加和验证供应商

在 AI 服务页面选择供应商
填写 API Key 和基础地址（Base URL）
如有需要，设置 API 格式、媒体 API 地址和服务类型
点击验证，确认 Key 和模型可用

自定义供应商

当你的供应商不在内置模板中，或公司内部通过统一网关代理模型时，可以添加自定义供应商。配置时通常需要确认：

Base URL 是否兼容 OpenAI API
API Key 或认证头是否符合网关要求
模型名是否与供应商实际暴露的名称一致
文本模型和媒体模型是否需要不同的 Base URL
是否需要单独设置 API 格式或服务类型

如果同一个协议下有多个实例，例如两个不同的 OpenAI 兼容网关，建议给每个实例保留清晰的名称，并在智能体专属配置中使用 providerId 指向目标实例。

Token Plan Key

某些供应商区分按量 API Key 与 Token Plan Key。界面会提示 Key 类型是否疑似放错位置，避免配置后模型一直验证失败。

官方云端算力

登录后，资源面板会自动出现官方云端算力分组。它会同步你当前账号可用的模型，并显示余额、credit、临期额度和相对消耗信息。

云端算力适合：

不想手动配置 API Key 的新用户
临时试用模型能力
使用订阅或 credit 包统一管理消耗

手动 API Key 和官方云端算力可以并存。你仍然可以为某些任务指定自己的供应商。

Claude Pro / Max 订阅

生效版本

v10.0.178+（Claude 订阅接入）。使用前请阅读下文的授权条件。

如果算力服务中显示 Claude 订阅 供应商，可以按界面提示连接账号。使用此入口需要符合 Anthropic 的订阅与授权规则，具体条件见下文。

运行方式与 Claude Code 的区别

选择 Claude 订阅模型后，你仍然在 DesireCore 中对话。智能体继续使用 DesireCore 的记忆、技能、工具、审批设置和审计记录，不会因此启用 Claude Code 自带的工具、插件或斜杠命令。

如果你需要完整的 Claude Code 编程工作流，请让 DesireCore 智能体调用本机安装的 Claude Code。

连接方式

界面会优先检测本机 Claude Code 登录状态。如果页面提供“登录”或粘贴 claude setup-token 的选项，按相应提示完成连接。连接后可使用 Claude 订阅供应商提供的模型；断开、过期或刷新失败时，界面会提示重新检测或重新登录。

条款、授权与账户风险

使用资格以 Anthropic 的规则为准

使用 Claude 订阅需符合 Anthropic 的授权要求。截至本文更新时，Anthropic 的 Claude Code 法律与合规说明明确要求构建第三方产品的开发者使用 API Key 或受支持的云平台认证，并不允许第三方向用户提供 Claude.ai 登录或代用户转发 Free、Pro、Max 凭据。Claude 订阅仅可在获得适用授权、并符合条款及地区和账号条件时使用。如果你无法使用此入口，请改用 Anthropic API Key 或其明确支持的云平台认证。

你应自行确认订阅用途、账户类型、使用地区和自动化方式符合 Anthropic 的现行条款。因订阅使用方式、账户状态或供应商政策导致的限流、功能限制、凭据失效、账户暂停或封禁风险由用户承担；DesireCore 无法控制 Anthropic 的账户处置。需要稳定的商业或组织级接入时，优先使用 Anthropic API Key 或其明确支持的云平台认证。

管理 API Key

你的 API Key 通过以下方式得到保护：

API Key 的实际值集中保存在本机 ~/.desirecore/config/secrets.json，供应商配置只保存引用名
在支持 POSIX 权限的平台上，DesireCore 会将该文件权限收紧为 0600；Windows 上的实际保护依赖当前系统账户、目录 ACL、设备锁定和磁盘加密
secrets.json 属于敏感路径，普通智能体文件工具不能直接读取；获准的连接会在执行层按引用解出所需凭据，并记录不含明文的访问审计
只有在用户主动调用对应第三方服务时，相应 Key 才会作为鉴权信息发送到该服务；DesireCore 官方云端凭据和外部登录凭据遵循各自的认证流程

本地文件不等于硬件密钥库

secrets.json 是受权限保护的本地凭据文件，并非 macOS Keychain、Windows Credential Manager 或硬件安全模块。能够控制你的操作系统账户、读取磁盘或访问未妥善保护备份的人，仍可能取得其中的凭据。请启用磁盘加密，不要把该文件加入 Git、网盘同步或普通备份。

修改 API Key：选择供应商后，点击编辑按钮，输入新的 Key 即可覆盖旧值。

删除供应商实例会移除该实例配置；如果某个智能体仍引用它，需要重新选择可用供应商或调整默认映射。建议按供应商或用途拆分 Key，不要把同一个高权限 Key 同时用于测试、日常任务和生产任务。这样更容易定位账单、限流和权限问题。

模型验证

配置完供应商后，建议验证模型是否可用：

选择一个已配置的供应商
点击 验证全部模型 按钮
系统会逐一检测每个模型的可用性

验证结果会以状态标签显示：

状态	含义
可用	模型或服务验证通过
异常	Key 无权限、地址错误、模型不存在或供应商返回错误
超时	网络或供应商响应超时
检测中	正在验证

模型验证会按模型类型选择合适的验证方式。图片、语音、视频、音乐等媒体模型会使用媒体服务路径；当供应商的普通 Base URL 指向非 OpenAI 兼容端点时，mediaBaseUrl 可用于媒体请求和验证。

验证结果会持久化到模型配置中。明确验证失败的模型不会优先出现在聊天模型选择器中，避免误选不可用模型。

服务类型和媒体模型

不同模型用途不同：

服务类型	用途
`chat`	普通对话和文本生成
`tool_use`	支持工具调用的对话
`vision` / `image_understanding`	图片理解、扫描 PDF 识别
`tts` / `asr`	语音合成和语音识别
`image_gen`	图像生成
`video_gen`	视频生成
`music_gen`	音乐生成

图像、视频、音乐等生成类模型不会作为普通聊天模型出现在对话模型选择器中，但可以被对应工具或技能调用。

默认模型映射

默认映射决定智能体在没有专属设置时使用哪个模型。常见用途包括：

日常对话
复杂推理
代码生成
文档处理
工具调用
媒体生成或理解

未设置的用途会回退到全局默认模型。选择映射时，可以按以下原则搭配：

低成本默认模型：用于日常问答、信息整理和轻量任务
高质量推理模型：用于复杂分析、规划、代码审查和高风险决策辅助
工具调用稳定的模型：用于需要频繁调用文件、命令、搜索或外部服务的任务
媒体专用模型：用于图片理解、图片生成、语音、视频或音乐相关任务

默认映射是全局兜底；如果某个智能体有专属模型设置，智能体配置优先。

智能路由的供应商优先级

想让智能路由优先使用某个供应商，可以这样设置：

打开对话中的模型选择面板，点击「Provider 优先级设置」。
为各供应商填写优先级，数值越大越优先。
点击「保存」。要恢复默认值，先点击「恢复默认」，再保存。

设置项	规则
可填范围	-10000 到 10000 的整数
默认值	官方云端算力 100，其他来源 0
选择顺序	同一模型量级内先比较供应商优先级；相同优先级沿用模型排序
生效范围	所有使用智能路由的对话；已固定的模型不受影响

供应商和模型仍需处于可用状态，提高优先级不能解决登录、凭据或模型不可用的问题。

智能体专属模型

需要固定使用某个模型时，在对话的模型选择面板中选择该模型。

高级配置：修改 agent.json

单个智能体可以在 agent.json 中覆盖全局模型配置：

{
  "llm": {
    "provider": "anthropic",
    "providerId": "provider-anthropic-001",
    "model": "claude-sonnet-4-5"
  }
}

provider 表示协议或供应商类型，providerId 表示具体供应商实例。存在多个同协议供应商、多个代理地址或同名模型时，应同时设置 providerId，避免请求使用错误的 Base URL 或 API Key。

迁移过来的配置或手动维护的配置中可能仍能看到 runtime 字段；推荐使用 llm。如果你手动编辑智能体配置，应优先保持 llm.provider、llm.providerId 和 llm.model 一致。

固定模型不可用怎么办？

模型不存在、被停用或不支持对话时，界面会显示原因；本次选择被拒绝后，原来的设置会保留。

查看提示，确认是模型、供应商配置还是登录问题。
按提示选择「重新选择模型」、打开算力中心或登录账号。
修复后继续任务。

固定模型在运行中失效时也会显示错误，不会自动改用智能路由。

多供应商管理

同时配置多个供应商可以用于：

冗余备份：某个供应商不可用时切换到其他供应商
成本优化：日常任务使用低成本模型，关键任务使用高质量模型
能力互补：文本、代码、图片、语音、视频等任务使用不同服务
区域和网络适配：为不同网络环境配置不同 Base URL

如果多个供应商共享同一个模型名，系统会优先使用明确的 providerId，再按默认映射和可用 Key 选择。

排查模型问题时，可以按这个顺序检查：

API Key 是否填在正确的供应商或 Key 类型中
Base URL 和媒体 Base URL 是否对应供应商接口
模型名是否仍然可用
验证状态是权限错误、供应商错误还是网络超时
默认映射或智能体 providerId 是否指向了预期的供应商实例

基本概念​

进入算力服务配置​

支持的供应商​

添加和验证供应商​

自定义供应商​

官方云端算力​

Claude Pro / Max 订阅​

运行方式与 Claude Code 的区别​

连接方式​

条款、授权与账户风险​

管理 API Key​

模型验证​

服务类型和媒体模型​

默认模型映射​

智能路由的供应商优先级​

智能体专属模型​

固定模型不可用怎么办？​

多供应商管理​