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
This commit is contained in:
@@ -0,0 +1,689 @@
|
||||
<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),如 [{ "a": 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>
|
||||
Reference in New Issue
Block a user