zkqh-lagrange-utils 0.0.54 → 0.0.55

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "zkqh-lagrange-utils",
 	"private": false,
-	"version": "0.0.54",
+	"version": "0.0.55",
 	"type": "module",
 	"scripts": {
 		"dev": "vite",

package/src/service/export_plugin/PluginLocalExport.vue

@@ -56,14 +56,28 @@
 				</div>
 			</div>
 		</template>
+
+		<!-- 插件导出：任务名称弹窗（内置） -->
+		<ExportTaskModal
+			v-if="showTaskModal"
+			:kind="kind"
+			:args="args"
+			:dirname="dirname"
+			:get-token="getToken"
+			:get-url="getUrl"
+			:validate-args="validateArgs"
+			@success="onTaskModalSuccess"
+			@close="showTaskModal = false" />
 	</div>
 </template>
 
 <script>
 import { defineComponent, ref, computed, toRefs, onMounted } from "vue"
 import PluginDirSelect from "./internal/plugin-dir-select.vue"
+import ExportTaskModal from "./internal/export-task-modal.vue"
 import { usePluginHealth } from "./hooks/use-plugin-health.js"
 import { isOverSizeLimit, isPreviewOverflowDisk } from "./utils/size.js"
+import { validateTimeRangeArgs } from "./utils/export-task.js"
 /** 组件局部使用 lc iconfont（不依赖宿主全局引入） */
 import "zkqh-lagrange-utils/assets/font/iconfont-lc.css"
 import "./internal/styles/plugin-local-export.less"
@@ -75,11 +89,11 @@ const DEFAULT_PREVIEW = {
 }
 
 /**
- * 本地导出组合区：平台/应用小文件导出 + 插件目录导出 + 50MB 分流
+ * 本地导出组合区：平台/应用小文件导出 + 插件目录导出 + 50MB 分流 + 任务弹窗
  */
 export default defineComponent({
 	name: "PluginLocalExport",
-	components: { PluginDirSelect },
+	components: { PluginDirSelect, ExportTaskModal },
 	props: {
 		/**
 		 * 预览与分流控制
@@ -91,12 +105,32 @@ export default defineComponent({
 		},
 		/** 插件安装包下载地址 */
 		downloadUrl: { type: String, default: "" },
+		/** 导出 kind（插件创建任务用） */
+		kind: { type: String, default: "event" },
+		/** 筛选参数（插件创建任务用） */
+		args: { type: Object, default: () => ({}) },
+		/**
+		 * 获取登录 token；不传则读 localStorage.token
+		 * @type {(() => string) | string}
+		 */
+		getToken: { type: [Function, String], default: null },
+		/**
+		 * 获取平台根 URL；不传则读 window.sys_con.baseURL
+		 * @type {(() => string) | string}
+		 */
+		getUrl: { type: [Function, String], default: null },
+		/**
+		 * 导出前校验 args；不传则校验时间范围
+		 * @type {(args: object) => boolean}
+		 */
+		validateArgs: { type: Function, default: null },
 	},
 	emits: ["success"],
 	setup(props, { emit }) {
-		const { previewInfo, downloadUrl } = toRefs(props)
+		const { previewInfo, downloadUrl, kind, args, getToken, getUrl, validateArgs } = toRefs(props)
 		const dirname = ref("")
 		const diskInfo = ref({ total_size: 0, used_size: 0 })
+		const showTaskModal = ref(false)
 
 		const health = usePluginHealth({
 			downloadUrl: () => downloadUrl.value,
@@ -112,6 +146,8 @@ export default defineComponent({
 			...(previewInfo.value || {}),
 		}))
 
+		const resolveValidate = () => validateArgs.value || validateTimeRangeArgs
+
 		/**
 		 * 是否展示平台/应用导出区（≤50MB）
 		 */
@@ -169,6 +205,9 @@ export default defineComponent({
 
 		/** 平台/应用路径：确认后回调 */
 		const onPlatformExportClick = () => {
+			const exportArgs = { ...(args.value || {}) }
+			if (!resolveValidate()(exportArgs)) return
+
 			window.$dialog?.warning?.({
 				title: "确认导出",
 				content: "确认按当前筛选条件通过平台打包下载？",
@@ -180,14 +219,28 @@ export default defineComponent({
 			})
 		}
 
-		/** 插件路径：校验后回调（含 dirname） */
+		/** 插件路径：打开任务名称弹窗 */
 		const onPluginExportClick = () => {
 			if (pluginExportDisabled.value) return
+			const exportArgs = { ...(args.value || {}) }
+			if (!resolveValidate()(exportArgs)) return
+			showTaskModal.value = true
+		}
+
+		/** 插件任务创建成功 */
+		const onTaskModalSuccess = () => {
+			showTaskModal.value = false
 			emit("success", { mode: "plugin", dirname: dirname.value })
 		}
 
 		return {
 			dirname,
+			kind,
+			args,
+			getToken,
+			getUrl,
+			validateArgs,
+			showTaskModal,
 			pluginReady,
 			usePlatformExport,
 			usePluginExport,
@@ -198,6 +251,7 @@ export default defineComponent({
 			onInstall,
 			onPlatformExportClick,
 			onPluginExportClick,
+			onTaskModalSuccess,
 		}
 	},
 })

package/src/service/export_plugin/hooks/use-plugin-health.js

@@ -22,6 +22,14 @@ function _downloadPlugin(url = "") {
 /**
  * 导出插件 health：单次检测 + 安装后轮询，就绪后自动停止
  * @param {{ interval?: number, downloadUrl?: string | import('vue').Ref<string> | (() => string) }} [options]
+ * @returns {{
+ *   pluginReady: import('vue').Ref<boolean>,
+ *   polling: import('vue').Ref<boolean>,
+ *   checkHealth: () => Promise<boolean>,
+ *   startPoll: () => void,
+ *   stopPoll: () => void,
+ *   triggerInstall: (url?: string) => void,
+ * }}
  */
 export function usePluginHealth(options = {}) {
 	const intervalMs = options.interval ?? PLUGIN_HEALTH_INTERVAL

package/src/service/export_plugin/index.js

@@ -3,13 +3,16 @@
  *
  * 对外：
  * - pluginApi：可独立引用
- * - PluginLocalExport：平台/插件导出区组合组件
+ * - PluginLocalExport：平台/插件导出区组合组件（含任务名称弹窗）
+ * - ExportTaskModal：也可单独使用
+ * - usePluginHealth：插件存活检测 / 安装轮询
  *
  * @example
- * import { pluginApi, PluginLocalExport } from "zkqh-lagrange-utils/export_plugin"
- * import { pluginApi } from "zkqh-lagrange-utils/export_plugin/api"
+ * import { pluginApi, PluginLocalExport, usePluginHealth } from "zkqh-lagrange-utils/export_plugin"
  */
 
 export { pluginApi } from "./api/plugin.js"
 export { default as PluginLocalExport } from "./PluginLocalExport.vue"
+export { default as ExportTaskModal } from "./internal/export-task-modal.vue"
+export { usePluginHealth } from "./hooks/use-plugin-health.js"
 export { default } from "./PluginLocalExport.vue"

package/src/service/export_plugin/internal/export-task-modal.vue

@@ -0,0 +1,149 @@
+<template>
+	<n-modal
+		:show="true"
+		preset="dialog"
+		title="导出任务"
+		positive-text="确认导出"
+		negative-text="取消"
+		:mask-closable="false"
+		:loading="exporting"
+		@update:show="onShowUpdate"
+		@positive-click="onConfirm">
+		<div class="export_plugin_modals_hint lc-fs-s">请填写导出任务名称，任务可在「导出进度」中查看。</div>
+		<n-input
+			v-model:value="taskName"
+			size="small"
+			placeholder="请输入导出任务名称"
+			class="mt-8"
+			@keyup.enter="onConfirm" />
+	</n-modal>
+</template>
+
+<script>
+import { defineComponent, ref } from "vue"
+import { pluginApi } from "../api/plugin.js"
+import {
+	buildTaskName,
+	getDefaultToken,
+	getDefaultUrl,
+	validateTimeRangeArgs,
+} from "../utils/export-task.js"
+import "./styles/export-plugin-modals.less"
+
+/**
+ * 导出任务名称弹窗（创建插件导出作业）
+ */
+export default defineComponent({
+	name: "ExportTaskModal",
+	props: {
+		/** 导出 kind */
+		kind: { type: String, default: "event" },
+		/** 筛选参数 */
+		args: { type: Object, default: () => ({}) },
+		/** 本地导出目录 */
+		dirname: { type: String, default: "" },
+		/**
+		 * 获取登录 token；不传则读 localStorage.token
+		 * @type {(() => string) | string}
+		 */
+		getToken: { type: [Function, String], default: null },
+		/**
+		 * 获取平台根 URL；不传则读 window.sys_con.baseURL
+		 * @type {(() => string) | string}
+		 */
+		getUrl: { type: [Function, String], default: null },
+		/**
+		 * 导出前校验 args；不传则校验时间范围
+		 * @type {(args: object) => boolean}
+		 */
+		validateArgs: { type: Function, default: null },
+	},
+	emits: ["close", "success"],
+	setup(props, { emit }) {
+		const taskName = ref(buildTaskName())
+		const exporting = ref(false)
+
+		const resolveToken = () => {
+			if (props.getToken == null) return getDefaultToken()
+			return typeof props.getToken === "function" ? props.getToken() : String(props.getToken || "")
+		}
+
+		const resolveUrl = () => {
+			if (props.getUrl == null) return getDefaultUrl()
+			return typeof props.getUrl === "function" ? props.getUrl() : String(props.getUrl || "")
+		}
+
+		const close = () => {
+			emit("close")
+		}
+
+		const onShowUpdate = (v) => {
+			if (!v) close()
+		}
+
+		/**
+		 * 创建导出任务
+		 * @param {string} name 任务名称
+		 * @returns {Promise<boolean>}
+		 */
+		const createExport = async (name) => {
+			const exportArgs = { ...(props.args || {}) }
+			const validate = props.validateArgs || validateTimeRangeArgs
+			if (!validate(exportArgs)) return false
+
+			const token = resolveToken()
+			const url = resolveUrl()
+			if (!token) {
+				window.$message?.error?.("登录态失效，请重新登录")
+				return false
+			}
+
+			exporting.value = true
+			try {
+				const res = await pluginApi.createExport({
+					name,
+					kind: props.kind,
+					token,
+					url,
+					dirname: props.dirname,
+					args: exportArgs,
+				})
+				if (res.code === 200) {
+					window.$message?.success?.(res.msg || "已创建导出任务")
+					return true
+				}
+				window.$message?.error?.(res.msg || "创建导出任务失败")
+				return false
+			} catch (e) {
+				console.error(e)
+				window.$message?.error?.("创建导出任务失败，请确认插件可用")
+				return false
+			} finally {
+				exporting.value = false
+			}
+		}
+
+		const onConfirm = async () => {
+			const name = taskName.value.trim()
+			if (!name) {
+				window.$message?.warning?.("请输入导出任务名称")
+				return false
+			}
+
+			const ok = await createExport(name)
+			if (!ok) return false
+
+			emit("success")
+			close()
+			return true
+		}
+
+		return {
+			taskName,
+			exporting,
+			onShowUpdate,
+			onConfirm,
+		}
+	},
+})
+</script>

package/src/service/export_plugin/utils/export-task.js

@@ -0,0 +1,49 @@
+/**
+ * 默认读取平台登录 token（可被 props.getToken 覆盖）
+ * @returns {string}
+ */
+export const getDefaultToken = () => {
+	try {
+		const token = localStorage.getItem("token")
+		if (!token) return ""
+		return JSON.parse(token)?.access_token || ""
+	} catch {
+		return ""
+	}
+}
+
+/**
+ * 默认平台根地址（可被 props.getUrl 覆盖）
+ * @returns {string}
+ */
+export const getDefaultUrl = () => {
+	const base =
+		(typeof window !== "undefined" && window.sys_con?.baseURL) ||
+		`${location.protocol}//${location.host}`
+	return String(base).replace(/\/$/, "")
+}
+
+/**
+ * 默认校验：导出 args 需含完整时间范围
+ * @param {Record<string, any>} args
+ * @returns {boolean}
+ */
+export const validateTimeRangeArgs = (args = {}) => {
+	if (!(args.start_time && args.end_time)) {
+		window.$message?.warning?.("请选择发生时间")
+		return false
+	}
+	return true
+}
+
+/**
+ * 生成导出默认名称：导出数据_<年><月><日>
+ * @returns {string}
+ */
+export const buildTaskName = () => {
+	const d = new Date()
+	const y = d.getFullYear()
+	const m = String(d.getMonth() + 1).padStart(2, "0")
+	const day = String(d.getDate()).padStart(2, "0")
+	return `导出数据_${y}${m}${day}`
+}