From 8478c55e513bbbb4b1676d1d9207f7feb2509465 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Fri, 22 May 2026 00:30:57 +0800
Subject: [PATCH] Freeze 7.6.0 release candidate and move docs out of repo
---
Apptag/PreferencesView.swift | 424 +++++++++++++++++++++++++++++++++++-----------------
1 files changed, 286 insertions(+), 138 deletions(-)
diff --git a/Apptag/PreferencesView.swift b/Apptag/PreferencesView.swift
index d0a1843..d01e500 100644
--- a/Apptag/PreferencesView.swift
+++ b/Apptag/PreferencesView.swift
@@ -1,6 +1,5 @@
import SwiftUI
import AppKit
-import Carbon
// MARK: - Preferences View
@@ -24,6 +23,8 @@
@AppStorage("showDockIcon") private var showDockIcon = AppDefaults.showDockIcon
@AppStorage("launchAtLogin") private var launchAtLogin = AppDefaults.launchAtLogin
@AppStorage("showUncommonAppBubbles") private var showUncommonAppBubbles = AppDefaults.showUncommonAppBubbles
+ @AppStorage("mainHotkeyRegistrationState") private var mainHotkeyRegistrationState = LauncherHotkeyRegistrationState.active.rawValue
+ @AppStorage("quickSearchHotkeyRegistrationState") private var quickSearchHotkeyRegistrationState = LauncherHotkeyRegistrationState.active.rawValue
@State private var selectedLanguage = L10n.currentCode
@State private var isRefreshingLanguage = false
@State private var allApps: [AppInfo] = []
@@ -31,6 +32,8 @@
@State private var categoryScheme = TagDatabase.CategorySchemeState()
@State private var isApplyingSystemScheme = false
@State private var showApplySystemSchemeConfirmation = false
+ @State private var hotkeyStatusToast: String? = nil
+ @State private var hotkeyStatusToastToken: UUID? = nil
private func scanApps() {
DispatchQueue.global(qos: .userInitiated).async {
@@ -117,6 +120,75 @@
alert.beginSheetModal(for: window)
} else {
alert.runModal()
+ }
+ }
+
+ private var mainHotkeyState: LauncherHotkeyRegistrationState {
+ LauncherHotkeyRegistrationState(rawValue: mainHotkeyRegistrationState) ?? .active
+ }
+
+ private var quickSearchHotkeyState: LauncherHotkeyRegistrationState {
+ LauncherHotkeyRegistrationState(rawValue: quickSearchHotkeyRegistrationState) ?? .active
+ }
+
+ private func hotkeyStatusText(for kind: LauncherHotkeyKind) -> String {
+ switch kind {
+ case .main:
+ return mainHotkeyState == .failed
+ ? tr("quickSearch.status.registrationFailed")
+ : tr("quickSearch.status.Active")
+ case .quickSearch:
+ return quickSearchHotkeyState == .failed
+ ? tr("quickSearch.status.unavailable")
+ : tr("quickSearch.status.Active")
+ }
+ }
+
+ private func hotkeyStatusTone(for kind: LauncherHotkeyKind) -> HotkeyStatusTone {
+ switch kind {
+ case .main:
+ return mainHotkeyState == .failed ? .warning : .active
+ case .quickSearch:
+ return quickSearchHotkeyState == .failed ? .warning : .active
+ }
+ }
+
+ private func showPendingHotkeyWarningIfNeeded() {
+ var messages: [String] = []
+ if LauncherHotkeyRegistrationStore.consumeNeedsAttention(for: .main),
+ LauncherHotkeyRegistrationStore.state(for: .main) == .failed {
+ messages.append(hotkeyFailureMessage(for: .main))
+ }
+ if LauncherHotkeyRegistrationStore.consumeNeedsAttention(for: .quickSearch),
+ LauncherHotkeyRegistrationStore.state(for: .quickSearch) == .failed {
+ messages.append(hotkeyFailureMessage(for: .quickSearch))
+ }
+ guard !messages.isEmpty else { return }
+ showHotkeyStatusToast(messages.joined(separator: "\n\n"))
+ }
+
+ private func hotkeyFailureMessage(for kind: LauncherHotkeyKind) -> String {
+ let key = kind == .main
+ ? "quickSearch.mainHotkeyUnavailableMessage"
+ : "quickSearch.globalHotkeyUnavailableMessage"
+ let status = LauncherHotkeyRegistrationStore.failureCode(for: kind)
+ .map(String.init) ?? "-"
+ return tr(key)
+ .replacingOccurrences(of: "%shortcut%", with: kind.hotkey.displayString)
+ .replacingOccurrences(of: "%status%", with: status)
+ }
+
+ private func showHotkeyStatusToast(_ message: String) {
+ let token = UUID()
+ hotkeyStatusToastToken = token
+ withAnimation(.easeOut(duration: 0.16)) {
+ hotkeyStatusToast = message
+ }
+ DispatchQueue.main.asyncAfter(deadline: .now() + 5.0) {
+ guard hotkeyStatusToastToken == token else { return }
+ withAnimation(.easeOut(duration: 0.18)) {
+ hotkeyStatusToast = nil
+ }
}
}
@@ -339,6 +411,38 @@
.contentShape(RoundedRectangle(cornerRadius: 8, style: .continuous))
}
+ private func hotkeySettingsPanel() -> some View {
+ VStack(alignment: .leading, spacing: 12) {
+ Text(tr("quickSearch.hotkeys"))
+ .font(.system(size: 13, weight: .semibold))
+ .foregroundStyle(.secondary)
+
+ StaticHotkeyInfoRow(
+ title: tr("quickSearch.mainHotkey"),
+ description: tr("quickSearch.mainHotkeyDesc"),
+ displayText: LauncherHotkey.main.displayString,
+ statusText: hotkeyStatusText(for: .main),
+ statusTone: hotkeyStatusTone(for: .main)
+ )
+
+ StaticHotkeyInfoRow(
+ title: tr("quickSearch.internalHotkey"),
+ description: tr("quickSearch.internalHotkeyDesc"),
+ displayText: tr("quickSearch.spaceDisplay"),
+ statusText: tr("quickSearch.internalHotkeyStatus"),
+ statusTone: .neutral
+ )
+
+ StaticHotkeyInfoRow(
+ title: tr("quickSearch.globalHotkey"),
+ description: tr("quickSearch.globalHotkeyDesc"),
+ displayText: LauncherHotkey.quickSearch.displayString,
+ statusText: hotkeyStatusText(for: .quickSearch),
+ statusTone: hotkeyStatusTone(for: .quickSearch)
+ )
+ }
+ }
+
var body: some View {
ZStack {
TabView {
@@ -380,102 +484,112 @@
.frame(maxHeight: 250)
Spacer(minLength: 0)
- ShortcutHintView()
- .frame(maxWidth: .infinity, alignment: .center)
- .padding(.bottom, 2)
}
.frame(maxWidth: settingsContentWidth, alignment: .leading)
.tabItem { Label(tr("settings.language"), systemImage: "globe") }
.padding()
// Tab 2: General
- VStack(alignment: .leading, spacing: 0) {
- // Toggle row — centered as a rectangular block
- HStack(spacing: 20) {
- if AppDelegate.supportsLaunchAtLogin {
- Toggle(tr("settings.launchAtLogin"), isOn: $launchAtLogin)
- .onChange(of: launchAtLogin) { _, enabled in
- if enabled {
- AppDelegate.enableLaunchAtLogin()
- } else {
- AppDelegate.disableLaunchAtLogin()
+ ScrollView(.vertical, showsIndicators: true) {
+ VStack(alignment: .leading, spacing: 0) {
+ // Toggle row — centered as a rectangular block
+ HStack(spacing: 20) {
+ if AppDelegate.supportsLaunchAtLogin {
+ Toggle(tr("settings.launchAtLogin"), isOn: $launchAtLogin)
+ .onChange(of: launchAtLogin) { _, enabled in
+ if enabled {
+ AppDelegate.enableLaunchAtLogin()
+ } else {
+ AppDelegate.disableLaunchAtLogin()
+ }
+ }
+ }
+ Toggle(tr("settings.showInDock"), isOn: $showDockIcon)
+ .onChange(of: showDockIcon) { _, _ in
+ AppDelegate.refreshChromeSettings()
}
- }
- }
- Toggle(tr("settings.showInDock"), isOn: $showDockIcon)
- .onChange(of: showDockIcon) { _, _ in
- AppDelegate.refreshChromeSettings()
+ Toggle(tr("settings.hideAppNames"), isOn: $hideAppNames)
}
- Toggle(tr("settings.hideAppNames"), isOn: $hideAppNames)
- }
- .frame(maxWidth: .infinity, alignment: .center)
- .padding(.bottom, 16)
+ .frame(maxWidth: .infinity, alignment: .center)
+ .padding(.bottom, 16)
- Divider()
- .padding(.bottom, 16)
+ Divider()
+ .padding(.bottom, 16)
- VStack(spacing: 18) {
- generalSettingRow(tr("settings.appListStyle"), description: tr("settings.flatDesc")) {
- VStack(spacing: 8) {
- DisplayModeOptionButton(
- mode: "flat",
- title: tr("settings.flat"),
- isSelected: displayMode == "flat"
- ) {
- displayMode = "flat"
- }
-
- LazyVGrid(columns: displayModeColumns, alignment: .leading, spacing: 8) {
- ForEach(containerDisplayModeOptions, id: \.id) { option in
+ VStack(spacing: 18) {
+ generalSettingRow(tr("settings.appListStyle"), description: tr("settings.flatDesc")) {
+ VStack(spacing: 8) {
DisplayModeOptionButton(
- mode: option.id,
- title: option.title,
- isSelected: displayMode == option.id
+ mode: "flat",
+ title: tr("settings.flat"),
+ isSelected: displayMode == "flat"
) {
- displayMode = option.id
+ displayMode = "flat"
+ }
+
+ LazyVGrid(columns: displayModeColumns, alignment: .leading, spacing: 8) {
+ ForEach(containerDisplayModeOptions, id: \.id) { option in
+ DisplayModeOptionButton(
+ mode: option.id,
+ title: option.title,
+ isSelected: displayMode == option.id
+ ) {
+ displayMode = option.id
+ }
+ }
}
}
+ .frame(width: generalControlWidth, alignment: .leading)
+ }
+
+ generalSettingRow(tr("settings.tagPosition"), description: tr("settings.tagPosDesc")) {
+ Picker("", selection: $tagPosition) {
+ Text(tr("settings.left")).tag("left")
+ Text(tr("settings.right")).tag("right")
+ Text(tr("settings.top")).tag("top")
+ }
+ .pickerStyle(.segmented)
+ .frame(width: compactPickerWidth, alignment: .leading)
+ }
+
+ generalSettingRow(tr("settings.tagFontSize"), description: tr("settings.tagFontDesc")) {
+ Picker("", selection: $tagFontSize) {
+ ForEach([16.0, 18.0, 20.0, 22.0, 24.0, 26.0], id: \.self) { size in
+ Text("\(Int(size))").tag(size)
+ }
+ }
+ .pickerStyle(.segmented)
+ .frame(width: compactPickerWidth, alignment: .leading)
+ }
+
+ generalSettingRow(tr("settings.iconSize"), description: tr("settings.iconSizeDesc")) {
+ Picker("", selection: $iconSize) {
+ ForEach([40.0, 48.0, 56.0, 64.0, 72.0, 80.0], id: \.self) { size in
+ Text("\(Int(size))").tag(size)
+ }
+ }
+ .pickerStyle(.segmented)
+ .frame(width: compactPickerWidth, alignment: .leading)
}
}
- .frame(width: generalControlWidth, alignment: .leading)
}
-
- generalSettingRow(tr("settings.tagPosition"), description: tr("settings.tagPosDesc")) {
- Picker("", selection: $tagPosition) {
- Text(tr("settings.left")).tag("left")
- Text(tr("settings.right")).tag("right")
- Text(tr("settings.top")).tag("top")
- }
- .pickerStyle(.segmented)
- .frame(width: compactPickerWidth, alignment: .leading)
- }
-
- generalSettingRow(tr("settings.tagFontSize"), description: tr("settings.tagFontDesc")) {
- Picker("", selection: $tagFontSize) {
- ForEach([16.0, 18.0, 20.0, 22.0, 24.0, 26.0], id: \.self) { size in
- Text("\(Int(size))").tag(size)
- }
- }
- .pickerStyle(.segmented)
- .frame(width: compactPickerWidth, alignment: .leading)
- }
-
- generalSettingRow(tr("settings.iconSize"), description: tr("settings.iconSizeDesc")) {
- Picker("", selection: $iconSize) {
- ForEach([40.0, 48.0, 56.0, 64.0, 72.0, 80.0], id: \.self) { size in
- Text("\(Int(size))").tag(size)
- }
- }
- .pickerStyle(.segmented)
- .frame(width: compactPickerWidth, alignment: .leading)
- }
+ .frame(maxWidth: generalContentWidth, alignment: .center)
+ .padding()
}
- }
- .frame(maxWidth: generalContentWidth, alignment: .center)
- .padding()
- .tabItem { Label(tr("settings.general"), systemImage: "gearshape") }
+ .tabItem { Label(tr("settings.general"), systemImage: "gearshape") }
- // Tab 3: Tags
+ // Tab 3: Hotkeys
+ ScrollView(.vertical, showsIndicators: true) {
+ VStack(alignment: .leading, spacing: 16) {
+ hotkeySettingsPanel()
+ .frame(width: generalContentWidth, alignment: .leading)
+ }
+ .frame(maxWidth: generalContentWidth, alignment: .center)
+ .padding()
+ }
+ .tabItem { Label(tr("quickSearch.hotkeys"), systemImage: "keyboard") }
+
+ // Tab 4: Tags
VStack(spacing: 0) {
TagEditorView(
tagColors: $tagColors,
@@ -486,7 +600,7 @@
.tabItem { Label(tr("settings.tags"), systemImage: "tag.fill") }
.onAppear { scanApps() }
- // Tab 4: Data
+ // Tab 5: Data
VStack(spacing: 0) {
Spacer(minLength: 32)
@@ -626,7 +740,7 @@
.padding()
.onAppear { refreshDataState() }
- // Tab 5: About
+ // Tab 6: About
VStack(spacing: 0) {
Spacer(minLength: 72)
@@ -653,7 +767,7 @@
Text("万物之中，希望最美")
.font(.caption)
.foregroundStyle(.secondary)
- Text("永桔@2026-18602102518")
+ Text("永桔@shanghai3168@gmail.com")
.font(.caption)
.foregroundStyle(.secondary)
}
@@ -661,8 +775,6 @@
.frame(width: 560, alignment: .leading)
Spacer(minLength: 30)
- ShortcutHintView()
- .frame(maxWidth: .infinity, alignment: .center)
Spacer(minLength: 18)
}
.tabItem { Label(tr("settings.about"), systemImage: "info.circle") }
@@ -713,10 +825,36 @@
.zIndex(3)
.transition(.opacity)
}
+
+ if let hotkeyStatusToast {
+ VStack {
+ Spacer()
+ Text(hotkeyStatusToast)
+ .font(.system(size: 13, weight: .semibold))
+ .foregroundStyle(.white)
+ .multilineTextAlignment(.center)
+ .lineSpacing(2)
+ .padding(.horizontal, 18)
+ .padding(.vertical, 12)
+ .background(
+ RoundedRectangle(cornerRadius: 8, style: .continuous)
+ .fill(Color.black.opacity(0.92))
+ )
+ .shadow(color: .black.opacity(0.28), radius: 18, y: 10)
+ .frame(maxWidth: 620)
+ .padding(.bottom, 22)
+ }
+ .zIndex(4)
+ .transition(.opacity.combined(with: .move(edge: .bottom)))
+ }
}
.frame(width: settingsWindowWidth, height: 460)
.onAppear {
syncSelectedLanguage()
+ showPendingHotkeyWarningIfNeeded()
+ }
+ .onReceive(NotificationCenter.default.publisher(for: .tagLauncherHotkeyRegistrationChanged)) { _ in
+ showPendingHotkeyWarningIfNeeded()
}
}
@@ -727,6 +865,71 @@
isRefreshingLanguage = false
}
}
+ }
+}
+
+private enum HotkeyStatusTone {
+ case active
+ case warning
+ case neutral
+
+ var foreground: Color {
+ switch self {
+ case .active: return Color.green
+ case .warning: return Color.orange
+ case .neutral: return Color.secondary
+ }
+ }
+
+ var background: Color {
+ foreground.opacity(0.13)
+ }
+}
+
+private struct StaticHotkeyInfoRow: View {
+ let title: String
+ let description: String
+ let displayText: String
+ let statusText: String
+ let statusTone: HotkeyStatusTone
+
+ var body: some View {
+ VStack(alignment: .leading, spacing: 12) {
+ HStack(alignment: .top, spacing: 12) {
+ VStack(alignment: .leading, spacing: 3) {
+ Text(title)
+ .font(.system(size: 13, weight: .semibold))
+ Text(description)
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ .fixedSize(horizontal: false, vertical: true)
+ }
+ .frame(maxWidth: .infinity, alignment: .leading)
+
+ VStack(alignment: .leading, spacing: 4) {
+ Text(displayText)
+ .font(.system(size: 15, weight: .semibold))
+ .lineLimit(1)
+ .minimumScaleFactor(0.85)
+ Text(statusText)
+ .font(.system(size: 11, weight: .semibold))
+ .foregroundStyle(statusTone.foreground)
+ .padding(.horizontal, 8)
+ .padding(.vertical, 3)
+ .background(Capsule().fill(statusTone.background))
+ }
+ .frame(width: 180, alignment: .leading)
+ }
+ }
+ .padding(12)
+ .background(
+ RoundedRectangle(cornerRadius: 8, style: .continuous)
+ .fill(Color(nsColor: .controlBackgroundColor))
+ )
+ .overlay(
+ RoundedRectangle(cornerRadius: 8, style: .continuous)
+ .stroke(Color.secondary.opacity(0.14), lineWidth: 1)
+ )
}
}
@@ -924,60 +1127,5 @@
}
let palette: [Color] = [.green, .purple, .blue, .orange]
return palette[index % palette.count].opacity(0.78)
- }
-}
-
-private struct ShortcutHintView: View {
- var body: some View {
- HStack(spacing: 12) {
- ShortcutKeycap(symbol: "⌥")
- Text("+")
- .font(.system(size: 22, weight: .semibold))
- .foregroundStyle(.tertiary)
- ShortcutKeycap(symbol: "⇧")
- Text("+")
- .font(.system(size: 22, weight: .semibold))
- .foregroundStyle(.tertiary)
- SpacebarKeycap()
- }
- .accessibilityLabel("⌥ ⇧ Space")
- .allowsHitTesting(false)
- }
-}
-
-private struct ShortcutKeycap: View {
- let symbol: String
-
- var body: some View {
- Text(symbol)
- .font(.system(size: 36, weight: .medium))
- .foregroundStyle(.secondary)
- .frame(width: 74, height: 58)
- .background(KeycapBackground())
- }
-}
-
-private struct SpacebarKeycap: View {
- var body: some View {
- ZStack {
- KeycapBackground()
- Capsule()
- .fill(Color.secondary.opacity(0.38))
- .frame(width: 72, height: 3)
- .offset(y: 13)
- }
- .frame(width: 190, height: 58)
- }
-}
-
-private struct KeycapBackground: View {
- var body: some View {
- RoundedRectangle(cornerRadius: 10, style: .continuous)
- .fill(Color(nsColor: .controlBackgroundColor))
- .overlay(
- RoundedRectangle(cornerRadius: 10, style: .continuous)
- .stroke(Color.primary.opacity(0.12), lineWidth: 1)
- )
- .shadow(color: .black.opacity(0.10), radius: 8, x: 0, y: 3)
}
}
--
Gitblit v1.9.3