Skip to content

Releases

v0.1.5 — 节点名与出口归属:名字只来自证据,判不出就不编

Choose a tag to compare

@7icence1Z 7icence1Z released this 18 Nov 03:32

这一版只做一件事:节点名与出口归属说真话 —— 名字只来自证据,判不出就不编。
「连日本节点却显示 proxy」与「选美国却显示新加坡」是两类症状、一个病根:拿弱证据顶上。
一起收掉的还有配置解析、v2rayN 节点数、出口反查缓存几处老毛病。

修复

  • 节点名等于没说时改用「地域 · 协议」。有的客户端把节点直接叫 proxy、自动选择,
    或只写一面国旗 —— 照抄出来人看不出连的是哪。现在这类名字显示成 日本 · VLESS,
    原名、地址与判定依据留在悬停提示里;站点行悬停的链路名同样换过来,不再一边写
    日本 · VLESS、一边写 node_11_… | CM CU。地域从国旗、地名(中英皆可)、
    机场代码(NRT-01)与服务器域名(jp-…)依次认,认不出就不填。
  • "选的是美国节点,面板却说新加坡"。原来按各策略组的 now 投票,组一多就会选中并不承载
    流量的那个组;判不出来时还会沿用上一次的节点,可出口 IP 早换了。现在按证据强弱逐级判定:
    连接表 chains[0] → 出口 IP 与节点地址相同 → 配置里 MATCH 指向的默认分组此刻选中谁 →
    全局模式的 GLOBAL.now → 各分组投票 → 配置里唯一的节点;出口 IP 变了而节点判不出时置空,
    只显示出口地域,不再顶着旧名字。
  • 策略组被当成节点(proxy-groups: 段落串进了节点表,节点数虚高)、mihomo 内置的
    REJECT-DROP / PASS-RULE 被算作节点
    ,两处都按类型排除。
  • 订阅走 proxy-providers 时节点整块空白:配置里没有 proxies: 段,改为从控制器
    /proxies 取节点名兜底,节点数也按控制器算。
  • v2rayN 的备注读不到:guiNDB.db 在 guiConfigs\ 的上一级或程序目录,原来只查配置所在
    目录;另外节点名优先取备注名,不再用 outbound tag(proxy)冒充。
  • v2rayN 的节点总数显示成 1:先从 guiNDB.db 数出总数,随后又被写死成 1。
  • 多节点 Xray 配置取错节点:原来取 outbounds 列表里第一个带地址的,现在先看路由表末条
    (MATCH)指向哪个 outboundTag,指向直连等没有地址的才退回第一个。
  • 订阅用行内写法时节点表只认一半:proxies: 下写成 - {name: …, server: …},或 - name:
    (破折号后两个空格)时整个节点被跳过,节点数、出口反查、链路名都跟着错。现在块状、行内、
    破折号后多空格三种写法都认。
  • 出口反查的 DNS 缓存没有过期时间:解析失败一次就再也不重试,节点轮换后还可能拿旧 IP 认错
    节点,一轮里最多挨个解析 64 个域名。改为成功缓 10 分钟、失败缓 2 分钟、每轮最多 16 个并按轮转推进。
  • 判不出节点时沿用上一次的条件从「有 server」改成「同一客户端进程 + 出口 IP 未变」:
    proxy-providers 的节点没有 server 字段,原来会闪成空白;换了客户端进程也不再沿用旧名字。
  • 解析 clash 配置时,proxies: / rules: 位于文件开头或使用 CRLF 换行会抛 IndexError,改为按行首定位。
  • 站点行悬停出现 undefined 条连接:没有连接数时不写这一截;认不出节点时悬停补上"为什么空着"。

新增

  • sing-box 的默认出口会顺着 selector 的 default 走到具体节点(route.final 常常指向一个组)。
  • Intl.DisplayNames 兜底地区名:内置表里没有的国家/地区也不至于显示成两位码。
  • tools/test_node.py:占位名、地域识别、Clash / sing-box / v2rayN / Xray 配置解析、判定顺序、
    节点视图、出口反查缓存共 75 项自检,python tools/test_node.py 直接跑,不需要装客户端。

文档

  • README 中英两版按现状改写:节点命名口径(证据链 + 「地域 · 协议」)、支持的客户端表、
    目录结构补 tools/test_node.py、版本与日期更新为 v0.1.5;
    docs/IMPLEMENTATION.md 的自检表补上 tools/test_node.py。
  • package.json 的 files 补上 tools/ 下的查看器与自检脚本,装完包也能跑文档里写的 tools/peek.py。

v0.1.4 — 探测设置可改、英文界面、采样 0.5 秒、稳态不再起子进程

Choose a tag to compare

@7icence1Z 7icence1Z released this 13 Nov 16:04

先修两个"面板看起来不对劲"的问题 —— 顶栏「采集器未连接」闪一下又灭、曲线一秒一跳、像折线;
再把探测设置搬上面板、补一套英文界面;最后把常态开销压下来 —— 不再定期唤醒子进程。

新增

  • 探测目标可以在面板上改。卡头多了个 ✎:探测目标、对照目标、间隔(5~120 秒),
    保存即生效 —— 采集器把新值写进运行参数并落盘 config.json,探测线程下一轮就用,不用重启。
    地址只收 http / https 且必须有主机名,指向本机(localhost / 127.0.0.1)会被拒绝:
    拿本机当"只有经隧道才可达"的目标,证明不了任何事。填错时原因写在表单里,不弹框。
    探测行标题改为显示实际探测的主机名,不再写死 baidu.com。
  • 界面加了英文(英式拼写)。顶栏 中 / EN 切换,选择记在 localStorage,也认 ?lang=en。
    判定理由、诊断结论、探测病因这些由采集器算出来的句子,一次发中英两版({"zh": …, "en": …}),
    面板按当前语言取;静态文案走 data-i18n* 属性重写,切语言不重载页面。
  • 文案去口语化:走 VPN → 经隧道、隧道读不到 → 隧道统计不可读、
    没在转发 → 未在走隧道、待测 → 检测中;本机模式补一句"经客户端本地口计数"的口径说明。

修复

  • 「采集器未连接」不再闪断。判掉线原来是"3.5 秒没有新帧",可正常节奏本来就是 0.5~1 秒一帧,
    机器忙、连接表/探针慢的时候偶尔憋到两三秒,提示就出现又消失。现在要连续 6 秒没有新帧才判
    掉线(首帧之前 8 秒),恢复要真的收到新帧才撤;另外收到帧就算"连着" —— 渲染出错是面板
    自己的锅,不再连累顶栏报采集器掉线。
  • SSE 关掉 Nagle(TCP_NODELAY):每帧就是一小段 JSON,攒包会让面板晚几百毫秒,连着攒就像卡住。

体验

  • 采样从 1 秒提到 0.5 秒(有代理客户端时)。本机模式要枚举连接和进程,采一帧超过 0.35 秒就
    自动退回 1 秒,不把 CPU 占满。历史从 120 帧提到 240 帧,窗口仍是 2 分钟。
  • 曲线改成单调三次插值:折线变圆润,又不会冲过头 —— 局部极值处切线归零,速率尖峰不会被
    拉成负值或虚高。
  • 站点标题栏的采样节奏改成后端实测值(快照里的 dt),不再写死 1s 采样。
  • tools/mock_state.py 加 MOCK_DIE_AT=<次数>:第 N 次请求之后一句不回就断,手工复现
    「采集器未连接」;也认 POST /api/probe(只回一句"已更新",不落盘),别让演示面板点了 ✎ 就 404。
    mock 的判定文案同样发 {zh, en} 两版,方便直接截图核对英文。

性能

稳态下不再定期起子进程。旧版每分钟要唤醒二十来个:PowerShell 查进程表(客户端模式 30 秒一次、
本机模式 8 秒一次,实测单次 0.9~1.0 秒)、netsh wlan 查无线(20 秒一次,0.24 秒)、
netsh 查地址与度量(20 秒一次,0.15 秒)、netstat 查端口归属(15 秒一次,0.08 秒)、
ping.exe 探网关(15 秒两次,可达 0.07 秒、不可达 0.5 秒)。本机模式下只进程表一项,就要每秒
让出一个核的 12 %。

这些都不必开进程 —— 内核表就在手边:

  • 进程表:Toolhelp32 快照 + QueryFullProcessImageNameW + GetProcessTimes,单次约 17 ms。
    只有"名字对不上客户端"的极少几个 pid 才去问 WMI(Win32_Process 加 ProcessId 过滤,命中即缓存 5 分钟)
  • 端口归属:GetExtendedTcpTable(OWNER_PID_ALL),v4 + v6 都查(只查 v4 会漏掉绑在 ::1 的客户端)。
    与 netstat 逐条比对:208 个端口、归属 0 处不同
  • 网卡地址 / 网关 / 度量:GetAdaptersAddresses,单次约 10 ms(netsh 133 ms)
  • 网关探活:IcmpSendEcho,单次约 8 ms(ping.exe 71 ms,且那个数含进程启动)
  • 无线信息:仍然用 netsh wlan(信道、频段它最省事),但只在真有无线网卡连着时才问 ——
    判定用内核的媒体连接状态,有线机器上这一项开销归零;无法确定时宁可多查询一次,以免遗漏信息

旧实现一律留着当内部兜底(_ps_table_wmi / _listen_map_netstat / _addrs_netsh / _gateway_ping),
内核表读不到(权限、旧系统、异常)就自动退回,行为不变。

其余三处都在采集器自己进程里,量不大,但不再随面板数量放大:

  • 与控制器改用长连接。按线程各留一条(断了重建,仍不成就退回 urllib):同一进程内 A/B 交替实测,
    取一次 /connections 从 1.8 ms 降到 0.6~1.0 ms —— 0.5 秒一帧,每帧省下的都是一次建连
  • 快照只编码一次。/api/stream 与 /api/state 以前各自 json.dumps 一遍,二十多 KB 的帧按读者数
    重复编码;现在发布时编一次,读者直接拿字节
  • 网卡名不再每秒重读。GetIfTable2 每帧只取计数与状态,别名字符串按索引缓存 30 秒

实测(同一台机器、客户端模式):稳态 60 秒内子进程 0 次;采集器自身 CPU 与内存和改动前基本持平
(约 2 % 单核、约 49 MB)—— 省下的是子进程的创建与它们占的 CPU,那部分本来记在 powershell /
netsh / ping 账上,不在采集器自己身上。

安装 / 更新

npm i -g @7icence1z/flow-tracking@latest
npx @7icence1z/flow-tracking@latest

v0.1.3 — 修 issue #1:在转发就说在转发 + 经本地口计数

Choose a tag to compare

@7icence1Z 7icence1Z released this 12 Nov 10:28

修的是 issue #1:
客户端明明在转发,面板却说"没在转发"。顺手把"读不到它的字节数"从死路变成活路 ——
不用让用户去开 v2rayN 的统计口,就能数出"应用 → 客户端本地口"这条回环连接上的字节。

修复

  • "在转发"和"没在转发"分成两件事判。以前只要控制器 / 统计口读不到,就写「没在走隧道」,
    可系统代理明明指着客户端自己开的本地口。现在先收集"它在转发"的证据(_forwarding_proxy()):
    系统代理开着 + 客户端身份还在 + 那个端口确实在听 + 端口属于它(或它的内核进程,两层父进程、
    进程名都能对上);拿到证据就判 部分走 VPN,理由改成"在转发,但字节数读不到" ——
    只说读不到,不断言它没干活。
  • 证明不了的时候也不再顺口下结论:只说"读不到它的流量 · 按网卡统计",
    不再写"本地代理口 / 控制器都连不上"这种没验证过的话。
  • 端口在听、但不是它的进程开的(别的程序占着)→ 不当证据,不猜。

新增

  • 经本地口计数:不给统计口也能数出"进了客户端"的字节。系统代理模式下,应用是先连
    127.0.0.1:10809 再由客户端转发出去的,那条回环 TCP 连接上过的字节就是入口字节。
    管理员下对"远端端口 = 客户端本地代理口"的已建立连接做 eStats 差分(hostflow.py 的新入参
    proxy_ports),得到 split.client。
    • 不碰客户端配置、不重启它的内核、不要求它开统计口;Clash 关了 API、v2rayN 关了统计口都一样能数。
    • 入口 ≠ 隧道:客户端按规则可能把一部分直接放出去,所以面板只把它当"上限"报
      (「经客户端 …」,进程行染中性色),不拿它冒充"经代理"、也不拿它做差算"不走代理"。
    • 只数 TCP(UDP/QUIC 本来就不经 HTTP 代理口),且只在系统代理模式成立 ——
      TUN 模式没有回环代理连接,那种情况也不需要(网卡本身就是隧道网卡)。
    • 每进程行跟着变准:以前浏览器走代理时它那行几乎是 0;现在把入口字节并回它的行,
      并单独标出其中多少经过本地代理口。
    • 发布字段:split.client(入口字节)+ split.src="loop";此时 split.proxy / split.direct
      为 null —— 真分账要客户端统计口,src="api" 才是那个来源。
  • 第 15 档诊断多一种说法:管理员下数到入口字节时,说「客户端在转发(经本地口计数)」,
    不再说"读不到字节数",也不说成"分账"。
  • flow admin 的收益从"每进程速率"扩成"每进程速率 + 进客户端的字节"(后者只在系统代理模式下有)。

复核修正(Codex review)

PR #2 的自动审查提了三条,逐条核对后都成立,已经改掉:

  • 把入口字节当隧道流量(P1):有路由规则的客户端会把 geosite:cn 之类直接放出去,
    入口字节里混着"过客户端但没走隧道"的量。改成只发 split.client,文案与染色都不再声称走 VPN。
  • 端口集合把不该算的端口算进来(P2):ProxyEnable=0 时注册表里残留的地址、
    以及远端(非回环)代理地址的端口,都可能匹配上无关的本机服务。改成只认
    "系统代理开着且指向本机"或"客户端自己报告的本地口",并且只有拿到转发证据才使用这堆字节。
  • 前端读不到"有没有入口数据"(P2):Collector._publish() 发布的 host 里不含 proxy 字段,
    前端却拿 host.proxy 判断,真机上永远是 false。改成从 split.src === "loop" + split.client 判断;
    mock 也去掉了那个只在演示数据里存在的字段,避免示意图掩盖问题。

收尾:面板与命令行

修复

  • VPN 关掉之后琥珀色折线不再消失(面板):主曲线以前整条按"此刻"的状态上色,隧道一断就从琥珀翻成
    青色,历史跟着被改写。改成每个采样点记下"当时走哪条路",按连续段上色 —— 关掉 VPN 之后琥珀不再长新点,
    旧点留在原处、随窗口继续向左滑出去,看得出"那段时间走的是隧道"。
  • 采集器掉线不再冒充"现在":窗口里那一帧若是旧的(被 kill / 崩了 / 端口改了),顶栏出现
    「采集器未连接 · 最后 21:03:10」,判定与读数变淡,直到新的快照进来才恢复。以前会一直挂着上一帧的
    「部分走 VPN」,看上去像"kill 了客户端还在走 VPN"。
  • 进程表缓存里的死进程不算"在转发"(providers._alive()):_table() 缓存 30 秒、_ports() 缓存
    15 秒,客户端被 kill 之后缓存里还留着它的名字和端口归属。现在转发证据必须挂在活着的 PID 上,
    免得"进程都没了,面板还说在走 VPN"。
  • flow status 会连带把面板也拉起来:runStatus() 是异步的,没退出就落到了下面的 psRun()。
    改成取完状态直接 return。

新增

  • flow status(别名 flow stat):读一次 /api/state 打印一屏 —— 模式、判定、诊断、通道、
    网卡、大盘与分账、累计、出口 IP、客户端与节点;-p 可指定端口。采集器没起时说清"没在运行"并退出 1。
    flow --help / flow -h / flow help 里列出来了。
  • flow --version(别名 -v、version):直接从包里的 package.json 读版本与包名,不依赖采集器、不碰 Windows 检查,flow -v 在管道/CI 里也能用。
  • tools/check_js.py:把面板内联 <script> 抠出来跑 node --check。面板 JS 语法错只会表现为
    "连接中…"停在原地,这个闸能在打包前拦住。
  • tools/mock_state.py 加 MOCK_OFF_AT=<次数>:手工看"VPN 关掉之后"的曲线(前 N 帧琥珀、之后直连)。
  • tools/test_diag.py 加 2 项:进程表缓存里名字对得上、但 PID 已死 → 不算在转发;PID 活着 → 才算。

文档

  • README 整体按 v0.1.3 现状改:命令表加 flow status / flow --help 与一小段用法(含退出码);
    面板那节写清"曲线按采样点当时的判定留色"和"连不上采集器时的顶栏提示";
    本机模式那节补第三种情形(管理员下的经本地口计数)、权限表加一行、结论表第 15 档写清两种说法、
    数据来源表加"进客户端的字节(本机模式)"、split 字段说明、
    排障表加"开了 VPN 但面板说直连"和"没有 VPN 却写部分走 VPN"、边界里写清入口计数的适用面
    (只 TCP / 只系统代理模式 / 入口≠隧道);版本节与顶部一行改成已发布 v0.1.3。
  • tools/test_diag.py:16 组构造证据 + 9 组异常分类 + 16 组本机 / 在转发 / 入口计数(共 41 项)。
    入口计数 7 项:端口集合的准入与排除(含注册表残留、远端代理地址)、假 eStats 下真的数出入口字节、
    这份字节记到进程头上、端口不在集合里就一个字节都不算。

v0.1.2 — 诊断结论 + 本机模式 + 流量分账

Choose a tag to compare

@7icence1Z 7icence1Z released this 12 Nov 04:56

这一版把面板从"给你三行探测结果"推到"告诉你到底该怀疑谁",同时补上两个长期缺口:
没开 VPN 时也能看流量(本机模式,管理员权限下还有每进程速率),
以及关掉节点后不再一直误报"隧道异常"。

新增

  • 诊断结论(diag.py,新文件,纯标准库)。右上角那句话由证据算出来,不是标题:
    链路 → DNS → 隧道 → 目标,从底层往上排,越底层的问题越先报。结论十四档:
    链路正常 / 目标被墙但代理正常 / 目标需要进出隧道(TUN)/ ⟨网卡⟩ 链路不通 / DNS 解析有问题 /
    链路通但外面不通 / VPN 本地代理口没开 / 代理口被占不是客户端 / VPN 没连上节点(灰)/
    VPN 拒绝连接 / ⟨隧道网卡⟩ 链路不通 / 代理侧 DNS 失败 / VPN 隧道或节点异常 /
    没在走隧道或没有代理客户端,只看本机流量(灰)。
    每档都带证据(对照 www.baidu.com 通 40ms、直连目标 超时、代理通道 不通),鼠标停上去就能看。
  • 本机模式(hostflow.py,新文件,纯 ctypes)。检测不到代理客户端(没系统代理、没 TUN、没控制器)时,
    面板照样监测:GetIfTable2 读网卡 InOctets/OutOctets 给真实 ↓↑ 与累计;
    GetExtendedTcpTable(TCP_TABLE_OWNER_PID_ALL) 拿已建立连接,按进程归并成"谁开着几条连接、连着几个远端 IP"。
    + 域名 收起、站点卡变「进程」、诊断结论写"只看本机流量",不假装知道隧道的事。
  • 管理员权限下的逐进程速率。本机模式以前只数连接不数字节,因为逐进程字节要内核 eStats,
    普通权限下 SetPerTcpConnectionEStats 回 5(ACCESS_DENIED)。现在采集器先用 IsUserAnAdmin 认权限:
    管理员启动时给每条已建立 TCP 连接开统计(SetPerTcpConnectionEStats),1 Hz 差分出每个进程真实的 ↓↑
    (GetPerTcpConnectionEStats 的 DataBytesIn/Out),于是「进程」表和「站点」表长得一模一样 ——
    曲线、速率、累计都有。普通权限保持原样:第一次 Set 拿到 5 就立刻关掉这条路,不重试、不报错、不编数字。
    升级方式:右键 start.cmd →「以管理员身份运行」,不用改配置。
  • 分账:开着 VPN 时直连和隧道一起数。网卡总量每帧都采,和客户端报的"经代理字节"相减,得到"不走代理"那部分。
    实时吞吐的大盘改成网卡总量(真实全机),旁边写 经代理 121 KB/s · 不走代理 8.5 KB/s,两条泳道各挂自己的速率。
    差值含 UDP/QUIC 帧开销,按估算对待。
  • 失败病因分类:探测失败不再显示 URLError,而是 DNS 失败 / 拒绝连接 / 连接重置 / 超时 / 网络不可达 /
    TLS 错误 / 绑不上网卡。URLError 会把真正病因包在 .reason 里,剥一层再判。
  • 网关探测:每条路各自那块网卡的网关单独 ping 一次(只看退出码,不解析输出,中英文 Windows 都稳)。
    这是"Wi-Fi / 网线断了"和"上游断了"的分界线。
  • DNS 双向对比:系统解析器问一次,再绕开它直接 UDP 问 223.5.5.5 一次。
    两边地址对不上就标"疑似污染";系统解析失败而公共 DNS 能解析,就指向本地 DNS 配置。
  • 按网卡绑定握手:把源地址钉到某块网卡再 connect() 目标 443,Wi-Fi 和有线各自独立成一格。
    带源地址的连接会按该地址选路由,所以测的是这块网卡自己的路,而不是"系统默认走哪条就测哪条"。

修复

  • 关掉节点连接之后,无论 VPN 软件开没开都一直显示"隧道异常"。三处病根一起治:
    ① 客户端壳还在、但控制器/代理口读不到时,采集器原本只把这一帧标成失败,面板就卡在 path.active="down",
    而 down 在界面上被写成「隧道异常」—— 现在失败帧会回落到本机模式(flow="host"),网卡速率照数,
    文案改成 ⟨客户端⟩ 在跑,但读不到它的流量(没连节点,或控制器没开);
    ② providers.py 发现客户端进程在、但控制器和统计口都读不到时不再保留旧身份(Registry._clear),
    软件关掉后不会继续去问一个不存在的控制器;
    ③ 界面上 down 改叫「隧道读不到」,并把"客户端在跑但没连节点"归到中性灰档
    (nopx「没在走隧道,只看本机流量」),红色只留给"说在用、但用不了"。
  • 能连上代理口、但隧道里 0 条连接(典型的"没选节点")以前会报成红色「VPN 隧道/节点异常」,
    现在改判中性灰「VPN 没连上节点」,并说明"连上节点这一格会自己变绿"。
  • 本机模式下不再显示那句红色的 控制器 … · 在线,页脚改成 本机模式 · 普通权限:只数连接 /
    本机模式 · 管理员:逐进程速率;VPN 泳道写 隧道未启用,不再是空着的 ?。

界面

  • 「通道探测」卡片右上角换成诊断结论:一句话 + 颜色(青=正常 / 琥珀=目标被墙 / 红=链路、DNS、隧道问题 / 灰=没在用隧道),
    鼠标停上去能看到支撑它的证据。
  • 判定多了 本机直连;站点卡标题变「进程」,右上角按权限写 只数连接 · 不数字节(要管理员权限)
    或 按进程归并 · 1s 采样 · 管理员权限。
  • 实时吞吐大盘改为网卡总量 + 分账;累计改为网卡累计(本次 ↓ ↑);
    连接数的 title 里区分"经代理 N 条 / 本机共 M 条"。
  • 探测失败的那一栏显示中文病因,title 里是原始错误;探测刷新时间挪到刻度行右侧(5/5 成功 · 11:09)。

测试与工具

  • tools/test_diag.py:14 组构造证据过归因判定 + 9 组异常过分类,离线、不发包、秒级跑完。
    含"没有代理客户端"两例、"壳在但没连节点"、"能连控制器但隧道 0 条连接"、"隧道里有连接却打不通(仍报红)"。
    每条用例自己 patch 客户端身份,结论与本机装的客户端无关。
  • tools/test_estats.py:eStats 结构体核对(20 / 1 / 96 字节,字段顺序)+ 普通权限退化
    • 管理员下真读一次(自己开一条连接,验证字节在涨)。
  • tools/test_xray.py:用构造的 v2rayN 配置 + 假统计口验证解析与出口级分账。
  • tools/mock_state.py 支持 MOCK_DIAG=ok|target|vpn|link|dns|nopx、MOCK_HOST=1、MOCK_HOST=1 MOCK_ELEV=1,
    四张示意图都能复现。
  • 新增 docs/panel.png / docs/panel-xray.png / docs/panel-host.png / docs/panel-host-admin.png 四张示意图。
  • start.ps1 非管理员时打一行提示,告诉你右键提权能多看到什么。

文档

  • README 重写:判定五档的真实触发条件、两条泳道各字段的含义、分账怎么算、
    客户端支持矩阵(判定 / 节点名 / 逐条连接 / 字节流量四列)、四种可见度、
    两种权限的差别(本机模式)、数据来源表、快照字段表、隐私声明、排障表、
    以及按主题重排的 19 条边界(权限与可见度 / 精度 / 适配 / 诊断 / 平台)。
  • 修掉几处与代码不符的说法:flow 的真实取值("" / xray / host)、
    并不存在的 FLOW_MIXED / FLOW_SITES 环境变量、以及"本机模式完全拿不到字节数"(管理员下能拿)。

v0.1.1

Choose a tag to compare

@7icence1Z 7icence1Z released this 12 Nov 02:59

从 v0.1.1 起,FLOW 不再只认 mihomo:Clash 系、sing-box、v2rayN/Xray、WireGuard 这些装哪个都能看。

一句话概括:这不只是“用了多少流量”,而是“这些字节最终从哪条路、哪个 IP 出去,某个域名走的是隧道还是直连”。

新增

  • 客户端自动发现(providers.py,纯标准库)。发现链:netstat 端口归属 → WMI 进程表 →
    探 GET /version 认 Clash 系 API → 从内核命令行抠 -f/-c/--config/-d 找配置 → 解析 proxies: / outbounds。
    覆盖 mihomo、Clash Verge、Clash for Windows、Mihomo Party、FlClash、sing-box(开了 clash_api)、
    v2rayN / Xray / NekoRay、WireGuard、OpenVPN、深信服、Tailscale;认不出的客户端直接用 exe 名显示,不写“未知”。
  • v2rayN / Xray 的出口级流量。 读它生成的 guiConfigs/config.json 里的 metrics.listen,
    对 GET /debug/vars 的 stats.outbound 做 1 Hz 差分,得到“经代理 / 直连”两条精确曲线。
    精确到字节,但粒度是出口不是域名 —— Xray 不暴露连接表,面板就明说,不拿总数去凑域名。
  • 节点名解析:显示软件自己的叫法(🇯🇵 东京-01、SG-02),三级回退
    (控制器 now → 连接链 → 出口 IP 反查配置里的 server);v2rayN 的备注从 guiNDB.db 只读反查。
  • 订阅感知:Clash 系读 /providers/proxies(名称 / 更新时间 / 流量 / 到期),
    拉平成一个大 yaml 的客户端则盯配置内容指纹,节点表一变就刷新。
  • 服务端保存 120 帧历史,面板一打开就有两分钟曲线,不用空等。

界面

  • 配色改为语义三色(琥珀 = 走 VPN / 青 = 直连 / 红 = 不通),曲线、泳道底色、站点小图、标签都跟着实际生效的路径变色。
  • 卡片头显示客户端身份与订阅新鲜度。
  • 两路泳道:本机 → 实际承载的网卡 → 节点 → 出口 IP;网卡按内核路由判定,不是按名字猜。
  • 双上行(有线走隧道、Wi-Fi 走直连)时两条泳道显示不同网卡,页脚补一句“直连走 WLAN”。
  • 面板改成一扇独立的应用窗口(Edge/Chrome 的 --app,独立 profile):没有地址栏和标签页,
    不再交给系统默认浏览器,也不碰你日常浏览器的登录和历史。

无障碍

  • 补 color-scheme: dark,表单控件与滚动条不再刺眼。
  • 品牌改 <h1>;域名输入框补 aria-label / name / inputmode;所有按钮补 type="button";
    outline:none 换成 :focus-visible 焦点环;底部提示换成 role="status" aria-live="polite"。

修复

  • 中英文 Windows 上 netsh / WMI 输出编码不一致,含中文目录的配置读不到。
  • 内核进程名带后缀(mihomo-windows-amd64)时认不出内核,软件名退化成内核名。
  • 订阅接口返回空壳 provider 时,把 0001-01-01 当成“更新时间”显示。
  • start.ps1 存成无 BOM 的 UTF-8 时,PowerShell 5.1 按 GBK 解析,中文里的引号会让整个脚本报语法错。
  • start.ps1 -Port 只改了窗口地址、没传给采集器,换端口必然连不上。
  • -Stop 只认“命令行带仓库绝对路径”的采集器,从本目录用 pythonw server.py 起的那个杀不掉。

文档

  • README 重写:判定四档的真实触发条件、客户端支持矩阵、三种可见度(连接级 / 出口级 / 只有网卡)、
    快照字段表、隐私声明、排障表。
  • 新增 docs/panel-xray.png(v2rayN 结构示意),两张示意图都是演示数据。
  • tools/ 下 peek.py(命令行看快照)、mock_state.py(生成示意图)、test_xray.py(v2rayN 适配自检)随仓库发布。

安装

Windows 10/11 + Python 3.10+,只用标准库,不需要 pip install:

git clone https://github.com/7icence1Z/flow-tracking.git
cd flow-tracking
.\start.cmd

或者直接下本页的 Source code (zip) 解压,双击 start.cmd。

已知边界

  • Xray 只到出口级字节,没有逐域名数据;WireGuard / OpenVPN 这类只有网卡与出口 IP。
  • v2rayN 适配依据它生成配置的格式,用构造样本 + 假统计口验证过,未覆盖它的所有版本。
  • 只支持 Windows(依赖注册表、WMI、netsh、GetIfTable2)。
  • TUN 模式打开时,“网卡”会变成 TUN 虚拟网卡,泳道展示的是隧道入口而非物理出口。