Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/ProxyStatusMenu.swift
T
Qiu Yuzhou 2fe401cd50 feat(ng2): add catalog workflow module as single UI-facing seam (#41)
建立目录工作流深 module(App/CatalogWorkflow/),收窄主窗口与配置 UI 对
配置目录、凭据存储、订阅快照、Legacy 导入与运行时收敛的访问:

- UI-facing interface:非敏感树/编辑面/订阅 projection、opaque NodeID 查询、
  typed command(ServerEditDraft 等)、typed error 与 structured outcome
  (BatchImportOutcome 逐行点名、RemovalOutcome selection invalidation);
  秘密值只在显式编辑/分享/订阅 URL 命令中出现。
- 服务器编辑:配置与凭据作为一个逻辑变更,CredentialWriteJournal 保证目录
  持久化失败时旧配置与旧凭据都保持有效(story 12/13,含测试)。
- 提交与收敛分离:目录提交成功与 runtimeSync 收敛阶段是独立观察面,运行时
  失败不回滚已提交目录(story 38/39,含测试)。
- 订阅:创建/刷新/换址/删除沿用原子快照、last-good 保留与凭据回滚;卡片
  projection 只含 host,结构化刷新状态由呈现层本地化。
- Legacy 导入端到端编排:不驱动运行时收敛、不自动重复、显式再导入创建独立
  分组;handoff 仍经组合根注入的独立边界。
- Deletion test:删除 CatalogViewModel/Types/+Subscriptions 旧 facade,全部
  视图与状态菜单迁移到新 seam;选择、pane、sheet、alert 状态收归 UI 持有
  (ErrorAlertPresenter)。导入失败行以行号点名,不再回显 ss:// 行内容。

测试经 module interface 观察(395 项全部通过):持久化失败凭据回滚、提交/
收敛阶段分离、收敛失败不回滚、导入不触发运行时等新增场景;既有 Domain、
协调器与运行时测试保持不变。

Out of scope(spec #41):设置编辑、ProxyRuntimeController、Legacy handoff、
新视觉设计、独立编译 target。
2026-09-22 11:39:07 +08:00

164 lines
5.4 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 AppKit
import SwiftUI
/// 状态菜单(spec #21 D11 八项白名单,issue #31/#41):①头部状态摘要(运行
/// 状态、当前模式、活动目标)②代理开关 ③模式选择(勾选态)④活动目标级联
/// 选择器(组树子菜单、只读)⑤立即更新全部订阅 ⑥复制 HTTP 导出行 ⑦打开主
/// 窗口 ⑧打开设置 ⑨退出(明示代理仍在后台运行)。白名单外操作一律不进菜单
/// 栏;编辑类操作只在主窗口或设置窗口。目录事实来自目录工作流 projection。
struct ProxyStatusMenu: View {
@Environment(\.openWindow) private var openWindow
@ObservedObject var controller: ProxyRuntimeController
@ObservedObject var catalogWorkflow: CatalogWorkflow
var body: some View {
let summary = presentation
let targetTree = catalogWorkflow.tree.roots
let exportLine = StatusMenuModel.httpExportLine(settings: controller.listenSettings)
// ① 头部状态摘要
Text(summary.status)
Text("模式:\(summary.modeLabel)")
Text(summary.targetPath.map { "目标:\($0)" } ?? "目标:未激活")
if let detail = summary.detail {
Text(detail)
.font(.caption)
.foregroundStyle(.secondary)
}
if !controller.skippedServers.isEmpty {
Text("已跳过 \(controller.skippedServers.count) 个无效服务器")
.font(.caption)
.foregroundStyle(.orange)
.help("激活时跳过了存在已知本地阻塞问题的服务器")
}
Divider()
// ② 代理开关
Button(summary.isOn ? "停止代理" : "启动代理") {
Task { await controller.setProxyEnabled(!summary.isOn) }
}
// ③ 模式选择(勾选态)
Picker("模式", selection: modeBinding) {
if isModeAvailable(.pac) {
Text(ProxyMode.pac.label).tag(ProxyMode.pac)
}
if isModeAvailable(.global) {
Text(ProxyMode.global.label).tag(ProxyMode.global)
}
if isModeAvailable(.manual) {
Text(ProxyMode.manual.label).tag(ProxyMode.manual)
}
if let externalMode = configuredExternalPACMode {
Text(externalMode.label).tag(externalMode)
}
}
.pickerStyle(.inline)
// ④ 活动目标级联(只读)
Menu("活动目标") {
if targetTree.isEmpty {
Text("目录为空")
} else {
TargetCascade(nodes: targetTree, activeTargetID: controller.activeTargetID)
}
}
Divider()
// ⑤ 立即更新全部订阅(实际刷新语义 #35)
Button("立即更新全部订阅") {
Task { await catalogWorkflow.refreshAllSubscriptions() }
}
.disabled(catalogWorkflow.subscriptions.isEmpty)
// ⑥ 复制 HTTP 导出行
Button("复制 HTTP 导出行") {
if let exportLine {
NSPasteboard.general.clearContents()
NSPasteboard.general.setString(exportLine, forType: .string)
}
}
.disabled(exportLine == nil)
Divider()
// ⑦ 打开主窗口
Button("打开主窗口…") {
NSApp.activate()
openWindow(id: "main")
}
// 菜单栏 app 没有常规应用菜单;设置 scene 由这里显式打开。
Button("打开设置…") {
NSApp.activate()
openWindow(id: "settings")
}
Divider()
// ⑨ 退出:仅退 GUI;agent 由 launchd 持有,代理不受影响(构造上成立)。
Button("退出 ShadowsocksX-NG 2.0(代理仍在后台运行)") {
NSApp.terminate(nil)
}
}
private var presentation: StatusMenuModel.Summary {
StatusMenuModel.summary(
state: controller.state,
mode: controller.proxyMode,
targetPath: StatusMenuModel.targetPath(
in: catalogWorkflow.tree.roots, activeTargetID: controller.activeTargetID))
}
/// 模式选择走控制器同一入口:切换的系统代理语义(#29)与菜单勾选态由
/// 同一 @Published 事实来源保证一致。
private var modeBinding: Binding<ProxyMode> {
Binding(
get: { controller.proxyMode },
set: { mode in Task { await controller.setProxyMode(mode) } })
}
private func isModeAvailable(_ mode: ProxyMode) -> Bool {
mode.kind == controller.proxyMode.kind || controller.settings.enabledModes.contains(mode.kind)
}
private var configuredExternalPACMode: ProxyMode? {
if case .externalPAC(let url) = controller.proxyMode {
return .externalPAC(url)
}
guard controller.settings.enabledModes.contains(.externalPAC),
let url = URL(string: controller.settings.externalPACURL),
!controller.settings.externalPACURL.isEmpty,
(try? ProxyMode.validateExternalPACURL(url)) != nil
else { return nil }
return .externalPAC(url)
}
/// 只读级联树:分组展开为子菜单,活动目标以勾选呈现;无编辑入口。
/// 递归经由具名 View 类型展开(opaque 自引用无法编译)。
private struct TargetCascade: View {
let nodes: [CatalogTreeNode]
let activeTargetID: NodeID?
var body: some View {
ForEach(nodes, id: \.id) { node in
if node.isGroup {
Menu(node.name) {
if node.childNodes.isEmpty {
Text("空分组")
} else {
TargetCascade(nodes: node.childNodes, activeTargetID: activeTargetID)
}
}
} else if node.id == activeTargetID {
Text("✓ \(node.name)")
} else {
Text(node.name)
}
}
}
}
}