KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

xiaomi-bl-unlock-helper

★ 95 Open GitHub ↗

小米BL解锁题目答案匹配器

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center"><img src="./assets/images/favicon.png" style="width: 30%;"></p>
<h1 align="center"> Xiaomi BL Unlock Helper </h1>
<h3 align="center"> 小米 BL 解锁答题助手 </h3>
<p align="center">一款面向小米手机用户的客户端 Web 应用，助你备考小米解锁 Bootloader 考试，应用支持智能题库搜索、收藏管理和解锁资格计算，且支持离线运行</p>

---

---

## 项目简介

`xiaomi-bl-unlock-helper` 是一个专为准备小米解锁 Bootloader 考试的用户设计的 Web 应用。

它通过集成题库数据，实现模糊搜索、收藏管理以及解锁资格计算功能，支持离线使用，该项目旨在提供轻量、易用且功能丰富的备考工具，帮助用户高效掌握解锁相关知识点。

![V1.4.1 - 主页](https://raw.githubusercontent.com/YuleBest/xiaomi-bl-unlock-helper/main/docs/img/home.jpeg)

---

## 主要功能

| 模块名称           | 路径    | 主要脚本             | 作用说明                                                                 |
| ------------------ | ------- | -------------------- | ------------------------------------------------------------------------ |
| 题库智能搜索与浏览 | `/`     | `/assets/js/main.js` | 题库智能搜索与浏览，支持模糊匹配与关键词高亮，快速定位所需题目           |
| 收藏管理           | `/star` | `/assets/js/star.js` | 收藏题目管理与导入导出，方便收藏重要题目，支持浏览器本地持久化及导入导出 |
| 解锁资格计算器     | `/calc` | `/assets/js/calc.js` | 自动计算解锁资格条件，输入相关信息，自动判断解锁资格是否满足要求         |

---

## 系统架构

> 所有业务逻辑均在浏览器端运行，无需依赖服务器，实现离线支持

### 数据存储

- 题库数据存储在结构化的静态 `JSON` 文件 [questions.json](./data/database/questions.json) 中

- 用户收藏和自定义搜索偏好通过浏览器 `localStorage` 本地保存

- 收藏数据支持文件导入导出，方便跨设备同步
    <img src="./docs/img/star.jpeg" />

### 开发环境

### 技术栈

#### 项目结构

> V1.4.2

```
├─ LICENSE                                # 许可证
├─ README.md                              # 说明文档

├─ assets                                 # 静态资源目录
│   ├─ css                                  # CSS 目录
│   │   ├─ main.css                         # 主 CSS 文件
│   │   └─ material-components-web.css      # MDC CSS 文件

│   ├─ fonts                              # 字体目录
│   │   └─ material-icon-font.woff2         # MDC ICON 字体文件

│   ├─ images                             # 图片目录
│   │   └─ favicon.png                      # 网站图标

│   └─ js                                 # JS 目录
│       ├─ calc.js                          # 解锁资格计算器脚本
│       ├─ main.js                          # 项目主脚本
│       ├─ material-components-web.js       # MDC 脚本
│       └─ star.js                          # 收藏管理脚本

├─ calc                                   # 解锁资格计算器模块
│   ├─ note.md                              # 解锁资格计算器说明文档
│   └─ index.html                           # 解锁资格计算器页面

├─ star                                   # 收藏管理模块
│   └─ index.html                           # 收藏管理页面

├─ data                                   # 项目数据目录
│   └─ database                             # 数据库目录
│       └─ questions.json                   # 题库 JSON 文件

├─ docs                                   # 文档目录
│   ├─ CONTRIBUTING.md                    # 贡献者指南
│   └─ img                                # 文档图片目录
│       ├─ calc.jpeg
│       ├─ home.jpeg
│       ├─ star-2.png
│       └─ star.jpeg

├─ index.html                             # 主页面
└─ server.py                              # 部署本地服务器脚本
```

```mermaid
flowchart TD
    A[项目根目录] --> B1[LICENSE / README.md]
    A --> B2[assets 静态资源]
    A --> B3[calc 解锁资格计算器]
    A --> B4[star 收藏管理模块]
    A --> B5[data 项目数据]
    A --> B6[docs 文档]
    A --> B7[index.html 主页面]
    A --> B8[server.py 本地服务器]

B2 --> C1[css/]
    C1 --> D1[main.css]
    C1 --> D2[material-components-web.css]

B2 --> C2[fonts/]
    C2 --> D3[material-icon-font.woff2]

B2 --> C3[images/]
    C3 --> D4[favicon.png]

B2 --> C4[js/]
    C4 --> D5[main.js]
    C4 --> D6[calc.js]
    C4 --> D7[star.js]
    C4 --> D8[material-components-web.js]

B3 --> E1[calc/index.html]
    B3 --> E2[note.md]

B4 --> F1[star/index.html]

B5 --> G1[database/]
    G1 --> H1[questions.json]

B6 --> I1[CONTRIBUTING.md]
    B6 --> I2[img/]
    I2 --> J1[calc.jpeg]
    I2 --> J2[home.jpeg]
    I2 --> J3[star-2.png]
    I2 --> J4[star.jpeg]
```

#### 前端

- HTML + CSS+ JavaScript

Material Design Components (`material-components-web.min.js`)

自定义 CSS (`style/main.css`) 实现主题和响应式布局

#### 数据管理

- 静态 JSON 题库 (`questions.json`)

- 浏览器本地存储

- 文件 API 实现收藏导入导出

---

## 快速开始

### 在线使用（推荐）

- **在线访问我们部署在 Cloudflare Pages 的网站：**[bl.lh520.pw](https://bl.lh520.pw)

- 或者使用备用域名：[xiaomi-bl-unlock-helper.pages.dev](https://xiaomi-bl-unlock-helper.pages.dev)

### 离线部署

> 使用下面的方法需要你有 Python 环境，如果你没有，可以自行使用 `node` 等工具开启本地服务器，但不建议直接使用浏览器打开 `index.html`，那可能会导致一些错误

1. 克隆或下载本项目的代码

```bash
   git clone https://github.com/YuleBest/xiaomi-bl-unlock-helper.git
   ```

2. 进入项目目录

```bash
   cd xiaomi-bl-unlock-helper
   ```

3. 运行部署脚本

```bash
   python server.py
   ```

如果一切正常，你会看到类似下面的输出：

```
Server is starting...

- Local access:    http://localhost:8000
- LAN access:      http://198.18.0.1:8000

Press Ctrl+C to stop the server
```

访问给出的网址即可，其中 `LAN` 地址支持局域网内的设备访问（前提是没有开启隔离）

### 使用说明

- 搜索题库：**在主界面的搜索框输入关键词**，下拉栏支持模糊匹配和高亮显示，快速定位目标题目

- 管理收藏：**点击题目的题号**，可以收藏你想重点复习的题目，支持导入导出收藏列表，方便跨设备使用
  <img src="./docs/img/star-2.png" style="zoom: 50%;" />

- 资格计算器：根据个人信息和状态，自动计算是否满足小米解锁资格条件
  <img src="./docs/img/calc.jpeg" style="zoom:33%;" />

---

## 许可协议

本项目采用 MIT 许可证，欢迎自由使用、修改和分发，但禁止商业使用！

**一切倒卖、投诉举报、恶意诋毁的行为都有可能导致本项目立刻删库跑路！！！！**

---

## 贡献指南

欢迎任何形式的贡献！具体贡献流程和规范请查看 [CONTRIBUTING.md](./docs/CONTRIBUTING.md)，无论是报告 Bug、提交代码、更新题库还是改进文档，我们都非常感谢你的参与！

---

## 致谢

- [Google Material Components Web](https://github.com/material-components/material-components-web) ，使用 MIT 许可证

---

xiaomi-bl-unlock-helper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README