Kaixxrua / excel-codex-bridge

# Codex Channels（excel-codex-bridge）
**简体中文** | English
> **非官方项目**，与 OpenAI、Microsoft 无任何关联，也未获其认可。使用前请先读风险与免责声明。
## 0.6：多通道研究与原生桥接
新增 **Codex HTTP、WebSocket、官方 CLI、SIWC、Responses 兼容服务、BPS** 六种研究适配器。
通过冻结题目、账号核对、提交前记账、固定评分和配对报告，对比实际可用性；不再以 Excel 为唯一前提。
Windows 包双击 `codex-channels.cmd` 只查看通道；macOS 使用 `codex-channels.command`，Linux 使用 `codex-channels.sh`。
完整流程与配置见 多通道研究指南。
 [code] 
研究默认不发请求；只有 `run` 执行冻结预算内的实验。CLI 内部重试、中转背后的账号和 SIWC 工作区身份有各自证据限制，
报告会标明，不能据此承诺模型能力恢复。已有启动器和包名保留兼容，研究入口与日常桥接分开。
## 原生桥接与兼容模式
默认上游已改为 **Codex HTTP**，使用 `codex login` 保存的本机 ChatGPT 登录。Excel/BPS 保留为
`--route excel` 兼容模式。服务启动后固定渠道；原生请求失败不会自动改走 BPS、换账号、降低推理强度或
删掉图片、工具及加密历史重试。模型目录采用所选账号返回的原生目录，包括提示词、工具能力、推理档位和上下文限制。
 [code] 
 [code] 
`EXCEL_BRIDGE_ROUTE=codex|codex-ws|excel` 可设置默认渠道，命令行 `--route` 优先。原生路径需要 Codex 的
ChatGPT 登录，不接受 `--login excel`。桥接只读取凭据，不替 Codex 刷新它；到期时重新 `codex login`。
双击原有启动器也使用新的默认渠道。升级后完全退出并重新打开 Codex，并为新渠道开始新对话；旧 BPS
会话里的加密历史可能无法跨后端使用，原生路径不会删除这些历史来假装续接成功。
`check-route` 目前验收原生 Codex：先调用一个只返回随机值的本地测试工具，再检查模型能否正确使用工具结果。
它不会执行 shell、读取项目文件或比较模型智力。每次运行先记账再提交，最多两次；失败即停止。
结果保存在状态目录的 `route-checks/*.json`，只含账号指纹、实际渠道、请求次数、终态、模型、档位和耗时，
不保存 token、题目、回复或加密推理。模型目录可读、登录有效和 `/healthz` 正常都不等于推理已通过；
检查成功也只证明本次工具协议可用。每次重新运行检查会产生新的推理用量。
这些次数上限仅适用于 `check-route`；正常使用时，Codex 或 SUB2API 自身发起的重试属于新的请求。
原生适配支持原生工具、完整历史、流式与非流式 Responses，以及图片输入。HTTP 模式要求完整 `input`，
不支持 `previous_response_id`、服务端会话或 `store:true`；独立图片生成接口返回明确的“不支持”。
不会把旧的 `*-1m-excel` 模型别名或 BPS 的上下文上限套用到原生模型。响应头 `X-Excel-Bridge-Route`
报告实际渠道；原生日志记录请求 ID、模型和完成/失败状态。单个服务进程内，同一 `prompt_cache_key`
切换账号会被拒绝；切换账号或渠道后应新开对话。
SUB2API 也可选原生 HTTP 或 WebSocket：见 部署说明。SIWC 等研究通道见 多通道指南。
## Excel/BPS 兼容模式
**下文的 Excel 登录回退、工具转换、生图、长上下文和重试说明仅适用于 `--route excel`。**
原有命令示例使用这一模式时，请增加 `--route excel`，或先设置 `EXCEL_BRIDGE_ROUTE=excel`。
> **新增可选：SUB2API 插件。** 将 Excel 会话作为独立上游接入你自己的 SUB2API，
> 无需修改 SUB2API 源码，见 Docker 部署与 SSH 会话同步。
> 此模式会在你显式运行同步命令后，把会话送到你指定的可信服务器；
> 下文“仅本机、只发往 OpenAI”的说明指默认本地模式，不适用于远端插件模式。
用你**自己电脑上**已有的 ChatGPT 登录来跑 Codex CLI
和 Codex 桌面版：双击或一条命令，本地桥接和 Codex 一起启动，退出时桥接自动关闭。
默认优先用 Codex 自己的登录（`codex login`），这样不必安装 Excel；后端不接受它时自动回退到
Excel 加载项缓存的那份会话，需要时会替你打开 Excel 的 ChatGPT 面板登录。见登录方式。
不监听本机以外的地址，会话只在内存里，只发往 OpenAI。
## 工作原理
 [code] 
- **自己不做登录**：不实现 OAuth，不碰账号密码，也从不刷新或写入任何 token。它只读取本机上
 已经存在的 ChatGPT 登录——优先是 Codex 自己的（`codex login` 写在 `~/.codex/auth.json`），
 其次是 Excel 加载项缓存在 WebView2 里的那份会话（`bps_auth_tokens`）。用 Excel 那份时，需要登录会在
 面板里完成（本工具会自动打开面板）。取哪一份、怎么回退见登录方式。
- **token 只在内存里**：不写盘、不上传，只随请求发往 `bps.openai.com`；日志只有请求行和错误类型，
 不含提示词和 token。
- **只给本机用**：只监听回环地址；拒绝非回环来源、非回环 `Host`（防 DNS rebinding）
 以及任何带 `Origin` 头的浏览器请求。`serve` 拒绝绑定 `0.0.0.0`。
- **工具调用**：Excel 后端不接受客户端自带工具。桥接把 Codex 的工具（shell、apply_patch…）
 写进提示词，模型通过后端原生的 `run_officejs` 回传调用，桥接再还原成 Codex 的工具调用。
 互不依赖的调用（比如同时读几个文件、跑几条命令）模型会一次发出，Codex 同时执行；改文件仍按顺序来。
 应用和 MCP 工具按需加载、不常用的工具只写摘要，见提示词大小。
- **多个会话同时用**：几个 Codex 窗口、桌面版对话或子代理可以共用一个桥接同时工作，互不排队。
- **图片**：图片和请求一样只发给 OpenAI。后端不收内嵌图片的地方，桥接像加载项的「上传文件」按钮
 那样把图片传到 OpenAI 再引用，见图片。
- **生图**：Codex 自带的生图工具由桥接转给 Excel 加载项自己生图用的接口