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

 ## 懒猫微服商店里的应用没及时更新怎么办？ 以 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

利用 Calibre-Web 好好读书

# 利用 Calibre-Web 好好读书 在我看来，[Clibre](https://calibre-ebook.com/) 是我心目中的最强图书管理软件，跨平台支持 windows、macos、linux 三大操作系统。遗憾的是，Clibre 没有提供数据同步能力。[Clibre-Web Automated](https://github.com/crocodilestick/Calibre-Web-Automated) 项目正好补上这个缺漏。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.calibreweb ## 修改密码 在懒猫商店下载安装 Calibre-Web，默认用 admin / admin123 登录。安全起见，登录后第一件事就是修改默认密码，点击右上角头像，点击“admin”，  找到“Password”一栏，输入你中意的复杂一些的密码，浏览器滑到底部点击“Save”，密码就改成功啦！   ## 上传图书 点击右上角“Upload”，选中你要上传的图书，来到图书编辑页面。   在这个页面，你可以修改书名、作者、书籍描述，添加 tag；还可以通过修改“Convert from”“Convert to”改变书籍格式 —— 但是我不推荐修改图书格式，自动转换格式出来的效果常常不尽如人意。滑到底部，点击右下角的“Save”按钮，图书就上传好了。 如果你习惯对图书设置 tags，你还能在左侧的“Categories”中看到自己设置过的所有 tag：  如果你想对图书管理做到更细致，还可以点击左下角的“CREATE A SHELF”创建书架。点进图书，点右上角可将书籍移动到你的目标书架中。  ## 如何提升阅读体验 桌面端 Calibre 不但擅长管理图书，内置的 viewer 用来读书体验也很不错，但是 Clibre-Web 不太适合阅读。既不支持高亮，也不支持做笔记，当前仅支持极为简单的书签功能（还不能给书签取别名😂）。  如果是在手机上，推荐把图书下载到本地，用第三方软件阅读。  如果你用 kindle，当然走 Send-to-Kindle！首先在 Account 中配置好自己的登录邮箱地址（主要是为了接受测试邮件），kindle 邮箱地址。  点右上角 Settings，点进“EDIT EMAIL SERVER SETTINGS”。  如果你跟我一样用 163 邮箱转发，那配置应该跟我下面相同：  **这里强调一下**：SMTP Password 不是 163 邮箱的登录密码，而是开启 POP3/SMTP 后创建的授权密码。  点击“SAVE AND SEND TEST EMAIL”，如果你的账号邮箱能收到测试邮件说明配置正确。点击图书右上角的“小飞机”，就能成功发到 kindle 了。