跳到正文
OcHub

高级功能

配置模型路由、思考映射、CLI 维护和工具专属选项。

更新于 查看 Markdown
For humans

高级功能会直接影响路由、历史记录或工具配置。动手前先完成一条普通连接,并确认能发起真实 请求;这样出现问题时可以快速切回已知可用状态。

推荐学习顺序

目标 教程
用模型别名、接口转换和规则解决真实路由需求 路由实战
让 Token 成本与模型价格、倍率和账单口径一致 模型定价与成本校准
创建快照,并使用 WebDAV 或 S3/R2 同步 数据、备份与同步

自动路由与接口转换

一个模型供应商可以同时启用以下接口:

  • Anthropic Messages
  • OpenAI Chat
  • OpenAI Responses

自动路由会优先选择客户端原生接口;模型在该接口不可用或接口故障时,再尝试其他已启用 接口。至少保留一个接口。自动检测只是起点,上游文档明确限制接口时应手动调整。

默认模型

填写默认模型后,客户端请求的模型没有命中例外规则时,OcHub 会改用默认模型。适合只有 一个可用模型的上游。

不要为了“保险”随意填写默认模型:它会掩盖客户端传错模型名的问题,也可能让不同用途的 请求全部落到同一个模型。

模型例外

只有自动路由无法表达的情况才需要添加例外。每条规则包含:

字段 作用
模型或模式 匹配客户端传入的模型,可使用页面支持的通配模式
指定接口 强制使用某个已启用接口,或继续自动选择
上游模型名 把客户端模型改写为上游模型;留空则保持原名

先写最具体的规则,并用真实请求验证。规则指定的接口必须保持启用。

模型规则的完整优先级和常见配置实例见路由实战。

思考强度

模型供应商提供三种处理方式:

  • 自动映射:在不同 CLI 的强度档位与上游 Token 预算之间转换。
  • 原样传递:不改写客户端提供的思考参数。
  • 关闭思考:移除或关闭相关参数。

自动映射可配置低、中、高、最大四档预算。四个值必须是递增的正整数。上游只支持强度枚举 而不支持 Token 预算时,应以它的接口文档为准。

快速切换与备用上游

模型供应商在应用页面启用后,连接页面可以直接切换当前上游。此后切换只更新本地路由,不重新 写入工具配置。

建议保留一个已验证的备用上游。主用供应商异常时:

  1. 在应用页面切换到备用模型供应商。
  2. 发起一条短请求。
  3. 在用量日志中比较状态和延迟。
  4. 主用供应商恢复后再切回,不要在故障期间同时修改模型规则。

自动路由会在同一模型供应商已启用的接口间选择和重试;主用与备用之间仍需手动切换。

用量与计费

请求可以正常返回但成本仍为 0,通常是计价模型没有匹配价格。先从请求详情记录“请求模型” “模型”和“计价模型”,再配置每百万 Token 的输入、输出、缓存读写价格。

Claude 与 Codex 还可以设置默认成本倍率和计价模型来源。经过模型别名或路由改写时,重点 核对计价模型是否代表供应商实际收费模型。完整校准流程见 模型定价与成本校准。

连接高级编辑

通用配置

“通用配置”是按应用共享的配置片段。打开“应用通用配置到此连接”后,OcHub 写入工具 配置时会合并该片段。

从当前配置提取前先确认文件中没有只属于某个连接的密钥或模型,否则会错误地扩散到其他 连接。

原始文件编辑

在“将写入的文件”中选择“编辑”,可以直接修改生成内容。应用后,OcHub 会尝试把改动同步 回上方表单。

只有表单无法表达某个受支持字段时才使用原始编辑。保存前刷新预览,确认自定义字段仍在。

CLI 工具维护

打开高级工具:

  1. 点击“刷新版本”查看各 CLI 的本地版本、最新版本和环境来源。
  2. 点击“扫描安装位置”检查 PATH 默认项、重复安装和异常可执行文件。
  3. 缺少工具时使用“安装缺失工具”。
  4. “更新全部工具”会执行对应更新命令;先阅读页面显示的命令与是否需要确认。

多个包管理器同时安装同一 CLI 时,先决定保留哪个来源,再手动整理 PATH。OcHub 会报告 冲突,但不会替你删除未知安装。

环境变量冲突

“环境变量冲突”会按应用扫描可能覆盖配置文件的变量。选择“删除并备份”前:

  1. 核对变量名和目标应用。
  2. 记录备份路径。
  3. 处理后重启终端和目标 CLI。
  4. 需要撤回时使用“恢复备份”并提供原备份路径。

环境变量常由 shell 配置、启动器或公司设备策略注入;删除后再次出现时,应继续检查真实 来源。

工具专属项目

工具 高级能力
Codex 检查统一历史备份、恢复官方历史
Claude 跳过或恢复引导、应用或恢复 OcHub 插件、读取和校验 MCP
OpenCode 读取并禁用 OMO / OMO Slim 配置
OpenClaw 检查配置,编辑默认模型、环境变量和工具 JSON
Hermes 编辑模型 JSON、MEMORY 与 USER 记忆及其启用状态

Claude 的跳过或恢复引导按钮会直接写入或清除引导完成状态。“应用 OcHub 插件”会写入 Claude config.json 中的 primaryApiKey,恢复动作会移除该项。这些是手动配置动作, 不会自动同步 MCP、技能或安装受管应用插件。

这些操作可能覆盖文件,但 OpenClaw、Hermes 和环境变量操作会在可用时生成备份。状态提示中 出现备份路径时立即保存下来。

数据恢复和远端同步请阅读数据、备份与同步;需要从 cc-switch 搬迁时阅读从 cc-switch 迁移。

Navigation

Type to search…

↑↓ navigate↵ selectEsc close