From 0b4a4f1c961f01d261f283c9af07f8da51313019 Mon Sep 17 00:00:00 2001
From: alex <alex@alterminal.com>
Date: Sat, 5 Sep 2026 09:19:44 +0800
Subject: [PATCH] =?UTF-8?q?docs(cli):=20=E6=96=B0=E5=A2=9E=20CLI=20?=
 =?UTF-8?q?=E5=AE=89=E8=A3=9D=E6=8C=87=E5=8D=97=EF=BC=88issue=20#17?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 docs/cli-install.md：前置需求、建置步驟、執行方式（PATH 連結）、
  token／API 設定、驗證與疑難排解；全部指令均於乾淨 clone 實測。
- 修正 cli/README.md 開發段落的啟動寫法（pnpm 9 下不應加 "--"）並附指南連結。
- 根 README 目錄結構補上 docs/cli-install.md。
---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d0ec0e9..6c37781 100644
--- a/README.md
+++ b/README.md
@@ -61,10 +61,12 @@
 
 ## 開發
 
+> 使用者安裝與設定說明見 [docs/cli-install.md](../docs/cli-install.md)。
+
 ```bash
 pnpm install        # 倉庫根目錄
 pnpm --filter fox-cli build
-pnpm --filter fox-cli start -- <子命令>   # 例如 auth status
+pnpm --filter fox-cli start <子命令>   # 例如 auth status；不要加 "--"（pnpm 9 會把它當參數）
 ```
 
 結構：`src/cli.ts`（進入點與分發）、`src/command.ts`（參數解析與註冊表）、