# 影片筆記：I Built an AI Content Studio with 5 Hermes Agents (Step-by-Step Guide)

## 一句話總結

影片詳細演示了如何透過 VPS 伺服器安裝並配置 **Hermes** 基礎設施，建立包含五個專屬 AI 代理（Atlas、Vera、Kite、Orion、Orchestrator）的自動化內容工作室 **Cadence**，並透過 Telegram 與自訂 Dashboard 實現從研究、寫作、設計到發布的完整自動化流程。

## 核心重點

1.  **系統架構 (Cadence)**：
    *   由五個代理組成：Atlas (研究員)、Vera (作家)、Kite (設計師/開發者)、Orion (發布者)、Orchestrator (協調者)。
    *   核心技術：使用 **HTML 模板** 而非 AI 圖片生成來製作輪播圖，實現無限編輯且無額外 API 成本。
    *   通訊機制：透過 Telegram Bot 進行指令路由，並建立專屬頻道隔離不同代理的訊息。

2.  **基礎設施部署 (Hermes)**：
    *   伺服器選擇：推薦使用 VPS (如 Racknet 或 Contabo)，作業系統為 Ubuntu。
    *   安裝流程：透過 SSH 連線至 VPS，建立非 root 使用者，執行一鍵安裝指令，並配置 Telegram Bot Token。
    *   模型配置：建議使用 OpenAI Plus/Pro 訂閱方案以免費使用 Codex 模型，避免按用量付費風險。

3.  **代理配置與記憶隔離**：
    *   每個代理擁有獨立的 `soul.md` (角色定義) 與 `memory.md` (長期記憶)。
    *   建立 Agent 日誌資料庫 (Agent Login Database)，記錄所有代理的活動、模型使用及時間戳，提供透明度。
    *   透過 Telegram 多 Bot 架構，將不同頻道綁定至不同代理，避免訊息混淆。

4.  **Dashboard 與發布流程**：
    *   使用 Python 後端與 HTML/JSON 模板構建儀表板。
    *   整合 Perplexity (研究)、ImageBB (圖片儲存)、Buffer/Metricool (發布) 等第三方 API。
    *   透過 Tailscale 實現安全的遠端存取，取代傳統的 SSH 隧道。

## 詳細大綱

### 1. 系統概覽與技術優勢
*   **Cadence 系統**：內容運營自動駕駛系統，由四個專家代理（Atlas, Vera, Kite, Orion）及一個協調者代理組成。
*   **HTML 渲染優勢**：
    *   不使用 AI 像素生成圖片，而是使用精心設計的 HTML 模板。
    *   允許免費編輯文字、大小、位置，實現無限次修改無額外費用。
    *   最終透過無頭瀏覽器 (Headless Browser) 渲染為圖片上傳社群媒體。
*   **數據透明**：儀表板顯示真實指標，記錄每個代理執行的任務、使用的 AI 模型及時間。

### 2. 伺服器環境準備
*   **VPS 選擇**：
    *   **Racknet**：年付約 $35，規格建議 2 CPU, 35 GB 空間, 2 GB RAM。
    *   **Contabo**：月付約 $8，規格建議 4 CPU, 8 GB RAM, 100 GB SSD。建議開啟自動備份。
*   **SSH 連線**：
    *   使用 Windows PowerShell 或 Mac Terminal。
    *   指令：`ssh root@IP地址`。
    *   建議建立新使用者帳戶 (如 Larry) 並賦予 sudo 權限，而非直接使用 root。

### 3. Hermes 安裝與配置
*   **安裝步驟**：
    *   執行一鍵安裝指令 (`curl ...`)。
    *   選擇 "Quick Setup"。
    *   綁定 News Research 帳號 (免費方案)。
    *   選擇自有 AI 模型，跳過預設模型。
    *   設定 Telegram 作為訊息平台，手動建立 Bot Token。
    *   設定管理員使用者 ID，將 Hermes Gateway 安裝為系統服務。
*   **AI 模型配置**：
    *   推薦使用 OpenAI Plus/Pro 訂閱，免費使用 Codex 模型。
    *   配置流程：列出模型 -> 選擇 OpenAI Codex -> OAuth 授權 -> 選擇模型版本 (如 5.5)。
    *   測試：透過終端介面發送 "hi" 確認回應。

### 4. 代理初始化與記憶機制
*   **Orchestrator 初始化**：
    *   設定代理名稱、使用者身份 (Owner)、品牌資訊、受眾、語氣及工作時區。
*   **代理角色定義**：
    *   **Atlas**：內容偵察 (Content Scout)，負責研究。
    *   **Vera**：作家 (Writer)。
    *   **Kite**：設計師與開發者 (Designer & Developer)。
    *   **Orion**：發布者 (Publisher)。
    *   **Orchestrator**：協調者。
*   **記憶結構**：
    *   每個代理擁有獨立的 `soul.md` (角色描述) 與 `memory.md` (長期記憶)。
    *   避免多個代理共用單一記憶文件導致混亂。

### 5. 日誌系統與多 Bot 架構
*   **Agent 日誌資料庫**：
    *   建立 SQL 資料庫，強制所有 Agent 記錄名稱、操作描述、時間戳記及使用的 AI 模型。
    *   透過儀表板熱圖提供透明度，並執行煙霧測試確保寫入正常。
*   **Telegram 多 Bot 架構**：
    *   為 Kite 建立專屬 Bot Token 與 Telegram 頻道。
    *   實現訊息隔離：Orchestrator 僅監聽其頻道，Kite 僅監聽其頻道。
    *   配置伺服器環境變數，將 Token 存入設定中。

### 6. 頻道綁定與 Gateway 重啟
*   **頻道綁定 (Binding)**：
    *   獲取 Telegram Group ID 及各頻道 Thread ID。
    *   將參數填入提示詞發送給 Orchestrator，執行綁定指令。
*   **Gateway 重啟**：
    *   Orchestrator 保存配置後無法自動重啟 Gateway，需手動執行命令。
    *   處理 `failed to connect to bus` 錯誤，確認 Gateway 運行狀態。
    *   將 Kite Bot 加入 Telegram 群組並設為管理員，測試各頻道僅回應對應 Agent。

### 7. Dashboard 開發與部署
*   **後端建立**：
    *   使用 Python 建立 Web 儀表板後端。
    *   初期使用 SSH Tunneling 確保安全性，後續安裝 Tailscale 以提供穩定遠端存取。
*   **模板上傳與驗證**：
    *   上傳 HTML 與 JSON 模板文件。
    *   Kite 使用內建瀏覽器進行自我檢查，確保前端顯示與模板一致。
*   **數據動態化**：
    *   將儀表板數據從硬編碼改為從 Agent Login Database 拉取的真實數據。
    *   修正熱圖與運行表數據，確保顯示歷史記錄而非僅當日記錄。

### 8. 圖片生成與自動適應
*   **Carousel 圖片生成器**：
    *   將每個 Carousel 幻燈片建構為 HTML 檔案。
    *   使用無頭瀏覽器 (Chromium) 渲染並截圖為 JPEG/PNG，供上傳社群媒體。
*   **後端自動適應 (Auto Fit)**：
    *   後端提示詞觸發，將 Vera 生成的內容自動適應並插入選定的 HTML 模板。
    *   解決字數長短不一的排版問題，確保設計美觀。

### 9. 發布管道與 API 整合
*   **Dashboard 觸發機制**：
    *   建立介面讓使用者透過 Dashboard 按鈕觸發不同 Agent。
*   **API 整合**：
    *   **Perplexity**：用於研究查詢，需申請 API Key。
    *   **ImageBB**：用於暫存生成的圖片。
    *   **Buffer / Metricool**：用於社群發布。Buffer 標準方案提供 API，但需為每個社群帳號額外付費。
*   **手動發布備用方案**：
    *   Dashboard 提供下載滑塊、縮圖及標題的功能，供使用者手動發布。

### 10. 端到端演示與錯誤修復
*   **API 金鑰儲存**：
    *   透過 PowerShell 將 API 金鑰秘密存入伺服器，防止洩露。
    *   執行煙霧測試驗證 Buffer、ImageBB 與 Perplexity 連線狀態。
*   **實機演示流程**：
    *   點擊「Generate Ideas」，Atlas 生成想法。
    *   點擊「Promote」，Vera 撰寫內容，套用模板，渲染至工作室。
    *   點擊「Post Now」，透過 Buffer 發布至 Instagram。
*   **錯誤修復**：
    *   修復發布頁顯示數量但內容為空的 Bug。
    *   配置設定頁，用於編輯品牌名稱、帳號名稱及內容簡介。

### 11. Telegram 遠端控制與 Tailscale
*   **Telegram 遠端控制**：
    *   建立 Telegram 遠端控制功能，以便在 Studio Tab 直接生成想法和推廣內容。
    *   修復 Gateway 重啟阻礙、Telegram 指令回報錯誤及模板名稱不一致問題。
*   **Tailscale 安裝**：
    *   取代 SSH Tunneling，無需每次輸入密碼，支援多裝置存取。
    *   下載並安裝 Tailscale，登入帳號後產生唯一 URL 連接 Dashboard。

### 12. Tail Scale 綁定與 Dashboard 總覽
*   **Tail Scale 綁定**：
    *   獲取登入連結，綁定設備至 Tail Scale 帳戶。
    *   確認設備已綁定至電腦的 Tailnet。
    *   終止 SSH 連接，確認可通過 Tail Scale URL 直接訪問。
*   **Dashboard 功能模組**：
    *   **Dashboard Tab**：查看代理活動日誌。
    *   **Ideas Tab**：創建新想法或自動生成。
    *   **Studio Tab**：推廣想法至此標籤頁。
    *   **Publish Tab**：推送帖子至社交媒體平台。
    *   **Templates Tab**：提供輪播幻燈片模板。
    *   **Dedicated Agents Tab**：顯示所有代理及其熱圖。
    *   **Calendar Tab**：查看已排程及已發布的帖子。
    *   **Configuration Tab**：配置品牌名稱及代理生成內容的參數。
    *   **Docs Tab**：使用說明。
*   **額外建議**：
    *   設置每週清理任務，刪除資料庫中超過 7 天的舊活動記錄。

## 工具 / 模型 / 名詞整理

*   **Cadence**：影片介紹的內容運營自動駕駛系統名稱。
*   **Hermes** (或聽似 **Her agents** / **Hemisen**)：AI Agent 基礎設施軟體。
*   **Atlas**：負責研究的 AI 代理 (Content Scout)。
*   **Vera**：負責寫作的 AI 代理 (Writer)。
*   **Kite** (或聽似 **Skype** / **Kai**)：負責設計的 AI 代理 (Designer & Developer)。
*   **Orion** (或聽似 **Orin** / **Rich**)：負責發布的 AI 代理 (Publisher)。
*   **Orchestrator**：協調者代理，位於頂層，接收 Telegram 聊天中的指令並路由任務。
*   **Telegram**：用於接收協調者代理指令的聊天平台，需建立專屬 Bot Token 與頻道。
*   **BotFather**：Telegram 中用於建立新 Bot 的官方 Bot。
*   **Perplexity**：用於深度研究的工具/模型，需申請 API Key。
*   **Buffer**：用於連接社交媒體平台並發布內容的平台，標準方案提供 API。
*   **Metricool** (或聽似 **Metrical**)：社群發布管理工具，進階方案提供 API。
*   **ImageBB** (或聽似 **imageb** / **image PV**)：圖片儲存平台，用於暫存生成的圖片。
*   **OpenAI / Codex**：AI 模型供應商及模型名稱，推薦使用 Plus/Pro 訂閱方案。
*   **Racknet**：VPS 供應商。
*   **Contabo**：VPS 供應商。
*   **Ubuntu**：作業系統。
*   **SSH**：安全殼層協定，用於連線伺服器。
*   **Tailscale**：網路連線工具，用於簡化 Dashboard 存取，取代 SSH 隧道。
*   **HTML / JSON**：前端模板文件格式，用於生成輪播圖。
*   **Chromium**：無頭瀏覽器，用於將 HTML 渲染為圖片。
*   **soul.md**：代理描述文件，包含名稱、職責、系統描述。
*   **memory.md**：代理長期記憶文件。
*   **Agent Login Database**：代理登入資料庫，用於儲存代理活動數據。
*   **Headless Browser**：無頭瀏覽器，用於自動化網頁渲染與截圖。
*   **Smoke Test**：煙霧測試，用於驗證系統組件是否正常運作。
*   **Steroid mode**：強化模式，生成更強有力的文案。
*   **Hook**：鉤子，輪播圖首張幻燈片。
*   **CTA**：行動呼籲，輪播圖末張幻燈片。

## 操作流程整理

1.  **準備伺服器環境**：
    *   選擇 VPS (Racknet 或 Contabo)，安裝 Ubuntu。
    *   透過 SSH 連線，建立非 root 使用者 (如 Larry)。
2.  **安裝與配置 Hermes**：
    *   執行一鍵安裝指令，選擇 Quick Setup。
    *   綁定 News Research 帳號，選擇自有 AI 模型 (如 OpenAI Codex)。
    *   設定 Telegram Bot Token，建立管理員使用者 ID。
    *   將 Hermes Gateway 安裝為系統服務。
3.  **初始化代理與記憶**：
    *   設定 Orchestrator 的品牌資訊與使用者身份。
    *   指示 Orchestrator 建立五個代理 (Atlas, Vera, Kite, Orion, Orchestrator) 的配置文件。
    *   確保每個代理擁有獨立的 `soul.md` 與 `memory.md`。
4.  **建立日誌資料庫與多 Bot 架構**：
    *   建立 SQL 資料庫，記錄所有代理活動。
    *   為 Kite 建立專屬 Telegram Bot Token 與頻道。
    *   配置伺服器環境變數，綁定頻道與代理。
5.  **開發 Dashboard**：
    *   使用 Python 建立後端，上傳 HTML/JSON 模板。
    *   整合 Perplexity, ImageBB, Buffer/Metricool API。
    *   安裝 Tailscale，實現遠端存取。
6.  **端到端測試與發布**：
    *   透過 Dashboard 觸發 Atlas 生成想法。
    *   透過 Vera 撰寫內容，套用 HTML 模板。
    *   使用 Chromium 渲染圖片，透過 Buffer 發布至 Instagram。
    *   修復發布頁顯示錯誤，配置設定頁。

## 值得注意的限制或風險

*   **API 成本風險**：若未使用 OpenAI Plus/Pro 訂閱，使用 Codex 模型可能產生按用量付費的額外費用。
*   **資料庫雜亂**：若未設置每週清理任務，資料庫中超過 7 天的舊活動記錄可能導致資料庫雜亂。
*   **Gateway 重啟問題**：Orchestrator 保存配置後可能無法自動重啟 Gateway，需手動執行命令，過程中可能遭遇 `failed to connect to bus` 錯誤。
*   **Telegram 頻道綁定限制**：預設情況下，Telegram 允許單一 Bot Token 對應單一 Bot，需建立多個 Bot Token 以實現多代理訊息隔離。
*   **模板名稱不一致**：Telegram 指令接受的模板名稱與 Dashboard 顯示名稱可能不一致，導致 `template not found` 錯誤，需手動修正對應關係。

## 逐字稿辨識疑點

*   **Hermes / Hemis / Hemisus / Hermise / Her agents / Hemisen**：逐字稿中交替出現這些名稱，指代同一個 AI Agent 基礎設施軟體，需查證正確名稱。
*   **Ben from Antropic**：講者口語提及 "Ben from Antropic"，Anthropic 是知名 AI 公司，"Ben" 可能是聽寫錯誤或口誤，需查證。
*   **Racknet / Rocknet / Rak**：講者在提及 VPS 供應商時，名稱拼寫不一致，需查證正確供應商名稱。
*   **Ubuntu 2012.04**：講者口語提及作業系統版本為 "2012.04"，Ubuntu 版本編號通常為年份.月份 (如 20.04, 22.04)，"2012.04" 可能是口誤，需查證。
*   **SSH port of three**：講者口語提及 SSH 連接埠預設為 "three" (3)，標準 SSH 連接埠通常為 22，需查證是否為口誤或特定情境。
*   **Macrop system**：講者口語提及 "macrop system"，應為 "Mac operating system" 或 "macOS"