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>
This commit is contained in:
yfoxjp
2026-07-28 08:02:14 +09:00
co-authored by Claude Opus 5
commit c7f68b6cca
38 changed files with 3102 additions and 0 deletions
@@ -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
}
}