LOCAL DATA / CLASH VERGE + MIHOMO

流量去了哪里，
留一本自己的账。

记录 Mihomo 的连接字节增量，尽可能归因到应用和目标，保存在本地 SQLite。让每天的用量有历史，让一次异常有证据。

开始记账查看公开发行版 ↗

本地账本 · 可追溯流量　/　源码公开

Clash Verge Traffic Ledger

本地流量账本

SQLite

示例账本 · 本日已记录

15.7GB

BBrowser11.2 GB

EEditor3.4 GB

+Other1.1 GB

记录方式示意 · 用量为演示数据，不是产品实测或实时账本

Python 3.11+运行时零第三方依赖

SQLite数据保存在本地

从现在开始记录未来的采样流量

CLI + Skill面向 Agent 的查询与审计

MADE FOR EVERYDAY USE

不只看数字，还看它从哪来。

记录、归因、覆盖和证据一起看，才能知道一个用量结论有多可靠。

把瞬时流量，留下来。

按连接采样字节增量，保存原始明细与每日汇总。已有连接建立基线，避免把启动之前的流量算进来。

应用与目标，一起核对。

优先使用 Mihomo 进程元数据，必要时结合本机可见套接字归因。无法确定的来源标为 unknown，并报告覆盖缺口。

让 Agent 回答得有依据。

通过 CLI 和随项目提供的 Skill 查询健康、用量、审计与证据。审计使用只读访问，数据维护默认先预览。

从这里，建立自己的工作流。

LOCAL TOOL · CLEAR BOUNDARIES

01 / CONNECT

连接本地控制器

支持 Clash Verge 服务套接字与 Mihomo 控制器。

02 / RECORD

持续保存字节增量

保留明细和汇总，让日常使用有连续记录。

03 / EXPLAIN

沿着证据查询

把应用、目标与归因覆盖放回同一段时间。

GET STARTED

把这件小事，
交给合适的工具。

上面的命令安装公开的 0.3.0 wheel，并只读检查控制器。需要开始采样或安装登录服务时，继续按仓库指南操作。Skill 在源码仓库内提供。

阅读完整指南 ↗

给 CODING AGENT 的提示词

请阅读 https://github.com/timmyagentic/clash-verge-traffic-ledger 的 README 和项目 Skill，帮我选择当前公开发行版或源码候选，检查本地控制器与账本状态。开始采样前说明数据目录，不改代理规则或清理历史。

手动操作 / 只读检查示例

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install https://github.com/timmyagentic/clash-verge-traffic-ledger/releases/download/v0.3.0/clash_verge_traffic_ledger-0.3.0-py3-none-any.whl
python3 -m clash_verge_traffic_ledger doctor

当前公开发行版为 v0.3.0。默认分支的 0.4.0rc1 是未发布候选，包含新的查询契约与仪表盘。选择源码候选不等于升级了已安装服务。

KNOW BEFORE YOU START

把边界，
也说清楚。

使用前了解版本、兼容范围与数据含义。
有具体问题，欢迎在 GitHub 提交反馈。

能还原安装前的流量吗？

不能。它从采样开始记录未来的连接字节增量，无法从缺少字节计数的旧日志中还原精确历史。

unknown 是否说明有可疑流量？

不一定。unknown 首先表示进程归因的覆盖缺口；高用量或周期性连接也不是恶意软件结论，需要结合时间、目标与上下文核对。

会改动代理规则或上传账本吗？

采样与审计面向控制器读取和本地 SQLite，不负责修改路由规则。内置 Web 页面只读且面向本地，网站也不会连接你的控制器或读取账本。

清理历史会保留哪些数据？

维护命令默认先预览。明确应用清理后，旧原始明细可能无法再下钻；每日汇总按命令约定保留。执行前应阅读相应版本的保留和备份说明。

流量去了哪里，留一本自己的账。