下载与安装
从官网下载页选择安装包。该页面根据实际发布文件提供下载入口；不要通过修改文件名猜测某个平台的下载地址。
选择系统与芯片
| 系统 | 芯片 | 安装包 |
|---|---|---|
| macOS | Apple 芯片或 Intel | 对应架构的 DMG |
| Windows | x64 | EXE 安装程序 |
| Linux | x64 或 ARM64 | DEB 或 AppImage |
macOS 可在系统的“关于本机”中查看芯片。Windows 请检查系统信息中的处理器架构。不要把 Windows ARM64 设备等同于原生 x64 支持；以下载页实际提供的平台为准。
在 macOS 安装
- 下载与你的芯片一致的 DMG。
- 打开 DMG。
- 将 Skills Hub 拖入 应用程序。
- 从应用程序目录打开 Skills Hub。
如果系统阻止打开，先确认安装包来自官方发布。再按 macOS 系统设置 → 隐私与安全性 中的提示允许打开。不要关闭整个系统的安全检查。架构选错时，返回下载页换用正确安装包。
提示“已损坏”或“无法验证开发者”
首次打开时，macOS 的 Gatekeeper 会检查下载的应用。未签名或未公证的版本可能被阻止打开，提示文字会随 macOS 版本变化。“已损坏”也可能表示文件确实损坏或被修改；先从官网下载页或官方 GitHub 发布页重新下载，确认来源与文件完整后再处理。原因与系统设置操作见 Apple 官方说明。
- 将 Skills Hub 拖入 应用程序，然后尝试打开一次。
- 前往 系统设置 → 隐私与安全性，找到 Skills Hub 的提示，点击 仍要打开 并确认。
- 若仍被下载隔离标记阻止，确认应用来自官方发布后，打开 终端，执行：
xattr -dr com.apple.quarantine "/Applications/Skills Hub.app"
执行后重新打开 Skills Hub。命令只移除这个应用及内部文件的下载隔离标记；如果安装在其他目录，请将路径替换为实际位置。它不会完成 Apple 签名或公证，也不会修复真正损坏的文件。若仍无法打开，请通过官方 Issues反馈完整提示、macOS 版本与下载的安装包名称。
在 Windows 安装
- 下载 Windows x64 安装程序。
- 运行安装程序并完成安装向导。
- 从开始菜单打开 Skills Hub。
若系统显示来源警告，先核对下载来源，再决定是否继续。Windows 当前使用全局 Skill 分发；项目级分发暂不支持。
在 Linux 安装
Linux 桌面端和 CLI 要求 glibc 2.39 或以上，例如 Ubuntu 24.04 或兼容的 GNU/glibc 发行版。Ubuntu 22.04、Debian 12 和 Alpine/musl 不满足这批构建的要求。AppImage 同样有此 glibc 要求。
DEB 用户可以用系统的软件安装器安装下载的包。AppImage 用户先在文件属性中允许作为程序执行，再打开文件。选择与你的 CPU 一致的 x64 或 ARM64 包。缺少系统依赖时，按照包管理器给出的依赖提示处理。
首次启动与升级
打开后，先查看工具检测结果，再安装或导入 Skills。现有 Skill 的发现提示不会自动接管你的文件；查看候选条目后再选择导入。
应用有新版本时，可从标题栏更新入口或 设置 查看更新说明并安装。安装完成后可以立即重启，也可以稍后重启。应用升级、Skill 内容更新和 AI 管理组件更新是三个不同操作，详见更新 Skills。
使用官网合集安装需要 v1.0.0 或更新版本。请从官网下载页安装或升级；旧版本不会因为打开网页而获得合集安装能力。