MijiaLAN 0.2.0

MijiaLAN 0.2.0

简体中文

原生 macOS 版，Build 26。支持 macOS 15 及以上，同一安装包适用于 Apple 芯片和 Intel。

• 在「设置 → 管理家庭设备」中展开设备，可分别选择要加入 Apple「家庭」的开关和传感器。关闭某一项前，请留意使用它的场景和自动化。
• 米家智能插座 3 优先显示电源和设备温度，童锁、倒计时和功率限制等收在「高级项目」中。
• 「家庭」中名为「开关 14」之类的项目，在管理页会显示实际功能名，原有名称放在副标题中，方便对照。

可在设置中检查更新，或从 GitHub Releases 下载经 Developer ID 签名和 Apple 公证的安装包。

English

Native macOS release, build 26. Requires macOS 15 or later. The Universal installer supports Apple silicon and Intel.

• Expand a device in Settings → Manage Home Devices to choose which switches and sensors appear in Apple Home. Check any scenes and automations that use an item before turning it off.
• The Xiaomi Smart Plug 3 shows power and device temperature first, with child lock, countdown and power limits under Advanced Controls.
• If Home assigned a label like “Switch 14,” the settings list shows the function as the title and the saved Home name underneath.

Check for updates in Settings or download the Developer ID signed and Apple notarized installer from GitHub Releases.

MijiaLAN Rust 0.2.0 · 正式版 (b16)

MijiaLAN Rust 0.2.0 正式版（构建 16）。

源码：a922c8f214e3d866f36f8de37dd63b75e771477d，CI 构建：Build run 42630856580。发布复用该次已验证的 Release 程序，无需重新编译。

• macOS Apple Silicon / Intel：分别提供 DMG / ZIP，内置 Sparkle 自动更新。Developer ID 签名、Hardened Runtime，App 和 DMG 均完成 Apple 公证及票据验证。
• Windows x64：推荐 MSI 安装包，内置 WinSparkle 自动更新；便携 ZIP 保留为手动更新方式。未做 Authenticode 签名；需要 Microsoft Visual C++ v14 x64 运行库。
• 校验值见 SHA256SUMS.txt。现有 Rust 配置及桥身份继续沿用，Swift 版与 Rust 版数据独立。

构建经过格式、Clippy、Release 测试和包内 CLI 验证；具体支持范围及实机边界见项目说明。

0.2.0 的变化

• 展开「管理家庭设备」中的设备，可逐项选择加入 Apple「家庭」的控件与传感器。关闭一项会影响使用它的场景和自动化，其他服务保留原有的配件和服务编号。
• 米家智能插座 3 将童锁、倒计时和功率限制等开关放在「高级项目」，电源和设备温度保留在设备展开后的列表中。
• 「开关 14」等 Apple「家庭」自动名称显示在功能名称下方，方便和「家庭」中的项目对照。
• NAS 设置向导也可以逐项选择家庭控件。现有 Rust 设备、配对和默认桥接选择可直接沿用。

Linux 和 NAS

• Debian 12 / Ubuntu 24.04 x86_64 桌面版提供 DEB 与便携包。
• 群晖容器版通过 compose.yaml 使用固定摘要的 GHCR 镜像。
• 群晖原生 SPK 是 Geminilake 测试包。已通过解包、非 root 启停、设置码和存储测试，仍需在 DSM 套件中心验收。
• 飞牛 x86_64 FPK 是本地验收包，和 SPK 一起保存在同次 Actions 的 MijiaLAN-NAS-x86_64-b16-test。飞牛应用中心上架另行提交。

Linux / NAS 构建与测试包 · 安装说明

MijiaLAN 0.1.9

MijiaLAN 0.1.9

简体中文

原生 macOS 版，Build 23。支持 macOS 15 及以上，同一安装包适用于 Apple 芯片和 Intel。

• 在设置顶部新增「登录时启动」，登录 Mac 后可自动在菜单栏启动 MijiaLAN。
• 改善 Apple「家庭」的灯具控制。关灯时可直接调高亮度，调到 0 时关灯。按设备确认后的状态更新，减少调光时的滑块回跳。
• 改善 HomeKit 的写入响应与断线恢复，减少控制后卡在「正在更新」的情况。
• 根据空气净化器的 PM2.5 读数显示 HomeKit 空气质量等级，并在 App 中统一显示 µg/m³。
• 本地诊断记录支持滚动保存，便于排查偶发的 HomeKit 与设备通信问题。

安装包经 Developer ID 签名和 Apple 公证，并通过 macOS 15 双架构启动检查。可在设置中检查更新，或从 GitHub Releases 下载安装包。

English

Native macOS release, build 23. Requires macOS 15 or later. The Universal installer supports Apple silicon and Intel.

• Enable Launch at Login at the top of Settings to start MijiaLAN in the menu bar when you log in.
• Raise a light's brightness in Apple Home even when it is off, or set brightness to zero to turn it off. Home gets confirmed device readings, reducing slider jumps during dimming.
• Improve HomeKit write responses and connection recovery so controls spend less time showing Updating.
• Show a HomeKit air quality grade based on the air purifier's PM2.5 reading and display the unit consistently as µg/m³ in the app.
• Rotate local diagnostic captures to help investigate intermittent HomeKit and device communication issues.

Packages are Developer ID signed, Apple notarized, and checked for startup on both CPU architectures running macOS 15. Check for updates in Settings or download the installer from GitHub Releases.

MijiaLAN 0.1.1-rs.15 · Rust 体验版

MijiaLAN Rust 体验版 0.1.1（构建 15）。

源码：1420128c5f55827f26ca99bc6bad1eb8416c9ed5，CI 构建：Build run 42502648117。发布复用该次已验证的 Release 程序，无需重新编译。

• macOS Apple Silicon / Intel：分别提供 DMG / ZIP，内置 Sparkle 自动更新。Developer ID 签名、Hardened Runtime，App 和 DMG 均完成 Apple 公证及票据验证。
• Windows x64：推荐 MSI 安装包，内置 WinSparkle 自动更新；便携 ZIP 保留为手动更新方式。未做 Authenticode 签名；需要 Microsoft Visual C++ v14 x64 运行库。
• 校验值见 SHA256SUMS.txt。现有 Rust 配置及桥身份继续沿用，Swift 版与 Rust 版数据独立。

构建经过格式、Clippy、Release 测试和包内 CLI 验证；具体支持范围及实机边界见项目说明。

0.1.1 的变化

• macOS 设置提供「登录时启动」。登录项由系统管理，待授权时可直接打开对应的系统设置。应用图标沿用原生版的 Icon Composer 资源。
• 从 Apple「家庭」调亮已关闭的灯时，桥先确认开灯，再发送亮度。可读属性在指令后确认实际状态，瞬时开关仍回传复位值。
• 空气净化器按 PM2.5 实测值向 Apple「家庭」提供空气质量等级，并保留原始读数。客户端使用 µg/m³ 显示该读数。
• Linux 桌面安装包、NAS 容器和群晖原生测试包与桌面端使用同一个发行版本。另提供飞牛 x86_64 测试包供本地验收。

Linux 和 NAS

• Debian 12 / Ubuntu 24.04 x86_64 桌面版提供 DEB 与便携包。
• 群晖容器版通过 compose.yaml 使用固定摘要的 GHCR 镜像。
• 群晖原生 SPK 是 Geminilake 测试包。已通过解包、非 root 启停、设置码和存储测试，仍需在 DSM 套件中心验收。
• 飞牛 x86_64 FPK 是本地验收包，和 SPK 一起保存在同次 Actions 的 MijiaLAN-NAS-x86_64-b15-test。飞牛应用中心上架另行提交。

Linux / NAS 构建与测试包 · 安装说明

MijiaLAN 0.1.0-rs.14 · Rust 体验版

MijiaLAN Rust 0.1.0-rs.14 同步原生 0.1.8 的 HomeKit 修复。原生发行说明

本版变化

• 将晾衣架等设备的只写档位作为瞬时开关。家庭读取时显示关闭，打开时发送指令。
• 显示固件上报的规格外模式值。家庭模式开关按实际读数匹配，空调使用规格中列出的模式推导运行状态，写入按规格校验。
• 将 1–255、1–65535 等亮度刻度换算为家庭的百分比。亮度设为 0% 时关闭灯具。
• 净化器根据电机转速判断运行状态。无转速属性的型号使用电源状态。
• 在家庭中显示智能床的标准姿态预设，过滤 None 和 Null 占位。厂商自定义控制可在客户端使用。
• 设备管理和诊断报告按实际映射的 HomeKit 服务显示桥接支持情况。

安装与更新

• Mac Apple Silicon。下载 DMG
• Mac Intel。下载 DMG
• Windows x64。下载 MSI

b13 用户可以在设置中检查更新。Mac App 和 DMG 已通过 Developer ID 签名与 Apple 公证。Windows MSI 支持自动更新，附件中的便携 ZIP 适合手动安装。Windows 安装包需要 Visual C++ v14 x64 运行库。微软运行库下载说明

发布复用三平台验证后的 Release 程序。安装包校验值见 SHA256SUMS.txt。源码 · CI · 签名与发布

English

Rust 0.1.0-rs.14 brings the HomeKit fixes from native 0.1.8. Write-only options read as momentary switches, firmware-reported modes remain visible, and out-of-spec climate modes are unavailable in Home. Light brightness scales to Home percentages and 0% turns the light off. Air purifier state uses motor speed where available and power otherwise. Standard bed presets appear in Home, with placeholder options filtered out. Bridge support comes from the actual service mapping and is included in diagnostics.

Check for updates in b13, or download the notarized Mac DMG or Windows MSI above. Package hashes are in SHA256SUMS.txt.

MijiaLAN 0.1.0 · Linux b1

MijiaLAN Linux 0.1.0（构建 1）。

• Debian 12 / Ubuntu 24.04 x86_64 桌面版提供 DEB 和便携包。
• 群晖 DS920+ 从 Container Manager 导入 compose.yaml，修改 NAS IPv4 后启动。镜像为 ghcr.io/ipocket-app/mijialan-bridge@sha256:d86d21f5e6ba203480d8b77ba46eb3195063a77a6e4e82e3a2c455f28c517d00。
• 从 DSM 日志获取一次性设置码，通过浏览器导入米家设备并配对 Apple「家庭」。

安装和升级说明 · 验收所用 CI 产物

MijiaLAN 0.1.8

MijiaLAN 0.1.8

简体中文

原生 macOS 版，Build 9。支持 macOS 15 及以上，同一安装包包含 Apple Silicon 和 Intel。

• 修复只写式动作控件的 HomeKit 读数，将其作为瞬时开关处理，避免因设备不提供状态回读而显示无响应。
• 保留固件上报但设备规格未列出的模式值，在 App 中显示实际读数，减少模式开关误报无响应；控制写入仍按规格校验。
• 修复使用 1–255 等不同亮度刻度的灯具在「家庭」中的百分比换算，亮度设为 0 时关闭灯具。
• 改善未提供电机转速属性的空气净化器运行状态映射；提供转速的型号继续使用实际转速判断。
• 按标准设备规格提供智能床的姿态开关，过滤占位的 None 选项；厂商私有控制继续在 Mac 中使用。
• 按实际 HomeKit 服务映射判断设备是否支持桥接，在设备详情显示支持情况，并在诊断报告中增加对应字段。

安装包经 Developer ID 签名和 Apple 公证，并在发布前通过 macOS 15 双架构启动检查。可在设置中检查更新，或从 GitHub Releases 下载安装包。已有设备配置和 HomeKit 配对继续使用原存储。

English

Native macOS release, build 9. Requires macOS 15 or later; Universal for Apple Silicon and Intel.

• Treat write-only action controls as momentary HomeKit switches, avoiding unavailable reads when a device does not report their state.
• Retain firmware-reported mode values missing from the specification and display the actual reading in the app, reducing unavailable mode switches. Writes remain validated against the specification.
• Scale lights with brightness ranges such as 1–255 to Home's percentage and switch them off when brightness is set to zero.
• Improve the current-state mapping for air purifiers without a motor-speed property while retaining actual-speed checks on models that provide one.
• Expose standard bed-position presets as switches, omit placeholder None options, and keep vendor-specific controls available on the Mac.
• Determine bridge support from the services that can actually be mapped to HomeKit, explain support in device details, and include it in diagnostic reports.

Packages are Developer ID signed, Apple notarized and checked for startup on both CPU architectures running macOS 15 before publication. Check for updates in Settings or download an installer from GitHub Releases. Existing device configuration and HomeKit pairing material continue to use their original storage.

MijiaLAN 0.1.7

MijiaLAN 0.1.7

简体中文

原生 macOS 版，Build 8。支持 macOS 15 及以上，同一安装包包含 Apple Silicon 和 Intel。

• 设置新增「诊断」区域，可一键导出 JSON 诊断报告，并在访达中定位文件。
• 报告包含设备在线状态、属性读数、重试状态和 HomeKit 读取失败项目，便于排查「家庭」中的感叹号或无响应问题。
• 支持创建附带诊断报告的邮件草稿；由你确认后发送。邮件 App 无法自动添加附件时，会显示报告文件供手动附加。
• 诊断报告包含设备名称、标识和读数，可先查看再分享；设备 token、网络地址和 HomeKit 配对密钥不作为导出字段。
• 源码构建改用仓库内维护的 MijiaCore，修复上游仓库不可用导致的构建失败。

安装包经 Developer ID 签名和 Apple 公证，并在发布前通过 macOS 15 双架构启动检查。0.1.6 用户可在设置中检查更新；也可从 GitHub Releases 下载安装包。已有设备配置和 HomeKit 配对继续使用原存储。

English

Native macOS release, build 8. Requires macOS 15 or later; Universal for Apple Silicon and Intel.

• Add a Diagnostics section in Settings to export a JSON report and reveal it in Finder.
• Include device health, property readings, retry state and failed HomeKit reads to help investigate warnings or unresponsive accessories in Apple Home.
• Open an email draft with the report attached for you to review and send. If the mail app cannot attach it automatically, reveal the file for manual attachment.
• Reports contain device names, identifiers and readings and can be reviewed before sharing. Device tokens, network addresses and HomeKit pairing keys are excluded as export fields.
• Build from the locally maintained MijiaCore sources, restoring source builds after the upstream repository became unavailable.

Packages are Developer ID signed, Apple notarized and checked for startup on both CPU architectures running macOS 15 before publication. Version 0.1.6 users can check for updates in Settings, or download an installer from GitHub Releases. Existing device configuration and HomeKit pairing material continue to use their original storage.

MijiaLAN TV 0.1.1 (3) · Sideloadly 侧载适配实验版

MijiaLAN TV 0.1.1 (3) · Sideloadly 侧载适配实验版

从独立 MijiaLAN-tvOS 分支发布，支持 tvOS 18 及以上。

修复侧载更换签名身份后，App 与 Network Extension 仍使用旧共享组、Keychain 前缀和固定 Provider ID 的问题。运行时读取安装包最终的 XML / DER 签名，选择双方实际获授权的共享组，并由 NE 独立核对传入的共享权限。

• IPA 为 App 和 NE 保留证书无关的权限模板，便于重签工具识别 Packet Tunnel、App Groups 与共享 Keychain。
• 从实际嵌入的扩展发现 Provider ID，支持重签后的 Bundle ID 与 App ID prefix；扩展丢失、共享权限缺失或身份不一致会明确报错。
• 附带 verify_sideload.py，可在 Mac 检查模板，或检查重签导出包的 App / NE 签名、真实设备描述文件、NE 授权、共享权限和设备注册。
• 提供 Sideloadly 安装说明、GitHub 参考资料与验证边界，详见附件 INSTALL.md、SIDELOADING.md。

IPA 必须由用户用能够授权 Network Extensions 的开发团队重签。 临时权限模板不等于 Apple 的 Ad Hoc 设备授权；普通免费侧载账号不能因此获得 NE 权限。请保留全部 App Extensions / PlugIns，App 和 NE 均须有匹配的设备描述文件。包中没有个人证书、私钥、描述文件或设备列表。

已完成 tvOS arm64 Release Archive，共享运行时 18 项执行通过、2 项集成用例跳过（含 7 项签名专项通过），IPA 变异校验 5 项通过，模拟器界面回归 3 项通过。实体 iPhone 已验证现有描述文件授权、新 NE 进程读取共享配置和短时后台轮询；故意将旧 Info.plist 共享值改错并重签后，新 NE 仍成功读取配置和启动桥。Sideloadly 已实际载入 tvOS 候选 IPA，但尚未产生账号重签导出包；没有 Apple TV 真机，tvOS 上的重签安装、NE 激活和后台 HomeKit 控制仍未验收。

更新仍通过 Mac 重新侧载安装，电视内只检查版本和显示发行页二维码。Packet Tunnel 承载网络监听属于 Apple TN3120 的不支持用途，继续保持自签实验定位。

MijiaLAN TV 0.1.0 (2) · 自签实验版

MijiaLAN TV 0.1.0 (2) · 自签实验预发布

从独立 MijiaLAN-tvOS 分支发布，支持 tvOS 18 及以上。

IPA 未签名，安装前需要自己的 Apple Developer 团队与适用的 tvOS 描述文件，同时签名 App 和 Network Extension。 详细步骤见附带的 INSTALL.md 或源码中的 Experiments/AppleTV/INSTALL.md。

• 原生「桥接中心」：总览、设备、家庭桥接、设置，支持遥控器导航和独立 TV 图标。
• 局域网设备认证、配置及电源控制；共用原生端的 miIO / MIoT 和 HomeKit 业务代码。
• 诊断报告、逐台设备属性和错误信息、JSON 导出与敏感字段脱敏。
• 线上检查更新、版本说明及发行页面二维码，使用独立 TV 更新服务。
• 包含 iPhone NE 实验中经对照修复的 Bonjour 服务声明；iOS 与 tvOS 分别编译签名。

已验证模拟器界面、遥控器、受控加密 UDP / HAP 测试及线上版本检查。Apple TV 真机、真实家电和 tvOS NE 后台持续运行尚未验收。 iPhone 的受控后台验证不代表 Apple TV 已通过。

本次发布已完成 tvOS arm64 Release Archive，TV 共享测试 11 项执行通过、1 项外部集成用例跳过，原生设备能力与 HomeKit 映射回归 45 项通过。此前遥控器回归 9 项和线上 HTTPS 检查 1 项通过。

此版本提供实验包及源码，不是 App Store / TestFlight 发行，也不提供电视内自动安装。Packet Tunnel 承载监听服务属于 Apple TN3120 的不支持用途，保持自签实验定位。

附件包括 arm64 真机 Release IPA、SHA-256 校验、未签名状态清单和安装说明。请在自行签名及安装后按 README 的前台、后台和停止流程验证。