mcpField
H
hermes-qq

hermes-qq

github.com/chujianyunAgent 工作流74766 次安装2 周前更新
代码仓库

关于 hermes-qq

用于给 Hermes Agent 正式 main 代码添加 QQ 渠道支持的安装 Skill，适用于 hermes-agent 仓库。它会先检查仓库和工作树，再运行补丁脚本，并建议执行指定测试。

主要功能

  1. 01确认目标仓库及本地改动
  2. 02运行脚本应用 QQ 补丁
  3. 03支持 QQ 文本与多种文件发送
  4. 04提供定向测试命令
  5. 05补丁锚点不符时要求审查差异

适用场景

  1. 01为 Hermes Agent main 添加 QQ 渠道
  2. 02向 QQ 发送文本、图片或音视频
  3. 03补丁应用后运行定向测试
  4. 04处理与预期版本不符的仓库

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/chujianyun/skills --skill hermes-qq

安装后在 Claude Code 中输入/hermes-qq确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
qq.py
references/
verification.md
scripts/
install_hermes_qq.py

详细介绍

来自项目 README

Hermes QQ Installer

这个技能用于把 Hermes Agent 的 main 正式代码 补成支持 QQ platform 的版本。

适用场景：

  • 当前仓库是 hermes-agent
  • 用户希望在正式 main 代码上增加 QQ 渠道
  • 需要同时支持 QQ 文本、图片、音频、视频、普通文件发送

不适用场景：

  • 当前仓库不是 hermes-agent
  • 用户只是想分析 QQ adapter 原理，不想改代码
  • 仓库已经是自带 QQ 支持的分支，且不需要再次打补丁

工作流程

  1. 先确认目标仓库是 hermes-agent，并且工作树里没有会冲突的本地改动。
  2. 运行 scripts/install_hermes_qq.py，默认对当前工作目录打补丁。
  3. 如仓库有 venv，优先执行： source venv/bin/activate && python -m pytest tests/gateway/test_platform_base.py tests/gateway/test_extract_local_files.py tests/gateway/test_send_image_file.py tests/cron/test_scheduler.py tests/gateway/test_background_command.py tests/gateway/test_internal_event_bypass_pairing.py -q -n 0
  4. 如果没有现成环境，再按仓库约定补测试环境后执行同一组定向测试。

运行方式

当前目录就是目标 hermes-agent 仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py

指定目标仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent

资源

  • assets/qq.py QQ adapter 完整实现，会被复制到 gateway/platforms/qq.py
  • references/verification.md 安装后建议执行的验证命令

如果脚本提示某个补丁锚点不存在，说明目标仓库已经偏离官方 main 太多。这种情况下不要盲写，先读 references/verification.md，再手动审查差异后补丁。

评论

支持 Markdown