docs: restructure README with 4-step installation guide

Step 1: VS Code + GitHub Copilot setup
- Download VS Code
- Install GitHub Copilot extension
- Pricing comparison (Free/Pro/Pro+ at $39)
- Author recommendation for Claude Opus 4.5 + GPT-5.2 Codex

Step 2: Install VSMONSTER Extension (VSIX)

Step 3: Install Gateway
- git clone, pnpm install
- Copy .env.example to .env

Step 4: Configure social platform (LINE/Telegram/Discord)
- Security warnings for token handling
- Direct .env file editing
- Links to setup guides

Also added:
- .env.example with detailed comments
- Security warnings in Chinese
- Updated version to 0.2.0

Author: akaiHuang

.env.example

@@ -0,0 +1,65 @@
+# ╔══════════════════════════════════════════════════════════════════════════════╗
+# ║                                                                              ║
+# ║   🔐 VSMONSTER 環境變數設定                                                   ║
+# ║                                                                              ║
+# ║   ⚠️  警告：此檔案包含敏感資訊，請勿外洩！                                      ║
+# ║   ⚠️  WARNING: This file contains sensitive data. DO NOT share or commit!     ║
+# ║                                                                              ║
+# ║   使用方式：                                                                  ║
+# ║   1. 複製此檔案為 .env                                                        ║
+# ║   2. 填入你的 Token（從各平台開發者後台取得）                                   ║
+# ║   3. 確保 .env 已加入 .gitignore（預設已加入）                                  ║
+# ║                                                                              ║
+# ╚══════════════════════════════════════════════════════════════════════════════╝
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 🌐 Gateway 設定
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+VSMONSTER_PORT=3000
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 💚 LINE 設定（選擇使用）
+# 
+# 取得方式：https://developers.line.biz/console/
+# 教學文件：docs/setup-line.md
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+LINE_CHANNEL_ACCESS_TOKEN=
+LINE_CHANNEL_SECRET=
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 🔵 Telegram 設定（選擇使用）
+# 
+# 取得方式：與 @BotFather 對話，輸入 /newbot
+# 教學文件：docs/setup-telegram.md
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+TELEGRAM_BOT_TOKEN=
+TELEGRAM_WEBHOOK_URL=
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 🟣 Discord 設定（選擇使用）
+# 
+# 取得方式：https://discord.com/developers/applications
+# 教學文件：docs/setup-discord.md
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+DISCORD_BOT_TOKEN=
+DISCORD_APPLICATION_ID=
+DISCORD_PUBLIC_KEY=
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 🚇 Tunnel 設定（可選）
+# 
+# ngrok: https://dashboard.ngrok.com/get-started/your-authtoken
+# Cloudflare Tunnel: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+NGROK_AUTHTOKEN=
+NGROK_ENABLED=false
+NGROK_REGION=ap
+
+# Cloudflare Tunnel（進階用戶）
+CLOUDFLARE_TUNNEL_TOKEN=
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 📊 Mission Control 設定（可選）
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+MISSION_CONTROL_PORT=3001
+MONGODB_URI=mongodb://localhost:27017/vsmonster

README.md

@@ -2,7 +2,7 @@
 
 > 把 LINE / Telegram / Discord 的訊息帶進 VS Code Copilot 的本地橋接平台
 
-**Version**: 0.0.1 (Preview)
+**Version**: 0.2.0 | [CHANGELOG](CHANGELOG.md)
 
 VSMONSTER 讓你在社群軟體中下指令、追蹤任務進度，所有執行都在你的 VS Code 本機環境完成。
 專案以 🦞 Moltbot 作為社群連接層，VSMONSTER 專注於 Copilot 與任務流程。
@@ -18,104 +18,167 @@ VSMONSTER 讓你在社群軟體中下指令、追蹤任務進度，所有執行
 - **MCP 擴充**：可選的 MCP 服務整合（Email / Browser / File 等）
 - **隧道支援**：可用 ngrok 產生公開預覽連結
 
-## 📣 支援平台
+---
 
-| 平台 | 說明 | 設定指南 |
-|------|------|----------|
-| LINE | 適合台灣/日本用戶 | `docs/setup-line.md` |
-| Telegram | 設定最簡單 | `docs/setup-telegram.md` |
-| Discord | 團隊協作首選 | `docs/setup-discord.md` |
+## 🚀 快速開始
 
-## 🧠 工作原理
+### Step 1️⃣ 安裝 VS Code 與設定 GitHub Copilot
 
-```
-User → 社群平台 → Moltbot → VSMONSTER Gateway → VS Code Extension → Copilot Chat
-   ↘ 任務更新 / 進度回報 / 預覽連結 ←───────────────────────────────────────────↗
-```
+#### 下載 VS Code
 
-VSMONSTER 將社群訊息轉成任務，交給 VS Code Copilot 執行，並回傳進度與結果到原平台。
+前往 [code.visualstudio.com](https://code.visualstudio.com/) 下載並安裝。
+
+#### 設定 GitHub Copilot
+
+在 VS Code 中安裝 **GitHub Copilot** 擴充功能：
+1. 開啟 Extensions（`Cmd+Shift+X` / `Ctrl+Shift+X`）
+2. 搜尋 "GitHub Copilot"
+3. 點擊 Install
+
+#### 💰 免費 vs 付費方案
+
+| 方案 | 價格 | 模型 | 適合對象 |
+|------|------|------|----------|
+| **Free** | $0 | GPT-4o mini, Claude 3.5 Sonnet | 學生、輕度使用者 |
+| **Pro** | $10/月 | GPT-4o, Claude 3.5 Sonnet | 一般開發者 |
+| **Pro+** | $39/月 | **Claude Opus 4.5**, **GPT-5.2 Codex** | 專業開發者 ⭐ |
+| **Business** | $19/用戶/月 | 同 Pro，含管理功能 | 團隊 |
+
+> 💡 **作者推薦**：我個人使用 **$39 Pro+** 方案，因為 **Claude Opus 4.5** 和 **GPT-5.2 Codex** 是目前最能勝任複雜編程任務的模型組合。在處理大型專案重構、跨文件修改、架構設計時，這兩個模型的表現遠超其他選項。
 
 ---
 
-## 🚀 快速開始（本地開發）
+### Step 2️⃣ 安裝 VSMONSTER VS Code 擴充功能
+
+目前擴展尚未發布到 Marketplace，請手動安裝：
+
+```bash
+# 先完成 Step 3 的安裝，再執行此指令
+pnpm extension:build
+```
+
+在 VS Code 中：
+1. `Cmd+Shift+P` / `Ctrl+Shift+P`
+2. 選擇 **Install from VSIX**
+3. 選取 `packages/vscode-extension/vsmonster-*.vsix`
+
+---
 
-### 1) 複製專案與安裝依賴
+### Step 3️⃣ 安裝 VSMONSTER Gateway
 
 ```bash
-git clone https://github.com/your-username/vsmonster.git
+# 1. 複製專案
+git clone https://github.com/akaiHuang/vsmonster.git
 cd vsmonster
+
+# 2. 安裝依賴
 pnpm install
+
+# 3. 複製環境變數範本
+cp .env.example .env
+
+# 4. 啟動 Gateway
+pnpm dev
 ```
 
-### 2) 設定社群平台
+啟動後可驗證狀態：
+```
+http://localhost:3000/health
+```
 
-- **推薦方式**：使用 Moltbot 設定向導
-  ```bash
-  moltbot onboard
-  ```
+---
 
-- **或手動建立設定檔**：放在 `configs/config.json`
+### Step 4️⃣ 設定社群平台（擇一）
 
-### 3) 啟動 Gateway
+> ⚠️ **安全警告**：以下取得的 Token 是高度敏感資料，請：
+> - ❌ **絕對不要**分享給任何人
+> - ❌ **絕對不要**上傳到 GitHub
+> - ❌ **絕對不要**截圖傳到群組
+> - ✅ 只存放在本機的 `.env` 檔案中
+
+#### 選擇你的平台：
+
+| 平台 | 難易度 | 適合對象 | 設定教學 |
+|------|--------|----------|----------|
+| 💚 **LINE** | ⭐⭐ | 台灣/日本用戶 | [📖 docs/setup-line.md](docs/setup-line.md) |
+| 🔵 **Telegram** | ⭐ | 最簡單，推薦新手 | [📖 docs/setup-telegram.md](docs/setup-telegram.md) |
+| 🟣 **Discord** | ⭐⭐⭐ | 團隊協作 | [📖 docs/setup-discord.md](docs/setup-discord.md) |
+
+#### 設定方式
+
+1. 依照上方教學取得你的平台 Token
+2. 編輯 `.env` 檔案，填入對應的 Token：
 
 ```bash
-pnpm dev
+# 編輯環境變數
+nano .env   # 或用你喜歡的編輯器
 ```
 
-啟動後可用以下 API 驗證狀態：
+```env
+# 💚 LINE（擇一填寫）
+LINE_CHANNEL_ACCESS_TOKEN=你的_LINE_Token
+LINE_CHANNEL_SECRET=你的_LINE_Secret
 
+# 🔵 Telegram（擇一填寫）
+TELEGRAM_BOT_TOKEN=你的_Telegram_Token
+
+# 🟣 Discord（擇一填寫）
+DISCORD_BOT_TOKEN=你的_Discord_Token
+DISCORD_APPLICATION_ID=你的_Application_ID
 ```
-http://localhost:3000/health
+
+3. 重新啟動 Gateway：
+```bash
+pnpm dev
 ```
 
-### 4) 安裝 VS Code Extension
+---
 
-目前擴展尚未發布到 Marketplace，請手動安裝：
+## 📣 支援平台
+
+| 平台 | 說明 | 設定指南 |
+|------|------|----------|
+| 💚 LINE | 適合台灣/日本用戶 | [docs/setup-line.md](docs/setup-line.md) |
+| 🔵 Telegram | 設定最簡單 | [docs/setup-telegram.md](docs/setup-telegram.md) |
+| 🟣 Discord | 團隊協作首選 | [docs/setup-discord.md](docs/setup-discord.md) |
+
+---
+
+## 🧠 工作原理
 
-```bash
-pnpm extension:build
+```
+User → 社群平台 → Moltbot → VSMONSTER Gateway → VS Code Extension → Copilot Chat
+   ↘ 任務更新 / 進度回報 / 預覽連結 ←───────────────────────────────────────────↗
 ```
 
-在 VS Code 中：
-1. `Cmd+Shift+P` / `Ctrl+Shift+P`
-2. 選擇 **Install from VSIX**
-3. 選取 `packages/vscode-extension/vsmonster-*.vsix`
+VSMONSTER 將社群訊息轉成任務，交給 VS Code Copilot 執行，並回傳進度與結果到原平台。
 
 ---
 
-## ⚙️ 設定檔與環境變數
-
-VSMONSTER 會依序搜尋以下位置：
-
-1. `configs/config.json`
-2. `./config.json`
-3. `~/.vsmonster/config.json`
-
-### 範例設定檔
-
-```json
-{
-  "port": 3000,
-  "channels": {
-    "telegram": {
-      "botToken": "YOUR_BOT_TOKEN"
-    }
-  },
-  "tunnel": {
-    "enabled": false,
-    "authtoken": "YOUR_NGROK_TOKEN",
-    "region": "ap"
-  }
-}
+## ⚙️ 環境變數設定
+
+所有敏感設定都放在 `.env` 檔案中（已加入 `.gitignore`，不會上傳）。
+
+### 快速設定
+
+```bash
+cp .env.example .env   # 複製範本
+nano .env              # 編輯並填入你的 Token
 ```
 
-### 環境變數
+### 環境變數說明
 
-- `VSMONSTER_PORT`
-- `LINE_CHANNEL_ACCESS_TOKEN`, `LINE_CHANNEL_SECRET`
-- `TELEGRAM_BOT_TOKEN`, `TELEGRAM_WEBHOOK_URL`
-- `DISCORD_BOT_TOKEN`, `DISCORD_APPLICATION_ID`, `DISCORD_PUBLIC_KEY`
-- `NGROK_AUTHTOKEN`, `NGROK_ENABLED`, `NGROK_REGION`
+| 變數 | 說明 | 必填 |
+|------|------|------|
+| `VSMONSTER_PORT` | Gateway 埠號（預設 3000） | ❌ |
+| `LINE_CHANNEL_ACCESS_TOKEN` | LINE Bot Token | LINE 用戶 |
+| `LINE_CHANNEL_SECRET` | LINE Channel Secret | LINE 用戶 |
+| `TELEGRAM_BOT_TOKEN` | Telegram Bot Token | Telegram 用戶 |
+| `DISCORD_BOT_TOKEN` | Discord Bot Token | Discord 用戶 |
+| `DISCORD_APPLICATION_ID` | Discord App ID | Discord 用戶 |
+| `NGROK_AUTHTOKEN` | ngrok 認證 Token | ❌ 可選 |
+
+> 💡 詳細範本請參考 [.env.example](.env.example)
 
 ---