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>

Sources/Photochk/Services/FolderAccess.swift

@@ -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)
+    }
+}

Sources/Photochk/Services/ThumbnailLoader.swift

@@ -0,0 +1,46 @@
+import AppKit
+import Foundation
+import QuickLookThumbnailing
+
+/// サムネイル生成。QuickLook 任せなので HEIC や RAW もそのまま扱える。
+@MainActor
+final class ThumbnailLoader {
+    static let shared = ThumbnailLoader()
+
+    private let cache = NSCache<NSString, NSImage>()
+
+    private init() {
+        cache.countLimit = 600
+    }
+
+    /// すでに読み込み済みなら即座に返す。スクロールで戻ってきたときに
+    /// 一瞬プレースホルダが出るのを防ぐために使う。
+    func cached(for url: URL, size: CGFloat) -> NSImage? {
+        cache.object(forKey: Self.key(url, size))
+    }
+
+    func thumbnail(for url: URL, size: CGFloat) async -> NSImage? {
+        let key = Self.key(url, size)
+        if let cached = cache.object(forKey: key) { return cached }
+
+        let scale = NSScreen.main?.backingScaleFactor ?? 2
+        let request = QLThumbnailGenerator.Request(
+            fileAt: url,
+            size: CGSize(width: size, height: size),
+            scale: scale,
+            representationTypes: .thumbnail
+        )
+
+        guard let representation = try? await QLThumbnailGenerator.shared
+            .generateBestRepresentation(for: request)
+        else { return nil }
+
+        let image = NSImage(cgImage: representation.cgImage, size: representation.contentRect.size)
+        cache.setObject(image, forKey: key)
+        return image
+    }
+
+    private static func key(_ url: URL, _ size: CGFloat) -> NSString {
+        "\(url.path)|\(Int(size))" as NSString
+    }
+}

Sources/Photochk/Services/TrashService.swift

@@ -0,0 +1,30 @@
+import AppKit
+import Foundation
+
+/// 選択されたファイルをゴミ箱へ送る。削除ではないので Finder から戻せる。
+enum TrashService {
+    struct Outcome: Sendable {
+        var trashed: [URL] = []
+        var failed: [URL] = []
+        var errorDescription: String?
+    }
+
+    @MainActor
+    static func moveToTrash(_ urls: [URL]) async -> Outcome {
+        guard !urls.isEmpty else { return Outcome() }
+
+        let (moved, error): ([URL: URL], Error?) = await withCheckedContinuation { continuation in
+            NSWorkspace.shared.recycle(urls) { newURLs, error in
+                continuation.resume(returning: (newURLs, error))
+            }
+        }
+
+        let trashed = urls.filter { moved[$0] != nil }
+        let failed = urls.filter { moved[$0] == nil }
+        return Outcome(
+            trashed: trashed,
+            failed: failed,
+            errorDescription: failed.isEmpty ? nil : error?.localizedDescription
+        )
+    }
+}