企业官网建设流程全解析

Hermes Tweet：为 Hermes Agent 打造 Read-First、审批门控的 X/Twitter 研究与操作插件

【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents

导读

Hermes Tweet 是 agents24/agents 插件市场生态中一个聚焦 X/Twitter 的 Hermes Agent 插件：它通过tweet_explore、tweet_read、tweet_action三个工具，为社交聆听、账号调研、上线信号监控、支持工单分类和抽奖审计等场景提供 Hermes 原生工具集，并默认采用"只读优先、变更需审批"的操作模型。读完本文，你将掌握该插件的安装与配置、三工具职责边界、审批门控契约，以及四类可落地的实战工作流模式。

插件定位与设计哲学

Hermes Tweet 为 Hermes Agent 增加了一组 X/Twitter 研究工具，适用于社交聆听（social listening）、账号研究、上线监控、支持分类、抽奖审计，以及"私有或状态变更操作保持显式受控"的工作流。

其核心设计哲学是只读优先（read-first）与审批门控（approval-gated）：

• 默认场景下，所有公开的只读研究都可以直接执行；
• 任何私有读取或状态变更操作（发帖、私信、监控、Webhook、抽取任务、抽奖、媒体操作）都必须显式审批后才会执行；
• 插件由hermes-tweet包及支撑其读写路由的 Xquik API 的维护者提交（见 plugins/hermes-tweet/README.md 中的 Disclosure 声明），因此文档与实现保持一致。

从 docs/plugins.md 可以看到，本仓库中每个插件通常由agents/、commands/、skills/三部分组成；Hermes Tweet 的组件位于 plugins/hermes-tweet/skills/hermes-tweet/ 下，包含一份可移植的 skill 主文档（SKILL.md）与两份参考文档（references/endpoint-contract.md、references/workflows.md），形成"说明书 + 边界契约 + 工作流模板"的完整文档体系。

工具模型：三个工具的分工与安全边界

插件通过三个工具覆盖从"离线发现"到"在线只读"再到"门控变更"的完整链路。以下矩阵来自 plugins/hermes-tweet/skills/hermes-tweet/references/endpoint-contract.md，适用于 CLI、Desktop、dashboard、gateway、定时任务及委派等所有 Hermes Agent 会话形态：

• tweet_explore：无凭据的本地路由发现。它读取随插件打包的路由目录（catalog），用于在调用前检索可用的 X/Twitter 读写路由，不消耗 API Key、不发起网络请求。
• tweet_read：仅在设置XQUIK_API_KEY后可用，调用目录中列出的公开只读端点（账号、推文、趋势、监控、搜索等数据）。
• tweet_action：仅在启用 action 门控后可用，处理写入、私有读取、监控、Webhook、抽取任务、抽奖与媒体操作。

理解这一模型的要点在于：tweet_explore只读本地目录，tweet_read只接受目录中列出的公开只读路由，tweet_action则承载所有"会产生副作用"的操作——三者边界清晰，从工具层面就防止了凭据缺失时的误用与越权调用。

环境准备：安装与配置

安装插件

在 Hermes 运行时上安装并启用插件：

hermes plugins install Xquik-dev/hermes-tweet --enable

Hermes 在安装和更新期间都会扫描插件，请逐一审阅每个警告；危险的裁决会阻止安装或禁用更新。

配置环境变量

在 Hermes 运行时主机上设置 API Key 与门控开关：

export XQUIK_API_KEY="<your-key>" export HERMES_TWEET_ENABLE_ACTIONS="false"

• XQUIK_API_KEY：tweet_read与tweet_action的前置条件，缺失时只有tweet_explore可用；
• HERMES_TWEET_ENABLE_ACTIONS：门控开关。只读优先的会话应保持false；仅当执行一次已获批的私有读取、写入、监控、Webhook、抽取、绘图或媒体操作时，才临时设为true。

API Key 应始终存放在环境变量或 Hermes 运行时 env 文件中，严禁粘贴进提示词、Issue、PR 评论或工具输入中。

输入清单

在执行路由选择前，向用户确认以下输入（来自 SKILL.md）：

• 目标：research（研究）、monitoring（监控）、support triage（支持分类）、giveaway audit（抽奖审计）或 action prep（操作准备）；
• 对象：账号 handle、推文 URL、关键词、列表、监控项或趋势；
• 时间窗口与新鲜度需求；
• 本次是否涉及私有或状态变更操作；
• 确认 Hermes 运行时已配置XQUIK_API_KEY。

运行时检查

配置完成后，可用如下命令核对工具是否按预期出现（见 endpoint-contract.md）：

hermes plugins list hermes tools list

确认三条规则成立：tweet_explore在无XQUIK_API_KEY时依然可用；tweet_read仅在配置 Key 后出现；tweet_action只有显式设置HERMES_TWEET_ENABLE_ACTIONS=true后才可用。环境变量变更后需要重新加载活跃的 CLI 会话；Gateway 场景下执行hermes gateway restart并开启新的 gateway 会话。SKILL.md 元数据标注该 skill 版本为 0.1.13、License 为 MIT（见 SKILL.md）。

操作工作流：从探索到审批执行

六步标准流程

1. 用tweet_explore检索随插件打包的路由目录，找到匹配的路由；
2. 选定目录路由后，通过tweet_read读取公开的 X/Twitter 数据；
3. 仅在获得明确审批后，用tweet_action执行私有或状态变更路由；
4. 将 API Key 保存在环境变量或 Hermes 运行时 env 文件中；
5. 不向提示词、Issue、PR 评论或工具输入中粘贴凭据；
6. 当用户需要的是活动（campaign）、监控（monitor）、支持（support）或抽奖（giveaway）流程而非单次读取时，加载 工作流模式。

审批检查清单

调用tweet_action前，必须逐项陈述并确认（来自 endpoint-contract.md）：

1. 目录中列出的端点和 HTTP 方法；
2. 目标账号或工作流；
3. 完整载荷（不含凭据）；
4. 预期的副作用及其理由；
5. 用户对该次操作的明确批准。

一次操作的审批不代表自动授权重试、关联操作或未来的定时运行；遇到策略、认证、校验或账号状态类失败时应立即停止。

输出格式与使用示例

输出格式

返回简明可操作的结果（来自 SKILL.md）：

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 }

四类实战工作流模式

当用户请求超出单次路由查询时，按 references/workflows.md 中定义的四类模式执行：

社交聆听（Social Listening）

1. 用tweet_explore搜索 search、trend、radar、monitor 类路由；
2. 对公开只读路由使用tweet_read；
3. 创建或修改监控前，先用tweet_action请求审批；
4. 按主题、账号、链接和时效性对结果分组；
5. 信号不完整时推荐后续只读路由。

支持分类（Support Triage）

1. 读取提及、账号上下文及相关推文线程；
2. 在不暴露凭据或私有运行时数据的前提下总结用户问题；
3. 将回复草拟与 action 调用分离；
4. 任何私有读取、回复、DM、关注或 Webhook 操作前都必须获得明确审批。

抽奖审计（Giveaway Audit）

1. 读取原始推文、回复、转发、粉丝与公开列表；
2. 保留路由路径与结果摘要的证据链；
3. 私有读取、抽取任务或抽奖前先请求审批；
4. 公开只读证据收集完成后，再给出候选的下一步操作。

受控发布（Controlled Publishing）

1. 确认本次会话设置HERMES_TWEET_ENABLE_ACTIONS=true是有意为之；
2. 起草内容并确认精确的tweet_action路由；
3. 执行前展示媒体、回复、排期或账号变更的输入；
4. 等待审批后，仅调用已获批的那条路由。

故障排查

• 只有tweet_explore出现：在 Hermes 运行时主机上配置XQUIK_API_KEY，然后重新加载或重启当前 Hermes 会话；
• action 路由不可用：保持公开读取独立进行，仅在获批的私有或状态变更操作时设置HERMES_TWEET_ENABLE_ACTIONS=true；
• 路由不匹配：再次运行tweet_explore，选择目录中列出的路径，而不是猜测端点。

最佳实践

• 将 Hermes Tweet 视为Hermes 原生的 X/Twitter 层，而非通用 API 包装器；
• 默认保持研究只读，创建或修改监控前必须审批；
• 私有或状态变更调用前，使用 Desktop 或 gateway 操作者审查；
• 调用tweet_read/tweet_action前，核对精确的目录路径；
• 环境变量变更后，重启 gateway、cron 或长驻 Hermes 会话。

与其他插件的协同

本仓库中的 social-publishing 插件可与之互补：后者面向跨 13 个平台（X、LinkedIn、Instagram、Facebook Pages、TikTok、Discord、Telegram、YouTube、Reddit、WordPress、Pinterest 等）的多平台发布编排，而 Hermes Tweet 聚焦 Hermes Agent 的 X/Twitter 工具集及其"只读优先、审批门控"的运行模型。二者分工不同：需要广泛多平台发布时选用 social-publishing，需要受控的 X/Twitter 研究与门控操作时使用 Hermes Tweet。

参考文件速查

• 插件主文档：plugins/hermes-tweet/README.md
• 可移植 skill 主文档：plugins/hermes-tweet/skills/hermes-tweet/SKILL.md
• 端点与审批边界契约：plugins/hermes-tweet/skills/hermes-tweet/references/endpoint-contract.md
• 工作流模式：plugins/hermes-tweet/skills/hermes-tweet/references/workflows.md
• 插件市场总览与插件结构说明：docs/plugins.md

【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents