gx完成

chenyc

2025-12-10 a85e047fa3f1a04aca4aeb079f06db69a96c8838

gx完成

 HTTP_API_INTEGRATION_GUIDE.md

@@ -76,8 +76,6 @@
# 获取原始格式数据
curl "http://localhost:8080/api/device/data?deviceNumber=D001"

# 获取映射格式数据（推荐）
curl "http://localhost:8080/api/device/data?deviceNumber=D001&mapped=true"
```

**响应示例（映射格式）**:

 Strholp.js

@@ -10,7 +10,7 @@
    var s = time.getSeconds();
    return y + '-' + add0(m) + '-' + add0(d) + ' ' + add0(h) + ':' + add0(mm) + ':' + add0(s);
}
function strToObj(str) {
function strToObj(str, ipAddress) {
    var data = {
        A: str.substring(6, 11),
        B: str.substring(12, 17),
@@ -68,7 +68,8 @@
        C54: str.substring(259, 264),
        C55: str.substring(265, 266),
        suedtime: format(new Date().getTime()),
        deviceType: '东丽'
        deviceType: '东丽',
        IPAddress: ipAddress || ''
    }
    return data
}

 aliyun.json

@@ -1,4 +1,4 @@
{
    "enabled": false,
    "enabled": true,
    "autoRegister": true 
  }

 chenyc.ps

New file
@@ -0,0 +1,27 @@
#!/bin/bash

# 设置变量
user="chenyc"
start_date="2025-01-01T00:00:00"
end_date="2025-12-30T23:59:59"

# 检查当前目录是否是Git仓库
if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
  echo "当前目录不是一个Git仓库。请在Git仓库的根目录下运行此脚本。"
  exit 1
fi

# 获取提交次数
commit_count=$(git log --author="$user" --since="$start_date" --until="$end_date" --pretty=oneline | wc -l)

# 获取代码行数的变化
lines_info=$(git log --author="$user" --since="$start_date" --until="$end_date" --pretty=tformat: --numstat | awk '{ add += $1; del += $2; net += $1 - $2 } END { printf "%s,%s,%s", add, del, net }')
IFS=',' read lines_added lines_deleted lines_changed <<< "$lines_info"

# 输出结果
echo "日期： $start_date ~ $end_date"
echo "用户: $user"
echo "提交次数: $commit_count"
echo "增加的代码行数: $lines_added"
echo "删除的代码行数: $lines_deleted"
echo "净变化的代码行数: $lines_changed"

 convert_to_word.py

New file
@@ -0,0 +1,220 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
将Markdown文档转换为Word格式
"""

import os
from pathlib import Path

try:
    from docx import Document
    from docx.shared import Pt, RGBColor, Inches
    from docx.enum.text import WD_ALIGN_PARAGRAPH
    from docx.oxml.ns import qn
    from docx.oxml import OxmlElement
except ImportError:
    print("正在安装必要的库...")
    os.system("pip install python-docx -q")
    from docx import Document
    from docx.shared import Pt, RGBColor, Inches
    from docx.enum.text import WD_ALIGN_PARAGRAPH
    from docx.oxml.ns import qn
    from docx.oxml import OxmlElement

import re
from datetime import datetime

class MarkdownToWord:
    def __init__(self):
        self.doc = Document()
        self.setup_styles()
    
    def setup_styles(self):
        """设置文档样式"""
        style = self.doc.styles['Normal']
        style.font.name = '宋体'
        style.font.size = Pt(11)
    
    def add_heading(self, text, level=1):
        """添加标题"""
        self.doc.add_heading(text, level=level)
    
    def add_paragraph(self, text=''):
        """添加段落"""
        if text:
            p = self.doc.add_paragraph(text)
            p_format = p.paragraph_format
            p_format.space_before = Pt(6)
            p_format.space_after = Pt(6)
            p_format.line_spacing = 1.5
    
    def add_table_from_markdown(self, lines, index):
        """从Markdown表格创建Word表格"""
        table_lines = []
        i = index
        
        # 收集表格行
        while i < len(lines):
            line = lines[i].strip()
            if not line.startswith('|'):
                break
            table_lines.append(line)
            i += 1
        
        if len(table_lines) < 3:
            return index
        
        # 解析表头
        header = table_lines[0].split('|')[1:-1]
        header = [h.strip() for h in header]
        
        # 创建表格
        table = self.doc.add_table(rows=1, cols=len(header))
        table.style = 'Light Grid Accent 1'
        
        # 添加表头
        hdr_cells = table.rows[0].cells
        for i, cell_text in enumerate(header):
            hdr_cells[i].text = cell_text
            # 设置表头样式
            for paragraph in hdr_cells[i].paragraphs:
                for run in paragraph.runs:
                    run.font.bold = True
                    run.font.name = '宋体'
        
        # 添加数据行（跳过分隔符行）
        for line in table_lines[2:]:
            cells = line.split('|')[1:-1]
            cells = [c.strip() for c in cells]
            row_cells = table.add_row().cells
            for i, cell_text in enumerate(cells):
                row_cells[i].text = cell_text
                for paragraph in row_cells[i].paragraphs:
                    for run in paragraph.runs:
                        run.font.name = '宋体'
        
        return i
    
    def add_code_block(self, language, code):
        """添加代码块"""
        p = self.doc.add_paragraph()
        p.paragraph_format.left_indent = Inches(0.25)
        p.paragraph_format.space_before = Pt(6)
        p.paragraph_format.space_after = Pt(6)
        
        # 代码块背景
        shading_elm = OxmlElement('w:shd')
        shading_elm.set(qn('w:fill'), 'E8E8E8')
        p._element.get_or_add_pPr().append(shading_elm)
        
        # 添加语言标记
        if language:
            run = p.add_run(f'# {language}\n')
            run.font.italic = True
            run.font.size = Pt(9)
        
        # 添加代码
        run = p.add_run(code)
        run.font.name = 'Courier New'
        run.font.size = Pt(9)
    
    def convert_markdown_file(self, input_path, output_path):
        """转换Markdown文件为Word"""
        print(f"正在读取: {input_path}")
        
        with open(input_path, 'r', encoding='utf-8') as f:
            lines = f.readlines()
        
        print(f"文件包含 {len(lines)} 行")
        
        i = 0
        code_block = False
        code_language = ''
        code_lines = []
        
        while i < len(lines):
            line = lines[i].rstrip()
            
            # 处理代码块
            if line.startswith('```'):
                if code_block:
                    # 结束代码块
                    self.add_code_block(code_language, '\n'.join(code_lines))
                    code_block = False
                    code_language = ''
                    code_lines = []
                else:
                    # 开始代码块
                    code_block = True
                    code_language = line[3:].strip()
                i += 1
                continue
            
            if code_block:
                code_lines.append(line)
                i += 1
                continue
            
            # 处理表格
            if line.strip().startswith('|'):
                self.add_table_from_markdown(lines, i)
                # 跳过表格行
                while i < len(lines) and lines[i].strip().startswith('|'):
                    i += 1
                continue
            
            # 处理标题
            if line.startswith('###### '):
                self.add_heading(line[7:], 6)
            elif line.startswith('##### '):
                self.add_heading(line[6:], 5)
            elif line.startswith('#### '):
                self.add_heading(line[5:], 4)
            elif line.startswith('### '):
                self.add_heading(line[4:], 3)
            elif line.startswith('## '):
                self.add_heading(line[3:], 2)
            elif line.startswith('# '):
                self.add_heading(line[2:], 1)
            
            # 跳过分隔符
            elif line.strip() in ['---', '***', '___']:
                self.add_paragraph()  # 空行
            
            # 处理普通段落
            elif line.strip():
                self.add_paragraph(line)
            else:
                self.add_paragraph()  # 空行
            
            i += 1
        
        # 保存Word文档
        print(f"正在保存到: {output_path}")
        self.doc.save(output_path)
        print(f"✓ 转换完成！")
        
        # 返回文件大小
        if os.path.exists(output_path):
            size = os.path.getsize(output_path) / 1024  # KB
            print(f"✓ 文件大小: {size:.1f} KB")
            return output_path
        
        return None

def main():
    workspace = r"d:\gitData\dongli_SocketServer"
    
    # 转换HTTP集成指南
    converter = MarkdownToWord()
    input_file = os.path.join(workspace, "HTTP_API_INTEGRATION_GUIDE.md")
    output_file = os.path.join(workspace, "HTTP_API_INTEGRATION_GUIDE.docx")
    
    if os.path.exists(input_file):
        converter.convert_markdown_file(input_file, output_file)
    else:
        print(f"错误: 未找到文件 {input_file}")

if __name__ == '__main__':
    main()

 homeConfig.json

New file
@@ -0,0 +1,4 @@
{
  "socketPort": 10963,
  "description": "Socket服务器监听端口"
}

 httpConfig.json

@@ -1,5 +1,5 @@
{
    "enabled": true,
    "enabled": false,
    "port": 8080,
    "host": "0.0.0.0",
    "cors": {

 index.js

@@ -10,10 +10,12 @@
const mqttConfigPath = path.join(appPath, 'mqtt.json');
const aliyunConfigPath = path.join(appPath, 'aliyun.json');
const httpConfigPath = path.join(appPath, 'httpConfig.json');
const homeConfigPath = path.join(appPath, 'homeConfig.json');

const mqttConfig = JSON.parse(fs.readFileSync(mqttConfigPath, 'utf8'));
const aliyunConfig=JSON.parse(fs.readFileSync(aliyunConfigPath, 'utf8'))
const aliyunConfig = JSON.parse(fs.readFileSync(aliyunConfigPath, 'utf8'));
const httpConfig = JSON.parse(fs.readFileSync(httpConfigPath, 'utf8'));
const homeConfig = JSON.parse(fs.readFileSync(homeConfigPath, 'utf8'));


console.log(aliyunConfig)
@@ -67,7 +69,12 @@
    }

    handleDevice(socket) {
        const deviceId = socket.remoteAddress + ':' + socket.remotePort;
        // 处理 IPv6 映射 IPv4 地址 (::ffff:127.0.0.1 -> 127.0.0.1)
        let remoteAddress = socket.remoteAddress;
        if (remoteAddress.startsWith('::ffff:')) {
            remoteAddress = remoteAddress.slice(7); // 移除 ::ffff: 前缀
        }
        const deviceId = remoteAddress + ':' + socket.remotePort;
        logger.info(`建立新连接: ${deviceId}`);

        const deviceInfo = {
@@ -190,9 +197,11 @@
        deviceInfo.lastAck = Date.now();

        try {
            const masData = toModel(message);
            const ipAddress = deviceId
            const masData = toModel(message, ipAddress);
            deviceInfo.iotDeviceNo = masData.n;
            deviceInfo.masData = masData;
            
            
            // ✅【新增】缓存数据到内存（按设备序号）
            dataCache.setDeviceData(masData.n, masData);
@@ -325,7 +334,7 @@
    manager.handleDevice(socket);
});

const PORT = process.env.PORT || 10961;
const PORT =  homeConfig.socketPort || 10961;
server.listen(PORT, () => {
    logger.info(`Socket 服务已启动，监听超级端口: ${PORT}`);
});

 mqtt.json

@@ -1,5 +1,5 @@
{
    "enabled": false,
    "enabled": true,
    "brokerUrl": "mqtt.ihemodialysis.com",
    "port": 62283,
    "username": "data",

 配置文件说明.md

New file
@@ -0,0 +1,593 @@
# 配置文件说明文档

**版本**: v1.1.0  
**最后更新**: 2025-12-10

---

## 📋 目录

1. [概述](#概述)
2. [homeConfig.json](#homeconfigjson)
3. [mqtt.json](#mqttjson)
4. [httpConfig.json](#httpconfigjson)
5. [aliyun.json](#aliyunjson)
6. [schema.json](#schemajson)
7. [常见问题](#常见问题)

---

## 概述

系统使用多个 JSON 配置文件来管理不同模块的参数。所有配置文件都应该放在应用程序的根目录中。

### 配置文件加载优先级

```
当前工作目录 (开发环境)
        ↓
可执行文件所在目录 (pkg 打包环境)
        ↓
硬编码默认值
```

### 环境变量覆盖

某些配置可以通过环境变量覆盖：

```bash
# Socket 服务端口
PORT=10961 npm start

# HTTP 服务端口
HTTP_PORT=8080 npm start
```

---

## homeConfig.json

**用途**: Socket 服务器和主服务配置

**位置**: 应用程序根目录

**优先级**: 环境变量 > homeConfig.json > 默认值

### 完整配置示例

```json
{
  "socketPort": 10961,
  "description": "Socket服务器监听端口"
}
```

### 配置字段说明

| 字段 | 类型 | 默认值 | 说明 | 示例 |
|------|------|--------|------|------|
| `socketPort` | number | 10961 | Socket服务器监听的端口号 | 10961 |
| `description` | string | - | 配置文件描述（可选） | Socket服务器监听端口 |

### 使用方式

```javascript
// 在 index.js 中
const homeConfig = JSON.parse(fs.readFileSync(homeConfigPath, 'utf8'));
const PORT = process.env.PORT || homeConfig.socketPort || 10961;
```

### 修改示例

```json
{
  "socketPort": 9999,
  "description": "自定义Socket服务器监听端口"
}
```

---

## mqtt.json

**用途**: MQTT 消息队列服务配置

**位置**: 应用程序根目录

**依赖包**: `mqtt@5.13.3`

### 完整配置示例

```json
{
  "enabled": true,
  "brokerUrl": "mqtt://127.0.0.1:1883",
  "clientId": "dialysis-server-01",
  "username": "admin",
  "password": "admin123",
  "keepalive": 60,
  "reconnectPeriod": 5000,
  "defaultTopicPrefix": "device/data",
  "qos": 1,
  "retain": false
}
```

### 配置字段说明

| 字段 | 类型 | 默认值 | 说明 | 示例 |
|------|------|--------|------|------|
| `enabled` | boolean | true | 是否启用 MQTT 功能 | true/false |
| `brokerUrl` | string | mqtt://127.0.0.1:1883 | MQTT Broker 服务器地址 | mqtt://192.168.1.100:1883 |
| `clientId` | string | dialysis-server-01 | MQTT 客户端 ID（需唯一） | device-server-01 |
| `username` | string | admin | MQTT 连接用户名 | mqtt_user |
| `password` | string | admin123 | MQTT 连接密码 | secure_password_123 |
| `keepalive` | number | 60 | 心跳间隔（秒） | 60 |
| `reconnectPeriod` | number | 5000 | 重连间隔（毫秒） | 5000 |
| `defaultTopicPrefix` | string | device/data | MQTT 主题前缀 | device/dialysis |
| `qos` | number | 1 | QoS 级别（0/1/2） | 1 |
| `retain` | boolean | false | 消息是否保留 | false |

### 使用方式

```javascript
// 在 index.js 中
const mqttConfig = JSON.parse(fs.readFileSync(mqttConfigPath, 'utf8'));

if (mqttConfig.enabled) {
    const topic = `${mqttConfig.defaultTopicPrefix}/${deviceNo}`;
    publishMessage(topic, payload);
}
```

### 常见场景

#### 场景1：禁用 MQTT
```json
{
  "enabled": false
}
```

#### 场景2：使用云端 MQTT（如阿里云）
```json
{
  "enabled": true,
  "brokerUrl": "mqtt://mqtt.aliyuncs.com:1883",
  "username": "xxxxx@instance123|securemode=2,signmethod=hmacsha256",
  "password": "your_password",
  "clientId": "device_client_id"
}
```

---

## httpConfig.json

**用途**: HTTP API 服务器配置

**位置**: 应用程序根目录

### 完整配置示例

```json
{
  "port": 8080,
  "host": "0.0.0.0",
  "cors": {
    "enabled": true,
    "origin": "*"
  },
  "rateLimit": {
    "enabled": true,
    "singleDeviceInterval": 5000,
    "allDevicesInterval": 60000
  },
  "propertyMapping": {
    "enabled": true,
    "useEmbeddedSchema": true
  },
  "cache": {
    "enabled": true
  }
}
```

### 配置字段说明

#### 基础配置

| 字段 | 类型 | 默认值 | 说明 | 示例 |
|------|------|--------|------|------|
| `port` | number | 8080 | HTTP 服务器监听端口 | 8080 |
| `host` | string | 0.0.0.0 | 服务器绑定地址（0.0.0.0 表示所有网卡） | 127.0.0.1 |

#### CORS 配置

| 字段 | 类型 | 默认值 | 说明 | 示例 |
|------|------|--------|------|------|
| `cors.enabled` | boolean | true | 是否启用 CORS 跨域 | true |
| `cors.origin` | string | * | 允许的来源（* 表示所有） | https://example.com |

#### 限流配置

| 字段 | 类型 | 默认值 | 说明 | 备注 |
|------|------|--------|------|------|
| `rateLimit.enabled` | boolean | true | 是否启用限流 | 生产环境建议启用 |
| `rateLimit.singleDeviceInterval` | number | 5000 | 单个设备查询限流间隔（毫秒） | 同一设备 5 秒最多 1 次 |
| `rateLimit.allDevicesInterval` | number | 60000 | 全局查询限流间隔（毫秒） | 所有设备 60 秒最多 1 次 |

#### 属性映射配置

| 字段 | 类型 | 默认值 | 说明 | 备注 |
|------|------|--------|------|------|
| `propertyMapping.enabled` | boolean | true | 是否启用属性映射 | 推荐启用 |
| `propertyMapping.useEmbeddedSchema` | boolean | true | 是否使用内嵌 schema | false 时使用 schema.json |

#### 缓存配置

| 字段 | 类型 | 默认值 | 说明 | 备注 |
|------|------|--------|------|------|
| `cache.enabled` | boolean | true | 是否启用数据缓存 | 建议启用以提升性能 |

### 使用方式

```javascript
// 在 httpServer.js 中
const httpConfig = JSON.parse(fs.readFileSync(httpConfigPath, 'utf8'));
const server = http.createServer((req, res) => {
    if (httpConfig.cors.enabled) {
        res.setHeader('Access-Control-Allow-Origin', httpConfig.cors.origin);
    }
});
```

### 修改示例

#### 仅本地访问
```json
{
  "port": 8080,
  "host": "127.0.0.1",
  "cors": {
    "enabled": false
  }
}
```

#### 生产环境高性能配置
```json
{
  "port": 8080,
  "host": "0.0.0.0",
  "cors": {
    "enabled": true,
    "origin": "https://your-domain.com"
  },
  "rateLimit": {
    "enabled": true,
    "singleDeviceInterval": 5000,
    "allDevicesInterval": 60000
  },
  "cache": {
    "enabled": true
  }
}
```

---

## aliyun.json

**用途**: 阿里云 IoT 平台集成配置

**位置**: 应用程序根目录

**依赖包**: `aliyun-iot-device-sdk`

### 完整配置示例

```json
{
  "enabled": true,
  "region": "cn-shanghai",
  "productKey": "your_product_key",
  "description": "阿里云IoT设备连接配置（需从阿里云控制台获取）"
}
```

### 配置字段说明

| 字段 | 类型 | 默认值 | 说明 | 示例 |
|------|------|--------|------|------|
| `enabled` | boolean | true | 是否启用阿里云功能 | true/false |
| `region` | string | cn-shanghai | 阿里云服务区域 | cn-shanghai, cn-beijing |
| `productKey` | string | - | 阿里云产品 Key（从控制台获取） | a1xxxxxxxxxxxxb |
| `description` | string | - | 配置说明（可选） | 阿里云IoT配置 |

### 使用方式

```javascript
// 在 index.js 中
const aliyunConfig = JSON.parse(fs.readFileSync(aliyunConfigPath, 'utf8'));

if (aliyunConfig.enabled) {
    // 连接到阿里云 IoT 平台
    const device = aliyunIot.device({
        ProductKey: aliyunConfig.productKey,
        DeviceName: deviceName,
        DeviceSecret: deviceSecret
    });
}
```

### 禁用阿里云

```json
{
  "enabled": false
}
```

### 注意事项

⚠️ **安全提示**:
- 不要将真实的 `productKey` 提交到公开代码仓库
- 生产环境建议使用环境变量替代敏感信息
- 确保配置文件的访问权限受限

---

## schema.json

**用途**: 设备属性 TSL（Thing Specification Language）定义

**位置**: 应用程序根目录

**备注**: 68 个属性的完整定义，与 propertyMapper.js 中的定义同步

### 完整配置示例（部分）

```json
{
  "version": "1.0.0",
  "properties": [
    {
      "identifier": "A",
      "name": "脱水目标量",
      "dataType": "float",
      "accessMode": "r",
      "unit": "kg",
      "description": "患者脱水目标量"
    },
    {
      "identifier": "B",
      "name": "脱水量",
      "dataType": "float",
      "accessMode": "r",
      "unit": "kg",
      "description": "当前已脱水的量"
    },
    {
      "identifier": "R",
      "name": "收缩压下限",
      "dataType": "int",
      "accessMode": "r",
      "unit": "mmHg",
      "description": "血压收缩压下限"
    },
    {
      "identifier": "IPAddress",
      "name": "IP地址",
      "dataType": "string",
      "accessMode": "r",
      "description": "设备连接的IP地址"
    }
  ]
}
```

### 属性字段说明

| 字段 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `identifier` | string | 属性唯一标识符（A-Z, a-z, C53-C55 等） | A, B, C, IPAddress |
| `name` | string | 属性中文名称（用户可读） | 脱水目标量 |
| `dataType` | string | 数据类型（int, float, string, bool） | float |
| `accessMode` | string | 访问模式（r 读, w 写, rw 读写） | r |
| `unit` | string | 单位（可选） | kg, mmHg, bpm |
| `description` | string | 属性描述（可选） | 患者脱水目标量 |

### 完整属性列表（68 个）

详见 `schema.json` 文件的完整内容。主要分类：

- **A-Z** (26 个): 基本生命体征和治疗参数
- **a-z** (26 个): 扩展参数
- **C53-C55** (3 个): 特殊参数
- **特殊字段** (13 个): deviceName, IPAddress, deviceType 等

---

## 常见问题

### Q1: 启动时报错 "找不到配置文件"

**A**: 确保以下文件存在于应用程序同目录：
- `homeConfig.json` ✅
- `mqtt.json` ✅
- `httpConfig.json` ✅
- `aliyun.json` ✅
- `schema.json` ✅

### Q2: 我想禁用某个功能，应该怎么做？

**A**: 在对应的配置文件中设置 `enabled: false`：

```json
// 禁用 MQTT
{ "enabled": false }

// 禁用阿里云
{ "enabled": false }

// 禁用 CORS
{ "cors": { "enabled": false } }
```

### Q3: 配置文件修改后需要重启吗？

**A**: **是的**，需要重启应用程序才能加载新的配置：

```bash
npm run pkg    # 重新打包
npm start      # 重新启动
```

### Q4: 环境变量如何设置？

**A**: 在启动命令前设置环境变量：

```bash
# Windows PowerShell
$env:PORT=10961; npm start

# Windows CMD
set PORT=10961 && npm start

# Linux/Mac
PORT=10961 npm start
```

### Q5: MQTT 连接失败怎么办？

**A**: 检查以下内容：
1. Broker URL 是否正确
2. 用户名和密码是否正确
3. 防火墙是否允许 MQTT 端口（通常 1883）
4. MQTT Broker 服务是否运行

```json
{
  "brokerUrl": "mqtt://your_broker_ip:1883",
  "username": "your_username",
  "password": "your_password"
}
```

### Q6: 如何修改 HTTP 服务端口？

**A**: 修改 `httpConfig.json`：

```json
{
  "port": 8080,
  "host": "0.0.0.0"
}
```

或使用环境变量：

```bash
HTTP_PORT=9000 npm start
```

### Q7: 限流规则是什么？

**A**: 在 `httpConfig.json` 中配置：

```json
{
  "rateLimit": {
    "enabled": true,
    "singleDeviceInterval": 5000,      // 单个设备 5 秒内最多 1 次
    "allDevicesInterval": 60000        // 全部设备 60 秒内最多 1 次
  }
}
```

### Q8: 如何在生产环境中安全地使用配置文件？

**A**: 建议做法：

1. **敏感信息使用环境变量**:
   ```bash
   MQTT_PASSWORD=xxx ALIYUN_KEY=xxx npm start
   ```

2. **配置文件不提交敏感信息**:
   ```json
   {
     "password": "${MQTT_PASSWORD}"
   }
   ```

3. **限制文件权限**:
   ```bash
   chmod 600 homeConfig.json mqtt.json
   ```

4. **定期更新密码**

### Q9: 多个实例如何使用不同的配置？

**A**: 使用环境变量覆盖：

```bash
# 实例 1
PORT=10961 HTTP_PORT=8080 npm start

# 实例 2
PORT=10962 HTTP_PORT=8081 npm start
```

---

## 快速参考表

### 配置文件概览

| 文件名 | 用途 | 必需 | 可禁用 |
|--------|------|:----:|:------:|
| homeConfig.json | Socket 端口配置 | ✅ | ❌ |
| mqtt.json | MQTT 服务配置 | ✅ | ✅ |
| httpConfig.json | HTTP API 配置 | ✅ | ❌ |
| aliyun.json | 阿里云 IoT 配置 | ✅ | ✅ |
| schema.json | 属性定义 | ✅ | ❌ |

### 服务启动流程

```
启动应用
  ↓
读取 homeConfig.json → 启动 Socket 服务
  ↓
读取 mqtt.json → 初始化 MQTT（若启用）
  ↓
读取 httpConfig.json → 启动 HTTP 服务
  ↓
读取 aliyun.json → 连接阿里云（若启用）
  ↓
读取 schema.json → 初始化属性映射
  ↓
系统运行 ✅
```

---

## 更新日志

### v1.1.0 (2025-12-10)
- 新增 `homeConfig.json` Socket 端口配置
- 更新所有配置文件说明
- 添加常见问题解答
- 增加安全建议

### v1.0.0 (2025-12-08)
- 初始版本

---

**最后更新**: 2025-12-10  
**版本**: v1.1.0  
**维护者**: 技术团队