mijiaAPI 4.2.0__tar.gz → 4.3.0__tar.gz

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

@@ -1,108 +1,108 @@
-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 或兼容许可证开源发布。
-
-## 免责声明
-
-* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
-* 用户使用本项目所产生的任何后果，需自行承担风险
-* 开发者不对使用本项目产生的任何直接或间接损失负责
+Metadata-Version: 2.4
+Name: mijiaAPI
+Version: 4.3.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.2.0 → mijiaapi-4.3.0}/mijiaAPI/__main__.py

@@ -112,8 +112,33 @@ def parse_args(args):
     )
     run.add_argument(
         '--quiet',
-        action='store_true',
-        help="小爱音箱静默执行",
+        action=argparse.BooleanOptionalAction,
+        default=True,
+        help="小爱音箱静默执行（默认开启；使用 --no-quiet 播报回复）",
+    )
+
+    play = subparsers.add_parser(
+        'play',
+        help="通过小爱音箱播放指定文本",
+    )
+    play.set_defaults(func='play')
+    play.add_argument(
+        '-p', '--auth_path',
+        type=Path,
+        default=Path.home() / ".config" / "mijia-api" / "auth.json",
+        help="认证文件保存路径，默认保存在 ~/.config/mijia-api/auth.json",
+    )
+    play.add_argument(
+        'text',
+        type=str,
+        help="要通过小爱音箱播放的文本",
+        metavar='TEXT',
+    )
+    play.add_argument(
+        '--wifispeaker_name',
+        type=str,
+        help="指定小爱音箱名称，默认是获取到的第一个小爱音箱",
+        default=None,
     )
 
     mcp_cmd = subparsers.add_parser(
@@ -507,7 +532,7 @@ def main(args):
             run_action(api, args)
         if args.func == 'statistics':
             get_statistics(api, args)
-        if args.func == 'run':
+        if args.func in ('run', 'play'):
             if device_mapping is None:
                 device_mapping = get_devices_list(api, verbose=False)
             if args.wifispeaker_name is None:
@@ -520,7 +545,10 @@ def main(args):
                     raise ValueError("未找到小爱音箱设备")
             else:
                 wifispeaker = mijiaDevice(api, dev_name=args.wifispeaker_name)
-            wifispeaker.run_action('execute-text-directive', _in=[args.prompt, 1 if args.quiet else 0])
+            if args.func == 'run':
+                wifispeaker.run_action('execute-text-directive', _in=[args.prompt, 1 if args.quiet else 0])
+            else:
+                wifispeaker.run_action('play-text', _in=[args.text])
 
 def cli():
     main(sys.argv[1:])

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

@@ -314,7 +314,7 @@ def get_device_info(device_model: str, cache_path: Optional[Union[str, Path]] =
     product = content["props"]["product"]
     name = product["name"]
     model = product["model"]
-    i18n_zh = content["props"]["i18n"]["zh_cn"]
+    i18n_zh = content["props"].get("i18n", {}).get("zh_cn", {})
     result = {
         "version": device_info_version,
         "name": name,

{mijiaapi-4.2.0 → mijiaapi-4.3.0}/mijiaAPI/errors.py

@@ -1,4 +1,4 @@
-# https://github.com/kekeandzeyu/ha_xiaomi_home/blob/main/custom_components/xiaomi_home/miot/i18n/zh-Hans.json
+# https://github.com/XiaoMi/ha_xiaomi_home/blob/main/custom_components/xiaomi_home/miot/i18n/zh-Hans.json
 ERROR_CODE = {
     "-10000": "未知错误",
     "-10001": "服务不可用",

{mijiaapi-4.2.0 → mijiaapi-4.3.0}/mijiaAPI/mcp_server.py

@@ -305,42 +305,54 @@ def get_statistics(
     return json.dumps(ret, ensure_ascii=False)
 
 
+def _find_speaker(api: mijiaAPI, speaker_name: Optional[str]) -> Optional[dict]:
+    devices = api.get_devices_list()
+    if speaker_name is not None:
+        return next((d for d in devices if d["name"] == speaker_name), None)
+    return next((d for d in devices if "xiaomi.wifispeaker" in d["model"]), None)
+
+
 @mcp.tool
 def run_speaker_command(
     prompt: str,
     speaker_name: Optional[str] = None,
-    quiet: bool = False,
+    quiet: bool = True,
 ) -> str:
     """通过小爱音箱执行自然语言指令。
 
     参数:
         prompt: 自然语言指令，如 "打开卧室台灯"、"把亮度调到50%"。
         speaker_name: 可选，指定小爱音箱名称，默认使用获取到的第一个小爱音箱。
-        quiet: 是否静默执行（不语音播报），默认 False。
+        quiet: 是否静默执行（不语音播报），默认 True。
 
     返回执行结果。
     """
     api = _get_api()
     _refresh_if_needed(api)
-    devices = api.get_devices_list()
-    if speaker_name is None:
-        match = None
-        for device in devices:
-            if "xiaomi.wifispeaker" in device["model"]:
-                match = device
-                break
-        if match is None:
-            return "未找到小爱音箱设备"
-    else:
-        matches = [d for d in devices if d["name"] == speaker_name]
-        if not matches:
-            return f"未找到名为 {speaker_name} 的小爱音箱"
-        match = matches[0]
+    match = _find_speaker(api, speaker_name)
+    if match is None:
+        return "未找到小爱音箱设备" if speaker_name is None else f"未找到名为 {speaker_name} 的小爱音箱"
     speaker = mijiaDevice(api, did=match["did"])
     speaker.run_action("execute-text-directive", _in=[prompt, 1 if quiet else 0])
     return f"已通过 {match['name']} 执行: {prompt}"
 
 
+@mcp.tool
+def speaker_play(
+    text: str,
+    speaker_name: Optional[str] = None,
+) -> str:
+    """通过小爱音箱朗读指定文本（play-text），不是执行设备控制指令。"""
+    api = _get_api()
+    _refresh_if_needed(api)
+    match = _find_speaker(api, speaker_name)
+    if match is None:
+        return "未找到小爱音箱设备" if speaker_name is None else f"未找到名为 {speaker_name} 的小爱音箱"
+    speaker = mijiaDevice(api, did=match["did"])
+    speaker.run_action("play-text", _in=[text])
+    return f"已通过 {match['name']} 播放: {text}"
+
+
 def _login_worker(api: mijiaAPI, login_data: dict) -> None:
     try:
         api._complete_qr_login(login_data)

mijiaapi-4.3.0/mijiaAPI/version.py

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

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

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

mijiaapi-4.2.0/mijiaAPI/version.py

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