mijiaAPI 3.0.3__tar.gz → 3.0.5__tar.gz

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 本文档记录了项目的v1.3.7以来的重要变更。
 
+## [3.0.5](https://github.com/Do1e/mijia-api/compare/v3.0.4...v3.0.5) - 2026-01-24
+### bugfix
+* 蓝牙设备控制返回 code 为 1 时表示网关已经接收指令，视为成功。
+
+## [3.0.4](https://github.com/Do1e/mijia-api/compare/v3.0.3...v3.0.4) - 2026-01-12
+### bugfix
+* api不可用时不对`available`进行缓存，以修复刷新token成功后依然提示不可用的问题
+
 ## [3.0.3](https://github.com/Do1e/mijia-api/compare/v3.0.2...v3.0.3) - 2026-01-02
 ### new feature
 * 新增 `MIJIA_LOG_LEVEL` 环境变量支持，用于配置 CLI 日志级别

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/FAQ.md

@@ -6,7 +6,8 @@
 
 ## 扫码登录后的有效期多长？
 
-`serviceToken` 有效期较短，但是已实现自动刷新。用于刷新的 `passToken` 有效期也许是一个月，即扫码登录后理论上可以保活一个月。
+用于访问API的 `serviceToken` 有效期较短，但是已实现自动刷新。  
+用于刷新的 `passToken` 有效期也许是一个月，即扫码登录后理论上可以保活一个月。但实际上截至当前 commit，我一个半月前的 `passToken` 依然有效。
 
 ## XXX设备的XXX如何获取/设置？
 

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mijiaAPI
-Version: 3.0.3
+Version: 3.0.5
 Summary: A Python API for Xiaomi Mijia
 Author-email: Do1e <i@do1e.cn>
 License-Expression: GPL-3.0-or-later
@@ -40,6 +40,7 @@ Dynamic: license-file
 
 ```bash
 pip install mijiaAPI
+# Or `uv add mijiaAPI` for uv users
 ```
 
 ### 从源码安装
@@ -49,7 +50,8 @@ git clone https://github.com/Do1e/mijia-api.git
 cd mijia-api
 pip install .
 # Or `pip install -e .` for editable mode
-# Or `uv sync` for uv users
+# Or `pip install git+https://github.com/Do1e/mijia-api.git` for direct install
+# Or `uv add git+https://github.com/Do1e/mijia-api.git` for uv users
 ```
 
 ### aur

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/README.md

@@ -20,6 +20,7 @@
 
 ```bash
 pip install mijiaAPI
+# Or `uv add mijiaAPI` for uv users
 ```
 
 ### 从源码安装
@@ -29,7 +30,8 @@ git clone https://github.com/Do1e/mijia-api.git
 cd mijia-api
 pip install .
 # Or `pip install -e .` for editable mode
-# Or `uv sync` for uv users
+# Or `pip install git+https://github.com/Do1e/mijia-api.git` for direct install
+# Or `uv add git+https://github.com/Do1e/mijia-api.git` for uv users
 ```
 
 ### aur

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/mijiaAPI/apis.py

@@ -84,8 +84,8 @@ class mijiaAPI():
         try:
             self.check_new_msg(refresh_token=False)
         except Exception:
-            self._available_cache = False
-            self._available_cache_time = current_time
+            self._available_cache = None
+            self._available_cache_time = 0
             return False
 
         self._available_cache = True
@@ -665,7 +665,7 @@ class mijiaAPI():
         uri = "/miotspec/prop/set"
         ret_data = self._request(uri, {"params": params})
         for ret in ret_data:
-            if ret.get("code", 0) != 0:
+            if ret.get("code", 0) not in (0, 1):
                 ret.update({"message": ERROR_CODE.get(str(ret["code"]), "未知错误")})
             else:
                 ret.update({"message": "成功"})
@@ -741,7 +741,7 @@ class mijiaAPI():
             ret = self._request(uri, {"params": param})
             ret_data.append(ret)
         for ret in ret_data:
-            if ret.get("code", 0) != 0:
+            if ret.get("code", 0) not in (0, 1):
                 ret.update({"message": ERROR_CODE.get(str(ret["code"]), "未知错误")})
             else:
                 ret.update({"message": "成功"})

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/mijiaAPI/devices.py

@@ -190,7 +190,9 @@ class mijiaDevice():
         method["did"] = self.did
         method["value"] = value
         result = self.api.set_devices_prop(method)
-        if result["code"] != 0:
+        if result["code"] == 1:
+            logger.warning(f"网关已经接收指令，无法判断是否设置成功: {self.name} -> {name}, 值: {value}")
+        elif result["code"] != 0:
             raise DeviceSetError(self.name, name, result["code"])
         time.sleep(self.sleep_time)
         logger.debug(f"设置属性: {self.name} -> {name}, 值: {value}, 结果: {result}")
@@ -228,7 +230,9 @@ class mijiaDevice():
                     raise ValueError(f"无效的参数: {k}. 请勿使用以下参数 ({', '.join(method.keys())})")
                 method[k] = v
         result = self.api.run_action(method)
-        if result["code"] != 0:
+        if result["code"] == 1:
+            logger.warning(f"网关已经接收指令，无法判断是否执行成功: {self.name} -> {name}")
+        elif result["code"] != 0:
             raise DeviceActionError(self.name, name, result["code"])
         time.sleep(self.sleep_time)
         logger.debug(f"执行动作: {self.name} -> {name}, 结果: {result}")

mijiaapi-3.0.5/mijiaAPI/version.py

@@ -0,0 +1 @@
+version = "3.0.5"

{mijiaapi-3.0.3 → mijiaapi-3.0.5}/mijiaAPI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mijiaAPI
-Version: 3.0.3
+Version: 3.0.5
 Summary: A Python API for Xiaomi Mijia
 Author-email: Do1e <i@do1e.cn>
 License-Expression: GPL-3.0-or-later
@@ -40,6 +40,7 @@ Dynamic: license-file
 
 ```bash
 pip install mijiaAPI
+# Or `uv add mijiaAPI` for uv users
 ```
 
 ### 从源码安装
@@ -49,7 +50,8 @@ git clone https://github.com/Do1e/mijia-api.git
 cd mijia-api
 pip install .
 # Or `pip install -e .` for editable mode
-# Or `uv sync` for uv users
+# Or `pip install git+https://github.com/Do1e/mijia-api.git` for direct install
+# Or `uv add git+https://github.com/Do1e/mijia-api.git` for uv users
 ```
 
 ### aur

mijiaapi-3.0.3/mijiaAPI/version.py

@@ -1 +0,0 @@
-version = "3.0.3"