mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-10-30 22:23:43 +00:00
Qiu Yuzhou
0f2855f453
系统对 NSSecureTextField 默认提供钥匙串/密码 App 的自动填充入口，且不 取决于字段语义：实测底层字段 contentType 已是 nil，既有 .textContentType(nil) 不足以关掉它，AppKit 也没有公开开关。 改用字段级私有开关 _setPasswordAutofillEnabled:（responds(to:) 守卫， 方法消失时静默回退、不崩溃）。PasswordAutofillOptOut 以同帧背景探针 认领承载密码控件的文本框，只关密码列自己；明文/密文切换换成新实例后 重新认领。 新增 PasswordAutofillOptOutTests 固定认领范围与切换行为；全量单测 1022 通过，人工验证通过。取舍与后果记入 ADR-0028。
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。
领域文档语言
本项目的 术语表 和新建 架构决策记录（ADR） 使用简体中文，代码标识符与必要的英文术语保留原文；已有 ADR 保留原文，不作语言迁移。
AI 生成大量文档后，人与机器之间的沟通成为协作瓶颈：人的阅读、理解和审阅速度决定了文档能否有效推动开发。使用简体中文可以降低维护者的认知负荷，提高沟通与审阅效率。