标准动态库插件示例

本目录包含 CLIProxyAPI C ABI 的标准动态库插件示例。

目录布局

simple/：声明全部支持能力的完整骨架示例。
model/：只演示模型能力。
auth/：只演示认证提供方能力。
frontend-auth/：只演示前端认证提供方能力。
frontend-auth-exclusive/：演示被选中后成为唯一请求认证方式的前端认证提供方。
executor/：只演示执行器能力。
protocol-format/：使用最小执行器重点演示输入和输出格式声明。
request-translator/：只演示请求转换能力。
request-normalizer/：只演示请求规整能力。
codex-service-tier/：仅 Go 实现的请求规整插件，启用后会将 Codex gpt-5.4 请求设置为 priority service tier。
scheduler/：仅 Go 实现的调度插件，可选择指定 auth ID、委托内置调度器或拒绝调度。
response-translator/：只演示响应转换能力。
response-normalizer/：只演示响应规整能力。
thinking/：只演示 Thinking 处理能力。
usage/：只演示 Usage 观察能力。
cli/：只演示命令行扩展能力。
management-api/：只演示 Management API 扩展能力。
host-callback/：使用最小 Management API 路由演示宿主回调。

多数标准能力示例都包含 go/、c/ 和 rust/ 三个子目录。专用示例可能只提供所需的实现语言。

codex-service-tier 声明请求规整能力。当 fast 为 true 时，如果 req.ToFormat 为 codex 且 req.Model 为 gpt-5.4，它会将 service_tier 设置为 priority。

yaml

plugins:
  configs:
    codex-service-tier:
      enabled: true
      priority: 1
      fast: false

scheduler 声明调度能力。它可以从候选列表中选择配置的 auth ID，委托内置的 fill-first 或 round-robin 调度器，或在 deny 为 true 时拒绝调度。

yaml

plugins:
  configs:
    scheduler:
      enabled: true
      priority: 1
      auth_id: ""
      delegate: ""
      deny: false

auth_id 会在 delegate 为空时选择匹配候选。delegate 支持 ""、fill-first 和 round-robin；其他非空值会让本插件不处理本次调度。deny 会返回调度错误。

bash

make -C examples/plugin list
make -C examples/plugin build

构建产物会写入 examples/plugin/bin。

protocol-format 使用最小执行器承载，因为格式声明属于执行器能力。

host-callback 使用最小 Management API 路由承载，因为宿主回调只能从插件方法内部发起，不是独立能力。