接入 DeepSeek

最小设置

export SIGIL_API_KEY="sk-..."
sigil

config_version = 2

[agent]
connection = "deepseek-default"
model = "deepseek-v4-flash"

[connections.deepseek-default]
label = "DeepSeek"
provider = "deepseek"
protocol = "deepseek"
base_url = "https://api.deepseek.com"
credential = { source = "environment", name = "SIGIL_API_KEY" }

[connections.deepseek-default.options]
fim_model = "deepseek-v4-pro"

可复制文件见 deepseek-basic.toml。

认证

示例只把当前连接绑定到 SIGIL_API_KEY。也可以在首次设置或 /config 中选择受保护凭据存储；此时 sigil.toml 只保存不透明的 stored ID。默认 file 使用 owner-only 的 ~/.sigil/credentials.json，不会触发系统认证框。粘贴的密钥不是合法 connection 字段。

选项与可见限制

base_url 属于这条精确连接。beta_base_url、anthropic_base_url、fim_model、strict_tools_mode 和 user_id_strategy 放在 [connections.deepseek-default.options] 下，只作用于该 DeepSeek 路由。

DeepSeek 图片输入尚未启用。附加图片会在发送请求前被拒绝；需要处理图片时，请选择支持图片的模型服务。

验证

运行 sigil doctor，确认 default=deepseek-default/deepseek-v4-flash、端点、凭据来源和就绪状态。

常见问题

认证失败：在启动 Sigil 的同一 Shell 中导出 SIGIL_API_KEY。
模型错误：检查 [agent].connection 与 [agent].model 组成的精确路由，以及任务角色覆盖设置。
FIM 不可用：确认 fim_model 和端点都支持该能力。
流式响应较慢：检查网络和模型请求超时设置。

下一步：返回模型服务指南。