Files
ShadowsocksX-NG/ShadowsocksX-NG2/Domain/Runtime/ProxyRuntimePlan.swift
T
Qiu Yuzhou 856d6b4272 refactor(domain): 按主题重组 Domain/ 源码目录
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 文件时两个用例均
失败并点名违规文件,清理后复验为绿。
2026-10-05 20:13:35 +08:00

94 lines
3.8 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
/// LaunchAgent 注册态(GUI 视角,spec #21 D2):SMAppService.Status 的纯域
/// 映射。SMAppService 不暴露运行中 agent 的 pid,wrapper 活性另由
/// `WrapperProcessState` 表达。
enum LaunchAgentStatus: Equatable, Sendable {
case notRegistered
/// 已注册(无论 wrapper 进程当前是否在运行)。
case registered
/// 需要用户在系统设置的登录项中批准。
case requiresApproval
/// 注册清单缺失(bundle 内 plist 不在)。
case notFound
}
/// wrapper 进程活性:GUI 读 `agent.pid` 并以 `kill(pid, 0)` 判定(D2)。
enum WrapperProcessState: Equatable, Sendable {
case notRunning
case running(pid: Int32)
}
/// GUI 对代理运行时的意图:运行给定义档,或停止并清理。
enum RuntimeIntent: Equatable {
case run(SslocalRuntimeDocument)
case stop
}
/// 控制器按序执行的动作(spec #21 D2/D5)。
enum RuntimeAction: Equatable, Sendable {
/// 原子写契约文件(权限与替换基线由 RuntimeFileStore 保证)。
case writeContract
/// 注册 LaunchAgent;launchd 随即拉起 wrapper,wrapper 启动时读契约。
case registerAgent
/// 注销 LaunchAgent:launchd 以 SIGTERM 结束 wrapper,触发显式停止协议
/// (wrapper 停 sslocal 并等待退出)。
case unregisterAgent
/// 通知运行中的 wrapper 重读契约;热重载或优雅重启由 wrapper 按监听
/// 指纹判定(D5 变更协议)。
case signalReload(pid: Int32)
/// 删除运行时文件(契约、pid 文件与残留临时文件)。
case deleteRuntimeFiles
}
/// 纯决策层(spec #21 D2/D5):把「代理意图 + launchd 注册态 + wrapper 活性
/// + 磁盘契约」推到有序动作序列。GUI 启动重同步、目录提交重展开与代理开关
/// 共用同一决策;相同契约内容跳过写入,兑现激活状态机的幂等注记。
enum ProxyRuntimePlan {
static func actions(
intent: RuntimeIntent,
agentStatus: LaunchAgentStatus,
wrapper: WrapperProcessState,
contractOnDisk: Data?,
preparedContract: PreparedRuntimeContract? = nil
) -> [RuntimeAction] {
switch intent {
case .run(let document):
let preparedData = preparedContract.flatMap { contract in
contract.document == document ? contract.data : nil
}
switch agentStatus {
case .notRegistered, .notFound, .requiresApproval:
// 首次启用或从未注册:写盘后注册,launchd 拉起的 wrapper 直接读新档。
return [.writeContract, .registerAgent]
case .registered:
switch wrapper {
case .running(let pid):
// 相同内容跳过写入(幂等优化);内容比较本身失败时宁可重写——
// 写入侧会如实呈现错误,不静默跳过部署。
if let onDisk = contractOnDisk,
let desiredData = preparedData ?? (try? document.jsonData()),
desiredData == onDisk
{
return []
}
return [.writeContract, .signalReload(pid: pid)]
case .notRunning:
// 已注册但 wrapper 已干净退出(如契约曾被清理):强制重新拉起。
// SMAppService 对已注册服务重复 register 不保证重跑,先注销再注册。
return [.writeContract, .unregisterAgent, .registerAgent]
}
}
case .stop:
switch agentStatus {
case .registered:
// 显式停止协议次序(D2):注销即 SIGTERM wrapper → wrapper 停 sslocal
// 并等待 → 控制器确认 wrapper 退出后才删文件(执行侧保证次序)。
return [.unregisterAgent, .deleteRuntimeFiles]
case .notRegistered, .requiresApproval, .notFound:
return [.deleteRuntimeFiles]
}
}
}
}