同名 fork 项目混淆

你会遇到什么

搜 "oh-my-claudecode" 找到多个同名/近似项目，装错版本。教程来自不同 fork，命令对不上，装完发现不是你要的那个。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

上游存在多个 fork/同名仓库（如 AustinElite 等 fork 系），名字接近，搜索引擎容易混入。认准两个硬指标：原仓库 + npm 包名。

GitHub 上“同名/近似名仓库”是分叉生态的副产品：任何开源项目都可以被 fork，fork 保留原名或近似名；搜索引擎把 fork、衍生项目和原仓库混在结果里，按热度排序，原仓库未必排第一。

但身份不随名字走：判断是不是原仓库，要看两个与名字无关的硬指标——组织/作者（Yeachan-Heo，仓库的归属者）和分发锚点（npm 包名 oh-my-claude-sisyphus，安装时真正寻址的东西）。

npm 包名尤其可靠：npm 上的名字是注册制的、唯一的，作者注册了它，安装命令指向的就是作者的包（除非包名也被人抢注，那属于另一种攻击）。所以验证顺序固定：先对 npm 包名（安装寻址一致）→ 再对原仓库（源码归属一致）→ 最后对版本号（内容一致）。三个都对上，就是原项目。

一步步来

1. 认准原仓库与包名 — 必做

原仓库 Yeachan-Heo/oh-my-claudecode；npm 包名 oh-my-claude-sisyphus（fork 系教程的安装命令不要用）。

2. 版本对齐 v5.0.0 — 必做

npm view oh-my-claude-sisyphus version

与收录版本 5.0.0（2026-08-24 release）对齐。

3. 装完验证 — 必做

omc --version

怎么确认修好了

版本输出正确（实测输出形态）：

omc --version
→ 5.0.0（隔离 HOME 实测，149 包 added，exit 0）

其它环境的表现

症状

搜 "oh-my-claudecode" 找到多个同名/近似项目，装错版本。

原因

上游存在多个 fork/同名仓库（如 AustinElite 等 fork 系），名字接近。

解法

1. 认准原仓库：Yeachan-Heo/oh-my-claudecode；npm 包名 oh-my-claude-sisyphus。
2. 版本对齐 v5.0.0（2026-08-24 release）；装前看包信息（npm view oh-my-claude-sisyphus version）。

本市场实测安装 / 卸载（2026-08-28）

安装（manifest install.cmd，隔离 HOME=/tmp/l34-omc/home）：

[install] 执行: npm i -g oh-my-claude-sisyphus@5.0.0 --no-audit --no-fund --registry=https://registry.npmmirror.com && omc --version
added 149 packages in 1m
5.0.0
[install] exit=0

卸载（manifest uninstall.cmd + verify）：

[uninstall] 执行: npm rm -g oh-my-claude-sisyphus
removed 149 packages in 156ms
[uninstall] 验证: omc removed: OK（fresh shell，verify exit=0）

• 完整日志：实测记录（本地留存）。
• CLI 冒烟：实测记录（本地留存）（omc --version 5.0.0；usage 输出）。
• 连通性：实测记录（本地留存）。
• 未能实测：Claude Code 插件形态（/plugin install + /omc-setup 需登录会话）、MCP bridge 实跑、多 Agent 实排。

冲突标注

• possible-conflict（推断态）：agent-governance-toolkit / ruflo / code-review-graph / cc-switch / claude-mem / skilldock——共享 ~/.claude.json 注册段 / Claude 插件注册面（详见矩阵对子证据）。
• possible-compatible（推断态）：claude-code-router / deepcode / superpowers 等（CLI 面隔离，矩阵对子）。
• 形态提醒：npm CLI 形态写面最小；Claude Code 插件形态写 ~/.claude 注册面，多插件共装时注意。

名称混淆

• 三套名字：npm 包 oh-my-claude-sisyphus / 插件 oh-my-claudecode / 命令 omc（见症状 5）。
• 同名 fork 项目（AustinElite 等）与上游 Yeachan-Heo 区分（见症状 7）。

判据（验证状态）

• 症状清单：
• [x] 命令未找到 → 重跑 omc-setup（CSDN 2026-03；本市场 PATH 实测）
• [x] 钩子未执行 → chmod +x hooks（CSDN 2026-03；Issue #30 Windows hook error）
• [x] 智能体未自动委托 → CLAUDE.md 加载检查（CSDN 2026-03）
• [x] 更新/配置异常 → omc-doctor 诊断（CSDN 2026-04）
• [x] 包名/插件名/命令名不一致（L33 记录 + 本市场实测）
• [x] Claude Code 本体环境类：OOM/Homebrew/ExecutionPolicy（CSDN 弱相关）
• [x] 同名 fork 混淆（L32 国外信号）
• 实测步骤：

本站实测记录

• [x] 卸载验证（manifest uninstall.cmd：npm rm 149 包 → verify 零残留 exit 0）
• [x] 网络/镜像场景（npmmirror 1m 安装；）
• [x] 未能实测项：Claude Code 插件形态（/omc-setup 交互）、MCP bridge 实跑

验收

• [x] 症状 → 原因 → 解法 → 验证证据 四段齐全（7 症状）
• [x] 名称混淆已点名（三套名字不一致；fork 同名）
• [x] check-words HARD 0
• [x] validate 通过
• [x] 未碰 GitHub / 未用任何账号