refactor(edge): 抽取边缘运行时共享包并完成 Phase 3 重构

- 新增 internal/apps/edge/，三组件改为薄包装，删除 3000+ 行重复代码
- Agent 心跳周期下沉至 heartbeat/cycle.go
- 协议类型迁入 pkg/protocol/agent.go
- 补充设计文档与 changelog

internal/apps/agent/config/config.go

@@ -1,11 +1,9 @@
 package config
 
 import (
-	"context"
 	"encoding/json"
 	"errors"
 	"fmt"
-	"net"
 	"os"
 	pathpkg "path"
 	"path/filepath"
@@ -13,8 +11,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/Rain-kl/Wavelet/pkg/geoip"
-	"github.com/Rain-kl/Wavelet/pkg/geoip/iputil"
+	"github.com/Rain-kl/Wavelet/internal/apps/edge/nodeip"
 	"github.com/Rain-kl/Wavelet/pkg/utils"
 )
 
@@ -35,11 +32,6 @@ const (
 	defaultMMDBDownloadURL                 = "https://raw.githubusercontent.com/Loyalsoldier/geoip/release/GeoLite2-Country.mmdb"
 )
 
-var (
-	lookupOutboundIP = geoip.GetOutboundIP
-	lookupLocalIP    = detectLocalNodeIP
-)
-
 type Config struct {
 	ServerURL                  string              `json:"server_url"`
 	AccessToken                string              `json:"agent_token"`
@@ -166,7 +158,7 @@ func applyDefaults(cfg *Config, baseDir string) {
 		cfg.NodeName = detectHostname()
 	}
 	if cfg.NodeIP == "" {
-		cfg.NodeIP = detectNodeIP()
+		cfg.NodeIP = nodeip.Detect()
 	}
 	if cfg.MainConfigPath == "" {
 		cfg.MainConfigPath = joinManagedPath(cfg.DataDir, defaultMainConfigRelativePath)
@@ -400,64 +392,4 @@ func detectHostname() string {
 	return strings.TrimSpace(host)
 }
 
-func detectNodeIP() string {
-	if ip := detectOutboundNodeIP(); ip != "" {
-		return ip
-	}
-	return lookupLocalIP()
-}
 
-func detectOutboundNodeIP() string {
-	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
-	defer cancel()
-	ip, err := lookupOutboundIP(ctx)
-	if err != nil || ip == nil {
-		return ""
-	}
-	return ip.String()
-}
-
-func detectLocalNodeIP() string {
-	interfaces, err := net.Interfaces()
-	if err != nil {
-		return ""
-	}
-	bestIP := ""
-	bestPriority := -1
-	for _, iface := range interfaces {
-		if iface.Flags&net.FlagUp == 0 || iface.Flags&net.FlagLoopback != 0 {
-			continue
-		}
-		addrs, err := iface.Addrs()
-		if err != nil {
-			continue
-		}
-		for _, addr := range addrs {
-			ipNet, ok := addr.(*net.IPNet)
-			if !ok || ipNet.IP == nil || ipNet.IP.IsLoopback() {
-				continue
-			}
-			ipv4 := normalizeIPv4(ipNet.IP)
-			priority := nodeIPPriority(ipv4)
-			if priority > bestPriority {
-				bestIP = ipv4.String()
-				bestPriority = priority
-			}
-			if bestPriority == 2 {
-				return bestIP
-			}
-		}
-	}
-	return bestIP
-}
-
-func normalizeIPv4(ip net.IP) net.IP {
-	if ip == nil {
-		return nil
-	}
-	return ip.To4()
-}
-
-func nodeIPPriority(ip net.IP) int {
-	return iputil.Score(ip)
-}

internal/apps/agent/config/config_test.go

@@ -10,7 +10,9 @@ import (
 	"testing"
 	"time"
 
+	"github.com/Rain-kl/Wavelet/internal/apps/edge/nodeip"
 	"github.com/Rain-kl/Wavelet/pkg/geoip"
+	"github.com/Rain-kl/Wavelet/pkg/geoip/iputil"
 )
 
 func TestLoadDefaultsToManagedBinaryPaths(t *testing.T) {
@@ -248,12 +250,12 @@ func TestLoadUsesEnvConfigWhenFileIsMissing(t *testing.T) {
 }
 
 func TestLoadDetectsOutboundIPWhenNodeIPMissing(t *testing.T) {
-	previousLookup := lookupOutboundIP
-	lookupOutboundIP = func(ctx context.Context, strategies ...geoip.OutboundIPStrategy) (net.IP, error) {
+	previousLookup := nodeip.LookupOutboundIP
+	nodeip.LookupOutboundIP = func(ctx context.Context, strategies ...geoip.OutboundIPStrategy) (net.IP, error) {
 		return net.ParseIP("8.8.8.8"), nil
 	}
 	defer func() {
-		lookupOutboundIP = previousLookup
+		nodeip.LookupOutboundIP = previousLookup
 	}()
 
 	dir := t.TempDir()
@@ -281,17 +283,17 @@ func TestLoadDetectsOutboundIPWhenNodeIPMissing(t *testing.T) {
 }
 
 func TestLoadFallsBackToLocalIPWhenOutboundLookupFails(t *testing.T) {
-	previousOutboundLookup := lookupOutboundIP
-	previousLocalLookup := lookupLocalIP
-	lookupOutboundIP = func(ctx context.Context, strategies ...geoip.OutboundIPStrategy) (net.IP, error) {
+	previousOutboundLookup := nodeip.LookupOutboundIP
+	previousLocalLookup := nodeip.LookupLocalIP
+	nodeip.LookupOutboundIP = func(ctx context.Context, strategies ...geoip.OutboundIPStrategy) (net.IP, error) {
 		return nil, errors.New("realip.cc unavailable")
 	}
-	lookupLocalIP = func() string {
+	nodeip.LookupLocalIP = func() string {
 		return "9.9.9.9"
 	}
 	defer func() {
-		lookupOutboundIP = previousOutboundLookup
-		lookupLocalIP = previousLocalLookup
+		nodeip.LookupOutboundIP = previousOutboundLookup
+		nodeip.LookupLocalIP = previousLocalLookup
 	}()
 
 	dir := t.TempDir()
@@ -512,7 +514,7 @@ func TestNodeIPPriority(t *testing.T) {
 			if tt.ip != "" {
 				parsed = net.ParseIP(tt.ip)
 			}
-			if got := nodeIPPriority(parsed); got != tt.expected {
+			if got := iputil.Score(parsed); got != tt.expected {
 				t.Fatalf("unexpected priority for %q: got %d want %d", tt.ip, got, tt.expected)
 			}
 		})

internal/apps/agent/config/duration.go

@@ -1,54 +1,5 @@
 package config
 
-import (
-	"encoding/json"
-	"fmt"
-	"strconv"
-	"strings"
-	"time"
-)
+import edgeconfig "github.com/Rain-kl/Wavelet/internal/apps/edge/config"
 
-type MillisecondDuration time.Duration
-
-func (d MillisecondDuration) Duration() time.Duration {
-	return time.Duration(d)
-}
-
-func (d MillisecondDuration) String() string {
-	return time.Duration(d).String()
-}
-
-func (d *MillisecondDuration) UnmarshalJSON(data []byte) error {
-	raw := strings.TrimSpace(string(data))
-	if raw == "" || raw == "null" {
-		*d = 0
-		return nil
-	}
-	if strings.HasPrefix(raw, "\"") {
-		var text string
-		if err := json.Unmarshal(data, &text); err != nil {
-			return err
-		}
-		text = strings.TrimSpace(text)
-		if text == "" {
-			*d = 0
-			return nil
-		}
-		parsed, err := time.ParseDuration(text)
-		if err != nil {
-			return fmt.Errorf("invalid duration string %q: %w", text, err)
-		}
-		*d = MillisecondDuration(parsed)
-		return nil
-	}
-	ms, err := strconv.ParseInt(raw, 10, 64)
-	if err != nil {
-		return fmt.Errorf("invalid duration milliseconds %q: %w", raw, err)
-	}
-	*d = MillisecondDuration(time.Duration(ms) * time.Millisecond)
-	return nil
-}
-
-func (d MillisecondDuration) MarshalJSON() ([]byte, error) {
-	return json.Marshal(time.Duration(d).Milliseconds())
-}
+type MillisecondDuration = edgeconfig.MillisecondDuration