codex-proxy-rs/docs/plans/remove-plugin-providers.md

移除插件 Provider 扩展计划

目标与边界

Provider 集合固定为内置 openai、xai，采用插件接入前的静态注册方式。 插件继续提供中间件、模型路由、账号调度、请求与用量观察、客户端认证、管理页面和 CLI。 插件仍可在已有权限与业务约束下调用宿主模型、管理 OpenAI/xAI 账号、访问网络和私有状态。

用户确认插件功能尚未发版。本次直接删除 Provider 扩展，不增加旧包兼容层、弃用期、升级流程或专门的数据迁移。 既有数据库迁移遵守冻结规则；保留通用插件安装、配置和私有状态持久化。

工作分支与执行安排

• 主仓库：/home/zyy/Codes/codex-proxy-rs，分支 main
• 起点：54b6be52 feat(proxies): fill manual location from outlet probe
• 工作目录：/home/zyy/Codes/codex-proxy-rs-plugin-provider-removal
• 工作分支：refactor/remove-plugin-providers
• 实现代理：gpt-6-sol，推理强度 max（用户指定的 6-sol-max）
• 在独立 worktree 实现和验证，随后由主代理集成
• main 上的代理位置提交原地保留；删除变更完成后集成到其后，不重写或撤销该提交
• 不推送、不创建 PR、不发布版本

实施前 main（54b6be52）已包含插件功能；行为参照是插件接入前的 60e0d4ee。 只能按本次职责恢复静态 Provider 行为，不能整块还原文件而丢失之后的代理、UI 或其他修复。

实施前核实的依据

• backend/apps/gateway/src/bootstrap.rs：组合根先构造 OpenAI/xAI，再通过插件 Runtime 扩展注册表；此前直接使用静态注册表。
• backend/crates/gateway-plugin/runtime/src/generation/prepare/instance.rs：每实例只有一个 Provider 描述符，Provider 专属能力由 executor 及七项附属能力组成。
• backend/crates/gateway-plugin/runtime/src/adapter/provider/：承载插件 Provider 执行、目录、凭据、额度、计费、画像及续写适配。
• backend/crates/gateway-core/src/engine/extensions.rs、backend/crates/gateway-admin/src/ports/provider_extensions.rs：动态 Provider 注册索引；其中通用调用作用域须按实际消费者保留。
• backend/crates/gateway-plugin/sdk/src/call/host.rs：宿主模型回调的 ModelEventBatch 复用了 call/provider 下的 ExecutionEvent，属于保留功能依赖。
• frontend/src/components/client-profile/ProviderRequestProfilesEditor.vue：当前请求 Provider 列表并维护加载、失败、动态配置和孤立画像状态；固定平台后应简化。
• 独立示例仓库 /home/zyy/Codes/codex-proxy-plugins 的 workbench 同时声明 Provider 和其他扩展，需同步核对其依赖。

实施步骤

1. 固定 Provider 注册

• Core 和 Admin 直接接入 OpenAI/xAI 静态注册表，覆盖常规启动和插件 CLI 路径
• 删除 ProviderExtensionIndex、ProviderAdminExtensionIndex 及专属动态查找、冲突检查和注册寿命管理
• 保留其他插件扩展的快照发布、在途请求保活、故障隔离和递归保护
• 保留现有 Provider trait、账号分组、模型路由、重试及两个内置 Provider 的业务实现

2. 删除插件 Provider 合同与实现

• 删除 contributes.provider 作者简写与 PluginBuilder.provider 注册入口
• 删除八项 Provider 能力：executor、models、authentication、quota、request_profile、account_management、billing、maintenance
• 删除对应 RPC 方法、Provider 描述、执行适配、目录、凭据、额度、计费、画像、续写和专属维护任务
• 清理 Runtime 的 ProviderStorePorts 注入、Provider 续写排空、专属诊断和失去消费者的辅助代码
• 将仍被宿主模型回调使用的事件、编码等合同放到合适的共享职责位置，保留其真实调用行为
• 保留 models/accounts 等访问权限、host.model/host.auth 回调和 frontend_authentication；能力删除不能扩大为权限删除
• 更新宿主兼容能力清单；保留通用插件合同版本检查，不为了未发布删除增加版本迁移机制
• 删除后沿调用链重新检查抽象：清理空 trait/枚举/错误类型、只剩转发的 wrapper、无独立职责的端口与注册表
• 合并同一 owner 内失去独立意义的碎片文件、单用途转换和重复状态，移除空文件及空模块；按职责与真实消费者判断，不单凭行数合并
• 不以空集合、恒定返回值、占位实现或多余泛化类型维持已经撤掉的 Provider 扩展结构

3. 前端固定平台与接口清理

• 全面盘点账号、用量、请求画像等页面中查询 Provider 名单的接口调用
• Provider 选择直接使用统一的 OpenAI/xAI 固定集合，移除仅为发现平台存在的请求、加载、失败和重试状态
• 删除插件 Provider 专用的 schema 表单、通用画像编辑和孤立 Provider 提示等无消费者 UI
• 清理不再需要的 API wrapper、后端路由/用例/存储查询及文档；用调用关系确认无剩余用途
• 对照接入插件前的行为，保留账号实际状态、模型目录、额度、版本/画像内容等真正的业务查询
• 原生平台的账号级能力仍以实际账号事实为准，不能把账号认证差异简单硬编码成平台名单
• 保持 54b6be52 代理位置功能及之后并发提交完整

4. 测试、文档与示例

• 删除纯 Provider 扩展测试，重写把 Provider 当作通用插件载体的 fixture，使其继续验证保留能力
• 按改动同步 SDK 文档、架构、API、插件使用说明和开发指引，在原章节修订
• 独立示例若需修改，在该仓库另建 worktree，保留其现有改动；移除回显 Provider 并保留可用的其他教学扩展
• 不修改 AGENTS.md，不自动追加发布说明，不运行发布动作

验证与验收

按当前仓库贡献指南使用 Rust 1.97.0、前端固定 pnpm 版本和专用测试环境。 实际执行命令和结果记录在下方，未运行或跳过项列为缺口。

1. Rustfmt、严格 Clippy、受影响的 SDK/Runtime/Core/Admin/API 测试及架构边界检查
2. 前端 format:check 和 build（包含类型检查），以及 git diff --check
3. 运行行为：OpenAI/xAI 仍可正确注册、选择与处理请求，插件无法注册第三个 Provider
4. 保留插件行为：管理/CLI 调用现有模型、账号回调、中间件、路由/调度、观察和客户端认证按变更范围验证
5. 浏览器验收：相关 Provider 控件只显示 OpenAI/xAI，切换正常；网络记录中没有为发现可选 Provider 发出的请求
6. 真实推理或服务依赖不可用时明确记录，不以构建或模拟数据替代真实集成结论
7. 完成后核对 main 仍包含 54b6be52，检查并发变更后再将本分支集成到 main；不覆盖其他工作区内容

执行记录

• 计划创建：已从 54b6be52 创建独立 worktree；主工作区干净，代理位置提交已在 main。
• 实现状态：固定原生 Provider 注册、删去插件 Provider 能力与适配、OAuth 多账号与延迟发布残留、前后端发现接口及动态表单；保留其他插件扩展与原生业务查询。
• Rust 静态检查：cargo fmt --all --check、共享 target 上的 cargo check --workspace --all-targets、严格 cargo clippy --locked --workspace --all-targets -- -D warnings 和 git diff --check 均通过；Clippy 使用 RUST_MIN_STACK=16777216、CARGO_BUILD_JOBS=1，日志 /tmp/cpr-provider-removal-clippy-final.log。
• Rust 测试：专用隔离 PostgreSQL/Redis 下运行 cargo test --locked --workspace --all-targets --no-fail-fast，日志 /tmp/cpr-provider-removal-workspace-tests-no-fail-fast.log；该轮因 Runtime 9 项、SDK 1 项、Store 2 项失败而退出 101，其他目标通过。修复后 Runtime cargo test --locked -p gateway-plugin-runtime --test main -- --test-threads=1 为 104 通过、0 失败、1 ignored（/tmp/cpr-provider-removal-runtime-serial.log）；SDK --features io 对失败用例复验 1/1 通过（/tmp/cpr-provider-removal-sdk-targeted.log），Store 两个失败用例分别 1/1 通过（/tmp/cpr-provider-removal-store-migration-targeted.log、/tmp/cpr-provider-removal-store-plugin-account-targeted.log）。最后的插件身份命名调整后，CLI 3/3 与管理模型流 1/1 复验通过（/tmp/cpr-provider-removal-cli-renamed-targeted.log、/tmp/cpr-provider-removal-management-renamed-targeted.log）。并行 Runtime 曾一次出现早期进程退出计数 2/3，原断言在隔离单测和串行 Runtime 套件均通过；资源竞争只是推测，未据此放宽断言。
• 前端：工作目录 node_modules 为复用同锁依赖的临时软链接，pnpm run 会尝试安装并拒绝软链接；直接运行同一依赖的 eslint . 通过（0 error、1 条既有 PluginVersionCard.vue 属性顺序 warning），vue-tsc -b --pretty false 与 Vite 生产构建通过。
• 隔离浏览器：模拟 API 下账号/用量筛选及 OpenAI/xAI 画像编辑正常；39 个请求中三个 Provider 名单发现端点均为 0，缺失 fixture 与浏览器错误均为 0。验收限桌面亮色与模拟数据。
• 示例：独立 worktree /home/zyy/Codes/codex-proxy-plugins-provider-removal（refactor/remove-provider-example）已提交 d2e4204d3dbc0442fc9eeb24273e42260705d126，移除 Provider 演示与假账号入口，保留 9 类扩展并改用现有 Key 和模型。SDK/CLI 固定到网关提交 eb4477ceca1a55a1a0067bea619d589e10bdda29，Cargo.lock 保留规范 Git 来源，没有本机路径补丁。固定后 cargo +1.97.0 test --locked --offline --manifest-path examples/workbench/backend/Cargo.toml 18/18 通过，严格 Clippy 和 Rustfmt 通过。前端使用原示例工作区已安装依赖，直接执行 ESLint、vue-tsc、Vite build 均通过，未另做 frozen-lockfile 安装；模拟页面验证了 Key/模型选择及示例请求。原示例 main 上的 README、pnpm 和 UI 依赖改动完整保留；refactor/remove-provider-example 已快进合入示例 main，这四个文件的本地改动仍未提交。
• 验证缺口：上述全量命令并非单次全绿，修复后按实际失败目标与命名调整范围复验。两个既有 ignored 分别为 Host 的 GitHub 在线发行查询、Runtime 的独立打包 observer 示例集成；后者需要两个示例包及隔离日志订阅器。未连接真实上游执行 OAuth 授权或推理，未验收窄屏和暗色状态。SDK 提交通过仅该命令生效的本地 Git URL 重写获取，未推送，未验证从远端获取新提交。

首次本地集成结果（折叠前）

• 网关实现提交：eb4477ceca1a55a1a0067bea619d589e10bdda29，已快进合入 main，直接位于 54b6be5286bb9bbfcea60abf1c908e833c392d70 之后。
• feat(proxies): fill manual location from outlet probe 提交保留，代理用例、API、探测与前端功能文件相对该提交没有改动；插件账号查询补齐了它需要的位置字段。
• 冻结迁移的 20 项校验通过，本次未改迁移文件。
• 独立 worktree 与分支保留供查看；未推送、未创建 PR、未发布版本。

提交整理

• Provider 删除、计划与验证记录、示例合入记录已并入 feat(plugin): add the complete plugin development and management workflow (#256)。
• 后续四笔依赖更新与两笔代理功能提交继续独立；feat(proxies): fill manual location from outlet probe 保持在 main 末尾。插件账号读取位置字段的修复归入 #209 的代理位置提交。
• 示例 SDK/CLI 引用同步到整理后的插件工作流提交，具体 revision 以示例工程的 Cargo.toml 和锁文件为准；原有 README、pnpm 和 UI 依赖的未提交改动保留。
• 整理前历史保存在 backup/main-before-plugin-provider-squash-20260924，上文旧提交号记录当时的实施与验证状态。