Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/ProxyRuntimeFacts.swift
T
Qiu Yuzhou 398e8d84b6 feat(ng2): split agent and system proxy switches
实现 #60(ACL 1/8):agent 意图与系统代理意图拆为两个独立开关,
首次运行默认 agent 开、系统代理关;显式关闭 agent 持久化并在 GUI
重启后生效;关闭系统代理只恢复 NG2 持有的系统设置,本地 SOCKS/HTTP
继续监听;关闭 agent 先恢复系统设置再停止监听。无活动目标时 agent
以空服务器列表契约提供本地监听(isWellFormed 放行空 servers,上游
sslocal v1.25.0 接受);需要代理出口的模式在活动目标缺失或端点不健
康时系统代理保持待应用,条件恢复后随下次收敛自动应用。首页、状态菜
单与侧栏状态卡经同一代理控制快照展示/操作 agent 意图/运行状态与系
统代理意图/实际应用及 typed 错误。测试覆盖启动顺序、持久化、健康门
禁、ownership 冲突、无效活动目标与 GUI 重同步(含真实 sslocal 空监
听回环证据);替身测试不表述为真实系统写入验证。
2026-09-26 00:38:28 +08:00

130 lines
3.9 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 Foundation
/// Stable runtime status categories exposed to app presentation surfaces.
/// 系统代理结果不在此列:它有独立的 `SystemProxyApplicationFacts`
/// (issue #60 拆分两个状态面)。
enum ProxyRuntimeStatus: Equatable, Sendable {
case off
case starting
case running
case firewallBlocked
case launchFailed
case requiresApproval
case serviceFailed
}
/// Domain-neutral runtime projection for status-menu presentation. The
/// controller's state representation stays behind the adapter below.
struct ProxyRuntimeFacts: Equatable, Sendable {
let status: ProxyRuntimeStatus
let isOn: Bool
let failure: RuntimeFailureFacts?
init(
status: ProxyRuntimeStatus,
isOn: Bool,
failure: RuntimeFailureFacts? = nil
) {
self.status = status
self.isOn = isOn
self.failure = failure
}
}
/// 系统代理实际作用的固定类别(issue #60):意图持久化为开关事实,这里
/// 呈现 NG2 对系统设置的真实作用,与 agent 运行状态互不代替。
enum SystemProxyApplicationFacts: Equatable, Sendable {
/// 意图关闭:NG2 不持有系统设置。
case idle
/// 意图开启,等待 agent 健康或可用出口;条件恢复后自动收敛。
case pending
/// 已写入系统设置且持续持有。
case applied
/// 写入或恢复失败(typed)。
case failed(SystemProxyFailureFacts)
}
/// Safe endpoint health categories used by runtime state and presentation.
enum RuntimeEndpointFailure: Equatable, Sendable {
case refused
case timedOut
case invalidResponse
case unknown
}
struct FirewallBlockedFacts: Equatable, Sendable {
let executableName: String
}
enum LaunchFailureFacts: Equatable, Sendable {
case missingRuntimeDocument
case localEndpoint(
endpoint: String, host: String, port: Int, cause: RuntimeEndpointFailure)
case pacEndpoint(port: Int, cause: RuntimeEndpointFailure)
case unreadableSettings
}
enum ServiceFailureFacts: Equatable, Sendable {
case runtimeFile
case agent
case missingDocument
case persistence
case unknown
}
enum SystemProxyOperationFailure: Equatable, Sendable {
case authorizationFailed
case preferencesUnavailable
case preferencesBusy
case noCurrentNetworkSet
case noProxyServices
case unreadableService
case invalidStoredConfiguration
case cannotWriteService
case commitFailed
case applyFailed
case ownershipStoreFailed
}
enum SystemProxyFailureFacts: Equatable, Sendable {
case operation(SystemProxyOperationFailure)
case mode(ProxyModeError)
case ownershipConflict
case unknown
}
/// Structured runtime failure projection used by runtime synchronization and
/// app presentation. No arbitrary platform detail is carried into this state.
/// `.systemProxy` 只用于把系统代理失败携带进结构化 outcome(设置工作流与
/// 目录收敛结果);呈现面走 `SystemProxyApplicationFacts.failed`。
enum RuntimeFailureFacts: Error, Equatable, Sendable {
case firewallBlocked(FirewallBlockedFacts)
case launch(LaunchFailureFacts)
case service(ServiceFailureFacts)
case activation(ActivationFailure)
case requiresApproval
case systemProxy(SystemProxyFailureFacts)
}
extension ProxyRuntimeFacts {
init(state: ProxyRuntimeController.AgentRunState) {
switch state {
case .off:
self.init(status: .off, isOn: false)
case .starting:
self.init(status: .starting, isOn: true)
case .running:
self.init(status: .running, isOn: true)
case .firewallBlocked(let facts):
self.init(
status: .firewallBlocked, isOn: true, failure: .firewallBlocked(facts))
case .launchFailed(let facts):
self.init(status: .launchFailed, isOn: false, failure: .launch(facts))
case .requiresApproval:
self.init(status: .requiresApproval, isOn: true, failure: .requiresApproval)
case .serviceFailed(let facts):
self.init(status: .serviceFailed, isOn: false, failure: .service(facts))
}
}
}