mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
配置目录领域核心(spec #21 D3/D5,票 #25): - Domain/ 新增配置目录树:单父、显子序、无环;手动/订阅来源严格分离; 有效启用 = 节点及其全部祖先启用;手动节点携带子树移动与重排; 非空手动组递归删除(返回被删条目供 Keychain 清理);空组持久保留; 非法操作(跨来源、身份复用即共享父、成环、订阅节点结构改动、 订阅服务器直挂根)全部带明确原因拒绝且状态不动。 - 凭据引用:密码/插件参数只在 Keychain 存权威副本,配置树只持 CredentialReference;KeychainCredentialStore 写读一致、覆盖写、幂等删。 - CatalogFileStore:v2/catalog.json 目录 0700/文件 0600,临时文件原子替换; 缺失 → 空目录,损坏/版本未知/结构不一致(悬空、共享父、成环含根外孤环、 不可达)→ 命名明确的 corrupt,结构校验收敛在 ConfigurationCatalog.validated 工厂。 - 测试 43 项覆盖全部验收项;project.yml 增加 Domain/ 源码目录。 - .swiftlint.yml 关闭 trailing_comma(与 .swift-format 尾逗号基线冲突, 触发案例见文件内注释),README/AGENTS.md 同步 Domain/ 与工具说明。
31 lines
1.7 KiB
Swift
31 lines
1.7 KiB
Swift
/// 目录操作失败原因,逐项对应 CONTEXT.md 的结构不变量(单父、显子序、
|
|
/// 无环、手动/订阅严格分离)。
|
|
enum CatalogError: Error, Equatable, Sendable {
|
|
/// 目标节点不存在。
|
|
case nodeNotFound(NodeID)
|
|
/// 指定的父容器不存在。
|
|
case parentNotFound(NodeID)
|
|
/// 指定的父容器不是分组(例如把服务器叶子当容器)。
|
|
case parentNotAGroup(NodeID)
|
|
/// 操作目标不是服务器叶子。
|
|
case notAServer(NodeID)
|
|
/// 操作目标不是分组。
|
|
case notAGroup(NodeID)
|
|
/// 目标身份已被挂载的节点占用:身份不复用于另一逻辑节点,否则即共享父。
|
|
case duplicateID(NodeID)
|
|
/// 手动与订阅来源严格分离:不允许把节点放进另一来源的子树。
|
|
case crossSourcePlacement(node: NodeSource, container: NodeSource)
|
|
/// 订阅子树由远端权威所有:本地结构操作(移动/删除/改连接字段/改名)一律拒绝,
|
|
/// 仅 `enabled` 作为本地资格状态可写;整棵订阅子树的移除属于订阅票(#35)。
|
|
case subscriptionNodeImmutable(NodeID)
|
|
/// 订阅服务器叶子必须位于其订阅固定分组内,不得直挂目录根(CONTEXT.md
|
|
/// 「Subscription group」:根层只允许订阅固定分组本身)。
|
|
case subscriptionServerAtRoot(NodeID)
|
|
/// 把分组移动进它自己的子树会成环。
|
|
case cycleDetected(NodeID)
|
|
/// 插入位置超出目标容器允许范围(0…=子节点数;以摘除移动节点后的子序计)。
|
|
case indexOutOfRange(parent: NodeID?, index: Int?, childCount: Int)
|
|
/// 外部载荷(持久化文件)结构不一致:悬空子引用、共享父、成环或不可达节点。
|
|
case invalidStructure(String)
|
|
}
|