JARVIS

透過 Claude Code 以文字或語音管理 Ubuntu VPS 的 Telegram 機器人，並以「蘇格拉底關卡」確認危險指令。

JARVIS MK1 Lite 是一款極簡的 Telegram 機器人（aiogram），可安全存取 Ubuntu VPS 上的 Claude Code SDK。危險指令必須通過「蘇格拉底關卡」（Socratic Gate）：共四個風險等級（SAFE / MODERATE / DANGEROUS / CRITICAL），其中 CRITICAL 級須輸入確切的確認語句；語音訊息透過 Telegram Premium 轉為文字，且在執行任何動作之前，機器人會先提出釐清問題。1.3.x 版曾在正式環境的 VPS 上運作（CHANGELOG 記載了 2026-02-09 的一次事件及其修復）；另有精簡後的公開版本以 MIT 授權發布。

任務

能在手機上管理伺服器並執行代理任務，而不必開啟 SSH，同時防止意外執行破壞性指令。

核心功能

• 僅允許白名單中的 Telegram ID 存取，並限制請求速率（token bucket）
• Socratic Gate：指令風險評估與確認；V2 為兩階段意圖檢查（語音訊息由 Claude Haiku 提出釐清問題，文字訊息則為選用）
• 透過 Telegram Premium（Telethon）處理語音訊息與圓形影片訊息
• 檔案處理：PDF 與文字（PyMuPDF）、回傳檔案、將過長的回覆智慧分段以符合 Telegram 限制
• 具備到期與 LRU 淘汰機制的工作階段、/status、/metrics 與 /new 指令、模型切換
• 正式環境配套：結構化日誌（structlog）、healthcheck、systemd 單元與安裝腳本

機器翻譯，校對中。