mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-02 16:53:45 +00:00
Qiu Yuzhou
b26954dd20
非「仅本机」监听方式下，首页命令卡在复制按钮上方提供单选 IP 下拉框：
候选仅含回环与当前启用 Wi‑Fi/Ethernet 接口单播地址（严格 SCNetworkInterface
类型白名单，排除 VPN/虚拟/未知类型），按监听地址族过滤（双栈含两个回环，
127.0.0.1 置顶；仅 IPv6 默认 ::1），标签 {IP} - {name}（本地化名称缺失回退
BSD 名）。两种 shell 的 HTTP/HTTPS/SOCKS 端点共用选中地址，端口取已保存
监听事实，IPv6 URL 方括号；选择会话内有效（跨首页返回保留、重启重置），
失效自动回退默认回环。进入首页、网络变化（SCDynamicStore 监视+去抖）与
复制前刷新。
- 新缝 LocalInterfaceFactsReading：原始接口事实（地址/类型/名称）+ 变化
通知；生产适配器封装 getifaddrs/SCNetworkInterface/SCDynamicStore 细节
- 运行时缝以 listenFacts 替换 terminalProxyEnvironmentCommands；命令派生
移至工作流层（监听事实 + 生效选择）
- 替身测试证明策略行为；真实主机非视觉验证证明系统适配器整合
（回环识别/类型映射/地址规范化/链路本地判定）
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。