mijiaAPI 4.1.1__tar.gz → 4.1.2__tar.gz

mijiaapi-4.1.2/MANIFEST.in

@@ -0,0 +1,3 @@
+prune demos
+prune .github
+prune mijiaAPI.egg-info

{mijiaapi-4.1.1/mijiaAPI.egg-info → mijiaapi-4.1.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: mijiaAPI
-Version: 4.1.1
+Version: 4.1.2
 Summary: A Python API for Xiaomi Mijia
 Author-email: Do1e <i@do1e.cn>
 License-Expression: GPL-3.0-or-later
-Project-URL: Homepage, https://github.com/Do1e/mijia-api
+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

{mijiaapi-4.1.1 → mijiaapi-4.1.2}/mijiaAPI/mcp_server.py

@@ -90,11 +90,21 @@ def list_devices(home_id: Optional[str] = None) -> str:
     参数:
         home_id: 可选，指定家庭ID则仅列出该家庭的设备；不传则列出所有设备。
 
-    返回每个设备的名称、did、model、在线状态等。
+    返回每个设备的名称、did、model、在线状态以及所属家庭(home)和房间(room)等。
     """
     api = _get_api()
     _refresh_if_needed(api)
     devices = api.get_devices_list() + api.get_shared_devices_list()
+    homes = api.get_homes_list()
+    did_location = {}
+    for home in homes:
+        for room in home.get('roomlist', []):
+            for did in room.get('dids', []) or []:
+                did_location[did] = (home['name'], room['name'])
+    for device in devices:
+        home_name, room_name = did_location.get(device['did'], ("未知", "未知"))
+        device['home'] = home_name
+        device['room'] = room_name
     if home_id is not None:
         devices = [d for d in devices if d.get("home_id") == home_id]
     return json.dumps(devices, ensure_ascii=False)

mijiaapi-4.1.2/mijiaAPI/version.py

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

mijiaapi-4.1.2/mijiaAPI.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+.gitignore
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+uv.lock
+mijiaAPI/__init__.py
+mijiaAPI/__main__.py
+mijiaAPI/apis.py
+mijiaAPI/devices.py
+mijiaAPI/errors.py
+mijiaAPI/logger.py
+mijiaAPI/mcp_server.py
+mijiaAPI/miutils.py
+mijiaAPI/version.py

{mijiaapi-4.1.1 → mijiaapi-4.1.2}/pyproject.toml

@@ -30,7 +30,7 @@ include = ["mijiaAPI"]
 version = {attr = "mijiaAPI.version.version"}
 
 [project.urls]
-Homepage = "https://github.com/Do1e/mijia-api"
+Homepage = "https://mijia-api.do1e.com/"
 Repository = "https://github.com/Do1e/mijia-api"
 
 [dependency-groups]

mijiaapi-4.1.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,84 +0,0 @@
----
-name: Bug report
-about: 提交一个遇到的bug
-title: "[BUG]"
-labels: bug
-assignees: ''
-
----
-
-<!--
-感谢使用mijia-api！如果您遇到了任何问题或发现了错误，请按照以下格式提交您的Bug报告。这将帮助我们更快地定位并解决问题。
-
-如何提交一个有效的Bug报告：
-
-1. **确保这是一个Bug**：请先查阅[已知问题](https://github.com/Do1e/mijia-api/issues?q=is%3Aissue%20label%3Awontfix)，确认您的问题不是已知的问题或是配置不当造成的。
-2. **尝试重现问题**：在不同的环境或条件下尝试重现此问题，以确定是否总是发生。
-3. **搜索现有问题**：查看现有的[Issue列表](https://github.com/Do1e/mijia-api/issues)，确认这个问题还没有被报告过。
-4. **提供详细信息**：
-   - 您的操作系统和版本。
-   - Python版本。
-   - 项目的版本号。
-   - 出现问题的具体步骤。
-   - 实际行为与预期行为之间的差异。
-   - 如果可能的话，附上相关的日志输出或截图。
--->
-
-## 报告模板
-
-### 基本信息
-
-- **操作系统**: [例如: Windows 10, macOS Big Sur, Ubuntu 20.04]
-- **Python版本**: [例如: 3.8.5]
-- **项目版本**: [例如: 1.0.0]
-- **设备model**: [例如: "lumi.acpartner.v2"]
-
-### 描述问题
-
-<!-- 简短描述遇到的问题是什么。 -->
-
-#### 步骤到复现
-<!--
-1. 第一步...
-2. 第二步...
-3. 等等...
--->
-
-#### 实际结果
-<!--
-这里写实际发生了什么。
--->
-
-
-#### 预期结果
-<!--
-这里写你期望看到的结果是什么样的。
--->
-
-#### 报错堆栈
-<!--
-复制并在这里粘贴Python的完整报错堆栈。
--->
-
-#### 日志信息
-<!--
-在代码开头加上：
-```python
-import logging
-logging.getLogger("mijiaAPI").setLevel(logging.DEBUG)
-```
-然后运行代码，复制并粘贴相关的日志输出，请注意手动隐藏任何敏感信息（如did、token等）。
--->
-
-### 附加信息
-<!--
-如果有更多的上下文可以帮助我们理解问题所在，请在这里添加。比如错误消息、堆栈跟踪等。
--->
-
-
-
----
-
-<!-- 
-再次感谢您的贡献！通过您的帮助，我们可以让这个项目变得更好。
--->

mijiaapi-4.1.1/PKG-INFO

@@ -1,108 +0,0 @@
-Metadata-Version: 2.4
-Name: mijiaAPI
-Version: 4.1.1
-Summary: A Python API for Xiaomi Mijia
-Author-email: Do1e <i@do1e.cn>
-License-Expression: GPL-3.0-or-later
-Project-URL: Homepage, https://github.com/Do1e/mijia-api
-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.1/demos/test_apis.py

@@ -1,116 +0,0 @@
-import json
-import logging
-import time
-
-from mijiaAPI import mijiaAPI
-
-
-logging.getLogger("mijiaAPI").setLevel(logging.DEBUG)
-
-api = mijiaAPI(".mijia-api-data/auth.json")
-
-# ----------------------- get homes list -----------------------
-homes = api.get_homes_list()
-with open(".mijia-api-data/homes.json", "w", encoding="utf-8") as f:
-    json.dump(homes, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-home_id = homes[0]['id']
-home_name = homes[0]['name']
-
-# ---------------------- get devices list ----------------------
-devices = api.get_devices_list()
-with open(".mijia-api-data/devices.json", "w", encoding="utf-8") as f:
-    json.dump(devices, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# -------------------- get shared homes list -------------------
-shared_devices = api.get_shared_devices_list()
-with open(".mijia-api-data/shared_devices.json", "w", encoding="utf-8") as f:
-    json.dump(shared_devices, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ------------------ get devices with home_id ------------------
-devices_with_home = api.get_devices_list(home_id=home_id)
-with open(f".mijia-api-data/devices_in_{home_name}.json", "w", encoding="utf-8") as f:
-    json.dump(devices_with_home, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ---------------------- get scenes list -----------------------
-scenes = api.get_scenes_list()
-with open(".mijia-api-data/scenes.json", "w", encoding="utf-8") as f:
-    json.dump(scenes, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ------------------ get scenes with home_id -------------------
-scenes_with_home = api.get_scenes_list(home_id=home_id)
-with open(f".mijia-api-data/scenes_in_{home_name}.json", "w", encoding="utf-8") as f:
-    json.dump(scenes_with_home, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ------------------------- run scene --------------------------
-scence_id = scenes[0]['scene_id']
-scence_name = scenes[0]['name']
-scence_home_id = scenes[0]['home_id']
-ret = api.run_scene(scence_id, scence_home_id)
-print(f"已执行场景 {scence_name}，响应: {ret}")
-time.sleep(1)
-
-# -------------------- get consumable items --------------------
-consumable_items = api.get_consumable_items()
-with open(".mijia-api-data/consumable_items.json", "w", encoding="utf-8") as f:
-    json.dump(consumable_items, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ------------- get consumable items with home_id --------------
-consumable_items_with_home = api.get_consumable_items(home_id=home_id)
-with open(f".mijia-api-data/consumable_items_in_{home_name}.json", "w", encoding="utf-8") as f:
-    json.dump(consumable_items_with_home, f, ensure_ascii=False, indent=2)
-time.sleep(1)
-
-# ----------------- get/set device properties ------------------
-# did 和 model 从 get_devices_list() 接口获取
-# siid 和 piid 请查阅 https://home.miot-spec.com/spec/{model}
-# 或者也可以直接在 米家APP->智能->+->手动控制 中
-# 添加 scene，调用 run_scene() 接口控制设备
-for device in devices:
-    if device["model"] == "yeelink.light.lamp4":
-        break
-
-did = device["did"]
-name = device["name"]
-
-ret = api.get_devices_prop([
-    {"did": did, "siid": 2, "piid": 2},
-    {"did": did, "siid": 2, "piid": 3},
-])
-brightness = ret[0]["value"]
-color_temperature = ret[1]["value"]
-print(f"获取设备 {name} 属性成功: {ret}")
-print(f"亮度: {brightness}%")
-print(f"色温: {color_temperature}K")
-
-ret = api.set_devices_prop([
-    {"did": did, "siid": 2, "piid": 2, "value": 50},
-    {"did": did, "siid": 2, "piid": 3, "value": 2700},
-])
-print(f"设置设备 {name} 属性成功: {ret}")
-time.sleep(1)
-
-# ------------------------- run action -------------------------
-ret = api.run_action({"did": did, "siid": 2, "aiid": 1})
-print(f"执行设备 {name} 动作成功: {ret}")
-time.sleep(1)
-
-# ----------------------- get statistics -----------------------
-for device in devices:
-    if device["model"] == "lumi.acpartner.mcn04":
-        break
-ret = api.get_statistics({
-    "did": device["did"],
-    "key": "7.1",
-    "data_type": "stat_month_v3",
-    "limit": 6,
-    "time_start": int(time.time() - 24 * 60 * 60 * 30 * 6),
-    "time_end": int(time.time()),
-})
-print(f"获取设备 {device['name']} 统计数据成功: {ret}")

mijiaapi-4.1.1/demos/test_get_statistics.py

@@ -1,35 +0,0 @@
-import time
-
-from mijiaAPI import mijiaAPI
-
-
-api = mijiaAPI(".mijia-api-data/auth.json")
-devices = api.get_devices_list()
-for device in devices:
-    if device['model'] == 'lumi.acpartner.mcn04':
-        did = device['did']
-        break
-
-# 参考 https://iot.mi.com/new/doc/accesses/direct-access/extension-development/extension-functions/statistical-interface
-ret = api.get_statistics({
-    "did": did,
-    "key": "7.1",                 # siid.piid，这里的7.1表示 lumi.acpartner.mcn04 的 power-consumption
-    "data_type": "stat_month_v3", # 按月统计，可选：时（stat_hour_v3）、天（stat_day_v3）、星期（stat_week_v3）、月（stat_month_v3）
-    "limit": 6,                   # 返回的最大条目数
-    "time_start": int(time.time() - 24 * 3600 * 30 * 6),
-    "time_end": int(time.time()),
-})
-
-"""
-已知问题：
-支持的设备有限，而且我的空调貌似也只支持 stat_month_v3。
-比较旧的设备使用的API会不一样，需要将`data_type`中的`_v3`去掉。
-并且`key`也不一样，比如 lumi.acpartner.mcn02 的统计耗电量的`key`为`powerCost`。
-详见 https://github.com/Do1e/mijia-api/issues/46
-"""
-
-for item in ret:
-    value = eval(item['value'])[0]
-    ts = item['time']
-    date = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(ts))
-    print(f'{date}: {value}')

mijiaapi-4.1.1/demos/test_login.py

@@ -1,12 +0,0 @@
-import logging
-
-from mijiaAPI import mijiaAPI
-
-
-logging.getLogger("mijiaAPI").setLevel(logging.DEBUG)
-
-api = mijiaAPI(".mijia-api-data/auth.json")
-print(api.available)
-api.login() # 实际就是调用 QRlogin 方法
-print(api.available)
-print(api.get_homes_list())

mijiaapi-4.1.1/mijiaAPI/version.py

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

mijiaapi-4.1.1/mijiaAPI.egg-info/SOURCES.txt

@@ -1,24 +0,0 @@
-.gitignore
-LICENSE
-README.md
-pyproject.toml
-uv.lock
-.github/ISSUE_TEMPLATE/bug_report.md
-demos/test_apis.py
-demos/test_get_statistics.py
-demos/test_login.py
-mijiaAPI/__init__.py
-mijiaAPI/__main__.py
-mijiaAPI/apis.py
-mijiaAPI/devices.py
-mijiaAPI/errors.py
-mijiaAPI/logger.py
-mijiaAPI/mcp_server.py
-mijiaAPI/miutils.py
-mijiaAPI/version.py
-mijiaAPI.egg-info/PKG-INFO
-mijiaAPI.egg-info/SOURCES.txt
-mijiaAPI.egg-info/dependency_links.txt
-mijiaAPI.egg-info/entry_points.txt
-mijiaAPI.egg-info/requires.txt
-mijiaAPI.egg-info/top_level.txt

mijiaapi-4.1.1/mijiaAPI.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

mijiaapi-4.1.1/mijiaAPI.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-mijiaAPI = mijiaAPI.__main__:cli

mijiaapi-4.1.1/mijiaAPI.egg-info/requires.txt

@@ -1,6 +0,0 @@
-fastmcp>=3.4.2
-pillow>=11.3.0
-pycryptodome>=3.23.0
-qrcode>=8.2
-requests>=2.32.5
-tzlocal>=5.3.1

mijiaapi-4.1.1/mijiaAPI.egg-info/top_level.txt

@@ -1 +0,0 @@
-mijiaAPI