应用商店版本落后？教你用 LPK 自助升级

![baner_image_1.png](https://dl.playground.lazycat.cloud/guidelines/803/656e2731-d581-4135-881d-fd64dcbc2742.png "baner_image_1.png")
## 懒猫微服商店里的应用没及时更新怎么办？
以 Calibre-Web Automated 为例：商店里是 3.0.5，而最新版已经到 3.1.4。作为不更新会死星人，自然要自己动手。

官方路径有两条：

1. 等待提供者更新（或客服联系开发者更新）
2. 自己修改 LPK 包，更换镜像版本

本文走第 2 条，几分钟搞定升级。

## 准备工作

### 需要工具：
  - [懒猫应用查看器](https://lazycat.cloud/appstore/detail/top.j0k3r.lpk-inspector)（用于导出/查看 LPK）
  - [lzc-cli](https://developer.lazycat.cloud/lzc-cli.html)（开发者命令行工具，需注册开发者账号）
  - [开发者文档AI助手](https://appstore.lazycat.cloud/#/shop/detail/in.zhaoj.devaihelper)（可用来查命令/规格）

## 步骤一：获取 LPK
安装并打开“懒猫应用查看器（LPK Inspector）”
导出 Calibre-Web Automated 的 LPK 文件

## 步骤二：解包并查看 manifest.yml
用任意解压软件打开 LPK（本质是 zip）
找到并打开 manifest.yml，原始片段类似：
```yaml
lzc-sdk-version: 0.1
package: cloud.lazycat.app.calibreweb
version: 3.0.5
name: Calibre-Web Automated
description: Calibre-Web，但自动化且具有 Calibre 功能
license: https://choosealicense.com/licenses/gpl-3.0/
homepage: https://github.com/crocodilestick/Calibre-Web-Automated
author: CrocodileStick
application:
  subdomain: calibreweb
  user_app: true
  routes:
    - /=http://server.cloud.lazycat.app.calibreweb.lzcapp:8083
services:
  server:
    image: >-
      registry.lazycat.cloud/longixaoyi/crocodilestick/calibre-web-automated:bdf3dbf10be5a22c
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
    binds:
      - /lzcapp/var/config:/config
      - /lzcapp/var/cwa-book-ingest:/cwa-book-ingest
      - /lzcapp/var/calibre-library:/calibre-library
      - /lzcapp/var/books:/books
      - >-
        /lzcapp/pkg/content/auto-library.py:/app/calibre-web-automated/scripts/auto-library.py
```

可以看到 `image` 使用的是 `registry.lazycat.cloud` 的仓库，意味着我们需要先把新版镜像同步到该仓库。

## 步骤三：把上游镜像同步到懒猫镜像仓库
使用 lzc-cli（需要开发者账号登录）执行（示例）：
`lzc-cli appstore copy-image crocodilestick/calibre-web-automated:V3.1.4`
命令执行成功后，会返回一个 registry.lazycat.cloud 上的完整镜像地址（包含命名空间与标签/摘要）。**记下这个地址**。

#### 提示：
- 平台通常要求走 registry.lazycat.cloud 拉取，直接改 docker.io/ghcr.io 不一定能拉到，因此用 copy-image 最稳。
- 确认镜像是否包含你的 CPU 架构（amd64/arm64）。

## 步骤四：修改 manifest.yml 的镜像地址
- 将 services.server.image 改为上一步返回的 registry.lazycat.cloud 完整地址（3.1.4 对应的 tag/摘要）。（顺便把version 也改成3.1.4吧）
- 其他项一般不需要变动，但建议检查：
  - 环境变量（PUID/PGID/TZ 是否仍适用，新版是否有新增/废弃）
  - 端口（仍为 8083 即可）
  - 数据卷路径（/config、/books、/calibre-library、/cwa-book-ingest 等是否一致）
  - 兼容性脚本（auto-library.py 的挂载路径未变化）

## 步骤五：重新打包为 LPK
- 将修改后的文件“就地压缩”为 zip（注意把目录内容打包到根层级，而不是再套一层目录）
- 把后缀 .zip 改为 .lpk，例如 calibreweb-3.1.4.lpk

可选：若这是一个完整项目，也可用 lzc-cli 构建（开发手册示例）
```
lzc-cli project build -o release.lpk
lzc-cli app install release.lpk
```

## 步骤六：安装并验证
安装新包：`lzc-cli app install calibreweb-3.1.4.lpk` 提示安装成功后，打开 Calibre-Web Automated，检查应用内“关于/版本”或首页标注，确认已是 3.1.4。

## 故障排查与回滚
- 拉取失败/403：重试 copy-image，或检查是否输错上游 tag（V3.1.4 大小写要一致）。
- 架构不匹配：确认镜像支持你的设备架构。
- 启动报错：对照新版 README/Changelog，检查环境变量、卷挂载、健康检查端点是否变化。
- 快速回滚：把 image 改回旧地址，重新打包并安装；原数据卷位于 /lzcapp/var/*，不会随升级丢失（建议重要数据先备份）。

## 贴士
- 商店更新节奏有时会滞后，“自己改 LPK + 同步镜像”是当前最省事的临时方案。
- 想省去手工压包，亦可在熟悉 lzc-cli 后把此流程脚本化。

## 用到的工具
- 懒猫应用查看器（LPK Inspector）：https://lazycat.cloud/appstore/detail/top.j0k3r.lpk-inspector
- 开发者文档AI助手（查命令/规范更快）：https://appstore.lazycat.cloud/#/shop/detail/in.zhaoj.devaihelper
- lzc-cli（开发者工具）

## 参考
- https://lazycat.cloud/playground/guideline/652
- https://lazycat.cloud/playground/guideline/662
- https://lazycat.cloud/playground/guideline/753
- https://developer.lazycat.cloud/lzc-cli.html