Xiaomi-cloud-tokens-extractor开发者指南：自定义扩展与二次开发

Xiaomi-cloud-tokens-extractor是一款功能强大的小米云设备令牌提取工具，能够帮助开发者轻松获取小米云连接设备的令牌和BLE设备的加密密钥。本文将详细介绍如何对该工具进行自定义扩展与二次开发，让你快速掌握扩展功能的核心方法。## 快速了解项目结构在开始二次开发前，先熟悉项目的核心文件结构，这将帮助你快速定位需要修改的模块：- **核心功能文件**：[token_

杨剑暖

513人浏览 · 2026-01-25 03:43:17

杨剑暖 · 2026-01-25 03:43:17 发布

Xiaomi-cloud-tokens-extractor开发者指南：自定义扩展与二次开发

【免费下载链接】Xiaomi-cloud-tokens-extractor This tool/script retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices. 项目地址: https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor

Xiaomi-cloud-tokens-extractor是一款功能强大的小米云设备令牌提取工具，能够帮助开发者轻松获取小米云连接设备的令牌和BLE设备的加密密钥。本文将详细介绍如何对该工具进行自定义扩展与二次开发，让你快速掌握扩展功能的核心方法。

快速了解项目结构

在开始二次开发前，先熟悉项目的核心文件结构，这将帮助你快速定位需要修改的模块：

核心功能文件：token_extractor.py 包含所有主要逻辑，包括小米云连接、设备数据获取和令牌解析
依赖管理：requirements.txt 列出项目所需的所有Python依赖包
执行脚本：run.sh 和 run_docker.sh 提供不同环境下的启动方式
打包配置：token_extractor.spec 用于将Python脚本打包为可执行文件

开发环境搭建

基础环境准备

首先克隆项目仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor
cd Xiaomi-cloud-tokens-extractor
pip install -r requirements.txt

关键依赖解析

requirements.txt 中定义了项目的核心依赖：

requests：处理HTTP请求，用于与小米云API通信
pycryptodome：提供加密解密功能，用于处理小米云的RC4加密数据
Pillow：图像处理库，用于验证码和QR码显示
colorama：实现跨平台终端彩色输出

如需添加新功能，可在此文件中添加额外依赖。

核心扩展点解析

1. 认证方式扩展

项目目前支持密码和QR码两种认证方式，你可以通过继承 XiaomiCloudConnector 抽象类添加新的认证方式：

class NewAuthXiaomiCloudConnector(XiaomiCloudConnector):
    def login(self) -> bool:
        # 实现新的认证逻辑
        pass

在 token_extractor.py 中，现有认证方式通过 PasswordXiaomiCloudConnector 和 QrCodeXiaomiCloudConnector 实现，你可以参考这些类的实现方式。

2. 设备数据处理扩展

设备数据获取主要通过 get_devices 方法实现（位于 XiaomiCloudConnector 类中）。如需扩展数据处理能力，可以：

修改 get_devices 方法获取更多设备信息
添加新的API调用方法，如获取设备历史数据
实现自定义数据解析逻辑

例如，添加获取设备固件版本的功能：

def get_device_firmware(self, country, did):
    url = self.get_api_url(country) + "/v2/device/firmware_info"
    params = {"data": '{"did":"' + did + '"}'}
    return self.execute_api_call_encrypted(url, params)

3. 输出格式扩展

当前结果输出支持控制台打印和JSON文件保存。你可以扩展输出格式，如CSV、XML等，修改 token_extractor.py 中的 main 函数：

if args.output:
    if args.output.endswith('.csv'):
        save_as_csv(output, args.output)
    elif args.output.endswith('.xml'):
        save_as_xml(output, args.output)
    else:
        with open(args.output, "w") as f:
            f.write(json.dumps(output, indent=4))

高级功能开发

多线程设备数据获取

为提高设备数据获取速度，可以实现多线程并发请求。参考 token_extractor.py 中的线程使用方式（如图片服务器），为不同服务器或设备并行请求数据。

自定义服务器选择逻辑

默认服务器选择逻辑在 get_servers_to_check 函数中实现。你可以修改此函数，根据用户位置自动选择最佳服务器，或添加服务器可用性检测：

def get_servers_to_check() -> list[str]:
    # 添加服务器ping测试，选择响应最快的服务器
    servers_with_latency = measure_server_latency(SERVERS)
    return sorted(servers_with_latency, key=lambda x: x[1])[:3]  # 返回延迟最低的3个服务器

集成设备控制功能

利用获取的设备令牌，你可以进一步开发设备控制功能。通过小米云API发送控制命令：

def control_device(self, country, did, command):
    url = self.get_api_url(country) + "/v2/device/control"
    params = {"data": json.dumps({
        "did": did,
        "cmd": command
    })}
    return self.execute_api_call_encrypted(url, params)