# Vibe Codiing - 基于Electron开发的CSV波形查看软件

**Repository Path**: douhao/Electron-CSV-wave-viewer

## Basic Information

- **Project Name**: Vibe Codiing - 基于Electron开发的CSV波形查看软件
- **Description**: Vibe Coding - 基于Electron开发的高效CSV波形查看软件，适用于数据可视化与分析。
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 振动数据处理软件 - 使用说明

## 📖 快速开始

### 1. 启动软件

双击运行程序，或执行以下命令：

```bash
cd "D:\华为家庭存储\MyAI\Project\vibration-analyzer"
.\node_modules\electron\dist\electron.exe .
```

### 2. 选择数据文件夹

1. 点击左侧面板的 **"📁 选择文件夹"** 按钮
2. 在弹出的对话框中选择包含 CSV 文件的文件夹
3. 文件列表将自动显示所有 CSV 文件

### 3. 查看数据

- **点击文件** 或按 **↓ 键** 选择要查看的文件
- 右侧自动显示波形图和数据表格
- 顶部显示文件元数据信息

---

## 🖥️ 界面说明

### 界面布局

```
┌─────────────────────────────────────────────┐
│  📊 振动数据处理软件 (蓝色标题栏)            │
├──────────────┬──────────────────────────────┤
│              │  [记录号] [次数] [数值] [Z²] │ ← 元数据卡片
│  文件列表     ├──────────────────────────────┤
│  - 无源 0.csv │      📊 波形图区域            │
│  - 无源 1.csv │      (Z 轴振动曲线)           │
│  - 无源 2.csv ├──────────────────────────────┤
│  ...        │      📋 数据表格               │
│              │   (序号/X 轴/Y 轴/Z 轴/计数值)  │
├──────────────┴──────────────────────────────┤
│  文件路径：D:\...\无源 0.csv                 │
└─────────────────────────────────────────────┘
```

### 元数据卡片说明

| 卡片 | 说明 | 来源 |
|------|------|------|
| **记录号** | CSV 文件中的记录编号 | CSV 第一行 |
| **无源上电次数** | 设备无源上电的次数 | CSV 第一行 |
| **当前计数值** | 当前的计数值 | CSV 第一行 |
| **Z 轴平方和** | Z 轴数据的平方和（能量指标） | 计算得出 |

---

## ⌨️ 快捷键

| 按键 | 功能 | 说明 |
|------|------|------|
| **↑** | 上一个文件 | 在文件列表中选择上一个文件 |
| **↓** | 下一个文件 | 在文件列表中选择下一个文件 |
| **Enter** | 确认选择 | 加载选中的文件 |
| **空格** | 确认选择 | 同 Enter 键 |
| **鼠标滚轮** | 滚动列表 | 在文件列表或表格中滚动 |

---

## 📊 波形图操作

### 图表控制按钮

| 按钮 | 功能 | 快捷键 |
|------|------|--------|
| **🔍 放大** | 放大波形图 (1.2 倍) | - |
| **🔍 缩小** | 缩小波形图 (0.8 倍) | - |
| **🔄 重置** | 恢复默认视图 | - |

### 图表元素说明

- **蓝色曲线**: Z 轴振动幅值
- **红色虚线**: 正负阈值线（默认最大值的 1.2 倍）
- **X 轴**: 采样点序号
- **Y 轴**: 振动幅值

### 鼠标交互

- **悬停**: 显示当前点的数值
- **拖拽**: 暂不支持
- **滚轮**: 暂不支持缩放

---

## 📋 数据表格

### 表格列说明

| 列名 | 说明 | 格式 |
|------|------|------|
| **序号** | 数据点序号 | 整数 |
| **X 轴** | X 轴振动值 | 4 位小数 |
| **Y 轴** | Y 轴振动值 | 4 位小数 |
| **Z 轴** | Z 轴振动值 | 4 位小数 |
| **计数值** | 计数值 | 原始值 |

### 表格功能

- **滚动**: 支持垂直和水平滚动
- **高亮**: 超过阈值的行显示浅红色背景
- **悬停**: 鼠标悬停显示深蓝色背景
- **限制**: 最多显示 500 行（避免卡顿）

---

## 📁 CSV 文件格式

### 标准格式

```
记录号：65，无源上电次数：14，当前计数值：0, 00 00 01 00...
序号，X 轴，Y 轴，Z 轴
0, -8, 18, 32
1, -8, 0, 40
2, -8, -6, 38
...
```

### 格式要求

1. **编码**: GBK 编码（中文 Windows 默认）
2. **分隔符**: 逗号 (`,`) 或 制表符 (`\t`)
3. **第一行**: 元数据（记录号、无源上电次数、当前计数值）
4. **第二行**: 表头（序号，X 轴，Y 轴，Z 轴）
5. **第三行起**: 数据行（至少 4 列数值）

### 示例文件

```
data/无源 -20260413082432/无源 0.csv
data/有源 -20260413082457/有源 0.csv
```

---

## ⚙️ 设置与配置

### 阈值设置

当前版本阈值自动计算为最大值的 1.2 倍。

如需自定义阈值，可修改 `data-processor.js` 中的 `calculateThreshold` 函数：

```javascript
function calculateThreshold(maxValue) {
  return maxValue * 1.2;  // 修改 1.2 为其他倍数
}
```

### 窗口大小

修改 `src/main.js` 中的窗口尺寸：

```javascript
mainWindow = new BrowserWindow({
  width: 1400,  // 修改宽度
  height: 900,  // 修改高度
  // ...
});
```

### 表格最大行数

修改 `src/renderer.js` 中的 `maxRows`：

```javascript
const maxRows = Math.min(data.length, 500);  // 修改 500 为其他值
```

---

## ❓ 常见问题

### Q1: 文件列表为空？
**A**: 请确保选择的文件夹中包含 `.csv` 文件，且文件扩展名为小写 `.csv`。

### Q2: 数据显示乱码？
**A**: CSV 文件必须是 **GBK 编码**。如果是 UTF-8 编码，请用记事本打开并另存为 GBK 编码。

### Q3: 波形图不显示？
**A**: 检查 CSV 文件格式是否正确，至少需要 3 行（元数据 + 表头 + 1 行数据）。

### Q4: 程序启动失败？
**A**: 确保已安装所有依赖：
```bash
cd "D:\华为家庭存储\MyAI\Project\vibration-analyzer"
npm install
```

### Q5: 文件排序不正确？
**A**: 程序使用自然排序（数字顺序），如：无源 0, 1, 2...10, 11。如果排序异常，请检查文件名格式。

---

## 🔧 故障排除

### 日志查看

1. 打开开发者工具：`Ctrl + Shift + I`
2. 切换到 **Console** 标签
3. 查看错误信息

### 常见错误

| 错误信息 | 原因 | 解决方案 |
|---------||------|
| `文件格式不正确` | CSV 格式错误 | 检查文件格式是否符合标准 |
| `解析后数据为空` | 无有效数据行 | 确保至少有 1 行数据 |
| `读取文件失败` | 文件被占用 | 关闭其他程序后重试 |

### 重置程序

1. 关闭程序
2. 删除 `node_modules` 文件夹
3. 重新安装依赖：
```bash
npm install
```

---

## 📦 技术依赖

| 依赖 | 版本 | 用途 |
|------|------|------|
| Electron | 28.3.3 | 应用框架 |
| Chart.js | 4.5.1 | 图表绘制 |
| iconv-lite | 0.7.2 | GBK 编码解码 |

---

## 📞 技术支持

### 开发团队
振动数据分析团队

### 文档版本
v1.0

### 最后更新
2026-04-15

### 反馈与建议
如有问题或建议，请联系开发团队。

---

## 📝 更新日志

### v1.0.0 (2026-04-15)
- ✅ 初始版本发布
- ✅ 支持 GBK 编码 CSV 文件
- ✅ 元数据提取和显示
- ✅ 波形图可视化
- ✅ 数据表格展示
- ✅ 键盘导航支持
- ✅ 浅色主题 UI

---

**© 2026 振动数据分析团队. All rights reserved.**