名称混淆：juspay/code-review-graph-rescript 同名变体

你会遇到什么

你搜 "code-review-graph"，结果里混着一个 juspay/code-review-graph-rescript，教程里的安装命令、仓库地址全对不上，装完发现根本不是你要的东西。同名项目把你带沟里了。

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

为什么会这样

github 上存在一个同名前缀的 rescript 生态项目（juspay 组织），和我们要装的 code-review-graph 没有任何关系。两个项目都叫类似的名字，搜索引擎很容易把国外信号（L32 Google 窗口期捕获）混进来。

项目身份（identity）有三个独立的锚点：仓库地址（源码归属）、分发包名（安装寻址）、命令面（运行时行为）。搜索引擎和教程混的是“名字相似”，但真正决定“你装到的是什么”的是后两个锚点：pip 按包名寻址，命令按 PATH 里的可执行文件寻址。

rescript 变体用 rescript 生态的安装命令，装出来的命令和 PyPI 包完全不同——所以“认 PyPI 包名 + 验 --version 输出”能在不依赖搜索引擎判断的情况下给出确定性结论。

这也是为什么排查顺序固定：先 pip install 指定精确包名（锁定分发包锚点）→ 再 --version 验命令面（锁定行为锚点）→ 最后才看文档仓库（确认源码归属）。搜索引擎只是入口，不是证据。

认准两个硬证据：PyPI 包名和 --version 输出。

一步步来

1. 只认 PyPI 包名 — 必做

pip install code-review-graph==2.3.8

包名 code-review-graph（PyPI），不要用 rescript 生态教程里的安装命令。

2. 验命令面 — 必做

code-review-graph --version

预期输出 code-review-graph 2.3.8（实测）。

3. 查文档认准仓库 — 必做

仓库地址 tirth8205/code-review-graph（MIT 协议）。教程里出现 juspay 或 rescript 字样直接跳过。

怎么确认修好了

版本命令输出符合预期（实测输出）：

code-review-graph --version
→ code-review-graph 2.3.8

pip show code-review-graph 能看到 Home-page 指向 tirth8205 仓库。

其它环境的表现

症状

搜索资料时把 code-review-graph 与 juspay/code-review-graph-rescript 混为一谈，装错仓库/命令对不上。

原因

juspay 的 rescript 生态同名项目（国外信号，L32 Google 窗口期捕获）；正确仓库 = tirth8205/code-review-graph（Python 包 code-review-graph，manifest 签名），两者无关联。

解法

1. 按包名认项目：pip 装的是 code-review-graph==2.3.8（PyPI），命令 code-review-graph --version 输出 code-review-graph 2.3.8。
2. 查文档认准仓库：tirth8205/code-review-graph（MIT），勿用 rescript 生态教程的安装命令。