# 两线助手-客户端 v1.0.0

> **NetInsight 网络洞察智析平台** · 首发版本  
> 发布日期：2026-06-02 · 平台：Windows 桌面端

---

## 📋 精简版（适合版本列表 / 更新提示）

两线助手-客户端首个正式版本 —— 一体化网络诊断 + AI 智能研判，覆盖**普通运维**与**直播保障**双场景。

**首发功能**
- 🤖 **AI 智能诊断** —— 自动汇总数据、研判出报告，支持追问
- 🎬 **双场景** —— 普通运维 / 直播保障一键切换
- ⚡ **速率 · 时延 · 资源** —— 上下行测速、时延抖动丢包、CPU/内存等终端资源监控
- 💡 **光网诊断** —— 私网 IP 直查光口质态、光功率、套餐与拓扑
- 🛰 **路由追踪** —— 快速逐跳 + 精准多路径质量评估
- 📺 **直播诊断** —— 抓包分析码率 / 重传 / RTT，内置抖音、B 站等平台预设
- 📄 **报告管理** —— 诊断结果统一归档，筛选备注，一键导出 PDF

**一句话版本**  
🎉 两线助手-客户端 v1.0.0 正式发布！一体化网络诊断 + AI 智能研判，支持普通运维与直播保障双场景，测速、时延、资源、光网、路由、直播全模块上线。

---

## 📖 完整版（适合发布页 / 详细说明）

## 产品简介

两线助手-客户端是一款面向**网络运维**与**直播保障**的桌面端一体化诊断工具。从链路质量、终端资源、光网状态、路由路径到直播流量，提供全链路诊断能力，并由 **AI 综合研判**、一键生成可归档的诊断报告。

## ✨ 核心亮点

- 🤖 **AI 智能诊断** —— 自动汇总多模块数据，智能研判输出报告，支持诊断后追问
- 🎬 **双场景自适应** —— 普通运维 / 直播保障，界面与指标随场景切换
- 💡 **光网直连诊断** —— 凭私网 IP 直查光口质态、光功率、套餐与拓扑
- 🛰 **双模式路由追踪** —— 快速逐跳 + 精准多路径质量评估
- 📄 **报告全程闭环** —— 诊断即归档，可筛选、备注、导出 PDF

## 功能模块

### 🏠 首页总览
- 一屏掌握设备信息（系统 / CPU / 内存 / 网卡 / IP / DNS）与当前网络状态
- 自动识别活跃网卡与双线接入，Wi-Fi 接入额外显示信号质量
- 一键「全面体检」，输出网络健康评分

### ⚡ 速率检测
- 实时测量上行 / 下行速率，双曲线呈现过程波动
- 测速节点可自定义，检测完成自动归档报告

### 📶 时延检测
- 多站点时延、抖动、丢包统计，实时 RTT 曲线
- 检测站点可按场景灵活启用

### 📊 资源监控
- CPU / GPU / 内存 / 磁盘 / 网络吞吐实时监控，24 小时趋势图
- CPU / 内存 TOP 进程列表，快速定位资源抢占
- 辅助判断网络体验异常是否源于本机负载

### 💡 光网诊断
- 基于私网 IP 直查光口质态、ONU / PON 收发光功率、上下行光衰
- 覆盖账号套餐、网络拓扑（OLT / PON 口 / 分光比）、流量与在线状态
- 自动探测私网 IP，失败可手动填写

### 🛰 路由追踪（快速 + 精准）
- **快速模式**：系统级逐跳追踪，实时跳数表，目标地址随时可改
- **精准模式**：多路径探测，路径质量 Q 分、稳定性判定、异常节点告警
- 逐跳显示 IP 归属地

### 🎬 直播诊断
- 实时抓取直播流量，分析码率、稳定性、重传 / 丢包、RTT、抖动
- 内置抖音直播、B 站直播、通用 RTMP 平台预设，支持自定义域名 / IP
- 自动识别推流进程，流详情展示 IP 归属与进程名

### 🤖 AI 智能诊断
- 支持**实时诊断**与**历史诊断**两种模式，自动汇总跨模块数据
- AI 流式研判，输出结构化诊断报告
- 报告生成后可开启对话，围绕本次结果继续追问

### 📄 报告管理
- 测速 / 时延 / 路由 / 精准探测 / 光网 / AI 报告统一归档
- 按场景、时间范围、关键词筛选，支持备注
- 一键导出 PDF，支持单条或批量导出

### ⚙️ 系统设置
- 测速节点、时延站点、资源采样、路由参数、AI、直播预设全可配置
- 数据入库间隔可调，平衡精度与存储
- 支持按模块或全量一键清理历史数据

## 🛠 通用能力

- **后台运行** —— 测速 / 时延 / 资源 / 路由任务离开页面不中断
- **本地数据持久化** —— SQLite 本地存储，默认保留 72 小时
- **Npcap 自动安装** —— 直播诊断 / 精准路由缺少抓包驱动时一键安装
- **IP 归属地** —— 路由与直播流量自动标注地理归属

## 运行环境

- Windows 桌面环境
- 直播诊断 / 精准路由追踪依赖 **Npcap**（内置一键安装）
- AI 智能诊断需在「设置」中配置可用的 API

---

## 📌 注意事项

1. ⚠️ **报告导出格式**：当前版本导出为 PDF 格式，通过系统保存对话框选择存储位置
2. ⚠️ **数据保留策略**：默认保留 72 小时历史数据，可在「设置 > 数据管理」按模块清理
3. ⚠️ **直播诊断权限**：首次使用需安装 Npcap 驱动，部分安全软件可能拦截，需手动放行

---

## 📥 下载与安装

**技术支持**：通过微信群联系项目组

---

## 🔮 后续计划

- 应用内自动更新检测
- 更多直播平台预设支持
- 历史数据趋势分析
- 更丰富的 AI 诊断场景

---

_本版本是两线助手-客户端的首个正式发布版本，感谢所有参与测试与反馈的用户！_
