mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
Domain/ 根目录原有 62 个平铺源文件,无法从目录读出主题划分。 按「目录即主题」重组为 11 个目录(Rules/Custom 为嵌套子目录):Catalog / Subscription / Rules / Runtime / Activation / Settings / SystemProxy / Plugin / Credentials / LegacyImport / Diagnostics。纯移动:类型名、模块名 与 import 均未改动,Domain/ 根下不再有散落文件。目录口径取自 GLOSSARY.md 的章节划分(配置与订阅、代理规则、代理控制与网络、设置、 凭据与诊断),而非新造分类。 配套改动: - project.yml:wrapper 与 helper 两个 target 按文件引用的 15 条显式路径 随目录改名,并补注释固定这一约定——这 15 条指向不存在的文件时, xcodegen generate 以 "missing source directory" 直接失败(实测,不静默)。 - SkeletonTests 新增 DomainLayoutTests:断言 Domain/ 根下无平铺 .swift、 树下只有 .swift。后者防的是与 App/ 同源的坑——Domain/ 整目录是 app 与 Core 的 source path,任何非源码文件都会被 XcodeGen 收进 Resources 阶段 并封进签名后的 bundle。 - README 工程结构说明同步;docs/design 与 docs/research 属历史文档不改。 验证:xcodegen generate 后 app 164 / Core 163 源文件数与整理前一致;Agent 恰好 9 个、Helper 恰好 6 个 Domain 文件(无缺失无多出);app 与 Core 各覆盖 全部 62 个。clean build 0 error;task test 1024 用例全通过(整理前 1022, +2 为新增守卫);task format 未改写任何被移动文件(证明纯移动);task lint 与整理前同为 21 条内容型 warning;packaging-gate.sh ALL CHECKS PASSED。 布局守卫已做变异验证:临时投放松散 .swift 与非 .swift 文件时两个用例均 失败并点名违规文件,清理后复验为绿。
55 lines
2.2 KiB
Swift
55 lines
2.2 KiB
Swift
import Foundation
|
|
|
|
/// 敏感配置文件的原子写盘基线(spec #21 D5):目录 0700(含自愈)、临时文件
|
|
/// 创建即 0600、写全校验后原子替换;任一步失败保留原文件。catalog.json、
|
|
/// activation.json 与 #27 的运行时文件共用同一物理安全基线。
|
|
enum AtomicFileWriter {
|
|
enum WriteError: Error, Equatable {
|
|
case failure(detail: String)
|
|
}
|
|
|
|
/// 隐藏暂存名约定 `.<name>.tmp-<uuid>` 的唯一出处:write 内部使用,同目录
|
|
/// 内的 symlink 暂存也由此派生,保证泄漏的暂存项能被 `isResidueName` 识别。
|
|
static func temporaryURL(for targetURL: URL) -> URL {
|
|
targetURL.deletingLastPathComponent()
|
|
.appendingPathComponent(".\(targetURL.lastPathComponent).tmp-\(UUID().uuidString)")
|
|
}
|
|
|
|
/// 目录项是否为本写入器的暂存残留(宽松匹配:0700 私有目录内过扫无害)。
|
|
static func isResidueName(_ name: String) -> Bool {
|
|
name.hasPrefix(".") && name.contains(".tmp-")
|
|
}
|
|
|
|
/// 把 `data` 原子写入 `fileURL`(含父目录创建与 0700 基线自愈)。
|
|
static func write(_ data: Data, to fileURL: URL) throws {
|
|
let directory = fileURL.deletingLastPathComponent()
|
|
do {
|
|
if !FileManager.default.fileExists(atPath: directory.path) {
|
|
try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
|
|
}
|
|
try FileManager.default.setAttributes(
|
|
[.posixPermissions: 0o700], ofItemAtPath: directory.path)
|
|
} catch {
|
|
throw WriteError.failure(detail: String(describing: error))
|
|
}
|
|
let temporaryURL = temporaryURL(for: fileURL)
|
|
if !FileManager.default.createFile(
|
|
atPath: temporaryURL.path,
|
|
contents: data,
|
|
attributes: [.posixPermissions: 0o600]
|
|
) {
|
|
throw WriteError.failure(detail: "无法创建临时文件 \(temporaryURL.path)")
|
|
}
|
|
do {
|
|
if FileManager.default.fileExists(atPath: fileURL.path) {
|
|
_ = try FileManager.default.replaceItemAt(fileURL, withItemAt: temporaryURL)
|
|
} else {
|
|
try FileManager.default.moveItem(at: temporaryURL, to: fileURL)
|
|
}
|
|
} catch {
|
|
try? FileManager.default.removeItem(at: temporaryURL)
|
|
throw WriteError.failure(detail: String(describing: error))
|
|
}
|
|
}
|
|
}
|