Repository navigation
Releases
v0.1.5 — 节点名与出口归属:名字只来自证据,判不出就不编
这一版只做一件事:节点名与出口归属说真话 —— 名字只来自证据,判不出就不编。
「连日本节点却显示 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 秒、稳态不再起子进程
先修两个"面板看起来不对劲"的问题 —— 顶栏「采集器未连接」闪一下又灭、曲线一秒一跳、像折线;
再把探测设置搬上面板、补一套英文界面;最后把常态开销压下来 —— 不再定期唤醒子进程。
新增
- 探测目标可以在面板上改。卡头多了个 ✎:探测目标、对照目标、间隔(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(netsh133 ms) - 网关探活:
IcmpSendEcho,单次约 8 ms(ping.exe71 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:在转发就说在转发 + 经本地口计数
修的是 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 — 诊断结论 + 本机模式 + 流量分账
这一版把面板从"给你三行探测结果"推到"告诉你到底该怀疑谁",同时补上两个长期缺口:
没开 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
从 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 虚拟网卡,泳道展示的是隧道入口而非物理出口。