Claude Marketplace 安装 UI UX Pro Max 提示 “Zip file contains a symbolic link“ 怎么办？

Claude Marketplace 安装 UI UX Pro Max 提示 Zip file contains a symbolic link 怎么办【免费下载链接】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在 Claude Code 中通过 Marketplace 安装 UI UX Pro Max一条为 AI 编码助手提供 UI/UX 设计数据的技能包时如果你遇到报错Zip file contains a symbolic link说明安装流程没有完成.claude/skills/ui-ux-pro-max/下的技能文件不会被写入项目。根据 README.md 的故障排查章节这是 v2.5.1 之前版本的已知问题仓库内部曾经使用符号链接symlink而某些安装工具无法处理它。解决办法是改用 CLI 安装器完成安装下文给出完整操作路径。先确认你遇到的是这个已知问题在开始修复前先核对两个条件确保问题属于文档描述的范围报错信息正是Zip file contains a symbolic link且发生在/plugin install ui-ux-pro-maxui-ux-pro-max-skill这条 Marketplace 安装链路中仓库当前版本为 v2.5.1 之前。CLAUDE.md 中的 Sync Rules 一节说明现在的仓库已经不再包含符号链接所有镜像副本cli/assets/、.claude/skills/ui-ux-pro-max/{data,scripts}都是真实提交的文件由cli/scripts/sync-assets.mjs保持同步并有 CI 校验。也就是说旧版本插件包里的 symlink 才是报错来源而不是你本地环境的问题。如果确认命中直接跳到下面的 CLI 安装路径如果等待新版本Marketplace 安装命令为见 README.md Installation 一节/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-maxui-ux-pro-max-skill改用 CLI 安装器完成安装文档给出的修复方式是使用 CLI 安装器。npm 包名是ui-ux-pro-max-cli安装后提供的命令是uipro。注意 README.md 特别提示旧的uipro-cli发行版本已过时不要用于当前资产。在项目根目录下依次执行# 全局安装 CLI npm install -g ui-ux-pro-max-cli # 进入你的项目根目录替换为实际路径 cd /path/to/your/project # 为 Claude Code 安装技能 uipro init --ai claude如果想让技能对所有项目可用可以使用全局安装文件会写入~/.claude/skills/来源README.md Global Install 一节uipro init --ai claude --global两个可选参数按需使用--force覆盖已存在的文件来源cli/README.md--offline兼容性标志安装随包自带的模板不依赖网络来源cli/README.md。另外GitHub 未认证 API 每小时限 60 次请求/IP如果你的网络环境经常触发限流cli/README.md 建议通过UI_PRO_MAX_GITHUB_TOKEN环境变量传入一个 GitHub Personal Access Token优先级高于--token参数和GITHUB_TOKEN。全局 npm 安装遇到权限错误时如果npm install -g ui-ux-pro-max-cli失败并提示权限错误README.md 给出两条替代路径使用 Node 版本管理器文档推荐跳过全局安装直接用 npx 运行# npx without installing globally npx ui-ux-pro-max-cli init --ai claude验证安装是否成功安装完成后按以下顺序验证检查技能目录。uipro init --ai claude成功后项目根目录下应存在.claude/skills/ui-ux-pro-max/。这个路径可以从 README.md 的卸载与手动移除小节rm -rf .claude/skills/ui-ux-pro-max # Claude Code以及设计系统命令的调用路径得到印证。如果目录不存在说明uipro init没有在该目录执行——该命令写入的是当前工作目录对应的 AI 助手目录。检查 Python 环境。技能的搜索脚本需要 Python 3.x仅标准库脚本本身不安装任何东西、不发起网络请求python3 --version如果缺失由你自行通过官方渠道或系统包管理器Homebrew、apt、winget安装文档明确要求 AI 代理不应替你安装软件它们被要求先征求你的同意。在 Windows 上运行脚本时把python3换成python来源CLAUDE.md Prerequisites 一节。跑一条搜索命令确认脚本可用。README.md 中给出的示例命令python3 .claude/skills/ui-ux-pro-max/scripts/search.py SaaS --domain style --json能返回 JSON 结果说明安装的技能脚本已经正常工作。注意人类可读输出会把超过 300 字符的长字段截断需要完整数据时保留--json参数。后续维护与限制技能文件过旧时先更新 npm 包再重新生成文件。uipro update会执行npm install -g ui-ux-pro-max-clilatest之后可用uipro init --ai platform --force重新生成来源cli/README.md How It Works 一节。README.md 也提示发布新 release 时应先更新 npm 包。查看可用版本uipro versions移除技能uipro uninstall自动检测平台、uipro uninstall --ai claude指定平台、uipro uninstall --global移除全局安装。本问题仅针对 Marketplace 安装链路中的 symlink 报错。若后续版本已修复该问题文档建议的另一个选择是等待下一个修复此问题的版本发布你可以回到 Marketplace 方式重新安装在确认新版本可用之前CLI 安装器是文档推荐的可靠路径。【免费下载链接】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），仅供参考