proxyctl 0.5.5__tar.gz → 0.5.6__tar.gz

{proxyctl-0.5.5 → proxyctl-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyctl
-Version: 0.5.5
+Version: 0.5.6
 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.5 → proxyctl-0.5.6}/man/proxyctl.1

@@ -131,11 +131,32 @@ Linux systemctl --user）。
 4 阶段健康检查：basic / groups / connectivity / outbound-ip。
 \fB--plain\fR 输出 TSV（stage / ok / detail）。
 .TP
-\fBproxyctl connections\fR [\fB--app\fR \fINAME\fR ...] [\fB--all\fR] [\fB--json\fR]
+\fBproxyctl connections\fR [\fB--host\fR \fITEXT\fR ...] [\fB--chain\fR \fITEXT\fR ...] [\fB--route\fR \fIKIND\fR ...] [\fB--preset\fR \fINAME\fR ...] [\fB--agent\fR \fINAME\fR ...] [\fB--query\fR \fITEXT\fR ...] [\fB--app\fR \fINAME\fR ...] [\fB--all\fR] [\fB--json\fR]
 把本机 App/进程的 TCP 连接与 \fIproxy_port\fR、mihomo \fB/connections\fR
-API 的 \fIsourcePort\fR 连接详情关联。默认过滤 Codex / Claude / ChatGPT；
-\fB--all\fR 查看所有进程。只读；非 mihomo 后端或本地 API 不可用时降级输出
-unmatched。
+API 的 \fIsourcePort\fR 连接详情关联。默认不做 AI 工具过滤，输出全部可关联
+目的站点；\fB--host\fR 按 host/rulePayload/IP 过滤，\fB--chain\fR /
+\fB--line\fR 按 Mihomo 链路节点过滤，\fB--route\fR 按 route_kind 过滤
+（proxy/direct/reject/unknown，也接受 代理/直连/拒绝/未知），\fB--preset\fR
+使用预设（如 ai/openai/anthropic/coding），\fB--agent\fR 按工具过滤（如
+codex/claude/chatgpt/openclaw），\fB--query\fR / \fB--filter\fR 做全文过滤。
+\fB--app\fR 保留兼容，用于进程/App 过滤；\fB--all\fR 为兼容 no-op。
+macOS 上还会用 \fBnetstat -anv\fR 反查被
+Network/System Extension 接管后的 socket owner，并在 JSON 中输出
+\fBproxy_owner_connections\fR 与 \fBproxy_owner_groups\fR。后者按
+rulePayload / host / IP 聚合目的地，输出 app_contexts / candidate_contexts，
+并标出 mixed_chains / mixed_route_kind。
+只读；非 mihomo 后端或本地 API 不可用时降级输出 unmatched。
+.TP
+\fBproxyctl traffic\fR [snapshot|sample|watch|report] [\fB--by\fR \fIline,app\fR] [\fB--interval\fR \fISEC\fR] [\fB--count\fR \fIN\fR] [\fB--since\fR \fI1h\fR] [\fB--store\fR \fIDIR\fR] [\fB--host\fR \fITEXT\fR ...] [\fB--chain\fR \fITEXT\fR ...] [\fB--route\fR \fIKIND\fR ...] [\fB--preset\fR \fINAME\fR ...] [\fB--agent\fR \fINAME\fR ...] [\fB--json\fR]
+按当前活跃 Mihomo \fB/connections\fR 的 upload/download 统计流量快照。
+默认 \fB--by line\fR 按首个链路节点统计线路；也可用
+\fB--by line,app\fR 进一步按软件归因。软件归因分可信度：
+可见进程为 process/socket-owner，被 Network/System Extension 遮蔽时按目的域名
+给出 inferred 候选。\fBsample\fR 记录一次连接计数器增量，
+\fBwatch\fR 按间隔重复记录，\fBreport\fR 读取已记录增量并按
+\fB--since\fR 汇总。人类输出模式下 \fBwatch\fR 每次采样都会实时打印一行进度；
+\fB--json\fR 保持最终单个 envelope。首次看到的连接只建立基线，不回填此前已经
+产生的字节；未运行 sample/watch 的时间段无法补算。
 .TP
 \fBproxyctl trace\fR \fIDOMAIN\fR [\fB--json\fR]
 4 阶段域名链路诊断：DNS 解析 / 规则匹配预测 / 连通性 / 实际连接。

{proxyctl-0.5.5 → proxyctl-0.5.6}/pyproject.toml

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

{proxyctl-0.5.5 → proxyctl-0.5.6}/src/proxyctl/_io.py

@@ -72,7 +72,7 @@ _COLOR_NAMES = ("RED", "GREEN", "YELLOW", "CYAN", "BOLD", "DIM", "NC")
 _COLOR_MODULES_KNOWN = (
     "proxyctl.cli", "proxyctl.status", "proxyctl.check",
     "proxyctl.trace", "proxyctl.audit", "proxyctl.explain",
-    "proxyctl.connections",
+    "proxyctl.connections", "proxyctl.connections_human", "proxyctl.traffic",
 )
 
 
@@ -399,7 +399,7 @@ def lock_paths(lock_dir: str | None = None) -> dict[str, str]:
     home = os.path.expanduser("~")
     base = lock_dir or os.path.join(home, ".config", "proxyctl")
     # 已知锁名（与 cli._exec_with_lock 一致）
-    names = ["system", "config", "daemon"]
+    names = ["system", "config", "daemon", "traffic"]
     return {n: os.path.join(base, f".lock.{n}") for n in names}
 
 

{proxyctl-0.5.5 → proxyctl-0.5.6}/src/proxyctl/cli.py

@@ -2,8 +2,8 @@
 
 支持 Mihomo 后端（首发）/ Sing-box 后端（预留）
 
-用法：proxyctl [start|stop|restart|status|log|check|fix|recover|
-               mode|audit|trace|bench|dns-lock|dns-unlock]
+用法：proxyctl [start|stop|restart|status|log|check|connections|traffic|
+               fix|recover|mode|audit|trace|bench|dns-lock|dns-unlock]
 """
 
 import functools
@@ -1680,6 +1680,8 @@ def cmd_version_print() -> None:
                 "doctor_since_filter":             True,   # 0.5.0: --since <version> 屏蔽未来规则
                 "suggestions_ignore_file":         True,   # 0.5.0: ~/.config/proxyctl/suggestions.ignore
                 "proxy_group_dead_check":          True,   # 0.5.0: proxy_group.mostly_dead 规则
+                "traffic_snapshot":                True,   # 0.5.6+: active /connections traffic grouping
+                "traffic_history":                 True,   # 0.5.6+: sample/watch/report recorded deltas
             },
         }
         _io.emit_json(_io.envelope("version", data=data))
@@ -2749,6 +2751,10 @@ def _h_connections(ctx):
     from proxyctl.connections import cmd_connections
     cmd_connections(ctx["args"], ctx["backend"], ctx["config"])
 
+def _h_traffic(ctx):
+    from proxyctl.traffic import cmd_traffic
+    cmd_traffic(ctx["args"], ctx["backend"], ctx["config"])
+
 def _h_bench(ctx):
     from proxyctl.check import cmd_bench
     bench_groups = ctx["args"] or None
@@ -2916,6 +2922,7 @@ DISPATCH: dict = {
     "log":             _h_log,
     "check":           _h_check,
     "connections":     _h_connections,
+    "traffic":         _h_traffic,
     "bench":           _h_bench,
     "fix":             _h_fix,
     "recover":         _h_recover,