如何在浏览器中同步 Codex 会话Codex Provider Sync 本地 Web UI 完全指南【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-syncCodex Provider Sync是一款开源的本地元数据同步工具它的 Web UI 让你直接在浏览器中同步 Codex 会话文件与 SQLite 聊天索引中的 Provider 信息。切换 Provider 后旧会话无法使用通过本地 Web UI 一键预览、确认并同步旧会话即可重新可用。全程只在本机运行数据不上传任何远程服务。为什么需要 Codex 会话同步用过 Codex 的都知道切换 Provider比如从 OpenAI 切到自定义供应商之后旧会话里的 Provider 元数据还停留在旧值导致历史会话无法按当前配置继续对话。Codex Provider Sync 的 Web UI 正是为了解决这个元数据不一致问题——它把会话文件rollout和 SQLite 聊天索引中的 Provider 信息对齐到当前配置需要注意它只同步 Provider 信息不修改聊天正文也不是登录工具或解密工具。跨供应商的encrypted_content推理内容可能无法解密遇到这种情况请切回原 Provider 或新建会话。快速安装3 步启动本地 Web UI 只需 Node.js16.20.2无需安装桌面应用npm install -g dailin521/codex-provider-sync codex-provider web启动后终端会输出默认地址http://127.0.0.1:8791并自动打开系统浏览器。首次进入使用一次性配对链接完成授权服务端只保存设备凭证哈希配对逻辑见 apps/web/src/pairing.ts。常用启动参数codex-provider web --port 8792 # 更换端口 codex-provider web --no-open # 不自动打开浏览器 codex-provider web --reset-access # 撤销当前浏览器授权 codex-provider web --codex-home /path/to/.codex --sqlite-home /path/to/sqlite 本地 Web 服务与 CLI、Electron 桌面版共用同一套 Node 同步核心安全边界和锁机制完全一致服务端入口为 src/web-server.js。在浏览器中同步当前 Provider 的完整步骤确认状态打开概览页检查当前 Provider、同步状态和存储路径。执行同步点击预览同步查看影响范围后确认赶时间可以直接点直接同步点击即授权内部仍走 Prepare/Apply、锁与备份校验。查看结果部分完成时先查看跳过项和失败阶段结束占用相关文件的 Codex 会话后重试。如果你希望由本工具直接改配置在概览底部使用单独切换 Provider——它会更新 config 中的目标 Provider 后再同步历史会话可选择使用目标模型、保留根模型或手动指定模型。日常同步只对齐 Provider不调整历史模型也不触发高级修复轻量且安全。Web UI 六大页面功能一览页面用途概览当前 Provider、同步状态、备份数量、存储来源同步与切换都在这里完成备份与恢复统一设置保留数量默认 2 份查看/恢复/清理备份聊天记录按项目组织会话支持元数据与正文搜索右键复制会话 ID 和继续命令存储配置管理受信任的 Codex 数据位置和聊天索引位置高级功能主动发起只读诊断按需专项修复日常同步用不到设置中英文切换、主题跟随系统/浅色/深色、自动同步管理、撤销浏览器连接界面完全支持键盘操作支持 200% 缩放窄窗口下聊天记录页会自动切换为列表/详情模式。进阶用法SSH 端口转发 远程浏览器服务只监听127.0.0.1不能直接暴露到局域网或公网。但在无桌面的远程机器上只转发回环端口即可ssh -L 8791:127.0.0.1:8791 userserver在远程 shell 中启动codex-provider web --no-open命令会输出可点击的一次性配对链接本地浏览器打开即可完成授权操作——这是 SSH 环境下使用 Codex 会话同步工具的最安全方式。本地安全边界你的数据只留在本地 Web UI 的安全设计值得了解仅回环监听服务只绑定127.0.0.1拒绝远程直连一次性配对首次启动生成短时配对链接服务端仅存凭证哈希严格 CSP生产环境 HTML 使用每响应随机 nonce禁止远程脚本与跨源 Core 请求先预览后写入预览同步、切换、修复、恢复都先显示预计改动再确认恢复只能选择本应用创建的受管备份。常见问题与注意事项⚠️同步中正在使用的会话可能被跳过结果显示部分完成。这是正常现象——结束相关 Codex 会话后再次同步即可不必担心数据丢失写入前已自动备份默认保留 2 份。⚠️不要用删除锁文件的方式解决状态待刷新——状态待刷新不等于工具正在写入锁文件由 src/state-db-lock.js 管理请让服务自行完成状态收敛。⚠️聊天记录数量与 SQLite 索引短暂不同步属于正常时序现象以页面显示的 Provider 分布和同步状态为准。总结Codex Provider Sync 的本地 Web UI 让你在浏览器中就能完成 Codex 会话的 Provider 元数据同步3 步启动、先预览后确认、修改前自动备份还支持 SSH 端口转发接入远程机器。完整文档见 docs/README_WEB_UI_ZH.md界面源码位于 apps/web/src/想深入了解同步落盘机制可阅读 docs/WORKING_PRINCIPLE_ZH.md。【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-sync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
