feat: add settings UI with refresh rate and app blacklist

- Add AppSettings: UserDefaults-backed observable settings manager
  - Configurable refresh interval (1/2/3/5/10 seconds)
  - Minimum traffic threshold filter (All/1KB/10KB/100KB)
  - App blacklist with add/remove support
- Add SettingsView: inline settings panel in dropdown menu
- Integrate settings into AppDelegate:
  - Apply blacklist filter to traffic items
  - Apply threshold from settings
  - Auto-restart nettop when refresh interval changes (Combine)
  - Dynamic menu height via NSMenuDelegate
- Add NSLock thread safety to NetworkDetails.update()
- Update README: replace screenshots with ASCII art, update feature list
- Add localization strings for all new UI elements (en/zh-Hans)

Author: cnfatal

NetworkStatusBar.xcodeproj/project.pbxproj

@@ -17,6 +17,8 @@
 		BE3EC932272FA7B8005AC578 /* NetworkStatus.swift in Sources */ = {isa = PBXBuildFile; fileRef = BE3EC92F272FA7B8005AC578 /* NetworkStatus.swift */; };
 		BE3EC933272FA7B8005AC578 /* StatusBarDetailsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = BE3EC930272FA7B8005AC578 /* StatusBarDetailsView.swift */; };
 		BE3EC935272FA827005AC578 /* Localizable.strings in Resources */ = {isa = PBXBuildFile; fileRef = BE3EC937272FA827005AC578 /* Localizable.strings */; };
+		AA0001012026021600000001 /* AppSettings.swift in Sources */ = {isa = PBXBuildFile; fileRef = AA0001002026021600000001 /* AppSettings.swift */; };
+		AA0001032026021600000002 /* SettingsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = AA0001022026021600000002 /* SettingsView.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXContainerItemProxy section */
@@ -55,6 +57,8 @@
 		BE3EC93E272FC761005AC578 /* statusbar-snapshot.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = "statusbar-snapshot.png"; sourceTree = "<group>"; };
 		BE3EC93F272FC7A1005AC578 /* details-snapshot.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = "details-snapshot.png"; sourceTree = "<group>"; };
 		BE3EC940272FC8CD005AC578 /* LICENSE */ = {isa = PBXFileReference; lastKnownFileType = text; path = LICENSE; sourceTree = "<group>"; };
+		AA0001002026021600000001 /* AppSettings.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppSettings.swift; sourceTree = "<group>"; };
+		AA0001022026021600000002 /* SettingsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsView.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -109,10 +113,12 @@
 			isa = PBXGroup;
 			children = (
 				BE3EC902272FA6E6005AC578 /* NetworkStatusBarApp.swift */,
+				AA0001002026021600000001 /* AppSettings.swift */,
 				BE3EC92D272FA7A2005AC578 /* StatusBarView.swift */,
 				BE3EC937272FA827005AC578 /* Localizable.strings */,
 				BE3EC92F272FA7B8005AC578 /* NetworkStatus.swift */,
 				BE3EC930272FA7B8005AC578 /* StatusBarDetailsView.swift */,
+				AA0001022026021600000002 /* SettingsView.swift */,
 				BE3EC906272FA6E7005AC578 /* Assets.xcassets */,
 				BE3EC90B272FA6E7005AC578 /* NetworkStatusBar.entitlements */,
 				BE3EC908272FA6E7005AC578 /* Preview Content */,
@@ -290,6 +296,8 @@
 				BE3EC92E272FA7A2005AC578 /* StatusBarView.swift in Sources */,
 				BE3EC903272FA6E6005AC578 /* NetworkStatusBarApp.swift in Sources */,
 				BE3EC933272FA7B8005AC578 /* StatusBarDetailsView.swift in Sources */,
+				AA0001012026021600000001 /* AppSettings.swift in Sources */,
+				AA0001032026021600000002 /* SettingsView.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};

NetworkStatusBar/AppSettings.swift

@@ -0,0 +1,80 @@
+//
+//  AppSettings.swift
+//  NetworkStatusBar
+//
+//  Settings management using UserDefaults with observable properties.
+//
+
+import Combine
+import Foundation
+
+final class AppSettings: ObservableObject {
+  static let shared = AppSettings()
+
+  private let defaults = UserDefaults.standard
+
+  private enum Keys {
+    static let refreshInterval = "refreshInterval"
+    static let blacklist = "blacklist"
+    static let showInactiveApps = "showInactiveApps"
+    static let minTrafficThreshold = "minTrafficThreshold"
+  }
+
+  /// Refresh interval in seconds (1-10)
+  @Published var refreshInterval: Int {
+    didSet {
+      defaults.set(refreshInterval, forKey: Keys.refreshInterval)
+    }
+  }
+
+  /// Blacklisted app names that won't appear in the details list
+  @Published var blacklist: [String] {
+    didSet {
+      defaults.set(blacklist, forKey: Keys.blacklist)
+    }
+  }
+
+  /// Whether to show apps with zero traffic
+  @Published var showInactiveApps: Bool {
+    didSet {
+      defaults.set(showInactiveApps, forKey: Keys.showInactiveApps)
+    }
+  }
+
+  /// Minimum traffic threshold in bytes to show an app (default 1024)
+  @Published var minTrafficThreshold: Int {
+    didSet {
+      defaults.set(minTrafficThreshold, forKey: Keys.minTrafficThreshold)
+    }
+  }
+
+  private init() {
+    let interval = defaults.integer(forKey: Keys.refreshInterval)
+    self.refreshInterval = interval > 0 ? interval : 1
+
+    self.blacklist = defaults.stringArray(forKey: Keys.blacklist) ?? []
+
+    if defaults.object(forKey: Keys.showInactiveApps) != nil {
+      self.showInactiveApps = defaults.bool(forKey: Keys.showInactiveApps)
+    } else {
+      self.showInactiveApps = false
+    }
+
+    let threshold = defaults.integer(forKey: Keys.minTrafficThreshold)
+    self.minTrafficThreshold = threshold > 0 ? threshold : 1024
+  }
+
+  func addToBlacklist(_ name: String) {
+    let trimmed = name.trimmingCharacters(in: .whitespaces)
+    guard !trimmed.isEmpty, !blacklist.contains(trimmed) else { return }
+    blacklist.append(trimmed)
+  }
+
+  func removeFromBlacklist(_ name: String) {
+    blacklist.removeAll { $0 == name }
+  }
+
+  func isBlacklisted(_ name: String) -> Bool {
+    return blacklist.contains(name)
+  }
+}

NetworkStatusBar/NetworkStatus.swift

@@ -27,6 +27,7 @@ open class NetworkDetails {
 
   var laststate: DataFrame = DataFrame()
   var process: Process = Process()
+  private let lock = NSLock()
 
   init() {
     self.prepare()
@@ -75,6 +76,9 @@ open class NetworkDetails {
     if data.isEmpty {
       return
     }
+    lock.lock()
+    defer { lock.unlock() }
+
     var dataframe = (try? DataFrame(csvData: data, columns: Columns)) ?? DataFrame.init()
     if #available(macOS 13.0, *) {
       dataframe.renameColumn("Column 0", to: ColumnName)

NetworkStatusBar/NetworkStatusBarApp.swift

@@ -5,6 +5,7 @@
 //  Created by fatal cn on 2021/10/31.
 //
 
+import Combine
 import SwiftUI
 
 @main
@@ -23,13 +24,17 @@ class AppDelegate: NSObject, NSApplicationDelegate {
   var statusItem: NSStatusItem?
 
   var networkStatus: NetworkDetails = NetworkDetails()
+  let settings = AppSettings.shared
+  private var cancellables = Set<AnyCancellable>()
 
   func onUpdate(update: NetworkStates) {
     DispatchQueue.main.async {
       self.iostates.total = update.total
-      self.iostates.items = update.items.filter({ item in
-        return item.total > 1024
-      })
+      let threshold = self.settings.minTrafficThreshold
+      let blacklist = self.settings.blacklist
+      self.iostates.items = update.items.filter { item in
+        return item.total >= threshold && !blacklist.contains(item.name)
+      }
     }
   }
 
@@ -41,36 +46,65 @@ class AppDelegate: NSObject, NSApplicationDelegate {
     statusItem = NSStatusBar.system.statusItem(withLength: 62)
 
     networkStatus.callback = onUpdate
-    DispatchQueue.global(qos: .userInteractive).async {
-      self.networkStatus.run(refreshSeconds: 1)
-    }
+    startNetworkMonitoring()
+
+    // Watch for refresh interval changes
+    settings.$refreshInterval
+      .dropFirst()
+      .removeDuplicates()
+      .sink { [weak self] _ in
+        self?.restartNetworkMonitoring()
+      }
+      .store(in: &cancellables)
 
     if let button = statusItem?.button {
       let statusbarview = NSHostingView(rootView: StatusBarView(iostates: iostates))
       statusbarview.frame = NSRect(x: 0, y: 0, width: 62, height: button.frame.height)
       button.addSubview(statusbarview)
     }
 
-    statusItem?.menu = {
-      let menu = NSMenu()
-      menu.items = [
-        {
-          let menuitem = NSMenuItem()
-          let detailsView = StatusBarDetailsView(iostates: iostates)
-          let hostingView = NSHostingView(rootView: detailsView)
-          hostingView.setFrameSize(NSSize(width: 280, height: 320))
-          menuitem.view = hostingView
-          return menuitem
-        }(),
-        NSMenuItem.separator(),
-        NSMenuItem(
-          title: NSLocalizedString("quit", comment: "quit the application"),
-          action: #selector(quit),
-          keyEquivalent: "q"
-        ),
-      ]
-      return menu
-    }()
+    setupMenu()
+  }
+
+  private func startNetworkMonitoring() {
+    DispatchQueue.global(qos: .userInteractive).async {
+      self.networkStatus.run(refreshSeconds: self.settings.refreshInterval)
+    }
+  }
+
+  private func restartNetworkMonitoring() {
+    networkStatus.stop()
+    startNetworkMonitoring()
+  }
+
+  private func setupMenu() {
+    let menu = NSMenu()
+    menu.delegate = self
+
+    let detailsItem = NSMenuItem()
+    let detailsView = StatusBarDetailsView(iostates: iostates)
+    let hostingView = NSHostingView(rootView: detailsView)
+    hostingView.setFrameSize(NSSize(width: 280, height: 320))
+    detailsItem.view = hostingView
+
+    let settingsItem = NSMenuItem()
+    let settingsHostingView = NSHostingView(rootView: SettingsView())
+    settingsHostingView.setFrameSize(NSSize(width: 280, height: 10))
+    settingsItem.view = settingsHostingView
+
+    menu.items = [
+      detailsItem,
+      NSMenuItem.separator(),
+      settingsItem,
+      NSMenuItem.separator(),
+      NSMenuItem(
+        title: NSLocalizedString("quit", comment: "quit the application"),
+        action: #selector(quit),
+        keyEquivalent: "q"
+      ),
+    ]
+
+    statusItem?.menu = menu
   }
 
   func applicationWillTerminate(_ notification: Notification) {
@@ -81,3 +115,20 @@ class AppDelegate: NSObject, NSApplicationDelegate {
     NSApp.terminate(nil)
   }
 }
+
+extension AppDelegate: NSMenuDelegate {
+  func menuWillOpen(_ menu: NSMenu) {
+    // Resize details view based on content
+    if let detailsView = menu.items.first?.view as? NSHostingView<StatusBarDetailsView> {
+      let fittingSize = detailsView.fittingSize
+      detailsView.setFrameSize(NSSize(width: 280, height: max(fittingSize.height, 80)))
+    }
+    // Resize settings view
+    if menu.items.count > 2,
+      let settingsView = menu.items[2].view as? NSHostingView<SettingsView>
+    {
+      let fittingSize = settingsView.fittingSize
+      settingsView.setFrameSize(NSSize(width: 280, height: fittingSize.height))
+    }
+  }
+}