Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/MainWindowView.swift
T
Qiu Yuzhou aaabb4f7ea refactor(ui): 订阅与诊断分区自持错误弹窗,塌缩两个 destination 包装壳
SubscriptionsView/DiagnosticsView 改为自持 ErrorAlertPresenter 并经
presentingErrors 挂载(与 ServersView 同法),只为转发 presenter 而存在的
WorkspaceSubscriptionsView/WorkspaceDiagnosticsView 整体删除,窗口壳
destinationView 直挂分区视图;WorkspaceHomeView 因承载旧版导入主动弹窗
保留。穿透链 13 个类型减至 11 个,presenter owner 减至 3 个。
2026-10-03 13:29:15 +08:00

469 lines
16 KiB
Swift
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import SwiftUI
private enum WorkspaceSheet: String, Identifiable {
case importURL
case qrImport
case legacyImport
case addSubscription
var id: String { rawValue }
var destination: WorkspaceDestination {
switch self {
case .importURL, .qrImport, .legacyImport:
.servers
case .addSubscription:
.subscriptions
}
}
}
/// 主窗口外壳(地图 #52,票 #53):NavigationSplitView 侧栏承载五项导航与
/// 底部常驻代理状态卡;详情区按 route destination 承载各分区视图。分区名即
/// 窗口标题(navigationTitle 绑定 route destination,ADR 0016 的 scene 版
/// 窗口原生呈现);订阅/诊断的页级动作经 .toolbar 桥接进窗口工具栏右端
/// (票 #56/#58 的槽位仅呈现位置变化),设置的表单级提交动作在其视图内容
/// 顶部(见 SettingsView)。路由状态仍由 WorkspaceRoute 持有;代理状态卡的
/// 状态与摘要只来自代理控制工作流的整体 snapshot(issue #47),与状态菜单
/// 使用同一口径;服务器分区的活动目标标记同源(snapshot.activeTarget)。
struct MainWindowView: View {
@ObservedObject var rulesWorkflow: RulesWorkflow
@ObservedObject var route: WorkspaceRoute
@ObservedObject var workflow: CatalogWorkflow
@ObservedObject var control: ProxyControlWorkflow
@ObservedObject var diagnostics: DiagnosticsWorkflow
@ObservedObject var settingsWorkflow: SettingsWorkflow
@ObservedObject var loginController: LaunchAtLoginController
@ObservedObject var silentLaunch: SilentLaunchController
/// 目录树折叠状态:组合根持有的长寿命对象,跨 destination 切换存续;服务器
/// 侧栏使用(见 CatalogExpansionState);首页独立保存浏览状态。
@ObservedObject var expansion: CatalogExpansionState
let clipboard: any TextClipboard
let diagnosticReportExporter: any DiagnosticReportExporter
let configurationGroupFileExporter: any ConfigurationGroupFileExporter
@StateObject private var homeServerList = HomeServerListState()
/// 侧栏选中项中转:macOS 的 List/NavigationSplitView 会在视图更新期间回写
/// selection(选择再同步,且可能携带缓存的旧值),回写必须落在 SwiftUI 自管
/// 的 @State 上,再经 onChange 单向驱动 route;直接 publish 到 route 会触发
/// view-update 期间发布警告,且缓存的旧值会把外部导航弹回。route 的外部
/// 导航(添加菜单、规则编辑器返回等)经 sidebar 上的 onChange 回填选中项。
/// 初值须与 WorkspaceRoute 的初始 destination 对齐,否则首帧侧栏无高亮行。
@State private var sidebarSelection: WorkspaceDestination? = WorkspaceRoute.initialDestination
@State private var selection: NodeID?
@State private var ruleDraft: CustomRuleDraft?
/// 全局添加菜单打开的表单,以及诊断导出由窗口壳持有。
@State private var presentedWorkspaceSheet: WorkspaceSheet?
@State private var exportedDiagnosticsPath: String?
@StateObject private var shellActionErrors = ErrorAlertPresenter()
var body: some View {
NavigationSplitView {
sidebar
.navigationSplitViewColumnWidth(min: 210, ideal: 236, max: 300)
.toolbar {
ToolbarItem(placement: .automatic) {
addMenu
}
}
} detail: {
destinationView
}
.onChange(of: workflow.tree, initial: true) {
homeServerList.update(tree: workflow.tree, activeTargetID: control.snapshot.activeTarget?.id)
}
.navigationTitle(route.destination.label)
.frame(minWidth: 920, minHeight: 580)
.toolbar {
ToolbarItemGroup(placement: .primaryAction) {
destinationActions
}
}
.sheet(item: $presentedWorkspaceSheet) { sheet in
switch sheet {
case .importURL:
ImportURLSheet(
workflow: workflow, errors: shellActionErrors, clipboard: clipboard,
selection: $selection)
case .qrImport:
QRImportSheet(workflow: workflow, errors: shellActionErrors, selection: $selection)
case .legacyImport:
LegacyImportSheet(workflow: workflow)
case .addSubscription:
AddSubscriptionSheet(workflow: workflow, errors: shellActionErrors)
}
}
.sheet(item: $ruleDraft) { draft in
CustomRuleEditorSheet(workflow: rulesWorkflow, draft: draft) { route.navigate(to: .home) }
}
.onChange(of: route.destination) { _, destination in
if destination != .rules { ruleDraft = nil }
}
.presentingErrors(shellActionErrors)
.alert(
"诊断已导出",
isPresented: Binding(
get: { exportedDiagnosticsPath != nil },
set: { if !$0 { exportedDiagnosticsPath = nil } })
) {
Button("好", role: .cancel) {}
} message: {
Text(exportedDiagnosticsPath ?? "")
}
}
// MARK: - 分区动作槽位
private var addMenu: some View {
Menu {
Button("通过 URL 导入…") { presentWorkspaceSheet(.importURL) }
Button("从二维码图片导入…") { presentWorkspaceSheet(.qrImport) }
if workflow.legacyImportState.snapshotFound {
Button(legacyImportActionTitle) { presentWorkspaceSheet(.legacyImport) }
}
Divider()
Button("添加订阅…") { presentWorkspaceSheet(.addSubscription) }
} label: {
Label("添加", systemImage: "plus")
}
.labelStyle(.iconOnly)
.help("添加")
}
private var legacyImportActionTitle: String {
workflow.legacyImportState.completed ? "再次导入旧版本服务器…" : "导入旧版本服务器…"
}
private func presentWorkspaceSheet(_ sheet: WorkspaceSheet) {
route.navigate(to: sheet.destination)
presentedWorkspaceSheet = sheet
}
/// 分区动作(票 #53/#56/#57):页级动作随 destination 切换,经工具栏桥接
/// 出现在窗口工具栏右端;首页/服务器无页级动作。例外:设置的保存/恢复
/// 默认是表单级提交动作,由 SettingsView 内容顶部行承载(动作与表单同置,
/// 工具栏呈现效果差)。sheet/alert 呈现状态仍由壳持有,本处只负责动作的
/// 呈现。
@ViewBuilder
private var destinationActions: some View {
switch route.destination {
case .subscriptions:
HStack(spacing: 8) {
if !workflow.refreshingSubscriptionIDs.isEmpty {
ProgressView()
.controlSize(.small)
}
Button("更新全部", systemImage: "arrow.triangle.2.circlepath") {
Task { await workflow.refreshAllSubscriptions() }
}
.disabled(workflow.subscriptions.isEmpty)
}
case .rules:
Button(RulesCopy.text("新增规则"), systemImage: "plus") {
ruleDraft = rulesWorkflow.makeCustomRuleDraft()
}.disabled(!rulesWorkflow.snapshot.isComplete)
case .diagnostics:
Button("导出诊断…", systemImage: "square.and.arrow.up") {
exportDiagnostics()
}
case .home, .servers, .settings:
EmptyView()
}
}
/// 诊断导出(票 #58):沿用 DiagnosticReportExportAction 既有入口;文件写
/// 入成功后才登记导出完成事件。
private func exportDiagnostics() {
switch DiagnosticReportExportAction(
diagnostics: diagnostics, exporter: diagnosticReportExporter
).perform()
{
case .preparationFailed(let failure):
shellActionErrors.present(failure)
case .cancelled:
break
case .saved(let url):
diagnostics.noteExportCompleted()
exportedDiagnosticsPath = url.path
case .exportFailed(let failure):
shellActionErrors.present(failure)
}
}
// MARK: - 分区承载
@ViewBuilder
private var destinationView: some View {
switch route.destination {
case .home:
WorkspaceHomeView(
workflow: workflow,
control: control,
serverList: homeServerList,
clipboard: clipboard,
onManageServers: { route.navigate(to: .servers) })
case .servers:
ServersView(
workflow: workflow,
activeTargetID: control.snapshot.activeTarget?.id,
selection: $selection,
expansion: expansion,
clipboard: clipboard,
configurationGroupFileExporter: configurationGroupFileExporter)
case .subscriptions:
SubscriptionsView(
workflow: workflow,
onNodesRemoved: clearSelectionIfInvalidated)
case .rules:
RulesView(
workflow: rulesWorkflow, onShowRuntime: { route.navigate(to: .home) },
onEditRule: { ruleDraft = rulesWorkflow.makeCustomRuleDraft(editing: $0) })
case .settings:
SettingsView(
workflow: settingsWorkflow, loginController: loginController,
silentLaunch: silentLaunch
)
.frame(maxWidth: .infinity, maxHeight: .infinity)
case .diagnostics:
DiagnosticsView(
diagnostics: diagnostics,
clipboard: clipboard)
}
}
private func clearSelectionIfInvalidated(_ removed: Set<NodeID>) {
if let selection, removed.contains(selection) {
self.selection = nil
}
}
}
extension WorkspaceDestination {
var label: String {
switch self {
case .home: "首页"
case .servers: "服务器"
case .subscriptions: "订阅"
case .rules: RulesCopy.text("代理规则")
case .settings: "设置"
case .diagnostics: "诊断"
}
}
var systemImage: String {
switch self {
case .home: "house"
case .servers: "server.rack"
case .subscriptions: "arrow.triangle.2.circlepath"
case .rules: "list.bullet.rectangle"
case .settings: "gearshape"
case .diagnostics: "chart.bar"
}
}
}
// MARK: - 侧栏与底部代理状态卡(同文件扩展,保持 private 访问)
extension MainWindowView {
// MARK: - 侧栏
private var sidebar: some View {
List(selection: $sidebarSelection) {
Section {
ForEach(WorkspaceDestination.allCases) { destination in
sidebarRow(destination)
.tag(destination)
}
}
}
.listStyle(.sidebar)
// 点击行 → @State 选中项 → route;nil 回写无对应 destination,忽略。
.onChange(of: sidebarSelection) { _, destination in
guard let destination else { return }
route.navigate(to: destination)
}
// route 的外部导航 → 回填选中项;等值不写,避免导航回声。
.onChange(of: route.destination) { _, destination in
if sidebarSelection != destination {
sidebarSelection = destination
}
}
.safeAreaInset(edge: .top, spacing: 4) { identityHeader }
.safeAreaInset(edge: .bottom, spacing: 4) { statusCard }
}
private var identityHeader: some View {
HStack(spacing: 10) {
ZStack {
RoundedRectangle(cornerRadius: 8, style: .continuous)
.fill(Color.primary)
Image(systemName: "paperplane.fill")
.font(.system(size: 15, weight: .semibold))
.foregroundStyle(Color(nsColor: .windowBackgroundColor))
}
.frame(width: 30, height: 30)
Text("ShadowsocksX-NG2")
.font(.headline)
Spacer(minLength: 0)
}
.padding(.leading, 16)
.padding(.trailing, 12)
.padding(.top, 12)
.padding(.bottom, 4)
}
private func sidebarRow(_ destination: WorkspaceDestination) -> some View {
HStack(spacing: 8) {
Label(destination.label, systemImage: destination.systemImage)
Spacer(minLength: 0)
if let count = badgeCount(for: destination) {
Text("\(count)")
.font(.caption2.monospacedDigit())
.foregroundStyle(.secondary)
.padding(.horizontal, 6)
.padding(.vertical, 1)
.background(Capsule().fill(.quaternary))
}
}
}
/// 行尾数量角标:服务器 = 目录树内服务器叶子数;订阅 = 订阅数。
private func badgeCount(for destination: WorkspaceDestination) -> Int? {
switch destination {
case .servers:
serverLeafCount > 0 ? serverLeafCount : nil
case .subscriptions:
workflow.subscriptions.isEmpty ? nil : workflow.subscriptions.count
default:
nil
}
}
private var serverLeafCount: Int {
func leaves(_ nodes: [CatalogTreeNode]) -> Int {
nodes.reduce(0) { $0 + ($1.isGroup ? leaves($1.childNodes) : 1) }
}
return leaves(workflow.tree.roots)
}
// MARK: - 底部代理状态卡
/// 底部状态卡(issue #60):分别呈现 agent 运行状态、系统代理实际应用、
/// 活动目标与模式;所有状态均来自同一 snapshot。
private var statusCard: some View {
let summary = StatusMenuModel.summary(from: control.snapshot)
let targetDisplay = targetPresentation(for: summary)
return VStack(alignment: .leading, spacing: 7) {
statusRow("后台代理", value: summary.status, color: runtimeStatusColor)
if let detail = summary.detail {
statusDetail(detail, color: runtimeDetailColor)
}
statusRow(
"系统代理设置", value: summary.systemProxyStateLabel, color: systemProxyStatusColor)
if let systemProxyDetail = summary.systemProxyDetail {
statusDetail(systemProxyDetail, color: .red)
}
Text(targetDisplay.text)
.font(.footnote.weight(.medium))
.lineLimit(1)
.truncationMode(.middle)
.help(targetDisplay.help)
.accessibilityElement(children: .ignore)
.accessibilityLabel("活动目标:\(targetDisplay.text)")
HStack(spacing: 0) {
Text("模式:")
.foregroundStyle(.secondary)
Text(control.snapshot.proxyMode.label)
if control.snapshot.proxyMode == .rule {
Text("·")
Text(control.snapshot.ruleDefaultAction.label)
}
}
.font(.caption)
.accessibilityElement(children: .combine)
}
.frame(maxWidth: .infinity, alignment: .leading)
.padding(12)
.background(.background.secondary, in: RoundedRectangle(cornerRadius: 10, style: .continuous))
.overlay(
RoundedRectangle(cornerRadius: 10, style: .continuous)
.strokeBorder(.quaternary)
)
.padding(.horizontal, 12)
.padding(.top, 8)
.padding(.bottom, 12)
}
private func statusRow(_ label: String, value: String, color: Color) -> some View {
HStack(spacing: 4) {
Text("\(label):")
.foregroundStyle(.secondary)
Text(value)
.fontWeight(.semibold)
.foregroundStyle(color)
}
.font(.footnote)
.lineLimit(1)
.accessibilityElement(children: .combine)
}
private func statusDetail(_ detail: String, color: Color) -> some View {
Text(detail)
.font(.caption)
.foregroundStyle(color)
.lineLimit(2)
.frame(maxWidth: .infinity, alignment: .leading)
.help(detail)
}
private func targetPresentation(for summary: StatusMenuModel.Summary) -> (
text: String, help: String
) {
if let targetPath = summary.targetPath {
return (targetPath, "活动目标:\(targetPath)")
}
if control.snapshot.proxyMode == .direct {
return ("直连模式(无需服务器)", "直连模式无需选择活动目标")
}
return ("未激活", "未设置活动目标;在首页或服务器目录中激活")
}
private var runtimeStatusColor: Color {
switch control.snapshot.runtime.status {
case .running:
.green
case .starting:
.secondary
case .off:
.secondary
case .firewallBlocked, .requiresApproval:
.orange
case .launchFailed, .serviceFailed:
.red
}
}
private var runtimeDetailColor: Color {
if control.snapshot.runtime.failure != nil {
return runtimeStatusColor
}
return control.snapshot.activationFailure == nil ? .secondary : .red
}
private var systemProxyStatusColor: Color {
switch control.snapshot.systemProxyApplication {
case .idle:
.secondary
case .pending, .changed, .applying, .repairing, .paused:
.orange
case .applied:
.green
case .failed, .repairFailed, .clearFailed, .unreadable:
.red
}
}
}