Add threshold calibration record

docs/calibration.md

@@ -0,0 +1,72 @@
+# しきい値の実測記録
+
+`Sensitivity` のしきい値は当てずっぽうではなく、実写画像で距離を測って決めている。
+判定を変えたくなったらこの手順をなぞって測り直すこと。
+
+## 測定に使った素材
+
+macOS 内蔵の動画壁紙（実写のタイムラプス）からフレームを切り出したものを元画像とした。
+
+| ファイル | 内容 |
+|---|---|
+| `shotA.jpg` | 元画像（1600×900, JPEG） |
+| `A_copy.jpg` | `cp` によるバイト単位の完全コピー |
+| `A_half.jpg` | 50% に縮小 |
+| `A_quarter.jpg` | 25% に縮小 |
+| `A_lowq.jpg` | 同じ寸法で JPEG 品質 25 に再圧縮 |
+| `A_crop.jpg` | 中央 1400×900 にトリミング |
+| `A_rot90.jpg` | ピクセルごと 90 度回転 |
+| `shotA_burst.jpg` | 0.5 秒後のフレーム（連写相当） |
+| `shotB.jpg` / `shotC.jpg` | 30 秒後 / 90 秒後のフレーム（同一シーンの別カット） |
+| `sonoma.jpg` | まったく別の写真 |
+
+## 測定結果（Vision の feature print 距離 / dHash のハミング距離）
+
+`shotA.jpg` を基準にした値。
+
+| 相手 | feature print | ハミング | 判定したい？ |
+|---|---|---|---|
+| 完全コピー・再エンコード | 0.000 | 0 | ○（SHA-256 で先に確定） |
+| 50% 縮小 | 0.049 | 5 | ○ |
+| 低画質 再圧縮 | 0.116 | 1 | ○ |
+| 25% 縮小 | 0.162 | 4 | ○ |
+| 連写（0.5 秒差） | 0.008 | 0 | ○ |
+| 同一シーン 30 秒差 | 0.017 | 6 | ○ |
+| 同一シーン 90 秒差 | 0.039 | 14 | ○ |
+| トリミング | 0.417 | 11 | 「ゆるい」でのみ |
+| 90 度回転 | 0.802 | 28 | ✗（後述） |
+| 無関係な写真 | 1.378 | 24 | ✗ |
+
+## 決めたしきい値
+
+| 段階 | feature print | ハミング | 何が拾えるか |
+|---|---|---|---|
+| 厳しい | 0.20 | 8 | コピー・縮小（25% まで）・再圧縮 |
+| 標準 | 0.30 | 12 | 上記＋連写・同一シーンの近いカット |
+| ゆるい | 0.55 | 20 | 上記＋トリミングされた版 |
+
+「ゆるい」の 0.55 でも無関係な写真の 1.38 とは大きく離れているので、誤検出の余地は小さい。
+当初案の「厳しい = 0.15」では 25% 縮小（0.162）を取りこぼしたため 0.20 に上げた。
+
+## 回転の扱い（意図的な仕様）
+
+dHash も Vision も EXIF の向きを反映してから比較している。つまり **「画面に表示したときの見た目」どうしを比べている**。
+
+- 回転がピクセルに焼き込まれた版と、EXIF の向きタグで回している版 → **距離 0.002 で検出できる**
+  （LINE や AirDrop を経由して向きが焼き込まれた、という現実的なケース）
+- 実際に向きが違う写真どうし（元画像 vs 90 度回転） → **距離 0.80 で検出しない**
+
+後者を拾うには4方向ぶんの特徴量を計算する必要があり、コストが4倍になる割に
+写真整理の用途では出番が少ないため、対応していない。
+
+## 測り直す手順
+
+```bash
+ffmpeg -ss 0 -i "/System/Library/Desktop Pictures/.wallpapers/Tahoe Day/Tahoe Day.mov" -frames:v 1 -vf scale=1600:-1 shotA.jpg
+sips -Z 800 shotA.jpg --out A_half.jpg
+sips -s format jpeg -s formatOptions 25 shotA.jpg --out A_lowq.jpg
+sips -c 900 1400 shotA.jpg --out A_crop.jpg
+```
+
+これらを1つのフォルダに置き、`GenerateImageFeaturePrintRequest`（`cropAndScaleAction = .scaleToFit`）で
+総当たりの距離行列を出す。アプリ本体の `FeaturePrinter.compute(for:)` と同じ設定であることを確認すること。