Hermes Tweet
Hermes Tweet 為 Hermes Agent 添加了 X/Twitter 工具集。它對於社交聆聽、帳號研究、發布監控、支援分類、抽獎活動審核以及需要明確說明的私密或狀態變更操作控制工作流程非常有用。
何時使用此技能
當使用者想要以下操作時，請使用此技能：
- 將 Hermes Tweet 安裝到 Hermes Agent 執行環境中
- 探索可用的 X/Twitter 讀取和動作路由
- 讀取 X/Twitter 帳號、推文、趨勢、監控或搜尋資料
- 在草擬回覆或活動前摘要公眾訊號
- 將私密和狀態變更操作限制在明確的操作者意圖下
設定
透過 Hermes 安裝並啟用外掛：
hermes plugins install Xquik-dev/hermes-tweet --enable
Hermes 在安裝和更新期間掃描外掛。請審閱每個警告。危險評級會阻止安裝或停用更新。
在 Hermes 執行環境主機上設定 API 金鑰：
export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"
對於唯讀優先的工作階段，請保持 HERMES_TWEET_ENABLE_ACTIONS 為 false。僅在核准的私密讀取、寫入、監控、Webhook、擷取、繪圖或媒體操作時，才將其設定為 true。
輸入
在選擇路由前，請詢問以下輸入：
- 目標：研究、監控、支援分類、抽獎活動審核或動作準備
- 目標：帳號代碼、推文 URL、關鍵字、清單、監控或趨勢
- 時間範圍和新鮮度需求
- 是否涉及任何私密或狀態變更操作
- 確認 Hermes 執行環境已設定
XQUIK_API_KEY
工作流程
- 使用
tweet_explore搜尋已捆綁的端點目錄，以找到匹配的路由。 - 選擇目錄路由後，透過
tweet_read讀取公開的 X/Twitter 資料。 - 僅在明確核准後，才使用
tweet_action進行私密或狀態變更路由。 - 將 API 金鑰保留在環境變數或 Hermes 執行環境的環境設定檔中。
- 不要將憑證貼到提示、問題、PR 評論或工具輸入中。
- 當使用者要求活動、監控、支援或抽獎活動工作流程（而非單一讀取）時，載入工作流程模式。
工具模型
| 工具 | 用途 |
|---|---|
tweet_explore | 無需使用 API 金鑰即可搜尋已捆綁的端點目錄。 |
tweet_read | 當設定 XQUIK_API_KEY 時，呼叫目錄中列出的公開唯讀端點。 |
tweet_action | 僅在啟用動作閘門時，呼叫私密讀取、寫入、監控、Webhook、擷取、繪圖和媒體操作。 |
輸出格式
回傳簡潔的操作輸出：
摘要：
- 檢查了什麼以及原因
讀取路由：
- 目錄路徑、輸入和結果摘要
動作計劃：
- 建議的私密或狀態變更操作，每個操作都等待明確核准
下一步檢查：
- 後續路由或監控頻率（若有用）
使用範例
在草擬回覆前研究帳號：
在草擬回覆前，使用 Hermes Tweet 檢查 @example 最近的公開上下文。
保持動作停用。
監控發布關鍵字：
追蹤今日 X/Twitter 上對於「Example Launch」的提及。
摘要主題和 notable 帳號。不要發布。
準備受保護的發布：
草擬一條發布推文，並列出你將使用的確切 tweet_action 呼叫。
在執行動作路由前等待核准。
擷取結構化路由筆記：
{
"objective": "support-triage",
"route": "/api/v1/x/search",
"action_gate": "disabled",
"approval_required": true
}
疑難排解
- 如果只出現
tweet_explore，請在 Hermes 執行環境主機上設定XQUIK_API_KEY，然後重新載入或重新啟動作用中的 Hermes 工作階段。 - 如果動作路由不可用，請將公開讀取分開處理。僅在核准的私密或狀態變更操作時，才設定
HERMES_TWEET_ENABLE_ACTIONS=true。 - 如果路由不匹配，請再次使用
tweet_explore，並選擇目錄中列出的路徑，而不是猜測端點。
最佳實踐
- 將 Hermes Tweet 視為 Hermes 原生的 X/Twitter 層，而不是通用的 API 包裝器。
- 預設將研究設定為唯讀。在建立或變更監控前需要先核准。
- 在進行私密或狀態變更呼叫前，使用桌面或閘道操作者審查。
- 在呼叫
tweet_read或tweet_action前，驗證確切的目錄路徑。 - 在環境變更後，重新啟動閘道、cron 或長時間執行的 Hermes 工作階段。
另請參閱
社交發布外掛補充了 Hermes Tweet，用於廣泛的多平台發布。Hermes Tweet 專注於 Hermes Agent 的 X/Twitter 工具集及其唯讀優先、審核核准的操作模型。
當路由邊界不明確時，請參閱端點與核准合約。請參閱官方指南：https://github.com/Xquik-dev/hermes-tweet#readme。