Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/ErrorPresentation.swift
T
Qiu Yuzhou 0ecca53a20 feat(ng2): subscription fetch, snapshot semantics and UI (#35)
SIP-008 v1 + x_shadowsocksx_ng extension parsing with flat fallback;
HTTPS/Content-Type gated fetch seam; atomic snapshot commits carrying
only the local enabled overlay; URL edit keeps identity; recursive
delete clears source, fixed group, members and credentials; subscription
cards pane and menu-bar update-all wiring.
2026-09-21 06:15:52 +08:00

119 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
/// 错误 → 用户可读文案(主窗口弹窗呈现)。领域拒绝逐条点名原因,与 spec #21
/// 的「无静默回退、点名失败」语义一致。
extension Error {
var presentableMessage: String {
switch self {
case let error as CatalogError:
return error.presentedMessage
case let error as ServerFormError:
switch error {
case .invalidAddress:
return "服务器地址不能为空"
case .invalidPort:
return "端口必须是 1–65535 之间的整数"
case .emptyName:
return "名称不能为空"
}
case let error as SsUriError:
switch error {
case .notSsUri:
return "不是 ss:// 链接"
case .malformed(let detail):
return "无法解析 ss:// 链接:\(detail)"
}
case let error as CredentialStoreError:
switch error {
case .keychainStatus(let status):
return "钥匙串操作失败(错误码 \(status))"
case .secretNotUTF8:
return "钥匙串中的凭据不是文本"
}
case let error as SubscriptionFormError:
switch error {
case .invalidURL:
return "订阅地址必须是有效的 HTTPS URL"
case .notFound:
return "订阅不存在(可能已被删除)"
}
case let error as SubscriptionFetchError:
return error.presentedMessage
case let error as SubscriptionParseError:
return error.presentedMessage
default:
return String(describing: self)
}
}
}
extension CatalogError {
var presentedMessage: String {
switch self {
case .nodeNotFound:
return "节点不存在(可能已被删除)"
case .parentNotFound:
return "目标分组不存在"
case .parentNotAGroup:
return "目标位置不是分组"
case .notAServer:
return "该节点不是服务器"
case .notAGroup:
return "该节点不是分组"
case .duplicateID:
return "节点身份冲突"
case .crossSourcePlacement(_, let container):
return container == .subscription
? "不能把手动节点移入订阅子树"
: "不能把订阅节点移入手动子树"
case .subscriptionNodeImmutable:
return "订阅节点由远端管理:结构、连接字段与名称只读,仅启用开关可调"
case .subscriptionServerAtRoot:
return "订阅服务器不能移出其订阅分组"
case .cycleDetected:
return "不能把分组移动进它自己的子树"
case .indexOutOfRange:
return "插入位置超出范围"
case .invalidStructure:
return "配置目录结构不一致"
}
}
}
extension SubscriptionFetchError {
var presentedMessage: String {
switch self {
case .invalidURL:
return "订阅地址无效(缺少主机)"
case .unsupportedScheme:
return "订阅地址必须是 HTTPS"
case .insecureRedirect:
return "订阅地址重定向到了非 HTTPS 站点,已拒绝"
case .transport(let detail):
return "订阅获取失败(\(detail))"
case .httpStatus(let code):
return "订阅服务器返回 HTTP \(code)"
case .contentType(let received):
return received.map { "订阅响应类型不是 application/json; charset=utf-8(收到 \($0))" }
?? "订阅响应缺少 Content-Type: application/json; charset=utf-8"
}
}
}
extension SubscriptionParseError {
var presentedMessage: String {
switch self {
case .decodingFailure:
return "订阅内容不是合法的 SIP-008 JSON 文档"
case .unsupportedSchemaVersion:
return "订阅文档版本不受支持(需要 SIP-008 version 1)"
case .missingServers:
return "订阅文档缺少 servers 列表"
case .recordValidation(let index, let reason):
return "订阅第 \(index + 1) 条服务器记录无效:\(reason)"
case .duplicateServerID(let id):
return "订阅包含重复的服务器 ID:\(id)"
}
}
}