Global Chinese Community of Universal Digital Commons
一個專為 GCC 社區設計的 Telegram AI 助手，作為 GCC 的第一道過濾器——回答基本問題、收集申請資料、預審申請者，再交棒給 GCC 人類成員進行深入判斷。
這個 Agent 不是通用問答機器。它的核心任務是：
- 過濾 — 只服務已加入 GCC Telegram 社區的成員
- 引導 — 優先給出官網連結，節省 token，回應更準確
- 收集 — 三步驟收集申請者的基本資料
- 預審 — 根據 GCC 價值觀對申請進行初步評分
- 交棒 — 把有潛力的申請者轉介給 GCC 人類成員
Agent 的價值觀與審查邏輯儲存在獨立的 values.yaml，完全不受用戶對話影響，可隨時由管理員更新。
- 群組成員驗證（只有 GCC 群組成員可使用）
- 每日訊息上限（預設 20 條，防止濫用）
- 三層 Prompt 架構（價值觀 → GCC 摘要 → 對話記錄）
- 連結優先邏輯（問及已知內容直接給官網連結）
- 三語支援（繁體中文 / 簡體中文 / 英文，跟隨用戶語言）
- 申請資料三步收集（項目名稱 → 基金類型 → 一句話介紹）
- Values Engine 預審評分（0-100 分）
- 管理員私訊通知（申請完成後自動發送摘要）
/status管理員統計指令/update_values即時更新價值觀設定
gcc-telegram-agent/
├── main.py # Bot 入口
├── models.py # 資料結構定義
├── db.py # SQLite 資料庫操作
├── values.yaml # 價值觀設定（可隨時更新）
├── core/
│ ├── values.py # 價值觀載入與 Prompt 注入
│ ├── session.py # Session 管理
│ └── prompt.py # 三層 Prompt 組裝 + 連結優先邏輯
└── handlers/
├── guard.py # 群組驗證 + Rate Limit + 語言偵測
├── router.py # Intent 識別
├── general.py # 一般問答（OpenAI API）
├── application.py # 申請流程 + 預審 + 管理員通知
└── admin.py # 管理員指令
技術棧： Python 3.12 · python-telegram-bot · OpenAI API · SQLite · Fly.io
- Python 3.12+
- Telegram Bot Token（從 @BotFather 取得）
- OpenAI API Key
- Fly.io 帳號（用於部署）
git clone https://github.com/你的帳號/gcc-telegram-agent.git
cd gcc-telegram-agentpython3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txtcp .env.example .env編輯 .env，填入以下變數：
BOT_TOKEN=你從 BotFather 取得的 Token
ADMIN_USER_ID=你的 Telegram User ID（數字）
GCC_GROUP_ID=GCC Telegram 群組 ID（負數）
OPENAI_API_KEY=你的 OpenAI API Key
ADMIN_NOTIFY_ID=接收申請通知的 Telegram User ID取得 Telegram User ID：在 Telegram 找 @userinfobot 發任意訊息
編輯 values.yaml，填入你的組織使命、優先資助方向、審查邏輯。
把 ADMIN_USER_ID 替換為你真實的 Telegram User ID（數字）。
python main.py看到 Polling 模式啟動（本地開發） 表示正常。在 Telegram 找你的 Bot 測試。
python test_db.py # 階段 1：資料層
python test_guard.py # 階段 2：Guard Layer
python test_stage3.py # 階段 3：Prompt 架構
python test_stage4.py # 階段 4：申請流程curl -L https://fly.io/install.sh | sh
export PATH="$HOME/.fly/bin:$PATH"
flyctl auth loginflyctl launch --no-deploy --name 你的app名稱
flyctl volumes create gcc_agent_data --region nrt --size 1flyctl secrets set \
BOT_TOKEN="你的token" \
ADMIN_USER_ID="你的user_id" \
GCC_GROUP_ID="你的群組id" \
OPENAI_API_KEY="你的key" \
ADMIN_NOTIFY_ID="你的user_id" \
WEBHOOK_URL="https://你的app名稱.fly.dev/webhook"flyctl deploy在瀏覽器打開：
https://api.telegram.org/bot你的BOT_TOKEN/setWebhook?url=https://你的app名稱.fly.dev/webhook
看到 {"ok":true} 表示設定成功。
編輯 values.yaml 後有兩種方式生效：
方式 A：重新部署（推薦）
flyctl deploy方式 B：Telegram 指令（即時生效）
在 Telegram 私訊 Bot 發送：
/update_values
只有 ADMIN_USER_ID 對應的帳號可以執行此指令。
| 指令 | 功能 |
|---|---|
/status |
查看今日統計（用戶數、訊息數、token 消耗、申請數） |
/update_values |
重新載入 values.yaml |
version: "1.0.0"
admin_telegram_user_id: ADMIN_USER_ID
mission_statement: |
組織使命描述...
priority_themes:
- 優先資助方向 1
- 優先資助方向 2
rejection_criteria:
- 明確不考慮的申請類型
screening_rubric:
mission_fit: 40 # 使命契合度（滿分 40）
public_goods_nature: 30 # 公共物品屬性（滿分 30）
chinese_community: 20 # 華語社區影響（滿分 20）
feasibility: 10 # 可行性（滿分 10）
tone_guidelines: |
回應語氣指引...
gcc_summary: |
組織背景摘要（用於初次對話）...預審評分結果：
- ≥ 70 分 → 通知管理員，建議深入跟進
- 40–69 分 → 提供資料連結，建議參與例會
- < 40 分 → 禮貌說明不符合方向
- 每個用戶保留最近 20 條對話記錄
- 30 分鐘無活動後自動開新 Session
- 不使用 AI 壓縮摘要，改以例會提醒引導深入交流
- 價值觀層（Layer 1）永遠排在對話記錄之前，不可被用戶覆蓋
本項目以 MIT 授權開源。
衍生作品必須同樣以 MIT 授權開源，共同維護數字公地的開放精神。
Global Chinese Community of Universal Digital Commons
GCC 支持以未來方式重塑公共物品的人與項目，立足華語，共連全球。
- 官方網站：gccofficial.org
- 資助申請：gccofficial.org/application