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

package/README.md

@@ -14,7 +14,7 @@ npm install -g @lazycatcloud/lzc-cli
 lzc-cli completion >> ~/.zshrc
 ```
 
-下面开始使用 `lzc-cli` 去创建一个项目吧!
+下面开始使用 `lzc-cli` 去创建一个项目吧。
 
 ```bash
 # 在新目录创建项目（交互选择模板）
@@ -23,24 +23,63 @@ lzc-cli project create you_project
 # 在当前目录初始化空白项目
 lzc-cli project create --in-place
 
-# 构建 release lpk 包（优先 lzc-build.release.yml，不存在则回退 lzc-build.yml）
-lzc-cli project release
+# 部署开发态项目（优先使用 lzc-build.dev.yml）
+lzc-cli project deploy
 
-# 将lpk包安装到盒子中去
-lzc-cli lpk install
+# 查看当前部署信息与 Target URL
+lzc-cli project info
 
-# 部署后默认自动启动
-lzc-cli project deploy
+# 持续同步本地代码到真实运行环境
+lzc-cli project sync --watch
 
 # 进入运行容器调试
 lzc-cli project exec /bin/sh
 
+# 构建 release lpk 包（使用 lzc-build.yml）
+lzc-cli project release
+
+# 将 lpk 包安装到盒子中去
+lzc-cli lpk install
+
 # 经过测试后，将包发布到懒猫云商店中去
 lzc-cli appstore publish
 ```
 
+补充说明：
+
+1. 只要项目里存在 `lzc-build.dev.yml`，`project deploy/info/start/exec/cp/log/sync` 默认都会优先使用它。
+2. 所有 `project` 命令都会打印当前实际使用的 `Build config`。
+3. 如需显式操作 release，请加 `--release`。
+4. 前端模板建议先 `project deploy` 并打开应用，再根据页面提示执行 `npm run dev`。
+5. 后端模板建议先打开应用，再根据页面提示执行 `project sync --watch` 与容器内进程启动。
+6. `project create` 生成的新项目会默认包含 `lzc-manifest.yml` 与 `package.yml`；静态包元数据不再写在 manifest 顶层。
+
 [changelog](./changelog.md)
 
+#### images 本地构建
+
+`lzc-build.yml:images.<alias>.builder` 支持两种模式：
+
+1. `remote`：默认值。在微服上的 developer tools 中构建镜像。
+2. `local`：在开发机本地构建镜像，再上传给 developer tools 生成最终的 `images/` 与 `images.lock`。
+
+示例：
+
+```yml
+images:
+  app-runtime:
+    builder: local
+    dockerfile: ./images/Dockerfile
+    context: ./images
+```
+
+说明：
+
+1. `builder=local` 的目标平台会自动从当前目标微服获取，例如 `linux/amd64`。
+2. `builder=local` 依赖开发机本地可用的 Docker/buildx 兼容命令。
+3. 基础镜像需要开发机自己能够拉取；如果当前网络环境有限制，建议显式使用可访问的镜像地址。
+4. `upstream-match` 对 `builder=remote` 与 `builder=local` 都生效；`builder=local` 会优先读取本地构建器元数据，必要时再根据 Dockerfile 的最终基底镜像推导上游层。
+
 #### box add-by-ssh 远端直连模式
 
 当运行环境无法使用 `hclient` 时，可通过 `box add-by-ssh` 配置远端 ssh 目标，由 `lzc-cli` 直连 `lzcos ssh` 并在远端执行 debug bridge 命令。

package/changelog.md

@@ -1,52 +1,89 @@
 # Changelog
 
-## 2.0.0-pre.0
+## [2.0.0-pre.2](https://gitee.com/linakesi/lzc-cli/compare/v2.0.0-pre.1...v2.0.0-pre.2) (2026-03-12)
 
-1. Add lpkv2 features for internal testing
+### Bug Fixes
 
-## [1.3.14](https://gitee.com/linakesi/lzc-cli/compare/v1.3.13...v1.3.14) (2025-12-17)
+- publish the current LPK v2 preview through the `lpkv2` dist-tag
+
+## [2.0.0-pre.1](https://gitee.com/linakesi/lzc-cli/compare/v1.3.17...v2.0.0-pre.1) (2026-03-11)
+
+### Features
 
+- add the LPK v2 project workflow with `project deploy`, `project start`, `project exec`, `project log`, `project cp`, and `project sync`
+- refresh `project create` templates for request inject based frontend and backend development
+- add dev id sync support during `project deploy` for remote development routing
 
 ### Bug Fixes
 
-* dealing with the i18n difference escape problem ([2b98cdf](https://gitee.com/linakesi/lzc-cli/commits/2b98cdf0573a1537bee409079d6160da1b7cd80b))
+- restore old cli devshell compatibility with current developer tools backend
+- refine `project exec` and deploy behavior in dev mode
+- load Vue devtools only in serve mode
 
+## [1.3.17](https://gitee.com/linakesi/lzc-cli/compare/v1.3.15...v1.3.17) (2026-03-03)
 
-### Features
 
-* cmd publish add `changelog-files` option ([17d95c6](https://gitee.com/linakesi/lzc-cli/commits/17d95c6fa761f25af234946dedd3d6a0503ba962))
+### Bug Fixes
 
-## [1.3.13](https://gitee.com/linakesi/lzc-cli/compare/v1.3.12...v1.3.13) (2025-12-10)
+* dealing with the error prompt of creating a new app ([6069b28](https://gitee.com/linakesi/lzc-cli/commits/6069b282027c7a6ddbcde45a0ff26156e6745030))
+* playground site url ([5afd2ec](https://gitee.com/linakesi/lzc-cli/commits/5afd2ec5edd8aee51579add5daed3ccaabc4650f))
+* submit the app file size ([7dffe90](https://gitee.com/linakesi/lzc-cli/commits/7dffe90b4a18f6f4b8afd8ace23c836d7fba17a7))
 
+## [1.3.16](https://gitee.com/linakesi/lzc-cli/compare/v1.3.13...v1.3.16) (2026-02-28)
+
+### Bug Fixes
+
+- dealing with the i18n difference escape problem ([2b98cdf](https://gitee.com/linakesi/lzc-cli/commits/2b98cdf0573a1537bee409079d6160da1b7cd80b))
+- disable i18next support notice output ([f433c88](https://gitee.com/linakesi/lzc-cli/commits/f433c88e9a2434c9cff303c088fa39d33bf59309))
+- playground site url ([5afd2ec](https://gitee.com/linakesi/lzc-cli/commits/5afd2ec5edd8aee51579add5daed3ccaabc4650f))
 
 ### Features
 
-* add i18n ([f62c52a](https://gitee.com/linakesi/lzc-cli/commits/f62c52a9b443d2226ffa06d17593f1912b9dc4de))
-* add i18n config ([185418d](https://gitee.com/linakesi/lzc-cli/commits/185418d5e77858d55fca485ff115191c0c95834e))
-* some copywriters provide i18n calls ([54d92f1](https://gitee.com/linakesi/lzc-cli/commits/54d92f17520e6413d735c82d57d3aa3404410add))
+- cmd publish add `changelog-files` option ([17d95c6](https://gitee.com/linakesi/lzc-cli/commits/17d95c6fa761f25af234946dedd3d6a0503ba962))
 
-## [1.3.12](https://gitee.com/linakesi/lzc-cli/compare/v1.3.11...v1.3.12) (2025-10-29)
+## [1.3.15](https://gitee.com/linakesi/lzc-cli/compare/v1.3.14...v1.3.15) (2026-02-26)
 
+### Bug Fixes
+
+- disable i18next support notice output ([f433c88](https://gitee.com/linakesi/lzc-cli/commits/f433c88e9a2434c9cff303c088fa39d33bf59309))
+
+## [1.3.14](https://gitee.com/linakesi/lzc-cli/compare/v1.3.13...v1.3.14) (2025-12-17)
 
 ### Bug Fixes
 
-*  ci friendly publish command ([1e7b477](https://gitee.com/linakesi/lzc-cli/commits/1e7b47740f1d9ae15d677a16a97d7cc461814c42))
-* pre publish print error ([55c8326](https://gitee.com/linakesi/lzc-cli/commits/55c832625aa532bab3e0fcf0d7ec09d8235db190))
+- dealing with the i18n difference escape problem ([2b98cdf](https://gitee.com/linakesi/lzc-cli/commits/2b98cdf0573a1537bee409079d6160da1b7cd80b))
+
+### Features
 
+- cmd publish add `changelog-files` option ([17d95c6](https://gitee.com/linakesi/lzc-cli/commits/17d95c6fa761f25af234946dedd3d6a0503ba962))
+
+## [1.3.13](https://gitee.com/linakesi/lzc-cli/compare/v1.3.12...v1.3.13) (2025-12-10)
 
 ### Features
 
-* add `LZC_CLI_CHECK_DNS_RESOLVE` set check dev tools to use built-in dns resolution ([78ba39e](https://gitee.com/linakesi/lzc-cli/commits/78ba39e6869cbed956141e7ff7812ce3718e41ce))
-* supports config the language key for publish app update logs through `--clang` ([e06eec8](https://gitee.com/linakesi/lzc-cli/commits/e06eec88f11827816ddd4e3a7ccd43b2883a1003))
-* uninstall app add `--delete-data` parameter ([b4378f7](https://gitee.com/linakesi/lzc-cli/commits/b4378f77b528fbb5b5a1c74771ddda9f60f4e49a))
+- add i18n ([f62c52a](https://gitee.com/linakesi/lzc-cli/commits/f62c52a9b443d2226ffa06d17593f1912b9dc4de))
+- add i18n config ([185418d](https://gitee.com/linakesi/lzc-cli/commits/185418d5e77858d55fca485ff115191c0c95834e))
+- some copywriters provide i18n calls ([54d92f1](https://gitee.com/linakesi/lzc-cli/commits/54d92f17520e6413d735c82d57d3aa3404410add))
 
-## [1.3.11](https://gitee.com/linakesi/lzc-cli/compare/v1.3.10...v1.3.11) (2025-10-10)
+## [1.3.12](https://gitee.com/linakesi/lzc-cli/compare/v1.3.11...v1.3.12) (2025-10-29)
 
+### Bug Fixes
+
+- ci friendly publish command ([1e7b477](https://gitee.com/linakesi/lzc-cli/commits/1e7b47740f1d9ae15d677a16a97d7cc461814c42))
+- pre publish print error ([55c8326](https://gitee.com/linakesi/lzc-cli/commits/55c832625aa532bab3e0fcf0d7ec09d8235db190))
+
+### Features
+
+- add `LZC_CLI_CHECK_DNS_RESOLVE` set check dev tools to use built-in dns resolution ([78ba39e](https://gitee.com/linakesi/lzc-cli/commits/78ba39e6869cbed956141e7ff7812ce3718e41ce))
+- supports config the language key for publish app update logs through `--clang` ([e06eec8](https://gitee.com/linakesi/lzc-cli/commits/e06eec88f11827816ddd4e3a7ccd43b2883a1003))
+- uninstall app add `--delete-data` parameter ([b4378f7](https://gitee.com/linakesi/lzc-cli/commits/b4378f77b528fbb5b5a1c74771ddda9f60f4e49a))
+
+## [1.3.11](https://gitee.com/linakesi/lzc-cli/compare/v1.3.10...v1.3.11) (2025-10-10)
 
 ### Features
 
-* support setting token through environment variables ([4a25f84](https://gitee.com/linakesi/lzc-cli/commits/4a25f84fe4df938cb3d85f6391e27772dae5b071))
-* the copy-image command adds the `trace-level` parameter ([cd4d4c3](https://gitee.com/linakesi/lzc-cli/commits/cd4d4c351d4bd43bffcfe5f67087c6bffd65d3f4))
+- support setting token through environment variables ([4a25f84](https://gitee.com/linakesi/lzc-cli/commits/4a25f84fe4df938cb3d85f6391e27772dae5b071))
+- the copy-image command adds the `trace-level` parameter ([cd4d4c3](https://gitee.com/linakesi/lzc-cli/commits/cd4d4c351d4bd43bffcfe5f67087c6bffd65d3f4))
 
 ## [1.3.10](https://gitee.com/linakesi/lzc-cli/compare/v0.0.8...v1.3.10) (2025-08-15)
 

package/lib/app/apkshell.js

@@ -1,45 +1,8 @@
-import fs from 'node:fs';
-import logger from 'loglevel';
-import axios from 'axios';
-import { t } from '../i18n/index.js';
+import { triggerApk as triggerApkFunc } from '../appstore/apkshell.js';
 
-// 创建 Axios 实例
-const api = axios.create();
-
-// 添加响应拦截器
-api.interceptors.response.use(
-	(response) => response, // 直接返回响应
-	(error) => {
-		if (error.response && error.response.status === 304) {
-			return Promise.resolve(error.response); // 返回响应以便后续处理
-		}
-		return Promise.reject(error); // 其他错误继续抛出
-	},
-);
-
-export async function triggerApk(id, name, iconPath) {
-	if (!id) {
-		logger.error(t('lzc_cli.lib.app.apkshell.trigger_apk_empty_appid', 'Appid 为必填项!'));
-		return;
-	}
-	name = name || t('lzc_cli.lib.app.apkshell.trigger_apk_default_app_name', '懒猫应用');
-	try {
-		const form = new FormData();
-		form.append('app_id', id);
-		form.append('app_name', name);
-		if (iconPath) {
-			form.append('app_icon', new Blob([fs.readFileSync(iconPath)]));
-		}
-		const resp = await api.post('https://appstore.api.lazycat.cloud/api/trigger_latest_for_app', form, { timeout: 5000 });
-		if (resp.status == 304) {
-			logger.debug(t('lzc_cli.lib.app.apkshell.trigger_apk_build_tips', `APK构建任务已创建成功,如需使用安卓端,请耐心等待1分钟左右`));
-		} else if (resp.status <= 201) {
-			logger.info(t('lzc_cli.lib.app.apkshell.trigger_apk_build_ok_tips', `APK构建任务已创建成功,如需使用安卓端,请耐心等待1分钟左右`));
-		} else if (resp.status >= 400) {
-			logger.debug(t('lzc_cli.lib.app.apkshell.trigger_apk_build_failed', '请求按钮应用出错:'), resp);
-			throw t('lzc_cli.lib.app.apkshell.trigger_apk_build_failed_tips', `请求生成应用出错! 使用 --apk=n 停止生成APK`);
-		}
-	} catch (error) {
-		logger.debug(error);
-	}
-}
+/**
+ * @deprecated use appstore/apk.js triggerApk
+ * @return {*}
+ */
+const triggerApk = triggerApkFunc;
+export { triggerApk };

package/lib/app/index.js

@@ -8,6 +8,7 @@ import { projectLogCommand } from './project_log.js';
 import { projectInfoCommand } from './project_info.js';
 import { projectStartCommand } from './project_start.js';
 import { projectDeployCommand } from './project_deploy.js';
+import { projectSyncCommand } from './project_sync.js';
 import { LpkInstaller, installConfig } from './lpk_installer.js';
 import logger from 'loglevel';
 import { sleep, checkRsync } from '../utils.js';
@@ -113,7 +114,7 @@ export function lpkProjectCommand(program) {
 					return;
 				}
 
-				throw new Error('Project name is required unless --in-place is used.');
+				throw new Error('Missing project directory name. Use "lzc-cli project create <name>" to create a new project, or "lzc-cli project create --in-place" to initialize the current directory.');
 			},
 		},
 		{
@@ -134,6 +135,7 @@ export function lpkProjectCommand(program) {
 			},
 			handler: async ({ context, output, file }) => {
 				const lpk = await new LpkBuild(context, file).init();
+				logger.info(`Build config: ${lpk.optionsFilePath}`);
 				// 正常的打包逻辑不需要 devshell
 				lpk.onBeforeBuildPackage(async (options) => {
 					delete options['devshell'];
@@ -164,6 +166,7 @@ export function lpkProjectCommand(program) {
 			handler: async ({ context, output, file }) => {
 				const cwd = context ? path.resolve(context) : process.cwd();
 				const configPath = resolveProjectReleaseConfigPath(cwd, file);
+				logger.info(`Build config: ${configPath}`);
 				const projectCwd = path.dirname(configPath);
 				const configName = path.basename(configPath);
 				const lpk = await new LpkBuild(projectCwd, configName).init();
@@ -253,6 +256,7 @@ export function lpkProjectCommand(program) {
 		projectInfoCommand(),
 		projectStartCommand(),
 		projectDeployCommand(),
+		projectSyncCommand(),
 	];
 	program.command({
 		command: 'project',