Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/ErrorPresentation.swift
T
Qiu Yuzhou 5e13c1716f feat(ng2): managed plugins end to end (#38)
- 受管插件静态事实表(v2ray-plugin v1.3.2,来源/许可证/版本/重签)与
  BundleManagedPluginProvider:受管集内且 bundle 内可执行文件在位才返回
  绝对路径;与 Vendor 清单双向锚定(D6/D10)
- 服务器编辑器插件区:受管选择器(无 + 受管列表),选中受管项才显示
  供应链事实与参数输入;集外引用显式「本版本未提供」并原样保留
- updateServer 插件落盘语义:「无」整体清除、参数写删钥匙串、集外不漂移
- wrapper 监听建立判定:3 秒未建立本地监听记 error 日志,监管继续(D10)
- 诊断导出新增受管插件清单(名称/版本/提供状态,无参数)
- 功能级兼容实测记录(docs/research/plugin-compat-record.md)与端到端
  冒烟:契约插件路径 → sslocal 拉起 → v2ray-plugin 进程建立 → 停止链
2026-09-21 10:38:30 +08:00

121 lines
4.0 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 .pluginNotManaged(let program):
return "本版本未提供插件「\(program)」"
}
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)"
}
}
}