From d654d17fb58fd198e3f68a4a6cce7c68c02221c5 Mon Sep 17 00:00:00 2001
From: Timmy <loyangchun@gmail.com>
Date: Sat, 27 Jun 2026 23:32:47 +0800
Subject: [PATCH] Document venv-based install in README (PEP 668)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 0021dcd..b831c23 100644
--- a/README.md
+++ b/README.md
@@ -4,10 +4,16 @@ Last-Z Gift Center 的命令列工具，支援查詢帳號資訊、兌換禮品
 
 ## 安裝
 
+建議使用虛擬環境（Homebrew / PEP 668 的 Python 不允許全域安裝套件）：
+
 ```bash
+python3 -m venv .venv
+source .venv/bin/activate
 pip install -r requirements.txt
 ```
 
+之後每次使用先 `source .venv/bin/activate`，或直接以 `.venv/bin/python giftcenter.py ...` 執行。
+
 ## 設定
 
 在專案根目錄建立 `.env` 檔案，填入你的 UID：