安装来源混淆：npm 同名包 / 其它 cc-switch 项目

你会遇到什么

按 "cc-switch" 搜索装到了错误的包——npm 上存在同名包，但不是这个项目；或装完根本没有 cc-switch 命令。认准一点：本项目是 Tauri 桌面应用，分发渠道是 GitHub Release（deb/AppImage/rpm/win/mac），没有 npm 包。

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

为什么会这样

本项目 = farion1231/cc-switch（Tauri 桌面应用），分发渠道 = GitHub Release 资产；npm 上同名 cc-switch 是其它项目。搜索"cc-switch"时 npm 结果排前面，容易装错。

“包名相同”不代表“是同一个东西”——分发渠道是身份的一部分：桌面应用（Tauri）的分发渠道是 GitHub Release 资产（deb/AppImage 等），npm 是 JS 包生态，两者机制完全不同。

npm install cc-switch 会装到 npm 上那个同名 JS 包，但它不提供 cc-switch 命令——所以“装完 command not found”是判断装错来源的硬信号。

反过来，装对了也有两个可核对的硬证据：命令面（cc-switch --version 能输出）和包元数据（dpkg-deb -I 里的 Package/Version/Maintainer 字段）。搜索结果的排序（npm 靠前）只是流量入口，不能当身份证据；判断身份要看“安装命令来自哪个生态 + 装完的命令面/元数据是否匹配”。

实测环境：deb 包元数据 Package: cc-switch / Version: 3.20.0 / Maintainer: Jason Young（2026-08-28 闭环日志）。

一步步来

1. 认准来源 — 必做

• 仓库：farion1231/cc-switch；
• 命令/入口：cc-switch 或桌面图标；
• 安装一律走 GitHub Release 资产（或本市场收录的 deb 路径），不要 npm install cc-switch。

2. 装完核对 — 必做

cc-switch --version

报 command not found → 装错来源（npm 同名包没有这个命令），卸载重装 Release 资产。

3. 核对包元数据 — 必做

dpkg-deb -I cc-switch.deb | head -8

Package: cc-switch / Version: 3.20.0 / Maintainer: Jason Young——对得上才是本项目。

怎么确认修好了

cc-switch --version && which cc-switch

命令存在、版本可输出即成功（实测：Release deb 安装后命令正常）。

其它环境的表现

症状

按 "cc-switch" 搜索装到错误的包（npm 上存在同名包，但不是本项目），或装完没有 cc-switch 命令。

原因

本项目 = farion1231/cc-switch（Tauri 桌面应用），分发渠道 = GitHub Release（deb/AppImage/rpm/win/mac），没有 npm 包；npm 同名包是其它项目。

解法

1. 认准仓库：farion1231/cc-switch；命令/入口 = cc-switch 或桌面图标。
2. 安装一律走 GitHub Release 资产（或本市场收录的 deb 路径），不要 npm install cc-switch。