mijiaAPI 3.0.0__tar.gz → 3.0.1__tar.gz

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

@@ -0,0 +1,84 @@
+---
+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-3.0.1/.gitignore

@@ -0,0 +1,19 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# data
+.mijia-api-data/
+
+# vscode debug
+.vscode/launch.json
+
+# har files
+*.har

mijiaapi-3.0.1/CHANGELOG.md

@@ -0,0 +1,129 @@
+# 更新日志
+
+本文档记录了项目的v1.3.7以来的重要变更。
+
+## [3.0.1](https://github.com/Do1e/mijia-api/compare/v3.0.0...v3.0.1) - 2025-12.09
+### new feature
+* 新增 API `mijiaAPI.get_shared_devices_list()`，用于获取共享设备列表
+### bugfix
+* 修复了 alpine 下 `locale` 无法正常获取，默认使用 `zh_CN` 解决，如果需要在 alpine 下使用其他位置，请自行设置环境变量 `LC_ALL` 和 `LANG`。
+* 修复了共享家庭中无权限的问题，确保传递正确的 `owner_id`。
+
+## [3.0.0](https://github.com/Do1e/mijia-api/compare/v2.0.2...v3.0.0) - 2025-11.28
+### new feature
+* 使用最新的米家API接口，从 https://api.io.mi.com/app 切换到 https://api.mijia.tech/app
+* `mijiaAPI` 类的初始化参数变更，请传递用于保存认证数据的路径 `auth_data_path` 而不是认证数据
+* 彻底移除账号密码登录方式，仅支持二维码登录
+* 部分 API 需要指定 `home_id`，不指定将遍历所有家庭
+* 实现自动 `serviceToken` 刷新，现在理论上扫码一次能保活一个月
+* 移除登录类 `mijiaLogin`，相关功能集成进入 `mijiaAPI` 类，请使用 `mijiaAPI.login()` / `mijiaAPI.QRlogin()`，两者均为二维码登录
+* `mijiaDevice` 类的初始化参数变更，不再需要传递 `dev_info`，请选择传递 `did` 或 `dev_name` 进行初始化
+* `mijiaDevice` 类的 `set`, `get`, `run_action` 彻底移除 `did` 参数，初始化时已完成
+* 一些其他更改，请参考代码注释
+
+## [2.0.2](https://github.com/Do1e/mijia-api/compare/v2.0.1...v2.0.2) - 2025-09-23
+### bugfix
+* 修复了`set`方法在类型检查前进行value_list检查，导致某些设备无法设置值的问题
+
+## [2.0.1](https://github.com/Do1e/mijia-api/compare/v2.0.0...v2.0.1) - 2025-06-29
+### bugfix
+* 处理一个家庭中超过200个设备的情况，修复了`get_devices_list`方法可能无法获取所有设备的问题
+### improvement
+* 所有打印内容均使用中文
+
+## [2.0.0](https://github.com/Do1e/mijia-api/compare/v1.5.0...v2.0.0) - 2025-06-27
+#### 此版本有多项破坏性变更，请在升级后参考下述说明修复
+### new feature
+* 新增API：`get_statistics`，用于获取设备的统计信息，使用方法参见[demos/test_get_statistics.py](demos/test_get_statistics.py)
+* 新增文件[demos/decrypt.py](demos/decrypt.py)和[demos/decrypt_har.py](demos/decrypt_har.py)，用于解密米家APP抓包
+* `get_homes_list`支持获取共享家庭
+* `get_consumable_items`支持获取共享家庭的耗材列表，需要额外指定`owner_id`参数
+* `get_devices_list`支持获取共享家庭的设备列表
+### improvement
+* 认证文件保存`cUserId`，可作为`userId`的替代，暂时未使用
+* **此版本彻底移除了`mijiaDevices`，请及时替换为`mijiaDevice`**
+* **`mijiaDevice`的`set`方法更换了参数顺序，请及时修复**
+* **部分API调用后需要读取返回值的字典，如`api.get_devices_list()['list']`，现在直接返回列表，请注意修改，如`api.get_devices_list()`，具体列表如下：**
+  * `api.get_devices_list()['list']` -> `api.get_devices_list()`
+  * `api.get_homes_list()['homelist']` -> `api.get_homes_list()`
+  * `api.get_scenes_list(home_id)['scene_info_list']` -> `api.get_scenes_list(home_id)`
+  * `api.get_consumable_items(home_id)['items']` -> `api.get_consumable_items(home_id)`
+
+## [1.5.0](https://github.com/Do1e/mijia-api/compare/v1.4.5...v1.5.0) - 2025-06-19
+### new feature
+* 重命名`mijiaDevices`为`mijiaDevice`
+
+## [1.4.5](https://github.com/Do1e/mijia-api/compare/v1.4.4...v1.4.5) - 2025-06-16
+### bugfix
+* 登陆过程中无法获取用户信息时，处理相关报错
+
+## [1.4.4](https://github.com/Do1e/mijia-api/compare/v1.4.3...v1.4.4) - 2025-06-14
+### new feature
+* `get_device_info`支持[https://home.miot-spec.com/](https://home.miot-spec.com/)中的中文描述
+### bugfix
+* cli修复了执行`get_device_info`必须先登录的问题
+### improvement
+* 优化日志输出
+* 使用`login`方法的警告修改得更加明确
+
+## [1.4.3](https://github.com/Do1e/mijia-api/compare/v1.4.2...v1.4.3) - 2025-05-22
+### bugfix
+* 针对部分特殊的设备，修复了`get_device_info`的TypeError
+
+## [1.4.2](https://github.com/Do1e/mijia-api/compare/v1.4.1...v1.4.2) - 2025-05-19
+### new feature
+* `get_device_info`支持缓存结果以加速
+
+## [1.4.1](https://github.com/Do1e/mijia-api/compare/v1.4.0...v1.4.1) - 2025-05-19
+### new feature
+* cli支持`--run`以使用自然语言描述需求，交给小爱音箱执行
+
+## [1.4.0](https://github.com/Do1e/mijia-api/compare/v1.3.14...v1.4.0) - 2025-05-19
+### new feature
+* 新增`mijiaAPI`的cli支持，运行`mijiaAPI --help`查看帮助
+
+## [1.3.14](https://github.com/Do1e/mijia-api/compare/v1.3.13...v1.3.14) - 2025-05-18
+### bugfix
+* `available`属性判断错误，始终返回False
+
+## [1.3.13](https://github.com/Do1e/mijia-api/compare/v1.3.12...v1.3.13) - 2025-05-18
+### new feature
+* 新增从cookie中提取有效期并保存在凭据中
+### improvement
+* `available`属性根据有效期判断
+
+## [1.3.12](https://github.com/Do1e/mijia-api/compare/v1.3.11...v1.3.12) - 2025-05-16
+### improvement
+* 简化`mijiaLogin`的初始化参数，根据`save_path`的值自动判断是否需要保存凭据
+* 重构了对象初始化和方法的注释
+
+## [1.3.11](https://github.com/Do1e/mijia-api/compare/v1.3.10...v1.3.11) - 2025-05-16
+### bugfix
+* 验证保存路径并确保在保存验证数据之前确保目录存在
+
+## [1.3.10](https://github.com/Do1e/mijia-api/compare/v1.3.9...v1.3.10) - 2025-05-16
+### improvement
+* 使用logging模块替代print函数
+
+## [1.3.9](https://github.com/Do1e/mijia-api/compare/v1.3.8...v1.3.9) - 2025-05-16
+### new feature
+* 新增用户个人信息查询
+* 新增用户凭据的可选保存
+### improvement
+* 支持非tty的二维码打印
+* 优化二维码图片的删除逻辑
+
+## [1.3.8](https://github.com/Do1e/mijia-api/compare/v1.3.7...v1.3.8) - 2025-05-14
+### improvement
+* 新增了devices里所有方法的注释
+* 新增了`mijiaDevice`实例化时的断言检查
+* 新增了操作失败时的错误提示抛出与错误代码的详情
+* 优化了`mijiaDevice`实例化时的内部变量的赋值逻辑
+* 优化了多处代码的可读性与简洁性
+### bugfix
+* 修复多处由于数据类型更新而引发的警告
+
+## [1.3.7](https://github.com/Do1e/mijia-api/compare/v1.3.6...v1.3.7) - 2025-05-14
+### new feature
+* 新增自定义`run_action`参数，`in`等python关键字，可在前面加上下划线`_`
+* `mijiaDevice`支持传入设备名称(米家中自定义的名称)进行初始化

mijiaapi-3.0.1/FAQ.md

@@ -0,0 +1,23 @@
+# 常见问题
+
+## 账号密码登录失败
+
+现在登录似乎100%遇到验证码，建议使用扫码登录。
+
+## 扫码登录后的有效期多长？
+
+`serviceToken` 有效期较短，但是已实现自动刷新。用于刷新的 `passToken` 有效期也许是一个月，即扫码登录后理论上可以保活一个月。
+
+## XXX设备的XXX如何获取/设置？
+
+我拥有的设备有限，无法保证能解答这类问题，但也欢迎提交 [issue](https://github.com/Do1e/mijia-api/issues)，可能需要你将设备共享给我进行抓包或者自行抓包给我提供请求和响应，提供har文件的话注意自行删除cookie等敏感信息。
+
+## 如何抓包？
+
+小米官方给了一个[抓包教程](https://iot.mi.com/new/doc/accesses/direct-access/extension-development/troubleshooting/packet_capture)，我没试过，不确定是否能行，如果抓包成功数据是加密的，可以使用 [decrypt/decrypt.py](decrypt/decrypt.py) 解密。
+
+我自己的解决方案是使用一个获取了root的手机，安装 [reqable](https://reqable.com/zh-CN/) 进行抓包，导出 HAR 文件后使用 [decrypt/decrypt_har.py](decrypt/decrypt_har.py) 解密后导入电脑版的 reqable 查看。
+
+## 是否可以支持设备回调？
+
+理论上可以实现，但由于[ha_xiaomi_home 开源许可证](https://github.com/XiaoMi/ha_xiaomi_home/blob/main/LICENSE.md)的要求，将不会支持相关功能。

{mijiaapi-3.0.0 → mijiaapi-3.0.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: mijiaAPI
-Version: 3.0.0
+Version: 3.0.1
 Summary: A Python API for Xiaomi Mijia
-Author-email: Do1e <dpj.email@qq.com>
+Author-email: Do1e <i@do1e.cn>
 License: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/Do1e/mijia-api
 Project-URL: Repository, https://github.com/Do1e/mijia-api
@@ -97,7 +97,7 @@ api.login()
 homes = api.get_homes_list()
 print(homes)
 
-# 获取所有设备
+# 获取所有设备（不包含共享设备）
 devices = api.get_devices_list()
 for device in devices:
     print(f"设备名称: {device['name']}, Model: {device['model']}, Did: {device['did']}")
@@ -105,6 +105,9 @@ for device in devices:
 # 获取指定家庭的设备
 home_id = homes[0]['id']
 devices_in_home = api.get_devices_list(home_id=home_id)
+
+# 获取共享设备列表（无法指定家庭ID）
+shared_devices = api.get_shared_devices_list()
 ```
 
 #### 2. 获取和设置设备属性
@@ -349,24 +352,55 @@ usage: mijiaAPI [-h] [-p AUTH_PATH] [--list_homes] [-l] [--list_scenes]
                  {get,set} ...
 
 positional arguments:
-  {get,set}                获取或设置设备属性
+  {get,set}
+    get                 获取设备属性
+    set                 设置设备属性
 
-optional arguments:
-  -h, --help               显示此帮助信息
+options:
+  -h, --help            show this help message and exit
+  -v, --version         显示版本信息并退出
   -p, --auth_path AUTH_PATH
-                           认证文件保存路径（默认：~/.config/mijia-api/auth.json）
-  --list_homes             列出所有家庭
-  -l, --list_devices       列出所有米家设备
-  --list_scenes            列出所有场景
-  --list_consumable_items  列出所有耗材
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --list_homes          列出家庭列表
+  -l, --list_devices    列出所有米家设备，包含共享设备
+  --list_scenes         列出场景列表
+  --list_consumable_items
+                        列出耗材列表
   --run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]
-                           执行场景，可指定场景ID或名称
+                        运行场景，指定场景ID或名称
   --get_device_info DEVICE_MODEL
-                           获取设备规格信息（指定设备model）
-  --run PROMPT             使用自然语言描述需求（需要小爱音箱）
+                        获取设备信息，指定设备model，先使用 --list_devices 获取
+  --run PROMPT          使用自然语言描述你的需求，如果你有小爱音箱的话
   --wifispeaker_name WIFISPEAKER_NAME
-                           指定小爱音箱名称（默认为第一个小爱音箱）
-  --quiet                  小爱音箱静默执行
+                        指定小爱音箱名称，默认是获取到的第一个小爱音箱
+  --quiet               小爱音箱静默执行
+```
+
+```
+usage: mijiaAPI get [-h] [-p AUTH_PATH] [--did DID] [--dev_name DEV_NAME] --prop_name PROP_NAME
+
+options:
+  -h, --help            show this help message and exit
+  -p, --auth_path AUTH_PATH
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --did DID             设备did，优先于 --dev_name 使用
+  --dev_name DEV_NAME   设备名称，指定为米家APP中设定的名称
+  --prop_name PROP_NAME
+                        属性名称，先使用 --get_device_info 获取
+```
+
+```
+usage: mijiaAPI set [-h] [-p AUTH_PATH] [--did DID] [--dev_name DEV_NAME] --prop_name PROP_NAME --value VALUE
+
+options:
+  -h, --help            show this help message and exit
+  -p, --auth_path AUTH_PATH
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --did DID             设备did，优先于 --dev_name 使用
+  --dev_name DEV_NAME   设备名称，指定为米家APP中设定的名称
+  --prop_name PROP_NAME
+                        属性名称，先使用 --get_device_info 获取
+  --value VALUE         需要设定的属性值
 ```
 
 #### 获取设备属性

{mijiaapi-3.0.0 → mijiaapi-3.0.1}/README.md

@@ -76,7 +76,7 @@ api.login()
 homes = api.get_homes_list()
 print(homes)
 
-# 获取所有设备
+# 获取所有设备（不包含共享设备）
 devices = api.get_devices_list()
 for device in devices:
     print(f"设备名称: {device['name']}, Model: {device['model']}, Did: {device['did']}")
@@ -84,6 +84,9 @@ for device in devices:
 # 获取指定家庭的设备
 home_id = homes[0]['id']
 devices_in_home = api.get_devices_list(home_id=home_id)
+
+# 获取共享设备列表（无法指定家庭ID）
+shared_devices = api.get_shared_devices_list()
 ```
 
 #### 2. 获取和设置设备属性
@@ -328,24 +331,55 @@ usage: mijiaAPI [-h] [-p AUTH_PATH] [--list_homes] [-l] [--list_scenes]
                  {get,set} ...
 
 positional arguments:
-  {get,set}                获取或设置设备属性
+  {get,set}
+    get                 获取设备属性
+    set                 设置设备属性
 
-optional arguments:
-  -h, --help               显示此帮助信息
+options:
+  -h, --help            show this help message and exit
+  -v, --version         显示版本信息并退出
   -p, --auth_path AUTH_PATH
-                           认证文件保存路径（默认：~/.config/mijia-api/auth.json）
-  --list_homes             列出所有家庭
-  -l, --list_devices       列出所有米家设备
-  --list_scenes            列出所有场景
-  --list_consumable_items  列出所有耗材
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --list_homes          列出家庭列表
+  -l, --list_devices    列出所有米家设备，包含共享设备
+  --list_scenes         列出场景列表
+  --list_consumable_items
+                        列出耗材列表
   --run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]
-                           执行场景，可指定场景ID或名称
+                        运行场景，指定场景ID或名称
   --get_device_info DEVICE_MODEL
-                           获取设备规格信息（指定设备model）
-  --run PROMPT             使用自然语言描述需求（需要小爱音箱）
+                        获取设备信息，指定设备model，先使用 --list_devices 获取
+  --run PROMPT          使用自然语言描述你的需求，如果你有小爱音箱的话
   --wifispeaker_name WIFISPEAKER_NAME
-                           指定小爱音箱名称（默认为第一个小爱音箱）
-  --quiet                  小爱音箱静默执行
+                        指定小爱音箱名称，默认是获取到的第一个小爱音箱
+  --quiet               小爱音箱静默执行
+```
+
+```
+usage: mijiaAPI get [-h] [-p AUTH_PATH] [--did DID] [--dev_name DEV_NAME] --prop_name PROP_NAME
+
+options:
+  -h, --help            show this help message and exit
+  -p, --auth_path AUTH_PATH
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --did DID             设备did，优先于 --dev_name 使用
+  --dev_name DEV_NAME   设备名称，指定为米家APP中设定的名称
+  --prop_name PROP_NAME
+                        属性名称，先使用 --get_device_info 获取
+```
+
+```
+usage: mijiaAPI set [-h] [-p AUTH_PATH] [--did DID] [--dev_name DEV_NAME] --prop_name PROP_NAME --value VALUE
+
+options:
+  -h, --help            show this help message and exit
+  -p, --auth_path AUTH_PATH
+                        认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json
+  --did DID             设备did，优先于 --dev_name 使用
+  --dev_name DEV_NAME   设备名称，指定为米家APP中设定的名称
+  --prop_name PROP_NAME
+                        属性名称，先使用 --get_device_info 获取
+  --value VALUE         需要设定的属性值
 ```
 
 #### 获取设备属性

mijiaapi-3.0.1/demos/test_apis.py

@@ -0,0 +1,116 @@
+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-3.0.1/demos/test_get_statistics.py

@@ -0,0 +1,35 @@
+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-3.0.1/demos/test_login.py

@@ -0,0 +1,12 @@
+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-3.0.0 → mijiaapi-3.0.1}/mijiaAPI/__main__.py

@@ -16,6 +16,12 @@ logging.getLogger("mijiaAPI").setLevel(logging.INFO)
 def parse_args(args):
     parser = argparse.ArgumentParser(description=f"Mijia API CLI (v{version})")
     subparsers = parser.add_subparsers(dest='command')
+    parser.add_argument(
+        '-v', '--version',
+        action='version',
+        version=f"%(prog)s {version}",
+        help="显示版本信息并退出",
+    )
     parser.add_argument(
         '-p', '--auth_path',
         type=Path,
@@ -30,7 +36,7 @@ def parse_args(args):
     parser.add_argument(
         '-l', '--list_devices',
         action='store_true',
-        help="列出所有米家设备",
+        help="列出所有米家设备，包含共享设备",
     )
     parser.add_argument(
         '--list_scenes',
@@ -190,7 +196,7 @@ def get_homes_list(api: mijiaAPI, verbose: bool = True, device_mapping: Optional
     return home_mapping
 
 def get_devices_list(api: mijiaAPI, verbose: bool = True) -> dict:
-    devices = api.get_devices_list()
+    devices = api.get_devices_list() + api.get_shared_devices_list()
     if verbose:
         print("设备列表:")
         for device in devices: