feyagate-skill 1.2.2__tar.gz

feyagate_skill-1.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 panzuji
+
+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.

feyagate_skill-1.2.2/PKG-INFO

@@ -0,0 +1,585 @@
+Metadata-Version: 2.4
+Name: feyagate-skill
+Version: 1.2.2
+Summary: MCP Smart Home Gateway for AI Agents - Control Xiaomi, Tuya, Midea, eWeLink devices via MCP protocol
+Author-email: panzuji <598432467@qq.com>
+License: MIT
+Project-URL: Homepage, https://www.feyagate.com
+Project-URL: Repository, https://github.com/toddpan/feyagate-skill
+Project-URL: Documentation, https://github.com/toddpan/feyagate-skill#readme
+Keywords: mcp,smart-home,iot,xiaomi,tuya,midea,ewelink,ai-agent,home-automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# FeyaGate Skill — MCP Smart Home Gateway for AI Agents
+
+[中文](#中文) | [English](#english)
+
+**MCP Server** | **Smart Home** | **IoT Gateway** | **AI Agent Skill**
+
+[![MCP](https://img.shields.io/badge/Protocol-MCP-blue)](https://modelcontextprotocol.io)
+[![Platforms](https://img.shields.io/badge/AI_Agents-OpenClaw%20%7C%20Claude%20Code%20%7C%20Hermes%20%7C%20Codex%20%7C%20Windsurf-green)](#)
+[![Devices](https://img.shields.io/badge/Devices-Xiaomi%20%7C%20Tuya%20%7C%20Midea%20%7C%20eWeLink-orange)](#)
+
+---
+
+<a id="english"></a>
+
+FeyaGate (飞阳网关) is an **MCP (Model Context Protocol) smart home gateway skill** that enables AI agents — **OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI** and other AI coding assistants — to directly control smart home devices through a unified MCP interface.
+
+Based on [miloco-mcp-server](https://gitee.com/panjyang/miloco-mcp-server), it provides cross-platform device control for **Xiaomi/Mi Home, Tuya, Midea, eWeLink**, camera monitoring with P2P streaming, Xiao AI speaker control, scheduled automation, and persistent memory — all accessible as MCP tools for any compatible AI agent.
+
+**Website:** [www.feyagate.com](https://www.feyagate.com)
+
+### Supported AI Agents
+
+| AI Agent | Status | Integration |
+|----------|--------|-------------|
+| **OpenClaw** | Supported | MCP Skill auto-install |
+| **Claude Code** | Supported | MCP config auto-setup |
+| **Hermes** | Supported | MCP Skill auto-install |
+| **Codex** | Supported | MCP Skill auto-install |
+| **Windsurf** | Supported | MCP config auto-setup |
+| **Copilot** | Supported | MCP config auto-setup |
+| **小智AI (Xiaozhi AI)** | Supported | MCP Skill auto-install |
+| **Cursor** | Supported | MCP config auto-setup |
+
+## Project Structure
+
+```
+feyagate-skill/
+├── SKILL.md                    # AI Agent Skill definition (MCP tool descriptions)
+├── README.md                   # Project README (this file)
+├── QUICKSTART.md               # Quick start guide
+├── reference.md                # Full MCP API reference
+│
+├── config/                     # Config templates (version-controlled)
+│   ├── config.yaml.example     # Config example
+│   └── camera_extra_info.yaml  # Camera extra info
+│
+├── scripts/                    # Management scripts (version-controlled)
+│   ├── install.sh / install.ps1  # One-click online installation
+│   ├── upgrade.sh / upgrade.ps1  # Online upgrade (version compare, backup & rollback)
+│   ├── setup.sh / setup.bat    # Auto-detect platform & extract release package
+│   ├── verify.sh / verify.bat  # Verify installation integrity
+│   ├── start.sh / start.bat    # Start service
+│   ├── stop.sh / stop.bat      # Stop service
+│   ├── health_check.sh / .bat  # Health check
+│   ├── auth.py                 # Mi Home OAuth authorization (cross-platform)
+│   ├── snapshot.py             # Camera snapshot tool
+│   └── scheduled_analysis.py   # Scheduled AI analysis
+│
+├── packages/                   # Downloaded release packages (gitignored)
+├── bin/                        # Binary files (auto-filled by setup, gitignored)
+├── lib/                        # Dynamic libraries (auto-filled by setup, gitignored)
+├── data/                       # Runtime data (gitignored)
+└── webui/                      # Web UI (auto-extracted by setup, gitignored)
+```
+
+## Platform Support
+
+| Platform | Release Package | Binary | Libraries |
+|----------|----------------|--------|-----------|
+| macOS Intel | `miloco-mcp-server-*-Darwin-x86_64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.dylib` |
+| macOS ARM | `miloco-mcp-server-*-Darwin-arm64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.dylib` |
+| Linux x86_64 | `miloco-mcp-server-*-Linux-x86_64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.so` |
+| Windows x64 | `miloco-mcp-server-*-Windows-x86_64.zip` | `bin/miloco-mcp-server.exe` | `lib/*.dll` |
+
+## Installation
+
+### Option 0: Install via AI Assistant (Easiest)
+
+Just send the message below to your AI assistant — it will read the guide and install FeyaGate Skill for you automatically.
+
+> **Supported AI Agents:** OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI, Cursor, and other MCP-compatible AI coding agents.
+
+**Copy and paste this prompt:**
+
+```
+Please read https://github.com/toddpan/feyagate-skill/blob/main/QUICKSTART.md and follow the instructions to install and set up FeyaGate Skill on my machine.
+```
+
+The AI assistant will automatically:
+1. Detect your OS and architecture
+2. Run the one-click install script
+3. Configure and start the service
+
+### Option 1: One-Click Online Install (Recommended)
+
+Automatically fetches the latest version from the server — download, extract, and configure in one step:
+
+**macOS / Linux:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex
+```
+
+Custom install directory:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash -s -- --dir ~/my-skill
+
+# Windows
+$env:FEYAGATE_INSTALL_DIR="D:\my-skill"; iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex
+```
+
+The install script automatically:
+1. Fetches the latest version info from [fota.json](https://oneapi.sooncore.com/ota/fota.json)
+2. Clones the feyagate-skill repository (with scripts and config templates)
+3. Downloads the binary release package for your platform and verifies MD5
+4. Extracts the binary to `bin/`, libraries to `lib/`, WebUI to `webui/`
+5. Creates the default `config/config.yaml` and `data/` directory
+
+### Option 2: Manual Installation
+
+#### Step 1: Clone the Repository
+
+```bash
+git clone https://github.com/toddpan/feyagate-skill.git
+cd feyagate-skill
+```
+
+#### Step 2: Download the Release Package
+
+**Download from website:** Visit [www.feyagate.com](https://www.feyagate.com) to download the Skill package for your platform, then place it in the `packages/` directory.
+
+**Direct download links:**
+
+```bash
+# macOS Intel
+curl -L -o packages/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz"
+
+# Linux x86_64
+curl -L -o packages/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz"
+
+# Windows x64
+curl -L -o packages/miloco-mcp-server-VERSION-Windows-x86_64.zip \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Windows-x86_64.zip"
+```
+
+> Tip: Get the latest version info at https://oneapi.sooncore.com/ota/fota.json (search for `feyagate-skill-*` entries).
+
+#### Step 3: Run Setup
+
+```bash
+# macOS / Linux
+bash scripts/setup.sh
+
+# Windows
+scripts\setup.bat
+
+# Or specify a package path
+bash scripts/setup.sh --package /path/to/miloco-mcp-server-*.tar.gz
+```
+
+#### Step 4: Configuration
+
+Edit `config/config.yaml` to set cloud region and other parameters:
+
+```yaml
+server:
+  http_port: 38080
+  bind_address: "0.0.0.0"
+auth:
+  cloud_server: "cn"      # cn / de / sg / us / ru / i2
+```
+
+### Start & Authorize
+
+```bash
+bash scripts/start.sh                # Start MCP Server
+python3 scripts/auth.py              # First-time Mi Home account authorization
+bash scripts/health_check.sh         # Verify status
+```
+
+## Service Management
+
+| Action | macOS / Linux | Windows |
+|--------|---------------|---------|
+| Install/Extract | `bash scripts/setup.sh` | `scripts\setup.bat` |
+| Verify Installation | `bash scripts/verify.sh` | `scripts\verify.bat` |
+| Start | `bash scripts/start.sh` | `scripts\start.bat` |
+| Stop | `bash scripts/stop.sh` | `scripts\stop.bat` |
+| Health Check | `bash scripts/health_check.sh` | `scripts\health_check.bat` |
+| Custom Port | `bash scripts/start.sh --port 9090` | `scripts\start.bat --port 9090` |
+| Online Upgrade | `bash scripts/upgrade.sh` | `powershell -File scripts\upgrade.ps1` |
+| Check for Updates | `bash scripts/upgrade.sh --check` | `powershell -File scripts\upgrade.ps1 -Check` |
+
+## MCP Tool Overview
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Device Discovery** | device/list, device/specs, platform/status, gateway/info | Cross-platform device management & status query |
+| **Xiaomi Control** | xiaomi/get_properties, xiaomi/set_property, xiaomi/execute_action | MIOT protocol device read/write & actions |
+| **Xiaomi Auth** | xiaomi/auth_status, xiaomi/auth_url, xiaomi/auth_callback | OAuth authorization management |
+| **Scenes** | scene/list, scene/trigger | Cross-platform scene management |
+| **Xiao AI Speaker** | xiaoai/tts, xiaoai/play_music, xiaoai/control | TTS, music, voice control |
+| **Camera** | xiaomi/camera_list, xiaomi/camera_connect, xiaomi/camera_snapshot, etc. | P2P connection, JPEG capture |
+| **Tuya** | tuya/get_properties, tuya/set_property | Tuya device control |
+| **Midea** | midea/get_properties, midea/set_property, midea/execute_action | Midea device control |
+| **eWeLink** | ewelink/get_properties, ewelink/set_property, ewelink/execute_action | eWeLink device control |
+| **Rooms** | room/list, room/set_device | Room management |
+| **Memory** | memory/read, memory/add, memory/search, memory/note, etc. | Long-term memory & daily notes |
+| **Scheduling** | schedule/add, schedule/list, schedule/get, etc. | Scheduled tasks |
+| **Serial/GPIO** | serial/*, gpio/* | Extended device control |
+
+For detailed API documentation, see [SKILL.md](SKILL.md), [FeyaGate_MCP_API.md](FeyaGate_MCP_API.md), and [FeyaGate_HTTP_API.md](FeyaGate_HTTP_API.md).
+
+## Upgrade
+
+### Online Upgrade (Recommended)
+
+Automatically fetches the latest version with version comparison, backup/rollback, and service lifecycle management:
+
+**Check for new versions:**
+
+```bash
+# macOS / Linux
+bash scripts/upgrade.sh --check
+
+# Windows
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Check
+```
+
+**Perform upgrade:**
+
+```bash
+# macOS / Linux (interactive confirmation)
+bash scripts/upgrade.sh
+
+# macOS / Linux (non-interactive, for automation)
+bash scripts/upgrade.sh --yes
+
+# Windows (interactive confirmation)
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1
+
+# Windows (non-interactive)
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Yes
+```
+
+Upgrade flow: stop service -> backup bin/ + lib/ -> download new version -> MD5 verify -> extract & install -> write version -> restart service -> health check. If any step fails, it automatically rolls back to the backup.
+
+### Manual Upgrade
+
+When online upgrade is unavailable:
+
+```bash
+bash scripts/stop.sh                                          # Stop current service
+cp ~/Downloads/miloco-mcp-server-NEW-VERSION.tar.gz packages/  # Place new package
+bash scripts/setup.sh                                          # Re-extract (overwrite bin/ lib/)
+bash scripts/start.sh                                          # Start new version
+```
+
+## Developer: Building Release Packages
+
+If you need to compile and package from source:
+
+```bash
+# In the miloco-mcp-server project
+cd miloco-mcp-server
+bash build-desktop-mac.sh --build --server-only   # macOS
+# or
+bash build-desktop-linux.sh --build --server-only  # Linux
+
+# Output: app/release/miloco-mcp-server-VERSION-OS-ARCH.tar.gz
+```
+
+## License
+
+MIT License
+
+---
+
+<a id="中文"></a>
+
+基于 [miloco-mcp-server](https://gitee.com/panjyang/miloco-mcp-server) 的 MCP Skill 封装，提供小米/米家智能设备控制、摄像头监控、小爱音箱控制等能力。
+
+**官网：** [www.feyagate.com](https://www.feyagate.com)
+
+### 支持的 AI 助手
+
+| AI 助手 | 状态 | 集成方式 |
+|---------|------|----------|
+| **OpenClaw** | 已支持 | MCP Skill 自动安装 |
+| **Claude Code** | 已支持 | MCP 配置自动生成 |
+| **Hermes** | 已支持 | MCP Skill 自动安装 |
+| **Codex** | 已支持 | MCP Skill 自动安装 |
+| **Windsurf** | 已支持 | MCP 配置自动生成 |
+| **Copilot** | 已支持 | MCP 配置自动生成 |
+| **小智AI** | 已支持 | MCP Skill 自动安装 |
+| **Cursor** | 已支持 | MCP 配置自动生成 |
+
+## 项目结构
+
+```
+feyagate-skill/
+├── SKILL.md                    # AI Agent Skill 定义（MCP 工具描述）
+├── README.md                   # 项目说明（本文件）
+├── QUICKSTART.md               # 快速开始指南
+├── reference.md                # 完整 MCP API 参考
+│
+├── config/                     # 配置模板（入版本控制）
+│   ├── config.yaml.example     # 配置示例
+│   └── camera_extra_info.yaml  # 摄像头附加信息
+│
+├── scripts/                    # 管理脚本（入版本控制）
+│   ├── install.sh / install.ps1  # 一键在线安装（官方发布）
+│   ├── upgrade.sh / upgrade.ps1  # 在线升级（版本对比、备份回滚）
+│   ├── setup.sh / setup.bat    # 自动检测平台 + 解压发布包
+│   ├── verify.sh / verify.bat  # 验证安装完整性
+│   ├── start.sh / start.bat    # 启动服务
+│   ├── stop.sh / stop.bat      # 停止服务
+│   ├── health_check.sh / .bat  # 健康检查
+│   ├── auth.py                 # 米家 OAuth 授权（跨平台）
+│   ├── snapshot.py             # 摄像头抓拍工具
+│   └── scheduled_analysis.py   # 定时 AI 分析
+│
+├── packages/                   # 放入下载的发布包（gitignored）
+├── bin/                        # 二进制文件（setup 自动填充，gitignored）
+├── lib/                        # 动态库（setup 自动填充，gitignored）
+├── data/                       # 运行时数据（gitignored）
+└── webui/                      # Web UI（setup 自动解压，gitignored）
+```
+
+## 平台支持
+
+| 平台 | 发布包格式 | 二进制 | 动态库 |
+|------|-----------|--------|--------|
+| macOS Intel | `miloco-mcp-server-*-Darwin-x86_64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.dylib` |
+| macOS ARM | `miloco-mcp-server-*-Darwin-arm64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.dylib` |
+| Linux x86_64 | `miloco-mcp-server-*-Linux-x86_64.tar.gz` | `bin/miloco-mcp-server` | `lib/*.so` |
+| Windows x64 | `miloco-mcp-server-*-Windows-x86_64.zip` | `bin/miloco-mcp-server.exe` | `lib/*.dll` |
+
+## 安装
+
+### 方式零：让 AI 助手帮你安装（最简单）
+
+直接把下面的消息发给你的 AI 助手，它会自动阅读安装指南并为你完成安装。
+
+> **支持：** OpenClaw、Claude Code、Hermes、Codex、Windsurf、Copilot、小智AI、Cursor 等各类 MCP 兼容 AI 编程助手。
+
+**复制以下提示词发送：**
+
+```
+请阅读 https://github.com/toddpan/feyagate-skill/blob/main/QUICKSTART.md 并按照指南在我的机器上安装和配置 FeyaGate Skill。
+```
+
+AI 助手会自动：
+1. 检测你的操作系统和架构
+2. 执行一键安装脚本
+3. 完成配置并启动服务
+
+### 方式一：一键在线安装（推荐）
+
+自动从服务器获取最新版本，下载、解压、配置一步到位：
+
+**macOS / Linux:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex
+```
+
+自定义安装目录：
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash -s -- --dir ~/my-skill
+
+# Windows
+$env:FEYAGATE_INSTALL_DIR="D:\my-skill"; iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex
+```
+
+安装脚本会自动：
+1. 从 [fota.json](https://oneapi.sooncore.com/ota/fota.json) 获取最新版本信息
+2. 克隆 feyagate-skill 仓库（含脚本和配置模板）
+3. 下载对应平台的二进制发布包并校验 MD5
+4. 解压二进制文件到 `bin/`，动态库到 `lib/`，WebUI 到 `webui/`
+5. 创建默认 `config/config.yaml` 和 `data/` 目录
+
+### 方式二：手动安装
+
+#### Step 1: 克隆仓库
+
+```bash
+git clone https://github.com/toddpan/feyagate-skill.git
+cd feyagate-skill
+```
+
+#### Step 2: 下载发布包
+
+**从官网下载：** 访问 [www.feyagate.com](https://www.feyagate.com) 下载对应平台的 Skill 包，放入 `packages/` 目录。
+
+**直接下载链接：**
+
+```bash
+# macOS Intel
+curl -L -o packages/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz"
+
+# Linux x86_64
+curl -L -o packages/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz"
+
+# Windows x64
+curl -L -o packages/miloco-mcp-server-VERSION-Windows-x86_64.zip \
+  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Windows-x86_64.zip"
+```
+
+> 提示：最新版本信息可通过 https://oneapi.sooncore.com/ota/fota.json 获取（搜索 `feyagate-skill-*` 类型的条目）。
+
+#### Step 3: 运行 Setup
+
+```bash
+# macOS / Linux
+bash scripts/setup.sh
+
+# Windows
+scripts\setup.bat
+
+# 或指定包路径
+bash scripts/setup.sh --package /path/to/miloco-mcp-server-*.tar.gz
+```
+
+#### Step 4: 配置
+
+编辑 `config/config.yaml`，设置云端区域等参数：
+
+```yaml
+server:
+  http_port: 38080
+  bind_address: "0.0.0.0"
+auth:
+  cloud_server: "cn"      # cn / de / sg / us / ru / i2
+```
+
+### 启动并授权
+
+```bash
+bash scripts/start.sh                # 启动 MCP Server
+python3 scripts/auth.py              # 首次授权米家账号
+bash scripts/health_check.sh         # 验证状态
+```
+
+## 服务管理
+
+| 操作 | macOS / Linux | Windows |
+|------|---------------|---------|
+| 安装/解压 | `bash scripts/setup.sh` | `scripts\setup.bat` |
+| 验证安装 | `bash scripts/verify.sh` | `scripts\verify.bat` |
+| 启动 | `bash scripts/start.sh` | `scripts\start.bat` |
+| 停止 | `bash scripts/stop.sh` | `scripts\stop.bat` |
+| 健康检查 | `bash scripts/health_check.sh` | `scripts\health_check.bat` |
+| 自定义端口 | `bash scripts/start.sh --port 9090` | `scripts\start.bat --port 9090` |
+| 在线升级 | `bash scripts/upgrade.sh` | `powershell -File scripts\upgrade.ps1` |
+| 检查更新 | `bash scripts/upgrade.sh --check` | `powershell -File scripts\upgrade.ps1 -Check` |
+
+## MCP 工具概览
+
+| 类别 | 工具 | 说明 |
+|------|------|------|
+| **设备发现** | device/list, device/specs, platform/status, gateway/info | 跨平台设备管理与状态查询 |
+| **小米控制** | xiaomi/get_properties, xiaomi/set_property, xiaomi/execute_action | MIOT 协议设备读写与动作 |
+| **小米授权** | xiaomi/auth_status, xiaomi/auth_url, xiaomi/auth_callback | OAuth 授权管理 |
+| **场景** | scene/list, scene/trigger | 跨平台场景管理 |
+| **小爱音箱** | xiaoai/tts, xiaoai/play_music, xiaoai/control | TTS、音乐、语音控制 |
+| **摄像头** | xiaomi/camera_list, xiaomi/camera_connect, xiaomi/camera_snapshot 等 | P2P 连接、JPEG 抓拍 |
+| **涂鸦** | tuya/get_properties, tuya/set_property | 涂鸦设备控制 |
+| **美的** | midea/get_properties, midea/set_property, midea/execute_action | 美的设备控制 |
+| **易微联** | ewelink/get_properties, ewelink/set_property, ewelink/execute_action | eWeLink 设备控制 |
+| **房间** | room/list, room/set_device | 房间管理 |
+| **记忆** | memory/read, memory/add, memory/search, memory/note 等 | 长期记忆与每日笔记 |
+| **定时任务** | schedule/add, schedule/list, schedule/get 等 | 定时调度 |
+| **串口/GPIO** | serial/*, gpio/* | 扩展设备控制 |
+
+详细 API 文档见 [SKILL.md](SKILL.md)、[FeyaGate_MCP_API.md](FeyaGate_MCP_API.md) 和 [FeyaGate_HTTP_API.md](FeyaGate_HTTP_API.md)。
+
+## 升级
+
+### 在线升级（推荐）
+
+自动从服务器获取最新版本，支持版本对比、备份回滚和服务生命周期管理：
+
+**检查是否有新版本：**
+
+```bash
+# macOS / Linux
+bash scripts/upgrade.sh --check
+
+# Windows
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Check
+```
+
+**执行升级：**
+
+```bash
+# macOS / Linux（交互式确认）
+bash scripts/upgrade.sh
+
+# macOS / Linux（非交互模式，适合自动化）
+bash scripts/upgrade.sh --yes
+
+# Windows（交互式确认）
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1
+
+# Windows（非交互模式）
+powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Yes
+```
+
+升级流程：停止服务 -> 备份 bin/ + lib/ -> 下载新版本 -> MD5 校验 -> 解压安装 -> 写入版本号 -> 重启服务 -> 健康检查。任何步骤失败将自动回滚到备份版本。
+
+### 手动升级
+
+当在线升级不可用时，可手动操作：
+
+```bash
+bash scripts/stop.sh                                          # 停止当前服务
+cp ~/Downloads/miloco-mcp-server-NEW-VERSION.tar.gz packages/  # 放入新包
+bash scripts/setup.sh                                          # 重新解压（覆盖 bin/ lib/）
+bash scripts/start.sh                                          # 启动新版本
+```
+
+## 开发者：打包发布包
+
+如果你需要从源码编译并打包：
+
+```bash
+# 在 miloco-mcp-server 项目中
+cd miloco-mcp-server
+bash build-desktop-mac.sh --build --server-only   # macOS
+# 或
+bash build-desktop-linux.sh --build --server-only  # Linux
+
+# 产出: app/release/miloco-mcp-server-VERSION-OS-ARCH.tar.gz
+```
+
+## 许可证
+
+MIT License