Files
ShadowsocksX-NG/ShadowsocksX-NG2/Domain/NodeIdentity.swift
T
Qiu Yuzhou 7bb327ba1d docs(domain): CONTEXT.md 改名 GLOSSARY.md 并对齐引用
domain-modeling skill 升级后单上下文约定文件名为 GLOSSARY.md:
git mv 保历史、内容零改动;AGENTS.md、docs/agents/domain.md 及
NG2 源码注释中的活引用随之对齐。docs/design、docs/research、ADR
中的旧名引用属历史记录,不改写。
2026-10-04 15:06:41 +08:00

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)
}
}