Hermes 推文

为什么需要这个插件

在 Hermes Agent 里做 X/Twitter 自动化，通常得自己写工具定义：搜索接口怎么调、主页信息怎么取、时间线分页怎么处理、发推点赞这类写操作怎么加权限保护。Hermes Tweet 把这些事打包成一个原生 Hermes Agent 插件，后端走 Xquik 的公开集成接口，省掉手写 tool schema 的开销。

它主要解决两个问题：

• 读写风险混在一起：只读的搜索、时间线读取，和会改变账号状态的发推、点赞、删除，风险完全不同，不该用同一套权限逻辑。
• 凭据不能硬编码：XQUIK_API_KEY 走环境变量，不能写进 skill 文本或源码里。

插件如何工作

插件把能力分成两层：

• 只读探索层：X 搜索、主页查询、时间线读取、推文详情查看，这类操作直接可用，适合做社交调研和发布监测。
• 写操作层：推文动作默认关闭，藏在显式启用闸门后面，并要求操作者在工作流里明确确认目标账号和动作类型。

关键步骤：

1. 在 Hermes Agent 环境里配置 XQUIK_API_KEY。
2. 插件调用 Xquik 集成接口完成搜索、读取和推文检查。
3. 只有当工作流明确需要写权限、且操作者已确认账号与动作时，才开启推文动作。

适用边界

• 适合：需要重复性社交调研、发布监测、账号背景调查、受控发布流程的 Hermes 工作流。
• 不适合：想脱离 Hermes Agent 直接调 Xquik 的场景，或不需要 Hermes 环境的轻量脚本。
• 注意：写操作一旦开启就会影响真实 X 账号，触发前务必确认账号和动作内容。