diff --git a/README.md b/README.md
index 9b91b0e..5c90080 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,20 @@
- 📦 僅依賴 `postal-mime`,無其他依賴
- 🚫 附件只保留 metadata,不存 base64,避免撞 KV 25MB 限制
+## 工作原理
+
+```
+外部郵件 → 你的域名 MX(Cloudflare Email Routing)
+ ↓ catch-all 轉發
+ Cloudflare Worker(收信 + HTTP API)
+ ↓ 存儲
+ Cloudflare KV(最近 50 封)
+ ↓ 讀取
+ curl /latest → 自動化腳本
+```
+
+郵件到達後由 `postal-mime` 解析為結構化 JSON,通過帶鑑權的 HTTP API 按需讀取,無需輪詢、無需訂閱。
+
## 前置條件
- 域名已托管在 Cloudflare
@@ -40,7 +54,7 @@ Cloudflare 控制台 → Workers & Pages → `ni-mail` → Settings → Bindings
**2. 設定 AUTH_KEY**
Settings → Variables and Secrets → 新增:
-- 類型:**Secret**
+- 類型:**Secret(密鑰)**,不要選 Text(明文可見)
- 變數名稱:`AUTH_KEY`
- 值:自訂一個密碼
@@ -109,7 +123,7 @@ custom_domain = true
**範例**
```bash
-curl https://ni-mail.你的帳號.workers.dev/latest \
+curl https://your-worker.workers.dev/latest \
-H "X-Auth-Key: 你的密碼"
```
@@ -140,10 +154,6 @@ curl https://ni-mail.你的帳號.workers.dev/latest \
{ "error": "unauthorized" }
```
-## License
-
-Apache License 2.0
-
## 常見問題
### error code: 1101
@@ -164,3 +174,17 @@ Settings → Variables and Secrets 新增 `AUTH_KEY` 時,類型請選 **Secret
- **Secret**:值加密儲存,部署後不可見,適合密碼類資訊
- **Text**:明文儲存,任何有控制台權限的人都能看到
+
+## Star History
+
+[](https://star-history.com/#mskatoni/ni-mail&Date)
+
+## 社區
+
+
+
+
+
+## License
+
+Apache License 2.0