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 会话形态工具API Key网络访问Action 门控用户审批tweet_explore不需要不需要不需要不需要tweet_read需要需要不需要公开只读路由不需要tweet_action需要需要需要需要针对该次精确操作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 --enableHermes 在安装和更新期间都会扫描插件请逐一审阅每个警告危险的裁决会阻止安装或禁用更新。配置环境变量在 Hermes 运行时主机上设置 API Key 与门控开关export XQUIK_API_KEYyour-key export HERMES_TWEET_ENABLE_ACTIONSfalseXQUIK_API_KEYtweet_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.mdhermes plugins list hermes tools list确认三条规则成立tweet_explore在无XQUIK_API_KEY时依然可用tweet_read仅在配置 Key 后出现tweet_action只有显式设置HERMES_TWEET_ENABLE_ACTIONStrue后才可用。环境变量变更后需要重新加载活跃的 CLI 会话Gateway 场景下执行hermes gateway restart并开启新的 gateway 会话。SKILL.md 元数据标注该 skill 版本为 0.1.13、License 为 MIT见 SKILL.md。操作工作流从探索到审批执行六步标准流程用tweet_explore检索随插件打包的路由目录找到匹配的路由选定目录路由后通过tweet_read读取公开的 X/Twitter 数据仅在获得明确审批后用tweet_action执行私有或状态变更路由将 API Key 保存在环境变量或 Hermes 运行时 env 文件中不向提示词、Issue、PR 评论或工具输入中粘贴凭据当用户需要的是活动campaign、监控monitor、支持support或抽奖giveaway流程而非单次读取时加载 工作流模式。审批检查清单调用tweet_action前必须逐项陈述并确认来自 endpoint-contract.md目录中列出的端点和 HTTP 方法目标账号或工作流完整载荷不含凭据预期的副作用及其理由用户对该次操作的明确批准。一次操作的审批不代表自动授权重试、关联操作或未来的定时运行遇到策略、认证、校验或账号状态类失败时应立即停止。输出格式与使用示例输出格式返回简明可操作的结果来自 SKILL.mdSummary: - 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用tweet_explore搜索 search、trend、radar、monitor 类路由对公开只读路由使用tweet_read创建或修改监控前先用tweet_action请求审批按主题、账号、链接和时效性对结果分组信号不完整时推荐后续只读路由。支持分类Support Triage读取提及、账号上下文及相关推文线程在不暴露凭据或私有运行时数据的前提下总结用户问题将回复草拟与 action 调用分离任何私有读取、回复、DM、关注或 Webhook 操作前都必须获得明确审批。抽奖审计Giveaway Audit读取原始推文、回复、转发、粉丝与公开列表保留路由路径与结果摘要的证据链私有读取、抽取任务或抽奖前先请求审批公开只读证据收集完成后再给出候选的下一步操作。受控发布Controlled Publishing确认本次会话设置HERMES_TWEET_ENABLE_ACTIONStrue是有意为之起草内容并确认精确的tweet_action路由执行前展示媒体、回复、排期或账号变更的输入等待审批后仅调用已获批的那条路由。故障排查只有tweet_explore出现在 Hermes 运行时主机上配置XQUIK_API_KEY然后重新加载或重启当前 Hermes 会话action 路由不可用保持公开读取独立进行仅在获批的私有或状态变更操作时设置HERMES_TWEET_ENABLE_ACTIONStrue路由不匹配再次运行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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hermes Tweet：为 Hermes Agent 打造 Read-First、审批门控的 X/Twitter 研究与操作插件
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 会话形态工具API Key网络访问Action 门控用户审批tweet_explore不需要不需要不需要不需要tweet_read需要需要不需要公开只读路由不需要tweet_action需要需要需要需要针对该次精确操作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 --enableHermes 在安装和更新期间都会扫描插件请逐一审阅每个警告危险的裁决会阻止安装或禁用更新。配置环境变量在 Hermes 运行时主机上设置 API Key 与门控开关export XQUIK_API_KEYyour-key export HERMES_TWEET_ENABLE_ACTIONSfalseXQUIK_API_KEYtweet_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.mdhermes plugins list hermes tools list确认三条规则成立tweet_explore在无XQUIK_API_KEY时依然可用tweet_read仅在配置 Key 后出现tweet_action只有显式设置HERMES_TWEET_ENABLE_ACTIONStrue后才可用。环境变量变更后需要重新加载活跃的 CLI 会话Gateway 场景下执行hermes gateway restart并开启新的 gateway 会话。SKILL.md 元数据标注该 skill 版本为 0.1.13、License 为 MIT见 SKILL.md。操作工作流从探索到审批执行六步标准流程用tweet_explore检索随插件打包的路由目录找到匹配的路由选定目录路由后通过tweet_read读取公开的 X/Twitter 数据仅在获得明确审批后用tweet_action执行私有或状态变更路由将 API Key 保存在环境变量或 Hermes 运行时 env 文件中不向提示词、Issue、PR 评论或工具输入中粘贴凭据当用户需要的是活动campaign、监控monitor、支持support或抽奖giveaway流程而非单次读取时加载 工作流模式。审批检查清单调用tweet_action前必须逐项陈述并确认来自 endpoint-contract.md目录中列出的端点和 HTTP 方法目标账号或工作流完整载荷不含凭据预期的副作用及其理由用户对该次操作的明确批准。一次操作的审批不代表自动授权重试、关联操作或未来的定时运行遇到策略、认证、校验或账号状态类失败时应立即停止。输出格式与使用示例输出格式返回简明可操作的结果来自 SKILL.mdSummary: - 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用tweet_explore搜索 search、trend、radar、monitor 类路由对公开只读路由使用tweet_read创建或修改监控前先用tweet_action请求审批按主题、账号、链接和时效性对结果分组信号不完整时推荐后续只读路由。支持分类Support Triage读取提及、账号上下文及相关推文线程在不暴露凭据或私有运行时数据的前提下总结用户问题将回复草拟与 action 调用分离任何私有读取、回复、DM、关注或 Webhook 操作前都必须获得明确审批。抽奖审计Giveaway Audit读取原始推文、回复、转发、粉丝与公开列表保留路由路径与结果摘要的证据链私有读取、抽取任务或抽奖前先请求审批公开只读证据收集完成后再给出候选的下一步操作。受控发布Controlled Publishing确认本次会话设置HERMES_TWEET_ENABLE_ACTIONStrue是有意为之起草内容并确认精确的tweet_action路由执行前展示媒体、回复、排期或账号变更的输入等待审批后仅调用已获批的那条路由。故障排查只有tweet_explore出现在 Hermes 运行时主机上配置XQUIK_API_KEY然后重新加载或重启当前 Hermes 会话action 路由不可用保持公开读取独立进行仅在获批的私有或状态变更操作时设置HERMES_TWEET_ENABLE_ACTIONStrue路由不匹配再次运行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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考