启鑫的黑板报

作者： 启鑫

  • 小米 Redmi 5 Plus (vince) 刷入 postmarketOS 教程

    在 Debian 13 系统环境下完全通过命令行为小米 Redmi 5 Plus (vince) 手机刷入轻量级的 postmarketOS 移动操作系统

    1. 前提条件

    1. 您的 Redmi 5 Plus 必须已经 解锁 Bootloader。
    2. 电脑已安装 Debian 13 系统。

    2. 安装必要工具

    2.1 安装 Python（推荐使用 Miniconda）

    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash ~/Miniconda3-latest-Linux-x86_64.sh
python --version

    提示: 安装完成后，您可能需要重启终端或运行 source ~/.bashrc 让python命令生效。

    2.2 安装 fastboot

    sudo apt install android-sdk-platform-tools-common android-sdk-platform-tools

    2.3 安装 pmbootstrap

    git clone https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git
cd pmbootstrap
pip install .
pmbootstrap --version

    3. 初始化 pmbootstrap 配置

    运行初始化命令并根据提示进行配置。

    pmbootstrap init

    配置选项及推荐值：

    序号选项描述 (原文/翻译)您的输入/选择目的或说明
    1Work path (工作路径)回车 (默认)默认路径通常最佳。
    2pmaports path (pmaports 路径)回车 (默认)存放 postmarketOS 软件包定义文件的路径。
    3Available postmarketOS release (选择发行版)v25.06选择您希望安装的 postmarketOS 版本。
    4Vendor (选择设备厂商)qcomRedmi 5 Plus 采用高通芯片。
    5Device codename (选择设备型号)msm8953Redmi 5 Plus 所属的平台代号。
    6Username (设置用户名)qixinlee替换为您想要的用户名。
    7Available providers for postmarketos-base-ui-wifi (选择 WiFi 后端)回车 (默认)默认选择 default 即可。
    8User interface (选择用户界面)phosh推荐 Phosh，它是一个基于 GNOME 的移动界面。
    9Install systemd? (是否安装 systemd)回车 (默认)默认选择 y。
    10Change them? (y/n) (更改额外选项)回车 (默认 n)通常无需更改。
    11Extra packages (额外软件包)回车 (默认 none)暂不添加额外软件包。
    12Use this timezone instead of GMT? (使用此本地时区)回车 (默认 y)使用本地时间而非 GMT。
    13Locale (选择本地化语言环境)回车 (默认 en_US)推荐使用 en_US，以确保兼容性。
    14Device hostname (设置设备主机名)回车 (默认)设备在网络上的名称。
    15Build outdated packages? (构建过时包)回车 (默认 y)允许构建可能过时的包，提高成功率。
    16Zap existing chroots…? (清空已有 chroot)回车 (默认 y)确保配置能立即生效。

    4. 构建系统 (Install)

    开始构建 postmarketOS 系统镜像。

    pmbootstrap install

    系统会提示设置用户登录密码，请根据提示输入两次密码：

    *** SET LOGIN PASSWORD FOR: 'qixinlee' ***
New password:
Retype new password:

    5. 电脑连接设备进行刷写

    将手机进入 Fastboot 模式：关闭手机电源，然后同时按住 音量下键 和 电源键，直到屏幕上出现 Fastboot 字样，连接电脑。

    5.1 确认设备已连接

    sudo fastboot devices

    提示: 如果能看到设备序列号，则连接成功。

    5.2 刷入 lk2nd (引导加载程序)

    pmbootstrap flasher flash_lk2nd

    5.3 刷入 rootfs (系统文件系统)

    pmbootstrap flasher flash_rootfs

    5.4 重启设备

    sudo fastboot reboot

    设备将自动启动进入您所选择的 postmarketOS 用户界面

  • 用 GitHub Pages 创建个人静态网站

    GitHub Pages 是一个免费的静态网站托管服务，你可以用它来展示个人主页、项目网站

    一、注册 GitHub 账户

    1. 打开GitHub 官网注册一个新账户。
    2. 选择一个你喜欢的用户名（USERNAME）。

    这个用户名将在后续作为你网站的域名的一部分，例如：USERNAME.github.io

    二、创建仓库（Repository）

    1. 登录 GitHub 后，在右上角点击 “+” → “New repository”。
    2. 在 Repository name 中填写：
    USERNAME.github.io
    1. 其余选项保持默认，然后点击 “Create repository”。

    三、安装并使用 GitHub Desktop 客户端

    1. 下载并安装 GitHub Desktop。
    2. 登录你的 GitHub 账户，并将刚创建的仓库克隆（Clone）到本地。
    3. 将你编写好的网页文件（如 index.html）放入该仓库文件夹中。
    4. 打开 GitHub Desktop，点击 “Commit to main” 提交更改。
    5. 点击 “Push origin”（或 “Fetch origin”）上传代码到 GitHub。

    四、访问你的网站

    上传成功后，在浏览器中访问：

    https://USERNAME.github.io

  • 从 0 到 1：使用 Qwen CLI 快速搭建炫酷个人主页

    想拥有一个效果炫酷的个人页面，却对编程一窍不通？没关系！带你一步步使用强大的 Qwen CLI 工具，让你在 20 分钟内，亲手完成制作个人主页的全过程。

    前提条件

    在开始之前，请确保你已准备好以下环境：

    1. 一台可以正常联网的电脑
      Qwen CLI 在写代码时需要联网。
    2. 操作系统和终端支持中文/英文显示
      确保你的操作系统（Windows/macOS/Linux）和终端可以正常显示和输入中英文字符。

    第一步：注册Qwen 账号

    首先，你需要一个Qwen的账号来授权 CLI 工具。

    1. 访问官网：使用 Chrome 浏览器
    2. 完成注册/登录：点击页面右上角的 “登录 / 注册” 按钮，按照指引完成账号创建。
    3. 记住账号信息：请记住你的注册方式（如手机号或邮箱），后续 CLI 登录会用到。

    第二步：安装 Node.js (CLI 的运行环境)

    Qwen CLI 是基于 Node.js 开发的，因此我们需要先安装这个运行环境。

    1. 访问下载页：打开 Node.js 官方下载页面
    2. 选择 LTS 版本：根据你的操作系统（Windows / macOS / Linux）下载 LTS (长期支持) 版本，这是最稳定和推荐的版本。
    3. 执行安装：双击下载的安装包，安装过程中保持默认选项，一路点击“下一步”即可。
    4. 验证安装：安装完成后，打开你的终端（或命令提示符），分别输入并执行以下两个命令：
    # 检查 Node.js 和 npm 版本
node -v
npm -v

    如果终端分别显示版本号，那就说明 Node.js 环境已成功安装！

    第三步：安装 Qwen CLI (核心工具)

    现在，我们可以安装主角——Qwen CLI 了。

    1. 打开终端：
    • Windows: 按 Win + R 键，输入 cmd 后回车。
    • macOS: 打开“应用程序” -> “实用工具” -> “终端 (Terminal)”。
    • Linux: 打开终端
    1. 执行安装命令：在终端中，输入以下命令并回车，它会从网络上下载并全局安装 Qwen CLI。
    npm install -g @qwen-code/qwen-code@latest
    1. 验证安装：安装完成后，输入以下命令验证：
    qwen --version

    如果显示出版本号，说明 Qwen CLI 已成功安装。

    第四步：登录你的 Qwen 账号

    在使用前，需要让 CLI 工具获取你的账号授权。

    1. 启动登录流程：在终端中，直接输入 qwen 命令并回车。
    qwen
    1. 浏览器授权：
    • CLI 会自动在你的默认浏览器中打开一个授权页面。
    • 如果你已在浏览器中登录了 Qwen 账号，只需点击 “授权” 即可。
    • 如果未登录，请先在网页上登录你的 Qwen 账号，然后进行授权。
    • 授权成功后，网页会提示“登录成功”，此时你可以关闭该网页。
    1. 返回终端：你会看到终端显示登录成功的欢迎信息，这表示 CLI 已经准备就绪！

    第五步：开始编程 – 创建你的个人主页项目

    最激动人心的部分来了！我们将用一句话让 Qwen CLI 为我们创建项目。

    1. 发送指令：在终端里，像聊天一样对 Qwen CLI 说出你的需求。你可以大胆发挥想象力，指令描述得越具体、越清晰，生成的效果可能就越符合你的预期！
    帮我使用nodejs制作个人介绍页面，使用中文语言，页面炫酷漂亮
    1. 确认项目创建：Qwen CLI 会理解你的需求并自动创建项目名称。
    2. 进入项目目录：项目创建完成后，根据提示按回车确认最终完成后终端会显示一个本地网址，通常是 http://localhost:3000
    3. 在浏览器中打开这个网址，你就能看到你的个人主页的雏形了！最棒的是，当你修改内容时在终端对话框输入你要表述的即可

  • macOS 15（Intel 版本）修复 rsync 同步问题

    在 macOS 15 (Intel 版本) 中，Apple 默认提供的 rsync 实际上是 openrsync 的一个版本。虽然它能完成基础同步任务，但与我们日常使用的、功能更强大的 GNU rsync 在参数兼容性、功能完整性上存在显著差异。这常常导致在执行复杂同步脚本或使用特定参数时遇到报错、同步失败或功能缺失等问题。

    1. 安装功能完整的 GNU rsync

    我们将使用 macOS 上最流行的包管理器 Homebrew 来安装官方的 GNU rsync。如果你还没有安装 Homebrew，请先进行安装。

    打开终端，执行安装命令：

    brew install rsync

    等待安装完成。Homebrew 会将新安装的 GNU rsync 放置在标准路径下：

    /usr/local/bin/rsync

    2. 确认 GNU rsync 安装成功

    安装完成后，我们必须验证当前使用的是否为我们需要的 GNU 版本。

    检查版本号

    通过完整路径运行 rsync，检查其版本信息：

    /usr/local/bin/rsync --version

    此时的输出应该类似于：

    rsync  version 3.x.x  protocol version 32

    关键点： 如果你看到 rsync version 3.x.x，这就确认你成功安装了 GNU rsync，它拥有比系统自带 openrsync 更完整的功能集。

    3. 永久切换默认 rsync 版本

    虽然已经安装了 GNU rsync，但系统默认执行 rsync 命令时仍会优先调用 /usr/bin/rsync（即 openrsync）。为了避免每次都输入完整路径，我们需要修改 Shell 的 PATH 环境变量。

    修改 Shell 配置文件

    编辑你的 Shell 配置文件。macOS 默认使用 zsh，所以我们编辑 ~/.zshrc：

    # 你可以使用 nano 或 vim 编辑器打开 ~/.zshrc 文件
# nano ~/.zshrc

    在文件的末尾添加以下一行配置：

    export PATH="/usr/local/bin:$PATH"

    这行配置的目的是将 Homebrew 的安装路径（/usr/local/bin）移到环境变量的最前端，确保系统在查找 rsync 命令时，会优先使用我们安装的 GNU rsync。

    激活配置并最终验证

    保存文件后，执行 source 命令使配置在当前终端会话中立即生效：

    source ~/.zshrc

    最后，运行 which rsync 命令进行最终确认：

    which rsync

    输出应该是：

    /usr/local/bin/rsync

    这表明系统已默认使用 GNU rsync。可以放心地执行各种同步任务和备份脚本了！

  • 在 VS Code编辑器中使用 LM Studio API + Continue 打造智能开发环境

    在日常开发中大语言模型（LLM）已经成为许多开发者的得力助手。LM Studio 提供了本地运行大模型的能力，而 Continue 插件则能在 VS Code 中无缝调用这些模型，带来智能补全、对话和代码生成体验。通过 Continue 插件接入 LM Studio 的 API，我们可以让本地或局域网部署的 AI 模型无缝集成到开发环境中。

    这种组合不仅能提供媲美云端的 AI 开发体验，还能保障数据隐私、不依赖外网。在代码补全、错误排查、文档生成等场景中，都能显著提升效率。

    一、准备工作

    1. 安装 LM Studio
    • 前往 LM Studio 官网下载并安装。
    • 启动后，根据需求下载模型（如 gpt-oss-20b、Qwen 等）。
    1. 安装 VS Code 与 Continue 插件
    • 打开 VS Code → Extensions → 搜索 Continue 并安装。
    • 安装完成后，左侧工具栏会出现 Continue 图标。

    二、启动 LM Studio API 服务

    1. 打开 LM Studio，进入 开发者模式。
    2. 加载所需模型（例如 gpt-oss-20b）。
    3. 启动 API 服务，默认会监听本地或局域网 IP 上的指定端口，例如：
    http://192.168.1.100:1234/v1

    三、配置 Continue 插件

    Continue 的配置文件默认路径如下：

    • Windows: C:\Users\<用户名>\.continue\config.yaml
    • macOS/Linux: ~/.continue/config.yaml

    示例配置：

    name: Local Agent
version: 1.0.0
schema: v1
models:
  - name: gpt-oss-20b
    provider: lmstudio
    model: openai/gpt-oss-20b
    apiBase: http://192.168.1.100:1234/v1/

    ⚠️ 注意：如果需要局域网访问，请将 localhost 替换为实际 IP 地址。

    四、开始使用

    1. 打开 VS Code，点击左侧 Continue 图标。
    2. 在对话框中选择你配置好的模型（如 gpt-oss-20b）。
    3. 输入问题，即可与模型对话，体验智能补全、调试和代码生成。

  • 在 Zed编辑器中集成本地 AI：配置 Zed 编辑器 + LM Studio API

    AI 助手在开发领域的普及越来越多的开发者开始依赖它们来提升编码效率。Zed 作为一款现代、轻量且速度极快的编辑器，不仅界面优雅，还原生支持接入远程 AI 模型，为我们提供了一个绝佳的平台。

    如果您在享受 AI 带来的便利时，又对数据隐私、网络延迟或 API 费用心存顾虑，那么将 Zed 编辑器 与 LM Studio 结合将是一个完美的解决方案。通过在本地或局域网中部署私有 AI 模型，可以在 Zed 编辑器中无缝使用 AI 辅助开发，既安全又高效。

    配置 Zed 编辑器 + LM Studio，让本地或局域网部署的 AI 模型无缝集成到开发环境中。

    配置步骤

    1. 启动 LM Studio API 服务

    您需要在 LM Studio 中启动一个本地 API 服务。

    1. 打开 LM Studio，进入开发者模块。
    2. 加载您所需的 AI 模型，例如 gpt-oss-20b。
    3. 启动 API 服务。该服务会默认监听您本地或局域网 IP 上的指定端口。

    例如

    http://192.168.1.100:1234/api/v0

    2. 修改 Zed 配置文件

    Zed 的配置文件在：

    • macOS / Linux: ~/.config/zed/settings.json
    • Windows: %APPDATA%\Zed\settings.json

    在配置文件中，添加以下核心配置：

    // Zed settings
{
  "agent": {
    "inline_assistant_model": {
      "provider": "lmstudio",
      "model": "openai/gpt-oss-20b"
    },
    "default_model": {
      "provider": "lmstudio",
      "model": "openai/gpt-oss-20b"
    }
  },
  "language_models": {
    "lmstudio": {
      "api_url": "http://192.168.1.100:1234/api/v0"
    }
  },
  "ui_font_size": 16,
  "buffer_font_size": 15,
  "theme": {
    "mode": "system",
    "light": "Ayu Light",
    "dark": "Ayu Dark"
  }
}

    请注意以下关键配置项：

    • provider: 确保设置为 “lmstudio”，以便 Zed 识别此服务提供商。
    • model: 这里需要填入您在 LM Studio 中加载的模型标识，例如 “openai/gpt-oss-20b”。
    • api_url: 填写 LM Studio API 服务的完整访问地址。

    3. 验证效果

    完成配置后，重新启动 Zed。
    打开 Inline Assist 功能，输入测试代码或指令，如果能得到 AI 输出，即表示配置成功。