Photochk 1.0.0 — 類似写真を探して整理する macOS アプリ

フォルダ内の写真から、中身が同じものと見た目が似ているものを検出してグループにまとめ、残す1枚を選んでほかをゴミ箱へ送れるようにする。検出は安い判定から順に4段: - ファイルサイズが同じものだけ SHA-256 でバイト一致を確定 - dHash（知覚ハッシュ）のハミング距離で候補ペアを抽出 - 候補に出てくる画像だけ Vision の feature print で精査 - Union-Find で連結成分をグループ化判定のしきい値は実写画像で距離を実測して決めた（docs/calibration.md）。 tools/release-update.sh で Gitea のリリースを更新する。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-28 08:02:14 +09:00
commit c7f68b6cca
38 changed files with 3102 additions and 0 deletions
@@ -0,0 +1,73 @@
+import AppKit
+import Foundation
+
+/// フォルダの選択と、サンドボックス下でのアクセス権の保持を担う。
+///
+/// `NSOpenPanel` で選んだフォルダは配下ごとアクセスが許可される。security-scoped bookmark を
+/// 保存しておくと、次回起動時に同じフォルダをそのまま開き直せる。
+@MainActor
+final class FolderAccess {
+    private static let bookmarkKey = "lastFolderBookmark"
+
+    private var accessedURL: URL?
+
+    /// フォルダ選択パネルを出す。キャンセルされたら nil。
+    func choose(startingAt current: URL?) -> URL? {
+        let panel = NSOpenPanel()
+        panel.canChooseFiles = false
+        panel.canChooseDirectories = true
+        panel.allowsMultipleSelection = false
+        panel.prompt = "このフォルダを調べる"
+        panel.message = "似た写真を探すフォルダを選んでください"
+        if let current { panel.directoryURL = current }
+
+        guard panel.runModal() == .OK, let url = panel.url else { return nil }
+        beginAccess(to: url)
+        saveBookmark(for: url)
+        return url
+    }
+
+    /// 前回のフォルダを復元する。無ければ nil。
+    func restorePrevious() -> URL? {
+        guard let data = UserDefaults.standard.data(forKey: Self.bookmarkKey) else { return nil }
+
+        var isStale = false
+        guard let url = try? URL(
+            resolvingBookmarkData: data,
+            options: .withSecurityScope,
+            relativeTo: nil,
+            bookmarkDataIsStale: &isStale
+        ) else {
+            UserDefaults.standard.removeObject(forKey: Self.bookmarkKey)
+            return nil
+        }
+
+        guard FileManager.default.fileExists(atPath: url.path) else { return nil }
+        beginAccess(to: url)
+        if isStale { saveBookmark(for: url) }
+        return url
+    }
+
+    func releaseAccess() {
+        accessedURL?.stopAccessingSecurityScopedResource()
+        accessedURL = nil
+    }
+
+    // MARK: - 内部
+
+    private func beginAccess(to url: URL) {
+        releaseAccess()
+        if url.startAccessingSecurityScopedResource() {
+            accessedURL = url
+        }
+    }
+
+    private func saveBookmark(for url: URL) {
+        guard let data = try? url.bookmarkData(
+            options: .withSecurityScope,
+            includingResourceValuesForKeys: nil,
+            relativeTo: nil
+        ) else { return }
+        UserDefaults.standard.set(data, forKey: Self.bookmarkKey)
+    }
+}