mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-19 08:34:59 +00:00
domain-modeling skill 升级后单上下文约定文件名为 GLOSSARY.md: git mv 保历史、内容零改动;AGENTS.md、docs/agents/domain.md 及 NG2 源码注释中的活引用随之对齐。docs/design、docs/research、ADR 中的旧名引用属历史记录,不改写。
50 lines
1.7 KiB
Swift
50 lines
1.7 KiB
Swift
import Foundation
|
|
|
|
/// 节点来源:手动子树与订阅子树严格分离(GLOSSARY.md「Relationships and invariants」)。
|
|
enum NodeSource: String, Codable, Equatable, Sendable {
|
|
case manual
|
|
case subscription
|
|
}
|
|
|
|
/// 节点持久身份:不透明字符串。手动节点每次新建生成全新 UUID,身份不随
|
|
/// 显示名、位置或父节点变化,也不复用于其他逻辑节点;订阅节点使用供应商
|
|
/// 稳定 ID(作用域限本订阅,由订阅数据保证唯一),本票仅供夹具使用。
|
|
struct NodeID: Hashable, Codable, Sendable {
|
|
let rawValue: String
|
|
|
|
init(rawValue: String) { self.rawValue = rawValue }
|
|
|
|
/// 手动新建节点身份。
|
|
static func fresh() -> NodeID { NodeID(rawValue: UUID().uuidString) }
|
|
|
|
init(from decoder: Decoder) throws {
|
|
rawValue = try decoder.singleValueContainer().decode(String.self)
|
|
}
|
|
|
|
func encode(to encoder: Encoder) throws {
|
|
var container = encoder.singleValueContainer()
|
|
try container.encode(rawValue)
|
|
}
|
|
}
|
|
|
|
/// 凭据引用:指向 Keychain 权威副本的非秘密关联(GLOSSARY.md「Credential
|
|
/// reference」)。配置树只存引用,永不存秘密明文;秘密值按 D5 由
|
|
/// CredentialStoring 写读。
|
|
struct CredentialReference: Hashable, Codable, Sendable {
|
|
let rawValue: String
|
|
|
|
init(rawValue: String) { self.rawValue = rawValue }
|
|
|
|
/// 新建凭据引用。
|
|
static func fresh() -> CredentialReference { CredentialReference(rawValue: UUID().uuidString) }
|
|
|
|
init(from decoder: Decoder) throws {
|
|
rawValue = try decoder.singleValueContainer().decode(String.self)
|
|
}
|
|
|
|
func encode(to encoder: Encoder) throws {
|
|
var container = encoder.singleValueContainer()
|
|
try container.encode(rawValue)
|
|
}
|
|
}
|