Alawn/ShadowsocksX-NG
1
0
Fork 0
mirror of https://github.com/shadowsocks/ShadowsocksX-NG.git synced 2026-10-30 06:03:48 +00:00
Code Releases Activity
902 Commits 8 Branches 34 Tags
856d6b42726fdf9505e72bcaf702c2eef4401b58
Commit Graph
902 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Qiu Yuzhou 856d6b4272 refactor(domain): 按主题重组 Domain/ 源码目录 
Domain/ 根目录原有 62 个平铺源文件，无法从目录读出主题划分。

按「目录即主题」重组为 11 个目录（Rules/Custom 为嵌套子目录）：Catalog /
Subscription / Rules / Runtime / Activation / Settings / SystemProxy /
Plugin / Credentials / LegacyImport / Diagnostics。纯移动：类型名、模块名
与 import 均未改动，Domain/ 根下不再有散落文件。目录口径取自
GLOSSARY.md 的章节划分（配置与订阅、代理规则、代理控制与网络、设置、
凭据与诊断），而非新造分类。

配套改动：

- project.yml：wrapper 与 helper 两个 target 按文件引用的 15 条显式路径
  随目录改名，并补注释固定这一约定——这 15 条指向不存在的文件时，
  xcodegen generate 以 "missing source directory" 直接失败（实测，不静默）。
- SkeletonTests 新增 DomainLayoutTests：断言 Domain/ 根下无平铺 .swift、
  树下只有 .swift。后者防的是与 App/ 同源的坑——Domain/ 整目录是 app 与
  Core 的 source path，任何非源码文件都会被 XcodeGen 收进 Resources 阶段
  并封进签名后的 bundle。
- README 工程结构说明同步；docs/design 与 docs/research 属历史文档不改。

验证：xcodegen generate 后 app 164 / Core 163 源文件数与整理前一致；Agent
恰好 9 个、Helper 恰好 6 个 Domain 文件（无缺失无多出）；app 与 Core 各覆盖
全部 62 个。clean build 0 error；task test 1024 用例全通过（整理前 1022，
+2 为新增守卫）；task format 未改写任何被移动文件（证明纯移动）；task lint
与整理前同为 21 条内容型 warning；packaging-gate.sh ALL CHECKS PASSED。

布局守卫已做变异验证：临时投放松散 .swift 与非 .swift 文件时两个用例均
失败并点名违规文件，清理后复验为绿。
 2026-10-05 20:13:35 +08:00
Qiu Yuzhou fb428f12bc refactor(app): 按分层重组 App/ 源码目录 
App/ 根目录原有 73 个散落源文件，已无法从目录读出任何分组信息。

按「目录即分层」重组为 Composition / Application / Presentation / UI /
PlatformEffects / Resources 六个目录，UI 层再按子视图分目录（Workspace、
Home、Servers（含 Plugin）、Subscriptions、Rules、Settings、Diagnostics、
StatusMenu）。纯移动：类型名、模块名与 import 均未改动，App/ 根层不再有
散落文件。

配套改动：

- project.yml：Core 测试镜像的 excludes 由裸文件名改为 `**/` 递归形式。
  XcodeGen 的 exclude 不跨 `/`，裸名只匹配 App 根层；MainApp.swift 下移后
  旧写法会静默失效，把 @main 组合根编进测试镜像。info.path 与
  entitlements.path 指向 App/Resources/；并排除 `**/*.md`——App/ 下任何
  非源码文件都会被 XcodeGen 收进 Resources 阶段并封进签名后的 bundle。
- SkeletonTests 的架构守卫由「默认扫描全部 App/ + 7 个豁免文件 + 1 个豁免
  前缀 + 4 个豁免目录」改为正面圈定 App/UI/，豁免登记全部删除；新增运行时
  适配器放进 Application/ 即自动落在扫描范围外，无需再登记。
- README 工程结构说明同步；根 .gitignore 的生成物路径随 Resources/ 归位。

验证：clean build 0 error；task test 1022 用例全通过（含两个架构守卫）；
task format 无改动（证明纯移动）；task lint 与移动前同为 21 条内容型
warning；packaging-gate.sh ALL CHECKS PASSED，确认 plist/entitlements 归位
后签名与 entitlements 语义不变。

注意：迁移时须先删旧的生成物再 xcodegen generate，否则遗留的 App/Info.plist
会被当作普通资源扫进 Resources 阶段。
 2026-10-05 19:56:18 +08:00
Qiu Yuzhou 0f2855f453 fix(ui): 关闭服务器表单密码框的系统密码自动填充 
系统对 NSSecureTextField 默认提供钥匙串/密码 App 的自动填充入口，且不
取决于字段语义：实测底层字段 contentType 已是 nil，既有
.textContentType(nil) 不足以关掉它，AppKit 也没有公开开关。

改用字段级私有开关 _setPasswordAutofillEnabled:（responds(to:) 守卫，
方法消失时静默回退、不崩溃）。PasswordAutofillOptOut 以同帧背景探针
认领承载密码控件的文本框，只关密码列自己；明文/密文切换换成新实例后
重新认领。

新增 PasswordAutofillOptOutTests 固定认领范围与切换行为；全量单测
1022 通过，人工验证通过。取舍与后果记入 ADR-0028。
 2026-10-05 19:23:55 +08:00
Qiu Yuzhou a6ebb69bbf feat(servers): add group sharing popover 2026-10-05 16:57:48 +08:00
Qiu Yuzhou bd68e45ea4 feat(servers): present sharing in a popover 2026-10-05 16:41:18 +08:00
Qiu Yuzhou 13a548193b ui: improve rules filter layout 2026-10-05 15:49:29 +08:00
Qiu Yuzhou fd6fa65a8d feat(share): rework server share as QR sheet 
- Replace toolbar QR popover with a window sheet per sketch: top hint,
  280pt white-backed QR, copy-image / save-image / copy-ss:// actions
  and a Done button; all buttons share a 260pt min label width
- Freeze share payload and suggested file name at presentation time;
  transient "copied" feedback on copy actions
- Add ImageClipboard seam (PNG normative type + TIFF in AppKit adapter)
  and QrImageSaver seam (NSSavePanel PNG, sanitized suggested name)
- Register new typed failures in the presentation whitelist; extend
  platform-effects architecture guard and seam tests
- Record spec in docs/design/server-share-sheet.md; GLOSSARY server
  share now covers saved QR image files
 2026-10-05 13:54:59 +08:00
Qiu Yuzhou 7c44cb4542 fix: retain focus in plugin option fields 
Remove redundant tap-driven focus writes that redirect plugin input to the server name field.
 2026-10-05 13:03:29 +08:00
Qiu Yuzhou 2b4f68f65d fix(rules): fit custom rule sheet title and adaptive height 
- Unify editor sheet title with other sheets (.title2)
- Cap preview area so the sheet hugs its content with no blank space
- Keep last preview while recomputing and animate residual size
  changes to stop per-keystroke sheet jitter
 2026-10-05 12:53:24 +08:00
Qiu Yuzhou 6f81b3fd70 Merge branch 'codex/custom-plugin' into develop 2026-10-05 12:05:42 +08:00
Qiu Yuzhou 86779b63ee feat(plugins): add settings management UI 2026-10-05 12:03:52 +08:00
Qiu Yuzhou ca45275810 Merge branch 'codex/custom-plugin' into develop 
# Conflicts:
#	ShadowsocksX-NG2/App/Localizable.xcstrings
 2026-10-05 11:18:03 +08:00
Qiu Yuzhou 3d8d56b8e1 test(plugins): cover mapping commit and runtime convergence 2026-10-05 11:13:42 +08:00
Qiu Yuzhou e74f8dfc01 refactor(plugins): derive server form facts from effective catalog 2026-10-05 00:46:43 +08:00
Qiu Yuzhou 128efcc0d6 feat(plugins): add user plugin catalog and runtime wiring 2026-10-05 00:28:16 +08:00
Qiu Yuzhou 3b3528d232 feat(subscription): show usage and provider dates 2026-10-05 00:10:13 +08:00
Qiu Yuzhou 87701fbacd fix(ui): prevent sidebar toolbar flicker 
Keep a hidden, zero-size detail toolbar item across destinations.
Crossing zero detail items triggers a native toolbar background fade,
including persistent sidebar controls.
 2026-10-04 22:54:31 +08:00
Qiu Yuzhou 4623dc78aa Merge commit 'a9a7aed' into develop 2026-10-04 22:26:20 +08:00
Qiu Yuzhou 76f8c9eaad fix(ui): update import button label and adjust sidebar column width 2026-10-04 22:24:04 +08:00
Qiu Yuzhou 543ae14c53 fix(import): 工具栏按钮文案简化为「导入服务器」并更名 addMenu 
按钮文案按显示空间收敛为「导入服务器」；构建方法更名 importButton，
与「菜单已收敛为单按钮」的实质一致。
 2026-10-04 22:11:49 +08:00
Qiu Yuzhou a9a7aedc0b fix(servers): restore direct creation buttons 2026-10-04 22:03:18 +08:00
Qiu Yuzhou 7d5784bb3a fix(import): 导入面板高度自适应内容 
去掉 minHeight 钉死的初始高度，拖放区改固定高：初始面板收拢为内容
自然高度，结果区出现时面板随内容长高。
 2026-10-04 21:59:06 +08:00
Qiu Yuzhou 83d67eba24 fix(ServerFormFields): update port validation to use closure syntax for clarity 2026-10-04 21:51:43 +08:00
Qiu Yuzhou b54b50d887 refactor(import): 导入模型拆出独立文件 
ImportSource/ImportRunOutcome 等统一导入 seam 类型与 LegacyImportAvailability
从 CatalogWorkflowModels.swift 集中到 CatalogWorkflowImportModels.swift，
使其回到 400 行基线以内；纯代码搬移，无行为变化。
 2026-10-04 21:49:28 +08:00
Qiu Yuzhou 5968b1fd0b feat(import): 统一服务器导入入口并支持 SIP-008 文件导入 
新增统一导入面板（拖放多文件/剪贴板 ss:// 一键/旧版直接导入），来源按内容
嗅探分派（位图→二维码、JSON→SIP-008、其余→文本行），逐来源独立事务与
结果。深模块集中在 CatalogWorkflow.importServers 单一接缝，凭据统一经
journal，退役 ss:// 文本框、二维码预览、Legacy 专属 sheet 与首启主动弹窗。
SIP-008 导入语义见 ADR-0027（文档 ID 只作装配键，目录身份全新生成）。
 2026-10-04 21:45:20 +08:00
Qiu Yuzhou 535d62a28a fix(servers): support root creation and clearing selection 
Add explicit current-group and root creation menus. Clear the management
tree selection on blank clicks or Escape while focused. Capture creation
parents, retain failed group drafts, and select/reveal created nodes.

Validation: 870 hostless tests (921 executions), 21 Python checks, unsigned
app build, format/lint/diff checks. Standards and spec reviews passed.
Native interaction and visual verification were not performed per request.
 2026-10-04 21:36:51 +08:00
Qiu Yuzhou b5dc43faf8 fix(ui): adjust sidebar column width for improved layout 2026-10-04 19:37:00 +08:00
Qiu Yuzhou 9c9a150ead refactor(ui): 集中插件参数草稿移动规则 2026-10-04 19:12:14 +08:00
Qiu Yuzhou 85db6cec00 refactor(runtime): 集中收敛意图与恢复策略 2026-10-04 19:01:47 +08:00
Qiu Yuzhou 0164ff75ec fix: defer plugin mode changes past view updates 
macOS segmented Picker writes its binding within a SwiftUI update.
Defer the draft mutation to a main actor task to prevent synchronous
Published notifications during that update.
 2026-10-04 18:46:25 +08:00
Qiu Yuzhou 1a22af7e62 refactor(forms): 集中服务器装载与失败门禁 2026-10-04 16:46:20 +08:00
Qiu Yuzhou 3d9ca630c5 feat(ui): 工具栏默认「图标和文本」标签风格 
场景级 windowToolbarLabelStyle 默认 titleAndIcon（绑定 AppStorage，
用户右键工具栏改选可持久化）；摘掉服务器区四条目与导入菜单的
iconOnly 条目级覆盖，规则表行内编辑按钮非工具栏保留不动。
 2026-10-04 15:56:41 +08:00
Qiu Yuzhou 46185797fe feat(ui): 边栏菜单改「导入」，添加订阅移回订阅页工具栏 
- 边栏「添加」菜单改名「导入」，图标换 square.and.arrow.down，与
  分享按钮 square.and.arrow.up 成对；菜单收敛为三项导入动作
- 「添加订阅」移回订阅分区自挂工具栏，表单由订阅页自持；窗口壳删
  .addSubscription workspace sheet 与 destination 映射
- 空态文案同步：订阅页指向本页按钮，服务器页改称「导入」菜单并删
  去从未存在的「创建分组」表述
 2026-10-04 15:41:10 +08:00
Qiu Yuzhou a00a93d5c0 docs: align domain docs with Chinese glossary 2026-10-04 15:19:54 +08:00
Qiu Yuzhou 7bb327ba1d docs(domain): CONTEXT.md 改名 GLOSSARY.md 并对齐引用 
domain-modeling skill 升级后单上下文约定文件名为 GLOSSARY.md：
git mv 保历史、内容零改动；AGENTS.md、docs/agents/domain.md 及
NG2 源码注释中的活引用随之对齐。docs/design、docs/research、ADR
中的旧名引用属历史记录，不改写。
 2026-10-04 15:06:41 +08:00
Qiu Yuzhou edaa492257 feat(ui): 服务器工具栏新增删除按钮 
- 工具栏次序：新建服务器、新建分组、删除、分享；删除钮作用于当前
  选中节点，确认弹窗与右键菜单共用 deleteTarget 流（档位见
  deleteFacts）。
- 无选中、选择失效或选中项不可删除时禁用；资格判定新增政策缝
  CatalogWorkflow.canDelete（节点存在且 manual），订阅节点结构只读
  不经此口径，订阅删除仍留在订阅分区。
- CONTEXT.md Vocabulary 增补 Deletable node 术语；新增 canDelete
  接口测试。
 2026-10-04 14:56:48 +08:00
Qiu Yuzhou fab2004aa5 feat(ui): 服务器分享上收为分区工具栏按钮 
- 工具栏最右新增「分享」(square.and.arrow.up)，行为复用原二维码弹窗
  （220×220 QR + 内嵌复制 ss:// 链接，后台线程生成）；详情区底部
  「复制 ss:// 链接」「二维码…」两按钮删除
- disabled 单谓词 sharePayload()==nil：空选择/选中分组/凭据不可解析
  一律不可用
- 弹窗锚在工具栏按钮；选中变化即收起，生成前清旧图防闪旧二维码
- ServerDetailView 失去 clipboard 参数；ServersView.errors 放宽
  internal 供跨文件扩展呈现失败
- CONTEXT.md Vocabulary 新增 Server share 词条（_Avoid_: export，
  export 保留给文件快照：分组 SIP-008 导出、诊断报告）
 2026-10-04 14:08:56 +08:00
Qiu Yuzhou b3fa498aaf test(agent): LaunchAgent manifest 双份 artifact 一致性守卫 
manifest 字典抽为 SMAppLaunchAgentService.manifestDictionary(programArguments:)
单一构造点，writeUserPlist 消费；新增测试解码 bundle 内打包 plist
（SMAppService 审批用）与代码重建字典，断言 Label/KeepAlive/
ThrottleInterval 逐键相等、ProgramArguments 形状等价（bundle 相对 vs
绝对路径是文档化的刻意差异）。

评审候选⑥ 6d：crash 重放协议的两份 artifact 从此有编译后守卫。
 2026-10-04 13:08:09 +08:00
Qiu Yuzhou 4b2ddae99e refactor(paths): App Support 目录命名权归 RuntimePaths 
六个 GUI 配置文件位置（catalog/settings/listen-settings/custom-rules/
activation 与 silent-launch 遗留迁移源）自拼 applicationSupport 目录的
写法收敛为 RuntimePaths 的具名函数，各 store 的 defaultFileURL 改一行
委托。RuntimePaths 宪章从「跨进程运行时契约」扩为「App Support 目录
全部文件清单」——目录里有过哪些文件从此一处可答。

评审候选⑥ 6c：目录改名从动六个文件缩为动一处。
 2026-10-04 13:02:31 +08:00
Qiu Yuzhou c1e229c455 refactor(runtime): tmp 暂存命名单一主人归 AtomicFileWriter 
AtomicFileWriter 暴露 temporaryURL(for:)（.\(name).tmp-<uuid> 约定唯一出处）
与 isResidueName(_:)（残留谓词）：write 内部与 RuntimeFileStore 的两处
symlink 暂存（repointActiveLink/restoreLink）改吃 temporaryURL，
deleteRuntimeFiles 的残留识别改吃谓词。staging 泄漏由
deleteRuntimeFiles 兜底清理的隐性链条由此由构造保证。

评审候选⑥ 6b：命名约定一改、残留清理不再静默失效。
 2026-10-04 13:00:26 +08:00
Qiu Yuzhou 945ea2b4db refactor(runtime): 收据写者归一为 Agent wrapper 
RuntimeFileStore.writeRuntimeReceipt 生产零调用（17 处调用全为测试夹具），
从生产 interface 删除；测试侧经 RuntimeReceiptFixture 的 extension 以同签名
承接，调用点零改动。收据格式知识仍由 RuntimeDeploymentReceipt 类型承载，
GUI 侧只保留 readRuntimeReceipt 读缝。

评审候选⑥ 6a：wrapper 是唯一收据写者，GUI 永不伪造收据。
 2026-10-04 12:59:26 +08:00
Qiu Yuzhou d9460c4d6d fix(ui): 订阅 URL 预填失败经错误弹窗呈现真实原因 2026-10-04 12:37:56 +08:00
Qiu Yuzhou bf23d03288 fix(ui): 订阅卡页脚改为现行快照表述 2026-10-04 12:37:51 +08:00
Qiu Yuzhou 6b2ee2dcbe refactor(ui): 删除 Legacy 导入的死 catch 分支 2026-10-04 12:37:19 +08:00
Qiu Yuzhou 7f1dbc6d94 refactor(ui): 系统代理暂停与不可读文案收成单一呈现常量 2026-10-04 12:37:06 +08:00
Qiu Yuzhou bcede88ea4 fix(ui): 规则过滤项启用筛选去掉「状态」措辞避免与状态列撞名 2026-10-04 12:26:07 +08:00
Qiu Yuzhou 53ebfd612a feat(ui): 参数行顺序调整与表格单元格点击聚焦 
重排（按已确认方案 B 落地——SwiftUI Table 无重排序 API，方案 A 的
onMove 前提经编译实测否定）：操作列加上移/下移按钮，PluginOptionsDraft
新增 moveRow(_:by:)。移动只换行序不改行内容：未修改行仍逐字回写原文
片段，移动不算结构修改、既有末尾分号保留；末尾快速添加行不可移动，
也不得把行移到它之后；首行不可上移、末尾正式行不可下移（按钮同步
禁用）。重排改变拼装串顺序，hasChanges 自然点亮。

修复 Table 单元格输入框不可点击：macOS SwiftUI Table 的行视图会吃掉
mouse-down，单元格 TextField 抢不到 first responder——两个输入单元
加 simultaneousGesture 单击转 FocusState 程序化聚焦（不依赖字段自身
抢到点击），值列补挂对应焦点绑定。
 2026-10-04 11:55:09 +08:00
Qiu Yuzhou 0847f9cf2c refactor(ui): 参数表格列宽改用 TableColumn.width 方法 
照评审示例补齐全部列：TableColumn 实例方法 width(min:ideal:max:)
不走初值重载决议，无排序 Table 亦可设置列宽。类型/操作列与只读
类型列定宽，参数名列限宽（编辑 72–140 / 只读 72–220），值列保持
无约束弹性吸收剩余宽度；同时移除先前经内容 frame 表达宽度的
补丁（选择器 .frame(width:)、参数名 .frame(maxWidth:)）。
 2026-10-04 11:45:18 +08:00
Qiu Yuzhou 2e24cdc752 chore: 关闭构建期字符串字面量自动抽取 
LOCALIZED_STRING_SWIFTUI_SUPPORT（Use Compiler to Extract Swift
Strings）置 NO：IDE 构建不再把 SwiftUI 字面量写进
Localizable.xcstrings。该目录按仓库惯例手工维护少量 key（中英对照），
自动抽取会在 Xcode 打开构建时膨胀文件（#81 人工验收时实测 88+ key）。
 2026-10-04 11:36:12 +08:00
Qiu Yuzhou bf86b78422 refactor(ui): 插件参数编辑区按评审意见表格化重排 
- 移除底部「添加参数」按钮（与末尾空行重复）
- 「值/开关」分段选择器移到行首；「无值开关」文案改「开关」
- 删除按钮文案改「删除」
- 编辑面与订阅只读面拆成两个独立视图，均改用 Table 控件布局；
  编辑行输入框改无边框（plain），参数名列限宽、值列弹性
- 原始文本编辑区与长值编辑 sheet 补分隔线边框
- NewServerSheet 的 isEditable 恒真，提交期禁用由外层负责，
  避免编辑视图闪换成只读视图
- 列宽不用 TableColumn width: 参数：无排序 Table 列泛型固定为
  Never，width:/value: 变体编译不过（macOS 15 SDK 实测），改经
  内容约束表达
 2026-10-04 11:33:44 +08:00