proxyctl 0.5.9__tar.gz → 0.5.10__tar.gz

{proxyctl-0.5.9 → proxyctl-0.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyctl
-Version: 0.5.9
+Version: 0.5.10
 Summary: Proxy configuration lifecycle management for macOS and Linux
 Project-URL: Homepage, https://github.com/crhan/proxyctl
 Project-URL: Issues, https://github.com/crhan/proxyctl/issues

{proxyctl-0.5.9 → proxyctl-0.5.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "proxyctl"
-version = "0.5.9"
+version = "0.5.10"
 description = "Proxy configuration lifecycle management for macOS and Linux"
 readme = "README.md"
 requires-python = ">=3.10"

{proxyctl-0.5.9 → proxyctl-0.5.10}/src/proxyctl/audit.py

@@ -180,8 +180,18 @@ def _is_covered(host: str, suffix_set: set) -> bool:
     return any(".".join(parts[i:]) in suffix_set for i in range(len(parts)))
 
 
+_AUDIT_DENY_OUTBOUNDS = {"block", "reject"}
+
+
 def _load_rules() -> tuple:
-    """从双 config 读取 direct/proxy 域名后缀规则集。"""
+    """从双 config 读取 direct/proxy 域名后缀规则集。
+
+    分类策略：``direct`` outbound 归 direct；``block`` / ``reject`` 忽略；
+    其它任意 outbound 名（用户的命名组如 ``proxy`` / ``residential-tw`` /
+    个人命名组等）一律视为"代理类"，归入 ``proxy_suffixes``。
+    这里**不 hardcode 任何具体的代理组名**——通用基线插件和 audit 都不
+    应假设用户配置里有某个特定名字的组。
+    """
     direct_suffixes: set = set()
     proxy_suffixes: set = set()
 
@@ -189,12 +199,15 @@ def _load_rules() -> tuple:
     try:
         cfg = json.load(open(SB_CONFIG))
         for rule in cfg.get("route", {}).get("rules", []):
-            ob = rule.get("outbound", "")
+            ob = (rule.get("outbound") or "").strip()
+            if not ob:
+                continue
+            ob_lc = ob.lower()
             for s in rule.get("domain_suffix", []):
                 s = s.lstrip(".")
-                if ob == "direct":
+                if ob_lc == "direct":
                     direct_suffixes.add(s)
-                elif ob in ("proxy", "claude"):
+                elif ob_lc not in _AUDIT_DENY_OUTBOUNDS:
                     proxy_suffixes.add(s)
     except Exception:
         pass
@@ -202,13 +215,17 @@ def _load_rules() -> tuple:
     # mihomo YAML (文本扫描，无需解析完整 YAML)
     try:
         for line in open(MH_CONFIG):
-            m = re.match(r'\s*-\s+DOMAIN-SUFFIX,([^,]+),(DIRECT|proxy|claude)', line, re.I)
-            if m:
-                dom, target = m.group(1), m.group(2)
-                if target.upper() == "DIRECT":
-                    direct_suffixes.add(dom)
-                else:
-                    proxy_suffixes.add(dom)
+            # group(2) 取第一个 outbound 段（到下一个逗号或空白），
+            # 避免把 "proxy,no-resolve" 整体当作 outbound 名。
+            m = re.match(r'\s*-\s+DOMAIN-SUFFIX,([^,]+),([^,\s]+)', line, re.I)
+            if not m:
+                continue
+            dom, target = m.group(1), m.group(2)
+            target_lc = target.lower()
+            if target_lc == "direct":
+                direct_suffixes.add(dom)
+            elif target_lc not in _AUDIT_DENY_OUTBOUNDS:
+                proxy_suffixes.add(dom)
     except Exception:
         pass
 

{proxyctl-0.5.9 → proxyctl-0.5.10}/src/proxyctl/builtin_plugins/connectivity_basic.py

@@ -3,12 +3,17 @@
 提供一组跨所有用户都通用的连通性测试点：
 - 海外（走代理）：google / github
 - 国内（直连）：baidu
-- AI 线路：openai / anthropic（anthropic 走 claude 规则组）
+- AI 线路：openai / anthropic
 
 本机特例（discord/telegram、企业内网等）请走用户插件。
 
 代理组：默认提供 "proxy"（绝大多数 mihomo/sing-box 配置都有这个组）。
-其他组（claude / residential-* 等）由用户插件提供。
+命名组（如 claude / residential-* 等）和针对它们的 expected_proxy 校验、
+出口探测都属本机特例，请放到 ~/.config/proxyctl/plugins/ 的用户插件里，
+不要 hardcode 进这个通用基线插件。
+
+出口探测：默认只提供 proxy（走主代理）/ direct（绕代理）两路对照，
+足够做分流校验；其它命名出口由用户插件按 name 追加或覆盖。
 """
 
 from proxyctl.core.plugin import CheckTarget, OutboundProbe, Plugin
@@ -30,14 +35,12 @@ class ConnectivityBasic(Plugin):
             CheckTarget(name="baidu",  url="https://www.baidu.com",  mode="direct"),
             CheckTarget(name="anthropic",
                         url="https://api.anthropic.com/v1/models",
-                        mode="proxy",
-                        expected_proxy="claude"),
+                        mode="proxy"),
         ]
 
     def check_outbound_probes(self, ctx: dict) -> list[OutboundProbe]:
         return [
             OutboundProbe(name="proxy", mode="proxy", url="https://api.ipify.org"),
-            OutboundProbe(name="claude", mode="proxy", url="https://ipinfo.io/ip"),
             OutboundProbe(name="direct",
                           mode="direct",
                           url="https://myip.ipip.net",

{proxyctl-0.5.9 → proxyctl-0.5.10}/src/proxyctl/check.py

@@ -35,6 +35,11 @@ def _strip_ansi(s: str) -> str:
     return _ANSI_RE.sub("", s).strip()
 
 
+def _visible_len(s: str) -> int:
+    """Return printable width for simple check output alignment."""
+    return len(_ANSI_RE.sub("", s))
+
+
 def _port_listening(port: int) -> bool:
     try:
         with socket.create_connection(("127.0.0.1", port), timeout=0.5):
@@ -162,11 +167,15 @@ def _target_uses_expected_proxy(api_base: str, api_secret: str, url: str,
 
 
 def _connectivity_line_value(mode: str) -> str:
-    """Return the default route-line label for one check target mode."""
+    """Return the default route-line label for one check target mode.
+
+    proxy 模式默认值是 em dash ("—") 而非问号——含义是"反查不到活动连接"，
+    比裸 "?" 信息密度更高、视觉更安静。真实反查命中时会被实际链路覆盖。
+    """
     if mode == "direct":
         return "direct"
     if mode == "proxy":
-        return "?"
+        return "—"
     return "-"
 
 
@@ -174,7 +183,8 @@ def _append_route_column(line: str, route_line: str,
                          route_chain: str = "") -> str:
     """Append the observed route in the same style as Mihomo chains."""
     value = route_chain or route_line or "-"
-    return f"{line}  {DIM}via{NC} {value:<32s}"
+    pad = max(2, 74 - _visible_len(line))
+    return f"{line}{' ' * pad}{DIM}via{NC} {value:<32s}"
 
 
 def _dedupe_check_targets(targets: list) -> list:
@@ -202,17 +212,23 @@ def _dedupe_check_targets(targets: list) -> list:
 
 
 def _dedupe_outbound_probes(probes: list) -> list:
-    """Drop exact duplicate outbound probes from multiple plugins."""
-    out = []
-    seen = set()
+    """Collapse outbound probes that share a (name, mode) identity.
+
+    A probe answers one question — "what IP does this egress show?" — so two
+    probes with the same ``name`` and ``mode`` are the same egress row even if
+    they hit different URLs (e.g. a builtin ``https://myip.ipip.net`` vs a user
+    plugin's ``http://`` variant). User plugins load after builtins, so the
+    later probe wins on conflict (本机特例覆盖通用基线), while the original
+    display position is preserved so row order stays stable across runs.
+    """
+    out: list = []
+    index: dict = {}  # (name, mode) -> position in out
     for probe in probes:
-        key = (getattr(probe, "name", ""),
-               getattr(probe, "mode", ""),
-               getattr(probe, "url", ""),
-               getattr(probe, "extract_re", ""))
-        if key in seen:
+        key = (getattr(probe, "name", ""), getattr(probe, "mode", ""))
+        if key in index:
+            out[index[key]] = probe  # later (user) probe overrides earlier
             continue
-        seen.add(key)
+        index[key] = len(out)
         out.append(probe)
     return out
 
@@ -1192,14 +1208,49 @@ def cmd_check(engine, api: str, api_secret: str,
                 parts = target.url.removeprefix("tcp:").rsplit(":", 1)
                 ok, line = _test_tcp(parts[0], int(parts[1]), target.name)
             else:
+                # proxy 模式：在 curl 测试**进行中**并发轮询 mihomo 的
+                # /connections，趁连接还活着抓到自己请求走的链路。
+                # curl 短连接测完即从 mihomo 连接表移除，如果等 curl 结束
+                # 后再查（旧实现），几乎抓不到自己刚发的请求 —— 这是
+                # google/github/openai 的 via 列长期显示 "?" 的根因。
+                host = urllib.parse.urlparse(target.url).hostname or ""
+                captured: dict = {}
+                stop_evt = threading.Event()
+                poller = None
+                if target.mode == "proxy" and host:
+                    def _poll():
+                        # Event.wait(timeout) 在 set 时立即返回 True，
+                        # 不会被 sleep 拖住停止响应。
+                        while not stop_evt.is_set():
+                            r = _route_from_connections(
+                                _api_connections(api, api_secret), host)
+                            if r.get("found"):
+                                captured.update(r)
+                                return
+                            stop_evt.wait(0.08)
+                    poller = threading.Thread(target=_poll, daemon=True)
+                    poller.start()
+
                 ok, line = _test_url(target.url, target.name,
                                      target.mode, target.timeout,
                                      proxy_port=proxy_port)
+
+                if poller is not None:
+                    stop_evt.set()
+                    poller.join(timeout=0.5)
+
                 expected = getattr(target, "expected_proxy", "")
                 if target.mode == "proxy" and ok:
-                    route = _target_route(api, api_secret, target.url)
-                    route_line = str(route.get("line") or "?")
-                    route_chain = str(route.get("chain") or "")
+                    # 优先取 curl 期间并发抓到的；抓不到时回退 _target_route，
+                    # 它可能从外部进程的活动长连接里命中（如用户的浏览器/
+                    # Claude Code 正在访问同一 host）。两者都没找到时
+                    # route_line 保留默认的 "—" 占位（_connectivity_line_value
+                    # 提供的友好兜底），而不是裸 "?"。
+                    route = (captured if captured.get("found")
+                             else _target_route(api, api_secret, target.url))
+                    if route.get("found"):
+                        route_line = str(route.get("line") or route_line)
+                        route_chain = str(route.get("chain") or "")
                     if expected:
                         route_ok, route_msg = _route_matches_expected_proxy(
                             route, expected)