TM(自動化ツール)

Tool

概要

TMはAndroid環境(実機およびエミュレータ)を対象とした自動化ツール群です。主に画像マッチングによる画面要素の検出とタップ実行、仮想キーボードを使った入力、OCRによるテキスト抽出、さらに複数ウィンドウ(インスタンス)を中央で管理する「中控」機能を備えます。雷電やMuMuなどのエミュレータをサポートし、スクリプトの可視化編集や非同期でのマルチ実行を想定した設計が見受けられます。用途はゲーム自動化や操作の反復作業、テスト自動化など多岐にわたります。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 6
  • ファイル数: 12
  • メインの言語: Python

主な特徴

  • 画像検出(テンプレートマッチ)による自動クリックと座標操作
  • ADBベースの入力操作(ADBKeyboard.apk同梱)による安定したキー入力
  • OCR連携で画面上の文字読み取りと条件分岐処理が可能
  • 複数エミュレータインスタンスの中控(集中管理)・非同期実行をサポート

技術的なポイント

TMは主にADB(Android Debug Bridge)と画像処理ライブラリを組み合わせて、画面キャプチャ→画像マッチング→操作(タップ/スワイプ/キー入力)という典型的な自動化フローを実装しています。ADBKeyboard.apkを同梱している点から、物理キーボード入力が難しい環境でも安定したテキスト入力を実現する工夫が見られます。画像検出はOpenCVやPillowなどのライブラリに依存している可能性が高く、テンプレートマッチングや閾値設定、類似度スコアを用いてヒット判定を行う設計です。

OCR機能は画面キャプチャを前処理(リサイズ・二値化など)した上でTesseract等のOCRエンジンに渡す流れが想定され、テキスト抽出をトリガーにした条件分岐やログ出力が可能です。マルチウィンドウ中控は複数のエミュレータインスタンスを同時に操作する仕組みで、非同期・並列実行のためにスレッドや非同期I/O(asyncioなど)を使っている可能性があります。adb_optimization_plan.jsonの存在は、ADBコマンドの最適化や接続管理、タイムアウト設定などを外部定義で調整できる設計思想を示しています。

さらに、リポジトリが「スクリプト可視化編集」を謳っていることから、GUIベースのワークフロー編集器またはスクリプト定義ファイル(JSON/YAML)を読み取って実行するランタイムを備えている可能性が高いです。サンプルやテンプレートを用いることで非エンジニアでも自動化フローを構築できる点が特徴です。一方で、エミュレータ固有の差(解像度やウィンドウ座標系、ADB接続の安定性)への対応や、画像検出の精度向上(閾値チューニング、マルチスケール検出)、OCRの言語・フォント対応などは実運用で注意すべき点です。またライセンス上「商用・違法利用不可」「出典明記」の条件があるため利用用途には留意が必要です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • ADBKeyboard.apk: file(エミュレータ/端末への文字入力補助)
  • LICENSE: file(利用条件:商用・違法利用不可、出典明記)
  • README.md: file(プロジェクト概要と使用例)
  • adb_optimization_plan.json: file(ADBコマンドや接続最適化設定)

…他 7 ファイル

上記以外のファイルは、Pythonスクリプト群や画像テンプレート、依存定義(requirements.txt想定)、短いユーティリティやサンプルスクリプトなどで構成されていることが推測されます。典型的には以下のような役割が含まれます:

  • 実行エントリ(メインスクリプト):フローの読み込みと実行管理
  • 画像テンプレートフォルダ:UI要素のサンプル画像群
  • OCR/画像処理ユーティリティ:キャプチャ→前処理→解析の共通処理
  • マルチウィンドウ管理モジュール:エミュレータインスタンスの登録・制御
  • 設定ファイル群:解像度毎の座標補正やタイムアウト設定

これらにより、ローカル環境での迅速な導入とエミュレータ複数台運用が比較的スムーズに行える構成になっています。導入時はPythonの実行環境、ADBの設定、必要な外部ライブラリ(OpenCV、Pillow、PyTesseractなど)とTesseract本体のインストールを確認すると良いでしょう。

まとめ

エミュレータ中心の画面ベース自動化を手軽に始められるリポジトリ。商用利用は要注意。

リポジトリ情報:

READMEの抜粋: 懒人包可以加群:15740321

image

功能:找图,点击,按键,OCR,多窗口中控等功能 支持模拟器支持雷电模拟器,mumu模拟器

效果预览 雷电模拟器脚本可视化编辑多开异步自带中控免费_游戏热门视频​

本开源项目作者:晚安不晚安啦 2025.10.28 全面开源,本项目使用python语言AI编程软件辅助编写,不得使用任何商业用途以及非法用途吗,使用本项目内的代码需注明出处。

配套python库:https://pan.baidu.com/s/5X3zK