uipro uninstall 提示 "No installed AI skill directories detected" 怎么排查?
【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill
使用ui-ux-pro-max-skill的 CLI(npm 包ui-ux-pro-max-cli,安装后提供uipro命令)移除已安装的 skill 时,uipro uninstall可能不会继续列出可移除的平台,而是直接输出一条警告并结束:
No installed AI skill directories detected.这条提示的含义是:自动检测没有在当前命令运行的位置找到任何已安装的 AI 平台 skill 目录。根据 README 故障排查章节的说明,最常见的原因是skill 安装在与当前运行命令不同的目录中——比如当初是在项目 A 里执行的uipro init,现在却在项目 B(或其他目录)里运行uipro uninstall。本文按检测机制说明如何定位安装位置,并给出三条文档提供的移除路径。
先看这条警告是怎么产生的
uipro uninstall在不带--ai参数时会先做自动检测,检测结果为空才输出这条警告,然后直接返回,不删除任何文件(见 uninstall 命令实现):
const { detected: initialDetected } = detectAIType(baseDir); // Auto-detect or prompt for AI type if (!aiType) { const detected = initialDetected; if (detected.length === 0) { logger.warn('No installed AI skill directories detected.'); return; } // ... }检测的基准目录由安装方式决定(uninstall.ts):
- 不带
--global时,baseDir是当前工作目录(process.cwd()); - 带
--global时,baseDir是用户主目录(homedir())。
而检测本身(detect.ts)是检查基准目录下是否存在各平台的标记目录,例如:
| 标记目录 | 对应平台(部分示例) |
|---|---|
.claude/、.claude-plugin/ | Claude Code |
.cursor/ | Cursor |
.windsurf/ | Windsurf |
.agents/ | Antigravity / Codex / Universal |
.github/ | GitHub Copilot |
.kiro/ | Kiro |
.roo/、.qoder/、.gemini/、.trae/、.opencode/、.continue/、.codebuddy/、.factory/、.kilocode/、.warp/、.augment/、.codewhale/ | 各对应 CLI 平台 |
也就是说,这条警告等价于:在基准目录里,连一个上述平台目录都不存在。排查时先回答两个问题:命令是在哪个目录运行的?当初uipro init又是在哪个目录运行的?
排查步骤
步骤一:确认 skill 实际安装在哪里
回忆或检查当初执行uipro init --ai <平台>时所在的目录。如果是项目级安装,skill 文件应位于该项目的.claude/skills/、.cursor/skills/等目录下;如果是全局安装(uipro init --ai claude --global这类形式),则安装在家目录,例如~/.claude/skills/、~/.cursor/skills/(见 README 全局安装章节)。
可以先用ls之类命令确认目标项目根目录下是否存在相应平台目录(如.claude、.cursor),存在说明检测基准目录选错了,不存在说明该位置确实没有安装。
步骤二:选一条移除路径
README 故障排查章节 针对这条警告给出了三个方案,按你的实际安装方式选择其一。
方案 A —— 回到最初安装的项目根目录再运行(项目级安装的默认路径):
# Option A — run from the project root where you originally installed it cd /path/to/your/project uipro uninstall其中/path/to/your/project需要替换为你当初执行uipro init时所在的项目根目录。检测到安装后,命令会列出检测到的平台并要求你选择要卸载哪一个,确认后会实际执行删除。
如果你明确知道安装的平台,也可以显式指定--ai,例如uipro uninstall --ai claude。指定后不再依赖自动检测结果(见 README 命令列表 中uipro uninstall --ai claude # Remove specific platform)。
方案 B —— 当初是全局安装,用--global移除:
# Option B — remove the global install uipro uninstall --global该命令的检测与删除基准目录是主目录,对应uipro init --ai <平台> --global的安装位置。
方案 C —— 手动删除(注意:以下命令会直接递归删除目录,执行前请逐条确认路径,路径需在你当初安装的项目根目录下执行):
# Option C — remove manually rm -rf .claude/skills/ui-ux-pro-max # Claude Code rm -rf .cursor/skills/ui-ux-pro-max # Cursor rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex按你实际使用的平台保留对应行。这些rm -rf是不可逆的文件删除操作,如果不确定目录内容,先用ls查看该目录再删除。
步骤三:验证移除结果
成功移除时,uipro uninstall会输出删除成功提示并列出被移除的路径(见 uninstall.ts 成功分支):
Skill files removed! Removed: - .claude/skills/ui-ux-pro-max ... UI/UX Pro Max uninstalled successfully!若选择方案 C 手动删除,则确认对应skills/ui-ux-pro-max目录已不存在即可。
如果命令提示检测到了安装、但最后显示No skill files found to remove(uninstall.ts),说明平台标记目录还在,但其中没有找到 skill 文件本身——同样可以回到方案 C 按平台路径手动清理残留。
相邻但不同的现象
排查时注意区分错误信息,避免误判:
- 提示是
No installed AI skill directories detected.—— 即本文场景,属于目录基准问题,按上面三个方案处理; - 提示是
unknown command 'uninstall'或unknown command 'update'—— 这是 README 中另一个独立问题:安装的ui-ux-pro-max-cli版本过旧,处理方式是先更新 CLI 再重试:
npm install -g ui-ux-pro-max-cli@latest uipro uninstall注意 npm 包名是ui-ux-pro-max-cli;README 同时说明旧的uipro-cli发布版本已过时,当前资产不应使用它。
限制说明
- 自动检测只认基准目录下各平台的标记目录(
.claude/、.cursor/等),不检查 skill 文件是否真的完整;检测为空就只输出警告并退出,不会报错、不会删除任何东西,因此该提示本身不需要额外"修复",关键是换到正确的目录或用--global重新运行。 - 手动删除方案 C 仅覆盖 README 列出的四个平台路径(Claude Code、Cursor、Windsurf、Antigravity / Codex);其他平台的 skill 目录布局参见 detect.ts 中各平台对应的标记目录与 uninstall.ts 中的平台路径逻辑,删除前确认目录存在。
【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考