# 方眼Diff

2つの Excel データ（シート／ブック／フォルダ）を比較し、差分を色付きの Excel と
レポートで提示するツールです。行や列の挿入・削除・移動があっても、キー列の指定
なしで実用精度の対応付けを自動で行います。

Java 版「方眼Diff」（〜v0.27）の後継です。

詳細は公式サイトをご覧ください： https://hogandiff.hotchpotch.xyz/

## 特徴

- 誰でも簡単かつ直感的に利用できます。
- 行や列の挿入・削除・移動によるギャップを自動で検出し、差分セルを着色した
  Excel ファイルと比較結果レポートを出力します。
- 特定のシート同士、ブック同士、フォルダ同士（サブフォルダを含む再帰比較も可）を
  比較できます。
- セルの内容が数式の場合、数式文字列／計算結果の値のどちらで比較するかを選べます。
- パスワード保護された Excel ブックの比較に対応しています。
- .xls / .xlsx / .xlsm 形式に対応しています。異なる形式のファイル同士を比較する
  こともできます。
- デスクトップアプリ（GUI）としての利用に加えて、コマンドライン（CLI）による
  自動化や、AI アシスタントとの連携（MCP サーバ）にも対応しています。

## 出来ないこと

- 比較できるのはセルの内容（値または数式）とセルコメントです。それ以外の一切、
  例えばフォントの種類、セル背景色、図形、グラフなどを比較することはできません。
- .xlsb 形式の Excel ファイルには対応していません。また、ワークシート以外のシート
  （グラフシートやダイアログシートなど）には対応していません。
- 方眼Diff はシンプルで使いやすいことを最重視して設計されています。Excel は高機能な
  アプリケーションであり世界中で様々な用途や方法で利用されているため、方眼Diff が
  対応できない場合があります。

## 動作環境

- Windows 10（バージョン 1607 以降）／ Windows 11
  ※ Arm 版 Windows は Windows 11 のみ対応です。
- macOS 14 (Sonoma) 以降（Apple Silicon / Intel）

.NET ランタイム等の追加インストールは不要です。比較の実行に Microsoft Excel は
不要です。

方眼Diff は比較結果を Excel ブック（.xlsx / .xls）として出力します。これらの
ファイルを表示するためのアプリケーションがお使いの PC に必要です。

## 同梱物と3つの使い方

配布パッケージには次の実行ファイルが含まれています（フォルダ内のその他のファイル
は動作に必要なライブラリ等です。配置はそのままでお使いください）。

| 実行ファイル | 用途 |
|---|---|
| `方眼Diff.exe` | デスクトップアプリ（通常はこちら） |
| `hogandiff.exe` | コマンドライン（CLI）。TortoiseGit 等の外部 diff ツール連携や自動化に |
| `hogandiff-mcp.exe` | MCP サーバ。Claude などの AI アシスタントから比較を実行 |

※ macOS 版は、デスクトップアプリが `方眼Diff.app`、CLI・MCP が拡張子なしの同名です。

### デスクトップアプリ（GUI）

`方眼Diff.exe` をダブルクリックして起動し、画面の項目に従って比較対象を指定
して「実行」を押してください。ショートカットをデスクトップ等に作成しておくと
便利です。

### コマンドライン（CLI）

比較対象のパス2つをパラメータに与えて起動できます。各種オプションも指定できます。

```
> hogandiff.exe <Excelファイル or フォルダ1> <Excelファイル or フォルダ2> [オプション]
```

オプションの一覧は `hogandiff.exe --help` または公式サイトをご覧ください。

### AI 連携（MCP サーバ）

`hogandiff-mcp.exe` を MCP 対応の AI クライアント（Claude Desktop、Claude Code、
各種エディタなど）に登録すると、AI との対話を通じて比較の実行・差分の深掘り・
比較条件の調整ができます。設定方法は公式サイトをご覧ください。

## インストール方法

### Windows の場合

ダウンロードした zip ファイルを解凍し、フォルダごとお好きな場所に配置するだけで
利用できます。フォルダの内容はそのままでご利用ください（実行ファイルだけを別の
場所に取り出すと正常に動作しません）。

未署名のアプリケーションのため、初回起動時に SmartScreen 等の警告が表示される
場合があります。

### macOS の場合

インストール手順は公式サイトをご覧ください。

## アンインストール方法

配置したフォルダを丸ごと削除してください。

設定ファイルや作業用フォルダも含めて完全に削除する場合は、次のフォルダも削除して
ください（既定の場所の例）。

- 設定：`%APPDATA%\xyz.hotchpotch.hogandiff`（Windows）／
  `~/Library/Application Support/xyz.hotchpotch.hogandiff`（macOS）
- 作業用フォルダ（比較結果の出力先）：`%LOCALAPPDATA%\xyz.hotchpotch.hogandiff`（Windows）／
  `~/Library/Application Support/xyz.hotchpotch.hogandiff`（macOS）
  ※作業用フォルダの場所を変更している場合はその場所

## 通信について

方眼Diff は次の目的で外部サーバと通信することがあります。いずれも設定画面から
無効にできます。

- 更新確認：新しいバージョンの有無を確認するため、公式サイトからバージョン情報を
  取得します。
- エラー情報の送信：品質改善のため、エラー発生時にその内容を送信します。

取り扱う情報の詳細はプライバシーポリシーをご覧ください：
https://hogandiff.hotchpotch.xyz/privacypolicy/

## ライセンス

方眼Diff は nmby の著作物です。同梱の EULA.txt（ソフトウェア使用許諾契約書）を
ご確認のうえご利用ください。本ソフトウェアを使用することにより、EULA に同意した
ものとみなされます。個人・商用を問わず無償でご利用いただけます。

方眼Diff には第三者著作物（ソフトウェアおよびフォント）が含まれています。その
一覧と各ライセンス条件は同梱の THIRD-PARTY-NOTICES.txt をご参照ください。

## 連絡先

- website : https://hogandiff.hotchpotch.xyz/
- e-mail  : hogandiff@hotchpotch.xyz
