feat(api): 测速 API 重构，直接调用 urltest.URLTest 支持自定义超时

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: mapleafgo

cmd/lib/exports.go

@@ -82,8 +82,10 @@ func CoreSelectProxy(group, tag *C.char) *C.char {
 }
 
 //export CoreTestDelay
-func CoreTestDelay(name *C.char) *C.char {
-	return resultJSON(api.TestDelay(goString(name)))
+func CoreTestDelay(name *C.char, timeoutMs C.int) *C.char {
+	delay := api.TestDelay(goString(name), int32(timeoutMs))
+	data, _ := json.Marshal(map[string]int32{"delay": delay})
+	return cString(string(data))
 }
 
 //export CoreSetMode

core/handler.go

@@ -130,6 +130,19 @@ func (h *ClientHandler) GetCachedConnectionsJSON() string {
 	return string(data)
 }
 
+// UpdateDelay updates the cached delay for a specific proxy tag.
+func (h *ClientHandler) UpdateDelay(tag string, delay int32) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	for i := range h.cachedGroups {
+		for j := range h.cachedGroups[i].Items {
+			if h.cachedGroups[i].Items[j].Tag == tag {
+				h.cachedGroups[i].Items[j].Delay = delay
+			}
+		}
+	}
+}
+
 // Connected is called when the command client connects to the server.
 func (h *ClientHandler) Connected() {
 	h.emit(EventConnected, map[string]bool{"connected": true})

core/service.go

@@ -1,6 +1,7 @@
 package core
 
 import (
+	"context"
 	"encoding/json"
 	"fmt"
 	"log/slog"
@@ -12,6 +13,7 @@ import (
 	"sync"
 	"time"
 
+	"github.com/sagernet/sing-box/common/urltest"
 	"github.com/sagernet/sing-box/experimental/libbox"
 	_ "github.com/sagernet/sing-box/include" // register all protocols
 
@@ -548,9 +550,29 @@ func (s *Service) SelectOutbound(groupTag, outboundTag string) error {
 	})
 }
 
-// URLTest runs a URL test for the given outbound tag.
-func (s *Service) URLTest(outboundTag string) error {
-	return s.withClient(func(c *libbox.CommandClient) error { return c.URLTest(outboundTag) })
+// URLTest tests outbound latency via urltest.URLTest.
+// Returns delay in milliseconds, -1 on error or timeout.
+func (s *Service) URLTest(outboundTag string, timeoutMs int32) int32 {
+	inst := s.commandServer.Instance()
+	if inst == nil {
+		return -1
+	}
+	outbound, ok := inst.Box().Outbound().Outbound(outboundTag)
+	if !ok {
+		return -1
+	}
+	ctx, cancel := context.WithTimeout(context.Background(),
+		time.Duration(timeoutMs)*time.Millisecond)
+	defer cancel()
+
+	delay, err := urltest.URLTest(ctx, "", outbound)
+	if err != nil {
+		return -1
+	}
+	if s.handler != nil {
+		s.handler.UpdateDelay(outboundTag, int32(delay))
+	}
+	return int32(delay)
 }
 
 // SetClashMode sets the clash routing mode.

docs/api-reference.md

@@ -59,7 +59,7 @@ Exported as C-compatible symbols via `c-shared` build mode. All functions return
 | Function | Signature | Description |
 |----------|-----------|-------------|
 | `CoreSelectProxy` | `char* CoreSelectProxy(const char* group, const char* tag)` | Select node in proxy group |
-| `CoreTestDelay` | `char* CoreTestDelay(const char* name)` | Run URL test for outbound |
+| `CoreTestDelay` | `char* CoreTestDelay(const char* name, int timeoutMs)` | URL test, returns `{"delay":ms}` or `{"delay":-1}` |
 | `CoreSetMode` | `char* CoreSetMode(const char* mode)` | Set routing mode: `rule` / `global` / `direct` |
 | `CoreSetGroupExpand` | `char* CoreSetGroupExpand(const char* group, int expand)` | Persist UI expand state |
 
@@ -166,7 +166,7 @@ Built with `gomobile bind`, generates AAR (Android) and xcframework (iOS). Metho
 | Method | Description |
 |--------|-------------|
 | `SelectProxy(group, tag string) error` | Select proxy node |
-| `TestDelay(name string) error` | URL test delay |
+| `TestDelay(name string, timeoutMs int32) int32` | URL test delay (ms), -1 on error/timeout |
 | `SetMode(mode string) error` | Set routing mode |
 | `SetGroupExpand(group string, expand bool) error` | UI expand state |
 

ffi/api.go

@@ -145,7 +145,10 @@ func (s *Singcast) SelectProxy(group, tag string) error {
 }
 
 // TestDelay runs a URL test for the given outbound tag.
-func (s *Singcast) TestDelay(name string) error { return s.svc.URLTest(name) }
+// Returns delay in milliseconds, -1 on error or timeout.
+func (s *Singcast) TestDelay(name string, timeoutMs int32) int32 {
+	return s.svc.URLTest(name, timeoutMs)
+}
 
 // SetMode sets the clash routing mode (rule, global, or direct).
 func (s *Singcast) SetMode(mode string) error { return s.svc.SetClashMode(mode) }