Hermes Tweet

概述

Hermes Tweet 在无需直接 HTTP 回退或猜测端点的情况下，解决 X 平台的研究与自动化任务。它可发现目录中列出的 Xquik 路由，执行已认证的读取操作，并将类写入操作或私有操作严格限制在显式的环境门控和用户明确批准之后。

请将该技能用于以读取为优先的工作流。仅当用户已明确认可某项具名操作的端点、载荷（payload）、账号及副作用时，才启用操作类工具（action tooling）。

适用场景

当 Hermes Agent 会话需要获取 X/Twitter 数据，或需通过 Hermes Tweet 插件执行受控的 X 平台操作时，请使用该技能。

尤其适用于以下场景：社交监听（social listening）、产品发布监控（launch monitoring）、客服问题分诊（support triage）、创作者研究（creator research）、品牌研究（brand research）、抽奖审计（giveaway audits）、社区审计（community audits），以及受控的内容发布工作流（controlled publishing workflows）。

当用户询问某项能力、端点、路由或 Xquik API 表面（API surface）时，请首先调用 tweet_explore；仅在已知只读端点后，再调用 tweet_read；仅当用户明确请求执行写入、私有读取、监控、Webhook、抽取任务（extraction job）、抽奖抽取（giveaway draw）或媒体操作（media operation）等需操作权限的操作时，才调用 tweet_action。

前提条件

• 通过命令安装并启用插件：hermes plugins install Xquik-dev/hermes-tweet --enable。
• 在 Hermes 运行时主机上配置 XQUIK_API_KEY 环境变量，以支持已认证的读取操作。tweet_explore 即使未配置密钥或无网络访问权限，仍保持可用。
• 除非工作流确实需要经批准的类写入或私有操作，否则请勿设置 HERMES_TWEET_ENABLE_ACTIONS，或将其设为 false。
• 对于项目本地插件（project-local plugins），仅在可信代码仓库中设置 HERMES_ENABLE_PROJECT_PLUGINS=true。
• 环境变量变更后，请重启网关并启动新会话；活跃的 CLI 会话可使用 /reload 命令重载配置。

权限与能力

• 仅可通过已启用的 Hermes Tweet 工具集调用 tweet_explore、tweet_read 和 tweet_action。
• 网络访问权限仅限于上述工具所调用的、目录中已列出的 Xquik API 路由；禁止创建直接 HTTP 回退路径。
• Shell 访问不属于常规操作范畴；Hermes CLI 命令仅可用于“测试”章节所列的安装与注册检查。
• 本地文件访问不属于常规操作范畴；除非用户明确要求导出工作流，否则不得写入报告、凭证、日志、截图或缓存的 API 响应载荷。
• 环境访问权限仅限于检查 XQUIK_API_KEY、HERMES_TWEET_ENABLE_ACTIONS 和 HERMES_ENABLE_PROJECT_PLUGINS 是否已配置；严禁请求或回显其具体值。
• 无需 MCP 访问权限。

操作指南

1. 使用 hermes plugins list 确认插件已启用，并使用 hermes tools list 确认工具已注册。
2. 使用 tweet_explore 发现目录中的端点与对应方法。
3. 在配置好 API 密钥后，对公开的只读端点使用 tweet_read。
4. 调用 tweet_action 前，须清晰陈述目标端点、载荷、账号、操作原因及预期副作用，并获得用户的明确批准。
5. 验证工具返回结果；如遇策略、认证、校验或账号类错误，请如实上报，不得尝试通过其他路径重试。

决策规则

• 若任务为端点发现，则使用简短查询调用 tweet_explore。
• 若端点方法为 GET，且目录未将其标记为操作类端点，则调用 tweet_read。
• 若端点方法非 GET，或该路由涉及私有账号状态，则仅当已启用操作功能（actions enabled）且用户已批准该操作时，方可调用 tweet_action。
• 若 tweet_action 不可用或已被禁用，则说明操作类工具受 HERMES_TWEET_ENABLE_ACTIONS=true 显式门控，属有意设计。
• 若缺失 XQUIK_API_KEY，则提示用户在 Hermes 运行时环境中配置该变量，但切勿在聊天中索取密钥值。
• 若 Hermes 列出该插件状态为 not enabled，则提示用户运行 hermes plugins enable hermes-tweet 或使用 --enable 参数重新安装。
• 若插件以项目本地方式安装于 .hermes/plugins/ 目录下，则提醒用户：Hermes 需在可信仓库中设置 HERMES_ENABLE_PROJECT_PLUGINS=true 才能加载此类插件。
• 若任务为无人值守、定时触发、网关驱动或 cron 驱动，则优先使用 tweet_read，并保持 tweet_action 处于禁用状态，除非工作流中存在明确的审批环节。
• 若用户在 Hermes Desktop 中使用远程网关配置文件，则提醒其：Hermes Tweet 必须在执行插件工具的远程 Hermes 主机上完成安装、启用与配置。
• 若用户通过 Hermes 仪表板（dashboard）管理网关或凭证，则应将 Hermes Tweet 的密钥保留在运行时环境中，切勿在聊天中索要密钥值。

安全性

• 严禁索取或泄露 API 密钥、签名密钥、密码、Cookie 或 TOTP 密钥。
• 严禁在工具参数中传递任何凭证信息。
• 仅允许调用目录中列出的 /api/v1/... 端点。
• 仅当复制的端点 URL 可解析为目录中已列出的路径时，才接受该 URL。
• 禁止使用账号连接、重新认证、API 密钥管理、账单、信用充值或工单支持等端点。
• 对于发帖、删帖、关注、私信（DMs）、资料修改、监控、Webhook、抽取任务及抽奖抽取等操作，在调用 tweet_action 前必须先汇总说明操作内容。

已知风险与缓解措施

• 风险：宽泛的 X/Twitter 请求可能映射至具备写入能力的路由。 缓解措施：始终从 tweet_explore 启动，优先选用 tweet_read，并在调用 tweet_action 前确保端点与载荷均经用户批准。
• 风险：密钥可能被粘贴至聊天记录或示例中。 缓解措施：仅询问环境配置，绝不索取密钥值；绝不将凭证信息置于工具参数中。
• 风险：端点猜测可能绕过目录审核机制。 缓解措施：仅接受目录中列出的 /api/v1/... 路径，拒绝一切直接 HTTP 回退行为。
• 风险：自动化的 X/Twitter 操作可能影响真实账号。 缓解措施：默认保持 HERMES_TWEET_ENABLE_ACTIONS=false，并在任何影响账号或工作流状态的调用前，完整汇总说明其副作用。

输出规范

• 输出类型：端点选择结果、API 响应摘要、操作预览及故障排查指引。
• 输出格式：面向人类阅读的简洁 Markdown 格式；面向 Hermes Tweet 工具调用的类 JSON 工具载荷格式。
• 副作用说明：tweet_explore 无外部副作用；tweet_read 执行已认证读取；tweet_action 仅在获得用户明确批准后，方可更改账号或工作流状态。

错误处理

采用最小化恢复步骤，以维持“读取优先、操作门控”的契约：

• 工具缺失：确认插件已启用，随后运行 hermes tools list。
• API 密钥缺失：在运行时主机上配置 XQUIK_API_KEY（切勿将密钥值粘贴至聊天中），随后在活跃 CLI 会话中运行 /reload，或执行 hermes gateway restart 并启动新网关会话。
• 未知端点：再次调用 tweet_explore；严禁猜测路径或创建直接 HTTP 回退。
• 操作被禁用：除非用户已主动请求且已显式配置 HERMES_TWEET_ENABLE_ACTIONS=true，否则保持操作阻断状态。
• 策略、认证、校验或账号类错误：返回清洗后的失败信息及纠正步骤；禁止尝试通过其他路径重试。
• 缺失斜杠命令（slash command）：应在活跃 Hermes 会话或插件注册表测试中验证其存在性，而非将提示文本视为注册完成的依据。
• 输入中含密钥：立即中止流程，并提示用户轮换密钥后再继续。

示例

示例：搜索推文

{"query":"tweet search","method":"GET"}

随后调用：

{"path":"/api/v1/x/tweets/search","query":{"q":"AI agents","limit":25}}

示例：查看趋势

在活跃 Hermes 会话中运行 /xtrends。当任务需要目录端点或结构化响应（而非斜杠命令）时，请使用 tweet_explore。

示例：发布推文

{"query":"post tweet","include_actions":true}

随后使用以下参数调用 tweet_action：

{"path":"/api/v1/x/tweets","method":"POST","body":{"account":"@example","text":"Hello from Hermes Tweet"},"reason":"Post the user-approved tweet."}

测试

在 Hermes Agent 中安装或升级插件后：

1. 若安装时未使用 --enable 参数，则运行 hermes plugins enable hermes-tweet。
2. 运行 hermes plugins list，确认插件状态为 enabled。
3. 运行 hermes tools list，确认 hermes-tweet 工具集已启用。
4. 确认 tweet_explore 在未配置 XQUIK_API_KEY 时仍可用。
5. 确认 tweet_read 仅在 XQUIK_API_KEY 已配置时才出现。
6. 确认 tweet_action 仅在 HERMES_TWEET_ENABLE_ACTIONS=true 时才可见或启用；否则保持隐藏或禁用状态。

常用 CLI 检查命令：

hermes plugins enable hermes-tweet
hermes tools list

发布可信门控（Release Trust Gate）

在将本技能作为 NVIDIA 认证技能或面向企业广泛部署前，须完成以下步骤：

1. 使用 SkillSpector 对完整技能目录执行扫描，并修复所有严重（critical）或高危（high）级别问题。
2. 补全 skill-card.md 文件，包含所有者、许可证、用例、部署地域、风险、参考文献、输出结构及发布版本信息。
3. 附带 Tier-3 评估数据及针对本次审核版本的 BENCHMARK.md。
4. 对经审核的技能目录进行数字签名，并发布 skill.oms.sig 文件。
5. 使用预期证书链验证已发布的目录完整性。

若上述发布制品缺失，则不得宣称本技能已获 NVIDIA 认证。

相关资源

• 端点与审批契约（Endpoint and approval contract）
• 技能卡片（Skill card）
• Hermes Tweet 代码仓库（Hermes Tweet repository）
• Hermes Agent 插件指南（Hermes Agent plugin guide）
• Xquik Hermes Tweet 指南（Xquik Hermes Tweet guide）