软件更新

目标：学会安全地给 LeLamp 升级软件——先备份、再拉取更新、构建前端、最后重启服务

• 购买产品的用户，可以不定期咨询是否有新版本。

我们也会提供一个自动升级脚本，运行脚本，自动完成升级。不需要单独下载。如果你已经基于之前的版本做了二次开发，请不要强行升级。可能会把你做二次开发会覆盖掉。

一、更新前先备份（最重要的一步）

LeLamp 的所有个人数据都保存在 ~/.lelamp/ 目录（~ 即 lelamp 用户的家目录），升级前请先备份整个目录：

1.执行备份：

#备份配置
cp -r ~/.lelamp ~/.lelamp.backup-$(date +%Y%m%d)
#备份源码
cp -r ~/lelampv2 ~/lelampv2.backup-$(date +%Y%m%d)

你应看到什么：命令无报错；执行下面命令能看到备份目录里的文件：

ls ~/.lelamp.backup-20260801/
ls ~/lelampv2.backup*
# 应看到 config.yaml、.env、calibration/、recordings/ 等

提示：也可以打包成单个压缩包便于保存：tar czf ~/lelamp-backup-$(date +%Y%m%d).tar.gz -C ~ .lelamp

2.下载压缩包（如果客服提供）

联系客服获取最新代码压缩包（如 lelamp-latest.zip）。

解压到临时目录：

unzip lelamp-latest.zip -d /tmp/lelamp-new

覆盖原有代码：

rsync -av --delete /tmp/lelamp-new/ ~/lelampv2/

使用 rsync 可以只更新差异文件，保留你的修改（但注意：如果新版本删除了某些文件，--delete 会同步删除，请谨慎）。

二、更新 Python 依赖

代码更新后，依赖包可能有变动：

cd ~/lelampv2
uv sync

你应看到什么：出现 Audited N packages（无变化）或 Installed N packages（有更新），无红色报错。

若因网络超时失败，可改用国内镜像：uv pip install -r <(uv export --no-dev) -i https://pypi.tuna.tsinghua.edu.cn/simple

三、构建前端界面

如果本次更新包含 Web 界面改动（frontend/ 目录有变化），需要重新构建：

cd ~/lelampv2/frontend
pnpm install     # 安装依赖（首次或依赖变更时）
pnpm build       # 构建

你应看到什么：构建过程无报错，最后生成 dist/ 目录（ls dist/ 能看到打包产物）。

若提示找不到 pnpm：可用 npm run build 代替（效果相同），或先执行 corepack enable 启用 pnpm。

四、重启服务

方式 A：systemd 服务（推荐，开机自启）

sudo systemctl restart lelamp.service
sudo systemctl status lelamp.service

你应看到什么：状态为 active (running)，绿色高亮。

方式 B：前台启动脚本

如果你是用启动脚本手动运行的（如 ~/lelampv2/start.sh），重启方式为：

cd ~/lelampv2
./start.sh

你应看到什么：终端滚动输出日志，最后出现 WebUI 访问地址（http://树莓派IP:8080）。

五、验证更新结果

1. 打开浏览器访问 http://树莓派IP:8080 → 你应看到：仪表盘正常加载，无报错页面；
2. 快速自检：

curl http://localhost:8080/api/v1/system/health

你应看到：返回包含 "status": "ok"（或类似）的 JSON； 3. 说一句"你好" → 你应听到：语音回复，灯效正常。

全部通过即更新成功。若舵机姿态异常，说明校准数据被覆盖，从备份恢复或重新校准（uv run -m lelamp.calibrate --port /dev/lelamp）。

常见问题