算力服务配置

算力服务（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

进入算力服务配置

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

支持的供应商

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

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

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

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

添加和验证供应商

1. 在 AI 服务页面选择供应商
2. 填写 API Key 和基础地址（Base URL）
3. 如有需要，设置 API 格式、媒体 API 地址和服务类型
4. 点击验证，确认 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 订阅

部分版本会在算力服务中显示 Claude 订阅 供应商。该路径使用 Anthropic 官方的 @anthropic-ai/claude-agent-sdk 发起模型请求，不会通过伪造 Claude Code 请求头来直连 Anthropic。

运行方式与 Claude Code 的区别

从执行边界看，这是一条双运行时协作链路：

1. DesireCore Agent 运行时负责系统提示词、记忆、Skill、工具注册、权限审批、委派和执行审计
2. Claude Agent SDK 运行时负责使用 Claude 订阅身份完成模型请求并返回文本或 tool_use
3. tool_use 会交回 DesireCore，由 DesireCore 的工具和审批链执行

Claude Agent SDK 自带的工具、Skill、Plugin、子 Agent、斜杠命令和连接器不会在这条路径中使用；SDK 也不会代替 DesireCore 执行文件、命令或外部服务操作。因此，Claude 订阅模型在 DesireCore 中的上下文、工具集合、权限边界和最终效果，和直接使用 Claude Code 有本质区别。

如果你需要在 DesireCore 中使用完整的 Claude Code 编程工作流，请让 DesireCore 智能体调用本机的 Claude Code；不要把“选择 Claude 订阅模型”理解为直接进入 Claude Code。

连接方式

界面会优先检测本机 Claude Code 登录状态。根据版本和平台，还可能提供应用内登录或粘贴 claude setup-token 的高级连接方式。连接后可使用 Claude 订阅供应商提供的模型；断开、过期或刷新失败时，界面会提示重新检测或重新登录。

条款、授权与账户风险

使用资格以 Anthropic 的规则为准

使用官方 SDK 说明 DesireCore 按官方技术接口实现该路径，不等于 Anthropic 已允许第三方产品转发 Claude Free、Pro 或 Max 凭据。截至本文更新时，Anthropic 的 Claude Code 法律与合规说明明确要求构建第三方产品的开发者使用 API Key 或受支持的云平台认证，并不允许第三方向用户提供 Claude.ai 登录或代用户转发 Free、Pro、Max 凭据。因此，Claude 订阅入口在取得适用于 DesireCore 场景的明确授权前应保持发布门控；该能力是否开放取决于后续官方授权、当时有效的条款、地区、账户和 DesireCore 发布策略。

你应自行确认订阅用途、账户类型、使用地区和自动化方式符合 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 同时用于测试、日常任务和生产任务。这样更容易定位账单、限流和权限问题。

模型验证

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

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

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

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

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

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

服务类型和媒体模型

不同模型用途不同：

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

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

默认模型映射

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

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

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

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

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

智能体专属模型

单个智能体可以在 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 选择。

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

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