Files
ShadowsocksX-NG/ShadowsocksX-NG2/AGENTS.md
T
Qiu Yuzhou 0cf28c97fe feat(ng2): config catalog domain core with credential refs (#25)
配置目录领域核心(spec #21 D3/D5,票 #25):

- Domain/ 新增配置目录树:单父、显子序、无环;手动/订阅来源严格分离;
  有效启用 = 节点及其全部祖先启用;手动节点携带子树移动与重排;
  非空手动组递归删除(返回被删条目供 Keychain 清理);空组持久保留;
  非法操作(跨来源、身份复用即共享父、成环、订阅节点结构改动、
  订阅服务器直挂根)全部带明确原因拒绝且状态不动。
- 凭据引用:密码/插件参数只在 Keychain 存权威副本,配置树只持
  CredentialReference;KeychainCredentialStore 写读一致、覆盖写、幂等删。
- CatalogFileStore:v2/catalog.json 目录 0700/文件 0600,临时文件原子替换;
  缺失 → 空目录,损坏/版本未知/结构不一致(悬空、共享父、成环含根外孤环、
  不可达)→ 命名明确的 corrupt,结构校验收敛在
  ConfigurationCatalog.validated 工厂。
- 测试 43 项覆盖全部验收项;project.yml 增加 Domain/ 源码目录。
- .swiftlint.yml 关闭 trailing_comma(与 .swift-format 尾逗号基线冲突,
  触发案例见文件内注释),README/AGENTS.md 同步 Domain/ 与工具说明。
2026-09-20 15:22:09 +08:00

999 B

ShadowsocksX-NG2

新实现(2.0)所在目录。仓库级约定见根目录 AGENTS.md;工程结构、外部二进制供应链、签名基线、构建测试命令、代码风格工具安装与基线版本见 README.md,本文件不重复。

Swift 提交门槛

  • 启用钩子(新 clone 必做一次,否则门槛不生效):

    git config core.hooksPath .githooks
    
  • 钩子只检查本目录暂存的 .swift 文件(其余目录含 Legacy/ 一律跳过):swift format 结果直接写进提交、工作区不动;SwiftLint error 级违规拒绝提交,warning 仅提示。

  • 手动执行(在本目录内运行配置才自动加载;swift format 作用于目录需 -r):

    swift format format --in-place -r App Tests Domain
    swiftlint lint
    
  • 调规则只针对实际痛点:改 .swift-format / .swiftlint.yml 的 PR 须给出触发案例,并同步更新 README 中的基线版本。