这次踩的坑，表面看是 Windows 找不到命令，实际根因是：DeepSeek-TUI 已经改名为 CodeWhale 了。

我一开始按老教程安装：

npm install -g deepseek-tui --registry=https://registry.npmmirror.com

终端提示安装成功：

changed 1 package

看起来没问题。

但执行：

deepseek

却提示：

deepseek 不是内部或外部命令，也不是可运行的程序

于是第一反应就是：环境变量没配好。

一、第一层误判：以为是 PATH 没加

Windows 下 npm 全局命令一般会安装到这个目录：

C:\Users\Administrator\AppData\Roaming\npm

所以我先把这个路径加进系统环境变量。

PowerShell 临时加 PATH 的写法是：

$env:Path += ";C:\Users\Administrator\AppData\Roaming\npm"

注意，这里不能写成：

set PATH=%PATH%;%APPDATA%\npm

这个是 CMD 写法，不是 PowerShell 写法。

如果你在 PowerShell 里执行 CMD 的写法，就会报类似这样的错误：

无法加载模块 %APPDATA%\npm

所以这里第一个坑是：

PowerShell 用 $env:变量名，CMD 才用 %变量名%。

二、第二层排查：PATH 加好了，还是找不到

后来我专门写了一个脚本，把 npm 全局路径永久加入系统 Path。

脚本执行后显示：

已成功加入系统环境变量 Path:
C:\Users\Administrator\AppData\Roaming\npm

说明环境变量已经加成功了。

但是继续检测：

Get-Command deepseek
Get-Command deepseek-tui
Get-Command codewhale

结果还是：

未找到命令：deepseek
未找到命令：deepseek-tui
未找到命令：codewhale

这时候就可以判断了：

这已经不是 PATH 的问题了。

如果 PATH 有问题，脚本不会显示加入成功。

如果 PATH 已经成功，但命令还是找不到，那就说明 npm 安装的包本身没有生成对应的命令入口。

也就是说：

npm install -g deepseek-tui

虽然执行成功，但它未必还会生成 deepseek 这个命令。

三、真正原因：DeepSeek-TUI 改名成 CodeWhale

真正原因是：DeepSeek-TUI 项目已经改名为 CodeWhale。

以前老教程里写的是：

npm install -g deepseek-tui
deepseek

现在应该改成：

npm install -g codewhale
codewhale

旧的 deepseek-tui 包已经不适合作为新安装方式了。

所以这次的坑，不是 Node 没装好，不是 npm 镜像问题，也不是 Windows 环境变量一定没配好，而是教程过期了。

一句话：

老名字叫 deepseek-tui，新名字叫 codewhale。以后别再用 deepseek 启动，直接用 codewhale。

四、正确解决方式

直接执行：

npm uninstall -g deepseek-tui
npm install -g codewhale --registry=https://registry.npmmirror.com

安装完成后检查：

Get-Command codewhale
Get-Command codewhale-tui

再查看版本：

codewhale --version

最后启动：

codewhale

如果你想看 npm 到底把命令装到哪里，可以执行：

npm config get prefix

正常情况下会返回类似：

C:\Users\Administrator\AppData\Roaming\npm

然后看这个目录里有没有生成命令：

dir "C:\Users\Administrator\AppData\Roaming\npm" | findstr /i "codewhale deepseek"

如果这里能看到 codewhale.cmd，说明命令入口已经生成。

五、Windows 桌面执行脚本的小坑

如果脚本放在桌面，推荐这样进入桌面目录：

cd ([Environment]::GetFolderPath("Desktop"))

这个比手写路径更稳。

因为有些电脑的桌面可能不是：

C:\Users\Administrator\Desktop

而是 OneDrive 或其他目录。

进入桌面后执行：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\fix-npm-path.ps1

这里的：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

只是让当前 PowerShell 窗口临时允许执行脚本，不是永久关闭安全策略。

六、最终判断逻辑

遇到这种“安装成功，但命令找不到”的问题，不要一上来就反复重装。

按这个顺序排查：

1. 先看命令是否存在

Get-Command deepseek
Get-Command deepseek-tui
Get-Command codewhale

2. 再看 npm 全局目录

npm config get prefix

3. 再看目录里有没有命令文件

dir "C:\Users\Administrator\AppData\Roaming\npm" | findstr /i "codewhale deepseek"

4. 如果 PATH 没问题，但命令不存在

那就不是环境变量问题，而是包没有生成这个命令。

这次就是这个情况。

七、最终命令合集

最推荐直接用这一套：

npm uninstall -g deepseek-tui
npm install -g codewhale --registry=https://registry.npmmirror.com
Get-Command codewhale
codewhale --version
codewhale

如果仍然找不到，再检查：

npm config get prefix
dir "C:\Users\Administrator\AppData\Roaming\npm" | findstr /i "codewhale deepseek"

八、这次踩坑的核心结论

这次问题不是：

npm 没安装成功

也不完全是：

Windows PATH 没配好

而是：

DeepSeek-TUI 改名为 CodeWhale，旧命令 deepseek 已经过时

所以以后安装不要再按老教程写：

npm install -g deepseek-tui
deepseek

而是直接写：

npm install -g codewhale
codewhale

技术工具更新太快，很多时候最坑人的不是报错本身，而是教程已经过期了。

这次就是典型案例：
命令没错，环境也快配好了，结果项目名字变了。