mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-19 09:24:59 +00:00
非「仅本机」监听方式下,首页命令卡在复制按钮上方提供单选 IP 下拉框:
候选仅含回环与当前启用 Wi‑Fi/Ethernet 接口单播地址(严格 SCNetworkInterface
类型白名单,排除 VPN/虚拟/未知类型),按监听地址族过滤(双栈含两个回环,
127.0.0.1 置顶;仅 IPv6 默认 ::1),标签 {IP} - {name}(本地化名称缺失回退
BSD 名)。两种 shell 的 HTTP/HTTPS/SOCKS 端点共用选中地址,端口取已保存
监听事实,IPv6 URL 方括号;选择会话内有效(跨首页返回保留、重启重置),
失效自动回退默认回环。进入首页、网络变化(SCDynamicStore 监视+去抖)与
复制前刷新。
- 新缝 LocalInterfaceFactsReading:原始接口事实(地址/类型/名称)+ 变化
通知;生产适配器封装 getifaddrs/SCNetworkInterface/SCDynamicStore 细节
- 运行时缝以 listenFacts 替换 terminalProxyEnvironmentCommands;命令派生
移至工作流层(监听事实 + 生效选择)
- 替身测试证明策略行为;真实主机非视觉验证证明系统适配器整合
(回环识别/类型映射/地址规范化/链路本地判定)
207 lines
8.1 KiB
Swift
207 lines
8.1 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,
|
||
systemProxyApprovalRequired: Bool = false,
|
||
mode: ProxyMode = .rule,
|
||
activeTarget: ProxyActiveTargetFacts? = nil
|
||
) -> ProxyControlSnapshot {
|
||
ProxyControlSnapshot(
|
||
runtime: facts,
|
||
agentIntentEnabled: agentIntent,
|
||
activationFailure: activationFailure,
|
||
systemProxyIntentEnabled: systemProxyIntent,
|
||
systemProxyApplication: systemProxyApplication,
|
||
systemProxyApprovalRequired: systemProxyApprovalRequired,
|
||
proxyMode: mode,
|
||
ruleDefaultAction: .proxyWhenUnmatched,
|
||
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;"),
|
||
commandAddressPicker: TerminalCommandAddressPicker(
|
||
isVisible: false,
|
||
candidates: [
|
||
TerminalCommandAddress(bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")
|
||
],
|
||
selected: TerminalCommandAddress(bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")),
|
||
terminalProxyEnvironmentCommands: TerminalProxyEnvironmentCommands(
|
||
listen: RuntimeListenFacts(listen: SslocalListenSettings()),
|
||
commandAddress: TerminalCommandAddress(
|
||
bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")))
|
||
}
|
||
|
||
// 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 approvalPending = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
systemProxyIntent: true,
|
||
systemProxyApplication: .pending,
|
||
systemProxyApprovalRequired: true))
|
||
XCTAssertEqual(approvalPending.systemProxyStatus, "系统代理:待批准")
|
||
XCTAssertNil(approvalPending.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(.operation(.applyFailed))))
|
||
XCTAssertEqual(failed.systemProxyStatus, "系统代理:应用失败")
|
||
XCTAssertEqual(
|
||
failed.systemProxyDetail,
|
||
AppPresentation.message(
|
||
for: RuntimeFailureFacts.systemProxy(.operation(.applyFailed))))
|
||
}
|
||
|
||
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)
|
||
}
|
||
}
|