mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
实现 #60(ACL 1/8):agent 意图与系统代理意图拆为两个独立开关, 首次运行默认 agent 开、系统代理关;显式关闭 agent 持久化并在 GUI 重启后生效;关闭系统代理只恢复 NG2 持有的系统设置,本地 SOCKS/HTTP 继续监听;关闭 agent 先恢复系统设置再停止监听。无活动目标时 agent 以空服务器列表契约提供本地监听(isWellFormed 放行空 servers,上游 sslocal v1.25.0 接受);需要代理出口的模式在活动目标缺失或端点不健 康时系统代理保持待应用,条件恢复后随下次收敛自动应用。首页、状态菜 单与侧栏状态卡经同一代理控制快照展示/操作 agent 意图/运行状态与系 统代理意图/实际应用及 typed 错误。测试覆盖启动顺序、持久化、健康门 禁、ownership 冲突、无效活动目标与 GUI 重同步(含真实 sslocal 空监 听回环证据);替身测试不表述为真实系统写入验证。
270 lines
10 KiB
Swift
270 lines
10 KiB
Swift
import Combine
|
||
import XCTest
|
||
|
||
@testable import ShadowsocksX_NG2
|
||
|
||
// MARK: - 确定性替身(snapshot 与命令 contract;不触真实运行时)
|
||
|
||
/// 可编程 runtime 替身(issue #47/#60,story 31):事实可编程、命令全记录;
|
||
/// changes 为手动 subject,同步发值保证观察测试确定性。
|
||
@MainActor
|
||
private final class FakeProxyRuntime: ProxyRuntimeAdapting {
|
||
var runtimeFacts: ProxyRuntimeFacts
|
||
var agentIntentEnabled: Bool
|
||
var activationFailure: ActivationFailure?
|
||
var systemProxyIntentEnabled: Bool
|
||
var systemProxyApplication: SystemProxyApplicationFacts
|
||
var proxyMode: ProxyMode
|
||
var skippedInvalidServerCount = 0
|
||
var activeTargetID: NodeID?
|
||
var httpExportCapability = HTTPExportCapability(
|
||
copyableLine:
|
||
"export http_proxy=http://127.0.0.1:11087;export https_proxy=http://127.0.0.1:11087;")
|
||
|
||
private let changeSubject = PassthroughSubject<Void, Never>()
|
||
var changes: AnyPublisher<Void, Never> { changeSubject.eraseToAnyPublisher() }
|
||
|
||
private(set) var resyncCount = 0
|
||
private(set) var agentCommands: [Bool] = []
|
||
private(set) var systemProxyCommands: [Bool] = []
|
||
private(set) var modeCommands: [ProxyMode] = []
|
||
|
||
init(
|
||
facts: ProxyRuntimeFacts = ProxyRuntimeFacts(status: .off, isOn: false),
|
||
agentIntent: Bool = true,
|
||
systemProxyIntent: Bool = false,
|
||
systemProxyApplication: SystemProxyApplicationFacts = .idle,
|
||
mode: ProxyMode = .pac
|
||
) {
|
||
runtimeFacts = facts
|
||
agentIntentEnabled = agentIntent
|
||
systemProxyIntentEnabled = systemProxyIntent
|
||
self.systemProxyApplication = systemProxyApplication
|
||
proxyMode = mode
|
||
}
|
||
|
||
func emitChange() { changeSubject.send() }
|
||
|
||
func resyncOnLaunch() async { resyncCount += 1 }
|
||
|
||
func setAgentEnabled(_ enabled: Bool) async { agentCommands.append(enabled) }
|
||
|
||
func setSystemProxyEnabled(_ enabled: Bool) async { systemProxyCommands.append(enabled) }
|
||
|
||
func setProxyMode(_ mode: ProxyMode) async { modeCommands.append(mode) }
|
||
}
|
||
|
||
/// 可编程目标事实替身(story 32):路径摘要可编程、查询全记录。
|
||
@MainActor
|
||
private final class FakeTargetFacts: ProxyTargetFactsReading {
|
||
var pathByTarget: [NodeID: String] = [:]
|
||
private(set) var queriedTargetIDs: [NodeID?] = []
|
||
|
||
func activeTargetFacts(for targetID: NodeID?) -> ProxyActiveTargetFacts? {
|
||
queriedTargetIDs.append(targetID)
|
||
guard let targetID else { return nil }
|
||
return ProxyActiveTargetFacts(id: targetID, pathSummary: pathByTarget[targetID])
|
||
}
|
||
}
|
||
|
||
/// 代理控制工作流的 snapshot 与命令 contract(issue #47/#60):整体一致性、
|
||
/// typed commands、窄目录事实缝、运行时变化重观察与命令边界。
|
||
@MainActor
|
||
final class ProxyControlWorkflowTests: XCTestCase {
|
||
private var runtime: FakeProxyRuntime!
|
||
private var targetFacts: FakeTargetFacts!
|
||
private var workflow: ProxyControlWorkflow!
|
||
|
||
override func setUp() {
|
||
super.setUp()
|
||
runtime = FakeProxyRuntime()
|
||
targetFacts = FakeTargetFacts()
|
||
workflow = ProxyControlWorkflow(runtime: runtime, targetFacts: targetFacts)
|
||
}
|
||
|
||
private static let serverID = NodeID(rawValue: "manual:server-1")
|
||
|
||
// MARK: - 整体 snapshot
|
||
|
||
func testSnapshotAssemblesAllFactsFromSingleObservation() {
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(
|
||
status: .running,
|
||
isOn: true,
|
||
failure: .firewallBlocked(FirewallBlockedFacts(executableName: "sslocal")))
|
||
runtime.agentIntentEnabled = true
|
||
runtime.activationFailure = .noActiveTarget
|
||
runtime.systemProxyIntentEnabled = true
|
||
runtime.systemProxyApplication = .pending
|
||
runtime.proxyMode = .global
|
||
runtime.skippedInvalidServerCount = 3
|
||
runtime.activeTargetID = Self.serverID
|
||
runtime.httpExportCapability = HTTPExportCapability(
|
||
copyableLine: "export http_proxy=http://127.0.0.1:11087;")
|
||
targetFacts.pathByTarget[Self.serverID] = "组A / 香港 01"
|
||
runtime.emitChange()
|
||
|
||
XCTAssertEqual(
|
||
workflow.snapshot,
|
||
ProxyControlSnapshot(
|
||
runtime: ProxyRuntimeFacts(
|
||
status: .running,
|
||
isOn: true,
|
||
failure: .firewallBlocked(FirewallBlockedFacts(executableName: "sslocal"))),
|
||
agentIntentEnabled: true,
|
||
activationFailure: .noActiveTarget,
|
||
systemProxyIntentEnabled: true,
|
||
systemProxyApplication: .pending,
|
||
proxyMode: .global,
|
||
availableModes: ProxyMode.availableModes,
|
||
activeTarget: ProxyActiveTargetFacts(id: Self.serverID, pathSummary: "组A / 香港 01"),
|
||
skippedInvalidServerCount: 3,
|
||
httpExport: HTTPExportCapability(
|
||
copyableLine: "export http_proxy=http://127.0.0.1:11087;")))
|
||
XCTAssertEqual(
|
||
workflow.snapshot.availableModes, ProxyMode.availableModes,
|
||
"可用模式是 issue #46 Domain 单点策略的投影")
|
||
}
|
||
|
||
// MARK: - typed commands:转发并整体重发布
|
||
|
||
func testAgentEnableCommandForwardsAndRepublishesWholeSnapshot() async {
|
||
let before = workflow.snapshot
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .running, isOn: true)
|
||
runtime.agentIntentEnabled = true
|
||
runtime.skippedInvalidServerCount = 2
|
||
runtime.activeTargetID = Self.serverID
|
||
|
||
let after = await workflow.setAgentEnabled(true)
|
||
|
||
XCTAssertEqual(runtime.agentCommands, [true])
|
||
XCTAssertEqual(after, workflow.snapshot, "命令返回值就是已发布的最新 snapshot")
|
||
XCTAssertNotEqual(after, before, "命令完成后整体重发布")
|
||
XCTAssertEqual(after.runtime, ProxyRuntimeFacts(status: .running, isOn: true))
|
||
XCTAssertEqual(after.skippedInvalidServerCount, 2)
|
||
}
|
||
|
||
func testAgentDisableCommandForwardsAndRepublishesWholeSnapshot() async {
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .running, isOn: true)
|
||
runtime.agentIntentEnabled = true
|
||
_ = await workflow.setAgentEnabled(true)
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .off, isOn: false)
|
||
runtime.agentIntentEnabled = false
|
||
runtime.skippedInvalidServerCount = 0
|
||
runtime.activeTargetID = nil
|
||
|
||
let after = await workflow.setAgentEnabled(false)
|
||
|
||
XCTAssertEqual(runtime.agentCommands, [true, false])
|
||
XCTAssertEqual(after.runtime, ProxyRuntimeFacts(status: .off, isOn: false))
|
||
XCTAssertFalse(after.agentIntentEnabled)
|
||
XCTAssertNil(after.activeTarget)
|
||
}
|
||
|
||
/// 系统代理命令与 agent 命令互不触碰对方事实(issue #60)。
|
||
func testSystemProxyCommandsForwardIndependentlyFromAgentCommands() async {
|
||
runtime.agentIntentEnabled = true
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .running, isOn: true)
|
||
_ = await workflow.setAgentEnabled(true)
|
||
runtime.systemProxyIntentEnabled = true
|
||
runtime.systemProxyApplication = .applied
|
||
|
||
let applied = await workflow.setSystemProxyEnabled(true)
|
||
|
||
XCTAssertEqual(runtime.systemProxyCommands, [true])
|
||
XCTAssertTrue(applied.systemProxyIntentEnabled)
|
||
XCTAssertEqual(applied.systemProxyApplication, .applied)
|
||
XCTAssertEqual(applied.agentIntentEnabled, true, "agent 意图不被系统代理命令触碰")
|
||
|
||
runtime.systemProxyIntentEnabled = false
|
||
runtime.systemProxyApplication = .idle
|
||
let off = await workflow.setSystemProxyEnabled(false)
|
||
|
||
XCTAssertEqual(runtime.systemProxyCommands, [true, false])
|
||
XCTAssertFalse(off.systemProxyIntentEnabled)
|
||
XCTAssertEqual(off.systemProxyApplication, .idle)
|
||
XCTAssertEqual(runtime.agentCommands, [true], "系统代理命令不触发 agent 命令")
|
||
}
|
||
|
||
func testModeCommandForwardsAndRepublishesWholeSnapshot() async {
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .running, isOn: true)
|
||
_ = await workflow.setAgentEnabled(true)
|
||
runtime.proxyMode = .global
|
||
|
||
let after = await workflow.setProxyMode(.global)
|
||
|
||
XCTAssertEqual(runtime.modeCommands, [.global])
|
||
XCTAssertEqual(after.proxyMode, .global)
|
||
XCTAssertEqual(after.runtime, ProxyRuntimeFacts(status: .running, isOn: true))
|
||
}
|
||
|
||
func testResyncOnLaunchForwardsAndRepublishes() async {
|
||
let before = workflow.snapshot
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(
|
||
status: .running, isOn: true, failure: nil)
|
||
|
||
await workflow.resyncOnLaunch()
|
||
|
||
XCTAssertEqual(runtime.resyncCount, 1)
|
||
XCTAssertNotEqual(workflow.snapshot, before)
|
||
XCTAssertEqual(workflow.snapshot.runtime.status, .running)
|
||
}
|
||
|
||
// MARK: - 运行时变化重观察
|
||
|
||
func testRuntimeChangeRepublishesWholeSnapshotWithoutCommand() {
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .starting, isOn: true)
|
||
runtime.emitChange()
|
||
XCTAssertEqual(workflow.snapshot.runtime.status, .starting)
|
||
|
||
runtime.runtimeFacts = ProxyRuntimeFacts(status: .running, isOn: true)
|
||
runtime.emitChange()
|
||
XCTAssertEqual(workflow.snapshot.runtime.status, .running)
|
||
XCTAssertTrue(workflow.snapshot.runtime.isOn)
|
||
}
|
||
|
||
// MARK: - 窄目录目标事实缝
|
||
|
||
func testActiveTargetFactsComeFromNarrowCatalogSeam() {
|
||
runtime.activeTargetID = Self.serverID
|
||
targetFacts.pathByTarget[Self.serverID] = "订阅分组 / 香港 01"
|
||
runtime.emitChange()
|
||
|
||
XCTAssertEqual(
|
||
workflow.snapshot.activeTarget,
|
||
ProxyActiveTargetFacts(id: Self.serverID, pathSummary: "订阅分组 / 香港 01"))
|
||
XCTAssertEqual(targetFacts.queriedTargetIDs.last, Self.serverID)
|
||
}
|
||
|
||
func testNoActiveTargetYieldsNilTargetFacts() {
|
||
XCTAssertNil(workflow.snapshot.activeTarget)
|
||
XCTAssertEqual(targetFacts.queriedTargetIDs, [nil] as [NodeID?], "init 观察即查询一次")
|
||
}
|
||
|
||
func testTargetMissingFromTreeKeepsExistenceWithNilSummary() {
|
||
runtime.activeTargetID = Self.serverID
|
||
targetFacts.pathByTarget[Self.serverID] = nil
|
||
runtime.emitChange()
|
||
|
||
let target = workflow.snapshot.activeTarget
|
||
XCTAssertEqual(target?.id, Self.serverID, "存在性来自活动目标身份")
|
||
XCTAssertNil(target?.pathSummary, "目标不在当前目录树中时摘要为 nil")
|
||
}
|
||
|
||
// MARK: - 命令边界(story 37)
|
||
|
||
func testCommandsTouchOnlyRuntimeAndTargetFactsAdapters() async {
|
||
await workflow.setAgentEnabled(true)
|
||
await workflow.setSystemProxyEnabled(true)
|
||
await workflow.setProxyMode(.global)
|
||
await workflow.resyncOnLaunch()
|
||
|
||
XCTAssertEqual(runtime.agentCommands, [true])
|
||
XCTAssertEqual(runtime.systemProxyCommands, [true])
|
||
XCTAssertEqual(runtime.modeCommands, [.global])
|
||
XCTAssertEqual(runtime.resyncCount, 1)
|
||
// 目标缝只被 snapshot 组装读取;目录激活、订阅刷新、设置保存与诊断导出
|
||
// 不在本 module 的依赖面上(类型层面不存在这些入口)。
|
||
XCTAssertFalse(targetFacts.queriedTargetIDs.isEmpty, "每次观察经窄缝取目标事实")
|
||
}
|
||
}
|