mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-01 07:33:46 +00:00
Qiu Yuzhou
c1aba5a882
GUI 侧 XPC 回调闭包（invalidationHandler 与 remoteObjectProxy 错误回调）在 @MainActor 方法里形成、传给非 @Sendable 的 Foundation 参数被推断为主 actor 隔离，Foundation 在 XPC 内部队列上调起时触发动态隔离断言直接崩溃；显式标注 @Sendable（nonisolated），闭包只捕获 Sendable 应答闸门。 连接系统域 LaunchDaemon 的 MachService 必须带 options: .privileged（否则只 在 per-user launchd 域查找，永远失败走错误回调）；并把 resume() 提到首次远 程调用之前，超时兜底任务在应答到达后取消。 收敛/清除失败补 RuntimeLog systemProxyWriteFailed(detail:)（诊断报告白名单 按既有承诺脱敏收录），XPC/ helper 层失败原因不再只能靠崩溃报告逆向。 listener delegate 与客户端校验移入 Domain 共享编译单元（与引擎同模式）， main.swift 改为显式注入引擎；新增真实 XPC 装配层 round-trip 测试：匿名监听 器挂真实 delegate（注入假特权写入器）+ listenerEndpoint 连接，覆盖接口签 名、客户端签名校验、Data 传输与 XPC 队列应答路径，无需 launchd。
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。