OmX 0.7.6 发版解读Team 可靠性加固、角色路由与 MCP Team 运行时抽取【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex本篇技术指南基于 OmXOh My codeX项目的 0.7.6 版本发布说明聚焦该版本围绕 Team 模式展开的三条主线tmux 会话/窗格定位与清理流程的可靠性加固、基于角色的任务路由与分解、以及 MCP Team 运行时的抽取与 CI 门禁可见性提升。读完本文你将掌握 0.7.6 的核心变更内容、底层实现位置含源码佐证以及如何用发版自带的冒烟验证清单复现发版就绪度检查。版本范围与信息口径0.7.6 发版说明制定于2026-03-02当前包版本为0.7.6。发版说明的 Scope policy 明确了信息口径内容严格基于git log --no-merges main..devgit diff --shortstat main...dev这意味着本文所引用的一切变更均来自main..dev分支区间即尚未合入主干的开发分支提交。在阅读仓库源码时若你发现某些实现如 src/team 下的角色路由、缩放清理等比 0.7.6 的提交账本更新的迭代属正常现象——它们反映的是后续演进本文只将源码作为理解 0.7.6 变更语义的佐证。Highlights0.7.6 的三个核心主题按发版说明0.7.6 的亮点可归纳为三点Team 可靠性加固覆盖 tmux 会话/窗格定位、清理流程与基于角色的任务分解MCP Team 运行时抽取与 CI 门禁可见性提升omx_run_team_*系列从通用 MCP 服务器中剥离到独立team-server.ts并新增 CI Status 门禁任务OpenClaw 与 notify-hook 的可靠性/文档更新包括 OpenClaw 通知集成指南、visual-verdict 结构化日志等。Added新增能力逐项拆解专用 ralph 自动运行清理策略#407, #412提交c235a5a feat(team): add dedicated ralph auto-run cleanup policy引入了面向 ralph 自动运行的专用清理策略。其语义是当 ralphRalph 工作流自动运行结束时不再依赖通用清理流程而是有独立的清理策略兜底避免遗留窗格与进程。与之配套后续提交454e69d fix(team): force cleanup on failed/cancelled runs, await worktree rollback, refresh dead-worker panes (#438)强化了失败/取消运行场景的强制清理、worktree 回滚等待与死 worker 窗格刷新。从源码结构看这一系列逻辑分布在 src/team 的cleanup、worktree、pane-status等模块并在测试层有 pane-teardown-residue-e2e.test.ts 这类端到端用例做残骸验证。专用 tmux 会话模式用于 worker 隔离#416—— 经历 revert 与修正提交1653aa7 feat(team): add dedicated tmux session mode for worker isolation (#416)最初希望为 worker 分配独立的 tmux 会话以增强隔离。但随后d4f6803 fix(team): revert dedicated tmux session mode, restore split-pane default恢复 split-pane 默认行为c3d1220 fix(team): switch dedicated tmux session to opt-in with worker location hint (#432)改为 opt-in worker 位置提示ee72e1f Revert fix(team): switch dedicated tmux session to opt-in with worker location hint (#432)再次回退最终f0cc833 fix(tmux): restore injection when scoped mode state is missing修复了作用域模式状态缺失时注入失效的问题。这一段“新增—回退—修正”的往返正是发版说明中 Reverts 章节列出的第一项。最终形态是独立 tmux 会话保持 opt-in默认仍采用 split-pane 布局。从 tmux-session.ts 的现状看团队会话创建仍以 pane 拓扑为核心TeamSession接口中保留了workerPaneIds、leaderPaneId、hudPaneId等窗格级身份字段印证了 split-pane 为主的设计取向同时TMUX_PANE_STABILITY_POLL_MS 60、TMUX_PANE_STABILITY_POLLS_REQUIRED 2等常量说明系统会对新窗格做稳定性探测防止 split 后窗格即刻消失引发的竞态。按 worker 角色路由与任务分解提交7413fe3 feat(team): add per-worker role routing and task decomposition落地了按 worker 角色路由。当前实现位于 role-router.ts其内部结构分为两层Layer 1Prompt 加载——loadRolePrompt(role, promptsDir)、isKnownRole、listAvailableRoles通过扫描prompts/目录下的*.md获取角色提示词角色名必须匹配SAFE_ROLE_PATTERN /^[a-z][a-z0-9-]*$/小写字母数字加连字符如test-engineer。Layer 2启发式角色路由——routeTaskToRole(taskSubject, taskDescription, phase, fallbackRole)返回{ role, confidence: high|medium|low, reason }。路由依据是意图正则build-fix / debug / review / verification / docs / design / cleanup / implementation与ROLE_KEYWORDS关键词表同一类别命中 2 个以上关键词为 high、1 个为 medium、无命中则按 phase 上下文推断并回退到fallbackRolelow。关键词表覆盖了test-engineer、designer、debugger、writer、quality-reviewer、code-reviewer、code-simplifier等角色且内置了韩文关键词如테스트、빌드、리뷰说明路由对多语言任务描述有适配。对应的角色提示词文件可在 prompts 目录中找到如 test-engineer.md、debugger.md。任务分解的另一侧是repo-aware-decomposition.ts其测试 repo-aware-decomposition.test.ts 验证了基于仓库感知的 DAG 分解行为。Changed文档、CI 与 MCP 重构OpenClaw 通知集成指南#413提交0c68a02 docs: OpenClaw integration guide for notifications新增了 OpenClaw 通知集成文档当前仓库中对应的中文版为 openclaw-integration.zh.md完整集成文档为 openclaw-integration.md。该指南属于“Prompt tuning guideconcise context-aware”章节的本地化提示词模板编辑位置集中在notifications.openclaw.hooks[session-start]、[session-idle]、[ask-user-question]、[stop]、[session-end]五个事件的instruction字段推荐上下文令牌始终包含{{sessionId}}、{{tmuxSession}}按事件选择{{projectName}}、{{question}}、{{reason}}详细度策略分三档minimal超短通知、session简洁会话运营上下文推荐、verbose更丰富的状态/动作/风险信息提供了基于jq的快速更新命令模板直接修改$HOME/.codex/.omx-config.json。在源码层notifications 模块与 openclaw 模块含config.ts、dispatcher.ts共同承载该能力测试 custom-alias-enablement.test.ts 验证了custom_webhook_command/custom_cli_command在 notifications 与 openclaw 两层间的配置一致性如openclaw.hooks[session-end].gateway custom-webhook。CI Status 门禁任务#423提交56091a4 ci: add CI Status gate job for branch protection为分支保护增加了 CI 状态门禁任务让 PR 是否通过核心检查在 CI 面板上一目了然。仓库的 ci-rust-gates.test.ts 从侧面印证了 CI 门禁在仓库验证体系中的地位Rust 工作区门禁与 TypeScript 主仓库并存。抽取omx_run_team_*到独立 team-server.ts#431提交3f6b3fd refactor(mcp): extract omx_run_team_* to dedicated team-server.ts将 MCP 层与 Team 相关的omx_run_team_*系列工具从通用服务器剥离为独立模块。这是典型的运行时关注点分离Team 运行时的复杂度tmux 会话管理、worker 生命周期、状态机不再污染通用 MCP 服务器而成为独立的 MCP 能力入口。MCP 相关的服务器实现集中在 src/mcp如state-server.ts、code-intel-server.ts、wiki-server.tsTeam 侧交互则在 src/team 的mcp-comm.ts与api-interop.ts中体现。Fixed修复清单与源码落点0.7.6 修复面可以按领域划分为五组每组都能在仓库中找到对应实现或测试佐证修复领域提交源码/测试佐证OpenClaw 原生网关通知路径8d3fef0#414/#415src/openclaw、src/notificationsTmux 启动/注入/会话定位回归383d79d、f5d47f4#441/#442、cc64635、f0cc833tmux-session.ts 中的 pane 稳定性探测与精确窗格校验Team 清理、scale-up 布局保持、shutdown/resume 回归b5dc657#430、454e69d#438、c8632fa#433/#437、587ec94、12dea24scaling.ts 的scaleUp/scaleDown测试 scaling.test.ts、shutdown-fallback.test.ts、pane-teardown-residue-e2e.test.tsRalph CLI 任务解析的选项值泄漏576ec9c#424src/cli/ralph.ts 中的VALUE_TAKING_FLAGS new Set([--model, --provider, --config, -c, -i, --images-dir])Skills 规范 OMX 路径归一化e0c5974、6c1c4eb、baeb8e7plugins/oh-my-codex/skills 与 skills 目录镜像Ralph CLI 选项值泄漏#424详解576ec9c fix(ralph): exclude option values from CLI task description修复了 ralph 任务解析中的一个典型 bug带值的选项如--model gpt-5的值部分被错误拼进任务描述。当前 ralph.ts 的实现通过VALUE_TAKING_FLAGS集合识别哪些标志会吞掉下一个 token 作为自己的值从而在组装任务文本时跳过这些值同时--分隔符之后的内容被整体视为任务文本omx ralph -- --task-with-leading-dash避免以连字符开头的任务词被误判为选项。这与文档 docs/contracts/ralph-cancel-contract.md、docs/contracts/ralph-state-contract.md 中定义的 ralph 状态与取消契约一脉相承。Skills 路径归一化e0c5974详解e0c5974 fix(skills): normalize forked OMC references to OMX canonical paths处理了 fork 产物中的命名漂移问题将历史遗留的 OMC 引用归一化为 OMX 规范路径。这与仓库中 skills 与 plugins/oh-my-codex/skills 的镜像同步机制相关sync-plugin-mirror.ts 脚本负责两处目录的一致性维护。visual-verdict 契约还原与回退baeb8e7 / a5f2b77baeb8e7尝试还原 visual-verdict 契约与 ralph visual-loop 指引随后a5f2b77又将其回退。与之配套的是6eed3c6 fix(notify-hook): add structured logging for visual-verdict parse/persist failures (#428)——为 visual-verdict 的解析/持久化失败增加结构化日志提升可观测性。这部分逻辑落在 src/scripts/notify-hook 与 src/hooks 的通知链路中。Reverts两次回退的来龙去脉发版说明明确列出两次回退tmux-session hint 变更的 opt-in 化#432先是尝试把独立 tmux 会话改为 opt-in worker 位置提示随后整体回退最终以f0cc833修复 scoped mode state 缺失时的注入恢复收尾保证功能不因状态缺失而静默失效。visual-verdict 指引还原baeb8e7还原后又被a5f2b77回退随后由路径归一化修复e0c5974承接把问题收敛到命名与路径一致性上。这两次回退体现了 0.7.6 的发布纪律无法证明稳定的变更宁可回退也不带病合入。发版就绪度验证清单可直接复现发版说明给出了 0.7.6 的三项硬性检查与八项冒烟证据。三项硬性检查为npm run build通过npm test通过npm run check:no-unused通过等价于tsc -p tsconfig.no-unused.json2026-03-02 的冒烟验证证据表如下读者可在本仓库直接复现命令退出码证据npm run build0build completednpm test0test pipeline completednpm run check:no-unused0tsc -p tsconfig.no-unused.jsonsucceedednode bin/omx.js --help0CLI usage renderednode bin/omx.js doctor0Results: 9 passed, 0 warnings, 0 failednode bin/omx.js version0oh-my-codex v0.7.6node bin/omx.js status0mode status renderednode bin/omx.js setup --dry-run0dry-run setup completednode bin/omx.js cancel0cancel command completed需要说明的适用前提node bin/omx.js doctor的“9 passed”结果是 0.7.6 发版当日的基线后续版本新增检查项会使数字变化如 doctor.ts 的实现会随能力扩展增加检查项。DEMO.md中的冒烟检查若受环境限制如无 tmux 的 CI 容器则记录说明即可不强求全部通过。提交账本main..dev以下按git log --reverse顺序完整列出 0.7.6 的 27 条提交供对照检查日期哈希描述2026-02-28c235a5afeat(team): add dedicated ralph auto-run cleanup policy (#407) (#412)2026-02-288d3fef0fix(notifications): native OpenClaw gateway support (#414) (#415)2026-03-011653aa7feat(team): add dedicated tmux session mode for worker isolation (#416)2026-03-010c68a02docs: OpenClaw integration guide for notifications (#413)2026-03-01383d79dfix(tmux): source shell profile (.zshrc/.bashrc) for detached session launch2026-03-01d4f6803fix(team): revert dedicated tmux session mode, restore split-pane default2026-03-0156091a4ci: add CI Status gate job for branch protection (#423)2026-03-01576ec9cfix(ralph): exclude option values from CLI task description (#424)2026-03-016eed3c6fix(notify-hook): add structured logging for visual-verdict parse/persist failures (#428)2026-03-01b5dc657fix(team): fix 3 regressions in team/ralph shutdown and resume paths (#430)2026-03-013f6b3fdrefactor(mcp): extract omx_run_team_* to dedicated team-server.ts (#431)2026-03-02c3d1220fix(team): switch dedicated tmux session to opt-in with worker location hint (#432)2026-03-01ee72e1fRevert fix(team): switch dedicated tmux session to opt-in with worker location hint (#432)2026-03-02454e69dfix(team): force cleanup on failed/cancelled runs, await worktree rollback, refresh dead-worker panes (#438)2026-03-02c8632fafix(team): fix leader pane targeting in notify-hook dispatch and runtime fallback (#433, #437) (#439)2026-03-01587ec94fix(team): harden autoscaling pane cleanup and teardown2026-03-0212dea24fix(team): preserve layout during scale-up and add regression test2026-03-02f5d47f4fix(tmux): skip injection when pane returns to shell (#441) (#442)2026-03-027413fe3feat(team): add per-worker role routing and task decomposition2026-03-02cc64635fix(tmux): target correct session when spawning team panes2026-03-02d33ecfcfix(team): remove unused symbols flagged in PR review2026-03-02f0cc833fix(tmux): restore injection when scoped mode state is missing2026-03-02baeb8e7fix(skills): restore visual-verdict contract and ralph visual-loop guidance2026-03-02a5f2b77Revert fix(skills): restore visual-verdict contract and ralph visual-loop guidance2026-03-026c1c4ebdocs(changelog): update unreleased notes for main...dev2026-03-02e0c5974fix(skills): normalize forked OMC references to OMX canonical paths小结0.7.6 的技术取向0.7.6 是一个典型的“可靠性优先”版本没有引入全新的用户级大功能而是把 Team 模式的工程地基打牢——tmux 窗格定位从“能用”走向“可证明”精确窗格校验、稳定性探测、拓扑冻结清理流程从“尽力而为”走向“强制兜底”角色路由让 worker 分工从硬编码走向启发式推断MCP 与 CI 则把团队运行时的复杂度收敛到独立边界并暴露在门禁可见面上。两次主动回退进一步说明对无法验证稳定的变更OmX 选择先回退、再修正而非带病发布。对于需要深入 Team 运行时细节的读者建议从 src/team/tmux-session.ts 与 src/team/role-router.ts 两个文件入手再配合 src/team/tests下的端到端用例理解整体运行模型。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考