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 空监 听回环证据);替身测试不表述为真实系统写入验证。
184 lines
7.0 KiB
Swift
184 lines
7.0 KiB
Swift
import XCTest
|
||
|
||
@testable import ShadowsocksX_NG2
|
||
|
||
/// 状态菜单呈现逻辑(spec #21 D11,issue #31/#47/#60):头部状态摘要从代理
|
||
/// 控制工作流的整体 snapshot 派生,agent 与系统代理两个状态面分开呈现。不
|
||
/// 持有 AppKit 类型;HTTP 导出行与目标路径摘要分别在代理控制与目录 module
|
||
/// 测试覆盖。
|
||
final class StatusMenuModelTests: XCTestCase {
|
||
private struct RuntimeSummaryCase {
|
||
let facts: ProxyRuntimeFacts
|
||
let expectedStatus: String
|
||
let expectedIsOn: Bool
|
||
}
|
||
|
||
private static let runtimeSummaryCases: [RuntimeSummaryCase] = [
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(status: .starting, isOn: true),
|
||
expectedStatus: "正在启动代理…",
|
||
expectedIsOn: true),
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
expectedStatus: "代理运行中",
|
||
expectedIsOn: true),
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(
|
||
status: .firewallBlocked,
|
||
isOn: true,
|
||
failure: .firewallBlocked(FirewallBlockedFacts(executableName: "sslocal"))),
|
||
expectedStatus: "代理运行中(局域网受阻)",
|
||
expectedIsOn: true),
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(
|
||
status: .launchFailed,
|
||
isOn: false,
|
||
failure: .launch(
|
||
.localEndpoint(
|
||
endpoint: "http", host: "127.0.0.1", port: 11087, cause: .refused))),
|
||
expectedStatus: "启动失败",
|
||
expectedIsOn: false),
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(
|
||
status: .requiresApproval, isOn: true, failure: .requiresApproval),
|
||
expectedStatus: "等待允许后台代理",
|
||
expectedIsOn: true),
|
||
RuntimeSummaryCase(
|
||
facts: ProxyRuntimeFacts(
|
||
status: .serviceFailed,
|
||
isOn: false,
|
||
failure: .service(.persistence)),
|
||
expectedStatus: "服务管理失败",
|
||
expectedIsOn: false),
|
||
]
|
||
|
||
/// 从运行时事实构造最小 snapshot(其余字段与本组用例无关)。
|
||
private func makeSnapshot(
|
||
facts: ProxyRuntimeFacts,
|
||
agentIntent: Bool = true,
|
||
activationFailure: ActivationFailure? = nil,
|
||
systemProxyIntent: Bool = false,
|
||
systemProxyApplication: SystemProxyApplicationFacts = .idle,
|
||
mode: ProxyMode = .pac,
|
||
activeTarget: ProxyActiveTargetFacts? = nil
|
||
) -> ProxyControlSnapshot {
|
||
ProxyControlSnapshot(
|
||
runtime: facts,
|
||
agentIntentEnabled: agentIntent,
|
||
activationFailure: activationFailure,
|
||
systemProxyIntentEnabled: systemProxyIntent,
|
||
systemProxyApplication: systemProxyApplication,
|
||
proxyMode: mode,
|
||
availableModes: ProxyMode.availableModes,
|
||
activeTarget: activeTarget,
|
||
skippedInvalidServerCount: 0,
|
||
httpExport: HTTPExportCapability(
|
||
copyableLine:
|
||
"export http_proxy=http://127.0.0.1:11087;export https_proxy=http://127.0.0.1:11087;"))
|
||
}
|
||
|
||
// MARK: - 头部状态摘要
|
||
|
||
func testSummaryRunningStateIsOnWithNoDetail() {
|
||
let summary = StatusMenuModel.summary(
|
||
from: makeSnapshot(facts: ProxyRuntimeFacts(status: .running, isOn: true)))
|
||
XCTAssertTrue(summary.agentIntentEnabled)
|
||
XCTAssertTrue(summary.isOn)
|
||
XCTAssertEqual(summary.status, "代理运行中")
|
||
XCTAssertNil(summary.detail)
|
||
}
|
||
|
||
func testSummaryOffStateIsOff() {
|
||
let summary = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .off, isOn: false),
|
||
agentIntent: false,
|
||
mode: .global))
|
||
XCTAssertFalse(summary.agentIntentEnabled, "开关意图独立于运行状态")
|
||
XCTAssertFalse(summary.isOn)
|
||
XCTAssertEqual(summary.status, "代理未运行")
|
||
XCTAssertNil(summary.detail)
|
||
}
|
||
|
||
func testSummaryProjectsEveryStableRuntimeStatus() {
|
||
for testCase in Self.runtimeSummaryCases {
|
||
let summary = StatusMenuModel.summary(from: makeSnapshot(facts: testCase.facts))
|
||
XCTAssertEqual(summary.isOn, testCase.expectedIsOn)
|
||
XCTAssertEqual(summary.status, testCase.expectedStatus)
|
||
XCTAssertEqual(
|
||
summary.detail,
|
||
testCase.facts.failure.map { AppPresentation.message(for: $0) })
|
||
}
|
||
}
|
||
|
||
/// 激活拒绝/目标清除的点名原因独立于运行状态呈现(issue #60):agent 仍
|
||
/// 在监听时也必须可读。
|
||
func testSummaryCarriesActivationFailureAlongsideRunningState() {
|
||
let summary = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
activationFailure: .targetNotFound(NodeID(rawValue: "manual:gone"))))
|
||
XCTAssertEqual(summary.status, "代理运行中")
|
||
XCTAssertEqual(
|
||
summary.detail,
|
||
AppPresentation.message(
|
||
for: ActivationFailure.targetNotFound(
|
||
NodeID(rawValue: "manual:gone"))))
|
||
}
|
||
|
||
/// 系统代理状态面(issue #60):意图与实际应用分开,失败携带点名原因。
|
||
func testSummaryProjectsSystemProxyApplicationIndependently() {
|
||
let idle = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .off, isOn: false),
|
||
systemProxyIntent: false,
|
||
systemProxyApplication: .idle))
|
||
XCTAssertFalse(idle.systemProxyIntentEnabled)
|
||
XCTAssertEqual(idle.systemProxyStatus, "系统代理:未接管")
|
||
XCTAssertNil(idle.systemProxyDetail)
|
||
|
||
let pending = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
systemProxyIntent: true,
|
||
systemProxyApplication: .pending))
|
||
XCTAssertTrue(pending.systemProxyIntentEnabled)
|
||
XCTAssertEqual(pending.systemProxyStatus, "系统代理:待应用")
|
||
XCTAssertNil(pending.systemProxyDetail)
|
||
|
||
let applied = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
systemProxyIntent: true,
|
||
systemProxyApplication: .applied))
|
||
XCTAssertEqual(applied.systemProxyStatus, "系统代理:已应用")
|
||
|
||
let failed = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
systemProxyIntent: true,
|
||
systemProxyApplication: .failed(.ownershipConflict)))
|
||
XCTAssertEqual(failed.systemProxyStatus, "系统代理:应用失败")
|
||
XCTAssertEqual(
|
||
failed.systemProxyDetail,
|
||
AppPresentation.message(for: RuntimeFailureFacts.systemProxy(.ownershipConflict)))
|
||
}
|
||
|
||
func testSummaryCarriesModeLabelAndTargetPathFromSnapshot() {
|
||
let summary = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
mode: .global,
|
||
activeTarget: ProxyActiveTargetFacts(
|
||
id: NodeID(rawValue: "manual:server"), pathSummary: "订阅分组 / 嵌套分组 / 日本 02")))
|
||
XCTAssertEqual(summary.modeLabel, "全局")
|
||
XCTAssertEqual(summary.targetPath, "订阅分组 / 嵌套分组 / 日本 02")
|
||
}
|
||
|
||
func testSummaryTargetPathIsNilWithoutActiveTarget() {
|
||
let summary = StatusMenuModel.summary(
|
||
from: makeSnapshot(facts: ProxyRuntimeFacts(status: .off, isOn: false)))
|
||
XCTAssertNil(summary.targetPath)
|
||
}
|
||
}
|