修复代码问题并更新版本到 v1.0.3

- 修复 config_flow.py 中的 KeyError 风险
- 添加 MQTT broker 地址和端口验证
- 完善翻译文件,添加所有配置字段的中文翻译
- 修复 sensor.py 中的弃用 API 使用
- 改进错误处理,转换失败时设置 available 为 False
- 添加 device_info 中的 sw_version 字段
- 清理 manifest.json 中不必要的 paho-mqtt 依赖
- 修正 README.md 中的路径错误
- 更新版本号到 1.0.3
This commit is contained in:
不求圣剑
2025-10-14 11:51:13 +08:00
parent 3ccf251194
commit 18c47052e6
6 changed files with 45 additions and 21 deletions

View File

@@ -18,7 +18,7 @@
本项目包含两个主要部分:
1. **MQTT 模拟器** (`main.py`) - 模拟发送能源监控数据到 MQTT broker
2. **Home Assistant 自定义集成** (`custom_components/energy_monitor/`) - 接收 MQTT 数据并创建传感器实体
2. **Home Assistant 自定义集成** (`custom_components/JackeryHome/`) - 接收 MQTT 数据并创建传感器实体
## 传感器列表
@@ -161,7 +161,7 @@ entities:
### 核心文件
- `main.py`: MQTT 传感器模拟器主程序
- `custom_components/energy_monitor/`: Home Assistant 自定义集成
- `custom_components/JackeryHome/`: Home Assistant 自定义集成
- `__init__.py`: 集成入口
- `manifest.json`: 集成元数据
- `sensor.py`: 传感器平台实现

View File

@@ -43,16 +43,30 @@ class JackeryHomeConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
errors = {}
if user_input is not None:
# 检查是否已经配置
await self.async_set_unique_id(DOMAIN)
self._abort_if_unique_id_configured()
# 验证 MQTT broker 地址
mqtt_broker = user_input.get("mqtt_broker", "").strip()
if not mqtt_broker:
errors["base"] = "mqtt_broker_required"
_LOGGER.info(f"Creating JackeryHome config entry with topic_prefix: {user_input['topic_prefix']}")
# 验证端口范围
try:
mqtt_port = int(user_input.get("mqtt_port", 1883))
if mqtt_port < 1 or mqtt_port > 65535:
errors["base"] = "invalid_port"
except (ValueError, TypeError):
errors["base"] = "invalid_port"
return self.async_create_entry(
title="JackeryHome",
data=user_input,
)
if not errors:
# 检查是否已经配置
await self.async_set_unique_id(DOMAIN)
self._abort_if_unique_id_configured()
_LOGGER.info(f"Creating JackeryHome config entry with topic_prefix: {user_input.get('topic_prefix', 'homeassistant/sensor')}")
return self.async_create_entry(
title="JackeryHome",
data=user_input,
)
return self.async_show_form(
step_id="user",

View File

@@ -11,8 +11,5 @@
"documentation": "https://github.com/suyulin/jackery_home",
"issue_tracker": "https://github.com/suyulin/jackery_home/issues",
"iot_class": "local_push",
"requirements": [
"paho-mqtt>=1.6.0"
],
"version": "1.0.2"
"version": "1.0.3"
}

View File

@@ -101,7 +101,7 @@ async def async_setup_entry(
)
entities.append(entity)
async_add_entities(entities, True)
async_add_entities(entities)
_LOGGER.info(f"Added {len(entities)} JackeryHome sensors")
@@ -132,6 +132,7 @@ class JackeryHomeSensor(SensorEntity):
"name": "JackeryHome",
"manufacturer": "Jackery",
"model": "Energy Monitor",
"sw_version": "1.0.3",
}
self._topic = f"{topic_prefix}/{sensor_id}/state"
self._attr_native_value = None
@@ -169,7 +170,11 @@ class JackeryHomeSensor(SensorEntity):
try:
value = float(payload)
except ValueError:
# 如果无法转换为数字,保持原值但设置不可用
value = payload
self._attr_available = False
self.async_write_ha_state()
return
# 更新传感器状态
self._attr_native_value = value

View File

@@ -3,14 +3,18 @@
"step": {
"user": {
"title": "配置 JackeryHome",
"description": "设置 MQTT 主题前缀以接收能源监控数据",
"description": "设置 MQTT 连接参数以接收能源监控数据",
"data": {
"topic_prefix": "MQTT 主题前缀"
"topic_prefix": "MQTT 主题前缀",
"mqtt_broker": "MQTT Broker 地址",
"mqtt_port": "MQTT 端口"
}
}
},
"error": {
"already_configured": "该集成已配置"
"already_configured": "该集成已配置",
"mqtt_broker_required": "MQTT Broker 地址不能为空",
"invalid_port": "端口号必须在 1-65535 范围内"
},
"abort": {
"already_configured": "该集成已配置"

View File

@@ -3,14 +3,18 @@
"step": {
"user": {
"title": "配置 JackeryHome",
"description": "设置 MQTT 主题前缀以接收能源监控数据",
"description": "设置 MQTT 连接参数以接收能源监控数据",
"data": {
"topic_prefix": "MQTT 主题前缀"
"topic_prefix": "MQTT 主题前缀",
"mqtt_broker": "MQTT Broker 地址",
"mqtt_port": "MQTT 端口"
}
}
},
"error": {
"already_configured": "该集成已配置"
"already_configured": "该集成已配置",
"mqtt_broker_required": "MQTT Broker 地址不能为空",
"invalid_port": "端口号必须在 1-65535 范围内"
},
"abort": {
"already_configured": "该集成已配置"