提供者概述
一个提供者指某台服务器上的某个模型，用于某一项工作。twinny 有三项工作：
| 类型 | 用途 | 需要 |
|---|---|---|
| 对话 | 对话面板回答、内联编辑、代码操作、代码审查、提交信息、终端助手 | 任何 instruct 或 chat 模型 |
| 自动补全（FIM） | 输入时的内联建议 | 经过 fill-in-the-middle 训练的模型：通常是 base 或 code 变体 |
| 嵌入 | 为工作区建立索引，让对话能引入相关代码 | 嵌入模型，如 nomic-embed-text |
每种类型可以有多个提供者。每种各有一个当前提供者：对话和嵌入在提供者标签页用使用此提供者选择，当前自动补全提供者还会显示在状态栏提示中。
点击侧边栏顶部的机器人图标或运行 Manage twinny providers 打开提供者标签页。
首次运行
没有配置任何提供者时，twinny 会按以下顺序查找本机已运行的服务器：Ollama、LM Studio、llama.cpp、Oobabooga、LiteLLM、Open WebUI，最后是 8080 端口上的通用 OpenAI 兼容服务器。第一个返回模型列表的服务器会被用来创建对话、自动补全和嵌入提供者，且仅在安装了合适模型时才创建。模型是否合适从名称判断：instruct/chat 用于对话，code/coder/base 系列用于补全，embed/minilm/bge/e5/nomic 用于嵌入。
没有服务器响应时，欢迎界面提供再次搜索和选择提供者。
预设
添加提供者显示分为本机和托管 API 两组的预设。本地预设会为所选工作填入服务器的主机名、端口和路径，并向服务器请求模型列表；表单选出第一个合适的模型，你可以修改。托管预设填入合理的模型名称并要求密钥。
本地服务器
| 服务器 | 对话 | 自动补全 | 嵌入 | 页面 |
|---|---|---|---|---|
| Ollama | localhost:11434 /v1 | /api/generate | /api/embed | Ollama |
| LM Studio | localhost:1234 /v1 | /v1/completions | /v1/embeddings | LM Studio |
llama.cpp（llama-server） | localhost:8080 /v1 | /completion | /embedding | llama.cpp |
| Oobabooga | localhost:5000 /v1 | /v1/completions | /v1/embeddings | 其他本地服务器 |
| LiteLLM | localhost:4000 /v1 | /v1/chat/completions | /v1/embeddings | 其他本地服务器 |
| Open WebUI | localhost:3000 /api | /ollama/api/generate | /ollama/api/embed | 其他本地服务器 |
| OpenAI 兼容服务器 | localhost:8080 /v1 | /v1/completions | /v1/embeddings | 其他本地服务器 |
对话的路径是 API 基路径，twinny 自行追加 /chat/completions。自动补全和嵌入的路径是完整路由。
托管 API
| 提供者 | 对话 | 自动补全 | 嵌入 |
|---|---|---|---|
| OpenAI | ✓ | ✓ | |
| Anthropic | ✓ | ||
| Mistral | ✓ | ✓ Codestral | |
| DeepSeek | ✓ | ✓ | |
| OpenRouter | ✓ | ✓ | |
| Gemini | ✓ | ||
| Groq | ✓ | ||
| Cohere | ✓ | ||
| Perplexity | ✓ |
详情、模型名称和获取密钥的地址见托管 API。
另一台设备
Twinny device (P2P) 提供者使用你另一台电脑上的 Ollama。它在提供者标签页的设备区域创建，而不是通过预设。见设备。
提供者表单
| 字段 | 说明 |
|---|---|
| 标签 | 名称，显示在菜单和状态栏 |
| 类型 | 对话、自动补全或嵌入 |
| 提供者 | 服务器或 API 系列，决定默认值和请求格式 |
| 主机名 | 只填主机，如 localhost。粘贴 https://my-box:8080/v1 这样的完整 URL 会被拆分为协议、主机、端口和路径 |
| 端口 | 留空表示协议默认端口 |
| 协议 | http 或 https |
| API 路径 | 见上表 |
| 模型名称 | 能获取列表时从服务器的模型中选择（从服务器的模型中选择），否则手动输入 |
| FIM 模板 | 仅自动补全。自动根据模型名称选择格式；建议看起来不对时手动设置 |
| API 密钥 | 托管 API 必填；本地服务器可选，设置后作为 bearer token 发送 |
托管对话使用固定的公共端点，因此其主机名、端口和路径被隐藏。设备提供者没有任何端点字段。
表单在输入时校验。测试提供者为该提供者的工作发送一个小请求，显示成功或服务器返回的错误以及调用的 URL。
检查设置
标签页顶部的检查设置测试每种类型的当前提供者：
- 正常：服务器已响应。
- 失败：未响应或返回错误。打开提供者跳转到表单。
- 未设置：该工作没有配置。面板和内联建议需要对话和自动补全；嵌入可选。
管理提供者
- 使用此提供者将其设为该类型的当前提供者。
- 复制复制一个提供者，用于同一服务器的另一个模型。
- 导出和导入以 JSON 在机器间迁移列表。见导入与导出。
- 重置删除所有提供者并回到首次运行界面。
提供者默认保存在 VS Code 全局状态中。把 twinny.providerStorageLocation 设为 file 可改为保存在扩展全局存储目录中的文件里，跨远程环境工作时更稳妥。
请求是如何发出的
twinny 有一个推理层，包含三类适配器：
- HTTP：向你指定的地址发出普通的流式请求。用于所有本地服务器、Deepseek，以及托管 API 的补全和嵌入端点。对话以 OpenAI 格式发往
<路径>/chat/completions；补全使用服务器的原生路由（Ollama 的/api/generate，llama.cpp 的/completion，其他为/v1/completions），并按模型渲染 FIM 提示。 - 托管：用供应商自己的 SDK 与 Anthropic、OpenAI、Mistral、Groq、OpenRouter、Cohere、Perplexity 和 Gemini 对话。端点固定。
- 设备：扩展内的回环网关，通过 P2P 连接转发到已配对机器的 Ollama。
每个失败都会被归为少数几类（不可用、模型缺失、未授权、限流、超时、提示过长……）并附上清晰说明，让你看到的通知告诉你该做什么。原始错误保留在日志中。