题桥 ProblemBridge

面向 CSP / NOIP / AtCoder 训练的 VS Code 学习工作台。网站看题，一键导入，自己写 C++，用 CPH 运行公开样例。

当前为预览版。商店发布正在准备中，可以从源码构建安装包。

一次训练怎么开始

1. 安装本插件的 VSIX、CPH（Competitive Programming Helper）以及 C++ 编译器。
2. 在 VS Code 打开并信任自己的训练文件夹。
3. 在 Chrome 加载配套扩展目录 browser/oi-vjudge-bridge。每次更新该扩展后，在扩展管理页重新加载，再刷新题目页面。
4. 打开支持网站的具体题目，点击「导入 VS Code」。首次导入时设置程序保存目录和命名规则。
5. 左侧读题，中间写程序；点击「运行样例」进入 CPH 测试，点击书本入口返回题面。

主要功能

• 题面和公开样例导入，保留公式与原站图片链接。
• 自选程序目录、文件名和模板，也可关联已有 C++ 程序。重复导入保留已有测试。
• CPH 本地样例测试，以及顶部编译文件清理入口。
• 手动翻译与原文切换；目标语言和模型在 AI 设置中调整，译文本地缓存。
• 旧版 .oi 工作流提供分级提示请求、对拍和复盘命令；这些功能尚未全部接入 CPH 工作流。

网站与验证范围

这些原站适配不包含自动提交、成绩同步或整站题库同步。交互题、文件输入输出题不支持。

编译器设置

CPH 调用独立安装的 C++ 编译器。macOS 自带的 g++ 通常是 Apple Clang，无法直接使用 GCC 的 bits/stdc++.h。

如果使用该头文件，先安装 GNU GCC，再在 VS Code 设置中填写：

{
  "cph.language.cpp.Command": "/opt/homebrew/bin/g++-16",
  "cph.language.cpp.Args": "-std=c++17"
}

路径和版本号只是示例，应以本机安装为准。Windows、Linux 使用各自实际的 GNU C++ 路径。

CPH 与 AI 依赖

当前 CPH 文件适配已验证 2026.8.1785865132 和 2026.9.1789051951；其他版本会暂停写入并保留基础测试降级。此适配使用 CPH 内部文件格式，并非 CPH 官方公共导入 API。CPH 需单独安装，项目不附带修改版 CPH。

翻译需本机可用的 Codex 或 Claude Code 客户端，以及对应账号验证。模型必须对当前账号可用；插件不提供会员额度，也不保证特定模型可用。Claude 路径尚缺本机登录后的完整验收。默认不自动翻译。

数据与使用边界

题面、程序关联、样例和译文缓存保存在本地。主动翻译时，题面会发送给所选 AI 服务；原站图片加载会访问其图片服务器。详见 隐私说明。

本地通过样例不等于在线 AC。只运行自己信任的代码：本地测试不是隔离沙箱。

开发与授权

npm ci → npm test → npm run build:browser → npm run package。

采用 MIT License，允许使用、修改与再分发。网站题目与第三方依赖的权利归各自权利人，项目许可不代替其授权。

问题反馈

请在 GitHub Issues 提交问题，不要附带账号凭据或私密题面。

Windows AI 客户端

0.10.5 起，Codex 和 Claude Code 共用跨平台启动适配。优先使用官方原生客户端，也支持标准 npm 安装生成的 .cmd（解析到相邻官方包的 JS 入口，不经过命令行 Shell 传递题面）。

在运行题桥的同一环境安装并登录官方客户端。Windows 原生 VS Code 和 WSL 是不同环境；插件不会自动跨环境读取账号。安装后重启 VS Code，或在设置中填写 oiCoach.ai.codexPath / oiCoach.ai.claudePath 的本机绝对路径。自定义 Shell 包装脚本不支持。路径为机器专属设置，不应写入 OneDrive 共享工作区。

AI 设置检查客户端和登录状态，Codex 另外读取额度接口；验证通过不等于翻译已验证。Claude 登录结果仍显示“实际调用待验证”，请点击题面翻译完成实测。不会自动切换到 API 计费。

本地题目与环境检查（0.11.0）

题桥侧栏新增“本地题目”和“环境与设置”。本地题目复用当前工作区的导入记录，点击打开缓存题面及关联程序；顶部搜索支持题名、网址和文件名，清空搜索显示全部。新打开的题目排在前面，旧记录首次重开后获得时间记录。右键移除只删除列表记录，保留程序、CPH 样例和缓存。此列表不是跨工作区、跨电脑同步题库。

环境区显示 CPH 是否安装及版本是否匹配。点击编译器检查，只执行 --version，不运行学生程序、不修改设置；可打开相应设置修正路径。编辑器编译器显示的是用户/工作区设置中的默认值，c_cpp_properties.json 仍可能覆盖它。AI 客户端存在不等于账号验证成功，点击进入原有验证流程。

CPH 升级后的降级运行（0.11.1）

网站一键导入先保存题面、公开样例及程序关联，再尝试连接 CPH。CPH 未安装、版本未适配或连接失败时，题面会提示“CPH 联动暂停”，读题、编辑和翻译仍可使用。点击运行样例可选择基础测试，结果显示在“题桥 · 基础样例结果”输出面板。

基础测试使用 CPH 设置中的 C++ 编译器路径，但固定 C++17 编译参数、按空白分隔比较和每例 2 秒超时，不包含 CPH 后加用例或自定义判题；并非完整在线评测。临时编译文件在测试结束后清除。不会自动运行导入的程序。

未知版本仍暂停写入 CPH 内部数据；恢复已适配版本后，运行或重开题目会再次尝试关联，已有 CPH 数据保持不变。旧版独立 CPH JSON 导入命令仍有版本限制，请使用浏览器题面导入流程。

翻译性能（0.12.0）

先检查磁盘缓存，再连接客户端。重开题目后，已有译文可离线读取。缓存按题面内容、语言、模型和翻译格式区分。显式选过 Spark 的用户仍保留该选择，可在 AI 设置中改为 Luna；默认自动选择现在固定优先 Luna，模型不可用时明确报错，不自动升级到更昂贵模型。旧 Spark 整段 HTML 缓存与新的统一格式不同，首次使用新流程需重新翻译。

Codex 复用一个 App Server 进程和 60 秒账号/模型缓存，每题创建独立 ephemeral 会话，不累积前题上下文。空闲五分钟释放进程；取消、断连、超时或手动验证会清理连接。Claude 登录状态缓存 60 秒，实际生成仍单独启动 CLI。配置及登录修复必须在运行 VS Code 的同一个 Windows / WSL 环境完成。

输出面板“题桥 · 翻译性能”记录本地耗时与生成调用次数，不上传遥测、不记录题面或账号。耗时不是 token 或会员额度统计。短文本 Mac 实测：首次约 9.8 秒、复用连接约 7.5 秒、缓存约 2 毫秒；完整题目和 Windows 的实际速度仍需测试。