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

package/scripts/smoke/frontend-dev-entry.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
+
+async function loadPlaywright() {
+  const require = createRequire(import.meta.url);
+  const hints = [
+    process.env.LZC_CLI_PLAYWRIGHT_MODULE,
+    path.join(process.cwd(), 'node_modules', 'playwright'),
+    '/tmp/pw-lzc-test/node_modules/playwright',
+    'playwright',
+  ].filter(Boolean);
+  for (const hint of hints) {
+    try {
+      const resolved = require.resolve(hint);
+      return await import(pathToFileURL(resolved).href);
+    } catch {}
+    try {
+      return await import(hint);
+    } catch {}
+  }
+  throw new Error('playwright module not found; set LZC_CLI_PLAYWRIGHT_MODULE or install playwright');
+}
+
+function getArg(name, fallback = '') {
+  const prefix = `--${name}=`;
+  const hit = process.argv.find((arg) => arg.startsWith(prefix));
+  return hit ? hit.slice(prefix.length) : fallback;
+}
+
+function requireArg(name) {
+  const value = getArg(name);
+  if (!value) {
+    throw new Error(`missing --${name}`);
+  }
+  return value;
+}
+
+const mode = requireArg('mode');
+const target = requireArg('url');
+const screenshot = getArg('screenshot');
+const username = getArg('username');
+const password = getArg('password');
+const expectedTitle = getArg('title');
+const requireTexts = getArg('require-text').split('||').map((item) => item.trim()).filter(Boolean);
+const forbidTexts = getArg('forbid-text').split('||').map((item) => item.trim()).filter(Boolean);
+
+const playwright = await loadPlaywright();
+const chromium = playwright.chromium || playwright.default?.chromium || playwright["module.exports"]?.chromium;
+if (!chromium) {
+  throw new Error("playwright chromium export not found");
+}
+const browser = await chromium.launch({ headless: true });
+const page = await browser.newPage();
+try {
+  await page.goto(target, { waitUntil: 'domcontentloaded', timeout: 120000 });
+  if (page.url().includes('/sys/login')) {
+    if (!username || !password) {
+      throw new Error('login required but --username/--password not provided');
+    }
+    await page.fill('#username', username);
+    await page.fill('#password', password);
+    await Promise.all([
+      page.waitForURL((url) => !url.toString().includes('/sys/login'), { timeout: 120000 }),
+      page.getByRole('button', { name: 'Login' }).click(),
+    ]);
+  }
+  await page.waitForLoadState('networkidle');
+  if (mode === 'ready') {
+    await page.reload({ waitUntil: 'networkidle', timeout: 120000 });
+  }
+  const body = await page.locator('body').innerText();
+  const title = await page.title();
+  if (expectedTitle && title !== expectedTitle) {
+    throw new Error(`unexpected title: ${title}`);
+  }
+  for (const text of requireTexts) {
+    if (!body.includes(text)) {
+      throw new Error(`required text missing: ${text}`);
+    }
+  }
+  for (const text of forbidTexts) {
+    if (body.includes(text)) {
+      throw new Error(`forbidden text found: ${text}`);
+    }
+  }
+  if (screenshot) {
+    fs.mkdirSync(path.dirname(screenshot), { recursive: true });
+    await page.screenshot({ path: screenshot, fullPage: true });
+  }
+  console.log(JSON.stringify({
+    ok: true,
+    mode,
+    url: page.url(),
+    title,
+    body_head: body.slice(0, 400),
+    screenshot,
+  }, null, 2));
+} finally {
+  await browser.close();
+}

package/scripts/smoke/template-project.mjs

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+import { mkdtempSync, rmSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+
+const cliRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', '..');
+const cliEntrypoint = path.join(cliRoot, 'scripts', 'cli.js');
+const frontendSmokeEntrypoint = path.join(cliRoot, 'scripts', 'smoke', 'frontend-dev-entry.mjs');
+
+function getArg(name, fallback = '') {
+	const prefix = `--${name}=`;
+	const hit = process.argv.find((arg) => arg.startsWith(prefix));
+	return hit ? hit.slice(prefix.length) : fallback;
+}
+
+function hasFlag(name) {
+	return process.argv.includes(`--${name}`);
+}
+
+function normalizeBoxName(input) {
+	return String(input || '').trim().replace(/\.heiyu\.space$/i, '');
+}
+
+async function capture(command, args, options = {}) {
+	return await new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd: options.cwd || process.cwd(),
+			env: { ...process.env, ...(options.env || {}) },
+			stdio: ['pipe', 'pipe', 'pipe'],
+			shell: false,
+		});
+		let stdout = '';
+		let stderr = '';
+		child.stdout.on('data', (chunk) => {
+			stdout += chunk.toString();
+		});
+		child.stderr.on('data', (chunk) => {
+			stderr += chunk.toString();
+		});
+		child.on('error', reject);
+		child.on('close', (code) => {
+			if (code === 0) {
+				resolve({ stdout, stderr });
+				return;
+			}
+			reject(new Error(`${command} ${args.join(' ')} failed with code ${code}\n${stdout}\n${stderr}`));
+		});
+		child.stdin.end(options.stdinText || '');
+	});
+}
+
+function spawnStreaming(command, args, options = {}) {
+	const child = spawn(command, args, {
+		cwd: options.cwd || process.cwd(),
+		env: { ...process.env, ...(options.env || {}) },
+		stdio: ['pipe', 'pipe', 'pipe'],
+		shell: false,
+	});
+	let stdout = '';
+	let stderr = '';
+	child.stdout.on('data', (chunk) => {
+		const text = chunk.toString();
+		stdout += text;
+		process.stdout.write(text);
+	});
+	child.stderr.on('data', (chunk) => {
+		const text = chunk.toString();
+		stderr += text;
+		process.stderr.write(text);
+	});
+	if (options.stdinText) {
+		child.stdin.write(options.stdinText);
+	}
+	child.stdin.end();
+	return { child, getStdout: () => stdout, getStderr: () => stderr };
+}
+
+async function runCli(projectDir, argv, options = {}) {
+	const { stdout, stderr } = await capture(process.execPath, [cliEntrypoint, ...argv], {
+		cwd: projectDir,
+		stdinText: options.stdinText || '',
+	});
+	if (stdout.trim()) {
+		process.stdout.write(stdout);
+	}
+	if (stderr.trim()) {
+		process.stderr.write(stderr);
+	}
+	return { stdout, stderr };
+}
+
+async function runSmoke(argv, options = {}) {
+	const { stdout, stderr } = await capture(process.execPath, [frontendSmokeEntrypoint, ...argv], options);
+	if (stdout.trim()) {
+		process.stdout.write(stdout);
+	}
+	if (stderr.trim()) {
+		process.stderr.write(stderr);
+	}
+	return JSON.parse(stdout);
+}
+
+async function readDefaultBoxName() {
+	const { stdout } = await capture(process.execPath, [cliEntrypoint, 'box', 'default']);
+	const box = normalizeBoxName(stdout.trim());
+	if (!box) {
+		throw new Error('default box is empty');
+	}
+	return box;
+}
+
+function extractTarEntry(lpkPath, entryName) {
+	const result = spawnSync('tar', ['-xOf', lpkPath, entryName], { encoding: 'utf8' });
+	if (result.status !== 0) {
+		throw new Error(`extract ${entryName} failed\n${result.stdout}\n${result.stderr}`);
+	}
+	return result.stdout;
+}
+
+function assert(condition, message) {
+	if (!condition) {
+		throw new Error(message);
+	}
+}
+
+async function waitForOutput(getText, pattern, timeoutMs = 30000) {
+	const startedAt = Date.now();
+	while (Date.now() - startedAt <= timeoutMs) {
+		if (pattern.test(getText())) {
+			return;
+		}
+		await new Promise((resolve) => setTimeout(resolve, 200));
+	}
+	throw new Error(`timeout waiting for output: ${String(pattern)}`);
+}
+
+async function retry(action, timeoutMs = 30000, intervalMs = 1000) {
+	const startedAt = Date.now();
+	let lastError = null;
+	while (Date.now() - startedAt <= timeoutMs) {
+		try {
+			return await action();
+		} catch (error) {
+			lastError = error;
+			await new Promise((resolve) => setTimeout(resolve, intervalMs));
+		}
+	}
+	throw lastError || new Error('retry timeout');
+}
+
+async function verifyReleaseLayout(projectDir, expectedPackage, expectedSubdomain) {
+	const lpkPath = path.join(projectDir, 'release.lpk');
+	await runCli(projectDir, ['project', 'release', '-o', lpkPath]);
+	const manifestText = extractTarEntry(lpkPath, 'manifest.yml');
+	const packageText = extractTarEntry(lpkPath, 'package.yml');
+	assert(!manifestText.includes('injects:'), 'release manifest must not contain injects');
+	assert(!manifestText.includes('name:'), 'release manifest must not contain static name');
+	assert(!manifestText.includes('description:'), 'release manifest must not contain static description');
+	assert(packageText.includes(`package: ${expectedPackage}`), 'package.yml missing package id');
+	assert(manifestText.includes(`subdomain: ${expectedSubdomain}`), 'release manifest missing subdomain');
+}
+
+async function smokeNotReadyPage({ url, title, requireText = [], username, password, screenshot }) {
+	await runSmoke([
+		'--mode=not-ready',
+		`--url=${url}`,
+		`--username=${username}`,
+		`--password=${password}`,
+		`--title=${title}`,
+		`--require-text=${requireText.join('||')}`,
+		`--screenshot=${screenshot}`,
+	]);
+}
+
+async function smokeReadyPage({ url, title, requireText, forbidText, username, password, screenshot }) {
+	await runSmoke([
+		'--mode=ready',
+		`--url=${url}`,
+		`--username=${username}`,
+		`--password=${password}`,
+		`--title=${title}`,
+		`--require-text=${requireText.join('||')}`,
+		`--forbid-text=${forbidText.join('||')}`,
+		`--screenshot=${screenshot}`,
+	]);
+}
+
+async function uninstallPackage(pkgId) {
+	await capture(process.execPath, [cliEntrypoint, 'lpk', 'uninstall', pkgId]);
+}
+
+async function runHelloVue(projectDir, appName, boxName, username, password) {
+	const pkgId = `cloud.lazycat.app.${appName}.dev`;
+	const url = `https://${appName}.${boxName}.heiyu.space`;
+	try {
+		await verifyReleaseLayout(projectDir, `cloud.lazycat.app.${appName}`, appName);
+		await runCli(projectDir, ['project', 'deploy']);
+		await runCli(projectDir, ['project', 'start', '--restart']);
+		await runCli(projectDir, ['project', 'exec', '--tty=false', 'pwd']);
+		await smokeNotReadyPage({
+			url,
+			title: 'Frontend Dev',
+			username,
+			password,
+			screenshot: path.join(projectDir, 'hello-vue-not-ready.png'),
+		});
+		const vite = spawnStreaming('npm', ['run', 'dev'], { cwd: projectDir });
+		try {
+			await waitForOutput(vite.getStdout, /ready in|Local:\s+http:\/\/localhost:3000\//, 30000);
+			await retry(async () => {
+				await smokeReadyPage({
+					url,
+					title: 'Vite + Vue + TS',
+					requireText: ['Welcome to Lazycat Microserver', 'Open Developer Docs', 'Fast local iteration'],
+					forbidText: ['Frontend dev server is not ready', 'Dev machine is offline', 'Dev machine is not linked yet'],
+					username,
+					password,
+					screenshot: path.join(projectDir, 'hello-vue-ready.png'),
+				});
+			}, 30000, 1000);
+		} finally {
+			vite.child.kill('SIGINT');
+		}
+	} finally {
+		await uninstallPackage(pkgId).catch(() => {});
+	}
+}
+
+async function runTodolistGolang(projectDir, appName, boxName, username, password) {
+	const pkgId = `cloud.lazycat.app.${appName}.dev`;
+	const url = `https://${appName}.${boxName}.heiyu.space`;
+	try {
+		await verifyReleaseLayout(projectDir, `cloud.lazycat.app.${appName}`, appName);
+		await runCli(projectDir, ['project', 'deploy']);
+		await runCli(projectDir, ['project', 'start', '--restart']);
+		const execResult = await runCli(projectDir, ['project', 'exec', '--tty=false', 'pwd']);
+		assert(execResult.stdout.includes('/lzcapp/cache/project-mirror'), 'project exec should enter project mirror workdir');
+		await smokeNotReadyPage({
+			url,
+			title: 'Backend Dev',
+			requireText: ['Backend dev service is not ready', 'project sync --watch', 'project exec /bin/sh', 'Expected local port: 3000'],
+			username,
+			password,
+			screenshot: path.join(projectDir, 'todolist-golang-not-ready.png'),
+		});
+	} finally {
+		await uninstallPackage(pkgId).catch(() => {});
+	}
+}
+
+async function runTodolistPython(projectDir, appName, boxName, username, password) {
+	const pkgId = `cloud.lazycat.app.${appName}.dev`;
+	const url = `https://${appName}.${boxName}.heiyu.space`;
+	try {
+		await verifyReleaseLayout(projectDir, `cloud.lazycat.app.${appName}`, appName);
+		await runCli(projectDir, ['project', 'deploy']);
+		await runCli(projectDir, ['project', 'start', '--restart']);
+		const execResult = await runCli(projectDir, ['project', 'exec', '--tty=false', 'pwd']);
+		assert(execResult.stdout.includes('/lzcapp/cache/project-mirror'), 'project exec should enter project mirror workdir');
+		await retry(async () => {
+			await smokeReadyPage({
+				url,
+				title: 'Lazycat Python Todo Template',
+				requireText: ['Todo demo powered by Flask API', 'Open Developer Docs', 'Todo quick demo'],
+				forbidText: ['Python dev service is not ready'],
+				username,
+				password,
+				screenshot: path.join(projectDir, 'todolist-python-ready.png'),
+			});
+		}, 45000, 1000);
+	} finally {
+		await uninstallPackage(pkgId).catch(() => {});
+	}
+}
+
+async function main() {
+	const template = getArg('template', 'hello-vue');
+	const username = getArg('username', 'c');
+	const password = getArg('password', 'ccc123');
+	const keep = hasFlag('keep');
+	const boxName = normalizeBoxName(getArg('box')) || await readDefaultBoxName();
+	const workspace = mkdtempSync(path.join(os.tmpdir(), `lzc-cli-smoke-${template}-`));
+	const appName = `${template}-smoke-${Date.now().toString(36)}`.replace(/[^a-z0-9-]/g, '-');
+	console.log(`workspace=${workspace}`);
+	console.log(`box=${boxName}`);
+	console.log(`app=${appName}`);
+	try {
+		await runCli(workspace, ['project', 'create', appName, '--template', template], { stdinText: '\n' });
+		const projectDir = path.join(workspace, appName);
+		if (template === 'hello-vue') {
+			await runHelloVue(projectDir, appName, boxName, username, password);
+		} else if (template === 'todolist-golang') {
+			await runTodolistGolang(projectDir, appName, boxName, username, password);
+		} else if (template === 'todolist-python') {
+			await runTodolistPython(projectDir, appName, boxName, username, password);
+		} else {
+			throw new Error(`unsupported template: ${template}`);
+		}
+		console.log(JSON.stringify({ ok: true, template, workspace, boxName, appName }, null, 2));
+	} finally {
+		if (!keep) {
+			rmSync(workspace, { recursive: true, force: true });
+		}
+	}
+}
+
+main().catch((error) => {
+	console.error(error?.stack || String(error));
+	process.exit(1);
+});

package/template/_lpk/README.md

@@ -1,13 +1,16 @@
-
 # 懒猫云应用
 
 ## 第一次部署（先看到结果）
-```bash
-npm install
+```
 lzc-cli project deploy
 lzc-cli project info
 ```
 
+默认情况下，project 命令在存在 `lzc-build.dev.yml` 时会优先使用它。
+每个命令都会打印实际使用的 `Build config`。
+如果要操作 `lzc-build.yml`，请显式加上 `--release`。
+如果是前端模板，`project deploy` 会按 `buildscript` 自动安装依赖并完成构建，不需要额外先执行 `npm install`。
+
 ## 构建
 ```
 lzc-cli project build -o you-awesome.lpk

package/template/_lpk/gui-vnc.manifest.yml.in

@@ -1,12 +1,3 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 项目主页或文档地址
-author: # app author
-
 # application 是默认前台容器，对应固定 service 名 app
 application:
   subdomain: ${subdomain} # 默认访问子域名前缀

package/template/_lpk/hello-vue.manifest.yml.in

@@ -0,0 +1,38 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: frontend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const devPort = 3000;
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.dev.id) {
+              ctx.response.send(200, renderDevPage("not_linked", devPort));
+              return;
+            }
+
+            const via = ctx.net.via.client(ctx.dev.id);
+            if (!ctx.dev.online()) {
+              ctx.response.send(200, renderDevPage("offline", devPort));
+              return;
+            }
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", devPort, via)) {
+              ctx.response.send(200, renderDevPage("not_ready", devPort));
+              return;
+            }
+
+            ctx.proxy.to("http://127.0.0.1:" + String(devPort), {
+              via: via,
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    - /=file:///lzcapp/pkg/content/dist
+#@build end

package/template/_lpk/manifest.yml.in

@@ -1,12 +1,3 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 出现bug时候提交反馈的地方
-author: # app author
-
 # application 作为默认前台容器运行，对应固定 service 名 app
 application:
   subdomain: ${subdomain} # 默认访问子域名前缀

package/template/_lpk/package.yml.in

@@ -0,0 +1,7 @@
+package: ${package} # app的唯一标识符
+version: 0.0.1 # app的版本
+name: ${name} # app名称
+description: # app描述
+author: # app author
+license: https://choosealicense.com/licenses/mit/
+homepage: # 出现bug时候提交反馈的地方

package/template/_lpk/todolist-golang.manifest.yml.in

@@ -1,16 +1,30 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 出现bug时候提交反馈的地方
-author: # app author
-
 application:
   subdomain: ${subdomain} # 默认访问子域名前缀
   image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendPort = 3000;
+            const backendURL = "http://127.0.0.1:" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
   routes:
     # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
     # 适合「一个容器同时承载前端+后端」的入门场景
     - /=exec://3000,/app/run.sh
+#@build end

package/template/_lpk/todolist-java.manifest.yml.in

@@ -1,15 +1,29 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 出现bug时候提交反馈的地方
-author: # app author
-
 application:
   subdomain: ${subdomain} # 默认访问子域名前缀
   image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendPort = 8080;
+            const backendURL = "http://127.0.0.1:" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
   routes:
     # exec:// 路由会执行 /app/run.sh，并把请求转发到 8080 端口
     - /=exec://8080,/app/run.sh
+#@build end

package/template/_lpk/todolist-python.manifest.yml.in

@@ -1,15 +1,37 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 出现bug时候提交反馈的地方
-author: # app author
-
 application:
   subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendHost = "backend";
+            const backendPort = 3000;
+            const backendURL = "http://" + backendHost + ":" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", backendHost, backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
   image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
   routes:
     # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
     - /=exec://3000,/app/run.sh
+#@build end
+
+#@build if env.DEV_MODE=1
+services:
+  backend:
+    image: embed:app-runtime
+    command: /app/run.sh
+#@build end

package/template/_lpk/todolist-serverless.manifest.yml.in

@@ -0,0 +1,38 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: frontend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const devPort = 3000;
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.dev.id) {
+              ctx.response.send(200, renderDevPage("not_linked", devPort));
+              return;
+            }
+
+            const via = ctx.net.via.client(ctx.dev.id);
+            if (!ctx.dev.online()) {
+              ctx.response.send(200, renderDevPage("offline", devPort));
+              return;
+            }
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", devPort, via)) {
+              ctx.response.send(200, renderDevPage("not_ready", devPort));
+              return;
+            }
+
+            ctx.proxy.to("http://127.0.0.1:" + String(devPort), {
+              via: via,
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    - /=file:///lzcapp/pkg/content/dist
+#@build end

package/template/blank/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/blank/lzc-build.yml

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