> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 1. 下載 Toolkit

> 在 Mac 上安裝 GNU sed 並複製 Ayakaleaf Toolkit。

**1. 檢查 Git 與 Homebrew**

```bash theme={null}
git --version
brew --version
```

若執行 Git 時 macOS 要求您安裝 Command Line Tools，請先安裝它們。若尚未安裝 Homebrew，請依照[官方說明](https://brew.sh/)安裝。

**2. 將 GNU sed 加入 PATH**

Toolkit 指令碼會使用 macOS 內建的 BSD sed 會拒絕的 GNU sed 選項。請安裝 [GNU sed](https://formulae.brew.sh/formula/gnu-sed)，並在此終端機中將它放在 `PATH` 的最前面：

```bash theme={null}
brew install gnu-sed
export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
sed --version
```

最後一個指令應該會印出 **GNU sed**。

像 `alias sed=gsed` 這樣的別名是不夠的：Toolkit 執行的是 Bash 指令碼，它們看不到您互動式 shell 中的別名。您不需要取代 `/usr/bin/sed`。

在每個用來執行 Toolkit 的新終端機中，請再次執行 `export PATH=...` 這一行，或將它加入您的 shell 啟動檔案中，並放在 Homebrew 本身的初始化之後。

**3. 複製 Ayakaleaf Toolkit 儲存庫**

請選擇一個會持續保留的目錄。對於線上資料庫與專案資料，請避免使用 `/tmp`、卸除式磁碟機，以及 iCloud Drive 等雲端同步資料夾。本指南使用 `~/ayakaleaf-toolkit`：

```bash theme={null}
git clone https://github.com/ayaka-notes/toolkit.git "$HOME/ayakaleaf-toolkit"
cd "$HOME/ayakaleaf-toolkit"
```

> [!WARNING]
>
> 若該目錄中已有安裝，請直接使用它，或為新執行個體選擇另一個目錄。請勿在既有部署上初始化新的設定。

### 下一步

請繼續進行 [2. 熟悉 Toolkit](https://ayakaleaf-pro.mintlify.site/zh-TW/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.