1. 選擇部署平台#

原始架構使用 Python、Pillow 及 Telegram Long Polling，因此優先評估既有程式的相容性與搬遷成本。

建議： 現有專案繼續使用 Render，優先改善機房、圖片處理及 API 延遲。

若準備改寫 TypeScript Webhook，再考慮 Cloudflare Workers。

2. Telegram 權限與安全設定#

為了讓機器人接收群組內的圖片，需要調整 Telegram 隱私模式。

1. 開啟 @BotFather，執行 /setprivacy。
2. 選擇 Bot，設定為 Disable。
3. 必要時將 Bot 移出群組後重新加入。
4. 使用 chat_id、user_id 白名單限制存取。

1
# 僅允許指定群組使用
2
if update.effective_chat.id not in ALLOWED_CHAT_IDS:
3
    return

另外應先過濾非圖片訊息，避免不必要的 Gemini API 呼叫。

3. Render 部署與 UptimeRobot 防休眠#

Render 免費 Web Service 在閒置一段時間後可能休眠，造成下一次 Telegram 操作等待較久。

可以在 Python Bot 加入 HTTP 健康檢查端點，提供外部監控工具定期存取。

1
import os
2
import threading
3
from http.server import HTTPServer, BaseHTTPRequestHandler
4

5
class HealthHandler(BaseHTTPRequestHandler):
6
    def do_GET(self):
7
        self.send_response(200)
8
        self.end_headers()
9
        self.wfile.write(b"OK")
10

11
# 背景提供健康檢查，不阻塞 Telegram Bot
12
threading.Thread(
13
    target=lambda: HTTPServer(
14
        ("0.0.0.0", int(os.getenv("PORT", 8080))),
15
        HealthHandler
16
    ).serve_forever(),
17
    daemon=True
18
).start()

接著在 UptimeRobot 建立 HTTP(s) Monitor：

1. 登入 UptimeRobot Dashboard。
2. 點選 Add New Monitor。
3. Monitor Type 選擇 HTTP(s)。
4. URL 填入 Render 服務網址，例如 https://your-bot.onrender.com。
5. Monitoring Interval 設定為每 5 分鐘（依方案支援）。
6. 儲存設定，確認健康檢查回傳 HTTP 200。 效果：

UptimeRobot 定期發送 HTTP GET 請求，降低 Render 因閒置而休眠的機率。

但此方法不保證免費服務永久常駐，也無法避免平台維護、部署重啟或資源限制。

4. Gemini 辨識與效能優化#

Telegram 圖片記帳的主要耗時通常集中在：

• 圖片下載。
• Pillow 圖片處理。
• Gemini 模型推論。
• Google Sheets / Tricount 記帳 API 寫入。 建議採取以下優化方式：

圖片處理可改為：

1
import asyncio
2

3
# 將同步圖片處理移至執行緒
4
image_bytes = await asyncio.to_thread(
5
    optimize_receipt_image,
6
    raw_bytes
7
)

Telegram 收到圖片後，先顯示處理狀態：

1
# 先通知使用者正在辨識
2
status = await update.message.reply_text(
3
    "收據辨識中..."
4
)
5

6
# 執行 Gemini 辨識與記帳寫入
7
# result_text = ...
8

9
# 完成後更新原本訊息
10
await status.edit_text(result_text)

此方式不會直接縮短 Gemini 推論時間，但可避免使用者誤以為 Bot 沒有回應。

1. Render 機房位置#

若原本使用美東機房，可考慮重新建立 Singapore 服務。

• 新增 Render Web Service。
• Region 選擇 Singapore。
• 設定原本的 GitHub Repository 與環境變數。
• 部署成功後，停止舊服務。 注意： 不要讓兩個 Long Polling 實例同時執行，避免 Telegram 更新接收衝突。

2. 環境變數與重啟#

Render 常用環境變數：

• TELEGRAM_BOT_TOKEN
• GEMINI_API_KEY
• ALLOWED_CHAT_IDS 修改環境變數後，確認 Render 是否已完成部署或重新啟動。

若需要手動重啟，可在 Render Dashboard 選擇 Restart Service。

3. Gemini 免費額度與模型備援#

Gemini 模型名稱、免費額度及 RPM / RPD 限制會隨時間調整。

建議：

• 在 Google AI Studio 確認目前可用模型。
• 遇到 HTTP 429 時，依錯誤類型決定重試或切換模型。
• 不要將歷史免費額度或已停用模型寫死在程式中。