外观
SPA 应用
每个业务子项目必须提供 release.config.json 声明 Web、Android、Chrome、Electron、VSIX 发布目标;共享基座除外。配置仅控制打包与发布资格,不改变前端开发发现和 lint 范围。字段与校验要求参见应用发布目标。
技术栈
Vite + Vue 3 + Vue Router + Pinia + Element Plus
目录结构
text
apps/{应用名}/
├── index.html # 入口html
├── tsconfig.json # TypeScript 配置文件
├── vite.config.mts # Vite 配置文件
├── release.config.json # 必填的多端发布目标声明
├── src/
│ ├── App.vue # 根组件
│ ├── main.ts # 入口
│ ├── router/ # 路由定义
│ ├── api/ # API 请求
│ ├── components/ # 组件
│ ├── views/ # 页面
│ ├── stores/ # 状态管理
│ ├── styles/ # 样式
│ └── assets/ # 资源1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
_base 基座
apps/_base/ 是一个特别的 SPA 应用,该应用不承载实际业务,是作为基座而存在的,用于提供跨多个 SPA 应用共享的基础代码。
基座将通用 UI 放在 apps/_base/src/components/,将认证、支付、文件、AI 等领域能力放在 apps/_base/src/features/。认证表单位于 apps/_base/src/features/auth/components/AuthForms/,并通过 apps/_base/src/apis/auth.ts 复用认证接口;登录成功后的 token 保存、用户状态写入与 ?f= 回跳统一由 apps/_base/src/features/auth/scripts/useAuthSuccess.ts 处理,各业务 SPA 仅声明默认落地路径与差异化的提示、跳转实现。表单组件负责字段校验、验证码刷新、验证码倒计时和接口错误提示。
共享类型
apps/_base/src/types/ 按组件与能力领域存放公开类型契约,供基座内部及各业务应用复用。类型通过 import type 直接从定义文件导入,例如图标名使用 @base/types/icon、表单契约使用 @base/types/form、客户端契约使用 @base/types/client。不通过组件或工具模块转发类型,也不新增汇总导出层。
组件、函数、运行时枚举与注入键实例仍位于原模块;仅供单文件实现使用的私有类型保留在实现中。混合使用组件和类型时分别导入,避免类型消费者依赖组件实现文件。
typescript
import type { IconName } from "@base/types/icon";
import type { FormInstance, FormRules } from "@base/types/form";
import CustomForm from "@base/components/CustomForm/CustomForm.vue";1
2
3
2
3
rem 布局
需要移动端等比布局的 SPA(如 hear、account)在 main.ts 中调用基座 apps/_base/src/scripts/RemUtils.ts 的 enableRemLayout() 启用 rem 布局,页面尺寸、字号、间距一律使用 rem 表达:
- 视口 ≤ 750px(手机/平板):根字号按设计稿等比换算
root = clamp(viewportWidth, 320, 750) / 750 * 100px,即 750 设计稿基准、1rem = 100px; - 视口 > 750px(桌面端):根字号固定 50px(等效 375px 视口,0.32rem ≈ 16px),使 rem 字号接近常规桌面网页体感,可传
desktopRootFontSize自定义; - 根字号同步写入
--root-font-sizeCSS 变量,并监听 resize 持续更新。
主题变量与深色模式
SPA 的配色以 CSS 变量为单一事实来源,从而支持「跟随系统」深色模式(当前参考实现:apps/hear)。
- 令牌定义:颜色令牌集中在
apps/{应用}/src/styles/variables.scss,经vite.config.mts的scss.additionalData注入所有组件样式;令牌值本身指向 CSS 变量(如$paper: var(--paper)),组件内引用$*即编译为var(--*),无需逐文件改写。 - 明暗真值:浅色真值定义在
apps/{应用}/src/styles/main.scss的:root,深色在@media (prefers-color-scheme: dark)中覆盖同名变量,即可整体切换,不提供应用内开关。 - 派生约束:令牌已是
var(),禁止再对其使用rgba()/darken()/lighten()/mix()等 SCSS 颜色函数;需要派生色时新增独立 CSS 变量(如--shadow-card、--glass、--coral-tint)。 - 元信息:
index.html声明<meta name="color-scheme" content="light dark" />,并按prefers-color-scheme提供深浅两版theme-color。
Android 壳(client/android,flavor=hear)与 H5 协同:
- 主题
AppTheme继承Theme.AppCompat.DayNight.*,values-night/colors.xml覆盖shell_window_background,与 H5 深色cream对齐;todosflavor 无该覆盖,保持浅色不受影响。 WindowInsetsHelper按根容器底色的 sRGB 亮度自动选择状态栏图标深浅;因AndroidManifest.xml的configChanges含uiMode,切换深浅不重建 Activity,需在onConfigurationChanged重调 inset。WebViewSetup将 WebView 背景设为shell_window_background,并关闭 WebView 算法暗化(setAlgorithmicDarkeningAllowed(false),低版本回退FORCE_DARK_OFF),避免与 H5 自适应叠加造成二次反色。
Android 原生视频返回方向
原生播放入口在 UI 线程记录调用页面的实际显示方向与方向策略,快照随播放器 Intent 保留。视频内按宽高择向和手动旋转独立于入口页面。
开启系统自动旋转时,播放器退出先请求入口方向,通过实际显示旋转与配置状态确认恢复,再交回调用页面原有的方向策略。这样平放设备没有新的姿态变化时也有明确的返回方向,之后仍可响应系统自动旋转。恢复等待设置超时兜底,系统忽略方向请求时记录日志并退出,避免阻塞返回。关闭自动旋转时沿用原有退出行为。
该流程覆盖关闭、系统返回与播放失败,不在切后台时触发。方向请求是否生效受 Android 版本、设备及窗口模式影响,需要设备验证;修改此机制须重新构建并安装 APK,H5 更新不会改变原生方向行为。
Android H5 下载进度
全部 flavor 的首次资源准备页与后续更新浮层复用原生下载展示组件,显示已下载量、总大小、已用时间、预计剩余时间及条内百分比,无需业务页面自行实现。
下载计时采用单调时钟,剩余时间根据近期平滑速度估算;样本不足或下载停滞时显示“计算中”,重试重新计时。下载达到 100% 后仍需校验与解压,只有完整资源激活后才能进入新版本。更新此原生界面需要重新构建并安装 APK,仅发布 H5 包不会改变界面。
Android 壳内跨应用登录态共享
各 flavor 是独立 APK(applicationId 不同),Android 应用沙箱按包名隔离,私有 SharedPreferences 互不可见;Web 端各应用同主域共享 localStorage 才天然互通。
- 壳内登录 token 改由系统
AccountManager承载:账号类型固定com.verysites.shell、账号名固定verysites(AuthAccountStore),由VerysitesAuthenticatorService注册 authenticator。各 flavor 必须使用同一签名证书,否则跨应用读写不生效。 NativeBridge只对token键分流到AuthAccountStore(peekAuthToken/setAuthToken),其余键仍走本应用私有 prefs(android-bridge);账号会出现在系统「设置 → 账户」,用户可手动删除(即登出)。- 前端
useUserStore在 Web 的visibilitychange与壳内的window.onShellResume(原生onResume经evaluateJavascript主动通知,因 WebView 内visibilitychange不可靠)时调syncTokenFromStorage()对齐 token;persist.afterHydrate用共享凭据覆盖持久化 token,避免本应用旧值冲掉跨应用登录态。
Todos 编辑器扩展客户端
client/vsix/todos/ 是独立 VS Code 扩展工程,命令“Hi备忘录:打开待办”打开单例标签页;复用 apps/todos/src/main.ts 和全部主要视图,不接入根构建、不替换 Android 桥。
- 构建:依赖统一由仓库根
package.json维护,client/vsix/todos不单独安装依赖,命令运行时由 npm 向上解析根node_modules/.bin;目录内可执行npm run check、npm test、npm run build、npm run lint。仓库根npm run vsix:build遍历client/vsix/下含package.json的子项目,依次委托其自身的 build 流水线(原始构建、构建校验、lint、单元测试、vsce 打包与产物校验),默认TASKS=vsix:*全量构建,可用TASKS=vsix:todos只构建指定子项目。产物为verysites-todos-0.1.0.vsix;不承诺脱离仓库构建。 - 检查:仓库根
npm run lint会遍历client/vsix/下各扩展子项目,分别委托其自身的 lint 流水线(宿主与 Webview 类型检查、桥接与面板单元测试),可用TASKS=vsix:*过滤,或用TASKS=vsix:todos只跑指定子项目;也可在子项目目录内执行npm run lint。 - 启动:Webview 消息监听 → 初始化凭据与偏好同步内存镜像 → 动态导入原 Todos 入口。请求与存储在页面、宿主两侧串行确认,登录写入 token 后再请求 API。
- 安全:宿主严格限制 API 方法/路径、JSON 体积、响应大小与超时,不接受页面指定 Authorization、Cookie、Host 或任意服务器;禁止重定向、路径穿越。验证码 SVG 由宿主转成受控图片,CookieJar 与认证请求共用,仅存内存,关闭及退出清理。
- 凭据:token 仅持久化到 SecretStorage,按服务器源的哈希隔离;globalState 只保存白名单偏好与受支持路由。扩展禁用用户 Pinia 持久化和记住密码,不在普通存储保存密码、token、Cookie,不与网站或 Android 共用登录态。
- 服务器:
verysites.todos.server默认为https://www.verysites.com,必须为无路径/凭据的 HTTPS 源;明确配置本机开发时允许 HTTP localhost/127.0.0.1。切换后关闭旧面板,重新打开恢复目标服务器独立凭据。 - 资源与体验:本地 HTML 入口资源转换为
asWebviewUri,动态 chunks 与 CSS 资源使用相对 URI,CSP 不开放远程脚本或任意联网;IDE 主题通知映射颜色令牌,保存受支持路由,账户中心/反馈走系统浏览器(不会自动登录)。 - 环境边界:独立构建不加载根环境文件、后端 ConstantUtils 或网站埋点。当前以 HTTPS JSON 响应为协议;若目标服务器开启私有密钥响应加密,需单独确认安全的宿主解密接入,不能将服务端密钥打入 VSIX。
- 验证边界:mock 自动化可验证消息、会话、凭据、顺序与单例,不等同于真实编辑器安装、人工账号登录和业务 CRUD 验收;VS Code/TraeCode/CodeBuddy 的实际兼容性需分别人工验证。
页面布局组件
页面布局组件位于 apps/_base/src/components/,采用「外壳 + 插槽」的组合方式,页头与内容区不再嵌套:
PageEmptyLayout/PageEmptyLayout.vue:通用页面外壳,提供撑满高度的容器、页头区域(pageTitle与pageDescprops,可用pageHeader插槽覆盖标题区,pageHeaderBottom插槽追加页头底部内容)和default内容插槽。PageListLayout/PageListLayout.vue:列表页面布局,基于PageEmptyLayout实现,通过pageHeaderBottom插槽把筛选卡片并入页头区域底部,通过default插槽传入数据卡片,并对外提供filterForm、filterCardHeaderRight、dataCardNote、dataCardHeaderRight、dataCardTable、dataCardPagination插槽以及search、reset事件。
新增非列表页面时直接使用 PageEmptyLayout;新增列表页面时继续使用 PageListLayout,页面无需关心外层容器与页头。
路径别名
在 SPA 项目里,你可以通过如下 2 个路径别名来方便引用 SPA 项目自身文件和 apps/_base 基座里的文件。
- 基座路径别名:
@base/*=>apps/_base/src/* - 当前应用路径别名:
@/*=>apps/当前应用/src/*
自动发现
SPA 应用采用目录自动发现机制
我们通过检测目录的方式,实现了 SPA 应用的自动发现机制。
文件:src/utils/ConstantUtils.mts
typescript
/**
* 子应用(从 apps/ 目录自动发现)
*/
export const SUB_APPS_NAMES: string[] = [];
if (existsSync(PATH_APPS)) {
const dirs = readdirSync(PATH_APPS).filter((name) => {
const fullPath = joinPath(PATH_APPS, name);
return statSync(fullPath).isDirectory() && !name.startsWith("_") && !name.endsWith("_backup");
});
dirs.sort((a, b) => a.localeCompare(b));
for (const appName of dirs) {
SUB_APPS_NAMES.push(appName);
}
}
export const SUB_APPS: SubApp[] = [];
for (const appName of SUB_APPS_NAMES) {
SUB_APPS.push({
appName: appName,
appPort: APP_START_PORT + SUB_APPS.length,
});
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
本地开发
hear 的独立 H5 下载、预置媒体离线使用与 Web 上传排除约定见 hear 预置资源与离线打包。
假设你创建的 SPA 应用目录为 apps/example,那么执行 npm run dev 后只需要访问 https://localhost:9000/example 就可以访问到你的 SPA 应用了,不需要配端口、也不用担心前端后请求之间的跨域问题。
SPA 应用本地开发脚本(scripts/dev.mts)
typescript
import { logInfo, logWarn, joinPath, isPathExists } from "nsuite";
import { writeSync } from "node:fs";
import { setTimeout as sleep } from "node:timers/promises";
import open from "open";
import {
APP_FRONT_PORT,
HEALTH_CHECK_PATH,
OPEN_PATH_IN_DEV,
PATH_APPS_HOME,
PATH_PUBLIC,
PATH_ROOT,
REDIS_HOST,
REDIS_PORT,
POSTGRES_PORT,
SERVER_HOST,
SERVER_PORT,
SSH_HOST,
SSH_PORT,
SSH_USERNAME,
SSH_PASSWORD,
STANDALONE_APPS_PORT,
STANDALONE_SSG_APPS_NAMES,
STANDALONE_SSR_APPS,
SUB_APPS,
} from "#utils/ConstantUtils";
import { cleanAllBuildFiles } from "#scripts/utils/clean-files";
import { runCommandInChildProcess, killAllChildProcessList } from "#scripts/utils/child-process";
import { buildPublic, checkServerHealth, reloadOnFilesChange } from "#scripts/utils/public-builder";
import { useTask } from "#scripts/utils/use-task";
import { waitForPort } from "#scripts/utils/use-dev";
const allowTasks = process.env.TASKS || "";
const isGitBash = Boolean(process.env.MSYSTEM);
const sshAskpassPath = joinPath(
PATH_ROOT,
`scripts/utils/ssh-askpass.${isGitBash ? "sh" : "cmd"}`,
);
const { killAllChildProcessWhenSuitable, addTask, runTasksSequentially, printTaskStatisticsInfo } =
useTask({ allowTasks });
/**
* 异常时关闭所有子进程
*/
killAllChildProcessWhenSuitable();
/**
* 停机标志:SIGINT/SIGTERM 或异常退出时置位,
* 避免清理阶段杀掉 ssh 被误判为隧道意外断开而触发重连
*/
let isShuttingDown = false;
process.on("SIGINT", () => {
isShuttingDown = true;
});
process.on("SIGTERM", () => {
isShuttingDown = true;
});
/**
* 兜底处理未捕获异常:同步打印错误并清理子进程后退出,
* 避免主进程静默死亡留下孤儿进程(vite、ssh 隧道等)
*/
const writeErrorAndExit = (message: string) => {
isShuttingDown = true;
// 使用 writeSync 同步写入,避免 process.exit 丢失缓冲区中的输出
writeSync(2, `${message}\n`);
void killAllChildProcessList().finally(() => process.exit(1));
};
process.on("uncaughtException", (error) => {
writeErrorAndExit(`[dev] 未捕获异常,进程即将退出: ${error.stack || error.message}`);
});
process.on("unhandledRejection", (reason) => {
const message = reason instanceof Error ? (reason.stack || reason.message) : String(reason);
writeErrorAndExit(`[dev] 未处理的 Promise rejection,进程即将退出: ${message}`);
});
/**
* 编译开始前先清空所有可能遗留的编译产物
*/
addTask("cleanAllBuildFiles", async () => {
await cleanAllBuildFiles();
});
/**
* 重连等待时间(毫秒)
*/
const SSH_RECONNECT_DELAY_MS = 2000;
/**
* 启动 SSH 隧道子进程
*/
const spawnSshTunnel = (): { promise: Promise<number | null> } => {
const { promise } = runCommandInChildProcess({
appName: "sshTunnel",
command: "ssh",
args: [
"-o StrictHostKeyChecking=accept-new",
"-o ExitOnForwardFailure=yes",
// 心跳保活:死连接约 1 分钟内暴露,避免 NAT/网络切换后隧道半开悬挂
"-o ServerAliveInterval=15",
"-o ServerAliveCountMax=4",
// Redis 端口转发
`-L ${REDIS_PORT}:localhost:6379`,
// PostgreSQL 端口转发
`-L ${POSTGRES_PORT}:localhost:5432`,
`-p ${SSH_PORT} ${SSH_USERNAME}@${SSH_HOST} -N`,
].join(" "),
env: {
...process.env,
DISPLAY: "localhost:0",
SSH_ASKPASS: sshAskpassPath,
SSH_ASKPASS_REQUIRE: SSH_PASSWORD ? "force" : "never",
},
});
return { promise };
};
/**
* 等待隧道端口就绪,或 SSH 进程异常退出
*/
const waitSshTunnelReady = async (sshExit: Promise<number | null>): Promise<void> => {
await Promise.race([
sshExit.then((code) => {
if (code) {
throw new Error(`SSH 隧道异常退出: code=${code}`);
}
}),
Promise.all([waitForPort(REDIS_PORT), waitForPort(POSTGRES_PORT)]),
]);
};
/**
* 监督 SSH 隧道:意外断开后延迟自动重连,直到进程停机
*/
const superviseSshTunnel = async (firstExit: Promise<number | null>): Promise<void> => {
let sshExit = firstExit;
while (!isShuttingDown) {
const code = await sshExit;
if (isShuttingDown) {
return;
}
logWarn(
`[sshTunnel] SSH 隧道已断开 (code=${code}),${SSH_RECONNECT_DELAY_MS / 1000} 秒后自动重连`,
);
await sleep(SSH_RECONNECT_DELAY_MS);
if (isShuttingDown) {
return;
}
try {
const spawned = spawnSshTunnel();
await waitSshTunnelReady(spawned.promise);
sshExit = spawned.promise;
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
logWarn(`[sshTunnel] 重连失败: ${message},继续重试`);
await sleep(SSH_RECONNECT_DELAY_MS);
}
}
};
/**
* SSH 端口转发隧道
*/
addTask("sshTunnel", async () => {
const { promise: sshExit } = spawnSshTunnel();
// 启动失败视为致命错误,中断 dev
await waitSshTunnelReady(sshExit);
// 启动成功后监督隧道,意外断开时自动重连,避免 Redis/PostgreSQL 持续连接失败
void superviseSshTunnel(sshExit);
});
/**
* 启动主服务
*/
addTask("server", async (payload) => {
const { progress, taskName } = payload;
const { promise } = runCommandInChildProcess({
appName: `${progress.current}/${progress.total}-${taskName}`,
command: "node",
args: "./scripts/utils/server-watcher.mts",
env: process.env,
onStdout: (data: string, resolve) => {
if (data.includes("Server is running on port")) {
resolve(0);
}
},
});
const exitCode = await promise;
if (exitCode) {
throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
}
});
/**
* 启动消费者服务
*/
addTask("consumer-bugs", async (payload) => {
const { taskName, progress } = payload;
const { promise } = runCommandInChildProcess({
appName: `${progress.current}/${progress.total}-${taskName}`,
command: "node",
args: `--watch --watch-preserve-output ./consumers/bugs.mts`,
env: process.env,
onStdout: (data: string, resolve) => {
if (data.includes("成功启动bugs相关队列消费脚本")) {
resolve(0);
}
},
});
const exitCode = await promise;
if (exitCode) {
throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
}
});
/**
* 顺序启动 SPA apps
*/
for (const app of SUB_APPS) {
const { appName, appPort } = app;
addTask(appName, async (payload) => {
const { progress, taskName } = payload;
const { promise } = runCommandInChildProcess({
appName: `${progress.current}/${progress.total}-SPA-${appName}`,
command: "cross-env",
args: `APP_NAME=${appName} PORT=${appPort} vite serve ./apps/${appName}`,
env: process.env,
onStdout: (data: string, resolve) => {
// vite ready 输出 "ready in xxx";"to show help" 仅在 TTY 终端打印,非交互环境以此兜底
if (data.includes("to show help") || data.includes("ready in")) {
resolve(0);
}
},
});
const exitCode = await promise;
if (exitCode) {
throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
}
});
}
if (allowTasks) {
const allAllowTasks = allowTasks.split(",");
const ssgTask = allAllowTasks.find((taskName) => taskName.startsWith("ssg:"));
if (ssgTask) {
const appName = ssgTask.split(":")[1] || "";
if (STANDALONE_SSG_APPS_NAMES.includes(appName)) {
addTask(ssgTask, async (payload) => {
const { progress, taskName } = payload;
// 区分应用类型:Next.js、Nuxt 4 应用、VitePress 2 应用
const pathApp = joinPath(PATH_APPS_HOME, appName);
const pathNuxtConfig = joinPath(pathApp, "nuxt.config.ts");
const pathNextConfig = joinPath(pathApp, "next.config.ts");
const isNext = await isPathExists(pathNextConfig);
const isNuxt = await isPathExists(pathNuxtConfig);
const args = isNext
? `APP_NAME=${appName} PORT=${STANDALONE_APPS_PORT} SERVER_HOST=${SERVER_HOST} SERVER_PORT=${SERVER_PORT} next dev ./apps-home/${appName}`
: isNuxt
? `APP_NAME=${appName} PORT=${STANDALONE_APPS_PORT} nuxt dev --cwd=./apps-home/${appName}`
: `PORT=${STANDALONE_APPS_PORT} vitepress dev ./apps-home/${appName}/config`;
const { promise } = runCommandInChildProcess({
appName: `${progress.current}/${progress.total}-SSG-${taskName}`,
command: "cross-env",
args,
env: process.env,
});
const exitCode = await promise;
if (exitCode) {
throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
}
});
}
}
}
if (allowTasks) {
const allAllowTasks = allowTasks.split(",");
const ssrTask = allAllowTasks.find((taskName) => taskName.startsWith("ssr:"));
if (ssrTask) {
const appName = ssrTask.split(":")[1] || "";
const app = STANDALONE_SSR_APPS.find((item) => item.appName === appName);
if (app) {
addTask(ssrTask, async (payload) => {
const { progress, taskName } = payload;
const args = `APP_NAME=${appName} PORT=${app.appPort} nuxt dev --host ${SERVER_HOST} --cwd=./apps-home/${appName}`;
const { promise } = runCommandInChildProcess({
appName: `${progress.current}/${progress.total}-SSR-${appName}`,
command: "cross-env",
args,
env: process.env,
});
const exitCode = await promise;
if (exitCode) {
throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
}
});
}
}
}
/**
* 启动 public 目录下 js/*.mts 和 css/*.scss 文件的实时编译
*/
addTask("browerSync", async () => {
await checkServerHealth({
healthCheckUrl: `http://${SERVER_HOST}:${SERVER_PORT}${HEALTH_CHECK_PATH}`,
conditionCallback: (res) => res.data.code === 200,
interval: 1000,
});
const browserSync = reloadOnFilesChange([
joinPath(PATH_PUBLIC, "js/**/*.min.js"),
joinPath(PATH_PUBLIC, "css/**/*.min.css"),
joinPath(PATH_ROOT, "views/**/*.ejs"),
]);
// 监听 browser-sync 错误事件(如端口被占用),
// 避免无监听器的 error 事件以未捕获异常形式导致主进程静默崩溃
let initReject: ((error: Error) => void) | undefined;
browserSync.emitter.on("error", (error: Error) => {
writeSync(2, `[browerSync] browser-sync 运行错误: ${error.stack || error.message}\n`);
initReject?.(error);
});
await new Promise<void>((resolve, reject) => {
initReject = reject;
browserSync.init(
{
port: APP_FRONT_PORT,
// listen 决定端口探测 host:默认 localhost 会在 Node 22 下因
// 多地址连接失败返回 AggregateError,触发 browser-sync 内部
// process.exit(1) 静默终止 dev 主进程,必须显式指定为 IPv4 地址
listen: SERVER_HOST,
online: true,
open: false,
notify: false,
// @ts-ignore
ws: true,
proxy: `${SERVER_HOST}:${SERVER_PORT}`,
},
(error) => {
if (error) {
reject(error);
return;
}
resolve();
},
);
});
await buildPublic({
enableWatch: true,
});
});
await runTasksSequentially();
printTaskStatisticsInfo();
if (OPEN_PATH_IN_DEV) {
const openUrl = `http://${SERVER_HOST}:${APP_FRONT_PORT}${OPEN_PATH_IN_DEV}`;
const localUrl = `http://localhost:${APP_FRONT_PORT}${OPEN_PATH_IN_DEV}`;
await open(openUrl);
logInfo(`\n🚀 启动成功,请访问: ${openUrl} 或 ${localUrl}`);
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
本地开发时服务端会自动对 SPA 应用本地开发服务的端口进行自动代理(src/apps.mts)
typescript
SUB_APPS.forEach(({ appName, appPort }) => {
app.use(`/${appName}`, createProxyHandler(`http://${SERVER_HOST}:${appPort}/${appName}`));
});1
2
3
2
3