mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
建立设置工作流深 module(App/SettingsWorkflow/),把设置编辑的编排从视图 收拢到一个 seam,镜像 #41 的目录工作流模式: - UI-facing interface:可编辑 draft 投影(binding 直连)、占用/校验/门禁/ 保存中/待确认 PAC 失效提示/错误等只读投影,与 suggestPort、save、 confirmPACNotice、cancelPACNotice、reset、reloadFromCommitted 等 typed command;登录启动项是独立偏好域(ADR-0005),视图直连其控制器,不经本 module。 - implementation(灰置):端口占用探测的 Task.detached 编排(代际去竞态)、 保存门禁(validationErrors+占用)、「当前运行端口」例外、PAC 失效确认 流、重置事务与 ProxySettingsStoreError 文案映射。 - isOn 判定从 StatusMenuModel 迁至 ProxyRuntimeController.ProxyState 扩展, 菜单摘要与设置工作流共用同一事实来源;设置视图不再持有 ProxyRuntimeController 与探测缝,组合根在 MainApp 接线一次,设置窗口 scene 的显式触达路径不变。 测试:设置编辑 workflow 不经 SwiftUI 即可全测——占用反应与门禁阻塞、 运行端口例外放行、PAC 失效确认/取消、校验阻塞、提交失败保留旧值并点名、 重置回出厂、建议端口只写草稿(8 项;全量 376 项通过)。 Out of scope:设置视觉重设计、ProxyRuntimeController 拆分、独立编译 target。
90 lines
3.4 KiB
Swift
90 lines
3.4 KiB
Swift
import Foundation
|
||
|
||
/// 状态菜单八项白名单的呈现模型(spec #21 D11,issue #31):从运行状态、
|
||
/// 模式、目录树与监听设置派生菜单数据。不持有 AppKit 类型,纯逻辑可测;
|
||
/// 视觉与交互细节(勾选标记、禁用态)在 ProxyStatusMenu 呈现,不建自动测试。
|
||
enum StatusMenuModel {
|
||
/// 头部状态摘要:运行状态、当前模式、活动目标(含点名失败细节)。
|
||
struct Summary: Equatable {
|
||
/// 代理开关的当前意图:true 为已开(菜单项呈现「停止代理」)。
|
||
let isOn: Bool
|
||
let status: String
|
||
/// 启动/激活/系统代理失败的点名原因,随状态摘要一并呈现。
|
||
let detail: String?
|
||
let modeLabel: String
|
||
/// 活动目标从根到节点的显示名路径;未激活为 nil。
|
||
let targetPath: String?
|
||
}
|
||
|
||
/// 运行状态 → 摘要映射(与主窗口诊断区口径一致)。
|
||
static func summary(
|
||
state: ProxyRuntimeController.ProxyState,
|
||
mode: ProxyMode,
|
||
targetPath: String?
|
||
) -> Summary {
|
||
let status: String
|
||
let detail: String?
|
||
switch state {
|
||
case .off:
|
||
status = "代理未运行"
|
||
detail = nil
|
||
case .starting:
|
||
status = "正在启动代理…"
|
||
detail = nil
|
||
case .running:
|
||
status = "代理运行中"
|
||
detail = nil
|
||
case .firewallBlocked(let reason):
|
||
status = "代理运行中(局域网受阻)"
|
||
detail = reason
|
||
case .launchFailed(let reason):
|
||
status = "启动失败"
|
||
detail = reason
|
||
case .activationFailed(let reason):
|
||
status = "无法启动"
|
||
detail = reason
|
||
case .requiresApproval:
|
||
status = "等待允许后台代理"
|
||
detail = "请在系统设置-登录项中允许 ShadowsocksX-NG 后台项"
|
||
case .serviceFailed(let reason):
|
||
status = "服务管理失败"
|
||
detail = reason
|
||
case .systemProxyFailed(let reason):
|
||
status = "系统代理未应用"
|
||
detail = reason
|
||
}
|
||
return Summary(
|
||
isOn: state.isOn, status: status, detail: detail, modeLabel: mode.label,
|
||
targetPath: targetPath)
|
||
}
|
||
|
||
/// 复制 HTTP 导出行(D11):shell 可直接 source 的 http/https 双导出;
|
||
/// HTTP 入站未启用时无行可复制(菜单项禁用)。地址取监听范围的对外地址
|
||
/// (回环态 127.0.0.1,主机态为对外公布地址),与 PAC 语义一致。
|
||
static func httpExportLine(settings: SslocalListenSettings) -> String? {
|
||
guard settings.httpProxyEnabled else { return nil }
|
||
let endpoint = "http://\(settings.scope.advertisedAddress):\(settings.httpPort)"
|
||
return "export http_proxy=\(endpoint);export https_proxy=\(endpoint);"
|
||
}
|
||
|
||
/// 活动目标的显示名路径(根 → 节点," / " 连接);基于目录树 projection
|
||
/// 派生(issue #41)。未激活或目标已不在树中为 nil。
|
||
static func targetPath(in nodes: [CatalogTreeNode], activeTargetID: NodeID?) -> String? {
|
||
guard let activeTargetID else { return nil }
|
||
var path: [String] = []
|
||
func search(_ node: CatalogTreeNode) -> Bool {
|
||
if node.id == activeTargetID {
|
||
path.append(node.name)
|
||
return true
|
||
}
|
||
for child in node.children ?? [] where search(child) {
|
||
path.insert(node.name, at: 0)
|
||
return true
|
||
}
|
||
return false
|
||
}
|
||
for node in nodes where search(node) { break }
|
||
return path.isEmpty ? nil : path.joined(separator: " / ")
|
||
}
|
||
}
|