快速开始

从源码构建到第一次流量对比,约十分钟。

环境要求

准备好三样工具,其余交给构建脚本。

Rust 1.91+

workspace 使用 edition 2024,需要较新的稳定版工具链。

Node.js 与 npm

前端构建依赖,Node 18+ 即可。

Tauri CLI

仅开发桌面端需要,安装后 cargo tauri 可用。

获取与构建

克隆仓库,一次构建整个 workspace,再装前端依赖。

git clone <仓库地址> && cd mydiff
cargo build --workspace
cd apps/desktop && npm install && cd ../..

选择你的入口

同一套 Rust 核心能力,按场景挑选最顺手的打开方式。

桌面工作台

推荐

图形界面,首次启动创建管理员账号。

cd apps/desktop && cargo tauri dev

浏览器 + HTTP 一键脚本

同时拉起后端(默认 127.0.0.1:3000)与前端 dev server(端口 1420), Ctrl+C 同停;--daemon 后台运行。

./scripts/dev-web.sh

HTTP 服务

浏览器模式 API 服务,可用 FLOWLENS_HOST / FLOWLENS_PORT / FLOWLENS_CORS_ORIGINS 调整。

cargo run -p flowlens-server

CLI 零配置体验

无需项目,直接对比两个 HAR 文件;加 --json 输出结构化结果。

cargo run -p flowlens-cli -- compare left.har right.har

MCP 服务(接入 AI 客户端)

面向 AI 客户端的 agent 协议入口,stdio 模式开箱即用,--http 启用 Streamable HTTP 传输(默认 127.0.0.1:3100)。

cargo run -p flowlens-mcp-bin --bin flowlens-mcp            # stdio 模式
cargo run -p flowlens-mcp-bin --bin flowlens-mcp -- --http  # Streamable HTTP

第一次流量对比

桌面工作台上的四步首跑,从建账号到锁定差异。

创建管理员并登录

首次启动桌面工作台或访问 HTTP 服务,按引导创建管理员账号并登录。

创建或打开项目

项目路径是账号内逻辑路径,存储层自动映射到隔离的物理目录。

导入两侧流量并分析

进入「流量对比」,左右各选择一个流量文件(HAR / JSONL / Burp XML / PCAP 等),点击「分析 HTTP」。

复核配对与差异

在 HTTP 语义视图复核配对与字段差异,锁定正确配对后可调参重跑。

进阶三步

从单次对比走向常态化分析:基线、发现、AI 协同。

构建基线

在「基线」页用正常样本构建基线模型,沉淀字段统计画像。

启动异常扫描

在「异常发现」页选择目标 Session 启动扫描,规则 / 统计 / 序列 / 内置检查四类信号协同评分。

交给 AI 助手

在「AI 助手」页用自然语言下达调查任务(需先在设置页配置 AI provider)。

数据与日志

数据留在本机,账号隔离,日志可按需调参。

数据目录默认在 ./flowlens-data,随项目自包含,不污染系统路径。
账号隔离账号项目按逻辑路径映射到 accounts/<account-id>/projects/<digest>/,物理路径互不可见。
日志控制运行时日志可用 RUST_LOGFLOWLENS_LOG_FORMATFLOWLENS_LOG_DESTINATION 控制,桌面端日志始终写 <数据根>/logs/