📋 安装指南
安装并配置 WyseOS Python SDK，以使用最新会话协议。
环境要求
- Python 3.9+
- macOS、Linux 或 Windows
从 PyPI 安装
pip install wyseos-sdk从源码安装
git clone https://github.com/WyseOS/wyseos-sdk-python
cd wyseos-sdk-python
python -m venv .venv激活虚拟环境：
- macOS/Linux：
source .venv/bin/activate- Windows（PowerShell）：
.\.venv\Scripts\Activate.ps1安装依赖并安装本地包：
pip install -e .基础验证
from wyseos.mate import Client, ClientOptions
client = Client(ClientOptions(api_key="your-api-key"))
print("SDK loaded, base_url:", client.base_url)配置
创建 mate.yaml：
mate:
# Use one of api_key or jwt_token
api_key: "your-api-key"
# jwt_token: "your-jwt-token"
base_url: "https://api.wyseos.com"
timeout: 30加载配置：
from wyseos.mate import Client, ClientOptions
from wyseos.mate.config import load_config
try:
client = Client(load_config("mate.yaml"))
except Exception:
client = Client(ClientOptions(api_key="your-api-key"))认证说明
- HTTP：
api_key->x-api-keyjwt_token->Authorization（不带Bearer前缀）
- WebSocket：
- API Key query:
?api_key=... - JWT query:
?authorization=...
- API Key query: