[yiguodev]

Summary

Allow callers to obtain complete subscription text before deciding whether to import nodes or preserve a provider's full Xray configuration. Remove exit-location probing from batch latency tests.

Invoke v3
  decodeSubscriptionText(text, optional age.secretKey)
    existing Age decryption → complete plaintext {text}
  pingBatch(configs ≤ 5)
    selected outbound + dependencies → one latency HEAD per valid item

The decoder reuses the existing Age implementation, preserves plaintext exactly, and returns text even when empty. It performs no JSON parsing, Base64 decoding, outbound projection or Core creation. Plaintext is limited to 16 MiB of UTF-8 bytes; the existing request/response envelope limits still apply separately. English and Chinese API documentation describe the contracts.

Batch results retain input order, zero-millisecond delays and per-item errors. The managed-instance guard and temporary Core cleanup remain unchanged; apiVersion remains 3.

Evidence

• Before: Subscription conversion returned node projections; there was no Invoke method for preserving a complete decrypted document. Location-enabled batch probes issued a HEAD followed by a GET.
  After: TestInvokeDecodeSubscriptionTextPreservesWholeDocument and the share decoder tests preserve complete objects/arrays, DNS, routing, balancers and unknown fields, including X25519 and hybrid Age round trips. Error, plaintext-size and response-envelope cases pass. TestInvokePingBatchUsesEachForcedOutboundAndOnlyLatencyHeads verifies freedom succeeds and blackhole fails in input order, with exactly one HEAD and no other request; the zero-delay wire test passes.
• go test ./... -count=1, gofmt and git diff --check passed at 029b68f. Android artifacts built for four ABIs and Apple artifacts for five slices using the unchanged Xray Core v26.10.10 dependency; copied artifacts matched source hashes. Android arm64 consumer validation exercised native Age decoding and latency-only batch tests.

Merge Danger

Door: Two-way

Code can be reverted, but downstream request/result models and native artifacts must stay synchronized.

Blast Radius: Integrations

PingBatchWithLocation, locationUrl, locationJson and locationError are removed. Go callers using the removed function/fields must update; JSON clients must stop requesting or expecting location data. Consumers calling the new method require rebuilt native artifacts. Format classification and complete-configuration validation belong to the caller.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.