======================================
   AI 工具箱 — 安装说明
======================================

在运行 AI 工具箱之前，你的 Mac 需要先安装「Xcode Command Line Tools」。
这是苹果官方的基础开发工具包，所有 AI 工具的运行都依赖它。

请按照以下步骤操作：


---------- 第 1 步：安装 Xcode Command Line Tools ----------

打开「终端」应用：
  1. 按 Command + 空格，打开搜索
  2. 输入「终端」，按回车打开

在终端中输入以下命令（直接复制粘贴），然后按回车：

  xcode-select --install

输入后，系统会弹出一个对话框，提示你安装开发者工具。
点击「安装」按钮，等待几分钟（取决于网络速度）。

安装完成后，对话框会提示「软件已安装」。
关闭终端窗口，重新打开一个新的终端。


---------- 第 2 步：验证是否安装成功 ----------

在新打开的终端中，依次输入以下命令，每输入一行按一次回车：

  git --version
  python3 --version

如果两行命令都显示了版本号（例如 git version 2.x.x，Python 3.x.x），
说明 Xcode Command Line Tools 安装成功，可以继续下一步。

如果提示「command not found」，说明安装未完成或失败，
请回到第 1 步重新执行。


---------- 第 3 步：运行 AI 工具箱 ----------

确认 Xcode CLI 安装成功后：

  1. 双击本文件夹中的「运行工具箱.command」文件
  2. 系统会自动打开终端并启动 AI 工具箱
  3. 浏览器会自动打开工具箱界面（http://localhost:17730）

之后你就可以在工具箱里一键安装其他 AI 工具了。


---------- 工具安装注意事项 ----------

以下工具在工具箱中点击安装时，需要额外注意：

  Homebrew（包管理器）
    首次安装需要你在终端中手动输入 Mac 密码授权 sudo。
    建议先在终端运行一次：sudo -v（输入密码缓存授权），
    然后再在工具箱中点击安装 Homebrew。

  Node.js / VS Code
    这两个工具会弹出 macOS 系统安装器窗口，
    请在弹出的安装窗口中点击「继续」→「安装」→ 输入密码。

  Docker
    工具箱会自动安装 Docker.app 到「应用程序」，
    但首次需要手动打开一次 Docker.app，在菜单栏确认它运行后，
    再回到工具箱安装 Dify 等依赖 Docker 的工具。

  Hermes
    需要 Python 3.10 或更高版本。如果你的 Mac 系统自带的
    Python 版本较低（例如 3.9.x），请先通过 Homebrew 安装：
    brew install python3


---------- 常见问题 ----------

Q：我已经安装过 Xcode 了，还需要装这个吗？
A：如果你是从 App Store 安装的完整版 Xcode，那已经包含了命令行工具，
   不需要额外安装。直接跳到第 3 步即可。

Q：系统提示「无法安装，因为软件未从 App Store 获取」？
A：这是 macOS 的安全设置。前往「系统设置 → 隐私与安全性」，
   在底部点击「仍要打开」即可。

Q：安装很慢，一直卡在「正在安装」？
A：Xcode CLI 大约 200MB，取决于网速，通常需要 1-5 分钟。
   请耐心等待，不要关闭安装窗口。

Q：工具箱里点了安装但没有反应？
A：部分工具（如 Homebrew）需要你已在终端中缓存了 sudo 授权。
   请先在终端运行一次「sudo -v」并输入密码，再重试。


======================================
如有问题，请联系技术支持。
======================================
