mcpField
H
hermes-qq

hermes-qq

github.com/chujianyunAgent workflows74766 installsUpdated 2w ago
Repository

About hermes-qq

An installer skill that adds QQ channel support to the official main code of Hermes Agent, for use in a hermes-agent repository. It checks the repository and working tree before applying a script-based patch, then recommends targeted tests.

Key features

  1. 01Checks the target repository and local changes
  2. 02Applies the QQ patch with a script
  3. 03Supports QQ text and multiple file types
  4. 04Provides targeted test commands
  5. 05Calls for diff review if patch anchors differ

Use cases

  1. 01Add a QQ channel to Hermes Agent main
  2. 02Send text, images, audio, video, or files through QQ
  3. 03Run targeted tests after patching
  4. 04Handle repositories that differ from the expected version

Install

Copy the command and run it in a terminal.

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

After installing, type/hermes-qqin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project 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，再手动审查差异后补丁。

Comments

Markdown supported