【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载导读本文基于 opencodex 开发记录中一份真实落地的分支拆分方案devlog/_fin/260722_claudedesktop_branch_split/000_plan.md完整还原把尚未成熟的 Claude Desktop 集成面从稳定的dev主干中拆出同时把全部 Desktop 工作保留在直接堆叠在该主干之上的独立分支这一 Git 历史重写操作。读者将掌握一套可复用的远程分支安全拆分范式如何精确锁定拆分点 SHA、如何用--force-with-leaserefs/heads/branch:expected-sha实现并发远端移动即中止的原子保护、如何设计可验证的产物边界以及如何在出错时无副作用的回滚。文中所有命令与验证步骤都结合了当前仓库源码与测试给出实操依据。背景为什么要把 Claude Desktop 从dev主干中拆出去opencodex 是面向 OpenAI Codex 与 Claude Code 的通用 provider 代理Claude Desktop 是其Claude 生态集成工作面的重要一环。仓库中与 Claude Desktop 相关的实现横跨多个模块从 CLI 到 GUI、再到服务端管理面例如gui/src/pages/ClaudeDesktop.tsx —— Desktop 配置页管理 opus/fable/sonnet/haiku 四个模型家族的路由分配、默认模型与 apply 指纹gui/src/pages/integrations/overview-clients.ts —— 集成总览中把claudeDesktop作为与 codex、claude、grok、cursor 并列的顶层集成客户src/cli/claude-desktop.ts ——ocx claude desktop子命令族提供 apply/show/status/move/default/export/importsrc/claude/desktop-first-party.ts--first-party模式、src/claude/desktop-3p.ts--gateway模式、src/claude/desktop-remote-store.ts远端配置存储src/claude/desktop-policy.ts —— Windows 机器级策略HKLM\SOFTWARE\Policies\Claude的只读、隐私安全探测。2026-07-22 这次拆分发生时Claude Desktop 集成面仍处于未成熟状态不应进入dev的日常演进但整套 Desktop 工作又不能丢失。于是需要一次远程dev历史重写Work class: C4让dev回到不含 Desktop 的干净基线把包含 Desktop 的完整历史原样保存到新分支claudedesktop并且保证新分支直接堆叠在dev之上未来可以干净地合并回主干。工作类别说明C4表示remotedevhistory rewrite即对远端dev分支的历史进行重写。这类操作在 devlog 中被视为常规但高风险的开发簿记拆分的最终结果分支结构、SHA已经存在于公开 git 历史中因此这份计划属于_fin/下的已关闭记录。拆分点锁定精确到 SHA 的基线计算任何历史重写的第一步都是把干净基线与Desktop 集成分支之间的边界精确锁定。该文档给出了四个关键 SHA含义SHA当前本地/远程dev含 Desktop 与两笔修复6da54a8965c24cdd31c4641ac3a864aad4968204Desktop 合并提交作为被剔除的合并418d29b1a0e7ae4945648720bd1bda390caf12ba干净的dev基线合并的第一父提交79e5067a4058f6c7e44462dbb188707fa6df70d6Desktop 功能分支父提交0c092de3ab54d78e87d0d84dad1c5826b1ef636c其推导逻辑非常值得借鉴。文档指出当前dev在 Desktop 合并之后只有两笔提交且两笔都是 Desktop/i18n 集成的修复ed2ed675—— 清理 Desktop 分支引入的冲突标记残留行6da54a89—— 为日语ja、俄语ru补充 Claude Desktop 相关键。因此不包含 Desktop 的干净dev在数学上恰好等于 Desktop 合并提交的第一父提交干净 dev 418d29b1^1 79e5067a这一行推导是整个拆分方案的基石只要合并提交的两个父提交第一父 合并前主干第二父 被合并分支语义正确就能用取第一父的方式无损剥离合并内容得到恰好等于从未合入 Desktop的主干状态。实现侧佐证Claude Desktop 的 GUI 界面在 gui/src/pages/ClaudeDesktop.tsx 中单独成页且集成总览把它作为独立客户端建模见 gui/src/pages/integrations/overview-clients.ts。这正是文档中以gui/src/pages/ClaudeDesktop.tsx是否存在于某分支来判定 Desktop 是否被引入这一内容边界能成立的原因——Desktop 是一个可独立成页、可整体判定存在与否的功能面。执行窗口与前置条件写冻结与并发安全该计划在正式执行前明确了一个关键的运行约束——短写冻结窗口仅有一个本地 worktree没有其他本地dev检出在重写完成并验证通过之前不允许任何其他 agent 向dev推送。这个约束的动机是重写后的陈旧检出问题任何基于6da54a89的过期 checkout在下次推送前必须先 reset 或 rebase否则一次普通的 fast-forward 推送就可能把 Desktop 内容意外放回dev。换句话说历史重写的真正风险不在重写本身而在重写之后其他人基于旧 SHA 的常规推送。正式执行前的六项前置条件在真正变更前一刻必须全部成立否则中止worktree 干净本地dev origin/dev 6da54a89本地与远端一致无漂移本地与远程均不存在claudedesktop分支确保新建分支不会意外覆盖或复用它origin只包含main、preview、dev三个分支对预期产物做一次预演确认见下文执行步骤再次确认写冻结窗口内没有其他推送者。执行步骤先备份、再移动、最后重写整个执行是一个先建备份、再动主干、最后验证的六步流程每一步都在可逆与不可逆之间划出清晰界线。Step 1 — 拉取并修剪远端引用且仅当所有前置条件在变更前一刻仍成立时继续。前置条件的意义是基于当前快照的承诺一旦条件变化例如远端多了新分支、本地出现脏文件整个流程立即失败避免基于过期信息做破坏性操作。Step 2 — 在本地创建claudedesktop分支指向当前dev的6da54a89git branch claudedesktop 6da54a8965c24cdd31c4641ac3a864aad4968204这一步只是本地书签不触碰远端也不移动dev。Step 3 — 先建立远程备份且使用不存在的引用 lease双重保护git push --force-with-leaserefs/heads/claudedesktop: \ origin refs/heads/claudedesktop:refs/heads/claudedesktop这里的--force-with-leaserefs/heads/claudedesktop:期望 SHA 为空意味着只有当远端该引用不存在时才允许创建从而杜绝意外覆盖一个已经存在的同名分支。推送后立即验证远程claudedesktop 6da54a89一旦不符中止且绝不移动dev。Step 4 — 仅在重新确认 worktree 干净之后把检出的本地dev移动到79e5067agit reset --hard 79e5067a4058f6c7e44462dbb188707fa6df70d6此时本地dev已经回到不含 Desktop 的基线但远端dev尚未被触碰——本地与远端暂时分叉这个窗口内绝不推送。Step 5 — 重写origin/dev并用预期旧值锁死并发git push --force-with-leaserefs/heads/dev:6da54a8965c24cdd31c4641ac3a864aad4968204 \ origin 79e5067a4058f6c7e44462dbb188707fa6df70d6:refs/heads/dev这是整个方案的技术核心。--force-with-leaserefs/heads/dev:6da54a89的含义是只有在推送时远端dev仍精确等于6da54a89即仍然是我们推导出干净基线的那份历史才执行强制更新如果在我们执行期间有任何并发推送移动了dev本次推送会被 Git 拒绝而非覆盖对方的工作——并发远端移动即中止而不是被覆盖。Step 6 — 完整验证。见下一节。验证矩阵让成功可以机械判定重写完成后计划定义了一套可逐条机械判定的验证矩阵检查项期望结果本地与远程dev均为79e5067a本地与远程claudedesktop均为6da54a89git merge-base --is-ancestor dev claudedesktop成功dev是claudedesktop的祖先origin分支集合恰好为main、preview、dev、claudedesktop加上HEAD内容边界gui/src/pages/ClaudeDesktop.tsx在dev上不存在、在claudedesktop上存在其中git merge-base --is-ancestor dev claudedesktop的祖先关系验证尤其重要它证明的不是两个分支碰巧内容相似而是claudedesktop确实完整包含dev的全部历史因此未来主干演进之后claudedesktop可以在不产生重复合并、不丢失主干提交的前提下被干净地合回。这正对应文档分支直接堆叠在该dev基线之上的目标。边界佐证ClaudeDesktop.tsx之所以能作为Desktop 是否引入的判定锚点是因为该页面在 GUI 中是 Claude Desktop 唯一专属的顶层页面且集成总览对claudeDesktop的行模型见 gui/src/pages/integrations/overview-clients.ts使得它要么整体在、要么整体不在。边界约束与回滚预案计划明确列出了操作的边界防止重写过程中顺手做无关变更不做任何源码编辑这是纯 git 簿记操作不移动main/preview不发布 release、不执行 npm publish不创建或删除其他远程分支。**回滚预案Rollback**同样是一套可机械执行的反向序列git fetch --prune断言远端origin/dev 79e5067a、本地claudedesktop 6da54a89只有期望状态才允许回滚用带 lease 的推送恢复远端devgit push --force-with-leaserefs/heads/dev:79e5067a4058f6c7e44462dbb188707fa6df70d6 \ origin refs/heads/claudedesktop:refs/heads/dev—— 即用claudedesktop分支把dev推回6da54a89且同样以79e5067a作为 lease 期望值防止覆盖并发移动 4. 验证远端dev 6da54a89 5. 断言本地 worktree 完全干净 6. 只有以上全部通过后才把本地devreset 回精确的6da54a89 7.claudedesktop作为备份保留除非用户另行授权删除。回滚设计的核心思想先恢复远端、再恢复本地。因为在重写过程中本地与远端短暂分叉若先动本地会丢失唯一可信的恢复源claudedesktop上保存的完整 Desktop 历史。拆分结果与质量验证按计划执行后的最终状态dev本地/远程79e5067a4058f6c7e44462dbb188707fa6df70d6—— 稳定主干回到不含 Claude Desktop 的干净基线claudedesktop本地/远程6da54a8965c24cdd31c4641ac3a864aad4968204—— 完整 Desktop 工作原样保留main与preview不变仍为6d6bef8b98d762ff9679916546cb44e8e3effebcorigin 头部分支恰好为claudedesktop、dev、main、preview祖先关系dev是claudedesktop的祖先内容边界ClaudeDesktop.tsx在dev上缺席、在claudedesktop上存在worktree干净本地dev与origin/dev一致。重写之后还附带了三重质量验证证明历史变了但代码没坏bun run typecheck通过隔离的测试套件完整运行且无失败退出与重写后精确 SHA79e5067a完全一致的既有 Cross-platform CI 运行29914489485为绿色——这得益于干净基线 合并第一父提交的特性79e5067a原本就是历史中的真实提交CI 早已为它跑通过。可复用的方法论提炼从这份计划中可以提炼出一套适用于任何从主干剥离不成熟功能面场景的通用流程用合并拓扑锁定边界若待剥离内容是一次合并引入的且其后只有少量修复提交则干净基线 合并提交的第一父提交且验证合并后提交集全部属于该功能即可无损推导先备份后重写任何历史重写都必须先把被剥离的内容完整保存到一个可恢复的分支本地 远程双备份再动主干给每个强推带上精确 lease--force-with-leaserefs/heads/branch:expected-old-sha把我知道远端此刻是什么显式写成承诺任何并发移动都会让强推安全失败而不是静默覆盖——这正是本方案能在多人协作仓库中放心执行的根本原因用祖先关系代替内容比较git merge-base --is-ancestor证明新分支完整包含主干历史为未来干净合并背书回滚 反向重写回滚本身也是一次带 lease 的强推且遵循先远端后本地的顺序善用 CI 历史因为拆出的基线是历史真实提交可以复用该 SHA 上既有的绿色 CI 运行作为重写后的质量证据而不必等待全量重跑。对于 opencodex 的后续演进claudedesktop分支在 Desktop 面成熟后可以沿dev的祖先关系干净合并回主干在合并之前dev保持不受 Claude Desktop 集成面干扰让主干演进与实验性集成互不阻塞——这正是本次分支拆分的最终目的。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐深入解析 Git Remotes 历史改写force push 的危险、force-with-lease 安全推送与协作最佳实践深入解析 Git Remotes 历史改写force push 的危险、force with lease 安全推送与协作最佳实践 本篇文章以 The Odin文档教程教育opencodex 分支合并实战claudecode → dev 的 53 提交安全合流与冲突解决记录opencodex 分支合并实战claudecode → dev 的 53 提交安全合流与冲突解决记录 本文基于 opencodex 仓库 devlog/_ftldraw 仓库实战用 clean-copy 技能把混乱分支重写成叙事级提交历史tldraw 仓库实战用 clean copy 技能把混乱分支重写成叙事级提交历史 导读 本指南以 tldraw 仓库内置的 Agent 技能文档 skill前端UI组件上一篇3周迁完80个页面一次基于 miniprogram-to-vue3 的真实迁移实录下一篇3步实战用Ehoney蜜罐系统构建企业级欺骗防御体系创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
