← 插件

模型供应商

统一管理 Claude Code、Codex、OpenCode、Pi 和 OMP 的模型接口、凭据与模型列表。

$ clisbot plugin add hulkzzhou1/model-providers
报告问题
hulkzzhou1Provider0次安装a15c8ba7fdb8源代码
模型供应商 截图 1模型供应商 截图 2模型供应商 截图 3模型供应商 截图 4

模型供应商管理在 Paseo 中集中保存模型接口地址、协议、凭据与模型列表,并为 Claude Code、Codex、OpenCode、Pi 和 OMP 创建独立接入配置。

页面采用紧凑工作台,支持按名称、接口地址、模型别名、实际请求 ID 和 Agent 搜索,并按启用状态筛选。入口位于「设置 → 插件 → 模型供应商」,命令中心也可打开同一设置页,主页侧边栏不再展示入口。设置栏内通过返回按钮切换列表与详情,内容区域足够宽时并列展示;详情可直接查看模型路由、每模型容量及 Agent。编辑模型在桌面使用紧凑表格,手机保留分组字段。关闭有修改的表单会确认是否放弃,模型加载或保存过程中锁定编辑和关闭。

Anthropic 鉴权可选 x-api-key 或 Bearer Token。

新增供应商可使用 DeepSeek 或 OpenRouter 预设。OpenRouter 使用 https://openrouter.ai/api/v1 的 Chat Completions 接口,默认选择 OpenCode、Pi 和 OMP;预设不写死模型列表,需加载目录或填写模型 ID 后保存,缺失容量时回退到 32,768 上下文和 4,096 最大输出。API 基础地址等全部默认设置均可修改,以接入兼容网关。切换预设会清空已输入的密钥。可为每个模型别名配置实际请求 ID,选择器显示别名,Agent 和连接测试发送映射后的 ID。DeepSeek、Anthropic、OpenRouter 模型目录返回容量时会保留,上下文与最大输出在每个模型行中分别设置,加载目录补齐未填写的容量且保留手动值;Codex 通过原生模型目录接收映射模型自身的上下文容量,OpenCode 与 Pi/OMP 同时接收上下文和输出容量,空白字段沿用旧记录的供应商默认值。预设容量仅为默认值,自定义网关可能具有不同限制。

供应商页面以弹窗表单新增与编辑,顶部显示摘要,连接设置、模型与路由、Agent 设置通过页签切换;切换保留草稿,校验失败返回对应页签,保存区固定在底部。模型 ID 和实际请求 ID 在同一行表单中填写;点击「加载模型」自动生成模型行,保留手工填写和映射,支持逐行添加、修改、移除,最多 100 行;创建会话时仅展示该供应商已启用的模型。没有模型列表接口的服务支持手动填写 ID。页面也支持停用和手动连接测试。保存后,该供应商支持的 Agent 会同时出现在 Paseo 原生 Provider 列表中,可沿用现有 Agent 预设。页面也能选择 Agent、模型和服务器工作目录创建新会话。Claude 支持 Anthropic Messages,Codex 支持 OpenAI Responses,OpenCode 支持 Anthropic 和 Chat Completions,Pi/OMP 支持以上三类协议;不进行协议转换。

Codex 需要支持 codex debug models --bundled 的 CLI(已验证 0.160.1)。保存时从本机 CLI 的内置模型指令和工具配置生成本地目录,写入每个模型的上下文容量,并保留 Codex 的原生预留比例:例如 1,000,000 Token 当前显示为 950,000 可用 Token。最大输出字段不配置 Codex 或 Claude Code;Claude Code 的上下文也沿用自身规则。升级插件后,已有供应商需重新保存并重新打开会话,才会刷新生成配置。

原有官方入口、订阅登录、MCP 配置和已有 Agent 预设不会被覆盖。自定义 API 使用相应供应商的 API 额度,不能自动使用官方订阅额度。修改设置在新建或重新打开会话时生效,不提供进行中会话的无缝热切换。停用入口不会终止已经运行的会话。

凭据由插件后端保存在当前 daemon 的 PASEO_HOME/model-providers/suppliers.json,目录权限 700、文件权限 600。Paseo 生成的 Provider 环境配置也包含所需凭据,因此同一服务器上有权读取 Paseo 配置的用户能访问凭据。页面只显示是否保存过凭据,编辑时留空沿用原值。空凭据可用于不需要认证的本地服务。

点击「加载模型」时,查询所配置 API 基础地址下的标准 /v1/models 接口,基础地址已有 /v2 等版本后缀时保留该版本。API 基础地址不要包含 /chat/completions 等完整请求路径。接口需返回标准 data 数组,保留模型名称、ID 及可选容量;Anthropic 支持分页。查询失败保留手工模型表单,旧供应商记录沿用原有默认值。查询向配置的 API 接口发送供应商密钥,并拒绝重定向;错误不回显响应正文或密钥,不读取第三方客户端登录态。模型发现不代表调用权限或推理兼容性。连接测试采用非流式 JSON,可能不适用于仅支持流式的服务。测试会发送“Reply OK.”及一个不会执行的工具定义,可能消耗少量 Token;测试成功仅表示所选协议返回了有效响应,并不证明流式输出、完整工具链、MCP 或模型质量通过验证。不向第三方发送遥测,不读取或改写官方认证文件。保存配置通过 Paseo SDK 更新且仅管理 mp- 前缀下由本插件拥有的别名,冲突时拒绝覆盖。

Pi/OMP 使用独立的本机扩展注册模型,保留原有用户目录与扩展。新模型按文本输入、无额外推理配置,不声明多模态和准确计费;成本字段为 0 表示未知,而不是免费。上下文与输出上限由用户按模型规格填写,支持完整 Token 数或 K/M 简写(1K = 1000 Token)。Agent CLI 必须已安装且对 daemon 可见,Paseo daemon 与客户端需 0.12.0 或更新版本。自定义供应商的实际兼容性以连接测试及真实 Agent 验证为准。

界面和设置入口标题自动跟随设备语言,支持简体中文,其他语言回退为英文;Paseo 0.12.0 尚未向插件开放应用内手动设置的语言。编辑器使用宿主弹窗,不修改宿主网页节点。

启动自定义 Agent 后,其提示词、代码上下文和工具执行结果会按该 Agent 的行为发送到所配置的模型供应商。供应商接口与数据策略由使用者选择。本插件无需运行时安装其他软件。