@lazycatcloud/lzc-cli 2.0.0-pre.0 → 2.0.0-pre.2

package/template/blank/lzc-manifest.yml

@@ -1,18 +1,9 @@
-name: helloworld # 应用名称（启动器里显示）
-package: cloud.lazycat.app.helloworld # 应用唯一ID，建议使用反向域名格式
-version: 0.0.1 # 应用版本，建议遵循 semver
-description: # 应用描述
-license: https://choosealicense.com/licenses/mit/
-homepage: # 项目主页或文档地址
-author: # 作者信息
-
 # application 是默认前台服务，对应固定 service 名 app
 application:
   subdomain: helloworld # 默认访问子域名前缀
   routes:
     # 路由示例：把首页转发到一个外部站点
     # 常见写法:
-    # - /=file:///lzcapp/pkg/content/dist        (静态前端)
-    # - /=exec://3000,/app/run.sh                (执行命令并转发到端口)
-    # - /api/=http://backend:3000/api/           (转发到其他 service)
-    - /=https://developer.lazycat.cloud/
+    #   - /=http://example.com
+    #   - /=file:///lzcapp/pkg/content/html
+    - /=http://example.com

package/template/blank/package.yml

@@ -0,0 +1,7 @@
+package: cloud.lazycat.app.helloworld # 应用唯一ID，建议使用反向域名格式
+version: 0.0.1 # 应用版本
+name: helloworld # 应用名称
+description: # 应用描述
+author: # 作者信息
+license: https://choosealicense.com/licenses/mit/
+homepage: # 项目主页或文档地址

package/template/golang/Dockerfile

@@ -13,7 +13,7 @@ WORKDIR /app
 COPY --from=builder /workspace/app /app/app
 COPY run.sh /app/run.sh
 RUN chmod +x /app/run.sh /app/app
-COPY web /lzcapp/pkg/content/web
+COPY web /app/web
 
 EXPOSE 3000
 CMD ["/app/run.sh"]

package/template/golang/Dockerfile.dev

@@ -0,0 +1,20 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache go
+WORKDIR /workspace
+
+COPY go.mod ./
+COPY main.go ./
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /workspace/app ./main.go
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache go
+WORKDIR /app
+COPY --from=builder /workspace/app /app/app
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh /app/app
+COPY web /app/web
+
+EXPOSE 3000
+CMD ["sh", "-lc", "trap : TERM INT; sleep infinity & wait"]

package/template/golang/README.md

@@ -6,7 +6,28 @@ lzc-cli project deploy
 lzc-cli project info
 ```
 
-Then open the app from launcher or browser.
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+In dev mode, the app will not auto-start the Golang service.
+If the backend service is not ready yet, the app page will show the expected port and what to do next.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
 
 ## API
 ```text
@@ -21,13 +42,3 @@ DELETE /api/todos/{id}
 ```text
 /lzcapp/var/todos.json
 ```
-
-## Build LPK
-```bash
-lzc-cli project build -o golang-app.lpk
-```
-
-## Install
-```bash
-lzc-cli lpk install golang-app.lpk
-```

package/template/golang/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/golang/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/golang/lzc-build.yml

@@ -1,11 +1,6 @@
-# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
-
 # manifest: 指定 lpk 的 manifest 文件
 manifest: ./lzc-manifest.yml
 
-# contentdir: 需要打包进 lpk 的目录
-contentdir: ./
-
 # pkgout: lpk 输出目录
 pkgout: ./
 

package/template/golang/main.go

@@ -247,6 +247,6 @@ func main() {
 		writeJSON(w, http.StatusOK, map[string]bool{"ok": true})
 	})
 
-	mux.Handle("/", http.FileServer(http.Dir("/lzcapp/pkg/content/web")))
+	mux.Handle("/", http.FileServer(http.Dir("/app/web")))
 	_ = http.ListenAndServe(":3000", mux)
 }

package/template/golang/manifest.dev.page.js

@@ -0,0 +1,24 @@
+function renderDevPage(port) {
+  const title = "Backend dev service is not ready";
+  const subtitle = "This app is running in dev mode and expects the backend service to be started manually inside the app container.";
+  const pageTitle = "Backend Dev";
+  const steps = [
+    "Sync your latest code into the container with <code>lzc-cli project sync --watch</code> or copy it with <code>lzc-cli project cp</code>.",
+    "Open a shell with <code>lzc-cli project exec /bin/sh</code> and start or restart the backend process with <code>/app/run.sh</code>.",
+    "Refresh this page after port <code>" + String(port) + "</code> is ready.",
+  ];
+  const portText = port === undefined || port === null ? "" : String(port);
+  const items = steps.map(function (step) {
+    return "<li>" + step + "</li>";
+  }).join("");
+  const portBadge = portText ? "<div class=\"pill\">Expected local port: " + portText + "</div>" : "";
+  return [
+    "<!doctype html>",
+    "<html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>", pageTitle, "</title><style>",
+    "body{margin:0;padding:32px;font-family:ui-sans-serif,system-ui,sans-serif;background:#f5f8fc;color:#112033}",
+    ".card{max-width:760px;margin:0 auto;background:#fff;border:1px solid #d9e4f2;border-radius:18px;padding:24px;box-shadow:0 16px 40px rgba(17,32,51,.08)}",
+    "h1{margin:0 0 12px;font-size:32px}.muted{color:#51627a}.pill{display:inline-block;margin:16px 0 0;padding:6px 10px;border-radius:999px;background:#eef5ff;color:#0c5dd6;font-weight:600}",
+    "ol{margin:18px 0 0;padding-left:20px;line-height:1.8}code{background:#f2f6fb;border-radius:8px;padding:2px 6px}button{margin-top:20px;border:0;border-radius:10px;padding:10px 14px;background:#112033;color:#fff;cursor:pointer}",
+    "</style></head><body><main class=\"card\"><h1>", title, "</h1><p class=\"muted\">", subtitle, "</p>", portBadge, "<ol>", items, "</ol><button onclick=\"location.reload()\">Refresh</button></main></body></html>",
+  ].join("");
+}

package/template/golang/run.sh

@@ -1,3 +1,10 @@
 #!/bin/sh
 set -e
+
+mirror_root="/lzcapp/cache/project-mirror"
+if command -v go >/dev/null 2>&1 && [ -f "$mirror_root/main.go" ]; then
+	cd "$mirror_root"
+	exec go run ./main.go
+fi
+
 exec /app/app

package/template/gui-vnc/README.md

@@ -6,11 +6,15 @@ lzc-cli project deploy
 lzc-cli project info
 ```
 
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
 Then open the app from launcher or browser.
 
 ## Build LPK
 ```bash
-lzc-cli project release -f lzc-build.yml -o gui-vnc.lpk
+lzc-cli project release -o gui-vnc.lpk
 ```
 
 ## Install

package/template/gui-vnc/lzc-build.dev.yml

@@ -0,0 +1,4 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev

package/template/gui-vnc/lzc-build.yml

@@ -1,11 +1,6 @@
-# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
-
 # manifest: 指定 lpk 的 manifest 文件
 manifest: ./lzc-manifest.yml
 
-# contentdir: 需要打包进 lpk 的目录
-contentdir: ./
-
 # pkgout: lpk 输出目录
 pkgout: ./
 

package/template/python/Dockerfile

@@ -9,7 +9,7 @@ RUN pip3 install --no-cache-dir -r /app/requirements.txt --break-system-packages
 COPY app.py /app/app.py
 COPY run.sh /app/run.sh
 RUN chmod +x /app/run.sh
-COPY web /lzcapp/pkg/content/web
+COPY web /app/web
 
 EXPOSE 3000
-CMD ["python3", "/app/app.py"]
+CMD ["/app/run.sh"]

package/template/python/Dockerfile.dev

@@ -0,0 +1,18 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache python3 py3-pip
+WORKDIR /app
+
+ENV LZC_PY_DEV=1
+ENV PYTHONUNBUFFERED=1
+
+COPY requirements.txt /app/requirements.txt
+RUN pip3 install --no-cache-dir -r /app/requirements.txt --break-system-packages
+
+COPY app.py /app/app.py
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh
+COPY web /app/web
+
+EXPOSE 3000
+CMD ["/app/run.sh"]

package/template/python/README.md

@@ -6,7 +6,34 @@ lzc-cli project deploy
 lzc-cli project info
 ```
 
-Then open the app from launcher or browser.
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+In dev mode, the Python service starts automatically.
+If the page still shows the backend dev guide, it will tell you the expected port and next step.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+```
+
+The dev image starts the Python service automatically and reloads on source changes.
+If you changed dependencies or need to restart the process manually:
+
+```bash
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
 
 ## API
 ```text
@@ -21,13 +48,3 @@ DELETE /api/todos/{id}
 ```text
 /lzcapp/var/todos.json
 ```
-
-## Build LPK
-```bash
-lzc-cli project build -o python-app.lpk
-```
-
-## Install
-```bash
-lzc-cli lpk install python-app.lpk
-```

package/template/python/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/python/app.py

@@ -3,7 +3,7 @@ import os
 import time
 from flask import Flask, send_from_directory, request
 
-app = Flask(__name__, static_folder="/lzcapp/pkg/content/web", static_url_path="")
+app = Flask(__name__, static_folder="/app/web", static_url_path="")
 DATA_FILE = "/lzcapp/var/todos.json"
 todos = []
 next_id = 1

package/template/python/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/python/lzc-build.yml

@@ -1,11 +1,6 @@
-# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
-
 # manifest: 指定 lpk 的 manifest 文件
 manifest: ./lzc-manifest.yml
 
-# contentdir: 需要打包进 lpk 的目录
-contentdir: ./
-
 # pkgout: lpk 输出目录
 pkgout: ./
 

package/template/python/manifest.dev.page.js

@@ -0,0 +1,25 @@
+function renderDevPage(port) {
+  const title = "Python dev service is not ready";
+  const subtitle = "This app starts the Python dev service automatically in dev mode. If the page still shows this guide, the process is still starting or needs attention.";
+  const pageTitle = "Backend Dev";
+  const steps = [
+    "Sync your latest code into the container with <code>lzc-cli project sync --watch</code> or copy it with <code>lzc-cli project cp</code>.",
+    "Check the service log with <code>lzc-cli project log -f</code>.",
+    "If you need to restart the process manually, open <code>lzc-cli project exec /bin/sh</code> and run <code>/app/run.sh</code>.",
+    "Refresh this page after port <code>" + String(port) + "</code> is ready.",
+  ];
+  const portText = port === undefined || port === null ? "" : String(port);
+  const items = steps.map(function (step) {
+    return "<li>" + step + "</li>";
+  }).join("");
+  const portBadge = portText ? "<div class=\"pill\">Expected local port: " + portText + "</div>" : "";
+  return [
+    "<!doctype html>",
+    "<html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>", pageTitle, "</title><style>",
+    "body{margin:0;padding:32px;font-family:ui-sans-serif,system-ui,sans-serif;background:#f5f8fc;color:#112033}",
+    ".card{max-width:760px;margin:0 auto;background:#fff;border:1px solid #d9e4f2;border-radius:18px;padding:24px;box-shadow:0 16px 40px rgba(17,32,51,.08)}",
+    "h1{margin:0 0 12px;font-size:32px}.muted{color:#51627a}.pill{display:inline-block;margin:16px 0 0;padding:6px 10px;border-radius:999px;background:#eef5ff;color:#0c5dd6;font-weight:600}",
+    "ol{margin:18px 0 0;padding-left:20px;line-height:1.8}code{background:#f2f6fb;border-radius:8px;padding:2px 6px}button{margin-top:20px;border:0;border-radius:10px;padding:10px 14px;background:#112033;color:#fff;cursor:pointer}",
+    "</style></head><body><main class=\"card\"><h1>", title, "</h1><p class=\"muted\">", subtitle, "</p>", portBadge, "<ol>", items, "</ol><button onclick=\"location.reload()\">Refresh</button></main></body></html>",
+  ].join("");
+}

package/template/python/run.sh

@@ -1,3 +1,14 @@
 #!/bin/sh
 set -e
-exec python3 /app/app.py
+
+mirror_root="/lzcapp/cache/project-mirror"
+app_file="/app/app.py"
+if [ -f "$mirror_root/app.py" ]; then
+	app_file="$mirror_root/app.py"
+fi
+
+if [ "${LZC_PY_DEV:-}" = "1" ]; then
+	exec python3 -m flask --app "$app_file" run --debug --host 0.0.0.0 --port 3000
+fi
+
+exec python3 "$app_file"

package/template/springboot/Dockerfile

@@ -17,4 +17,4 @@ COPY run.sh /app/run.sh
 RUN chmod +x /app/run.sh
 
 EXPOSE 8080
-CMD ["java", "-jar", "/app/app.jar"]
+CMD ["/app/run.sh"]

package/template/springboot/Dockerfile.dev

@@ -0,0 +1,20 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache openjdk17 maven
+WORKDIR /workspace
+
+COPY pom.xml ./
+COPY src ./src
+RUN mvn -DskipTests package
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache openjdk17 maven
+WORKDIR /app
+
+COPY --from=builder /workspace/target/*.jar /app/app.jar
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh
+
+EXPOSE 8080
+CMD ["sh", "-lc", "trap : TERM INT; sleep infinity & wait"]

package/template/springboot/README.md

@@ -6,7 +6,28 @@ lzc-cli project deploy
 lzc-cli project info
 ```
 
-Then open the app from launcher or browser.
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+If the backend dev service is not ready yet, the app page will show the expected port and what to do next.
+In dev mode, the Spring Boot service is started manually inside the app container.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
 
 ## API
 ```text
@@ -21,13 +42,3 @@ DELETE /api/todos/{id}
 ```text
 /lzcapp/var/todos.json
 ```
-
-## Build LPK
-```bash
-lzc-cli project build -o springboot-app.lpk
-```
-
-## Install
-```bash
-lzc-cli lpk install springboot-app.lpk
-```

package/template/springboot/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/springboot/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/springboot/lzc-build.yml

@@ -1,11 +1,6 @@
-# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
-
 # manifest: 指定 lpk 的 manifest 文件
 manifest: ./lzc-manifest.yml
 
-# contentdir: 需要打包进 lpk 的目录
-contentdir: ./
-
 # pkgout: lpk 输出目录
 pkgout: ./
 

package/template/springboot/manifest.dev.page.js

@@ -0,0 +1,24 @@
+function renderDevPage(port) {
+  const title = "Backend dev service is not ready";
+  const subtitle = "This app is running in dev mode and expects the backend service to be started manually inside the app container.";
+  const pageTitle = "Backend Dev";
+  const steps = [
+    "Sync your latest code into the container with <code>lzc-cli project sync --watch</code> or copy it with <code>lzc-cli project cp</code>.",
+    "Open a shell with <code>lzc-cli project exec /bin/sh</code> and start or restart the backend process with <code>/app/run.sh</code>.",
+    "Refresh this page after port <code>" + String(port) + "</code> is ready.",
+  ];
+  const portText = port === undefined || port === null ? "" : String(port);
+  const items = steps.map(function (step) {
+    return "<li>" + step + "</li>";
+  }).join("");
+  const portBadge = portText ? "<div class=\"pill\">Expected local port: " + portText + "</div>" : "";
+  return [
+    "<!doctype html>",
+    "<html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>", pageTitle, "</title><style>",
+    "body{margin:0;padding:32px;font-family:ui-sans-serif,system-ui,sans-serif;background:#f5f8fc;color:#112033}",
+    ".card{max-width:760px;margin:0 auto;background:#fff;border:1px solid #d9e4f2;border-radius:18px;padding:24px;box-shadow:0 16px 40px rgba(17,32,51,.08)}",
+    "h1{margin:0 0 12px;font-size:32px}.muted{color:#51627a}.pill{display:inline-block;margin:16px 0 0;padding:6px 10px;border-radius:999px;background:#eef5ff;color:#0c5dd6;font-weight:600}",
+    "ol{margin:18px 0 0;padding-left:20px;line-height:1.8}code{background:#f2f6fb;border-radius:8px;padding:2px 6px}button{margin-top:20px;border:0;border-radius:10px;padding:10px 14px;background:#112033;color:#fff;cursor:pointer}",
+    "</style></head><body><main class=\"card\"><h1>", title, "</h1><p class=\"muted\">", subtitle, "</p>", portBadge, "<ol>", items, "</ol><button onclick=\"location.reload()\">Refresh</button></main></body></html>",
+  ].join("");
+}

package/template/springboot/run.sh

@@ -1,3 +1,10 @@
 #!/bin/sh
 set -e
+
+mirror_root="/lzcapp/cache/project-mirror"
+if command -v mvn >/dev/null 2>&1 && [ -f "$mirror_root/pom.xml" ]; then
+	cd "$mirror_root"
+	exec mvn spring-boot:run
+fi
+
 exec java -jar /app/app.jar

package/template/vue/README.md

@@ -1,39 +1,26 @@
-# 懒猫云应用
+# Lazycat Vue App
 
-## 第一次部署（先看到结果）
-```
+## First Deploy
+```bash
 lzc-cli project deploy
 lzc-cli project info
 ```
 
-执行完成后：
-1. 在微服启动器点击应用图标打开。
-2. 或根据 `project info` 输出中的域名在手机/PC浏览器访问。
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
 
-## 修改源码后再次部署
-```bash
-lzc-cli project deploy
-```
+Open the app first.
+If the frontend dev server is not running yet, the app page will show the expected port and next step.
 
-建议同时打开日志排查问题：
+## Frontend Dev Loop
 ```bash
-lzc-cli project log -f
+npm run dev
 ```
 
-## 构建
-```
-lzc-cli project build -o you-awesome.lpk
-```
+Then refresh the app page.
 
-会在当前的目录下构建出一个 lpk 包。
-
-## 安装
-```
-lzc-cli lpk install you-awesome.lpk
+## Logs
+```bash
+lzc-cli project log -f
 ```
-
-会安装在你的微服应用中,安装成功后可在懒猫微服启动器中查看!
-
-## 交流和帮助
-
-你可以在 https://bbs.lazycat.cloud/ 畅所欲言。

package/template/vue/_gitignore

@@ -23,4 +23,3 @@ pnpm-debug.log*
 *.sw?
 .temp
 .cache
-lzc-build.base.yml

package/template/vue/lzc-build.dev.yml

@@ -0,0 +1,7 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1

package/template/vue/lzc-build.yml

@@ -1,5 +1,3 @@
-# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
-
 # buildscript
 # - 可以为构建脚本的路径地址
 # - 如果构建命令简单，也可以直接写 sh 的命令