模型与服务商
Captain Who 不附带可直接使用的模型账户。你需要提供一个兼容的 API 地址、Token 和模型标识。
当前兼容方式
当前运行时支持三类模型接入：
- OpenAI Chat Completions 兼容接口。
- Anthropic Messages 兼容接口。
- DeepSeek V4 Chat 专用配置。
“兼容”表示接口需要满足 Captain Who 使用的消息、流式输出和工具调用约定，不保证所有第三方代理或自建网关都能工作。第一次真实任务才会验证服务端响应。
通用兼容模式根据完整 API URL 选择请求格式：包含 /chat/completions 时使用 OpenAI 兼容格式；包含 anthropic 或以 /messages 结尾时使用 Anthropic 兼容格式；其他地址默认按 OpenAI 兼容格式处理。
配置默认连接
- 打开“设置 → 配置”。
- 在“模型配置”中填写默认 API URL 和 API Token。
- 确认 URL 使用
http或https，并与 Token 成对填写。 - 在“可用模型”中开启希望出现在任务选择器里的模型。
继承默认连接的模型会共用这组地址和 Token。修改默认地址后，只影响仍使用默认连接的模型。
新建或编辑模型
点击“管理模型”，可以新建、编辑、删除或启停模型。主要字段是：
- 模型 ID：原样发送给服务商，必须与接口实际接受的值一致。
- 显示名称：只影响界面，不改变路由。
- 上下文总窗口：留空时按 128,000 tokens 保存；应填写服务商真实支持值。
- 支持图像输入：声明该模型是否接收图片；开关不会让纯文本接口自动获得视觉能力。
- 输入、缓存输入、输出价格：用于本地估算，每 1,000 tokens 计价。
在“更多”中可以为单个模型填写独立 URL 和 Token。两项必须同时填写，Captain Who 不会把单个模型的 URL 与全局 Token 混用，也不会反向混用。
“API 厂商”默认使用通用兼容配置；当前还可以选择 DeepSeek V4 Chat，并设置 Thinking 模式与推理强度。服务商专用选项只在对应配置下生效。
在任务中选择模型
新建对话或 Automation 时，从模型选择器选取一个已启用模型。没有连接信息的模型不会成为可用选项。
在已有对话里切换模型时：
- 同一兼容边界内可以直接切换。
- 切换 API 厂商或兼容规则时，应用会要求先压缩历史，再切换。
- 当前运行仍在生成，或正在等待审批时，不能切换。
压缩会保留任务摘要和必要索引，但不会把全部历史逐字发送给新模型。重要事实应在切换前写入项目文件或在提示中重新说明。
用量和费用估算
在“设置 → 用量与费用估算”可以按时间和模型查看请求数、输入、缓存输入、输出及 thinking tokens。打开“对话 token 详情”后，每条模型回复下方可以显示本次用量。
费用是根据你填写的每 1k token 单价在本地计算的估算：
- 不代表服务商最终账单。
- 不区分币种。
- 缺少有效价格的消息不会计入估算。
- 清空统计不会删除历史对话中的 token 详情。
数据与凭据
模型请求会把提示词、必要历史和工具结果发送到所配置的 API URL。签名 macOS 发行版把模型 Token 保存到系统钥匙串，数据库只保存不透明引用。已保存值不会回显到界面；替换或导入后恢复连接时需要重新输入。仍应保护本机账户、钥匙串、备份和磁盘访问权限。
不要把 Token 放进聊天、项目文件、终端命令、MCP 参数或截图。
常见问题
- 鉴权失败：核对 Token 是否属于该 URL，是否含多余空格。
- 模型不存在：模型 ID 与服务端实际名称不一致。
- 响应无效：接口虽然宣称兼容，但工具调用或流式格式不满足要求。
- 图片不能发送：所选模型未启用图像能力，或服务端实际不支持。
- 上下文超限：配置的窗口大于服务商真实限制，或当前历史需要压缩。