diff --git a/apps/ios/Cook/Model/CloudKitSchema.swift b/apps/ios/Cook/Model/CloudKitSchema.swift index d3ad0f380..c4e031ba5 100644 --- a/apps/ios/Cook/Model/CloudKitSchema.swift +++ b/apps/ios/Cook/Model/CloudKitSchema.swift @@ -14,7 +14,8 @@ // 版本 2 新增 FridgeItem,版本 3 新增 PrivateRecipeRecord。 // 已初始化旧版本的开发设备需要重新建结构。 // 版本 4 为 FridgeItem 添加日期依据、生产日期与储存建议(均可选)。 - static let version = 4 + // 版本 5 新增 FridgeCategory 及 FridgeItem 的可选分类键。 + static let version = 5 /// 成功后记下 version。要强制重建(比如在 Console 里 Reset 了 Development),启动参数加 `-cloudkit.schemaInitialized 0` static let doneKey = "cloudkit.schemaInitialized" /// UI 测试在真机上跑时设置这个环境变量,跳过初始化 diff --git a/apps/ios/Cook/Model/FridgeCategory.swift b/apps/ios/Cook/Model/FridgeCategory.swift new file mode 100644 index 000000000..f40be8f3b --- /dev/null +++ b/apps/ios/Cook/Model/FridgeCategory.swift @@ -0,0 +1,119 @@ +import CookCore +import Foundation +import SwiftData + +/// 分类独立于库存,吃完最后一份食材后仍可继续使用该分类。 +@Model +final class FridgeCategory { + var identifier: UUID = UUID() + var name: String = "" + + init(name: String) { + self.name = name + } + + static func nameError(_ name: String, takenNames: [String]) -> String? { + if name.isEmpty { return "请输入分类名称。" } + if name.count > 24 { return "分类名称最多 24 个字。" } + if (FridgeBuiltInCategory.allCases.map(\.title) + ["自动归类"] + takenNames).contains(where: { + $0.compare(name, options: [.caseInsensitive, .widthInsensitive]) == .orderedSame + }) { + return "已经有同名分类了。" + } + return nil + } +} + +enum FridgeBuiltInCategory: String, CaseIterable { + case fruit, vegetable, meat, staple, uncategorized + + var title: String { + switch self { + case .fruit: return "水果" + case .vegetable: return "蔬菜" + case .meat: return "肉和蛋" + case .staple: return "主食" + case .uncategorized: return "未分类" + } + } + + static func automatic(for name: String, in food: FoodCatalog) -> Self { + if FridgeFruit(rawValue: name) != nil { return .fruit } + if food.vegetable.contains(where: { $0.name == name }) { return .vegetable } + if food.meat.contains(where: { $0.name == name }) { return .meat } + if food.staple.contains(where: { $0.name == name }) { return .staple } + return .uncategorized + } +} + +enum FridgeCategoryChoice: Hashable { + case automatic + case builtIn(FridgeBuiltInCategory) + case custom(UUID) + + init(storedKey: String?) { + if let key = storedKey, let category = FridgeBuiltInCategory(rawValue: key) { + self = .builtIn(category) + } else if let key = storedKey, let identifier = UUID(uuidString: key) { + self = .custom(identifier) + } else { + self = .automatic + } + } + + var storedKey: String? { + switch self { + case .automatic: return nil + case let .builtIn(category): return category.rawValue + case let .custom(identifier): return identifier.uuidString + } + } + + /// 分类删除后保留食材;原分类不存在时和旧记录一样自动归类。 + func available(in categories: [FridgeCategory]) -> Self { + if case let .custom(identifier) = self, !categories.contains(where: { $0.identifier == identifier }) { + return .automatic + } + return self + } + + func resolved(for name: String, in food: FoodCatalog, custom categories: [FridgeCategory]) -> Self { + let choice = available(in: categories) + return choice == .automatic ? .builtIn(.automatic(for: name, in: food)) : choice + } +} + +/// 冰箱快选独立于菜谱食材词典,只有已有储存依据的水果才提供专属天数。 +enum FridgeFruit: String, CaseIterable, Identifiable { + case blueberry = "蓝莓" + case watermelon = "西瓜" + case apple = "苹果" + case strawberry = "草莓" + case raspberry = "树莓" + case blackberry = "黑莓" + case banana = "香蕉" + case grape = "葡萄" + case orange = "橙子" + case pineapple = "菠萝" + case peach = "桃" + case nectarine = "油桃" + case pear = "梨" + + var id: String { rawValue } + + var emoji: String { + switch self { + case .blueberry: return "🫐" + case .watermelon: return "🍉" + case .apple: return "🍎" + case .strawberry: return "🍓" + case .raspberry, .blackberry: return "🫐" + case .banana: return "🍌" + case .grape: return "🍇" + case .orange: return "🍊" + case .pineapple: return "🍍" + case .peach, .nectarine: return "🍑" + case .pear: return "🍐" + } + } +} diff --git a/apps/ios/Cook/Model/FridgeIntake.swift b/apps/ios/Cook/Model/FridgeIntake.swift index 9e86f8b42..aefa265d7 100644 --- a/apps/ios/Cook/Model/FridgeIntake.swift +++ b/apps/ios/Cook/Model/FridgeIntake.swift @@ -23,14 +23,13 @@ struct ProduceStorageAdvice: Equatable { let source: URL static let source = URL(string: "https://extension.umaine.edu/food-health/2025/05/29/storing-and-washing-fresh-fruits-and-vegetables/")! - static let fruitNames = ["草莓", "蓝莓", "树莓", "黑莓", "桃", "油桃", "梨", "苹果"] - static let names = fruitNames + ["西兰花", "胡萝卜", "白萝卜", "玉米", "黄瓜", "茄子", "生菜", "菠菜", "青菜", "青椒", "西葫芦", "豆角", "荷兰豆"] + static let names = FridgeFruit.allCases.map(\.rawValue) + ["西兰花", "胡萝卜", "白萝卜", "玉米", "黄瓜", "茄子", "生菜", "菠菜", "青菜", "青椒", "西葫芦", "豆角", "荷兰豆"] /// 取公开储存建议区间的较短端,完整蔬果与切开蔬果分别计算。 /// 不覆盖既有通用 shelf-life 数据;没有已核对条目的种类返回 nil。 static func recommendation(for name: String, cut: Bool = false) -> Self? { if cut { - guard names.contains(name) || ["番茄", "香蕉", "葡萄", "橙子", "菠萝", "西瓜", "土豆", "洋葱", "菌菇"].contains(name) else { return nil } + guard names.contains(name) || ["番茄", "土豆", "洋葱", "菌菇"].contains(name) else { return nil } // 切开不会延长完整食材的建议时间,例如蓝莓原本只建议 2 天。 let days = min(name == "番茄" ? 2 : 3, recommendation(for: name)?.days ?? 3) return Self(days: days, condition: "切开后及时密封冷藏,保持 4℃ 或以下;从切开当天起算。", source: source) diff --git a/apps/ios/Cook/Model/Persistence.swift b/apps/ios/Cook/Model/Persistence.swift index 36cb69b3c..972bfd145 100644 --- a/apps/ios/Cook/Model/Persistence.swift +++ b/apps/ios/Cook/Model/Persistence.swift @@ -105,6 +105,8 @@ final class FridgeItem { var productionDate: Date? var expiryBasisRaw: String? var storageAdvice: String? + /// nil 表示按食材自动归类;也用于没有分类字段的旧记录。 + var categoryKey: String? var createdAt: Date = Date() var updatedAt: Date = Date() var deletedAt: Date? @@ -117,6 +119,12 @@ final class FridgeItem { updatedAt = addedAt } + convenience init(name: String, days: Int, at date: Date, calendar: Calendar = .current) { + let today = calendar.startOfDay(for: date) + let expiryDay = calendar.date(byAdding: .day, value: days, to: today) ?? today + self.init(name: name, addedAt: date, expiresAt: FridgeDay.stored(expiryDay, calendar: calendar)) + } + /// 到期那天在当前时区的 0 点,算剩几天、排提醒和选日期都用它 func expiryDay(in calendar: Calendar = .current) -> Date { FridgeDay.local(expiresAt, calendar: calendar) @@ -126,7 +134,7 @@ final class FridgeItem { } enum Persistence { - static let models: [any PersistentModel.Type] = [Favorite.self, HistoryEntry.self, Preferences.self, FridgeItem.self, PrivateRecipeRecord.self] + static let models: [any PersistentModel.Type] = [Favorite.self, HistoryEntry.self, Preferences.self, FridgeItem.self, PrivateRecipeRecord.self, FridgeCategory.self] /// 软删除的记录保留多久,过期后真正删掉 static let tombstoneLifetime: TimeInterval = 30 * 24 * 60 * 60 @@ -187,7 +195,7 @@ extension ModelContext { /// 先保存已有修改,确保失败回滚只撤销本次操作,不抹掉其他页面的待保存数据。 /// 读取和保存错误均交给调用方显示;不得把读取失败当成「没有收藏」。 - private func saveUserChange(save: (ModelContext) throws -> Void, _ change: () throws -> T) throws -> T { + func saveUserChange(save: (ModelContext) throws -> Void = { try $0.save() }, _ change: () throws -> T) throws -> T { if hasChanges { try save(self) } do { let result = try change() @@ -331,9 +339,7 @@ extension ModelContext { /// 放进冰箱,到期日按放入那天加上默认天数 @discardableResult func addToFridge(_ name: String, days: Int, at date: Date = Date(), calendar: Calendar = .current) -> FridgeItem { - let today = calendar.startOfDay(for: date) - let expiryDay = calendar.date(byAdding: .day, value: days, to: today) ?? today - let item = FridgeItem(name: name, addedAt: date, expiresAt: FridgeDay.stored(expiryDay, calendar: calendar)) + let item = FridgeItem(name: name, days: days, at: date, calendar: calendar) insert(item) try? save() return item @@ -349,12 +355,6 @@ extension ModelContext { try? save() } - func setExpiry(_ item: FridgeItem, to date: Date, calendar: Calendar = .current) { - item.expiresAt = FridgeDay.stored(date, calendar: calendar) - item.updatedAt = Date() - try? save() - } - private func purgeFridgeTombstones(now: Date) { let removed = (try? fetch(FetchDescriptor(predicate: #Predicate { $0.deletedAt != nil }))) ?? [] for item in removed { diff --git a/apps/ios/Cook/Views/FridgeCategoryViews.swift b/apps/ios/Cook/Views/FridgeCategoryViews.swift new file mode 100644 index 000000000..45d4f4804 --- /dev/null +++ b/apps/ios/Cook/Views/FridgeCategoryViews.swift @@ -0,0 +1,169 @@ +import SwiftData +import SwiftUI + +struct FridgeCategoryPicker: View { + @Query(sort: \FridgeCategory.name) private var categories: [FridgeCategory] + @State private var creating = false + @Binding var selection: FridgeCategoryChoice + var automaticTitle: String? + + var body: some View { + Picker("分类", selection: availableSelection) { + Text(automaticTitle.map { "自动归类(\($0))" } ?? "自动归类").tag(FridgeCategoryChoice.automatic) + ForEach(FridgeBuiltInCategory.allCases, id: \.self) { category in + Text(category.title).tag(FridgeCategoryChoice.builtIn(category)) + } + ForEach(categories) { category in + Text(category.name).tag(FridgeCategoryChoice.custom(category.identifier)) + } + } + .accessibilityIdentifier("fridge.category.picker") + Button("新建分类", systemImage: "plus") { creating = true } + .sheet(isPresented: $creating) { + FridgeCategoryEditor { selection = .custom($0.identifier) } + } + } + + private var availableSelection: Binding { + Binding(get: { selection.available(in: categories) }, set: { selection = $0 }) + } +} + +struct FridgeCategoryManager: View { + @Environment(\.modelContext) private var context + @Environment(\.dismiss) private var dismiss + @Query(sort: \FridgeCategory.name) private var categories: [FridgeCategory] + @State private var editor: EditorRoute? + @State private var deleting: FridgeCategory? + @State private var saveError = false + + private enum EditorRoute: Identifiable { + case new, edit(FridgeCategory) + + var id: ID { + switch self { + case .new: return .new + case let .edit(category): return .edit(category.identifier) + } + } + + enum ID: Hashable { case new, edit(UUID) } + } + + var body: some View { + NavigationStack { + List { + Section("自定义分类") { + ForEach(categories) { category in + Button(category.name) { editor = .edit(category) } + .foregroundStyle(.primary) + .accessibilityHint("重命名分类") + .swipeActions(allowsFullSwipe: false) { + Button("删除", systemImage: "trash", role: .destructive) { deleting = category } + } + } + Button("新建分类", systemImage: "plus") { editor = .new } + } + } + .navigationTitle("管理分类") + .navigationBarTitleDisplayMode(.inline) + .toolbar { + ToolbarItem(placement: .confirmationAction) { Button("完成") { dismiss() } } + } + .sheet(item: $editor) { route in + switch route { + case .new: FridgeCategoryEditor() + case let .edit(category): FridgeCategoryEditor(category: category) + } + } + .alert("删除分类?", isPresented: Binding(get: { deleting != nil }, set: { if !$0 { deleting = nil } }), presenting: deleting) { category in + Button("删除分类", role: .destructive) { delete(category) } + Button("取消", role: .cancel) {} + } message: { category in + Text("“\(category.name)”里的食材会保留,并恢复自动归类。") + } + .fridgeSaveError(isPresented: $saveError) + } + } + + private func delete(_ category: FridgeCategory) { + do { + try context.saveUserChange { context.delete(category) } + } catch { + saveError = true + } + } +} + +private struct FridgeCategoryEditor: View { + @Environment(\.dismiss) private var dismiss + @Environment(\.modelContext) private var context + @Query private var categories: [FridgeCategory] + @State private var name: String + @State private var saveError = false + private let category: FridgeCategory? + private let onSave: (FridgeCategory) -> Void + + init(category: FridgeCategory? = nil, onSave: @escaping (FridgeCategory) -> Void = { _ in }) { + self.category = category + self.onSave = onSave + _name = State(initialValue: category?.name ?? "") + } + + private var cleanName: String { name.trimmingCharacters(in: .whitespacesAndNewlines) } + + private var nameError: String? { + FridgeCategory.nameError(cleanName, takenNames: categories.filter { $0.identifier != category?.identifier }.map(\.name)) + } + + var body: some View { + NavigationStack { + Form { + Section { + TextField("分类名称", text: $name, prompt: Text("例如:早餐、零食")) + .accessibilityIdentifier("fridge.category.name") + .submitLabel(.done) + .onSubmit(save) + } footer: { + if !cleanName.isEmpty, let nameError { Text(nameError) } + } + } + .navigationTitle(category == nil ? "新建分类" : "重命名分类") + .navigationBarTitleDisplayMode(.inline) + .toolbar { + ToolbarItem(placement: .cancellationAction) { Button("取消") { dismiss() } } + ToolbarItem(placement: .confirmationAction) { Button("保存", action: save).disabled(nameError != nil) } + } + .fridgeSaveError(isPresented: $saveError) + } + } + + private func save() { + guard nameError == nil else { return } + do { + let saved = try context.saveUserChange { + if let category { + category.name = cleanName + return category + } + let created = FridgeCategory(name: cleanName) + context.insert(created) + return created + } + onSave(saved) + dismiss() + } catch { + saveError = true + } + } +} + +extension View { + func fridgeSaveError(isPresented: Binding) -> some View { + alert("未能保存修改", isPresented: isPresented) { + Button("好") {} + } message: { + Text("请检查设备的可用储存空间后重试。") + } + } +} diff --git a/apps/ios/Cook/Views/FridgePhotoSheet.swift b/apps/ios/Cook/Views/FridgePhotoSheet.swift index a1c6beaca..64c89131b 100644 --- a/apps/ios/Cook/Views/FridgePhotoSheet.swift +++ b/apps/ios/Cook/Views/FridgePhotoSheet.swift @@ -202,6 +202,7 @@ private struct FridgePhotoReview: View { @State private var hasProductionDate: Bool @State private var productionDay: Date @State private var saveError = false + @State private var category = FridgeCategoryChoice.automatic init(scan: FridgeLabelScan, onRetake: @escaping () -> Void) { self.scan = scan @@ -218,7 +219,6 @@ private struct FridgePhotoReview: View { private var advice: ProduceStorageAdvice? { ProduceStorageAdvice.recommendation(for: cleanName, cut: cut) } private var isProduce: Bool { ProduceStorageAdvice.names.contains(cleanName) || store.food.vegetable.contains { $0.name == cleanName } - || ["番茄", "香蕉", "葡萄", "橙子", "菠萝", "西瓜"].contains(cleanName) } var body: some View { @@ -234,6 +234,11 @@ private struct FridgePhotoReview: View { Text("图像识别可能出错,请核对食材种类和包装原文。") .font(.footnote).foregroundStyle(.secondary) } + Section { + FridgeCategoryPicker( + selection: $category, + automaticTitle: cleanName.isEmpty ? nil : FridgeBuiltInCategory.automatic(for: cleanName, in: store.food).title) + } Section { ForEach(scan.messages, id: \.self) { Text($0).font(.footnote).foregroundStyle(.secondary) } Toggle("记录生产日期", isOn: $hasProductionDate) @@ -366,6 +371,7 @@ private struct FridgePhotoReview: View { let item = FridgeItem(name: cleanName, addedAt: Date(), expiresAt: FridgeDay.stored(expiresAt)) item.productionDate = hasProductionDate ? FridgeDay.stored(productionDay) : nil item.expiryBasisRaw = basis.rawValue + item.categoryKey = category.storedKey if basis == .estimated { let starting = "\(startDay.formatted(date: .numeric, time: .omitted))\(cut ? "切开" : "购买")。" item.storageAdvice = starting + (advice.map { "\($0.condition) 建议 \($0.days) 天内吃完。" } ?? "通用天数估算,请自行核对。") diff --git a/apps/ios/Cook/Views/FridgeView.swift b/apps/ios/Cook/Views/FridgeView.swift index 7d8bda46f..34e91744f 100644 --- a/apps/ios/Cook/Views/FridgeView.swift +++ b/apps/ios/Cook/Views/FridgeView.swift @@ -10,16 +10,29 @@ struct FridgeView: View { @Environment(\.modelContext) private var context @Environment(AppRouter.self) private var router @Query(filter: #Predicate { $0.deletedAt == nil }, sort: \FridgeItem.expiresAt) private var items: [FridgeItem] + @Query(sort: \FridgeCategory.name) private var categories: [FridgeCategory] @AppStorage(FridgeReminder.enabledKey) private var remindersEnabled = false @AppStorage(FridgeReminder.promptDismissedKey) private var promptDismissed = false @State private var path = NavigationPath() - @State private var adding: AddRoute? - @State private var editing: FridgeItem? + @State private var sheet: Sheet? + @State private var grouping = Grouping.expiry @State private var now = Date() - private enum AddRoute: String, Identifiable { - case manual, photo - var id: String { rawValue } + private enum Grouping { case expiry, category } + + private enum Sheet: Identifiable { + case manual, photo, categories, edit(FridgeItem) + + enum ID: Hashable { case manual, photo, categories, edit(PersistentIdentifier) } + + var id: ID { + switch self { + case .manual: return .manual + case .photo: return .photo + case .categories: return .categories + case let .edit(item): return .edit(item.persistentModelID) + } + } } var body: some View { @@ -40,43 +53,24 @@ struct FridgeView: View { } description: { Text("把买回来的食材记在这里,快过期时提醒你,还能直接看看用它们能做什么。") } actions: { - Button("放点食材") { adding = .manual } + Button("放点食材") { sheet = .manual } .buttonStyle(.borderedProminent) - Button("拍照识别", systemImage: "camera") { adding = .photo } + Button("拍照识别", systemImage: "camera") { sheet = .photo } } } else { List { if !remindersEnabled, !promptDismissed { ReminderPrompt(onDismiss: { promptDismissed = true }) } - if !soon.isEmpty { - Section { - rows(soon, now: now) - } header: { - HStack { - Text("优先食用") - Spacer() - Button("只用这几样做菜") { cook(soon) } - .font(.footnote) - .textCase(nil) - } - } footer: { - Text("记录日期在今天到后天之间,先安排食用。") - } - } - if !fresh.isEmpty { - Section("稍后食用") { - rows(fresh, now: now) - } + Picker("冰箱分组", selection: $grouping) { + Text("按临期").tag(Grouping.expiry) + Text("按分类").tag(Grouping.category) } - if !expired.isEmpty { - Section { - rows(expired, now: now) - } header: { - Text("已过记录日期") - } footer: { - Text("请核对包装及储存情况;外观和气味不能保证食用安全。左滑可以移出冰箱。") - } + .pickerStyle(.segmented) + if grouping == .expiry { + expirySections(soon: soon, fresh: fresh, expired: expired) + } else { + categorySections } Section { FridgeReminderRows() @@ -103,11 +97,12 @@ struct FridgeView: View { .navigationTitle("冰箱") .toolbar { ToolbarItemGroup(placement: .topBarTrailing) { - Button { adding = .photo } label: { + Button("管理分类", systemImage: "folder") { sheet = .categories } + Button { sheet = .photo } label: { Label("拍照识别", systemImage: "camera") } Button { - adding = .manual + sheet = .manual } label: { Label("放进冰箱", systemImage: "plus") } @@ -117,31 +112,81 @@ struct FridgeView: View { ResultsView() } .recipeDestinations() - .sheet(item: $adding) { route in + .sheet(item: $sheet) { route in switch route { case .manual: AddFridgeSheet() case .photo: FridgePhotoSheet() + case .categories: FridgeCategoryManager() + case let .edit(item): FridgeItemSheet(item: item) } } - .sheet(item: $editing) { item in - FridgeItemSheet(item: item) - .presentationDetents([.medium, .large]) - } } .sensoryFeedback(.success, trigger: items.count) { old, new in new > old } .refreshesAtMidnight($now) // 点开临期通知:不管之前点进了哪里,都回到冰箱首页看临期列表 .onChange(of: router.fridgeHomeRequests) { path = NavigationPath() - adding = nil - editing = nil + sheet = nil + grouping = .expiry } } - private func rows(_ list: [FridgeItem], now: Date) -> some View { + @ViewBuilder + private func expirySections(soon: [FridgeItem], fresh: [FridgeItem], expired: [FridgeItem]) -> some View { + if !soon.isEmpty { + Section { + rows(soon) + } header: { + HStack { + Text("优先食用") + Spacer() + Button("只用这几样做菜") { cook(soon) } + .font(.footnote) + .textCase(nil) + } + } footer: { + Text("记录日期在今天到后天之间,先安排食用。") + } + } + if !fresh.isEmpty { + Section("稍后食用") { rows(fresh) } + } + if !expired.isEmpty { + Section { + rows(expired) + } header: { + Text("已过记录日期") + } footer: { + Text("请核对包装及储存情况;外观和气味不能保证食用安全。左滑可以移出冰箱。") + } + } + } + + private var categorySections: some View { + let food = store.food + let groups = Dictionary(grouping: items) { item in + FridgeCategoryChoice(storedKey: item.categoryKey).resolved(for: item.name, in: food, custom: categories) + } + return Group { + ForEach(FridgeBuiltInCategory.allCases.filter { $0 != .uncategorized }, id: \.self) { category in + categorySection(category.title, items: groups[.builtIn(category)]) + } + ForEach(categories) { category in + categorySection(category.name, items: groups[.custom(category.identifier)]) + } + categorySection(FridgeBuiltInCategory.uncategorized.title, items: groups[.builtIn(.uncategorized)]) + } + } + + @ViewBuilder + private func categorySection(_ title: String, items: [FridgeItem]?) -> some View { + if let items { Section(title) { rows(items) } } + } + + private func rows(_ list: [FridgeItem]) -> some View { ForEach(list) { item in Button { - editing = item + sheet = .edit(item) } label: { FridgeRow(item: item, emoji: emoji(for: item.name), freshness: Freshness(expiresAt: item.expiryDay(), now: now)) } @@ -155,7 +200,7 @@ struct FridgeView: View { } private func emoji(for name: String) -> String { - store.emoji(forStuff: name) ?? "🥡" + FridgeFruit(rawValue: name)?.emoji ?? store.emoji(forStuff: name) ?? "🥡" } /// 把这几样食材带去找菜,在冰箱页里直接打开推荐结果 @@ -196,7 +241,7 @@ private struct FridgeRow: View { .foregroundStyle(tint) } .accessibilityElement(children: .combine) - .accessibilityHint("点开修改到期日") + .accessibilityHint("点开修改日期或分类") } private var tint: Color { @@ -337,6 +382,8 @@ struct AddFridgeSheet: View { @Environment(\.dismiss) private var dismiss @State private var selected: [String] = [] @State private var input = "" + @State private var category = FridgeCategoryChoice.automatic + @State private var saveError = false var body: some View { NavigationStack { @@ -349,10 +396,11 @@ struct AddFridgeSheet: View { Button("添加", action: addInput) .disabled(input.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty) } + } + Section { + FridgeCategoryPicker(selection: $category) } footer: { - if !extras.isEmpty { - Text("自己输入的按 \(store.data.shelfLife.defaultDays) 天估到期日。") - } + Text("自动归类会按每种食材分别归类。指定分类后,本次选中的食材会放进同一分类。") } if !extras.isEmpty { ChipSection(title: "输入的食材") { @@ -361,21 +409,24 @@ struct AddFridgeSheet: View { } } } - section("蔬菜", store.food.vegetable) ChipSection(title: "水果") { - ForEach(ProduceStorageAdvice.fruitNames, id: \.self) { name in - Chip(title: name, isSelected: selected.contains(name)) { - toggle(name) + ForEach(FridgeFruit.allCases) { fruit in + Chip(title: fruit.rawValue, emoji: fruit.emoji, isSelected: selected.contains(fruit.rawValue)) { + toggle(fruit.rawValue) } } } + section("蔬菜", store.food.vegetable) section("肉和蛋", store.food.meat) section("主食", store.food.staple) if !selected.isEmpty { Section { ForEach(selected, id: \.self) { name in - let days = ProduceStorageAdvice.recommendation(for: name)?.days ?? store.data.shelfLife.days(for: name) - LabeledContent(name, value: "建议 \(days) 天内吃完") + if let advice = ProduceStorageAdvice.recommendation(for: name) { + LabeledContent(name, value: "建议 \(advice.days) 天内吃完") + } else { + LabeledContent(name, value: "通用参考:\(store.data.shelfLife.days(for: name)) 天") + } } } header: { Text("食用时间建议") @@ -386,6 +437,7 @@ struct AddFridgeSheet: View { } .navigationTitle("放进冰箱") .navigationBarTitleDisplayMode(.inline) + .fridgeSaveError(isPresented: $saveError) .toolbar { ToolbarItem(placement: .cancellationAction) { Button("取消") { dismiss() } @@ -400,12 +452,12 @@ struct AddFridgeSheet: View { } private var extras: [String] { - selected.filter { !store.isCatalogStuff($0) && !ProduceStorageAdvice.fruitNames.contains($0) } + selected.filter { !store.isCatalogStuff($0) && FridgeFruit(rawValue: $0) == nil } } private func section(_ title: String, _ list: [StuffItem]) -> some View { ChipSection(title: title) { - ForEach(list, id: \.name) { item in + ForEach(list.filter { FridgeFruit(rawValue: $0.name) == nil }, id: \.name) { item in Chip(title: item.name, emoji: item.emoji, isSelected: selected.contains(item.name)) { toggle(item.name) } @@ -431,13 +483,20 @@ struct AddFridgeSheet: View { private func save() { let now = Date() - for name in selected { - let advice = ProduceStorageAdvice.recommendation(for: name) - let item = context.addToFridge(name, days: advice?.days ?? store.data.shelfLife.days(for: name), at: now) - item.storageAdvice = advice?.condition + do { + try context.saveUserChange { + for name in selected { + let advice = ProduceStorageAdvice.recommendation(for: name) + let item = FridgeItem(name: name, days: advice?.days ?? store.data.shelfLife.days(for: name), at: now) + item.categoryKey = category.storedKey + item.storageAdvice = advice?.condition + context.insert(item) + } + } + dismiss() + } catch { + saveError = true } - try? context.save() - dismiss() } } @@ -447,12 +506,24 @@ private struct FridgeItemSheet: View { @Environment(\.modelContext) private var context @Environment(\.dismiss) private var dismiss let item: FridgeItem - @State private var expiresAt = Date() - @State private var basis = FridgeExpiryBasis.estimated + @State private var expiresAt: Date + @State private var basis: FridgeExpiryBasis + @State private var category: FridgeCategoryChoice + @State private var saveError = false + + init(item: FridgeItem) { + self.item = item + _expiresAt = State(initialValue: item.expiryDay()) + _basis = State(initialValue: item.expiryBasis) + _category = State(initialValue: FridgeCategoryChoice(storedKey: item.categoryKey)) + } var body: some View { NavigationStack { Form { + Section { + FridgeCategoryPicker(selection: $category, automaticTitle: FridgeBuiltInCategory.automatic(for: item.name, in: store.food).title) + } Section { LabeledContent("放入日期", value: item.addedAt.formatted(.dateTime.year().month().day())) if let production = item.productionDate { @@ -475,25 +546,33 @@ private struct FridgeItemSheet: View { } .navigationTitle(item.name) .navigationBarTitleDisplayMode(.inline) + .fridgeSaveError(isPresented: $saveError) .toolbar { ToolbarItem(placement: .cancellationAction) { Button("取消") { dismiss() } } ToolbarItem(placement: .confirmationAction) { - Button("完成") { - let changedDate = expiresAt != item.expiryDay() - let editedBasis = changedDate && (basis == .estimated || basis == .calculated) ? .manual : basis - if changedDate || editedBasis != item.expiryBasis { item.storageAdvice = nil } - item.expiryBasisRaw = editedBasis.rawValue - context.setExpiry(item, to: expiresAt) - dismiss() - } + Button("完成", action: save) } } - .onAppear { - expiresAt = item.expiryDay() - basis = item.expiryBasis + } + } + + private func save() { + do { + try context.saveUserChange { + let expiresDay = FridgeDay.stored(expiresAt) + let changedDate = expiresDay != item.expiresAt + let editedBasis = changedDate && (basis == .estimated || basis == .calculated) ? .manual : basis + if changedDate || editedBasis != item.expiryBasis { item.storageAdvice = nil } + item.expiryBasisRaw = editedBasis.rawValue + item.expiresAt = expiresDay + item.categoryKey = category.storedKey + item.updatedAt = Date() } + dismiss() + } catch { + saveError = true } } } diff --git a/apps/ios/CookTests/FridgeIntakeTests.swift b/apps/ios/CookTests/FridgeIntakeTests.swift index 9cb15c374..925b4800b 100644 --- a/apps/ios/CookTests/FridgeIntakeTests.swift +++ b/apps/ios/CookTests/FridgeIntakeTests.swift @@ -121,6 +121,35 @@ final class FridgeIntakeTests: XCTestCase { XCTAssertEqual(saved.storageAdvice, "按包装要求冷藏") } + @MainActor + func testCustomCategoryRenameAndRemovalKeepTheSameFridgeItem() throws { + let container = Persistence.makeContainer(inMemory: true) + let context = container.mainContext + let food = try RecipeStore.loadBundled(inMemory: true).food + let category = FridgeCategory(name: "早餐") + let item = FridgeItem(name: "苹果", days: 28, at: day(11, 1), calendar: calendar) + item.categoryKey = FridgeCategoryChoice.custom(category.identifier).storedKey + context.insert(category) + context.insert(item) + try context.save() + + let reopened = ModelContext(container) + let savedCategory = try XCTUnwrap(reopened.fetch(FetchDescriptor()).first) + let savedItem = try XCTUnwrap(reopened.fetch(FetchDescriptor()).first) + savedCategory.name = "明日早餐" + try reopened.save() + let choice = FridgeCategoryChoice(storedKey: savedItem.categoryKey) + XCTAssertEqual(choice.resolved(for: savedItem.name, in: food, custom: [savedCategory]), .custom(savedCategory.identifier)) + + reopened.delete(savedCategory) + try reopened.save() + let remaining = try XCTUnwrap(reopened.fetch(FetchDescriptor()).first) + let categories = try reopened.fetch(FetchDescriptor()) + XCTAssertTrue(categories.isEmpty) + XCTAssertEqual(choice.resolved(for: remaining.name, in: food, custom: categories), .builtIn(.fruit)) + XCTAssertEqual(remaining.expiryDay(in: calendar), day(11, 29)) + } + @MainActor func testExistingFridgeStoreMigratesWithoutLosingItems() throws { let directory = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString) @@ -134,8 +163,10 @@ final class FridgeIntakeTests: XCTestCase { let container = try ModelContainer( for: schema, configurations: ModelConfiguration(schema: schema, url: url, cloudKitDatabase: .none)) let old = LegacyFridge.FridgeItem() - old.name = "鸡蛋" + old.name = "西瓜" old.expiresAt = FridgeDay.stored(day(11, 20), calendar: calendar) + old.productionDate = FridgeDay.stored(day(11, 1), calendar: calendar) + old.expiryBasisRaw = FridgeExpiryBasis.manual.rawValue container.mainContext.insert(old) try container.mainContext.save() } @@ -144,19 +175,23 @@ final class FridgeIntakeTests: XCTestCase { let container = try ModelContainer( for: schema, configurations: ModelConfiguration(schema: schema, url: url, cloudKitDatabase: .none)) let saved = try XCTUnwrap(container.mainContext.fetch(FetchDescriptor()).first) - XCTAssertEqual(saved.name, "鸡蛋") + XCTAssertEqual(saved.name, "西瓜") XCTAssertEqual(saved.expiryDay(in: calendar), day(11, 20)) - XCTAssertEqual(saved.expiryBasis, .estimated) - XCTAssertNil(saved.productionDate) - saved.productionDate = FridgeDay.stored(day(11, 1), calendar: calendar) - saved.expiryBasisRaw = FridgeExpiryBasis.package.rawValue + XCTAssertEqual(saved.expiryBasis, .manual) + XCTAssertEqual(saved.productionDate, FridgeDay.stored(day(11, 1), calendar: calendar)) + XCTAssertNil(saved.categoryKey) + let choice = FridgeCategoryChoice(storedKey: saved.categoryKey) + let food = try RecipeStore.loadBundled(inMemory: true).food + XCTAssertEqual(choice.resolved(for: saved.name, in: food, custom: []), .builtIn(.fruit)) + saved.categoryKey = FridgeCategoryChoice.builtIn(.uncategorized).storedKey try container.mainContext.save() } let schema = Schema(Persistence.models) let container = try ModelContainer( for: schema, configurations: ModelConfiguration(schema: schema, url: url, cloudKitDatabase: .none)) let saved = try XCTUnwrap(container.mainContext.fetch(FetchDescriptor()).first) - XCTAssertEqual(saved.expiryBasis, .package) + XCTAssertEqual(saved.categoryKey, FridgeBuiltInCategory.uncategorized.rawValue) + XCTAssertEqual(saved.expiryBasis, .manual) XCTAssertEqual(saved.productionDate, FridgeDay.stored(day(11, 1), calendar: calendar)) } @@ -238,6 +273,9 @@ private enum LegacyFridge { var name: String = "" var addedAt: Date = Date() var expiresAt: Date = Date() + var productionDate: Date? + var expiryBasisRaw: String? + var storageAdvice: String? var createdAt: Date = Date() var updatedAt: Date = Date() var deletedAt: Date? diff --git a/apps/ios/CookTests/PrivateRecipePersistenceTests.swift b/apps/ios/CookTests/PrivateRecipePersistenceTests.swift index 7c0761169..041258e35 100644 --- a/apps/ios/CookTests/PrivateRecipePersistenceTests.swift +++ b/apps/ios/CookTests/PrivateRecipePersistenceTests.swift @@ -270,7 +270,7 @@ final class PrivateRecipePersistenceTests: XCTestCase { try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true) defer { try? FileManager.default.removeItem(at: directory) } let url = directory.appendingPathComponent("migration.store") - // Exact models already shipped before custom recipes, including schema 2's FridgeItem. + // Exercise opening a store that predates the standalone recipe and category tables. try autoreleasepool { let schema = Schema([Favorite.self, HistoryEntry.self, Preferences.self, FridgeItem.self]) let config = ModelConfiguration(schema: schema, url: url, cloudKitDatabase: .none) @@ -287,7 +287,7 @@ final class PrivateRecipePersistenceTests: XCTestCase { // Exercise that extra migration/unload path without contacting iCloud. try autoreleasepool { let model = try XCTUnwrap(NSManagedObjectModel.makeManagedObjectModel(for: Persistence.models)) - XCTAssertEqual(Set(model.entities.compactMap(\.name)), ["Favorite", "HistoryEntry", "Preferences", "FridgeItem", "PrivateRecipeRecord"]) + XCTAssertEqual(Set(model.entities.compactMap(\.name)), ["Favorite", "HistoryEntry", "Preferences", "FridgeItem", "PrivateRecipeRecord", "FridgeCategory"]) let description = NSPersistentStoreDescription(url: url) description.shouldAddStoreAsynchronously = false description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey) diff --git a/apps/ios/CookUITests/FridgePhotoUITests.swift b/apps/ios/CookUITests/FridgePhotoUITests.swift index d20591d84..170fa8802 100644 --- a/apps/ios/CookUITests/FridgePhotoUITests.swift +++ b/apps/ios/CookUITests/FridgePhotoUITests.swift @@ -89,6 +89,67 @@ final class FridgePhotoUITests: XCTestCase { XCTAssertTrue(item.label.contains("建议 28 天内吃完"), item.label) } + @MainActor + func testFruitCanMoveFromCustomCategoryBackToAutomaticGrouping() { + let categoryName = "零食" + let renamedCategoryName = "零食盒" + let app = openFridge() + app.buttons["放点食材"].tap() + app.buttons["新建分类"].tap() + let name = app.textFields["fridge.category.name"] + XCTAssertTrue(name.waitForExistence(timeout: 10)) + name.tap() + name.typeText(categoryName) + app.buttons["保存"].tap() + + for fruit in ["蓝莓", "西瓜", "苹果"] { + let chip = app.buttons[fruit] + for _ in 0..<4 where !chip.isHittable { app.swipeUp() } + XCTAssertTrue(chip.isHittable, fruit) + chip.tap() + } + app.buttons["放进去(3)"].tap() + let grouped = app.buttons["按分类"] + XCTAssertTrue(grouped.waitForExistence(timeout: 10)) + grouped.tap() + XCTAssertTrue(app.staticTexts[categoryName].exists) + XCTAssertFalse(app.staticTexts["水果"].exists) + let apple = app.buttons.matching(NSPredicate(format: "label BEGINSWITH %@", "苹果")).firstMatch + XCTAssertTrue(apple.exists) + XCTAssertTrue(apple.label.contains("建议 28 天内吃完"), apple.label) + capture(app, "fridge-custom-category") + + apple.tap() + let picker = app.buttons["fridge.category.picker"] + XCTAssertTrue(picker.waitForExistence(timeout: 10)) + picker.tap() + app.buttons["自动归类(水果)"].tap() + app.buttons["完成"].tap() + XCTAssertTrue(app.staticTexts["水果"].waitForExistence(timeout: 10)) + XCTAssertTrue(app.staticTexts[categoryName].exists) + XCTAssertTrue(apple.label.contains("建议 28 天内吃完"), apple.label) + + app.buttons["管理分类"].tap() + let category = app.buttons[categoryName] + XCTAssertTrue(category.waitForExistence(timeout: 10)) + category.tap() + XCTAssertTrue(name.waitForExistence(timeout: 10)) + name.tap() + name.typeText("盒") + app.buttons["保存"].tap() + let renamed = app.buttons[renamedCategoryName] + XCTAssertTrue(renamed.waitForExistence(timeout: 10)) + renamed.swipeLeft() + app.buttons["删除"].tap() + app.alerts.buttons["删除分类"].tap() + XCTAssertTrue(renamed.waitForNonExistence(timeout: 10)) + app.buttons["完成"].tap() + let watermelon = app.buttons.matching(NSPredicate(format: "label BEGINSWITH %@", "西瓜")).firstMatch + XCTAssertTrue(watermelon.waitForExistence(timeout: 10)) + XCTAssertFalse(app.staticTexts[categoryName].exists) + XCTAssertFalse(app.staticTexts[renamedCategoryName].exists) + } + @MainActor private func openFridge(label: String? = nil) -> XCUIApplication { continueAfterFailure = false diff --git a/apps/ios/README.md b/apps/ios/README.md index 7842d85b0..4032c2bd7 100644 --- a/apps/ios/README.md +++ b/apps/ios/README.md @@ -92,7 +92,9 @@ CI 的 `ios-tests` 矩阵在 iPhone 和 iPad 模拟器上分组跑单元测试 「使用微信注册」还需要构建显式设置 `COOK_WECHAT_SIGNUP_ENABLED=YES`。生产和普通联调构建默认关闭。 -## 冰箱拍照录入 +## 冰箱分类与拍照录入 + +冰箱可在「按临期」和「按分类」之间切换。「按分类」自动把已知食材归入水果、蔬菜、肉和蛋或主食,未匹配的归入「未分类」。右上角「管理分类」可新建、重命名或删除自定义分类;删除后食材保留并恢复自动归类。手动添加可按批选择分类,拍照确认和单份食材详情也可指定分类。水果快选包含蓝莓、西瓜、苹果等常见水果。 冰箱右上角的相机按钮可拍摄包装或一份蔬果,也可通过系统照片选择器选图。Apple Vision 在本机识别,照片和识别原文不保存、不上传;不需要 AI Key 或会员。确认页可编辑食材、生产日期、到期日及日期依据;日期不完整、无法判断标签或存在冲突时需手动核对。包装到期日优先,其次按识别出的生产日期与唯一保质期推算。 @@ -102,12 +104,12 @@ CI 的 `ios-tests` 矩阵在 iPhone 和 iPad 模拟器上分组跑单元测试 私人菜谱源码以最新 main 集成后的代码检查、Web/Swift 文件往返和 iPhone/iPad 模拟器测试作为合并条件。五模型生产结构、同账户跨设备读写,以及构建 6 的离线新增和修改 / 删除冲突已有[真实生产证据](../../docs/dev/ios-production-sync-2026-10-24.md)。维护者随后决定,剩余验收改用模拟器,不再要求真机;覆盖范围和不能由本地测试证明的账号行为见[模拟器验收记录](../../docs/dev/ios-simulator-acceptance-2026-10-24.md)。文件协议见[私人菜谱与文件迁移](../../docs/dev/private-recipes.md)。 -收藏、浏览记录、做菜偏好、冰箱食材和私人菜谱用 SwiftData 存,登录 iCloud 时通过容器 `iCloud.fun.yunle.cook` 同步。TestFlight 和 App Store 版本用 CloudKit 的 **Production** 环境,结构要先在 Development 环境建好,再手动部署过去: +收藏、浏览记录、做菜偏好、冰箱食材和分类、私人菜谱用 SwiftData 存,登录 iCloud 时通过容器 `iCloud.fun.yunle.cook` 同步。TestFlight 和 App Store 版本用 CloudKit 的 **Production** 环境,结构要先在 Development 环境建好,再手动部署过去: -1. 用 Xcode 在**真机**上跑 Debug 版(已登录 iCloud)。第一次启动会调用 `initializeCloudKitSchema()` 把 `CD_Favorite`、`CD_HistoryEntry`、`CD_Preferences`、`CD_FridgeItem`、`CD_PrivateRecipeRecord` 建到 Development,首屏会多等几秒;日志里看到「已在 Development 环境建好 CloudKit 结构」就是成功了。结构版本 2 包含冰箱食材,版本 3 加入私人菜谱,版本 4 添加冰箱记录的可选生产日期、日期依据与储存建议;之前初始化过旧版本的设备也会重新初始化。模拟器和 Release 构建不会跑这一步(见 `Cook/Model/CloudKitSchema.swift`)。 +1. 用 Xcode 在**真机**上跑 Debug 版(已登录 iCloud)。第一次启动会调用 `initializeCloudKitSchema()` 把 `CD_Favorite`、`CD_HistoryEntry`、`CD_Preferences`、`CD_FridgeItem`、`CD_PrivateRecipeRecord` 和 `CD_FridgeCategory` 建到 Development,首屏会多等几秒;日志里看到「已在 Development 环境建好 CloudKit 结构」就是成功了。版本 4 添加冰箱记录的可选生产日期、日期依据与储存建议;版本 5 新增分类及食材上的可选分类键。之前初始化过旧版本的设备也会重新初始化。模拟器和 Release 构建不会跑这一步(见 `Cook/Model/CloudKitSchema.swift`)。 2. 打开 [CloudKit Console](https://icloud.developer.apple.com/dashboard/) → `iCloud.fun.yunle.cook` → Development → Record Types,确认这几个类型和字段都在。 3. 点左下角 **Deploy Schema Changes…**,检查变更只有新增(类型、索引和对应的默认权限),再点 Deploy。Production 的字段之后只能加不能删改,部署前想清楚。 -4. 在 Production → Record Types 确认当前五个模型的结构已经同步过去,再用同一 Production 构建验证两台设备之间的收藏、历史、偏好、冰箱和私人菜谱读写,以及离线冲突、账号隔离和退出 iCloud 后的本地数据处理。记录版本、设备、环境、操作与观察结果;没有实际证据的项目保留为未验证。 +4. 在 Production → Record Types 确认当前六个模型的结构已经同步过去,再用同一 Production 构建验证两台设备之间的收藏、历史、偏好、冰箱食材和分类、私人菜谱读写,以及离线冲突、账号隔离和退出 iCloud 后的本地数据处理。记录版本、设备、环境、操作与观察结果;没有实际证据的项目保留为未验证。 改了 `@Model` 的字段时:把 `CloudKitSchema.version` 加一,真机 Debug 启动一次,然后重复第 2–4 步。如果在 Console 里 Reset 了 Development 环境,用启动参数 `-cloudkit.schemaInitialized 0` 让开发版重新建一次。 diff --git a/docs/privacy.md b/docs/privacy.md index 6431b3190..4810d8e8a 100644 --- a/docs/privacy.md +++ b/docs/privacy.md @@ -6,9 +6,9 @@ ## 本地数据与 iCloud -选食材、普通搜索和推荐在设备上完成,不需要注册云乐坊账号;可选的智能识别见下节。收藏、浏览记录、做菜偏好和冰箱里的食材保存在本机;启用并可用的 iCloud 会通过 Apple CloudKit 将这些数据同步到同一 Apple 账户的设备。冰箱记录包括你确认的食材名称、放入时间、包装到期日期或建议食用日期、可选的生产日期、日期依据与储存建议,以及用于同步的创建、修改和删除时间。iCloud 服务由 Apple 提供,其处理方式受 [Apple 隐私政策](https://www.apple.com/legal/privacy/zh-cn/)约束。 +选食材、普通搜索和推荐在设备上完成,不需要注册云乐坊账号;可选的智能识别见下节。收藏、浏览记录、做菜偏好、冰箱里的食材和自定义分类保存在本机;启用并可用的 iCloud 会通过 Apple CloudKit 将这些数据同步到同一 Apple 账户的设备。冰箱记录包括你确认的食材名称、放入时间、包装到期日期或建议食用日期、可选的生产日期、日期依据与储存建议、所选分类,以及用于同步的创建、修改和删除时间。自定义分类保存名称与关联标识。iCloud 服务由 Apple 提供,其处理方式受 [Apple 隐私政策](https://www.apple.com/legal/privacy/zh-cn/)约束。 -你可以在 App 中取消收藏、清空浏览记录、修改偏好,或在冰箱页修改到期日、用「吃完了」移出食材。为将删除操作同步到其他设备,数据库会保留必要的删除记录;历史删除记录在超过 30 天后再次记录浏览时清理,冰箱删除记录在超过 30 天后再次移出食材时清理。关闭 iCloud 同步不会自动删除已有的云端副本;你可以通过系统设置管理本 App 的 iCloud 数据。卸载 App 会移除本地数据,但不等于删除 iCloud 副本。 +你可以在 App 中取消收藏、清空浏览记录、修改偏好,也可以在冰箱页修改到期日、删除自定义分类,或用「吃完了」移出食材。为将删除操作同步到其他设备,数据库会保留必要的删除记录;历史删除记录在超过 30 天后再次记录浏览时清理,冰箱删除记录在超过 30 天后再次移出食材时清理。关闭 iCloud 同步不会自动删除已有的云端副本;你可以通过系统设置管理本 App 的 iCloud 数据。卸载 App 会移除本地数据,但不等于删除 iCloud 副本。 ## 可选的智能识别与 DeepSeek 服务 @@ -72,7 +72,7 @@ App 为每个账号保存独立的本机缓存,支持离线使用;缓存不 ## 冰箱临期提醒 -你可以主动拍摄食品包装或蔬果,或通过系统照片选择器选择一张照片。拍摄时才申请相机权限;照片选择器只向 App 提供你选中的照片,不要求访问整个照片库。图像、文字与常见蔬果类别识别由 Apple Vision 在设备上处理,不向开发者服务器、云乐坊或 DeepSeek 上传照片。照片和识别原文仅用于当前核对流程,不保存到冰箱记录或 iCloud;确认后只保存上述食材与日期字段。拒绝相机权限不影响手动添加及从照片选择。 +你可以主动拍摄食品包装或蔬果,或通过系统照片选择器选择一张照片。拍摄时才申请相机权限;照片选择器只向 App 提供你选中的照片,不要求访问整个照片库。图像、文字与常见蔬果类别识别由 Apple Vision 在设备上处理,不向开发者服务器、云乐坊或 DeepSeek 上传照片。照片和识别原文仅用于当前核对流程,不保存到冰箱记录或 iCloud;确认后只保存上述冰箱记录字段。拒绝相机权限不影响手动添加及从照片选择。 临期提醒默认关闭,只有你主动开启时才会申请系统通知权限。记录日期前一天和当天的提醒由设备在本地排程,不通过开发者的服务器发送;通知区分食用时间建议与包装到期日期。通知可能显示食材名称与临期情况,并根据你的系统通知设置出现在锁定屏幕上。提醒开关、时间和提示卡片的关闭状态只保存在当前设备,不随 iCloud 同步。