WT 個人 AI 助手系統架構

一系統總覽

這是 WT（王逸倫）的個人 AI 助手系統，運行在 Hetzner 雲端主機（46.225.179.123），24/7 在線。核心是 Claude Code（Opus 4.6），透過 Discord 與 WT 即時對話，同時管理多個自動化服務。

架構圖

┌─────────────────────────────────────────────────────┐
│                    Hetzner Cloud                     │
│                  46.225.179.123                      │
│                                                     │
│  ┌──────────────┐    ┌──────────────────────────┐   │
│  │  Claude Code  │◄──►│  Discord Plugin (MCP)     │   │
│  │ (tmux session)│   │  channel: 148476...       │   │
│  │  Opus 4.6     │   └──────────────────────────┘   │
│  │               │                                   │
│  │  ┌──────────┐ │   ┌──────────────────────────┐   │
│  │  │ Hooks    │ │   │  Cron Jobs (14 個)         │   │
│  │  │ 11 個    │ │   │  每 5 分～每天             │   │
│  │  └──────────┘ │   └──────────────────────────┘   │
│  │               │                                   │
│  │  ┌──────────┐ │   ┌──────────────────────────┐   │
│  │  │ Memory   │ │   │  Services (3 個)           │   │
│  │  │ Git Repo │ │   │  captain / transcribe      │   │
│  │  └──────────┘ │   └──────────────────────────┘   │
│  └──────────────┘                                   │
│                                                     │
│  ┌──────────────┐    ┌──────────────────────────┐   │
│  │ Cloudflare   │    │  GitHub (4 repos)          │   │
│  │ Pages (4站)  │    │  adom-near/*               │   │
│  └──────────────┘    └──────────────────────────┘   │
└─────────────────────────────────────────────────────┘
         ▲                        ▲
         │ HTTPS                  │ SSH/SFTP
         ▼                        ▼
┌──────────────┐          ┌──────────────┐
│  WT 的手機    │          │  MacBook Pro  │
│  (Discord)    │          │  (本機 Claude │
│  (JPR 錄音)   │          │   Code)       │
└──────────────┘          └──────────────┘

二核心元件

2.1 Claude Code 主程序

• 啟動時帶 --channels 參數啟用 Discord 即時通訊
• 自動重啟：每 6 小時或記憶體低於 500MB 時由 cron 觸發

2.2 Discord 通訊層

• 頻道：1484763667512823808
• 功能：即時對話、任務指派、進度回報、檔案傳輸
• Bot token 存於 /root/.claude/channels/discord/.env

2.3 記憶系統

• 儲存：Git repo（adom-near/claude-memory），markdown 檔案
• 同步：每 5 分鐘自動 git sync（sync-memory.sh）
• 跨 session：雲端和本機 Claude 共用同一個 repo
• TTL 機制：patrol.sh 定期掃描過期記憶（project 30天、feedback 90天、user 180天）

三Hooks 系統（11 個）

四Cron 排程（14 個）

五常駐 Services（3 個）

六網站部署（4 站）

七巡檢系統（patrol.sh，9 項檢查）

patrol.sh 每 30 分鐘執行一次，有異常時回報 DC，沒事就靜默。

1. 新錄音未處理
2. auto_transcribe lock 卡住
3. task_queue pending 任務
4. checkpoint 中斷任務
5. claude-memory 未 commit 變更
6. 最近錯誤 log
7. DC 漏回覆偵測（Discord API 比對時間差）
8. 記憶檔案 TTL 過期（每天 09:00 那一輪）
9. 磁碟使用率

八資料流

iPhone JPR 錄音 → SFTP → /root/incoming/recordings/
    → watch-recordings.service 偵測
    → auto_transcribe.sh（每 15 分鐘）
    → faster-whisper 轉譯
    → Claude 分析摘要
    → 更新語音轉譯摘要頁
    → git push → Cloudflare 自動部署
    → DC 傳連結

WT 透過 DC 指派研究任務
    → Claude 搜尋/分析
    → 生成 HTML 頁面
    → git push → Cloudflare 部署
    → post-push-verify.sh 驗證
    → DC 傳連結

Claude 寫入記憶檔案
    → PostToolUse hook 觸發 memory-git-sync.sh push
    → git commit + push
    → sync-memory.sh 每 5 分鐘雙向同步
    → 本機 Claude 啟動時 git pull 取得更新

cron 每小時檢查 → 超過 6h 或記憶體低
    → 重啟前生成 daily log
    → /exit 優雅退出（等 30 秒）
    → tmux new-session 重啟
    → postcheck 確認 PID
    → DC 通知「🟢 auto-restart 成功」
    → SessionStart hooks 自動恢復（拉記憶、載任務、補日誌）
    → fetch DC 訊息補漏

九安全機制

十成本