Files
print-tag-system/plugin/preview/App.vue
T
funjia ef41d98838 feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码
把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录,
与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。

- 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令
- 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留)
- 店铺名 / 电话从写死改为可配置,记忆在插件私有存储
- 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/
- 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主
- 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码;
  关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建
- 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用)
- code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR)
- 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本
- verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」,
  而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界)

已发布到插件仓库:funjia.print-tag@1.0.0
2026-10-03 23:48:32 +08:00

690 lines
26 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<template>
<div class="pv">
<!-- ------------------------------------------------------ 顶栏 -->
<header class="pv-top">
<div class="pv-top__line">
<h1 class="pv-top__name">{{ config.name }}</h1>
<code class="pv-top__id">{{ config.id }}</code>
<el-tag size="small" :type="loader.mode === 'source' ? 'success' : 'warning'" effect="dark">
{{ loader.label }}模式
</el-tag>
<el-tag size="small" :type="phaseType">{{ phaseText }}</el-tag>
<span v-if="state.activatedAt" class="pv-top__time">启用时间 {{ state.activatedAt }}</span>
</div>
<div class="pv-top__line pv-top__meta">
<span>v{{ config.version }}</span>
<span>形态 {{ config.kind }}</span>
<span>activation {{ config.activation ?? "未声明" }}</span>
<span v-if="config.globalKey">globalKey {{ config.globalKey }}</span>
<span v-if="config.style">style {{ config.style }}</span>
<span class="pv-top__warn">repository 字段为空(预览等同于「手工填 URL 安装」)</span>
</div>
<div class="pv-top__line pv-top__ops">
<el-button v-if="isIdle" type="primary" size="small" :loading="busy" @click="start">
装载并启用
</el-button>
<template v-else>
<el-button size="small" :loading="busy" @click="stop">停用</el-button>
<el-button size="small" :loading="busy" @click="rerun">重新装载</el-button>
<el-button size="small" type="danger" plain @click="remove">卸载</el-button>
</template>
<!--
登录区。这里显示的是**真实**登录态(令牌来自 `/api/auth/login`,
请求时由请求层自动带上),不再是早前那个「模拟已登录」开关 ——
开关是个谎话:它让插件以为自己拿到了用户,而接口根本没带令牌。
-->
<div class="pv-auth">
<template v-if="state.user">
<el-tag size="small" type="success" effect="plain">
{{ state.user.name }} · {{ state.user.role }}
</el-tag>
<el-button size="small" :loading="state.authBusy" @click="onLogout">退出登录</el-button>
</template>
<template v-else>
<el-tag size="small" type="info" effect="plain">未登录</el-tag>
<el-button size="small" type="primary" plain @click="openLogin">登录</el-button>
</template>
</div>
</div>
</header>
<p class="pv-hint">{{ loader.hint }}</p>
<!-- 令牌失效:任何一次接口调用拿到 401 都会走到这里(宿主里对应「跳登录页」) -->
<el-alert
v-if="state.authNotice && !state.user"
type="warning"
:closable="false"
show-icon
:title="`登录态已失效:${state.authNotice}`"
class="pv-alert"
/>
<el-alert v-if="error" type="error" :closable="false" show-icon :title="error" class="pv-alert" />
<el-alert
v-for="w in warnings"
:key="w"
type="warning"
:closable="false"
show-icon
:title="w"
class="pv-alert"
/>
<!-- -------------------------------------------- 菜单 + 页面 + 命令 -->
<div class="pv-body">
<aside class="pv-side">
<section>
<h3>侧边菜单 <em>{{ state.menus.length }}</em></h3>
<ul class="pv-list">
<li
v-for="m in state.menus"
:key="m.id"
:class="{ 'is-active': isCurrent(m.path) }"
@click="pick(m.path)"
>
<span class="pv-list__title">{{ m.title }}</span>
<code>{{ m.path || "(无路径)" }}</code>
</li>
<li v-if="!state.menus.length" class="pv-list__empty">activate 里没有注册菜单</li>
</ul>
</section>
<section>
<h3>路由 <em>{{ state.routes.length }}</em></h3>
<ul class="pv-list">
<li
v-for="r in state.routes"
:key="r.name"
:class="{ 'is-active': isCurrent(r.path) }"
@click="pick(r.path)"
>
<span class="pv-list__title">{{ r.name }}</span>
<code>{{ r.path }}</code>
</li>
<li v-if="!state.routes.length" class="pv-list__empty">activate 里没有注册路由</li>
</ul>
</section>
</aside>
<main class="pv-main">
<section class="pv-stage">
<div class="pv-bar">
<span class="pv-bar__label">页面区</span>
<code v-if="selectedRoute">{{ selectedRoute.path }}</code>
<span v-else class="pv-muted">(未选中路由)</span>
</div>
<div class="pv-stage__body">
<component v-if="selectedRoute" :is="selectedRoute.component" />
<div v-else class="pv-empty">
<p>没有可渲染的页面。</p>
<p>
插件用 <code>ctx.addRoute({ path, component })</code> 注册页面,注册完这里就会显示。
</p>
</div>
</div>
</section>
<section class="pv-stage pv-stage--cmd">
<div class="pv-bar">
<span class="pv-bar__label">命令台</span>
<span class="pv-muted">命令是跨插件协作的正规通道 —— 在这里直接调它,看返回值</span>
</div>
<div class="pv-cmd__form">
<el-select
v-model="cmdName"
size="small"
placeholder="选一个命令"
:disabled="!commandNames.length"
style="width: 200px"
>
<el-option v-for="n in commandNames" :key="n" :label="n" :value="n" />
</el-select>
<el-input
v-model="cmdArgs"
size="small"
placeholder='参数(JSON 数组),如 ["世界"]'
style="width: 260px"
/>
<el-button size="small" type="primary" :disabled="!cmdName" @click="runCommand">执行</el-button>
<span v-if="!commandNames.length" class="pv-muted">当前没有注册命令</span>
</div>
<pre v-if="cmdResult" class="pv-cmd__result" :class="{ 'is-error': !cmdResult.ok }">{{
cmdResult.ok ? format(cmdResult.value) : cmdResult.error
}}</pre>
<div v-if="cmdResult" class="pv-cmd__ms">耗时 {{ cmdResult.ms.toFixed(1) }} ms</div>
</section>
</main>
</div>
<!-- --------------------------------------------------- 底部面板 -->
<el-tabs v-model="bottomTab" class="pv-bottom">
<el-tab-pane name="log">
<template #label>日志<em v-if="state.logs.length"> {{ state.logs.length }}</em></template>
<div class="pv-bar">
<span class="pv-muted">logger 与 ui.* 的输出都落在这里(真实宿主里进浏览器控制台)</span>
<el-button size="small" type="text" @click="host.clearLogs()">清空</el-button>
</div>
<div ref="logBox" class="pv-lines">
<div v-for="l in state.logs" :key="l.seq" class="pv-line" :class="'is-' + l.level">
<span class="pv-line__time">{{ l.time }}</span>
<span class="pv-line__tag">{{ l.level }}</span>
<span class="pv-line__text">{{ l.text }}</span>
</div>
<div v-if="!state.logs.length" class="pv-line__empty">(暂无输出 —— 点上面的「装载并启用」)</div>
</div>
</el-tab-pane>
<el-tab-pane name="event">
<template #label>事件<em v-if="state.events.length"> {{ state.events.length }}</em></template>
<div class="pv-cmd__form">
<el-select
v-model="evChannel"
size="small"
placeholder="选一个通道"
:disabled="!channelOptions.length"
style="width: 230px"
>
<el-option v-for="c in channelOptions" :key="c.value" :label="c.label" :value="c.value" />
</el-select>
<el-input v-model="evArgs" size="small" placeholder="参数(JSON),如 [{ &quot;a&quot;: 1 }]" style="width: 230px" />
<el-button size="small" :disabled="!evChannel" @click="fireEvent">手动触发</el-button>
<span class="pv-muted">局部通道的事件名在宿主里会自动加插件前缀,所以不必担心重名</span>
</div>
<div class="pv-lines">
<div v-for="e in state.events" :key="e.seq" class="pv-line is-event">
<span class="pv-line__time">{{ e.time }}</span>
<span class="pv-line__tag">{{ e.scope === "global" ? "全局" : "局部" }}</span>
<span class="pv-line__text"><code>{{ e.name }}</code><template v-if="e.payload"> {{ e.payload }}</template></span>
</div>
<div v-if="!state.events.length" class="pv-line__empty">(暂无事件流水)</div>
</div>
</el-tab-pane>
<el-tab-pane name="ext">
<template #label>扩展点</template>
<div class="pv-ext">
<div class="pv-ext__col">
<h4>仪表盘卡片 <em>{{ state.widgets.length }}</em></h4>
<ul>
<li v-for="w in state.widgets" :key="w.id">{{ w.id }} · span={{ w.span ?? "默认" }}</li>
<li v-if="!state.widgets.length" class="pv-list__empty">无</li>
</ul>
<h4>顶栏动作 <em>{{ state.toolbarActions.length }}</em></h4>
<ul>
<li v-for="a in state.toolbarActions" :key="a.id">{{ a.title }}({{ a.id }})</li>
<li v-if="!state.toolbarActions.length" class="pv-list__empty">无</li>
</ul>
<h4>设置区块 <em>{{ state.settingsSections.length }}</em></h4>
<ul>
<li v-for="s in state.settingsSections" :key="s.id">{{ s.title }}</li>
<li v-if="!state.settingsSections.length" class="pv-list__empty">无</li>
</ul>
</div>
<div class="pv-ext__col">
<h4>视图模型 / 配置类 <em>{{ Object.keys(state.viewModels).length }}</em></h4>
<ul>
<li v-for="(_, name) in state.viewModels" :key="name">{{ name }}</li>
<li v-if="!Object.keys(state.viewModels).length" class="pv-list__empty">无</li>
</ul>
<h4>命令 <em>{{ commandNames.length }}</em></h4>
<ul>
<li v-for="n in commandNames" :key="n">{{ n }} · {{ state.commands[n].description || "无说明" }}</li>
<li v-if="!commandNames.length" class="pv-list__empty">无</li>
</ul>
<h4>待回收项 <em>{{ state.disposerCount }}</em></h4>
<p class="pv-note">
停用时宿主会一次性回收这些注册(连同 <code>ctx.onDispose()</code> 登记的自清理函数)。
停用后回到本页看,菜单和路由应当<strong>全部消失</strong>。
</p>
</div>
</div>
</el-tab-pane>
<el-tab-pane name="storage">
<template #label>私有存储<em v-if="Object.keys(state.storage).length"> {{ Object.keys(state.storage).length }}</em></template>
<div class="pv-bar">
<span class="pv-muted">
<code>ctx.storage</code> 的实时内容(真实宿主落在浏览器存储里,按插件 id 隔离,卸载时清空)
</span>
<span>
<el-button size="small" type="text" @click="host.syncStorageMirror()">刷新</el-button>
<el-button size="small" type="text" @click="host.clearStorage()">清空</el-button>
</span>
</div>
<div class="pv-kv">
<div v-for="(v, k) in state.storage" :key="k" class="pv-kv__row">
<code>{{ k }}</code><span>{{ v }}</span>
</div>
<div v-if="!Object.keys(state.storage).length" class="pv-line__empty">
(空 —— 插件还没往 storage 里写过东西)
</div>
</div>
</el-tab-pane>
</el-tabs>
<!--
登录框。对应宿主里的登录页(`src/views/LoginView.vue`)——
预览没有路由与守卫,所以「未登录」的表现就是一个可以随时关掉的弹窗,
而不是「整站被拦到登录页」。接口该回 401 的照样回 401。
-->
<el-dialog v-model="loginVisible" title="登录预览后端" width="380px" append-to-body>
<p class="pv-login__tip">
预览的 <code>/api</code> 来自内置的最小后端 <code>preview/mock-api.ts</code>
(响应契约与宿主一致)。登录后,插件里每一次
<code>ctx.http</code> 请求都会自动带上 <code>Authorization</code> 头。
</p>
<el-form label-width="52px" @submit.prevent>
<el-form-item label="账号">
<el-input v-model="loginForm.account" placeholder="funjia" @keyup.enter="submitLogin" />
</el-form-item>
<el-form-item label="密码">
<el-input
v-model="loginForm.password"
type="password"
show-password
placeholder="funjia123"
@keyup.enter="submitLogin"
/>
</el-form-item>
</el-form>
<el-alert v-if="dialogMessage" type="error" :closable="false" show-icon :title="dialogMessage" />
<div v-if="demos.length" class="pv-login__demos">
<span class="pv-muted">演示账号(点一下填入):</span>
<el-tag
v-for="d in demos"
:key="d.account"
size="small"
class="pv-login__demo"
@click="fillDemo(d)"
>
{{ d.account }} / {{ d.password }}({{ d.role }})
</el-tag>
</div>
<p v-else class="pv-login__tip pv-muted">
当前后端没有提供演示账号接口(真后端不会有)——手工填账号密码即可。
</p>
<template #footer>
<el-button size="small" @click="loginVisible = false">取消</el-button>
<el-button size="small" type="primary" :loading="state.authBusy" @click="submitLogin">
登录
</el-button>
</template>
</el-dialog>
</div>
</template>
<script setup lang="ts">
/**
* 预览界面。
*
* 定位是**开发时的镜子**:把插件注册出来的东西全部摊开 —— 菜单、页面、
* 命令、事件、扩展点、私有存储 —— 好回答「我实现的东西长什么样」。
*
* 生命周期按钮刻意与宿主同语义:
*
* | 按钮 | 发生什么 |
* | ---- | -------- |
* | 装载并启用 | `install`(仅首次)→ `activate`;注册项进注册表 |
* | 停用 | `deactivate` → **统一回收**全部注册项 |
* | 卸载 | 停用 + `uninstall` + 清空私有存储与 install 标记 |
* | 重新装载 | 源码模式刷新页面;产物模式重新拉一次产物 |
*
* 尤其是「停用」:点完回来看一眼,菜单和路由应该全没了。这条最容易验证
* 「插件有没有偷偷留下幽灵菜单」,而在宿主里要装两遍才看得出来。
*/
import { computed, nextTick, onMounted, reactive, ref, watch } from "vue";
import type { PreviewHost, CommandResult } from "./host";
import type { PluginConfig, PreviewLoader } from "./loaders";
import type { DemoAccount } from "./api-contract";
const props = defineProps<{
host: PreviewHost;
loader: PreviewLoader;
config: PluginConfig;
}>();
const state = props.host.state;
const busy = ref(false);
const error = ref("");
/** 当前装载到的插件模块(用来驱动停用/卸载)。名字避开 `module` —— 它在别处是个敏感词 */
const pluginModule = ref<any>(null);
const selectedRoute = ref<any>(null);
const bottomTab = ref("log");
const logBox = ref<HTMLElement | null>(null);
/* ------------------------------------------------------------ 生命周期 */
const isIdle = computed(() => state.phase !== "active");
const phaseText = computed(() =>
state.phase === "active" ? "已启用" : state.phase === "error" ? "出错" : "未启用"
);
const phaseType = computed(() =>
state.phase === "active" ? "success" : state.phase === "error" ? "danger" : "info"
);
async function start() {
if (busy.value) return;
busy.value = true;
error.value = "";
try {
const loaded = await props.loader.getModule();
pluginModule.value = loaded.module;
for (const note of loaded.notes) props.host.pushLog("info", note);
await props.host.activate(loaded.module);
// 装载完自动选中第一个路由,省一次点击
selectedRoute.value = state.routes[0] ?? null;
} catch (e) {
error.value = String((e as Error)?.message ?? e);
props.host.pushLog("error", error.value);
} finally {
busy.value = false;
}
}
async function stop() {
busy.value = true;
try {
await props.host.deactivate(pluginModule.value);
} finally {
busy.value = false;
}
}
async function rerun() {
// 源码模式下模块已经求值过(自注册被消费、模块内状态也变了),
// 重新装载最可靠的方式是刷新页面 —— 预览启动很快,刷新几乎无感
if (props.loader.reloadPageOnRerun) {
location.reload();
return;
}
busy.value = true;
try {
await props.host.deactivate(pluginModule.value);
await start();
} finally {
busy.value = false;
}
}
async function remove() {
busy.value = true;
try {
await props.host.uninstall(pluginModule.value);
pluginModule.value = null;
selectedRoute.value = null;
} finally {
busy.value = false;
}
}
/* -------------------------------------------------------- 菜单与页面 */
function pick(path?: string) {
if (!path) return;
const hit = state.routes.find((r) => r.path === path);
if (hit) selectedRoute.value = hit;
}
const isCurrent = (path?: string) => !!path && selectedRoute.value?.path === path;
// 重新装载后旧的 route 对象已经失效,指向它会让页面区渲染不出东西
watch(
() => state.routes.map((r) => r.path).join("|"),
() => {
if (!state.routes.includes(selectedRoute.value)) {
selectedRoute.value = state.routes[0] ?? null;
}
}
);
/* ------------------------------------------------------------ 命令台 */
const commandNames = computed(() => Object.keys(state.commands));
const cmdName = ref("");
const cmdArgs = ref("[]");
const cmdResult = ref<CommandResult | null>(null);
watch(
commandNames,
(names) => {
if (!names.includes(cmdName.value)) cmdName.value = names[0] ?? "";
},
{ immediate: true }
);
function parseArgs(text: string): { args: any[]; error?: string } {
const trimmed = text.trim();
if (!trimmed) return { args: [] };
try {
const parsed = JSON.parse(trimmed);
return { args: Array.isArray(parsed) ? parsed : [parsed] };
} catch (e) {
return { args: [], error: (e as Error).message };
}
}
async function runCommand() {
const { args, error: bad } = parseArgs(cmdArgs.value);
if (bad) {
cmdResult.value = { ok: false, error: `参数不是合法 JSON:${bad}`, ms: 0 };
return;
}
cmdResult.value = await props.host.callCommand(cmdName.value, args);
}
/* ------------------------------------------------------------ 事件 */
const channelOptions = computed(() =>
state.channels.map((c) => ({
value: `${c.scope}:${c.name}`,
label: `${c.scope === "global" ? "全局" : "局部"} · ${c.name}`,
}))
);
const evChannel = ref("");
const evArgs = ref("[]");
watch(
() => channelOptions.value.map((c) => c.value).join("|"),
() => {
if (!channelOptions.value.some((c) => c.value === evChannel.value)) {
evChannel.value = channelOptions.value[0]?.value ?? "";
}
},
{ immediate: true }
);
function fireEvent() {
const idx = evChannel.value.indexOf(":");
const scope = evChannel.value.slice(0, idx);
const name = evChannel.value.slice(idx + 1);
const { args, error: bad } = parseArgs(evArgs.value);
if (bad) props.host.pushLog("warn", `事件参数不是合法 JSON(${bad}),已按空参数触发`);
if (scope === "global") props.host.invokeGlobal(name, args);
else props.host.invokeLocal(name, args);
}
/* ------------------------------------------------------------ 登录态 */
/**
* 登录框的状态。
*
* `demos` 是从 `/api/auth/demo-accounts` 取回来的 —— **不是写死在界面里**。
* 真后端没有这个接口时它为空数组,整块演示账号区域自动消失,
* 界面因此不需要知道「当前连的是 mock 还是真后端」。
*/
const loginVisible = ref(false);
const loginError = ref("");
const loginForm = reactive({ account: "", password: "" });
const demos = ref<DemoAccount[]>([]);
function fillDemo(d: DemoAccount) {
loginForm.account = d.account;
loginForm.password = d.password;
// 清掉「上一次登录失败」的提示:用户换了账号,旧错误已经没意义了。
// ⚠️ 这里只清 `loginError`(本次表单的错误),**不能碰 `state.authNotice`** ——
// 上面那句「凭什么是它弹出的框」归 state 管,见 `dialogMessage`。
loginError.value = "";
}
function openLogin() {
// 手动打开时把上一次的失效提示清掉,否则会带着一句不相干的旧原因弹出来
state.authNotice = "";
loginError.value = "";
loginVisible.value = true;
}
async function submitLogin() {
loginError.value = "";
const account = loginForm.account.trim();
if (!account || !loginForm.password) {
loginError.value = "请输入账号与密码";
return;
}
const result = await props.host.login(account, loginForm.password);
if (!result.ok) {
loginError.value = result.message || "登录失败";
return;
}
loginVisible.value = false;
// 密码不留在内存里:预览页面对的是开发者的真机,没必要留一份
loginForm.password = "";
}
async function onLogout() {
await props.host.logout();
loginVisible.value = false;
}
/**
* 对话框里那条提示。
*
* ## 为什么不是直接用一个 `loginError`
*
* 这里有两个**来源不同**的原因,早前把它们塞进同一个 `ref` 时踩过一个很隐蔽的坑:
*
* 1. **本次登录失败**(密码错)→ 表单自己的状态,换账号就该清掉;
* 2. **凭什么是它弹出的框**(令牌失效 / 接口需要登录)→ 属于会话层的事实,
* 存在 `state.authNotice` 里。
*
* 合成一个 ref 之后,「切换演示账号」那次 `loginError = ""` 会把第 2 类原因
* 一起抹掉。而这个抹除只在**请求先后的竞态**下发生(启动恢复的 401 早于
* 演示账号请求),所以表现是「有时弹出来的框没有提示、有时又有」。
*
* 现在:表单原因覆盖会话原因,会话原因**只读不改**,谁也抹不掉谁。
*/
const dialogMessage = computed(() => loginError.value || state.authNotice);
/** 取演示账号。真后端没有这个接口 → 空数组 → 界面自动收起那一块 */
async function loadDemos() {
demos.value = await props.host.demoAccounts();
}
/**
* 令牌失效 / 需要登录时自动把登录框弹出来。
*
* 监听的是**计数器**而不是提示文本:watch 只在值变化时触发,
* 而未登录时连点两次「拉设备列表」会给出两条一模一样的 401 ——
* 只看文本的话第二次就不会弹框了。
*
* 宿主里这一步是「清会话 + 跳登录页」,预览没有路由,对应物就是这个弹窗。
*/
watch(
() => state.authNoticeSeq,
() => {
if (!state.authNotice || state.user) return;
// 弹框的原因是「会话失效 / 接口需要登录」,不是上一次的密码错误 —— 清掉表单那份,
// 让提示完整地由 state.authNotice 提供(见 dialogMessage 的说明)
loginError.value = "";
loginVisible.value = true;
}
);
/* ------------------------------------------------------------ 杂项 */
/** 日志跟着长 —— 不自动滚到底的话,最新那条永远要手动拉 */
watch(
() => state.logs.length,
async () => {
await nextTick();
if (logBox.value) logBox.value.scrollTop = logBox.value.scrollHeight;
}
);
/**
* 静态可查的配置问题。
*
* 这里只挑「预览里就能判定」的几条;真正的体检(产物、checksum、索引一致性)
* 在 `npm run verify` 与仓库的 `repo-doctor` 里,不在这里重复做。
*/
const warnings = computed(() => {
const out: string[] = [];
const contributes = props.config.contributes ?? {};
const hasEntry = (contributes.menus?.length ?? 0) > 0 || (contributes.routes?.length ?? 0) > 0;
if (props.config.activation === "lazy" && !hasEntry) {
out.push(
"activation 是 lazy,但 contributes 里既没有 menus 也没有 routes —— 宿主找不到入口," +
"延迟装载的插件会被退回 eager(代价是启动变慢)"
);
}
if (state.phase === "active" && !state.routes.length) {
out.push("activate 跑完了,但没有注册任何路由 —— 页面区会是空的,用户也找不到这个插件");
}
if (props.config.style && props.loader.mode === "source") {
out.push(
`plugin.config.json 声明了 style=${props.config.style},但源码模式不产出 CSS 文件 —— ` +
"想验证样式真的被抽出来,切到产物模式(npm run preview)"
);
}
return out;
});
const format = (value: any) => {
try {
return JSON.stringify(value, null, 2);
} catch {
return String(value);
}
};
onMounted(async () => {
props.host.syncStorageMirror();
if (props.loader.mode === "artifact") {
props.host.pushLog("info", "产物模式:正在从 /artifact/ 加载 dist/ 里的产物…");
}
/**
* ⚠️ 会话恢复必须**早于**插件装载。
*
* 插件的 `activate` 里会调 `ctx.getUser()` 决定「要不要渲染管理入口」。
* 如果那时会话还没接回来,它会认为没人登录 —— 页面看着正常、功能却是降级过的,
* 而且没有任何报错。宿主里是同一条约束(还要更严:早于路由守卫),
* 见宿主 `src/main.ts` 的启动步骤。
*
* 顺带取一次演示账号;取不到(真后端)不影响装载。
*/
await Promise.all([props.host.restoreSession(), loadDemos()]);
// 首次打开就预填一个演示账号,省掉手打密码;只在表单为空时填,不覆盖用户输入
if (!loginForm.account && !loginForm.password && demos.value.length) fillDemo(demos.value[0]);
start();
});
</script>