Repository navigation
Releases: JoeySystem/boring-developer-kit
Release list
BORING MIST 官方固件 20261012.01 · Power V2 样机
BORING MIST · Power V2 官方签名固件
- 适用硬件：
WMP-S3-MATRIX12-POWER-V2 - Build ID：
20261012.01-g5398b776 - 产品版本：
0.3.0-alpha.1 - 渠道／验证状态：
sample / sample-verified（留样机验收，非量产稳定版）
本版更新逐台摇杆校准、失效读数释放和 Normal 模式单次拨动单方向；保留 Codex 连续画圈、语音按住，以及开机状态恢复和 USB／蓝牙连接切换修复。
**安装：**通过支持官方固件导入的 BORING Console，连接 Power V2 设备并选择完整的 Firmware-BORING-20261012.01.zip。请勿把源码 ZIP 或单独的 .bin 当作维护包导入。此附件是已签名的官方应用固件，和仓库中可修改的源码分开交付。
本次同步了可公开的应用固件源码；装配定位、产线自检、生产签发工具、私钥、凭据和设备数据不在公开范围。源码编译得到的是 custom- 自定义构建，不能重建或冒充此签名包。
BORING MIST USB 恢复工具 · 20261007.01
面向 BORING MIST（WMP-S3-MATRIX12-POWER-V2）的 USB 售后恢复工具，适用于 M 系列 Mac。内置官方签名的 20261007.01-gae3b06fb-dirty 固件，用于尝试恢复无法正常启动但仍可响应 USB 固件协议的设备。
下载哪一个
- **普通用户：**下载
BORING-MIST-Recovery-20261007-Customer.zip，包含 DMG、工具源码、固件源码、使用说明、故障排查和 AI 提示词。 - **只安装工具：**下载
BORING-MIST-Recovery-20261007.01-arm64.dmg。 - **交给 Codex / Claude Code 排查：**下载
recovery-tool-source.zip，打开其中的AI-RECOVERY-PROMPT.md，复制提示词并附上实际报错/诊断文件。 - 固件开发参考：
firmware-source.zip。修改后属于自定义固件，不可复用官方签名。 - Console 手动导入：
BORING-MIST-Official-Recovery-20261007.01.zip是独立的官方签名维护包，不是应用安装包或源码包。
使用
退出 Console，用 USB 数据线直连设备，打开恢复工具并点击“恢复官方固件”。等待设备重启、版本回读和官方来源登记完成，再退出工具，重开官方 Console 0.2.1，通过 USB 使用。
修复和验证
固件修复首次电量采样失败误记为关机、开机自检灯光计时提前的问题。样机通过 DMG 工具完成 USB 恢复、精确版本读回、配置保留，并在官方 DMG 版 Console 0.2.1 中显示官方固件。恢复工具 33 项、配套固件 35 项、仓库公开材料 12 项测试通过。
此为定向售后预发布，不替换 Console 最新版本或在线固件索引。客户闪灯故障尚未在样机复现，蓝牙异常未宣称修复。无需 BOOT/拆机，但完全没有 USB 通道或无法响应更新协议的设备不能靠此工具强行恢复，请联系售后。
DMG 为 ad-hoc 签名，未做 Apple 公证；首次运行按系统“隐私与安全性 → 仍要打开”处理，不要关闭系统安全保护。内置固件的 BORING 官方签名与 Apple 应用签名是两回事。
源码沿用仓库 PolyForm Noncommercial 1.0.0 非商业许可，第三方组件保留各自许可。源码及安装包不包含生产私钥、客户配置或设备身份签发工具。
BORING Developer Kit preview.10 · Console 0.2.1 / SDK 1.1
Console 0.2.1 安装包下载
选择对应系统，直接从 GitHub 下载：
- Windows 64 位安装包（EXE，147.6 MB）
- macOS Apple Silicon 安装包（DMG，114.6 MB） — 适用于 M 系列芯片，macOS 13 及以上，不适用于 Intel Mac。
以上为可直接安装使用的 Console 0.2.1 安装包；需要修改源码或开发扩展时，再下载下方社区源码开发包。安装说明见 安装指南。
社区源码与 SDK
本次公开 Console 0.2.1 的社区源码适配、Python SDK 1.1.0 / API 1.1，以及四个扩展示例。源码已同步至 main。
- 控制台：更新语音设置、连接状态、草稿恢复与配置流程；社区构建使用独立设置、系统字体和简化设备示意，不订阅官方自动更新。
- SDK：新增电脑端任务事件及取消处理；增加 save_host_task 示例。
- 下载：完整源码开发包 ZIP、SDK wheel、四个可导入的扩展 ZIP。
- 公开范围：包含协议、公开根公钥、测试与文档；不含内部模型/动画/字库、生产与部署资料、私钥或设备备份。
- 固件：保留 preview.9 / 20260916.01 的源码参考，本次未更新固件。
原创内容继续采用 PolyForm Noncommercial 1.0.0，商业复用需另行授权。
已完成定向回归、打包检查及独立解压安装后的模拟设备启动验证。此版本为社区源码预发布，本轮未做新的原生安装或实机硬件验收。详细范围见 验证记录。
BORING Developer Kit preview.9 · Power V2 20260916.01
Power V2 20260916.01-gbc6d2699-dirty 的官方签名维护包与功能对应的固件源码已公开。该固件仍为 sample / sample-verified，不是 RC 或量产正式版。
下载时请区分：
Boring-20260916.01.zip：官方签名固件维护包。使用新版官方 BORING Console，经 USB 在“设置 → 固件更新 → 更多固件选项 → 选择官方固件文件”导入整个 ZIP；适用硬件为WMP-S3-MATRIX12-POWER-V2。仓库既有 0.1.13 控制台安装包不保证具备此入口。详见 维护包说明。BORING-Developer-Kit-v0.1.0-preview.9.zip：可修改源码、协议、SDK、三个示例及文档。固件源码编译后产生custom-自定义包，不是官方签名镜像。boring_console_sdk-1.0.0-py3-none-any.whl与三个示例 ZIP：SDK 和扩展单独下载入口，接口版本未变。
本轮固件源码同步动态调频、保存亮度、默认待机时间、蓝牙广播降频与待机轮询。原官方包标记 git_dirty=true，公开快照对应功能，但不承诺逐字节重建。控制台公开源码仍为 0.1.46，公开安装包仍为 0.1.13。实际功耗收益、Windows 与长期运行未在本轮扩展验收。源码按 PolyForm Noncommercial 1.0.0 提供，维护方式为 Best Effort。
BORING Developer Kit preview.8 · Console 0.1.46 源码
这是面向 DIY 用户的开发者预览，语气和支持边界保持 Best Effort。
本次包含：
- BORING Console Community 0.1.46 公开适配源码；
- 与 Power V2
20260914.03-gbc6d2699-dirty / sample-verified功能参考对齐的固件应用源码； - Python SDK 1.0、协议、Schema 和三个扩展示例；
- DIY 固件包格式说明。
本次不包含新的 DMG / EXE、官方固件镜像、官方在线更新地址、产品 3D / STEP 模型、内部字库与品牌动画、生产凭据、设备身份数据、签发／预置／部署／维修工具。公开安装包仍为 0.1.13。
验证：Console 最终完整回归 1416 passed、9 skipped；公开材料和固件工具 22 passed。完整开发包独立解压后可从包内加载 Console、SDK 和协议，模拟设备进入 READY。9 项跳过依赖 Cocoa 原生窗口行为、真实弹出菜单坐标或官方 Sparkle 框架，未计为通过。
建议先下载 BORING-Developer-Kit-v0.1.0-preview.8.zip，阅读根目录 START-HERE.md、许可和固件 DIY 边界。Source code 是 GitHub 自动生成的仓库快照，不是可导入控制台的固件维护包。
BORING Developer Kit preview.7 · Power V2 20260914.03 源码
Power V2 20260914.03 源码同步
固件源码已对齐当前 20260914.03-gbc6d2699-dirty / sample-verified 权威参考。本次只更新允许公开的应用源码与对应说明，不提供预编译固件。
- NORMAL 模式的六个 Agent 键使用与 CODEX 一致的有效来源、标准状态颜色及断线／未知回白色规则，并可选择 AG00–AG05。
- NORMAL 其他按键、旋钮和摇杆继续走 Profile；CODEX / CC 既有行为不变。
- USB、认证、更新、启动回滚、分区、存储和电源底层没有修改，DIY 禁止改动范围保持不变。
本次没有上传官方固件镜像、生产私钥、设备数据、签发／预置工具、部署凭据或内部维修资料。开发包中的固件构建默认生成 custom- 来源和 built 状态，不会冒充官方包。
验证结果：来源工程相关行为回归 95 项通过；公开固件工具 9 项、公开材料 12 项通过；公开目录使用 ESP-IDF 6.0.2 实际编译成功。编译测试未刷写设备。当前权威包已有的 USB OTA 与实体功能验收只适用于该官方参考，不代表任意 DIY 修改都可靠。
下载 BORING-Developer-Kit-v0.1.0-preview.7.zip 获取完整源码开发包。DIY-Firmware-Package-Format.md 是可单独阅读的包格式说明；三个小 ZIP 是控制台扩展示例，wheel 是 SDK 1.0.0，它们都不是固件维护包。
控制台源码仍为 0.1.24，公开安装包仍为 0.1.13；本次没有发布新的 DMG / EXE，也没有修改官方在线更新渠道。完整 DIY 安装 → 恢复官方 → 功能正常的实机闭环仍未验收。
源码继续采用 PolyForm Noncommercial 1.0.0，商业复用需另行书面授权；项目按 Best Effort 维护。
BORING Developer Kit preview.6 · 固件源码与 DIY 边界
补充：DIY 固件包格式与导入条件
请先阅读 最新包格式说明，也可下载下方新增的 DIY-Firmware-Package-Format.md 附件。它补齐 ZIP 目录、manifest 必要字段、自定义来源要求，以及导入/安装/重连确认的区别。原 preview.6 源码 ZIP 保留不替换；这份说明是发布后的文档补充，未改变固件或控制台代码。
首次公开当前 BORING MIST / Matrix12 Power V2 应用固件源码，并提供明确的 DIY 修改与恢复边界。源码参考 20260913.01，包含截至 2026-09-14 的默认 custom 构建与无 Git 源码 ZIP 支持。
USB、身份认证、固件更新、启动与回滚、分区存储、电源和硬件引脚等基础模块坚决不要改。 只有设备仍可通过 USB 正常连接、认证并执行更新时，才具备控制台恢复官方固件的前提。不能保证任意错误固件都能恢复。
允许从快捷键数据表、现有文案、静态图案和既有限制内的配色入手；动画、新交互与资源占用需要慎重。恢复官方会替换 DIY 功能，不合并代码，不承诺修改过的配置格式可以无损恢复。完整 DIY 安装→恢复官方→功能正常的实机流程尚未验收。
验证：ESP-IDF 6.0.2 真实编译通过；开发包独立解压、无 Git 环境再次编译通过；9 项固件工具测试和 12 项公开包测试通过。未刷写设备或改变服务器固件渠道。
下载 BORING-Developer-Kit-v0.1.0-preview.6.zip 获取完整源码开发包。其他三个 ZIP 是控制台扩展示例，wheel 是既有 SDK 1.0.0；它们都不是固件维护包。
本次保留社区控制台源码 0.1.24 和旧公开安装包 0.1.13，不包含新控制台安装包或预编译固件。DIY 安装前需准备具备自定义导入与官方恢复功能的官方控制台；本文恢复界面参考 0.1.29。
沿用 PolyForm Noncommercial 1.0.0 非商业源码许可。没有公开生产私钥、设备数据、部署凭据或内部生产工具。
BORING Developer Kit v0.1.0-preview.5 · Console 0.1.24 源码
本次开发包同步 BORING Console 0.1.24 的可公开源码，SDK 1.0.0 / API 1.0 保持不变。
包含蓝牙名称、配置变化检测与草稿恢复、UTF-8 修复、三语言 JSON 文案、编辑界面、应用更新客户端和固件发布者签名校验。WMP1 名称命令、能力字段和样例一并对齐。
公开构建继续使用独立应用标识和系统字体；设备图使用简化控件示意。不包含内部产品模型、品牌字库/图标/动画、完整固件、生产工具、私钥或设备备份。应用和固件在线源默认留空，不会自动加入官方应用更新渠道。
这是源码开发者预览，不是新的安装包或固件。 仓库提供的官方安装包仍为 0.1.13。官方固件导入需签名维护包；自定义固件入口不代表任意错误固件可免拆机恢复，暂不建议普通用户刷入自改固件。BOOT 恢复属于内部售后流程。
BORING-Developer-Kit-v0.1.0-preview.5.zip：完整源码开发包，包含 Console、SDK、协议、文档及三个可导入扩展 ZIP。boring_console_sdk-1.0.0-py3-none-any.whl：SDK 包，不含控制台或 Qt。- 其余三个 ZIP：单独导入控制台的扩展示例。
使用与测试范围见仓库 README、docs/console-source.md、docs/versions.md 和 docs/verification.md。原创内容采用 PolyForm Noncommercial 1.0.0；商业使用需另行书面授权，按 Best Effort 维护。
BORING Developer Kit v0.1.0-preview.4 · Console 0.1.13 源码
公开控制台源码同步到 BORING Console 0.1.13。主要变化：离线工作区、配置应用流程、快捷键录制与模式提示、响应式布局及设备控件比例、macOS 菜单栏显示和可选电量状态。
公开副本保留系统字体、独立应用设置与本地服务标识；设备认证和写入确认仍保留。SDK 1.0.0 / API 1.0 不变。非商业源码许可与 Best Effort 支持约定不变。
下载完整开发包即可获得控制台源码、SDK、三个示例、协议和说明。SDK wheel 不包含宿主；三个示例 ZIP 用于导入扩展。源码 ZIP 不是安装包，也不包含固件镜像。
直接使用软件请看 0.1.13 安装包。固件参考仍为 .07 / sample-verified；它不提供新增电量字段，配套电量固件仍是候选，本次没有发布新固件。
本轮自动测试、独立安装启动和已知限制见 发布验证。这不是所有平台及实体触发场景均已验收的稳定版。
BORING Developer Kit v0.1.0-preview.3 · Console Community Source
本次新增 BORING Console Community 源码，用户可以修改界面、配置编辑、通信和扩展运行逻辑，并从公开工程独立安装和运行。
- 社区控制台基于已提交的 Console 0.1.6 快照进行公开适配；不包含仍在开发的 0.1.10。
- Python SDK 1.0.0、本地 API 1.0 保持不变；参考固件为 Power V2 20260910.07 / sample-verified。
- 保留设备身份认证、配置确认和更新客户端逻辑；社区版使用系统字体与独立应用设置，未附生产密钥、内部字库、官方图标、完整固件或量产资料。
下载什么
- BORING-Developer-Kit-v0.1.0-preview.3.zip：完整源码开发包，包含 console、SDK、协议、Schema、测试、文档及三个可导入扩展 ZIP。解压后从 START-HERE.md 开始。
- boring_console_sdk-1.0.0-py3-none-any.whl：独立 SDK，不包含控制台宿主。
- observe_prompt.zip / claim_prompt.zip / propose_mapping.zip：三个扩展示例，需兼容控制台宿主。
本发布不包含 DMG / EXE 或固件镜像；不是新版官方安装包。不要把开发包 ZIP 导入固件维护页面。
验证与限制
公开工程已完成独立虚拟环境安装、源码 wheel 构建、解压开发包独立启动与测试，并在内部 .07 留样机上完成 USB 生产身份认证及配置读取。具体测试数量与范围见 验证记录。
三个扩展示例的最终安装包实体触发和写入／读回联合验收、社区原生安装包、BLE 扩展实体触发与其他平台实测仍未完成，因此保留开发者预发布状态。
BORING 原创内容采用 PolyForm Noncommercial 1.0.0，商业复用需另行书面授权；第三方保留各自许可。按 Best Effort 维护，不承诺 Issue 响应或 PR 合并时限。