mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-01 07:33:46 +00:00
Qiu Yuzhou
8587b2e80c
三份「执行 → 健康门 → 失败回滚」编排骨架（mode 切换 / rules 提交 / deployPrepared）统一为收敛脊柱的 apply 层： - apply：幂等跳过（派生契约与运行中运行时逐字节相同 → .unchanged， 不闪 starting、不重走健康门）→ 计划执行 → 健康门（requiresReceipt / convergeProxyOnSuccess / preserveProxyOnFailure 逐路径参数照旧）→ 成功后按 proxyTail 收敛系统代理。 - restore：单一回滚例程 + RollbackPlan 两种载荷 policy（mode 的 settings/mode 回退 + 意图变化强制重收敛；rules 的规则文档恢复）。 restoreRuntimeDocument/relaunchPreviousInstance 删除——计划层对 写契约/信号/注销重注的裁决与旧例程逐场景等价。 - 票据 inout 传参：execute 后的 flow 推进对调用方可见，rules 提交在 apply 之后的时效检查使用推进过的票据。 - ModeTransitionSnapshotForRules 删除，rules 回滚计划在部署入口构建。 行为保持：.run 计划动作全部同步执行，starting 前置不可观测；mode/rules 路径到 apply 时计划必非空，幂等跳过只对 deploy 路径生效（与「有效值未 变的提交不做运行时收敛」不变量一致）。
ShadowsocksX-NG
🚧 重新实现进行中 —— 本仓库正在使用现代技术栈重写 ShadowsocksX-NG macOS 客户端。
新工程不再通过 git 子模块在仓库内构建依赖，而是直接复制上游项目发布好的可执行文件，以简化构建流程。
目录结构
.
├── ShadowsocksX-NG2/ # 新工程：现代化重写版本（开发中）
└── Legacy/ # 旧版工程完整源码，仅供参考，不保证可构建
旧版工程的功能说明与使用文档见 Legacy/README.md。
开发钩子
新 clone 后，在仓库根目录启用 Git hooks：
git config core.hooksPath .githooks
启用后，pre-commit 只检查暂存区中 ShadowsocksX-NG2/ 下的 .swift 文件：swift format 的结果写回暂存区、不修改工作区；SwiftLint 的 error 级违规拒绝提交，warning 仅提示。Legacy/ 和其他文件跳过；没有 NG2 Swift 文件时直接放行。含有 NG2 Swift 文件但缺少工具时，提交检查失败。工具安装与版本见 ShadowsocksX-NG2/README.md。