DeepCompare

概要

DeepCompare は、Python で実装されたシンプルなコード比較ツールです。 MiniLM モデル (sentence-transformers/paraphrase-MiniLM-L6-v2) を活用し、 2 つのソースコードファイルの行ごとの意味的類似度を計算し、動的計画法を用いた最適な行アライメントを行います。 GUI は PyQt6 を使用し、直感的に操作できるシンプルなインターフェースを提供します。

---

特徴

DeepCompare は、従来の文字ベースの比較ツールとは異なり、言語モデルを活用してコードの意味的な類似性を評価できる 点が特徴です。大規模な比較ツールと比べるとシンプルな設計ですが、手軽にコードの差分を確認する用途に適しています。

1. 行単位の意味的類似性評価

各ファイルの行を MiniLM によりベクトル化し、コサイン類似度を計算することで、既存のコンペアツールでは捉えにくい意味的な類似性を考慮した比較が可能です。

2. 最適アライメントの採用

Needleman–Wunsch アルゴリズムを使用し、コサイン類似度スコアを考慮しながら 2 つのファイル間の最適な対応を決定。これにより、変更箇所を整理し、より分かりやすく表示します。

3. 文字レベルの差分ハイライト

差分がある行は背景色で強調表示され、行内の差分部分はオレンジ色で視認性を向上させています。

4. シンプルで使いやすい GUI

• ダークテーマ対応
• フレームレスウィンドウ
• ドラッグ＆ドロップによるファイル選択
• ウィンドウのリサイズ対応

---

必要な環境・依存ライブラリ

• Python 3.7 以降
• sentence-transformers
• PyQt6

インストール方法

# リポジトリをクローン
$ git clone https://github.com/monyuonyu/DeepCompare.git
$ cd DeepCompare

# 仮想環境を作成
$ python -m venv .venv

# 仮想環境を有効化

   - Windows:
     .venv\Scripts\activate

   - macOS/Linux:
     source .venv/bin/activate

# 依存ライブラリをインストール
$ pip install -r requirements.txt

---

使い方

GUI モード

python DeepCompare.py

または Windows の場合、launch.bat をダブルクリックすることで起動可能。

コマンドライン引数を使用

python DeepCompare.py path/to/file1.py path/to/file2.py

起動時に比較するファイルを指定することで、GUI の起動後自動で読み込まれ比較が実行されます。

---

プロジェクト構成

DeepCompare/
├── DeepCompare.py         # メインプログラム
├── launch.bat            # Windows 用起動スクリプト
├── requirements.txt      # 依存ライブラリ一覧
├── .gitignore            # Git の追跡対象外ファイル
├── README.md             # 説明文書
└── .venv/                # Python 仮想環境