mcpField
H
hermes-qq

hermes-qq

github.com/chujianyunエージェントワークフロー74766 回インストール2 週間前に更新
リポジトリ

hermes-qq について

Hermes Agent の正式な main コードに QQ チャネル対応を加えるインストールスキルです。hermes-agent リポジトリと作業ツリーを確認してからスクリプトでパッチを適用し、対象テストの実行を案内します。

主な機能

  1. 01対象リポジトリとローカル変更を確認
  2. 02スクリプトで QQ パッチを適用
  3. 03QQ のテキストや複数のファイル形式に対応
  4. 04対象テストのコマンドを提示
  5. 05パッチ箇所が異なる場合は差分確認を促す

活用シーン

  1. 01Hermes Agent main に QQ チャネルを追加
  2. 02QQ でテキスト、画像、音声、動画、ファイルを送信
  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 対応