qq-farm-bot-vision
QQクラシック農場ロボット（AIビジョン版）
CVビジョンマッチングに基づく初版はすでに開発完了、Alaph版がリリース済み、注意：これは初期テスト版であり、機能は不完全で継続的に開発・最適化中、主に一部ユーザーに試用してもらい、バグテストや意見収集を目的としています。
試用中に問題があればissueを提出してください：issue問題区
技術交流はDiscordへどうぞ：農民交流频道
以下はCV版の展開と試用方法です
備考：これはテスト版で多くの問題や機能不足がありますので、dockerやexeなどのワンクリックインストール・デプロイ方法は提供しておらず、ソースコードからの起動方法のみ提供しています。一定の技術基盤があり、新しいものを試したいユーザー向けです。今後、バージョンが十分に更新・安定したらワンクリックデプロイ方法を提供予定です。ご理解ください。
❗ 使用前に必読：
- 現バージョンはゲームウィンドウが常に最前面にある必要がありますが、遮蔽は可能です
- 現バージョンには初版のGUIインターフェースがあり、使用したい場合は
python main_gui.py を起動してください
- 現バージョンは
自動収穫、自動除草/駆除/水やり、自動植え付け（テスト中）、自動盗み、自動支援除草/駆除/水やり、毎日無料肥料の自動受け取り機能を実装済みで、関連機能は継続的にテスト・最適化中です
- 画像テンプレートマッチングは様々な要因でマッチしない、誤マッチする場合があるため、使用状況に応じてパラメータの閾値を調整する必要があります。閾値調整方法は以下を参照してください：threshold_adjust.txt
- キーリスニングを設定し、ロボットのショートカット操作を可能にしています。ショートカット：
Ctrl+cで即停止・終了、pで一時停止/再開
---
ブランチ説明
- ### ~~silence-clickブランチ：クリックモードをサイレントクリックに変更し、ゲーム画面は前面にあるもののユーザーのマウス操作を奪わずクリックします。ただし、このモードではアカウント停止のリスクがあるため、使用は自己判断でお願いします。使用した場合はフィードバックを多く頂けると幸いです~~（このブランチはmainに統合済み）
- ### gui-prブランチ：GUIインターフェースのプルリクエスト用ブランチです。プロジェクトのデフォルトGUIはシンプルなので、良いGUIデザインがあればこのブランチへPRしてください（現時点では未投稿）
---
GUIインターフェース表示
システム要件
- Windows 10以上のOS（Linuxなど他OSは未対応）
- ローカルにPython（conda環境推奨）をインストール済み、Pythonバージョンは3.9以上
- NTアーキテクチャのデスクトップ版QQがインストールされており、農場ページが開けること
展開・試用手順
- 1、
git cloneで本プロジェクトをローカルに取得し、PC版QQにログイン
- 2、プロジェクトのルートディレクトリでターミナルを開く（任意でconda環境切替）、コマンド
pip install -r requirement.txt で依存パッケージをインストール
- 3、ルートディレクトリの
config.ini 設定ファイルを確認し、必要に応じて設定項目を変更
- 4、コマンド
python main.py でロボットを起動し、ターミナルで正常起動を確認（GUI版起動は python main_gui.py）
- 5、農場ゲームのウィンドウを開く（現バージョンはゲームウィンドウが遮蔽されない状態にする必要あり）
- 6、プログラムが自動でマウスを操作し、各種機能を自動化
---
今後の開発計画
- ~~初版はcvベースの画像マッチングモードで収穫、駆除、除草機能を実装（まずは簡易版を素早く提供し、移行期間として利用可能に）~~（実装済み）
- ~~GUIインターフェースの追加、使いやすさ向上~~（実装済み）
- CVマッチングバージョンの機能最適化と問題修正（進行中）
- 画面データセットの収集：クリーニング処理、アノテーション、増強
- yoloニューラルネットワークに基づく物体検出モデルのトレーニング
- ニューラルネットワークを使用して各種アイコンをより正確かつ豊富に認識し、機能を充実させる（野菜の栽培、収穫、盗み、耕作など）
あなたのstar⭐が私の更新の原動力です
まずはプロジェクトに関心を持ちstar⭐を付けていただきありがとうございます。ただ私自身は普段は仕事をしており、暇な時間や勤務後にしか更新やメンテナンスができません。また本プロジェクトはゼロからのスタートのため進捗が遅く、コードの品質もやや低いかもしれません。ご理解いただけると幸いです。皆様からのPRを歓迎し、プロジェクトの貢献者になっていただければと思います。最後に開発状況は随時更新しますので、しばらくお待ちください。
免責事項 ❗
本プロジェクトは研究、学習、AIおよびコンピュータビジョン技術の応用交流を目的としたものであり、永続的にオープンソースかつ無料で提供します。いかなる者も本プロジェクトの二次開発、パッケージ化、販売、宣伝などの違法行為を禁止します。また、本プロジェクトの使用はゲームサービス規約に違反しアカウント停止などのペナルティを受ける可能性があります。本コードを使用する場合、上記情報を了承したものとみなします。これにより生じる一切の責任は使用者が負い、作者は関与しません。
---
Tranlated By
Open Ai Tx | Last indexed: 2026-07-11
---