hermes-tweet

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。

输入

在选择路由之前，请先询问以下输入：

• 目标：调研、监控、支持分流、抽奖审计或操作准备
• 目标对象：账号 handle、推文 URL、关键词、列表、监控或趋势
• 时间窗口与时效性需求
• 是否有任何私有操作或状态变更操作在范围内
• 确认 Hermes 运行时已具备 XQUIK_API_KEY

工作流

1. 使用 tweet_explore 搜索内置端点目录，以找到匹配的路由。
2. 选择目录路由后，通过 tweet_read 读取公开的 X/Twitter 数据。
3. 仅在获得明确批准后，才使用 tweet_action 处理私有路由或状态变更路由。
4. 将 API 密钥保存在环境变量或 Hermes 运行时 env 文件中。
5. 不要将凭据粘贴到提示词、issue、PR 评论或工具输入中。
6. 当用户要求的是活动、监控、支持或抽奖工作流而非单次读取时，请加载 工作流模式。

工具模型

工具	用途
tweet_explore	在不使用 API 密钥的情况下搜索内置端点目录。
tweet_read	在设置了 XQUIK_API_KEY 时，调用目录中列出的公开只读端点。
tweet_action	仅在启用操作门控时，调用私有读取、写入、监控、webhook、提取、抽奖和媒体操作。

输出格式

返回简洁的可操作输出：

Summary:
- What was checked and why

Read routes:
- Catalog path, input, and result summary

Action plan:
- Proposed private or state-changing operations, each awaiting explicit approval

Next check:
- Follow-up route or monitoring cadence when useful

使用示例

在起草回复之前调研某个账号：

Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.

监控某个发布关键词：

Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.

准备一条受控的帖子：

Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.

记录结构化的路由笔记：

{
  "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 封装。
• 默认将调研保持为只读。在创建或更改监控之前要求批准。
• 在私有调用或状态变更调用之前，使用 Desktop 或网关操作者审查。
• 在调用 tweet_read 或 tweet_action 之前，验证确切的目录路径。
• 在环境变更后，重启网关、cron 或长时间运行的 Hermes 会话。

另请参阅

社交发布插件可与 Hermes Tweet 互补，用于广泛的多平台发布。Hermes Tweet 专注于 Hermes Agent 的 X/Twitter 工具集及其读取优先、审批门控的运行模式。

当路由边界不清晰时，请参阅端点与审批契约。官方指南见 https://github.com/Xquik-dev/hermes-tweet#readme。