中文时钟、天气与问候，抬头就看见
用树莓派驱动旧HDMI显示器，做一个能显示中文时间、问候与城市天气的桌面信息屏。固定MagicMirror² v2.38.0和Node 24，配完整BOM、购买地址与八步图解。复用显示器时主控等新增材料规划约¥500–800，预留半天；核心软件MIT，源于成熟开源社区。
alan000
本页固定为Pi 4驱动旧HDMI显示器的桌面信息屏。按7项BOM点件；外壳为卡扣款，屏幕沿用底座，不需要螺丝、胶水或木框。断电时把板卡压入对应Pi 4外壳，接口对准开孔，不用蛮力。micro-HDMI接Pi 4的HDMI0（靠近USB-C电源口），另一端接显示器；屏幕和树莓派分别接自己的电源。先不通电，下一步插好系统卡再启动。不要拆显示器外壳。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
在电脑安装官方Raspberry Pi Imager，插入读卡器和32GB卡。设备选Raspberry Pi 4，系统选Raspberry Pi OS（64-bit）带Desktop的版本，不选Lite。设置自己的用户名、密码、Wi-Fi和时区，确认写入目标确实是这张可清空的卡。写入并校验完成后弹出卡，插入Pi底部卡槽。连接USB键鼠，屏幕切到对应HDMI输入，再给Pi通电；进入桌面并确认浏览器可联网。记录系统版本和日期。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
在树莓派桌面打开终端，以下命令在树莓派上执行。先安装git/curl，再从nvm官方仓库安装版本管理器。下载脚本后可以先打开查看；运行后重新打开终端，再安装Node 24。最后应看到v24开头的版本号。
```
sudo apt update
sudo apt install -y git curl
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh -o /tmp/nvm-install.sh
bash /tmp/nvm-install.sh
```
关闭终端后重新打开，执行：
```
nvm install 24
nvm alias default 24
node -v
npm -v
```
若提示nvm不存在，重新登录桌面后打开终端，参考nvm官方安装排错；不要用sudo运行MagicMirror。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
在普通用户主目录执行以下命令。目录已存在时先确认内容，不覆盖已有配置。依赖下载可能花较长时间；安装成功再运行下一行。默认示例的地点和新闻源不是你的地点，先确认画面出现，下一步改成本地版本。
```
cd ~
git clone --branch v2.38.0 --depth 1 https://github.com/MagicMirrorOrg/MagicMirror.git
cd MagicMirror
node --run install-mm
cp config/config.js.sample config/config.js
node --run start
```
本路线使用当前Pi OS的Wayland桌面。若你主动切换成X11，启动命令改为 `node --run start:x11`。黑屏先确认系统桌面正常、Node版本合格以及依赖安装无错误。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
按Alt打开应用菜单退出，或回终端Ctrl+C停止应用。先备份配置，再用文本编辑器打开文件：
```
cd ~/MagicMirror
cp config/config.js config/config.js.backup
nano config/config.js
```
用下面完整内容替换文件，Ctrl+O保存、Enter确认、Ctrl+X退出。第一次只保留时钟和问候，避免外部接口干扰。
```
const config = {
address: "localhost",
port: 8080,
ipWhitelist: ["127.0.0.1", "::1", "::ffff:127.0.0.1"],
language: "zh-cn",
locale: "zh-CN",
timeFormat: 24,
units: "metric",
modules: [
{ module: "clock", position: "top_left" },
{
module: "compliments", position: "lower_third",
config: { compliments: { anytime: ["今天也值得期待"] } }
}
]
};
if (typeof module !== "undefined") { module.exports = config; }
```
保存后检查配置并启动：
```
node --run config:check
node --run start
```
修改问候语后重启，应能看到新文字。中文方框时安装系统中文字体包fonts-noto-cjk再重启应用。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
最小画面成功后，在modules数组里加入下面对象；前一个对象后面需要英文逗号。示例坐标是北京城市中心，只作演示，请按城市修改，不需要家庭精确地址。Open-Meteo提供天气数据，网络与服务政策会影响结果；个人非商业用途请查看服务条款。它是天气服务数据，不是本机传感器实测。
```
{
module: "weather",
position: "top_right",
config: {
weatherProvider: "openmeteo",
type: "current",
lat: 39.9042,
lon: 116.4074
}
}
```
检查配置、重启，确认城市和时间正确。失败时看终端错误，先核对网络和坐标；时钟模块仍可单独使用。
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
位置图中的top_left、top_right、lower_third等名称对应屏幕区域。修改position即可改变位置。屏幕横放即可，旋转用系统显示设置完成。需要日程时再参考官方calendar模块，填入自己的ICS订阅；秘密日历URL相当于读取凭证，不应放进公开项目附件或截图。首次作品不依赖个人日历，不默认添加人脸识别、麦克风或AI。
[日历模块说明](https://docs.magicmirror.builders/modules/calendar.html) · [模块位置说明](https://docs.magicmirror.builders/modules/configuration.html)
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。
拍下成品屏幕，记录板卡、系统日期、MagicMirror版本和node -v结果。验收四项：中文时钟持续走动；新问候语生效；天气显示你设置的城市；重启系统后用下面命令能重新显示。最后关机用系统菜单，等待完成后断电，不直接拔卡。
```
cd ~/MagicMirror
node --run start
```
本页基本路线为手动启动。需要开机自启时，使用官方自启说明，并按实际Node安装位置配置；nvm安装路径不是/usr/bin/node，不能直接照抄该路径。保持localhost监听与默认IP白名单，不将8080端口映射到公网。备份config.js前移除私人订阅地址。
[可选：官方开机自启说明](https://docs.magicmirror.builders/configuration/autostart.html)
依据：[MagicMirror²官方文档](https://docs.magicmirror.builders/) · [固定版本v2.38.0](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
图源：MagicMirror²文档，Michael Teeuw，MIT；中文接线/流程/验收图为ORecord原创示意，MIT。示意图与官方历史界面截图均非本站硬件测试照片。