mijiaAPI 4.1.3__tar.gz → 4.2.0__tar.gz

{mijiaapi-4.1.3 → mijiaapi-4.2.0}/PKG-INFO

@@ -1,108 +1,108 @@
-Metadata-Version: 2.4
-Name: mijiaAPI
-Version: 4.1.3
-Summary: A Python API for Xiaomi Mijia
-Author-email: Do1e <i@do1e.cn>
-License-Expression: GPL-3.0-or-later
-Project-URL: Homepage, https://mijia-api.do1e.com/
-Project-URL: Repository, https://github.com/Do1e/mijia-api
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: <4.0,>=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastmcp>=3.4.2
-Requires-Dist: pillow>=11.3.0
-Requires-Dist: pycryptodome>=3.23.0
-Requires-Dist: qrcode>=8.2
-Requires-Dist: requests>=2.32.5
-Requires-Dist: tzlocal>=5.3.1
-Dynamic: license-file
-
-# mijiaAPI
-
-米家 API，可以使用代码、CLI、MCP 直接控制米家设备。
-
-> 🎉 **v4.0.0 版本已支持 MCP**，详见 [MCP 使用文档](https://mijia-api.do1e.com/usage/mcp)  
-> 🎉 **v4.1.0 版本已支持 Agent Skill**，详见 [Agent Skill 使用文档](https://mijia-api.do1e.com/usage/skill)
-
-[![GitHub](https://img.shields.io/badge/GitHub-Do1e%2Fmijia--api-blue)](https://github.com/Do1e/mijia-api)
-[![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
-[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
-
-📖 **完整文档请见 [mijia-api.do1e.com](https://mijia-api.do1e.com)**
-
-[常见问题](https://mijia-api.do1e.com/faq) | [更新日志](https://mijia-api.do1e.com/changelog)
-
-## 安装
-
-> 要求 Python >= 3.10
-
-```bash
-pip install mijiaAPI
-# Or `uv add mijiaAPI` for uv users
-```
-
-其他安装方式（源码安装、AUR）请参考[文档](https://mijia-api.do1e.com/guide/installation)。
-
-## 快速开始
-
-```python
-from mijiaAPI import mijiaAPI, mijiaDevice
-
-# 初始化并扫码登录（认证文件默认保存在 ~/.config/mijia-api/auth.json）
-api = mijiaAPI()
-api.login()
-
-# 通过设备名称控制设备（推荐）
-device = mijiaDevice(api, dev_name="我的台灯")
-device.on = True              # 打开设备
-device.brightness = 60        # 设置亮度为 60%
-
-# 查看设备支持的所有属性和动作
-print(device)
-```
-
-CLI 用法：
-
-```bash
-mijiaAPI login                          # 扫码登录
-mijiaAPI -l                             # 列出所有设备
-mijiaAPI set --dev_name "台灯" --prop_name "brightness" --value 60
-```
-
-MCP 用法：
-
-执行 `uvx mijiaAPI login -p /path/to/auth.json` 登录后，在 MCP 客户端配置中添加以下内容即可接入米家：
-
-```json
-{
-  "mcpServers": {
-    "mijia-api": {
-      "command": "uvx",
-      "args": ["mijiaAPI", "mcp", "-p", "/path/to/auth.json"]
-    }
-  }
-}
-```
-
-更多用法（API 基础调用、MCP Server、CLI 完整参数、最佳实践等）请查阅[完整文档](https://mijia-api.do1e.com)。
-
-## 致谢
-
-* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
-* [米家 APP 网络请求的抓包、加解密与构造的代码笔记](https://imkero.net/posts/mihome-app-api/)
-* [al-one/hass-xiaomi-miot](https://github.com/al-one/hass-xiaomi-miot)
-
-## 开源许可
-
-本项目采用 [GPL-3.0](LICENSE) 开源许可证。
-
-**请注意：GPL-3.0 是具有“强传染性”的开源许可证。**  
-如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也**必须**以 GPL-3.0 或兼容许可证开源发布。
-
-## 免责声明
-
-* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
-* 用户使用本项目所产生的任何后果，需自行承担风险
-* 开发者不对使用本项目产生的任何直接或间接损失负责
+Metadata-Version: 2.4
+Name: mijiaAPI
+Version: 4.2.0
+Summary: A Python API for Xiaomi Mijia
+Author-email: Do1e <i@do1e.cn>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://mijia-api.do1e.com/
+Project-URL: Repository, https://github.com/Do1e/mijia-api
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: <4.0,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: pillow>=11.3.0
+Requires-Dist: pycryptodome>=3.23.0
+Requires-Dist: qrcode>=8.2
+Requires-Dist: requests>=2.32.5
+Requires-Dist: tzlocal>=5.3.1
+Dynamic: license-file
+
+# mijiaAPI
+
+米家 API，可以使用代码、CLI、MCP 直接控制米家设备。
+
+> 🎉 **v4.0.0 版本已支持 MCP**，详见 [MCP 使用文档](https://mijia-api.do1e.com/usage/mcp)  
+> 🎉 **v4.1.0 版本已支持 Agent Skill**，详见 [Agent Skill 使用文档](https://mijia-api.do1e.com/usage/skill)
+
+[![GitHub](https://img.shields.io/badge/GitHub-Do1e%2Fmijia--api-blue)](https://github.com/Do1e/mijia-api)
+[![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
+
+📖 **完整文档请见 [mijia-api.do1e.com](https://mijia-api.do1e.com)**
+
+[常见问题](https://mijia-api.do1e.com/faq) | [更新日志](https://mijia-api.do1e.com/changelog)
+
+## 安装
+
+> 要求 Python >= 3.10
+
+```bash
+pip install mijiaAPI
+# Or `uv add mijiaAPI` for uv users
+```
+
+其他安装方式（源码安装、AUR）请参考[文档](https://mijia-api.do1e.com/guide/installation)。
+
+## 快速开始
+
+```python
+from mijiaAPI import mijiaAPI, mijiaDevice
+
+# 初始化并扫码登录（认证文件默认保存在 ~/.config/mijia-api/auth.json）
+api = mijiaAPI()
+api.login()
+
+# 通过设备名称控制设备（推荐）
+device = mijiaDevice(api, dev_name="我的台灯")
+device.on = True              # 打开设备
+device.brightness = 60        # 设置亮度为 60%
+
+# 查看设备支持的所有属性和动作
+print(device)
+```
+
+CLI 用法：
+
+```bash
+mijiaAPI login                          # 扫码登录
+mijiaAPI -l                             # 列出所有设备
+mijiaAPI set --dev_name "台灯" --prop_name "brightness" --value 60
+```
+
+MCP 用法：
+
+执行 `uvx mijiaAPI login -p /path/to/auth.json` 登录后，在 MCP 客户端配置中添加以下内容即可接入米家：
+
+```json
+{
+  "mcpServers": {
+    "mijia-api": {
+      "command": "uvx",
+      "args": ["mijiaAPI", "mcp", "-p", "/path/to/auth.json"]
+    }
+  }
+}
+```
+
+更多用法（API 基础调用、MCP Server、CLI 完整参数、最佳实践等）请查阅[完整文档](https://mijia-api.do1e.com)。
+
+## 致谢
+
+* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
+* [米家 APP 网络请求的抓包、加解密与构造的代码笔记](https://imkero.net/posts/mihome-app-api/)
+* [al-one/hass-xiaomi-miot](https://github.com/al-one/hass-xiaomi-miot)
+
+## 开源许可
+
+本项目采用 [GPL-3.0](LICENSE) 开源许可证。
+
+**请注意：GPL-3.0 是具有“强传染性”的开源许可证。**  
+如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也**必须**以 GPL-3.0 或兼容许可证开源发布。
+
+## 免责声明
+
+* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
+* 用户使用本项目所产生的任何后果，需自行承担风险
+* 开发者不对使用本项目产生的任何直接或间接损失负责

{mijiaapi-4.1.3 → mijiaapi-4.2.0}/mijiaAPI/devices.py

@@ -1,6 +1,7 @@
 import json
 import re
 import time
+from collections import Counter
 from pathlib import Path
 from typing import Optional, Union
 
@@ -20,6 +21,19 @@ from .version import version
 
 
 device_url = "https://home.miot-spec.com/spec/"
+device_info_version = 1
+
+
+def _deduplicate_names(items: list[dict], iid_key: str) -> None:
+    name_counts = Counter(item["name"] for item in items)
+    for item in items:
+        if name_counts[item["name"]] > 1:
+            item["name"] = f"{item['name']}-{item['method']['siid']}"
+
+    name_counts = Counter(item["name"] for item in items)
+    for item in items:
+        if name_counts[item["name"]] > 1:
+            item["name"] = f"{item['name']}-{item['method'][iid_key]}"
 
 
 class DevProp():
@@ -252,6 +266,7 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
 
     返回值:
         dict: 设备规格信息字典，包含以下字段：
+            - version (int): 设备信息缓存格式版本
             - name (str): 设备名称
             - model (str): 设备型号
             - properties (list): 设备属性列表，每个属性包含以下字段：
@@ -275,12 +290,16 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
         >>> print(info['name'])  # 输出设备名称
         >>> print(info['properties'][0]['name'])  # 输出第一个属性的名称
     """
+    cache_file = None
     if cache_path is not None:
         cache_file = Path(cache_path) / f"{device_model}.json"
         if cache_file.exists():
             logger.debug(f"从缓存加载设备信息: {cache_file}")
             with cache_file.open("r", encoding="utf-8") as f:
-                return json.load(f)
+                cached_result = json.load(f)
+            if cached_result.get("version") == device_info_version:
+                return cached_result
+            logger.debug(f"设备信息缓存版本不匹配，重新获取: {cache_file}")
     response = requests.get(device_url + device_model, headers={
         "User-Agent": f"mijiaAPI/{version}"
     })
@@ -297,6 +316,7 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
     model = product["model"]
     i18n_zh = content["props"]["i18n"]["zh_cn"]
     result = {
+        "version": device_info_version,
         "name": name,
         "model": model,
         "properties": [],
@@ -304,11 +324,8 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
     }
     services = content["props"]["tree"]["services"]
 
-    properties_name = []
-    actions_name = []
     for svc in services:
         siid = svc["iid"]
-        svc_type = svc["type"]
         for prop in svc.get("properties", []):
             piid = prop["iid"]
             if prop["format"].startswith("int"):
@@ -345,9 +362,6 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
                     if vl_zh:
                         vl_entry["desc_zh_cn"] = vl_zh
                     item["value-list"].append(vl_entry)
-            if item["name"] in properties_name:
-                item["name"] = f"{svc_type}-{item['name']}"
-            properties_name.append(item["name"])
             result["properties"].append(item)
         for act in svc.get("actions", []):
             aiid = act["iid"]
@@ -360,15 +374,13 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
                     "aiid": aiid
                 }
             }
-            if act_item["name"] in actions_name:
-                act_item["name"] = f"{svc_type}-{act_item['name']}"
-            actions_name.append(act_item["name"])
             result["actions"].append(act_item)
 
-    if cache_path is not None:
-        cache_path = Path(cache_path)
-        cache_path.mkdir(parents=True, exist_ok=True)
-        cache_file = cache_path / f"{device_model}.json"
+    _deduplicate_names(result["properties"], "piid")
+    _deduplicate_names(result["actions"], "aiid")
+
+    if cache_file is not None:
+        cache_file.parent.mkdir(parents=True, exist_ok=True)
         logger.debug(f"缓存设备信息到: {cache_file}")
         with cache_file.open("w", encoding="utf-8") as f:
             json.dump(result, f, indent=2, ensure_ascii=False)

mijiaapi-4.2.0/mijiaAPI/version.py

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

{mijiaapi-4.1.3 → mijiaapi-4.2.0}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

mijiaapi-4.1.3/mijiaAPI/version.py

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