flowwatch v1.1.0 — 进程流量告警规则引擎

告警规则引擎 + 常驻采集守护：这一版把 flowwatch 从「看当前流量」推进到「按规则盯着流量」。

新增：进程流量告警规则引擎（927c406）

• 按规则盯：给「某个进程 / 某类连接」配阈值（上传 / 下载速率、连接数），超了才提醒；规则存在 alert_rules.json，改完即生效
• 连接数入桶：连接数按时间桶统计，短时突刺不会漏，也不会被单次采样抖动误报
• 单端口界面：界面与 API 同源挂在一个端口上，不用再单独开前端服务（对内存紧张的机器尤其友好：零新增进程）

改进：常驻采集守护（c51decd）

• 常驻采集的守护 + 自启逻辑打磨，长时间运行更稳

工程

• CI：push 必跑「文档与对外材料闸门」（校验脚本 + 红线扫描，含 UTF-8 stdout 兜底与 vendor 跳过规则）
• README 对齐当前进度（架构段补告警层）

升级

沿用即可：拉到最新代码，按 README 的「常驻采集」方式启动（界面直接走常驻服务的端口）。

---

开箱即用（Windows）—— 两个包，按需选一个

包	适合谁	怎么用
flowwatch-v1.1.0-windows.zip	已装 Python 3.10+	解压 → 双击 start.cmd（首次自动 pip install）
flowwatch-v1.1.0-win64-exe.zip	没装 Python / 想零配置	解压 → 双击 flowwatch.exe

两个包都一样：界面与 API 同源在 http://127.0.0.1:8791/（不需要 Node、不需要开两个终端）。

• Npcap 是驱动级依赖，两个包都"不进包"，必须单独安装：https://npcap.com/#download
  未装时界面能开、但没有数据（启动时会直接提示）。
• 助手默认 mock 档（不联网、仍真跑工具与记忆链路）；点面板右上「模型设置」可换成
  任意 OpenAI 兼容 API 或本地 Ollama，保存即生效。
• exe 包的运行期数据（history.db / assistant_memory.db / notes/）就写在 exe 旁边；
  源码包的写在项目目录里（FLOWWATCH_DATA_DIR 可改）。
• 想改前端源码 / HMR 开发：仍按 README 的 python server.py + npm run dev 两端口流程。

v1.0.3

开箱即用（Windows）—— 两个包，按需选一个

包	适合谁	怎么用
flowwatch-v1.0.3-windows.zip	已装 Python 3.10+	解压 → 双击 start.cmd（首次自动 pip install）
flowwatch-v1.0.3-win64-exe.zip	没装 Python / 想零配置	解压 → 双击 flowwatch.exe

两个包都一样：界面与 API 同源在 http://127.0.0.1:8791/（不需要 Node、不需要开两个终端）。

• Npcap 是驱动级依赖，两个包都"不进包"，必须单独安装：https://npcap.com/#download
  未装时界面能开、但没有数据（启动时会直接提示）。
• 助手默认 mock 档（不联网、仍真跑工具与记忆链路）；点面板右上「模型设置」可换成
  任意 OpenAI 兼容 API 或本地 Ollama，保存即生效。
• exe 包的运行期数据（history.db / assistant_memory.db / notes/）就写在 exe 旁边；
  源码包的写在项目目录里（FLOWWATCH_DATA_DIR 可改）。
• 想改前端源码 / HMR 开发：仍按 README 的 python server.py + npm run dev 两端口流程。

v1.0.2

开箱即用（Windows）—— 两个包，按需选一个

包	适合谁	怎么用
flowwatch-v1.0.2-windows.zip	已装 Python 3.10+	解压 → 双击 start.cmd（首次自动 pip install）
flowwatch-v1.0.2-win64-exe.zip	没装 Python / 想零配置	解压 → 双击 flowwatch.exe

两个包都一样：界面与 API 同源在 http://127.0.0.1:8791/（不需要 Node、不需要开两个终端）。

• Npcap 是驱动级依赖，两个包都"不进包"，必须单独安装：https://npcap.com/#download
  未装时界面能开、但没有数据（启动时会直接提示）。
• 助手默认 mock 档（不联网、仍真跑工具与记忆链路）；点面板右上「模型设置」可换成
  任意 OpenAI 兼容 API 或本地 Ollama，保存即生效。
• exe 包的运行期数据（history.db / assistant_memory.db / notes/）就写在 exe 旁边；
  源码包的写在项目目录里（FLOWWATCH_DATA_DIR 可改）。
• 想改前端源码 / HMR 开发：仍按 README 的 python server.py + npm run dev 两端口流程。

v1.0.1

开箱即用（Windows）—— 两个包，按需选一个

包	适合谁	怎么用
flowwatch-v1.0.1-windows.zip	已装 Python 3.10+	解压 → 双击 start.cmd（首次自动 pip install）
flowwatch-v1.0.1-win64-exe.zip	没装 Python / 想零配置	解压 → 双击 flowwatch.exe

两个包都一样：界面与 API 同源在 http://127.0.0.1:8791/（不需要 Node、不需要开两个终端）。

• Npcap 是驱动级依赖，两个包都"不进包"，必须单独安装：https://npcap.com/#download
  未装时界面能开、但没有数据（启动时会直接提示）。
• 助手默认 mock 档（不联网、仍真跑工具与记忆链路）；点面板右上「模型设置」可换成
  任意 OpenAI 兼容 API 或本地 Ollama，保存即生效。
• exe 包的运行期数据（history.db / assistant_memory.db / notes/）就写在 exe 旁边；
  源码包的写在项目目录里（FLOWWATCH_DATA_DIR 可改）。
• 想改前端源码 / HMR 开发：仍按 README 的 python server.py + npm run dev 两端口流程。

flowwatch v1.0.0 - local traffic attribution + read-only assistant

回答一个任务管理器回答不了的问题：这台机器上，哪个进程在跟谁通信、用了多少带宽、从什么时候开始的。

这一版有什么

• 抓包归因（无需管理员）：ctypes 直调系统已装的 Npcap，用连接表把字节数算到进程头上；通配地址走端口回退表，UDP 不丢。
• 30 天历史留档：分钟桶 + 变化事件（出现 / 消失 / 尖峰）+ 域名维度，SQLite 单文件，可连同库一起备份。
• 流量助手（只读 Agent，12 个工具）：面板里直接问本机流量，工具调用过程可见。
  • 证据纪律：结论必须来自工具；首轮零工具调用会被服务端纠正一轮，仍无证据则标注「未核实」；记忆类工具不算数据证据。
  • 点名检索：match 按名字查全量（小写 doubao 能命中 Doubao.exe），同名多进程合并成一行。
  • 进程身份：读 exe 版本资源回答「这是哪个软件」（厂商 / 产品 / 版本），不靠名字猜。
  • 事件按进程名 + 时间窗过滤（pid 会变，名字才稳）；重复提问会剔除历史同题问答，避免复读。
• 隐私边界：默认只发聚合元数据；对端 IP:端口只在明细档注入（明细工具在聚合档压根不交给模型 —— 物理隔离，不是提示词承诺）；本地 Ollama / mock 模式零外发。

演示（本机真实运行录制）

已知边界（如实说）

• 未归因率中位数约 30%（提权进程 / 短连接 / QUIC 等），README《归因质量》一节给了完整口径与测量方法。
• 需要系统已装 Npcap；仅支持 Windows。
• 助手能力取决于你配置的模型（OpenAI 兼容 / Ollama / mock）。

有问题或想法，欢迎 Issue / PR。