From 948a5db277f43fbb60111c1265a50c425ebbd147 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8B=97=E5=B8=A6=E5=B8=A6=E5=AD=90?=
 <19979176+isdoge@users.noreply.github.com>
Date: Wed, 19 Aug 2026 00:27:19 +0800
Subject: [PATCH] =?UTF-8?q?fix(country-rule):=20=E5=9B=BD=E5=AE=B6?=
 =?UTF-8?q?=E8=A7=84=E5=88=99=E6=AD=A3=E5=88=99=E5=BC=95=E6=93=8E=E4=BB=8E?=
 =?UTF-8?q?=20RE2=20=E5=88=87=E6=8D=A2=E4=B8=BA=20PCRE=EF=BC=8C=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81=E9=9B=B6=E5=AE=BD=E6=96=AD=E8=A8=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

国家规则的匹配模式字段使用 Go 标准库 regexp（RE2 引擎），不支持零宽断言
（lookahead/lookbehind），导致 mihomo 用户常用的边界匹配写法编译失败：

    (?<![A-Za-z])HK(?![A-Za-z])
    → error parsing regexp: invalid named capture: (?<...

这迫使用户使用裸子模式（如 (?i)香港|HK|Hong Kong），无法表达「两侧非字母边界」
语义，导致 SHK Premium、HKG（广岛 IATA 代码）等节点名误匹配 HK 规则。

改动：
- models/country_rule.go: import 从标准库 regexp 改为
  github.com/dlclark/regexp2/v2/compat（PCRE 引擎的标准库兼容适配器）
- 所有调用点零改动：compat 子包的 Compile 返回 (*Regexp, error)、
  MatchString 返回 bool，签名与标准库完全一致
- 不新增 module：mihomo 已传递依赖 dlclark/regexp2/v2 v2.2.1（go.mod indirect）

兼容性：
- 所有现有合法 pattern 行为不变（含 (?i) 内联标志、\s*、emoji、分组、量词）
- fix 只放开引擎能力，不自动改写用户已有规则；用户如想解决 SHK Premium/HKG
  误匹配，需手动把 HK 规则 pattern 改为 (?<![A-Za-z])HK(?![A-Za-z])|香港|... 形式

测试（models/models_regexp2_test.go 新增）：
- TestRegexp2Lookbehind: 7 个零宽断言用例，覆盖 issue #270 的 SHK Premium 场景
- TestRegexp2InlineFlags: 4 个老格式兼容性用例
- 现有 TestCountryRulePatternMatching 的 16 条 RE2 pattern 全部仍 PASS

实测验证：
- go test ./models/... 全部 PASS（golang:1.26.4 容器）
- 部署到生产实例实测 API /country-rules/test：
  (?<![A-Za-z])HK(?![A-Za-z]) 对 HK→true、SHK Premium→false、HKG→false
- Web UI 编辑规则对话框零宽断言 pattern 实测通过
- batch-test 51 条启用规则 × 14 个节点名解析正确，无回归

Closes #270
---
 models/country_rule.go        |  6 ++-
 models/models_regexp2_test.go | 78 +++++++++++++++++++++++++++++++++++
 2 files changed, 83 insertions(+), 1 deletion(-)
 create mode 100644 models/models_regexp2_test.go

diff --git a/models/country_rule.go b/models/country_rule.go
index 4b7d155ac..7428af491 100644
--- a/models/country_rule.go
+++ b/models/country_rule.go
@@ -3,7 +3,6 @@ package models
 import (
 	"bufio"
 	"fmt"
-	"regexp"
 	"sort"
 	"strconv"
 	"strings"
@@ -13,6 +12,11 @@ import (
 	"sync"
 	"time"
 
+	// 使用 dlclark/regexp2 PCRE 引擎的 compat 适配器，API 与 Go 标准库 regexp 一致
+	// 替代 RE2 语法，以支持零宽断言等高级特性
+	// 如 (?<![A-Za-z])HK(?![A-Za-z]) 等在 mihomo 中可用的正则
+	// compat.Compile 不传 options 时，pattern 内联标志（如 (?i)）正常生效
+	regexp "github.com/dlclark/regexp2/v2/compat"
 	"gorm.io/gorm"
 )
 
diff --git a/models/models_regexp2_test.go b/models/models_regexp2_test.go
new file mode 100644
index 000000000..f58a78a76
--- /dev/null
+++ b/models/models_regexp2_test.go
@@ -0,0 +1,78 @@
+package models
+
+import (
+	"testing"
+
+	regexp "github.com/dlclark/regexp2/v2/compat"
+)
+
+// TestRegexp2Lookbehind 验证 fix 分支引入的 regexp2/compat (PCRE) 引擎行为。
+// 对照 sublinkpro 生产 v1.2.18 (标准库 regexp / RE2)：
+//   - (?<![A-Za-z])HK(?![A-Za-z]) 在 RE2 编译失败：invalid named capture
+//   - (?i)香港|HK|Hong Kong 对 "SHK Premium" 误匹配（裸 HK 子模式）
+//
+// 该测试需要 fix 分支的 models/country_rule.go 已把引擎换为 compat。
+func TestRegexp2Lookbehind(t *testing.T) {
+	const pattern = `(?<![A-Za-z])HK(?![A-Za-z])`
+
+	re, err := regexp.Compile(pattern)
+	if err != nil {
+		t.Fatalf("compile %q: %v (RE2 会失败，compat 应成功)", pattern, err)
+	}
+
+	cases := []struct {
+		name   string
+		expect bool
+		why    string
+	}{
+		{"HK", true, "纯 HK — 应匹配"},
+		{"HK01", true, "右侧数字不算字母 — 应匹配"},
+		{"HK Premium 01", true, "中间位置两侧非字母 — 应匹配"},
+		{"SHK Premium", false, "左侧 S 是字母 — 不应匹配（issue #270 误匹配场景）"},
+		{"HKG", false, "右侧 G 是字母 — 不应匹配"},
+		{"The HK node", true, "空格两侧非字母 — 应匹配"},
+		{"香港 01", false, "不含 HK — 不应匹配"},
+	}
+	for _, c := range cases {
+		matched := re.MatchString(c.name)
+		if matched != c.expect {
+			t.Errorf("pattern=%q name=%q: got %v want %v (%s)", pattern, c.name, matched, c.expect, c.why)
+		}
+	}
+}
+
+// TestRegexp2InlineFlags 兼容性：旧 (?i) 内联标志与旧裸子模式 format 必须仍可用。
+// 同时确认旧 bug 行为仍存在（这才是需要零宽断言的原因）：(?i)香港|HK|Hong Kong 仍会
+// 误匹配 "SHK Premium"，因为 HK 是裸子模式。
+func TestRegexp2InlineFlags(t *testing.T) {
+	oldPatterns := []struct {
+		pattern      string
+		mSHK         bool
+		mHongKongSrv bool
+		mHKNode      bool
+	}{
+		{`(?i)香港|HK|Hong Kong`, true, true, true},
+		{`(?i)(香港|HK|Hong\s*Kong)`, true, true, true},
+		{`(?i)(美国|USA?|United\s*States)`, false, false, false},
+		{`香港|HK|Hong Kong|🇭🇰`, true, true, true},
+	}
+	for _, p := range oldPatterns {
+		re, err := regexp.Compile(p.pattern)
+		if err != nil {
+			t.Errorf("compile %q: %v (旧格式必须仍能编译)", p.pattern, err)
+			continue
+		}
+		mSHK := re.MatchString("SHK Premium")
+		mHK := re.MatchString("Hong Kong Server")
+		mNode := re.MatchString("HK-001")
+		if mSHK != p.mSHK {
+			t.Errorf("pattern=%q vs SHK Premium: got %v want %v", p.pattern, mSHK, p.mSHK)
+		}
+		if mHK != p.mHongKongSrv {
+			t.Errorf("pattern=%q vs Hong Kong Server: got %v want %v", p.pattern, mHK, p.mHongKongSrv)
+		}
+		if mNode != p.mHKNode {
+			t.Errorf("pattern=%q vs HK-001: got %v want %v", p.pattern, mNode, p.mHKNode)
+		}
+	}
+}