# YZWater3 配置说明

复制 `yzwater-config.template.json` 为 `yzwater-config.json`，按需修改。

## PLC 连接

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `PlcIp` | string | `192.168.0.150` | PLC IP 地址 |
| `PlcPort` | int | `5000` | PLC 端口（西门子 S7 默认 102，本项目配置为 5000） |
| `AutoConnect` | bool | `true` | 启动时是否自动连接 PLC |
| `PlcPollingIntervalMs` | int | `1000` | PLC 轮询间隔（毫秒） |
| `PlcAddresses` | dict | `{}` | PLC 地址覆盖。key=标签名（如 `Tank1Level`），value=地址（如 `VD100`）。留空使用内置默认地址 |

## 报警阈值

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `LevelHighAlarm` | float | `80.0` | 液位高报警值（%） |
| `LevelLowAlarm` | float | `20.0` | 液位低报警值（%） |
| `FlowHighAlarm` | float | `100.0` | 流量高报警值 |
| `FlowLowAlarm` | float | `5.0` | 流量低报警值 |
| `PumpFrequency` | float | `50.0` | 泵频率设置（Hz） |

## 中控通信（WebSocket Hub）

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `RunMode` | string | `Direct` | 运行模式：`Direct`（直连PLC）/ `Server`（PLC+WebSocket服务端）/ `Client`（仅连WebSocket）/ `Mock`（模拟数据） |
| `HubPort` | int | `8765` | WebSocket 服务端监听端口（Server 模式） |
| `HubServerUrl` | string | `""` | WebSocket 服务端地址（Client 模式使用，如 `ws://192.168.1.100:8765`） |
| `HubToken` | string | `""` | Hub 通信令牌（服务端和客户端必须匹配，空字符串表示不验证） |

## 界面设置

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `IsDarkTheme` | bool | `false` | 深色主题（true）/ 浅色主题（false） |
| `IsChinese` | bool | `true` | 中文（true）/ 英文（false） |

## 登录

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `RememberUserName` | bool | `false` | 是否记住登录用户名 |
| `SavedUserName` | string | `""` | 记住的用户名 |

## 项目

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `ActiveProject` | string | `""` | 当前激活的项目名称（对应 `projects/` 目录下的 JSON 文件名，不含后缀）。空字符串使用内置默认配置 |

## 系统信息

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `SystemName` | string | `污水处理监控系统` | 系统显示名称 |
| `CompanyName` | string | `扬州旭轩科技有限公司` | 公司名称 |
| `ContactPerson` | string | `赵经理` | 联系人 |
| `ContactPhone` | string | `18115099090` | 联系电话 |

## 默认账户

首次启动会自动创建管理员账户：

- **用户名**：`admin`
- **密码**：`admin123`

> ⚠️ 首次登录后请立即修改密码！