xiaozhi-sdk 0.1.0__tar.gz → 1.0.0__tar.gz

xiaozhi_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 dairoot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xiaozhi_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: xiaozhi-sdk
+Version: 1.0.0
+Summary: 一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
+Home-page: https://github.com/dairoot/xiaozhi-sdk
+Author: dairoot
+Author-email: 623815825@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: websockets
+Requires-Dist: aiohttp
+Requires-Dist: av
+Requires-Dist: opuslib
+Requires-Dist: requests
+Requires-Dist: sounddevice
+Requires-Dist: python-socks
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 小智SDK (XiaoZhi SDK)
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
+
+一个用于连接和控制小智服务的 Python SDK，支持实时音频通信、MCP 工具集成和设备管理等功能。
+
+---
+
+## 📦 安装
+
+```bash
+pip install xiaozhi-sdk
+```
+
+---
+
+## 🚀 快速开始
+
+### 1. 终端使用
+
+最简单的方式是通过命令行连接设备：
+
+#### 查看帮助信息
+
+```bash
+python -m xiaozhi_sdk -h
+```
+
+输出示例：
+
+```text
+positional arguments:
+  device             你的小智设备的MAC地址 (格式: XX:XX:XX:XX:XX:XX)
+
+options:
+  -h, --help         显示帮助信息并退出
+  --url URL          小智服务 websocket 地址
+  --ota_url OTA_URL  小智 OTA 地址
+```
+
+#### 连接设备（需要提供 MAC 地址）
+
+```bash
+python -m xiaozhi_sdk 00:11:22:33:44:55
+```
+
+### 2. 编程使用
+参考 [examples](examples/) 文件中的示例代码，可以快速开始使用 SDK。
+
+
+

xiaozhi_sdk-1.0.0/README.md

@@ -0,0 +1,53 @@
+# 小智SDK (XiaoZhi SDK)
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
+
+一个用于连接和控制小智服务的 Python SDK，支持实时音频通信、MCP 工具集成和设备管理等功能。
+
+---
+
+## 📦 安装
+
+```bash
+pip install xiaozhi-sdk
+```
+
+---
+
+## 🚀 快速开始
+
+### 1. 终端使用
+
+最简单的方式是通过命令行连接设备：
+
+#### 查看帮助信息
+
+```bash
+python -m xiaozhi_sdk -h
+```
+
+输出示例：
+
+```text
+positional arguments:
+  device             你的小智设备的MAC地址 (格式: XX:XX:XX:XX:XX:XX)
+
+options:
+  -h, --help         显示帮助信息并退出
+  --url URL          小智服务 websocket 地址
+  --ota_url OTA_URL  小智 OTA 地址
+```
+
+#### 连接设备（需要提供 MAC 地址）
+
+```bash
+python -m xiaozhi_sdk 00:11:22:33:44:55
+```
+
+### 2. 编程使用
+参考 [examples](examples/) 文件中的示例代码，可以快速开始使用 SDK。
+
+
+

xiaozhi_sdk-1.0.0/setup.cfg

@@ -0,0 +1,11 @@
+[flake8]
+ignore = E203, E266, E501, W503, F403, F401, E731, E711, C901, F841, D103, B008, D400, E402, E712
+max-line-length = 120
+max-complexity = 20
+exclude = 
+	tests/*
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/setup.py

@@ -2,18 +2,23 @@ from setuptools import find_packages, setup
 
 setup(
     name="xiaozhi-sdk",  # 包名
-    version="0.1.0",  # 版本号
+    version="1.0.0",  # 版本号
     packages=find_packages(),  # 自动发现包
     install_requires=[  # 依赖
         "numpy",
-        "requests>=2.32.1",
-        "sounddevice>=0.4.2",
+        "websockets",
+        "aiohttp",
+        "av",
+        "opuslib",
+        "requests",
+        "sounddevice",
+        "python-socks"
     ],
     author="dairoot",
     author_email="623815825@qq.com",  # 作者邮箱
-    description="A short description of your package",  # 简短描述
-    long_description=open('README.md').read(),  # 详细描述（通常从 README 读取）
-    long_description_content_type='text/markdown',  # README 文件格式
+    description="一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。",  # 简短描述
+    long_description=open("README.md").read(),  # 详细描述（通常从 README 读取）
+    long_description_content_type="text/markdown",  # README 文件格式
     url="https://github.com/dairoot/xiaozhi-sdk",  # 项目主页
     classifiers=[  # 分类元数据
         "Programming Language :: Python :: 3",

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/tests/test_pic.py

@@ -1,6 +1,7 @@
-import aiohttp
 import asyncio
 
+import aiohttp
+
 
 async def explain_image():
     url = "http://api.xiaozhi.me/mcp/vision/explain"
@@ -9,7 +10,6 @@ async def explain_image():
 
     boundary = "----ESP32_CAMERA_BOUNDARY"
     headers = {
-
         "Content-Type": f"multipart/form-data; boundary={boundary}",
         # 不设置Transfer-Encoding，aiohttp自动处理
     }
@@ -42,5 +42,6 @@ async def explain_image():
             text = await resp.text()
             print("Response:", text)
 
+
 if __name__ == "__main__":
     asyncio.run(explain_image())

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/tests/test_xiaozhi.py

@@ -1,11 +1,10 @@
 import asyncio
-import json
 import os
 import sys
 import time
-import wave
 
 import numpy as np
+import pytest
 import sounddevice as sd
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
@@ -13,8 +12,6 @@ sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
 from xiaozhi_sdk import XiaoZhiWebsocket
 from xiaozhi_sdk.utils import read_audio_file
 
-play_audio_over = asyncio.Event()
-
 
 async def assistant_audio_play(audio_queue):
     # 创建一个持续播放的流
@@ -24,7 +21,7 @@ async def assistant_audio_play(audio_queue):
     while True:
         if not audio_queue:
             await asyncio.sleep(0.01)
-            if last_time and time.time() - last_time > 3:
+            if last_time and time.time() - last_time > 1:
                 break
 
             continue
@@ -33,22 +30,20 @@ async def assistant_audio_play(audio_queue):
         stream.write(pcm_data)
         last_time = time.time()
 
-    play_audio_over.set()
     stream.stop()
     stream.close()
 
 
 def mcp_tool_func():
-
     def mcp_take_photo(data):
         return open("./file/leijun.jpg", "rb")
 
     def mcp_get_device_status(data):
         return {
-                "audio_speaker": {"volume": 80},
-                "screen": {"brightness": 75, "theme": "light"},
-                "network": {"type": "wifi", "ssid": "wifi名称", "signal": "strong"},
-            }
+            "audio_speaker": {"volume": 80},
+            "screen": {"brightness": 75, "theme": "light"},
+            "network": {"type": "wifi", "ssid": "wifi名称", "signal": "strong"},
+        }
 
     def mcp_set_volume(data):
         return {}
@@ -61,32 +56,31 @@ def mcp_tool_func():
     return mcp_tool_func
 
 
+async def message_handler_callback(message):
+    print("message received:", message)
 
 
+MAC_ADDR = "fc:01:2c:c9:2b:31"
+# URL = "ws://120.79.156.134:8380"
+URL = None
 
-async def main():
-    async def message_handler_callback(message):
-        print("message received:", message)
 
-    MAC_ADDR = "fc:01:2c:c9:2b:31"
-    url = "ws://120.79.156.134:8380"
-    url = None
-    xiaozhi = XiaoZhiWebsocket(message_handler_callback, url=url)
+@pytest.mark.asyncio
+async def test_main():
+    xiaozhi = XiaoZhiWebsocket(message_handler_callback, url=URL)
     await xiaozhi.set_mcp_tool_callback(mcp_tool_func())
     await xiaozhi.init_connection(MAC_ADDR)
-    asyncio.create_task(assistant_audio_play(xiaozhi.audio_queue))
-    await asyncio.sleep(1)
-    
-    # 使用新的音频读取函数
-    for pcm in read_audio_file("./file/take_photo.wav"):
-    # for pcm in read_audio_file("./file/say_hello.wav"):
-        await xiaozhi.send_audio(pcm)
 
-    # 发送静音数据
+    # say hellow
+    for pcm in read_audio_file("./file/say_hello.wav"):
+        await xiaozhi.send_audio(pcm)
     await xiaozhi.send_silence_audio()
-    await asyncio.wait_for(play_audio_over.wait(), timeout=20.0)
-    await xiaozhi.close()
+    await assistant_audio_play(xiaozhi.audio_queue)
 
+    # say take photo
+    for pcm in read_audio_file("./file/take_photo.wav"):
+        await xiaozhi.send_audio(pcm)
+    await xiaozhi.send_silence_audio()
+    await assistant_audio_play(xiaozhi.audio_queue)
 
-if __name__ == "__main__":
-    asyncio.run(main())
+    await xiaozhi.close()

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/__init__.py

@@ -3,22 +3,24 @@ import json
 import os
 import uuid
 import wave
-import websockets
 from collections import deque
-from typing import Dict
+from typing import Any, Callable, Dict
+
+import websockets
 
 from xiaozhi_sdk.config import INPUT_SERVER_AUDIO_SAMPLE_RATE, WSS_URL
 from xiaozhi_sdk.iot import OtaDevice
 from xiaozhi_sdk.mcp import McpTool
 from xiaozhi_sdk.opus import AudioOpus
-from xiaozhi_sdk.utils import read_audio_file, get_wav_info
+from xiaozhi_sdk.utils import get_wav_info, read_audio_file
 
 
 class XiaoZhiWebsocket(McpTool):
 
-    def __init__(self, message_handler_callback=None, url=None, audio_sample_rate=16000, audio_channels=1):
+    def __init__(self, message_handler_callback=None, url=None, ota_url=None, audio_sample_rate=16000, audio_channels=1):
         super().__init__()
         self.url = url or WSS_URL
+        self.ota_url = ota_url
         self.audio_sample_rate = audio_sample_rate
         self.audio_channels = audio_channels
         self.audio_opus = AudioOpus(audio_sample_rate, audio_channels)
@@ -31,6 +33,7 @@ class XiaoZhiWebsocket(McpTool):
         self.audio_queue = deque()
         self.websocket = None
         self.message_handler_task = None
+        self.ota = None
 
     async def send_hello(self, aec: bool):
         hello_message = {
@@ -49,32 +52,27 @@ class XiaoZhiWebsocket(McpTool):
         await asyncio.wait_for(self.hello_received.wait(), timeout=10.0)
 
     async def start_listen(self):
-        listen_message = {
-            "session_id": self.session_id,
-            "type": "listen",
-            "state": "start",
-            "mode": "realtime"
-        }
+        listen_message = {"session_id": self.session_id, "type": "listen", "state": "start", "mode": "realtime"}
         await self.websocket.send(json.dumps(listen_message))
 
-    async def set_mcp_tool_callback(self, tool_func: Dict[str, callable]):
+    async def set_mcp_tool_callback(self, tool_func: Dict[str, Callable[..., Any]]):
         self.tool_func = tool_func
 
-    async def activate_iot_device(self):
-        ota = OtaDevice(self.mac_addr, self.client_id)
-
-        data = await ota.activate_device()
-        if data.get("activation"):
-            await self.send_demo_get_code_audio()
-            challenge = data["activation"]["challenge"]
+    async def activate_iot_device(self, ota_info):
+        if ota_info.get("activation"):
+            await self.send_demo_audio()
+            challenge = ota_info["activation"]["challenge"]
             await asyncio.sleep(3)
             for _ in range(10):
-                if await ota.check_activate(challenge):
+                if await self.ota.check_activate(challenge):
                     break
                 await asyncio.sleep(3)
 
     async def init_connection(self, mac_addr: str, aec: bool = False):
         self.mac_addr = mac_addr
+        self.ota = OtaDevice(self.mac_addr, self.client_id, self.ota_url)
+        ota_info = await self.ota.activate_device()
+
         headers = {
             "Authorization": "Bearer test-token",
             "Protocol-Version": "1",
@@ -86,9 +84,9 @@ class XiaoZhiWebsocket(McpTool):
         self.message_handler_task = asyncio.create_task(self.message_handler())
         await self.send_hello(aec)
         await self.start_listen()
-        asyncio.create_task(self.activate_iot_device())
+        asyncio.create_task(self.activate_iot_device(ota_info))
 
-    async def send_demo_get_code_audio(self):
+    async def send_demo_audio(self):
         current_dir = os.path.dirname(os.path.abspath(__file__))
         wav_path = os.path.join(current_dir, "../file/greet.wav")
         framerate, nchannels = get_wav_info(wav_path)
@@ -97,6 +95,7 @@ class XiaoZhiWebsocket(McpTool):
         for pcm_data in read_audio_file(wav_path):
             opus_data = await audio_opus.pcm_to_opus(pcm_data)
             await self.websocket.send(opus_data)
+        await self.send_silence_audio()
 
     async def send_silence_audio(self, duration_seconds: float = 1.2):
         # 发送 静音数据
@@ -141,7 +140,8 @@ class XiaoZhiWebsocket(McpTool):
         except websockets.ConnectionClosed:
             if self.message_handler_callback:
                 await self.message_handler_callback(
-                    {"type": "websocket", "state": "close", "source": "sdk.message_handler"})
+                    {"type": "websocket", "state": "close", "source": "sdk.message_handler"}
+                )
 
     async def close(self):
         if self.message_handler_task and not self.message_handler_task.done():

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/__main__.py

@@ -1,15 +1,15 @@
 import argparse
 import asyncio
+import numpy as np
 import re
+import sounddevice as sd
 import time
 from collections import deque
 
-import numpy as np
-import sounddevice as sd
-
 from xiaozhi_sdk import XiaoZhiWebsocket
+from xiaozhi_sdk.config import INPUT_SERVER_AUDIO_SAMPLE_RATE
 
-input_audio = deque()
+input_audio: deque[bytes] = deque()
 
 is_play_audio = False
 
@@ -21,7 +21,7 @@ async def message_handler_callback(message):
 async def assistant_audio_play(audio_queue):
     global is_play_audio
     # 创建一个持续播放的流
-    stream = sd.OutputStream(samplerate=16000, channels=1, dtype=np.int16)
+    stream = sd.OutputStream(samplerate=INPUT_SERVER_AUDIO_SAMPLE_RATE, channels=1, dtype=np.int16)
     stream.start()
     last_time = None
 
@@ -40,13 +40,14 @@ async def assistant_audio_play(audio_queue):
 
 
 class Client:
-    def __init__(self, mac_address):
+    def __init__(self, mac_address, url=None, ota_url=None):
         self.mac_address = mac_address
         self.xiaozhi = None
-        pass
+        self.url = url
+        self.ota_url = ota_url
 
     async def start(self):
-        self.xiaozhi = XiaoZhiWebsocket(message_handler_callback)
+        self.xiaozhi = XiaoZhiWebsocket(message_handler_callback, url=self.url, ota_url=self.ota_url)
         await self.xiaozhi.init_connection(self.mac_address, aec=False)
         asyncio.create_task(assistant_audio_play(self.xiaozhi.audio_queue))
 
@@ -66,7 +67,7 @@ class Client:
 
 def mac_address(string):
     """验证是否为有效的MAC地址"""
-    if re.fullmatch(r'([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}', string):
+    if re.fullmatch(r"([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}", string):
         return string
     else:
         raise argparse.ArgumentTypeError(f"无效的MAC地址格式: '{string}'")
@@ -74,10 +75,13 @@ def mac_address(string):
 
 async def main():
     parser = argparse.ArgumentParser(description="这是一个小智SDK。")
-    parser.add_argument('device', type=mac_address, help='你的小智设备的MAC地址 (格式: XX:XX:XX:XX:XX:XX)')
+    parser.add_argument("device", type=mac_address, help="你的小智设备的MAC地址 (格式: XX:XX:XX:XX:XX:XX)")
+    parser.add_argument("--url", help="小智服务 websocket 地址")
+    parser.add_argument("--ota_url", help="小智 OTA 地址")
+
 
     args = parser.parse_args()
-    client = Client(args.device)
+    client = Client(args.device, args.url, args.ota_url)
     await client.start()
     await asyncio.sleep(2)
 

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/data.py

@@ -1,4 +1,6 @@
-mcp_initialize_payload = {
+from typing import Any, Dict, List
+
+mcp_initialize_payload: Dict[str, Any] = {
     "jsonrpc": "2.0",
     "id": 1,
     "result": {
@@ -8,7 +10,7 @@ mcp_initialize_payload = {
     },
 }
 
-mcp_tool_conf = {
+mcp_tool_conf: Dict[str, Dict[str, Any]] = {
     "get_device_status": {
         "description": "Provides the real-time information of the device, including the current status of the audio speaker, screen, battery, network, etc.\nUse this tool for: \n1. Answering questions about current condition (e.g. what is the current volume of the audio speaker?)\n2. As the first step to control the device (e.g. turn up / down the volume of the audio speaker, etc.)",
         "inputSchema": {"type": "object", "properties": {}},
@@ -51,7 +53,7 @@ mcp_tool_conf = {
     },
 }
 
-mcp_tools_payload = {
+mcp_tools_payload: Dict[str, Any] = {
     "jsonrpc": "2.0",
     "id": 2,
     "result": {"tools": []},

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/iot.py

@@ -1,14 +1,16 @@
-import aiohttp
 import json
 
+import aiohttp
 from xiaozhi_sdk.config import OTA_URL
 
+
 USER_AGENT = "XiaoXhi-SDK/1.0"
 
 
 class OtaDevice(object):
 
-    def __init__(self, mac_addr: str, client_id: str, serial_number: str = ""):
+    def __init__(self, mac_addr: str, client_id: str, ota_url: str, serial_number: str = ""):
+        self.ota_url = ota_url or OTA_URL
         self.mac_addr = mac_addr
         self.client_id = client_id
         self.serial_number = serial_number
@@ -29,12 +31,12 @@ class OtaDevice(object):
             },
         }
         async with aiohttp.ClientSession() as session:
-            async with session.post(OTA_URL, headers=header, data=json.dumps(payload)) as response:
+            async with session.post(self.ota_url, headers=header, data=json.dumps(payload)) as response:
                 data = await response.json()
                 return data
 
     async def check_activate(self, challenge: str):
-        url = OTA_URL + "/activate"
+        url = self.ota_url + "/activate"
         header = {
             "user-agent": USER_AGENT,
             "Device-Id": self.mac_addr,

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/mcp.py

@@ -3,7 +3,7 @@ import json
 import requests
 
 from xiaozhi_sdk.config import VL_URL
-from xiaozhi_sdk.data import mcp_initialize_payload, mcp_tools_payload, mcp_tool_conf
+from xiaozhi_sdk.data import mcp_initialize_payload, mcp_tool_conf, mcp_tools_payload
 
 
 class McpTool(object):
@@ -18,14 +18,16 @@ class McpTool(object):
         return json.dumps({"session_id": self.session_id, "type": "mcp", "payload": payload})
 
     def _build_response(self, request_id: str, content: str, is_error: bool = False):
-        return self.get_mcp_json({
-            "jsonrpc": "2.0",
-            "id": request_id,
-            "result": {
-                "content": [{"type": "text", "text": content}],
-                "isError": is_error,
-            },
-        })
+        return self.get_mcp_json(
+            {
+                "jsonrpc": "2.0",
+                "id": request_id,
+                "result": {
+                    "content": [{"type": "text", "text": content}],
+                    "isError": is_error,
+                },
+            }
+        )
 
     async def analyze_image(self, img_byte: bytes, question: str = "这张图片里有什么？"):
         headers = {"Authorization": f"Bearer {self.vl_token}"}
@@ -38,12 +40,12 @@ class McpTool(object):
     async def mcp_tool_call(self, mcp_json: dict):
         tool_name = mcp_json["params"]["name"]
         tool_func = self.tool_func[tool_name]
-        
+
         if tool_name == "take_photo":
             res = await self.analyze_image(tool_func(None), mcp_json["params"]["arguments"]["question"])
         else:
             res = tool_func(mcp_json["params"]["arguments"])
-        
+
         content = json.dumps(res, ensure_ascii=False)
         return self._build_response(mcp_json["id"], content)
 

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/opus.py

@@ -1,4 +1,5 @@
 import os
+
 from xiaozhi_sdk import INPUT_SERVER_AUDIO_SAMPLE_RATE
 
 # 设置 opus 库路径

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk/utils.py

@@ -5,13 +5,14 @@ def get_wav_info(file_path):
     with wave.open(file_path, "rb") as wav_file:
         return wav_file.getframerate(), wav_file.getnchannels()
 
+
 def read_audio_file(file_path):
     """
     读取音频文件并通过yield返回PCM流
-    
+
     Args:
         file_path (str): 音频文件路径
-        
+
     Yields:
         bytes: PCM音频数据块
     """
@@ -20,4 +21,4 @@ def read_audio_file(file_path):
             pcm = wav_file.readframes(960)  # 每次读取960帧（60ms的音频数据）
             if not pcm:
                 break
-            yield pcm
+            yield pcm

xiaozhi_sdk-1.0.0/xiaozhi_sdk.egg-info/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: xiaozhi-sdk
+Version: 1.0.0
+Summary: 一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
+Home-page: https://github.com/dairoot/xiaozhi-sdk
+Author: dairoot
+Author-email: 623815825@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: websockets
+Requires-Dist: aiohttp
+Requires-Dist: av
+Requires-Dist: opuslib
+Requires-Dist: requests
+Requires-Dist: sounddevice
+Requires-Dist: python-socks
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 小智SDK (XiaoZhi SDK)
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
+
+一个用于连接和控制小智服务的 Python SDK，支持实时音频通信、MCP 工具集成和设备管理等功能。
+
+---
+
+## 📦 安装
+
+```bash
+pip install xiaozhi-sdk
+```
+
+---
+
+## 🚀 快速开始
+
+### 1. 终端使用
+
+最简单的方式是通过命令行连接设备：
+
+#### 查看帮助信息
+
+```bash
+python -m xiaozhi_sdk -h
+```
+
+输出示例：
+
+```text
+positional arguments:
+  device             你的小智设备的MAC地址 (格式: XX:XX:XX:XX:XX:XX)
+
+options:
+  -h, --help         显示帮助信息并退出
+  --url URL          小智服务 websocket 地址
+  --ota_url OTA_URL  小智 OTA 地址
+```
+
+#### 连接设备（需要提供 MAC 地址）
+
+```bash
+python -m xiaozhi_sdk 00:11:22:33:44:55
+```
+
+### 2. 编程使用
+参考 [examples](examples/) 文件中的示例代码，可以快速开始使用 SDK。
+
+
+

{xiaozhi_sdk-0.1.0 → xiaozhi_sdk-1.0.0}/xiaozhi_sdk.egg-info/SOURCES.txt

@@ -1,4 +1,6 @@
+LICENSE
 README.md
+setup.cfg
 setup.py
 tests/test_pic.py
 tests/test_xiaozhi.py

xiaozhi_sdk-1.0.0/xiaozhi_sdk.egg-info/requires.txt

@@ -0,0 +1,8 @@
+numpy
+websockets
+aiohttp
+av
+opuslib
+requests
+sounddevice
+python-socks

xiaozhi_sdk-0.1.0/PKG-INFO

@@ -1,58 +0,0 @@
-Metadata-Version: 2.4
-Name: xiaozhi-sdk
-Version: 0.1.0
-Summary: A short description of your package
-Home-page: https://github.com/dairoot/xiaozhi-sdk
-Author: dairoot
-Author-email: 623815825@qq.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: numpy
-Requires-Dist: requests>=2.32.1
-Requires-Dist: sounddevice>=0.4.2
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# 小智SDK (XiaoZhi SDK)
-
-[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
-
-一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
-
-
-## 📦 安装
-
-```bash
-pip install xiaozhi-sdk
-```
-
-
-## 🚀 快速开始
-
-### 命令行使用
-
-最简单的使用方式是通过命令行连接设备：
-
-```bash
-# 查看帮助信息
-python -m xiaozhi_sdk -h
-
-# 连接设备（需要提供MAC地址）
-python -m xiaozhi_sdk 00:11:22:33:44:55
-```
-
-### 编程使用
-...
-

xiaozhi_sdk-0.1.0/README.md

@@ -1,33 +0,0 @@
-# 小智SDK (XiaoZhi SDK)
-
-[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
-
-一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
-
-
-## 📦 安装
-
-```bash
-pip install xiaozhi-sdk
-```
-
-
-## 🚀 快速开始
-
-### 命令行使用
-
-最简单的使用方式是通过命令行连接设备：
-
-```bash
-# 查看帮助信息
-python -m xiaozhi_sdk -h
-
-# 连接设备（需要提供MAC地址）
-python -m xiaozhi_sdk 00:11:22:33:44:55
-```
-
-### 编程使用
-...
-

xiaozhi_sdk-0.1.0/setup.cfg

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

xiaozhi_sdk-0.1.0/xiaozhi_sdk.egg-info/PKG-INFO

@@ -1,58 +0,0 @@
-Metadata-Version: 2.4
-Name: xiaozhi-sdk
-Version: 0.1.0
-Summary: A short description of your package
-Home-page: https://github.com/dairoot/xiaozhi-sdk
-Author: dairoot
-Author-email: 623815825@qq.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: numpy
-Requires-Dist: requests>=2.32.1
-Requires-Dist: sounddevice>=0.4.2
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# 小智SDK (XiaoZhi SDK)
-
-[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)
-
-一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
-
-
-## 📦 安装
-
-```bash
-pip install xiaozhi-sdk
-```
-
-
-## 🚀 快速开始
-
-### 命令行使用
-
-最简单的使用方式是通过命令行连接设备：
-
-```bash
-# 查看帮助信息
-python -m xiaozhi_sdk -h
-
-# 连接设备（需要提供MAC地址）
-python -m xiaozhi_sdk 00:11:22:33:44:55
-```
-
-### 编程使用
-...
-

xiaozhi_sdk-0.1.0/xiaozhi_sdk.egg-info/requires.txt

@@ -1,3 +0,0 @@
-numpy
-requests>=2.32.1
-sounddevice>=0.4.2