@lazycatcloud/lzc-cli 1.3.17 → 2.0.0-pre.1

package/README.md

@@ -14,22 +14,62 @@ npm install -g @lazycatcloud/lzc-cli
 lzc-cli completion >> ~/.zshrc
 ```
 
-下面开始使用 `lzc-cli` 去创建一个项目吧!
+下面开始使用 `lzc-cli` 去创建一个项目吧。
 
 ```bash
+# 在新目录创建项目（交互选择模板）
 lzc-cli project create you_project
 
-# 构建懒猫云平台lpk包
-lzc-cli project build
+# 在当前目录初始化空白项目
+lzc-cli project create --in-place
 
-# 将lpk包安装到盒子中去
-lzc-cli app install
+# 部署开发态项目（优先使用 lzc-build.dev.yml）
+lzc-cli project deploy
 
-# 使用 devshell 可以让你在盒子中开发调试
-lzc-cli project devshell
+# 查看当前部署信息与 Target URL
+lzc-cli project info
+
+# 持续同步本地代码到真实运行环境
+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)
+
+#### box add-by-ssh 远端直连模式
+
+当运行环境无法使用 `hclient` 时，可通过 `box add-by-ssh` 配置远端 ssh 目标，由 `lzc-cli` 直连 `lzcos ssh` 并在远端执行 debug bridge 命令。
+
+示例：
+
+```bash
+lzc-cli box add-by-ssh root 192.168.31.13
+```
+
+说明：
+
+1. 参数格式为 `loginUser address`，地址支持 `host` 或 `host:port`
+2. 配置后会自动设为默认盒子，可通过 `box list/switch/default` 管理
+3. `project release/deploy/start/exec/cp/log/info`、`lpk install/uninstall`、`docker/docker-compose` 都会优先使用该远端
+4. `lzc-build.yml` 不再支持 `remote` 字段
+5. 可选基础配置文件为 `lzc-build.base.yml`（与构建配置同目录）

package/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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
+
+- 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)
 
 

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

@@ -1,7 +1,14 @@
 import path from 'node:path';
-import lpkCreate from './lpk_create.js';
+import lpkCreate, { listProjectTemplateValues, normalizeTemplateType } from './lpk_create.js';
 import { LpkBuild } from './lpk_build.js';
 import { AppDevShell } from './lpk_devshell.js';
+import { projectExecCommand } from './project_exec.js';
+import { projectCpCommand } from './project_cp.js';
+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';
@@ -9,28 +16,110 @@ import { DebugBridge } from '../debug_bridge.js';
 import shellApi from '../shellapi.js';
 import { generate } from './lpk_create_generator.js';
 import { t } from '../i18n/index.js';
+import { resolveBuildRemoteFromFile } from '../build_remote.js';
+import { resolveProjectReleaseConfigPath } from './project_runtime.js';
+
+async function installLpk(pkgPath, apk) {
+	if (!resolveBuildRemoteFromFile(process.cwd())) {
+		await shellApi.init();
+	}
+	installConfig.apk = apk == 'y';
+
+	const installPath = pkgPath ?? process.cwd();
+	const installer = new LpkInstaller();
+	await installer.init();
+	await installer.install(installPath);
+}
+
+async function uninstallLpk(pkgId, deleteData) {
+	const buildRemote = resolveBuildRemoteFromFile(process.cwd());
+	if (!buildRemote) {
+		await shellApi.init();
+	}
+
+	const bridge = new DebugBridge(process.cwd(), buildRemote);
+	await bridge.init();
+	await bridge.uninstall(pkgId, deleteData);
+	logger.debug(`default lcmd device: ${bridge.boxname} , uninstall the app ${pkgId} finish`);
+}
+
+function lpkInstallSubCommand({ desc }) {
+	return {
+		command: 'install [pkgPath]',
+		desc,
+		builder: (args) => {
+			args.option('apk', {
+				describe: t('lzc_cli.lib.app.index.lpk_cmd_index_rags_apk_desc', '是否生成APK(y/n)'),
+				type: 'string',
+				default: 'y',
+			});
+		},
+		handler: async ({ pkgPath, apk }) => {
+			await installLpk(pkgPath, apk);
+		},
+	};
+}
+
+function lpkUninstallSubCommand({ desc }) {
+	return {
+		command: 'uninstall <pkgId>',
+		desc,
+		builder: (args) => {
+			args.option('delete-data', {
+				describe: t('lzc_cli.lib.app.index.lpk_cmd_uninstall_rags_delete_data_desc', '删除应用数据 ⚠️ 警告: 应用数据删除后无法恢复'),
+				type: 'boolean',
+				default: false,
+			});
+		},
+		handler: async ({ pkgId, deleteData }) => {
+			await uninstallLpk(pkgId, deleteData);
+		},
+	};
+}
 
 export function lpkProjectCommand(program) {
 	let subCommands = [
 		{
-			command: 'init',
-			desc: t('lzc_cli.lib.app.index.lpk_cmd_init_desc', '初始化懒猫云应用(提供最基础的模板)'),
-			handler: async () => {
-				generate('blank', './');
-				logger.info(t('lzc_cli.lib.app.index.lpk_cmd_init_success', '应用初始化完成'));
-			},
-		},
-		{
-			command: 'create <name>',
+			command: 'create [name]',
 			desc: t('lzc_cli.lib.app.index.lpk_cmd_create_desc', '创建懒猫云应用'),
-			handler: async ({ name }) => {
-				name = String(name);
-				await lpkCreate(name);
+			builder: (args) => {
+				args.option('in-place', {
+					describe: 'Initialize current directory with blank template',
+					type: 'boolean',
+					default: false,
+				});
+				args.option('t', {
+					alias: 'template',
+					describe: `Template name (${listProjectTemplateValues().join(', ')})`,
+					type: 'string',
+				});
+			},
+			handler: async ({ name, inPlace, template }) => {
+				if (name && inPlace) {
+					throw new Error('--in-place cannot be used with <name>.');
+				}
+				const normalizedTemplate = normalizeTemplateType(template);
+				if (name) {
+					name = String(name);
+					await lpkCreate(name, process.cwd(), normalizedTemplate);
+					return;
+				}
+
+				if (inPlace) {
+					if (normalizedTemplate) {
+						throw new Error('--template cannot be used with --in-place.');
+					}
+					generate('blank', './');
+					logger.info(t('lzc_cli.lib.app.index.lpk_cmd_init_success', '应用初始化完成'));
+					return;
+				}
+
+				throw new Error('Project name is required unless --in-place is used.');
 			},
 		},
 		{
 			command: 'build [context]',
-			desc: t('lzc_cli.lib.app.index.lpk_cmd_build_desc', '构建'),
+			desc: false,
 			builder: (args) => {
 				args.option('o', {
 					alias: 'output',
@@ -46,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'];
@@ -58,9 +148,42 @@ export function lpkProjectCommand(program) {
 				await lpk.exec();
 			},
 		},
+		{
+			command: 'release [context]',
+			desc: 'Build release package',
+			builder: (args) => {
+				args.option('o', {
+					alias: 'output',
+					describe: t('lzc_cli.lib.app.index.lpk_cmd_build_args_output_desc', '输出文件'),
+					type: 'string',
+				});
+				args.option('f', {
+					alias: 'file',
+					describe: t('lzc_cli.lib.app.index.lpk_cmd_build_args_file_desc', '指定构建的lzc-build.yml文件'),
+					type: 'string',
+				});
+			},
+			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();
+				lpk.onBeforeBuildPackage(async (options) => {
+					delete options['devshell'];
+
+					if (output) {
+						options['lpkPath'] = output;
+					}
+					return options;
+				});
+				await lpk.exec();
+			},
+		},
 		{
 			command: 'devshell [context]',
-			desc: t('lzc_cli.lib.app.index.lpk_cmd_devshell_desc', '进入盒子的开发环境'),
+			desc: false,
 			builder: (args) => {
 				args.option('f', {
 					alias: 'force',
@@ -84,12 +207,16 @@ export function lpkProjectCommand(program) {
 				});
 			},
 			handler: async ({ context, force, config, contentdir, apk }) => {
-				await shellApi.init();
+				logger.warn('project devshell is deprecated. Use "project deploy", "project start", "project exec", "project cp", and "project log" instead.');
+				const cwd = context ? path.resolve(context) : process.cwd();
+				const buildRemote = resolveBuildRemoteFromFile(cwd, config);
+				if (!buildRemote) {
+					await shellApi.init();
+				}
 				// 检测 rsync 满足
 				await checkRsync();
 
 				installConfig.apk = apk == 'y';
-				const cwd = context ? path.resolve(context) : process.cwd();
 				const lpkBuild = await new LpkBuild(cwd, config).init();
 				lpkBuild.onBeforeBuildPackage(async (options) => {
 					// devshell 正常情况下，不需要执行 buildscript 和 contentdir 字段
@@ -109,6 +236,27 @@ export function lpkProjectCommand(program) {
 				await app.rsyncShell();
 			},
 		},
+		{
+			command: 'app',
+			desc: false,
+			builder: (args) => {
+				args.command([
+					lpkInstallSubCommand({
+						desc: false,
+					}),
+					lpkUninstallSubCommand({
+						desc: false,
+					}),
+				]);
+			},
+		},
+		projectExecCommand(),
+		projectCpCommand(),
+		projectLogCommand(),
+		projectInfoCommand(),
+		projectStartCommand(),
+		projectDeployCommand(),
+		projectSyncCommand(),
 	];
 	program.command({
 		command: 'project',
@@ -121,58 +269,22 @@ export function lpkProjectCommand(program) {
 
 export function lpkAppCommand(program) {
 	let subCommands = [
-		{
-			command: 'install [pkgPath]',
+		lpkInstallSubCommand({
 			desc: t('lzc_cli.lib.app.index.lpk_cmd_install_desc', '部署应用至设备, pkgPath 可以为路径，或者https://,http://请求地址, 如果不填写，将默认为当前目录下的lpk'),
-			builder: (args) => {
-				args.option('apk', {
-					describe: t('lzc_cli.lib.app.index.lpk_cmd_index_rags_apk_desc', '是否生成APK(y/n)'),
-					type: 'string',
-					default: 'y',
-				});
-				args.option('ssh-private-key', {
-					alias: 'ssh-key',
-					describe: t('lzc_cli.lib.app.index.lpk_cmd_install_args_ssh_private_key_desc', '指定安装时用于连接设备的 SSH 私钥路径(兼容别名: --ssh-key)'),
-					type: 'string',
-				});
-			},
-			handler: async ({ pkgPath, apk, sshPrivateKey }) => {
-				await shellApi.init();
-				installConfig.apk = apk == 'y';
-				installConfig.sshPrivateKey = sshPrivateKey ? path.resolve(sshPrivateKey) : '';
-
-				pkgPath = pkgPath ?? process.cwd();
-				const installer = new LpkInstaller();
-				await installer.init();
-				await installer.install(pkgPath);
-			},
-		},
-		{
-			command: 'uninstall <pkgId>',
+		}),
+		lpkUninstallSubCommand({
 			desc: t('lzc_cli.lib.app.index.lpk_cmd_uninstall_desc', '从设备中卸载某一个应用'),
-			builder: (args) => {
-				args.option('delete-data', {
-					describe: t('lzc_cli.lib.app.index.lpk_cmd_uninstall_rags_delete_data_desc', '删除应用数据 ⚠️ 警告: 应用数据删除后无法恢复'),
-					type: 'boolean',
-					default: false,
-				});
-			},
-			handler: async ({ pkgId, deleteData }) => {
-				await shellApi.init();
-
-				const bridge = new DebugBridge();
-				await bridge.init();
-				await bridge.uninstall(pkgId, deleteData);
-				logger.debug(`default lcmd device: ${bridge.boxname} , uninstall the app ${pkgId} finish`);
-			},
-		},
+		}),
 		{
 			command: 'status <pkgId>',
 			desc: t('lzc_cli.lib.app.index.lpk_cmd_status_desc', '获取某一个应用的状态'),
 			handler: async ({ pkgId }) => {
-				await shellApi.init();
+				const buildRemote = resolveBuildRemoteFromFile(process.cwd());
+				if (!buildRemote) {
+					await shellApi.init();
+				}
 
-				const bridge = new DebugBridge();
+				const bridge = new DebugBridge(process.cwd(), buildRemote);
 				await bridge.init();
 				const status = await bridge.status(pkgId);
 				console.log(status);
@@ -190,7 +302,9 @@ export function lpkAppCommand(program) {
 				});
 			},
 			handler: async () => {
-				await shellApi.init();
+				if (!resolveBuildRemoteFromFile(process.cwd())) {
+					await shellApi.init();
+				}
 
 				throw 'not yet realized';
 			},
@@ -198,7 +312,7 @@ export function lpkAppCommand(program) {
 	];
 	program.command({
 		command: 'app',
-		desc: t('lzc_cli.lib.app.index.lpk_cmd_app_desc', '应用管理'),
+		desc: false,
 		builder: async (args) => {
 			args.command(subCommands);
 		},