mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-10-30 06:03:48 +00:00
Qiu Yuzhou
43ea00cb44
launchd 对 ProgramArguments[0] 的相对路径按 _PATH_STDPATH（PATH）解析而非 bundle：系统域 daemon 的 job 因此永远 spawn 失败（EX_CONFIG 节流循环， launchctl print 显示 job state = spawn failed、runs 持续累加），客户端 XPC 调用只能等到超时。agent 之所以正常，是 GUI 域导入时被解析成绝对路径，system 域 submitted job 没有这一步。SMAppService 清单的正确键是 BundleProgram （bundle 相对，launchd.plist(5)），改用之。 launchd 同时沿用注册提交时的定义快照：app 更新改动 LaunchDaemon 清单后旧 定义不会自动刷新（register() 对已注册服务返回 alreadyRegistered），必须注销 重注。门禁在已批准分支按清单内容 SHA-256 指纹（UserDefaults）检测漂移，漂移 才注销重注——审批与 bundle 签名绑定，重注不重新弹授权；首次注册成功即记指 纹，失败不记（下次启动重试），指纹一致为一次哈希比对的 no-op。
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。