From 74edf51a75b33e5417fc2af1c0f3b69c397ccb87 Mon Sep 17 00:00:00 2001
From: iorebuild <iorebuild@linuxacme.com>
Date: Thu, 30 Apr 2026 12:53:05 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0README=EF=BC=8C?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8EWindows/Linux=E8=B7=A8=E5=B9=B3=E5=8F=B0?=
 =?UTF-8?q?=E7=BC=96=E8=AF=91=E6=96=B9=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d583e99
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+# AiAnalysis - 16通道AI数据UDP实时采集分析工具
+
+## 功能
+- UDP端口监听，实时接收数据包
+- 解析16通道逗号分隔的ADC数据（格式: `val0,val1,...,val15`）
+- 实时波形绘制，深色主题，16条独立颜色曲线
+- 数据自动保存为CSV（存到 `data_端口号/` 目录）
+- 支持打开历史CSV文件回放查看
+- 滚轮缩放、右键拖拽平移、双击恢复自动范围
+- 通道可见性切换、显示点数可调
+
+## 跨平台支持
+✅ Linux ✅ Windows ✅ macOS
+
+代码纯Qt5编写，无平台特定依赖。
+
+---
+
+## Windows 编译 & 运行
+
+### 准备工作
+1. 下载安装 **Qt 5.15** (MinGW 或 MSVC 版本均支持): https://download.qt.io/archive/qt/5.15/
+   - 安装时勾选 `MinGW` 编译器 或 `MSVC` 编译器
+2. 下载安装 **CMake** (3.14+): https://cmake.org/download/
+   - 安装时勾选 "Add CMake to system PATH"
+
+### 编译（命令行）
+```powershell
+# 在项目目录下
+mkdir build
+cd build
+cmake .. -G "MinGW Makefiles"
+mingw32-make -j4
+# 或使用 MSVC:
+# cmake .. -G "Visual Studio 17 2022"
+```
+
+### 编译（Qt Creator）
+1. 打开 Qt Creator
+2. File → Open File or Project → 选择 `CMakeLists.txt`
+3. 选择对应的 Kit（MinGW 64-bit 或 MSVC）
+4. 点击构建 → 运行
+
+### 直接运行
+编译完成后，`build/AiAnalysis.exe` 即为可执行文件。
+
+---
+
+## Linux 编译
+```bash
+sudo apt install qtbase5-dev cmake g++
+mkdir build && cd build
+cmake ..
+make -j$(nproc)
+./AiAnalysis
+```
+
+## 使用说明
+1. 输入UDP端口号，点击「开始监听」
+2. 下位机通过UDP发送逗号分隔的16通道数据
+3. 右侧面板可切换通道显示/隐藏
+4. 「打开文件」可加载历史CSV数据回放
+5. 鼠标滚轮缩放Y轴，右键拖拽平移，双击恢复自动范围