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
@@ -0,0 +1,40 @@
|
||||
import Foundation
|
||||
|
||||
/// スキャン対象の写真1枚。ファイル URL を同一性とする。
|
||||
struct PhotoAsset: Identifiable, Hashable, Sendable {
|
||||
var id: URL { url }
|
||||
|
||||
let url: URL
|
||||
let fileSize: Int64
|
||||
let modificationDate: Date
|
||||
|
||||
/// EXIF の撮影日時。無ければファイルの作成日。
|
||||
var captureDate: Date?
|
||||
var pixelWidth: Int
|
||||
var pixelHeight: Int
|
||||
|
||||
var fileName: String { url.lastPathComponent }
|
||||
|
||||
/// 画素数。代表選出の第一基準。
|
||||
var pixelCount: Int { pixelWidth * pixelHeight }
|
||||
|
||||
var dimensionText: String {
|
||||
pixelWidth > 0 && pixelHeight > 0 ? "\(pixelWidth) × \(pixelHeight)" : "—"
|
||||
}
|
||||
|
||||
var fileSizeText: String {
|
||||
ByteCountFormatter.string(fromByteCount: fileSize, countStyle: .file)
|
||||
}
|
||||
|
||||
var captureDateText: String {
|
||||
guard let captureDate else { return "—" }
|
||||
return PhotoAsset.displayDateFormatter.string(from: captureDate)
|
||||
}
|
||||
|
||||
private static let displayDateFormatter: DateFormatter = {
|
||||
let f = DateFormatter()
|
||||
f.dateStyle = .medium
|
||||
f.timeStyle = .short
|
||||
return f
|
||||
}()
|
||||
}
|
||||
@@ -0,0 +1,90 @@
|
||||
import Foundation
|
||||
|
||||
/// 類似判定の厳しさ。UI の3段階と検出パラメータを結び付ける。
|
||||
enum Sensitivity: String, CaseIterable, Identifiable, Sendable {
|
||||
case strict
|
||||
case standard
|
||||
case loose
|
||||
|
||||
var id: String { rawValue }
|
||||
|
||||
var label: String {
|
||||
switch self {
|
||||
case .strict: return "厳しい"
|
||||
case .standard: return "標準"
|
||||
case .loose: return "ゆるい"
|
||||
}
|
||||
}
|
||||
|
||||
var help: String {
|
||||
switch self {
|
||||
case .strict: return "コピーやリサイズなど、ほぼ同じ写真だけを検出します"
|
||||
case .standard: return "リサイズ・再圧縮された同じ写真と、連写の近いカットを検出します"
|
||||
case .loose: return "トリミングされた版や、似た構図の別カットも検出します"
|
||||
}
|
||||
}
|
||||
|
||||
/// Vision の feature print 距離のしきい値。これ未満なら「似ている」。
|
||||
///
|
||||
/// 実写画像で計測した距離の目安（`docs/calibration.md` 参照）:
|
||||
/// 再エンコード 0.00 / 50%縮小 0.05 / 低画質 0.12 / 25%縮小 0.16 /
|
||||
/// 連写 0.01 / 同一シーンの別カット 0.02〜0.04 / トリミング 0.42〜0.48 /
|
||||
/// 無関係な写真 1.38 以上。
|
||||
var featurePrintThreshold: Double {
|
||||
switch self {
|
||||
case .strict: return 0.20 // 25%まで縮小された版までを拾う
|
||||
case .standard: return 0.30 // 縮小・再圧縮・連写まで。トリミングは拾わない
|
||||
case .loose: return 0.55 // トリミング版まで拾う。無関係な写真とはなお十分離れている
|
||||
}
|
||||
}
|
||||
|
||||
/// dHash のハミング距離のしきい値。ここを通ったペアだけ feature print で精査する。
|
||||
///
|
||||
/// 同じ計測でのハミング距離: 縮小・低画質 1〜5 / トリミング 9〜17 / 無関係 22〜27。
|
||||
var hammingThreshold: Int {
|
||||
switch self {
|
||||
case .strict: return 8
|
||||
case .standard: return 12
|
||||
case .loose: return 20
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
struct ScanSettings: Equatable, Sendable {
|
||||
var includesSubfolders = true
|
||||
var sensitivity: Sensitivity = .standard
|
||||
}
|
||||
|
||||
/// スキャンの進捗。UI にそのまま表示する。
|
||||
struct ScanProgress: Equatable, Sendable {
|
||||
enum Phase: Equatable, Sendable {
|
||||
case scanning
|
||||
case hashing
|
||||
case fingerprinting
|
||||
case comparing
|
||||
case grouping
|
||||
|
||||
var label: String {
|
||||
switch self {
|
||||
case .scanning: return "フォルダを走査中"
|
||||
case .hashing: return "重複を判定中"
|
||||
case .fingerprinting: return "画像の特徴を計算中"
|
||||
case .comparing: return "類似度を比較中"
|
||||
case .grouping: return "グループにまとめ中"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
var phase: Phase
|
||||
var completed: Int = 0
|
||||
var total: Int = 0
|
||||
|
||||
var fractionCompleted: Double? {
|
||||
guard total > 0 else { return nil }
|
||||
return min(1, Double(completed) / Double(total))
|
||||
}
|
||||
|
||||
var detailText: String {
|
||||
total > 0 ? "\(completed) / \(total)" : ""
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
import Foundation
|
||||
|
||||
/// 似ていると判定された写真のまとまり。必ず2枚以上を含む。
|
||||
struct SimilarityGroup: Identifiable, Hashable, Sendable {
|
||||
/// 代表写真とメンバーの関係。
|
||||
enum Relation: Hashable, Sendable {
|
||||
/// バイト単位で完全に同一。
|
||||
case exact
|
||||
/// 見た目が似ている。距離は Vision の feature print 由来で 0 に近いほど似ている。
|
||||
/// 画像をデコードできず距離を出せなかった場合は nil。
|
||||
case similar(distance: Double?)
|
||||
|
||||
var isExact: Bool {
|
||||
if case .exact = self { return true }
|
||||
return false
|
||||
}
|
||||
|
||||
/// 並べ替え用。完全同一を最優先、距離不明は最後に回す。
|
||||
var sortKey: Double {
|
||||
switch self {
|
||||
case .exact: return -1
|
||||
case .similar(let d): return d ?? .greatestFiniteMagnitude
|
||||
}
|
||||
}
|
||||
|
||||
var distanceText: String {
|
||||
switch self {
|
||||
case .exact: return "完全同一"
|
||||
case .similar(let d?): return String(format: "距離 %.3f", d)
|
||||
case .similar(nil): return "類似"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
struct Member: Identifiable, Hashable, Sendable {
|
||||
var id: URL { asset.id }
|
||||
let asset: PhotoAsset
|
||||
let relation: Relation
|
||||
|
||||
/// 代表以外にもバイト単位で同じファイルがある場合の目印（"A", "B" …）。
|
||||
/// 単独なら nil。同じ印どうしは中身が完全に同じなので、どれを消しても失われるものはない。
|
||||
var exactSetTag: String?
|
||||
}
|
||||
|
||||
/// 1回のスキャン結果の中で代表は一意なので、そのまま識別子に使う。
|
||||
var id: URL { representativeID }
|
||||
|
||||
/// 代表を先頭とし、以降は代表に近い順。
|
||||
let members: [Member]
|
||||
let representativeID: URL
|
||||
|
||||
var representative: PhotoAsset {
|
||||
members.first(where: { $0.id == representativeID })?.asset ?? members[0].asset
|
||||
}
|
||||
|
||||
/// 全メンバーが代表と完全同一なら true。混在していれば false。
|
||||
var isAllExact: Bool {
|
||||
members.allSatisfy { $0.id == representativeID || $0.relation.isExact }
|
||||
}
|
||||
|
||||
var kindText: String { isAllExact ? "完全同一" : "類似" }
|
||||
|
||||
var totalBytes: Int64 { members.reduce(0) { $0 + $1.asset.fileSize } }
|
||||
|
||||
/// 代表1枚を残した場合に削減できるバイト数。
|
||||
var reclaimableBytes: Int64 { totalBytes - representative.fileSize }
|
||||
|
||||
var totalBytesText: String {
|
||||
ByteCountFormatter.string(fromByteCount: totalBytes, countStyle: .file)
|
||||
}
|
||||
|
||||
var reclaimableBytesText: String {
|
||||
ByteCountFormatter.string(fromByteCount: reclaimableBytes, countStyle: .file)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user