English

本页内容

Sigil Provider 指南

Sigil 把 provider 选择和其他用户工作流拆开。本指南及其链接的 provider 专页统一维护 provider 选择、认证环境变量、模型 endpoint 和 provider 专项配置。共享的 workspace、权限、任务、终端和工具设置仍由配置说明。

选择 Provider

Provider	最适合	图片输入 V1	Config value	指南
DeepSeek	默认 Quick Setup 路径、DeepSeek chat、FIM 和 DeepSeek 专项 endpoint。	不支持	`deepseek`	DeepSeek provider
OpenAI-compatible	OpenAI 或兼容 Chat Completions `/v1` 的网关。	不支持	`openai_compat`	OpenAI-compatible provider
OpenAI Responses	OpenAI Responses `/v1/responses` 模型与 event stream。	明确认识的 model id	`openai_responses`	OpenAI Responses provider
Anthropic	通过 Anthropic Messages streaming 使用 Claude 模型。	明确认识的 Claude id	`anthropic`	Anthropic provider
Gemini	通过 `streamGenerateContent` 和 function calling 使用 Gemini 模型。	明确认识的 Gemini id	`gemini`	Gemini provider

第一次使用时，直接运行 sigil 并完成 Quick Setup。需要可重复本地默认值、CI 自动化，或当前 Quick Setup 未覆盖的 provider 时，再手写配置。

设置 [agent].provider，并配置对应 [providers.*] 区块：

[agent]
provider = "deepseek"
model = "deepseek-v4-flash"
tool_timeout_secs = 30

[providers.deepseek]
# Provider 区块只放 endpoint、认证和 provider 专项字段。

[agent].model 是唯一聊天模型配置。计划任务中的 planner、executor 或 subagent role 仍可单独覆盖继承到的 agent provider/model。

凭据优先使用环境变量。明文 api_key 字段仍然支持本地私有配置，但当 key 只来自配置文件时，doctor 会给出 warning。

Provider	环境变量 key	配置文件备用
DeepSeek	`SIGIL_API_KEY`	`[providers.deepseek].api_key`
OpenAI-compatible	`SIGIL_OPENAI_COMPATIBLE_API_KEY`	`[providers.openai_compat].api_key`
OpenAI Responses	`SIGIL_OPENAI_RESPONSES_API_KEY`	`[providers.openai_responses].api_key`
Anthropic	`SIGIL_ANTHROPIC_API_KEY`	`[providers.anthropic].api_key`
Gemini	`SIGIL_GEMINI_API_KEY`	`[providers.gemini].api_key`

修改凭据后运行：

sigil doctor

在 TUI 中，/doctor 会把同一份 provider 和 key-source 检查渲染到 transcript，且不会打印密钥值。

配置模板位于 docs/examples/config：

把它们当作起点使用，然后在真实 workspace 中运行前检查 model 名称、base URL、key 来源和 permission policy。

Provider 专项选项由对应 provider 页面维护。共享的 Sigil 工作流保持一致：

Provider 调用失败时：