docs: 更新问题修复记录 - 添加导入错误修复

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
impressionyang 2026-04-15 19:10:28 +08:00
parent 472fec4a70
commit 9637c7f39d

View File

@ -8,13 +8,22 @@
### 根本原因 ### 根本原因
1. **类型注解错误**`config_flow.py` 使用了小写 `any` 而非 `Any` 1. **类型注解错误**`config_flow.py` 使用了小写 `any` 而非 `Any`
2. **依赖包不存在**`manifest.json` 中引用了不存在的 `bleak-mesh>=0.2.0` 2. **依赖包不存在**`manifest.json` 中引用了不存在的 `bleak-mesh>=0.2.0`
3. **导入错误**`coordinator.py` 从错误的模块导入 `MeshMessageEvent``ProvDeviceEvent`
### 错误日志 ### 错误日志
#### 错误 1: 依赖包不存在
``` ```
homeassistant.requirements.RequirementsNotFound: homeassistant.requirements.RequirementsNotFound:
Requirements for sigmesh_gateway not found: ['bleak-mesh>=0.2.0']. Requirements for sigmesh_gateway not found: ['bleak-mesh>=0.2.0'].
``` ```
#### 错误 2: 导入错误
```
Error occurred loading flow for integration sigmesh_gateway:
cannot import name 'MeshMessageEvent' from 'custom_components.sigmesh_gateway.protocol_parser'
```
### 解决方案 ### 解决方案
#### 修复 1: config_flow.py 类型注解 #### 修复 1: config_flow.py 类型注解
@ -23,9 +32,6 @@ Requirements for sigmesh_gateway not found: ['bleak-mesh>=0.2.0'].
- async def async_step_user(self, user_input: dict[str, any] | None = None) -> FlowResult: - async def async_step_user(self, user_input: dict[str, any] | None = None) -> FlowResult:
+ async def async_step_user(self, user_input: dict[str, Any] | None = None) -> FlowResult: + async def async_step_user(self, user_input: dict[str, Any] | None = None) -> FlowResult:
- async def async_step_init(self, user_input: dict[str, any] | None = None) -> FlowResult:
+ async def async_step_init(self, user_input: dict[str, Any] | None = None) -> FlowResult:
``` ```
#### 修复 2: manifest.json 依赖 #### 修复 2: manifest.json 依赖
@ -34,11 +40,29 @@ Requirements for sigmesh_gateway not found: ['bleak-mesh>=0.2.0'].
+ "requirements": ["pyserial-asyncio-fast>=0.6"], + "requirements": ["pyserial-asyncio-fast>=0.6"],
``` ```
#### 修复 3: coordinator.py 导入
```diff
from .protocol_parser import (
DeviceManager,
DeviceState,
- MeshMessageEvent,
ParsedMeshMessage,
- ProvDeviceEvent,
ProtocolParser,
)
+ from .serial_reader import (
+ MeshMessageEvent,
+ ProvDeviceEvent,
+ SerialReader,
+ )
```
### 提交记录 ### 提交记录
| Commit | 说明 | | Commit | 说明 |
|--------|------| |--------|------|
| 66b86e3 | fix: 修复 config_flow.py 类型注解错误 | | 472fec4 | fix: 修复 coordinator.py 导入错误 |
| e905410 | fix: 修复 manifest.json 依赖错误 | | e905410 | fix: 修复 manifest.json 依赖错误 |
| 66b86e3 | fix: 修复 config_flow.py 类型注解错误 |
### 部署步骤 ### 部署步骤
```bash ```bash