🏅 Sync 2026-10-06 17:10:26

luci-app-substore/CHANGELOG.md

@@ -2,6 +2,81 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.7.2-r6] - Loon / Surge 家族写法按官方文档对齐（LEGACY_ISSUES 7.9）
+
+`docs/LEGACY_ISSUES.md` 第七节 2.7.2 审计新发现的**第五轮**修复：(a)(b)(c)(d)
+全部实施，(e) 保持保守。改动集中在 `output_formats.surge_line`（生成端）与
+`parser_surge.parse_surge_line`（解析端）—— 两端必须成对，否则导出的配置再导入
+回来会**静默丢字段**。
+
+### 修复 — 7.9(a)：Loon 的 TLS 开关是 `over-tls`，Trojan 例外
+
+Loon 文档（`nsloon.app/docs/Node/`）通篇用 `over-tls=true`，从没把 `tls` 列为
+它的别名；本生成器此前对 Loon 也写 Surge 的 `tls=true`。若 Loon 忽略它，vmess /
+vless / trojan 会按明文连 —— 包括 Reality 节点（公钥写了、TLS 标志却没生效）。
+
+```lua
+local tls_flag = is_loon and "over-tls=true" or "tls=true"
+```
+
+**Trojan 反过来**：Loon 文档的明文与 Reality 两条示例都**没有**任何 TLS 键
+（Trojan 本身建立在 TLS 之上），所以 Loon 的 trojan 行整个不写 TLS 参数。
+Surge 家族的 `tls=true` 是文档要求的，保持不变。
+
+### 修复 — 7.9(b)：Loon 的 UDP 参数是 `udp`
+
+Loon 文档每个示例都写 `udp=true`，`udp-relay` 一次都没出现。Surge 家族仍用
+`udp-relay=true`。
+
+### 修复 — 7.9(c)：Surge 家族补上 vmess 的 `encrypt-method`
+
+Surge 手册的 vmess 页有具名参数 `encrypt-method`，取值只有 `aes-128-gcm`
+（默认）与 `chacha20-ietf-poly1305`。本生成器此前只写 `username=`，于是 cipher 是
+chacha20 的节点被 Surge 按默认的 `aes-128-gcm` 去连 —— **静默用错算法**。新增
+`SURGE_VMESS_CIPHER` 做拼写映射（模型写 `chacha20-poly1305`，客户端写
+`chacha20-ietf-poly1305`）。映射不到的取值（`zero` / `none` / `auto` /
+`aes-128-cfb`）不写该参数、节点保留。
+
+### 修复 — 7.9(d)：Loon 的 ss / ssr / hysteria2 凭据是位置参数
+
+```
+Shadowsocks,服务器,端口,加密方式,"密码"
+ShadowsocksR,服务器,端口,加密方式,"密码",protocol=…,obfs=…
+Hysteria2,服务器,端口,"密码"
+```
+
+此前一律写具名的 `encrypt-method=` / `password=` —— 落在 Loon 的语法里就是第 4、
+5 个位置参数各拿到一串 `key=value` 文本，加密方式解析不出来、密码也不再是密码，
+节点必然连不上。ssr 的 `protocol=` / `obfs=` 及其参数仍是具名。
+
+### 同步修改解析端（并修掉一个既有缺陷）
+
+`parse_surge_line` 补上位置参数提取，保住「Loon 输出 → 导入」回环。其中
+**SSR 此前根本没有取字段的分支** —— 不论哪种写法导入，加密方式、密码、协议插件、
+混淆方式全是 nil，节点带着空凭据进入统一模型，导出时再被静默丢掉。这是本轮顺带
+修掉的既有缺陷，不是 (d) 引入的。
+
+### 保持保守 — 7.9(e)
+
+值里含英文逗号时仍按「整条丢弃」处理。Loon 的引号按文档确实能保住逗号，但本行的
+具名参数一律不带引号，同一行混用两种约定会让「哪个值被包裹」变成依赖客户端实现的
+行为。已加断言钉住这个选择。
+
+### 测试
+
+* `tests/ssr_test.lua`：`loon encrypt-method` 一条改为断言位置参数写法，新增 9 条
+  Loon 输出 → 导入回环断言。
+* `tests/output_formats_test.lua`：新增 7.9 专节 24 条断言。
+* 反向验证：逐条把代码改回旧行为，确认测试变红（3 / 2 / 2 / 2 / 5 / 1 / 1 条 FAIL），
+  还原后全部 PASS。
+* 全套 **59 个测试文件、0 失败**。
+
+### 本轮新发现（未实施，记录在 LEGACY_ISSUES）
+
+(g) Loon 的节点类型清单里没有 Hysteria v1，本生成器仍会输出 `hysteria` 行；
+(h) `skip-cert-verify=1` 这个取值两家文档都没写；(i) 协议名大小写（Loon 文档用
+首字母大写，本生成器用小写）。三条都只记录、不动代码。
+
 ## [2.7.2-r5] - 后端错误串 msgid 化（LEGACY_ISSUES 7.7）
 
 `docs/LEGACY_ISSUES.md` 第七节 2.7.2 审计新发现的**第四轮**修复。

luci-app-substore/Makefile

@@ -10,7 +10,7 @@ PKG_NAME:=luci-app-substore
 # 版本约定：每次提交 PKG_RELEASE +1（2.1.2-r1 ~ r9）；
 # 达到 r10 时 PKG_VERSION 末位 +1（2.1.2 -> 2.1.3），PKG_RELEASE 重置为 1。
 PKG_VERSION:=2.7.2
-PKG_RELEASE:=20
+PKG_RELEASE:=21
 
 LUCI_DEPENDS:=+luci-lua-runtime +luci-compat
 

luci-app-substore/docs/LEGACY_ISSUES.md

@@ -658,12 +658,13 @@ crontab 里，`substore-cron.sh` 会拿着已不存在的 id 反复执行，每
 | 7.6 | 修复 | **已修复**（第一轮，见下） |
 | 7.7 | A：后端错误串 msgid 化 | **已实施**（第四轮，见下） |
 | 7.8 | A：删除 `age.lua` / `age_test.lua` | **已删除**（第一轮） |
-| 7.9 | 记录（第二轮实施时新发现） | 待决策 |
+| 7.9 | (a)(b)(c)(d) 全部实施；(e) 保持保守（含逗号整条丢弃） | **已实施**（第五轮，见下） |
 
 7.5 / 7.6 的修复见本节末尾「7.5 / 7.6 修复记录」，
 7.1 / 7.3 / 7.4 的实施见「第二轮修复记录」，
 7.2 的实施见「第三轮修复记录」，
-7.7 的实施见「第四轮修复记录」。
+7.7 的实施见「第四轮修复记录」，
+7.9 的实施见「第五轮修复记录」。
 
 | # | 问题 | 位置 | 依据 | 影响 |
 |---|---|---|---|---|
@@ -675,7 +676,7 @@ crontab 里，`substore-cron.sh` 会拿着已不存在的 id 反复执行，每
 | 7.6 | ~~Loon 的 `transport=ws` 未映射到 `net`~~ **已修复** | `parser_surge.parse_surge_line` 的 `transport=` 分支 | 只认 `ws=true`（Surge 旧写法）与 `obfs=ws`（QX）；`nsloon.app/docs/Node/` 用 `transport=ws` + `path=` + `host=` | Loon 的 ws 节点导入后 `net=tcp`，`path` / `host` 全丢 → 导出到任何格式都按 tcp 连，握手失败**且不报错** |
 | 7.7 | ~~后端模块仍有 **113 处**硬编码中文字符串字面量（注释外）~~ **已实施** | `core.lua` 47 / `http.lua` 47 / `parser.lua` 9 / `util.lua` 5 / `output_wireguard_conf.lua` 3 / `node.lua` 2 | 扫描脚本（去注释后提取含 CJK / 全角的字符串字面量），见下 | 控制器文案已接入 i18n，但这些来自后端的失败原因经 `?err=` **原样**显示，英文界面下仍是中文。**已按 A 实施**：全部改为语言中立的英文 msgid，组合消息用 `msg.lua` 的分隔符机制，翻译只在显示边界发生（详见「第四轮修复记录」） |
 | 7.8 | ~~`root/usr/share/substore/age.lua` 与 `tests/age_test.lua` 未被 git 跟踪，且 `age.lua` 未被任何模块 `require`~~ **已删除** | 仓库根 | `grep -rn require` 无引用 | 未随包发布；留在工作区会被后续审计反复重新评估 |
-| 7.9 | Loon 的节点行仍有**多处**与官方文档不一致；Surfboard 的 trojan / vmess / vless 凭据同样是位置参数；Loon 的双引号其实**能**保住逗号 | `output_formats.surge_line` | `nsloon.app/docs/Node/`；`getsurfboard.com` | 逐条见下「7.9 的明细」。均未实施（本轮只做决策里点名的 7.4-A） |
+| 7.9 | ~~Loon 的节点行仍有**多处**与官方文档不一致~~ **已实施** | `output_formats.surge_line` / `parser_surge.parse_surge_line` | `nsloon.app/docs/Node/`；`manual.nssurge.com`；`getsurfboard.com` | 逐条见下「7.9 的明细」。**已按 (a)(b)(c)(d) 全部实施、(e) 保持保守**：Loon 的 TLS 开关改 `over-tls`（Trojan 除外）、UDP 改 `udp`、Surge 家族补 `encrypt-method`、Loon 的 ss/ssr/hysteria2 改位置参数；解析端同步跟进以保住回环（详见「第五轮修复记录」）。实施中新发现三条待决策项，见下「第五轮新发现」 |
 
 ### 7.7 的统计口径与例外（修复前必读）
 
@@ -708,11 +709,13 @@ crontab 里，`substore-cron.sh` 会拿着已不存在的 id 反复执行，每
 （英文），翻译只发生在显示边界（视图 / 控制器），后端模块不得 `require("luci.i18n")`
 —— `substore-cron.sh` 会在独立的 lua 进程里跑 `core.sync`，那里没有 LuCI 环境。
 
-### 7.9 的明细（第二轮实施时新发现，**均未实施**）
+### 7.9 的明细（第二轮实施时新发现，**第五轮已实施**）
 
 第二轮为实施 7.4-A 去核对 Loon 的节点行文档（`nsloon.app/docs/Node/`），顺带发现
 Loon 与 Surge 家族的不一致远不止「凭据位置」。以下每条都对照官方文档原文，
 **没有推测项**；本轮按用户的轮次安排只做决策里点名的 7.4-A，其余记录在此待决策。
+**第五轮（2.7.2-r6）已按 (a)(b)(c)(d) 全部实施、(e) 保持保守**，各条下方的
+「→ 实施」注明落点。
 
 **(a) Loon 的 TLS 开关写作 `over-tls`，本生成器写 `tls`** —— 影响最大的一条。
 Loon 文档的通用参数表与 Reality 示例都用 `over-tls=true`：
@@ -730,9 +733,18 @@ Loon 文档**只**为传输参数明说了旧写法别名（`ws=true` ↔ `trans
 **包括本轮新支持的 Reality 节点**（公钥写了、TLS 标志却没生效）。
 这条不修，7.4-A 与 Reality 支持在真机 Loon 上的收益都要打折。
 
+**→ 实施（第五轮）**：`surge_line` 引入 `tls_flag`（`is_loon and "over-tls=true"
+or "tls=true"`），vmess / vless 用它。**Trojan 例外**：复核 Loon 文档的明文与
+Reality 两条 Trojan 示例，**都没有任何 TLS 键** —— Trojan 本身就建立在 TLS 之上，
+Loon 不再要这个开关，所以 Loon 的 Trojan 行整个不写 TLS 参数（Surge 家族的
+`tls=true` 是文档要求的，保持不变）。解析端早已同时认 `tls` 与 `over-tls`
+（`parser_surge.lua`），回环不受影响。
+
 **(b) Loon 的 UDP 参数写作 `udp`，本生成器写 `udp-relay`** —— 同上，Loon 文档是
 `udp=true`。影响较小（UDP 转发失效，节点本身还能用）。
 
+**→ 实施（第五轮）**：`udp = is_loon and "udp=true" or "udp-relay=true"`。
+
 **(c) Surge 家族的 vmess 不输出 `encrypt-method`** —— Surge 手册的 vmess 页有
 `encrypt-method` 参数，取值 `aes-128-gcm`（默认）或 `chacha20-ietf-poly1305`。
 本生成器只写 `username=`，所以 cipher 是 chacha20 的节点会被 Surge 按默认的
@@ -740,6 +752,11 @@ Loon 文档**只**为传输参数明说了旧写法别名（`ws=true` ↔ `trans
 统一模型写 `chacha20-poly1305`，Surge / Loon 都写 `chacha20-ietf-poly1305`
 （Loon 侧本轮已用 `LOON_VMESS_CIPHER` 映射，Surge 侧没有对应参数可写）。
 
+**→ 实施（第五轮）**：新增 `SURGE_VMESS_CIPHER`（`aes-128-gcm` → `aes-128-gcm`、
+`chacha20-poly1305` → `chacha20-ietf-poly1305`），在**非 Loon** 的 vmess 分支输出
+`encrypt-method=`。取值不在 Surge 清单里时（`zero` / `none` / `auto` /
+`aes-128-cfb`）不写该参数、节点保留 —— 写一个客户端读不懂的取值比不写更糟。
+
 **(d) Loon 的 shadowsocks / ssr / hysteria2 凭据也是位置参数** —— Loon 文档：
 
 ```
@@ -750,6 +767,12 @@ Loon 文档**只**为传输参数明说了旧写法别名（`ws=true` ↔ `trans
 
 本生成器对这些协议一律写具名参数（`encrypt-method=` / `password=`）。
 
+**→ 实施（第五轮）**：Loon 分支下 ss / ssr 的加密方式与密码、hysteria2 的密码
+一律改位置参数（密码走 `loon_positional` 加双引号）；ssr 的 `protocol=` / `obfs=`
+及其参数仍是具名。**解析端同步跟进**（`parser_surge.parse_surge_line`）——
+其中 **SSR 此前根本没有取字段的分支**，任何写法导入后加密方式、密码、协议插件、
+混淆方式全是 nil，是这一轮顺带修掉的既有缺陷。
+
 **(e) Loon 的双引号确实能保住逗号** —— 文档原文「参数值中含有英文逗号时，
 请使用双引号包裹」。本文件此前注释写的「Loon 的那对引号只是标记，值里的逗号
 照样是分隔符」是**错的**，已在本轮更正。当前实现仍按「含逗号就整条丢弃」处理
@@ -763,6 +786,38 @@ vmess 页：其 Format 模板写 `{username}` 位置，但**实际示例与参
 trojan 页同样写 `username=` / `password=`。所以 Surge / Surfboard / SurgeMac 的
 具名写法**是对的**，7.4 只该改 Loon —— 7.4 行已按此更正。
 
+**(e) 实施说明（第五轮）**：保持不变。生成端仍按「位置参数或具名值里含英文逗号
+就整条丢弃」处理，并在 `tests/output_formats_test.lua` 钉了一条断言防止日后被
+无意改成半截输出。
+
+### 第五轮新发现（**均未实施，待决策**）
+
+第五轮实施 (a)–(d) 时对照 `nsloon.app/docs/Node/` 全文复核，另发现三处不一致。
+每条都只陈述**文档写了什么**与**本实现写了什么**，不推测客户端的实际行为。
+
+**(g) Loon 没有 Hysteria v1，本生成器会把 `hysteria` 行输出给它** —— Loon 文档的
+节点类型清单里只有 **Hysteria2**，没有 Hysteria（v1）。而 `FAMILY_CAPS` 只按
+vless / ssr 分客户端能力，`hysteria` 不在过滤表里，所以统一模型里的 hysteria v1
+节点会生成一条 Loon 读不懂的行。修法二选一：(i) 给 `FAMILY_CAPS.loon` 加
+`hysteria = false` 整条丢弃（与丢弃 wireguard / ssr 同一约定）；(ii) 保持现状。
+**未实施** —— 需要先确认「Loon 是否真的不认 `hysteria`」以及 hysteria v1 节点在
+用户订阅里的实际占比。
+
+**(h) `skip-cert-verify` 写成 `1`，两家文档都没写这个取值** —— Loon 文档的示例
+一律写 `skip-cert-verify=false`；Surge 手册的 TLS 页只写「Optional, boolean,
+default: false」，**没有**列出可接受的字面量。本生成器一律写
+`skip-cert-verify=1`。`1` 是否被接受**无依据**。解析端两种都认（`parser_surge`
+把非 `0` / 非 `false` 都当 true），所以回环不受影响，改与不改都不会破坏导入。
+**未实施** —— 改成 `true` 会动到所有 Surge 系输出的既有断言，收益（若 `1` 本就被
+接受则为零）尚不明确。
+
+**(i) 协议名大小写：Loon 文档一律首字母大写，本生成器一律小写** —— Loon 文档写
+`Hysteria2` / `VMess` / `VLESS` / `Shadowsocks` / `AnyTLS`；本生成器输出
+`hysteria2` / `vmess` / `vless` / `shadowsocks` / `anytls`。Loon 官方定位是
+「兼容 Surge 配置」，而 Surge 手册的语法行用的是小写（`Name = vmess, <host>, …`），
+所以小写**很可能**被接受，但**没有文档明说**。**未实施** —— 这是全协议面的写法，
+改动面大且依据不足；若日后确认大小写敏感，应改的是 Loon 分支的类型名映射。
+
 ## 7.1 / 7.2 / 7.3 的实测探针
 
 **修复前**（`[2.7.2-r2]` 及更早）：
@@ -1176,6 +1231,90 @@ message"` 后跑 `tests/backend_i18n_test.lua`，得到 **1 条 FAIL**（`no po
 
 ---
 
+## 第五轮修复记录（7.9）
+
+**7.9 (a)(b)(c)(d) 按官方文档对齐 Loon / Surge 家族的写法**，(e) 保持保守。
+全部改动集中在 `root/usr/share/substore/output_formats.lua` 的 `M.surge_line`
+（生成端）与 `root/usr/share/substore/parser_surge.lua` 的 `parse_surge_line`
+（解析端）—— 两端必须成对，否则导出的配置再导入回来会静默丢字段。
+
+### (a) TLS 开关：Loon 用 `over-tls`，Trojan 例外
+
+```lua
+local is_loon  = (flavor == "loon")
+local tls_flag = is_loon and "over-tls=true" or "tls=true"
+```
+
+vmess / vless 的 `if tls then … end` 改用 `tls_flag`。**Trojan 反过来**：Loon 文档
+的明文与 Reality 两条示例都**没有**任何 TLS 键（Trojan 本身建立在 TLS 之上），
+所以 Loon 的 trojan 行整个不写 TLS 参数，Surge 家族的 `tls=true` 保持不动。
+
+### (b) UDP 开关：Loon 用 `udp`
+
+```lua
+if n.udp then e[#e + 1] = is_loon and "udp=true" or "udp-relay=true" end
+```
+
+### (c) Surge 家族补 `encrypt-method`
+
+新增 `SURGE_VMESS_CIPHER`（`aes-128-gcm` → `aes-128-gcm`、
+`chacha20-poly1305` → `chacha20-ietf-poly1305`），在**非 Loon** 的 vmess 分支写出。
+映射不到的取值（`zero` / `none` / `auto` / `aes-128-cfb`）**不写该参数**、节点保留：
+Surge 的清单只有那两个取值，写一个客户端读不懂的比不写更糟（写与不写都是
+`aes-128-gcm` 默认值，语义等价）。Loon 侧加密方式本就在位置参数上，不受影响。
+
+### (d) Loon 的 ss / ssr / hysteria2 改位置参数
+
+```
+Shadowsocks,服务器,端口,加密方式,"密码"
+ShadowsocksR,服务器,端口,加密方式,"密码",protocol=…,obfs=…
+Hysteria2,服务器,端口,"密码"
+```
+
+密码走 `loon_positional`（加双引号，值里含双引号则整条丢弃）；ssr 的
+`protocol=` / `obfs=` / `obfs-param=` / `protocol-param=` 仍是具名参数。
+
+### 解析端同步（**并修掉一个既有缺陷**）
+
+`parse_surge_line` 的字段提取补上位置参数：
+
+| 协议 | 生成端（Loon） | 解析端 |
+|---|---|---|
+| shadowsocks | `加密方式,"密码"` | `kv.* or pos[1]` / `kv.password or pos[2]` |
+| ssr | 同上 + 具名插件参数 | **新增分支**（此前 ssr 没有任何取字段的分支） |
+| hysteria2 | `"密码"` | `kv.password or pos[1]` |
+
+**SSR 此前根本没有取字段的分支** —— 不论哪种写法导入，加密方式、密码、协议插件、
+混淆方式全是 nil，节点带着空凭据进入统一模型，导出时再被静默丢掉。这是本轮顺带
+修掉的既有缺陷，不是 (d) 引入的。`obfs-param` / `protocol-param` 两种拼写都写一份
+（`PROTO_FIELDS` / `DEFAULTS` 用带连字符的规范写法，各输出模块读的是下划线别名，
+与 `parser.lua` 同时写 `method` / `cipher` 同一理由）。
+
+### 顺手更正的陈旧注释
+
+`surge_line` 里 anytls 分支上方原写着「这是本文件里唯一按 flavor 分叉的协议：
+trojan / vmess / vless 一律用具名参数」—— 7.4-A 之后就不成立了，已改写。
+
+### 测试
+
+* `tests/ssr_test.lua`：`loon encrypt-method` 一条改为断言位置参数写法，并新增
+  **9 条 Loon 输出 → 导入回环**断言。
+* `tests/output_formats_test.lua`：新增 **7.9 专节 24 条**（(a) 6 / (b) 3 / (c) 4 /
+  (d) 4 / (e) 1 / 回环 6）。
+* **反向验证**（逐条把代码改回旧行为，确认测试变红）：`tls_flag` 写死 `tls=true`
+  → 3 条 FAIL；UDP 写死 `udp-relay` → 2 条 FAIL；去掉 `encrypt-method` → 2 条 FAIL；
+  Loon 的 ss / hysteria2 改回具名 → 2 条 FAIL；解析端 ssr 分支停用 → 5 条 FAIL；
+  解析端 hysteria2 / ss 位置参数去掉 → 各 1 条 FAIL。还原后全部 PASS。
+
+全套 **59 个测试文件、0 失败**。
+
+### 本轮新发现（未实施，见上文「第五轮新发现」）
+
+(g) Loon 没有 Hysteria v1；(h) `skip-cert-verify=1` 的取值无文档依据；
+(i) 协议名大小写。三条都只记录，不动代码。
+
+---
+
 # 附：P2 修复范围（不含本文件所列项）
 
 P2 为审计表中**其余中危 / 低危**项中性质明确、无需另行决策的缺陷，例如

luci-app-substore/root/usr/share/substore/output_formats.lua

@@ -33,6 +33,25 @@ local LOON_VMESS_CIPHER = {
 	["chacha20-ietf-poly1305"] = "chacha20-ietf-poly1305",
 }
 
+-- Surge 家族的 VMess「加密方式」是**具名**参数 encrypt-method，与 Loon 把它放在
+-- 位置参数上不同（manual.nssurge.com/policies/vmess.html 原文：
+--   `Name = vmess, <host>, <port>, username=<UUID>[, parameter=value, ...]`
+--   encrypt-method 取值只有 aes-128-gcm / chacha20-ietf-poly1305，默认 aes-128-gcm；
+-- Surfboard 的 vmess 页同此）。
+--
+-- 只有模型的 chacha20-poly1305 需要写出来：它的拼写与客户端不同
+-- （chacha20-ietf-poly1305），不写这个参数 Surge 会按默认的 aes-128-gcm 去连，
+-- chacha20 的节点**静默用错算法**——握手失败或更糟。aes-128-gcm 是客户端默认值，
+-- 写与不写等价，这里仍写出来是为了让导出结果自解释。
+-- 其余取值（none / zero / auto / aes-128-cfb）不在客户端的清单里，映射不到就不写
+-- 该参数、由客户端取默认值；写一个客户端不认的取值是「写了读不懂的东西」，
+-- 与本文件丢弃 wireguard / ssr 同一约定。
+local SURGE_VMESS_CIPHER = {
+	["aes-128-gcm"] = "aes-128-gcm",
+	["chacha20-poly1305"] = "chacha20-ietf-poly1305",
+	["chacha20-ietf-poly1305"] = "chacha20-ietf-poly1305",
+}
+
 -- 支持 Reality 的目标格式。Reality 只在 Loon 的节点行里有官方文档：
 -- nsloon.app/docs/Node/ 给出 VLESS / VMess / Trojan / AnyTLS 的 Reality 示例，
 -- 统一用 public-key / short-id 两个具名参数。
@@ -91,6 +110,16 @@ function M.surge_line(n, flavor)
 	local e = {}
 	local tls = (n.security and n.security ~= "none") or (n.tls and n.tls ~= false and n.tls ~= "none")
 
+	-- TLS 开关的**参数名**各家不同：
+	--   Surge / Surfboard / SurgeMac：`tls=true`
+	--     （manual.nssurge.com/policies/vmess.html 与 .../vless.html 的 tls 参数）
+	--   Loon：`over-tls=true`
+	--     （nsloon.app/docs/Node/ 通篇用 over-tls；文档只为 ws 传输列过别名
+	--      「ws=true ↔ transport=ws」，从没把 tls 列为 over-tls 的别名）
+	-- 只换名字，不换语义：两边都是「本连接走 TLS」这一个布尔量。
+	local is_loon = (flavor == "loon")
+	local tls_flag = is_loon and "over-tls=true" or "tls=true"
+
 	-- Loon 的凭据写法：端口之后的**位置参数**且用双引号包起来
 	--   Trojan = Trojan,h,p,"密码"
 	--   VLESS  = VLESS,h,p,"UUID"
@@ -140,8 +169,22 @@ function M.surge_line(n, flavor)
 	end
 
 	if proto == "shadowsocks" then
-		e[#e + 1] = "encrypt-method=" .. (n.method or n.cipher or "aes-256-gcm")
-		e[#e + 1] = "password=" .. (n.password or "")
+		local cipher = n.method or n.cipher or "aes-256-gcm"
+		if is_loon then
+			-- Loon 的 Shadowsocks 把加密方式与密码都画在位置参数上，密码带双引号：
+			--   `Shadowsocks,服务器,端口,加密方式,"密码"`（nsloon.app/docs/Node/）
+			-- 加密方式是裸值，与 VMess 行的加密方式同形。
+			-- 此前写成具名的 encrypt-method= / password=，落在 Loon 的语法里就是
+			-- 第 4、5 个位置参数各拿到一串 `key=value` 文本 —— 加密方式解析不出来，
+			-- 密码也不再是密码，节点必然连不上。
+			local pw = loon_positional(n.password)
+			if not pw then return nil end
+			positional[#positional + 1] = cipher
+			positional[#positional + 1] = pw
+		else
+			e[#e + 1] = "encrypt-method=" .. cipher
+			e[#e + 1] = "password=" .. (n.password or "")
+		end
 	elseif proto == "vmess" then
 		if flavor == "loon" then
 			-- Loon 的 VMess 把加密方式与 UUID 都放在位置参数上（见 loon_positional）
@@ -152,8 +195,11 @@ function M.surge_line(n, flavor)
 			positional[#positional + 1] = id
 		else
 			e[#e + 1] = "username=" .. (n.uuid or "")
+			-- Surge 家族把加密方式写在具名参数 encrypt-method 上（见 SURGE_VMESS_CIPHER）
+			local sc = SURGE_VMESS_CIPHER[n.cipher]
+			if sc then e[#e + 1] = "encrypt-method=" .. sc end
 		end
-		if tls then e[#e + 1] = "tls=true" end
+		if tls then e[#e + 1] = tls_flag end
 		if n.sni then e[#e + 1] = "sni=" .. n.sni end
 		-- VMess 的 Reality 与 VLESS 同形。Loon 文档的 VMess-Reality 示例：
 		-- `VMess = VMess,host,443,aes-128-gcm,"uuid",transport=tcp,alterId=0,`
@@ -172,7 +218,7 @@ function M.surge_line(n, flavor)
 		else
 			e[#e + 1] = "username=" .. (n.uuid or "")
 		end
-		if tls then e[#e + 1] = "tls=true" end
+		if tls then e[#e + 1] = tls_flag end
 		if n.sni then e[#e + 1] = "sni=" .. n.sni end
 		if n.flow then e[#e + 1] = "flow=" .. n.flow end
 		add_reality()
@@ -186,7 +232,11 @@ function M.surge_line(n, flavor)
 		else
 			e[#e + 1] = "password=" .. (n.password or "")
 		end
-		e[#e + 1] = "tls=true"
+		-- Loon 的 Trojan 行**没有** TLS 开关：nsloon.app/docs/Node/ 的明文与 Reality
+		-- 两条示例都只写 `Trojan,服务器,端口,"密码",sni=…[,public-key=…,short-id=…]`，
+		-- 既没有 over-tls 也没有 tls。Trojan 本身就建立在 TLS 之上，Loon 不再要这个
+		-- 开关；写上去是客户端读不懂的参数。Surge 家族的 tls=true 相反是文档要求的。
+		if not is_loon then e[#e + 1] = "tls=true" end
 		if n.sni then e[#e + 1] = "sni=" .. n.sni end
 		add_reality()
 	elseif proto == "anytls" then
@@ -205,9 +255,12 @@ function M.surge_line(n, flavor)
 		-- 其余 flavor（surge / surgemac）走上面的具名写法。
 		-- （Egern 已不在本文件里 —— 它的配置是 YAML，见 output_egern.lua。）
 		--
-		-- 这是本文件里唯一按 flavor 分叉的协议：trojan / vmess / vless 一律用具名
-		-- 参数，而 Loon / Surfboard 的文档同样把它们的凭据画在位置参数上 —— 那是
-		-- 既有实现，改动面大且不在本次范围内，所以只让 anytls 按文档写对。
+		-- 按 flavor 分叉的协议不止 anytls：Loon 的 vmess / vless / trojan /
+		-- shadowsocks / ssr / hysteria2 同样把凭据画在位置参数上，TLS 开关与 UDP
+		-- 参数的名字也和 Surge 家族不同 —— 那些分叉在各分支里就地处理（见
+		-- is_loon / tls_flag 与 loon_positional 上方的说明）。anytls 的特别之处
+		-- 只在于它的密码写法在**三家之间**都不同（Surge 具名 / Surfboard 裸位置
+		-- 参数 / Loon 带引号位置参数），所以只有它在这里写成了三分支。
 		if flavor == "surfboard" then
 			positional[#positional + 1] = n.password or ""
 		elseif flavor == "loon" then
@@ -220,8 +273,21 @@ function M.surge_line(n, flavor)
 		if n.sni then e[#e + 1] = "sni=" .. n.sni end
 		add_reality()
 	elseif proto == "ssr" then
-		e[#e + 1] = "encrypt-method=" .. (n.method or n.cipher or "aes-128-cfb")
-		e[#e + 1] = "password=" .. (n.password or "")
+		local cipher = n.method or n.cipher or "aes-128-cfb"
+		if is_loon then
+			-- Loon 的 ShadowsocksR 同样把加密方式与密码放在位置参数上（密码带引号），
+			-- 其余仍是具名参数：
+			--   `ShadowsocksR,服务器,端口,加密方式,"密码",protocol=…,obfs=…`
+			-- （nsloon.app/docs/Node/）。具名的 encrypt-method= / password= 在这里
+			-- 会各自占掉一个位置参数，加密方式与密码都解析不出来。
+			local pw = loon_positional(n.password)
+			if not pw then return nil end
+			positional[#positional + 1] = cipher
+			positional[#positional + 1] = pw
+		else
+			e[#e + 1] = "encrypt-method=" .. cipher
+			e[#e + 1] = "password=" .. (n.password or "")
+		end
 		e[#e + 1] = "protocol=" .. (n.protocol or "origin")
 		e[#e + 1] = "obfs=" .. (n.obfs or "plain")
 		local op = n.obfs_param or n["obfs-param"]
@@ -229,7 +295,15 @@ function M.surge_line(n, flavor)
 		if op and op ~= "" then e[#e + 1] = "obfs-param=" .. op end
 		if pp and pp ~= "" then e[#e + 1] = "protocol-param=" .. pp end
 	elseif proto == "hysteria2" or proto == "hysteria" then
-		e[#e + 1] = "password=" .. (n.password or "")
+		if is_loon then
+			-- Loon 的 Hysteria2 把密码放在位置参数上，带双引号：
+			--   `Hysteria2,服务器,端口,"密码",sni=…`（nsloon.app/docs/Node/）
+			local pw = loon_positional(n.password)
+			if not pw then return nil end
+			positional[#positional + 1] = pw
+		else
+			e[#e + 1] = "password=" .. (n.password or "")
+		end
 		if n.sni then e[#e + 1] = "sni=" .. n.sni end
 	elseif proto == "tuic" then
 		e[#e + 1] = "username=" .. (n.uuid or "")
@@ -266,7 +340,10 @@ function M.surge_line(n, flavor)
 	end
 
 	if n["skip-cert-verify"] then e[#e + 1] = "skip-cert-verify=1" end
-	if n.udp then e[#e + 1] = "udp-relay=true" end
+	-- UDP 转发的参数名同样各家不同：Surge 家族是 udp-relay=true，Loon 是 udp=true
+	-- （nsloon.app/docs/Node/ 的每个示例都写 udp=true，udp-relay 一次都没出现；
+	-- 相关的另外两个开关叫 udp-over-tcp / udp-port）。
+	if n.udp then e[#e + 1] = is_loon and "udp=true" or "udp-relay=true" end
 
 	-- 参数值里的逗号无法用这些格式表达，整条丢弃（返回 nil，由调用方剔除）。
 	-- [Proxy] 行与 QX 的 [server_local] 行都是逗号分隔的 `key=value` 序列，

luci-app-substore/root/usr/share/substore/parser_surge.lua

@@ -106,9 +106,38 @@ local function parse_surge_line(name, rest)
 	local data = {
 		proto = proto, name = util.trim(name), server = server, port = port,
 	}
+	-- 凭据在两种写法里的落点，与 output_formats.surge_line 的分叉一一对应：
+	--   shadowsocks : Surge 家族 `encrypt-method=…,password=…`；Loon `加密方式,"密码"`
+	--   ssr         : 同上，另有 protocol= / obfs= / obfs-param= / protocol-param=
+	--   vmess       : Surge 家族 `username=…`；Loon `加密方式,"UUID"`
+	--   vless       : Surge 家族 `username=…`；Loon `"UUID"`
+	--   trojan      : Surge 家族 `password=…`；Loon `"密码"`
+	--   hysteria2   : Surge 家族 `password=…`；Loon `"密码"`
+	--   anytls      : Surge 家族 `password=…`；Surfboard 裸位置参数；Loon `"密码"`
+	-- 位置参数（pos）只收集「不含 = 的字段」，具名写法完全不受影响，所以两种写法
+	-- 可以无条件并存 —— 本函数导入的既有 Surge / Loon 配置不会因此改变解析结果。
 	if proto == "shadowsocks" then
-		data.method = kv["encrypt-method"] or kv.cipher or kv.method
-		data.password = kv.password
+		data.method = kv["encrypt-method"] or kv.cipher or kv.method or pos[1]
+		data.password = kv.password or pos[2]
+	elseif proto == "ssr" then
+		-- SSR 此前**没有**取字段的分支：不管哪种写法导入，加密方式、密码、协议插件、
+		-- 混淆方式全是 nil，节点带着空凭据进入统一模型，导出时再被静默丢掉。
+		data.method = kv["encrypt-method"] or kv.cipher or kv.method or pos[1]
+		data.password = kv.password or pos[2]
+		if kv.protocol then data.protocol = kv.protocol end
+		if kv.obfs then data.obfs = kv.obfs end
+		-- 两种拼写都写一份：PROTO_FIELDS / DEFAULTS 用的是带连字符的规范写法
+		-- （表单据此渲染），而 parser.lua 与各输出模块读的是下划线别名
+		-- （`n.obfs_param or n["obfs-param"]`）—— 与 parser.lua 同时写
+		-- method / cipher 是同一个理由，只写一份就会在某条输出路径上丢失。
+		if kv["obfs-param"] then
+			data["obfs-param"] = kv["obfs-param"]
+			data.obfs_param = kv["obfs-param"]
+		end
+		if kv["protocol-param"] then
+			data["protocol-param"] = kv["protocol-param"]
+			data.protocol_param = kv["protocol-param"]
+		end
 	elseif proto == "vmess" or proto == "vless" then
 		-- Loon 的 VMess 位置参数是「加密方式, UUID」两个字段；VLESS 只有一个 UUID
 		if proto == "vmess" and pos[2] then
@@ -123,7 +152,8 @@ local function parse_surge_line(name, rest)
 	elseif proto == "anytls" then
 		data.password = kv.password or pos[1]
 	elseif proto == "hysteria2" or proto == "hysteria" then
-		data.password = kv.password
+		-- Loon 的 Hysteria2 把密码写在端口之后的位置参数上（`Hysteria2,h,p,"密码"`）
+		data.password = kv.password or pos[1]
 	end
 
 	-- Reality 参数。Loon 的 VLESS / VMess / Trojan / AnyTLS Reality 行共用

luci-app-substore/tests/output_formats_test.lua

@@ -153,5 +153,114 @@ local qx_ok = fmts.to_qx({ { proto = "trojan", name = "XY", server = "1.1.1.1",
 check("qx newline name does not add lines", count_lines(qx_nl) == count_lines(qx_ok))
 check("qx newline name flattened", qx_nl:find("X Y", 1, true) ~= nil)
 
+-- ---------- 7.9：Loon 与 Surge 家族的参数名 / 写法分叉 ----------
+-- 依据：nsloon.app/docs/Node/（Loon 节点行）与 manual.nssurge.com/policies/*.html
+-- （Surge 家族）。两家语法在四处不同：TLS 开关名、UDP 开关名、VMess 加密方式的
+-- 落点、以及凭据是否写成端口之后的位置参数。写错任何一处都不会报错，只是节点
+-- 连不上 —— 所以每处分叉都钉一条断言。
+
+-- (a) TLS 开关名：Surge 家族 tls=true，Loon over-tls=true
+local vm_tls = { proto = "vmess", name = "V", server = "1.1.1.1", port = 443,
+	uuid = "u", security = "tls" }
+check("surge vmess tls=true", fmts.surge_line(vm_tls, "surge"):find("tls=true", 1, true) ~= nil)
+check("loon vmess over-tls=true", fmts.surge_line(vm_tls, "loon"):find("over-tls=true", 1, true) ~= nil)
+-- 具名参数之间是 ", " 分隔，所以独立的 tls 参数会以 ", tls=true" 出现；
+-- 直接找 "tls=true" 会命中 "over-tls=true" 的子串，必须带上前导分隔符。
+check("loon vmess no bare tls=true",
+	fmts.surge_line(vm_tls, "loon"):find(", tls=true", 1, true) == nil)
+
+local vl_tls = { proto = "vless", name = "L", server = "1.1.1.1", port = 443,
+	uuid = "u", security = "tls" }
+check("surge vless tls=true", fmts.surge_line(vl_tls, "surge"):find("tls=true", 1, true) ~= nil)
+check("loon vless over-tls=true", fmts.surge_line(vl_tls, "loon"):find("over-tls=true", 1, true) ~= nil)
+
+-- Trojan 是例外：Loon 文档的 Trojan 示例（明文与 Reality 两条）里根本没有 TLS 键
+-- —— Trojan 本身就建立在 TLS 之上，Loon 不再要这个开关。Surge 家族的 tls=true
+-- 则是文档要求的，不能跟着一起删。
+local tj_node = { proto = "trojan", name = "T", server = "1.1.1.1", port = 443, password = "p" }
+check("surge trojan tls=true", fmts.surge_line(tj_node, "surge"):find("tls=true", 1, true) ~= nil)
+local loon_tj = fmts.surge_line(tj_node, "loon")
+check("loon trojan has no tls key", loon_tj:find("tls", 1, true) == nil)
+check("loon trojan positional password", loon_tj:find('trojan, 1.1.1.1, 443, "p"', 1, true) ~= nil)
+
+-- (b) UDP 开关名：Surge 家族 udp-relay=true，Loon udp=true
+local udp_node = { proto = "trojan", name = "U", server = "1.1.1.1", port = 443,
+	password = "p", udp = true }
+check("surge udp-relay=true", fmts.surge_line(udp_node, "surge"):find("udp-relay=true", 1, true) ~= nil)
+local loon_udp = fmts.surge_line(udp_node, "loon")
+check("loon udp=true", loon_udp:find("udp=true", 1, true) ~= nil)
+check("loon has no udp-relay", loon_udp:find("udp-relay", 1, true) == nil)
+
+-- (c) Surge 家族的 VMess 加密方式写在具名参数 encrypt-method 上，取值只有
+-- aes-128-gcm / chacha20-ietf-poly1305（默认前者）。模型的 chacha20-poly1305
+-- 与客户端拼写不同，不写出来 Surge 会按默认的 aes-128-gcm 去连 —— 静默用错算法。
+local vm_chacha = { proto = "vmess", name = "C", server = "1.1.1.1", port = 443,
+	uuid = "u", cipher = "chacha20-poly1305" }
+check("surge vmess chacha mapped",
+	fmts.surge_line(vm_chacha, "surge"):find("encrypt-method=chacha20-ietf-poly1305", 1, true) ~= nil)
+local vm_gcm = { proto = "vmess", name = "C", server = "1.1.1.1", port = 443,
+	uuid = "u", cipher = "aes-128-gcm" }
+check("surge vmess aes-128-gcm",
+	fmts.surge_line(vm_gcm, "surge"):find("encrypt-method=aes-128-gcm", 1, true) ~= nil)
+-- 不在客户端清单里的取值（zero / none / auto / aes-128-cfb）不写该参数、节点保留：
+-- 写一个客户端读不懂的取值比不写更糟
+local vm_zero = { proto = "vmess", name = "C", server = "1.1.1.1", port = 443,
+	uuid = "u", cipher = "zero" }
+local zero_line = fmts.surge_line(vm_zero, "surge")
+check("surge vmess unmapped cipher omitted",
+	zero_line ~= nil and zero_line:find("encrypt-method", 1, true) == nil)
+-- Loon 把加密方式放在位置参数上，不该出现具名的 encrypt-method
+check("loon vmess no named encrypt-method",
+	fmts.surge_line(vm_chacha, "loon"):find("encrypt-method", 1, true) == nil)
+
+-- (d) Loon 的 shadowsocks / hysteria2 凭据同样是位置参数（密码带双引号）
+local ss_node = { proto = "shadowsocks", name = "S", server = "1.1.1.1", port = 8388,
+	method = "aes-256-gcm", password = "pw" }
+check("surge ss named", fmts.surge_line(ss_node, "surge"):find("encrypt-method=aes-256-gcm", 1, true) ~= nil)
+check("loon ss positional",
+	fmts.surge_line(ss_node, "loon"):find('shadowsocks, 1.1.1.1, 8388, aes-256-gcm, "pw"', 1, true) ~= nil)
+
+local hy_node = { proto = "hysteria2", name = "H", server = "1.1.1.1", port = 443, password = "pw" }
+check("surge hysteria2 named", fmts.surge_line(hy_node, "surge"):find("password=pw", 1, true) ~= nil)
+check("loon hysteria2 positional",
+	fmts.surge_line(hy_node, "loon"):find('hysteria2, 1.1.1.1, 443, "pw"', 1, true) ~= nil)
+
+-- (e) 值里含英文逗号：Loon 的引号按文档确实能保住逗号，本实现仍按「整条丢弃」
+-- 处理（具名参数不带引号，同一行混用两种约定会让「哪个值被包裹」变成依赖客户端
+-- 实现的行为）。这里钉住这个保守选择，避免日后被无意改成半截输出。
+local ss_comma = { proto = "shadowsocks", name = "S", server = "1.1.1.1", port = 8388,
+	method = "aes-256-gcm", password = "pa,ss" }
+check("loon comma password drops node", fmts.surge_line(ss_comma, "loon") == nil)
+
+-- ---------- Loon 输出 → 导入回环 ----------
+-- 生成端与解析端必须成对改动：只改生成端的话，导出的 Loon 配置再导入回来会静默
+-- 丢掉凭据（parser_surge 此前对 ssr 根本没有取字段的分支，对 shadowsocks /
+-- hysteria2 也不认位置参数）。
+local psurge = require("substore.parser_surge")
+local function loon_roundtrip(node)
+	return psurge.parse(fmts.to_loon({ node }, { name = "P" }))[1]
+end
+
+local rt_ss = loon_roundtrip(ss_node)
+check("loon rt ss method", rt_ss and rt_ss.method == "aes-256-gcm")
+check("loon rt ss password", rt_ss and rt_ss.password == "pw")
+
+local rt_hy = loon_roundtrip(hy_node)
+check("loon rt hysteria2 password", rt_hy and rt_hy.password == "pw")
+check("loon rt hysteria2 security", rt_hy and rt_hy.security == "tls")
+
+local rt_vm = loon_roundtrip(vm_tls)
+check("loon rt vmess uuid", rt_vm and rt_vm.uuid == "u")
+check("loon rt vmess security", rt_vm and rt_vm.security == "tls")
+
+local rt_vl = loon_roundtrip(vl_tls)
+check("loon rt vless uuid", rt_vl and rt_vl.uuid == "u")
+check("loon rt vless security", rt_vl and rt_vl.security == "tls")
+
+-- Trojan：Loon 行里不再有 TLS 开关，security 由 node.normalize 的 TLS_ONLY 补回
+local rt_tj = loon_roundtrip(tj_node)
+check("loon rt trojan password", rt_tj and rt_tj.password == "p")
+check("loon rt trojan security", rt_tj and rt_tj.security == "tls")
+
 print(string.format("\n%d passed, %d failed", passed, failed))
 os.exit(failed == 0 and 0 or 1)

luci-app-substore/tests/ssr_test.lua

@@ -75,8 +75,28 @@ check("shadowrocket has ssr", shr and util.base64_decode(shr):find("ssr://") ~=
 -- ---------- Loon 保留 SSR，Surge 丢弃 ----------
 local loon = output.generate({ n }, "loon")
 check("loon has ssr", loon and loon:find("ssr, 127%.0%.0%.1, 8388") ~= nil)
-check("loon encrypt-method", loon and loon:find("encrypt%-method=aes%-128%-cfb") ~= nil)
+-- Loon 把加密方式与密码写成端口之后的**位置参数**（密码带双引号），不是具名参数：
+--   `ShadowsocksR,服务器,端口,加密方式,"密码",protocol=…,obfs=…`（nsloon.app/docs/Node/）
+-- 具名的 encrypt-method= / password= 在 Loon 的语法里会各自占掉一个位置参数，
+-- 加密方式与密码都解析不出来。
+check("loon cipher positional", loon and loon:find('ssr, 127%.0%.0%.1, 8388, aes%-128%-cfb, "test%-password"') ~= nil)
+check("loon no named encrypt-method", loon and loon:find("encrypt%-method=") == nil)
 check("loon protocol", loon and loon:find("protocol=auth_aes128_md5") ~= nil)
+
+-- ---------- Loon 输出 → 导入回环（位置参数写法） ----------
+-- 生成端与解析端必须成对：只改生成端的话，导出的 Loon 配置再导入回来会丢掉
+-- 加密方式与密码（parser_surge 此前对 ssr 根本没有取字段的分支）。
+local loon_parsed = require("substore.parser_surge").parse(loon)
+check("loon roundtrip count", #loon_parsed == 1)
+local lr = loon_parsed[1]
+check("loon roundtrip proto", lr and lr.proto == "ssr")
+check("loon roundtrip method", lr and lr.method == "aes-128-cfb")
+check("loon roundtrip password", lr and lr.password == "test-password")
+check("loon roundtrip protocol", lr and lr.protocol == "auth_aes128_md5")
+check("loon roundtrip obfs", lr and lr.obfs == "http_simple")
+check("loon roundtrip obfs_param", lr and (lr.obfs_param == "download.windowsupdate.com"
+	or lr["obfs-param"] == "download.windowsupdate.com"))
+check("loon roundtrip name", lr and lr.name == "测试节点")
 local surge = output.generate({ n }, "surge")
 check("surge drops ssr", surge and surge:find("127%.0%.0%.1") == nil)