Prism Bridge

把 Prism 变成本机的 OpenAI 兼容接口（Responses / Chat Completions），给 Codex CLI、OMP 以及任何能填 Base URL 的客户端使用。

• 用你自己的 Prism / OpenAI 账号登录。

客户端（Codex CLI / OMP / 任意 OpenAI 兼容客户端）
  → http://127.0.0.1:18765/v1
    → 本机 Playwright 桥（真实 Chromium，由浏览器自己完成 Cloudflare / Sentinel 校验）
      → https://prism.openai.com

• 一键登录：Windows 优先直接拉起系统 Chrome/Edge（不由 Playwright 托管），完成登录并关闭窗口后凭证保存在本机；没有系统浏览器时才使用 Playwright 窗口。
• 图形界面：一个窗口里登录、启动/停止服务、看日志；也可以纯命令行使用。
• 两套接口：/v1/responses 和 /v1/chat/completions，都支持 SSE 流式。
• 工具调用：客户端带的工具（function、custom 自由文本、namespace 分组、Codex CLI 的 additional_tools）由桥中继给模型，调用结果回到客户端，在客户端那台机器上执行，不使用 Prism 自带的云端沙箱。
• 图片输入：input_image / image_url 会先上传到 Prism 项目再交给模型。
• 会话延续：客户端每轮重放全部历史，桥只把新增内容发进同一个 Prism 会话。
• 保活与自愈：每 5 分钟心跳；页面崩溃自动重载；新账号自动创建工作区。
• 限流与失败保护：SSE 保持心跳；普通 401/403、超时、断流或执行状态未知时不盲目重发最终作答，遇真人验证应手工处理。

• Python 3.10+
• 能同时访问 prism.openai.com 和 sentinel.openai.com 的网络（两个都要通，见常见问题）

pip install -r requirements.txt
playwright install chromium

用图形界面时可以跳过第二条：缺少 Chromium 时界面会出现“下载浏览器”按钮。

Windows 双击 prism.cmd，按数字键选择：

Linux / macOS 直接用右边一列的命令。

第一次使用：先登录，再启动服务。启动需要 15–25 秒（唤醒 Chromium 和 Prism 工作区）。登录凭证大约十天过期，过期后重新登录一次。

图形界面的几点行为：

• 关闭窗口会停止服务。
• Windows 登录默认使用未由 Playwright 接管的系统 Chrome，其次 Edge；看到 Prism 编辑器后关闭该窗口，程序才读取会话。系统浏览器不可用时才退回 Playwright 有头登录。
• 图形界面和控制台方式不能同时运行服务。

• Base URL：http://127.0.0.1:18765/v1
• API Key：任意非空值（没设 PRISM_BRIDGE_API_KEY 时桥不校验）

config.toml（codex-cli 0.159.2 实测）：

model = "gpt-6.1-sol"
model_provider = "prism"

[model_providers.prism]
name = "Prism bridge"
base_url = "http://127.0.0.1:18765/v1"
wire_api = "responses"
env_key = "PRISM_BRIDGE_KEY"

环境变量 PRISM_BRIDGE_KEY 填任意非空值，然后 codex exec "Run whoami and tell me the output."。

models.yml：

providers:
  prism:
    baseUrl: http://127.0.0.1:18765/v1
    api: openai-responses
    apiKey: any-non-empty-value
    models:
      - gpt-6.1-sol
      - gpt-5.6-sol
      - gpt-5.6-terra
      - gpt-6-luna
      - auto

各模型需要声明 input: [text, image]，否则 OMP 会把图片换成占位符。OMP 在流里长时间等不到事件时会切到 fallback 模型；不想被静默换模型，就把这个 provider 的 fallback 链设为空。

目前prism仅仅支持以下三个模型，astra曾经上过但是被下掉了。

以上是 2026-10 的目录。Prism 网页的模型下拉框由官方远程配置下发，配置没加载出来时网页只显示 5.6 Sol，这不代表其它模型下线。（一般是页面中文会触发）

Prism 拒绝某个模型 ID 时桥直接报错，不会悄悄换成别的模型。设 PRISM_ALLOW_MODEL_FALLBACK=1 才会回退到 Prism 默认模型，此时响应里的 model 是 auto。

推理挡位可通过 reasoning.effort（优先）或 reasoning_effort 传入；max、ultra 原样传给 Prism。默认仍为 high；xhigh/highest 映射为 high，minimal/min 映射为 low。

• GET /health：服务状态、用户 ID、凭证过期时间
• GET /v1/models：模型列表
• POST /v1/responses：OpenAI Responses（SSE、函数调用、custom 工具、namespace、additional_tools）
• POST /v1/chat/completions：Chat Completions（SSE、tool_calls）

Prism 后端只把 system 条目和最后一条 user 消息交给模型，请求里的 instructions 和原生 tools 都会被丢弃（2026-10-03 实测）。所以桥把一段短协议和客户端的工具目录放进用户消息开头的 <relay_instructions> 里。模型需要工具时输出：

<client_tool_call>
{"name":"bash","arguments":{"command":"whoami"}}
</client_tool_call>

桥把它还原成 Responses 的 function_call（自由文本工具还原成 custom_tool_call），由客户端执行后把结果带回下一轮。能直接回答的问题模型输出纯文本，不走工具。

桥只做传输，不复制客户端的系统提示：超过 2000 字的 instructions 默认不转发（PRISM_FORWARD_CLIENT_INSTRUCTIONS=1 或单个请求里 metadata.forward_instructions=1 可强制转发）。

接入新客户端不工作时，设 PRISM_DUMP_DIR=<目录>，桥会把每个请求体、发往上游的内容和解析结果各存一份 JSON（不含 Authorization），先看客户端把工具放在了请求的什么位置。

• 无 /fast 加速接口：桥目前不提供未经 Prism 明确确认的加速参数。
• 限流与未知失败：短时间内连发多轮（曾实测约 25 秒 5 轮）会被上游拒绝。仅已明确确认未执行的拒绝可有限等待或重试；普通 401/403、超时、断流以及提交后缺少请求 ID 不触发自动重发最终作答。遇真人验证应手工处理，不保证切换浏览器即可通过。
• 发送大小：按 JSON 转义后的 UTF-8 文本字节计量，默认每段 86000、最多 8 段，包含协议、工具目录及分段包装；这不是模型 token 窗口。发送前逐段预检，当前保护批次超限时不启动 worker、不建会话、不上传图片。
• 续接优先：delta 可发送时不预先构建或压缩备用 full；只有未命中或已确认可安全重放时才准备 full。目录变化仍会在 delta 中刷新，租户、模型和原始历史哈希的续接规则不变。
• 自动压缩是有损摘录，不是模型摘要：默认目标 2 段，保留旧版成功候选；旧版能在 8 段内完整发送的历史不新增删减。仅旧候选确实超硬限时自适应放宽目标。当前真实提问、随后的工具调用、结果和图片不裁；0 禁止有损压缩。不增加摘要模型调用，不新增摘要持久化，也不保证旧细节或模型记忆无损。
• 诊断与隐私：日志记录实际发送路径、段数、字节和历史省略范围，不把备用候选当成已发送；未建立真实归档时明确原文未保留。显式开启调试导出仍会保存请求正文，请自行保管，不将调试目录误认为客户端可访问的归档服务。
• 聊天列表：桥创建的会话会出现在你 Prism 项目的聊天列表里，桥不会删除它们。
• 整段返回：Prism 生成完才给正文，流式输出里先是心跳，最后一次性给出内容。
• 上游会变：这是对网页接口的适配，Prism 改版后可能失效。
• 没测过的客户端：Codex 桌面版、Codex 的 apply_patch、经 Codex 传图片、Claude Code 等。

都是可选的。

桥可以当成一个 OpenAI 兼容的上游，挂到网关后面：

export PRISM_HOST=0.0.0.0
export PRISM_CALLER_OWNED_TOOLS=true
export PRISM_BRIDGE_API_KEY='自己设一个'
python bridge.py serve

在网关里新增一条 OpenAI 兼容渠道：Base URL 填 http://<运行桥的机器>:18765/v1，类型选 Responses，Key 填上面的 PRISM_BRIDGE_API_KEY。

• 一定要设 PRISM_BRIDGE_API_KEY，或者保证端口只有网关能访问。否则任何连得上这个端口的人都在用你的 Prism 账号。
• 服务器没有桌面时：在有桌面的机器上 python bridge.py login，把生成的 auth.json 拷到服务器，用 PRISM_AUTH_FILE 指过去。凭证过期后重复一次。
• Linux：桥默认用完整 Chromium 的新 headless 模式。Playwright 默认的 headless shell 配持久化浏览器目录，在 Linux 容器里启动约 30 秒后会丢光 Cookie。
• 会话延续要靠用户标识：网关模式下，请求带 X-User-Id / X-OpenAI-User 请求头或 user 字段时才续接会话；都没有时每个请求都当成新会话整段重放，避免不同用户串到同一个会话里。
• 一个 Prism 账号的限流是共用的，多人同时用会更容易触发。

登录窗口启动即退出：TargetClosedError / exitCode=2147483651 这是浏览器启动阶段的问题，不能仅凭这个异常判断 Cookie 失效或 Cloudflare 拦截。我们在 Windows 上用公开提交 26d82ff2246676f0256944280d8352fe5eac67ab 实测：全新 profile 正常，既有 profile 副本用 bundled Chromium 有头模式会崩溃，改用系统 Chrome 则正常；并非所有用户都会遇到。

新版 Windows 登录优先使用系统 Chrome，再选 Edge，均未安装才用 bundled Chromium。只在浏览器未安装时继续尝试；profile 占用、权限或其它启动错误保留原始报错，不会删除 profile、Cookie 或强杀浏览器。服务模式默认不变。显式设置 PRISM_BROWSER_CHANNEL 时尊重该选择，失败不自动换浏览器。

登录弹出 auth.openai.com「正在验证您是否是真人」/ Just a moment...，或 JSON 解析报 Unexpected token '<'（Issue #1） 这是登录/授权阶段拿到了 HTML，不是桥把 Cookie 解析错。Playwright 托管窗口在本机曾出现 GET /api/accounts/authorize 返回 403 text/html，标题 Just a moment...，授权弹窗会反复刷新；系统 Chrome 同机可走到正常登录页。

新版 Windows 登录默认直接启动系统 Chrome，其次 Edge，不由 Playwright 接管登录窗口。看到真人验证时，在该窗口等待验证完成，不要反复点击「使用 OpenAI 继续」；看到 Prism 编辑器后关闭这个登录窗口，程序再读取 Profile 中的会话并保存。服务模式仍使用 Playwright 无头浏览器。

如果仍出现真人验证：先确认日常 Chrome 能否打开 prism.openai.com 和 auth.openai.com，并确保两个域名走同一条能用的线路。换浏览器不是绕过验证的保证；若普通浏览器也持续验证或打不开，是网络/IP/账号风险控制，需要停止反复重试并稍后再试。

显式指定登录通道时：

$env:PRISM_BROWSER_CHANNEL = "chrome"
python gui.py

系统 Chrome 使用本项目独立的 profile，不是日常浏览器的默认个人资料。关闭登录窗口前不会写入 auth.json。

启动报 net::ERR_CONNECTION_CLOSED 到不了 prism.openai.com。

页面能开，但所有请求都是 403 {"error":"Request verification failed"} 到不了 sentinel.openai.com，校验令牌拿不到。两个域名必须走同一条能用的线路。

Error while processing conversation (403 Forbidden) 限流，见已知限制。停一会儿再用，不要连续重试。

This request is too large to send 来自 Prism 的单轮大小限制，和模型上下文窗口无关。新版桥已经按会话延续和拆分处理；还遇到的话检查 PRISM_CONTINUE 是否被关掉。

模型说“看不到本机文件”或自己编工具名 通常是客户端把工具放在了桥不认识的位置。用 PRISM_DUMP_DIR 看请求体。

端口被占用 桥已经在另一个窗口运行，或者换一个端口：python bridge.py serve --port 18766。

本项目通过浏览器自动化访问你自己账号下的 Prism，可能不符合 OpenAI 的服务条款，账号风险自负。仅供学习和个人使用，请勿用于转售或大规模滥用。

本项目认可并参与 LINUX DO 社区。

GitHub：@yyyllllming

QQ 交流群：608041120，群主即为作者。传播、转载、二次分发请标明原作者。

本项目以 MIT 协议开源。