Lazycat Lpk Builder

This guide helps you package existing applications into Lazycat MicroServer's lpk format, which is their containerized app distribution system. You'll use it when converting Docker images or raw source code into something that runs on their platform. It walks you through writing three config files: package.yml for metadata and permissions, lzc-manifest.yml for runtime structure like services and routing, and lzc-build.yml for the build process. The skill is written in Chinese but the specs are clear about platform constraints like requiring persistent data under /lzcapp/var and using specific domain patterns for inter-service communication. It's focused on their V2 spec which separates metadata from runtime config, so if you're working with legacy lpk files you'll need to restructure them.

skills.sh installs: 259
GitHub stars: 61
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add whoamihappyhacking/lazycat-skills --skill lazycat-lpk-builder --agent claude-code

Installs into .claude/skills of the current project.

Files

懒猫微服 LPK V2 打包与移植

0. 先校准，后写配置

写/改 package、manifest、build 或执行 build/deploy/release 前，必须先读取并执行 references/spec-sync.md：记录目标 lzcos 与 CLI 版本，获取官方原文，核对本地快照并声明冲突。HTTP 错误、空文档、HTML 错误页不算成功；离线只能明确声明使用快照，不能声称实时校准。

基线为 lzcos >=1.5.0、lzc-cli >=2.0.0；每项新能力还需独立核验门槛。当前技能不是“永远最新”的保证。

1. 分析应用

梳理端口/协议、CPU 架构、镜像入口与 UID、内部数据/用户文件、依赖、业务鉴权和所需权限。不要将 Compose 原样当 manifest，不默认申请 root/privileged/全部权限。

2. 分开编写四种配置

文件/需求	行动指令
package.yml：静态身份、版本、权限	读取 `references/package-spec.md`
lzc-manifest.yml：服务、路由、inject、entries、运行身份	读取 `references/manifest-spec.md`
lzc-build.yml：正式构建	读取 `references/build-spec.md`
lzc-build.dev.yml：开发差异	同上，不能复制整份 release 配置
资源导出/导入	读取 `references/resource-export.md`
权限、初始化、探针、持久化故障	读取 `references/troubleshooting.md`
上架与审核	读取 `references/store-publish.md`

V2 manifest 不放 package/version/name/locales/permissions/import_resources 等静态字段。完整包的内容可选，image-only 不必伪造 contentdir；图标按官方 PNG/商店要求，不能臆造大小限制。

3. 构建与验证

lzc-cli --version
lzc-cli project build -o release.lpk

SKILL.md on GitHub

Details

Repository: github.com/whoamihappyhacking/lazycat-skills
Categories: DevOps & CI/CD, Mobile Development
First seen: Jun 3, 2026

More from whoamihappyhacking/lazycat-skills

All 5