zkqh-lagrange-utils 0.0.52 → 0.0.53

package/src/service/export_plugin/PluginLocalExport.jsx

@@ -0,0 +1,205 @@
+import { defineComponent, ref, computed, toRefs, onMounted } from "vue"
+import { PluginDirSelect } from "./internal/plugin-dir-select.jsx"
+import { usePluginHealth } from "./hooks/use-plugin-health.js"
+import { isOverSizeLimit, isPreviewOverflowDisk } from "./utils/size.js"
+import "./internal/styles/plugin-local-export.less"
+import("./assets/font/iconfont-lc.css")
+
+const DEFAULT_PREVIEW = {
+	show: false,
+	totalSize: 0,
+	exportDisabled: false,
+}
+
+/**
+ * 本地导出组合区：平台/应用小文件导出 + 插件目录导出 + 50MB 分流
+ *
+ * @example
+ * <PluginLocalExport
+ *   previewInfo={{ show, totalSize, exportDisabled }}
+ *   downloadUrl={url}
+ *   onSuccess={({ mode, dirname }) => {}}
+ * />
+ */
+export const PluginLocalExport = defineComponent({
+	name: "PluginLocalExport",
+	props: {
+		/**
+		 * 预览与分流控制
+		 * @type {{ show?: boolean, totalSize?: number, exportDisabled?: boolean }}
+		 */
+		previewInfo: {
+			type: Object,
+			default: () => ({ ...DEFAULT_PREVIEW }),
+		},
+		/** 插件安装包下载地址 */
+		downloadUrl: { type: String, default: "" },
+	},
+	emits: ["success"],
+	setup(props, { emit }) {
+		const { previewInfo, downloadUrl } = toRefs(props)
+		const dirname = ref("")
+		const diskInfo = ref({ total_size: 0, used_size: 0 })
+
+		const health = usePluginHealth({
+			downloadUrl: () => downloadUrl.value,
+		})
+		const { pluginReady, checkHealth, triggerInstall } = health
+
+		onMounted(() => {
+			checkHealth()
+		})
+
+		const preview = computed(() => ({
+			...DEFAULT_PREVIEW,
+			...(previewInfo.value || {}),
+		}))
+
+		/**
+		 * 是否展示平台/应用导出区（≤50MB）
+		 * show=true 且未禁用且有大小且未超 50MB
+		 */
+		const usePlatformExport = computed(() => {
+			const info = preview.value
+			if (!info.show || info.exportDisabled) return false
+			const size = Number(info.totalSize) || 0
+			if (size <= 0) return false
+			return !isOverSizeLimit(size)
+		})
+
+		/**
+		 * 是否展示插件导出区
+		 * - show=false：始终插件
+		 * - show=true：已可导出且 >50MB
+		 */
+		const usePluginExport = computed(() => {
+			const info = preview.value
+			if (!info.show) return true
+			if (info.exportDisabled) return false
+			const size = Number(info.totalSize) || 0
+			if (size <= 0) return false
+			return isOverSizeLimit(size)
+		})
+
+		/** 插件路径：预览大小是否超出当前目录剩余空间 */
+		const diskOverflow = computed(() => {
+			if (!pluginReady.value || !usePluginExport.value) return false
+			const info = preview.value
+			if (!info.show) return false
+			return isPreviewOverflowDisk(info.totalSize, diskInfo.value)
+		})
+
+		const pluginExportDisabled = computed(() => {
+			if (!pluginReady.value) return true
+			if (!dirname.value) return true
+			if (diskOverflow.value) return true
+			return false
+		})
+
+		const pluginButtonTitle = computed(() => {
+			if (!pluginReady.value) return "请先安装并启动导出插件"
+			if (!dirname.value) return "请选择本地导出目录"
+			if (diskOverflow.value) return "预估大小超出本地目录剩余空间，无法导出"
+			return ""
+		})
+
+		const onDiskInfoUpdate = (info) => {
+			diskInfo.value = info || { total_size: 0, used_size: 0 }
+		}
+
+		const onInstall = () => {
+			triggerInstall()
+		}
+
+		/** 平台/应用路径：确认后回调 */
+		const onPlatformExportClick = () => {
+			window.$dialog?.warning?.({
+				title: "确认导出",
+				content: "确认按当前筛选条件通过平台打包下载？",
+				positiveText: "确认",
+				negativeText: "取消",
+				onPositiveClick: () => {
+					emit("success", { mode: "platform" })
+				},
+			})
+		}
+
+		/** 插件路径：校验后回调（含 dirname） */
+		const onPluginExportClick = () => {
+			if (pluginExportDisabled.value) return
+			emit("success", { mode: "plugin", dirname: dirname.value })
+		}
+
+		return () => {
+			const showPlatform = usePlatformExport.value
+			const showPlugin = usePluginExport.value
+
+			if (!showPlatform && !showPlugin) {
+				return null
+			}
+
+			return (
+				<div class="plugin_local_export">
+					{showPlatform ? (
+						<div class="_ple_platform">
+							<span class="__tip lc-fs-m">文件小于50MB，请直接导出！</span>
+							<span
+								class="__action lc_btn_primary lc_btn_m"
+								onClick={onPlatformExportClick}>
+								导&nbsp;&nbsp;出
+							</span>
+						</div>
+					) : null}
+
+					{showPlugin ? (
+						<>
+							<div class="_ple_label lc-fs-m">选择本地目录</div>
+							{pluginReady.value && diskOverflow.value ? (
+								<div class="_ple_warn lc-fs-s">
+									<i class="lc lc-warning-circle-outlined"></i>
+									<span>预估大小超出本地目录剩余空间，请更换目录或缩小导出范围</span>
+								</div>
+							) : null}
+
+							{!pluginReady.value ? (
+								<div class="_ple_row">
+									<n-tree-select
+										size="small"
+										disabled
+										placeholder="安装插件后可选择导出文件"
+										options={[]}
+									/>
+									<span
+										class="lc_btn_primary lc_btn_m _ple_install"
+										onClick={onInstall}>
+										立即安装插件
+									</span>
+								</div>
+							) : (
+								<div class="_ple_row">
+									<PluginDirSelect
+										modelValue={dirname.value}
+										onUpdate:modelValue={(v) => {
+											dirname.value = v
+										}}
+										onUpdate:diskInfo={onDiskInfoUpdate}
+									/>
+									<div class="_ple_action">
+										<span
+											class={["lc_btn_primary", "lc_btn_m", pluginExportDisabled.value ? "_disabled" : ""]}
+											title={pluginButtonTitle.value}
+											onClick={onPluginExportClick}>
+											导&nbsp;&nbsp;出
+										</span>
+									</div>
+								</div>
+							)}
+						</>
+					) : null}
+				</div>
+			)
+		}
+	},
+})
+
+export default PluginLocalExport

package/src/service/export_plugin/api/index.js

@@ -0,0 +1,6 @@
+/**
+ * 导出插件 API 独立入口（可不挂载 UI）
+ * @example
+ * import { pluginApi } from "zkqh-lagrange-utils/export_plugin/api"
+ */
+export { pluginApi } from "./plugin.js"

package/src/service/export_plugin/api/plugin-bridge.js

@@ -0,0 +1,154 @@
+/** 与 front_plugins/lagrange-export-bridge 内容脚本约定的消息源（内置，不对外） */
+export const PLUGIN_BRIDGE_SOURCE = "lagrange-export-bridge"
+
+const REQUEST = "LAGRANGE_EXPORT_BRIDGE_REQUEST"
+const RESPONSE = "LAGRANGE_EXPORT_BRIDGE_RESPONSE"
+const READY = "LAGRANGE_EXPORT_BRIDGE_READY"
+const PING = "LAGRANGE_EXPORT_BRIDGE_PING"
+
+const BRIDGE_WAIT_MS = 1200
+const BRIDGE_TIMEOUT_MS = 15000
+
+const debugEnabled = () =>
+	typeof localStorage !== "undefined" && localStorage.getItem("LAGRANGE_PLUGIN_BRIDGE_DEBUG") === "1"
+
+/** @param {...unknown} args */
+function bridgeLog(...args) {
+	if (debugEnabled()) {
+		console.log("[plugin-bridge]", ...args)
+	}
+}
+
+let bridgeReady = false
+let listenerAttached = false
+
+/** 内容脚本注入后写入，避免 READY 早于业务脚本 */
+function isBridgeDomMarked() {
+	return typeof document !== "undefined" && document.documentElement?.dataset?.lagrangeExportBridge === "1"
+}
+
+function markBridgeReady(reason) {
+	if (!bridgeReady) {
+		bridgeReady = true
+		bridgeLog("ready", reason)
+	}
+}
+
+function attachBridgeListener() {
+	if (listenerAttached || typeof window === "undefined") return
+	listenerAttached = true
+	window.addEventListener("message", (event) => {
+		if (event.origin !== window.location.origin) return
+		const data = event.data
+		if (data?.source !== PLUGIN_BRIDGE_SOURCE || data?.type !== READY) return
+		markBridgeReady("message")
+	})
+}
+
+attachBridgeListener()
+
+/**
+ * 扩展桥接是否可用
+ * @returns {boolean}
+ */
+export function isPluginBridgeReady() {
+	return bridgeReady || isBridgeDomMarked()
+}
+
+/**
+ * 等待扩展 content script 就绪
+ * @returns {Promise<boolean>}
+ */
+export function waitForPluginBridge() {
+	if (isPluginBridgeReady()) {
+		return Promise.resolve(true)
+	}
+	attachBridgeListener()
+	window.postMessage(
+		{ source: PLUGIN_BRIDGE_SOURCE, type: PING },
+		window.location.origin,
+	)
+	bridgeLog("ping sent", window.location.origin)
+	return new Promise((resolve) => {
+		const deadline = Date.now() + BRIDGE_WAIT_MS
+		const tick = () => {
+			if (isBridgeDomMarked()) {
+				markBridgeReady("dom-dataset")
+			}
+			if (isPluginBridgeReady()) {
+				resolve(true)
+				return
+			}
+			if (Date.now() >= deadline) {
+				bridgeLog("wait timeout, bridge not detected")
+				resolve(false)
+				return
+			}
+			requestAnimationFrame(tick)
+		}
+		tick()
+	})
+}
+
+function createBridgeRequestId() {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+		try {
+			return crypto.randomUUID()
+		} catch {
+			// HTTP 非安全上下文下 randomUUID 不可用
+		}
+	}
+	return `ep-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`
+}
+
+/**
+ * 经 Chrome 扩展访问本机插件 API
+ * @param {string} method
+ * @param {string} path 如 /health
+ * @param {object} [body]
+ * @returns {Promise<object>}
+ */
+export function pluginFetchViaBridge(method, path, body) {
+	bridgeLog("request", method, path)
+	return new Promise((resolve, reject) => {
+		const id = createBridgeRequestId()
+
+		const timer = setTimeout(() => {
+			window.removeEventListener("message", onMessage)
+			reject(new Error("扩展桥接请求超时"))
+		}, BRIDGE_TIMEOUT_MS)
+
+		const onMessage = (event) => {
+			if (event.origin !== window.location.origin) return
+			const data = event.data
+			if (data?.source !== PLUGIN_BRIDGE_SOURCE || data?.type !== RESPONSE || data.id !== id) {
+				return
+			}
+			clearTimeout(timer)
+			window.removeEventListener("message", onMessage)
+
+			if (data.error) {
+				reject(new Error(data.error))
+				return
+			}
+			if (data.data == null && data.ok === false) {
+				reject(new Error("扩展桥接失败"))
+				return
+			}
+			resolve(data.data)
+		}
+
+		window.addEventListener("message", onMessage)
+		window.postMessage(
+			{
+				source: PLUGIN_BRIDGE_SOURCE,
+				type: REQUEST,
+				id,
+				method,
+				path,
+				body,
+			},
+			window.location.origin,
+		)
+	})
+}

package/src/service/export_plugin/api/plugin.js

@@ -0,0 +1,95 @@
+import axios from "axios"
+import {
+	isPluginBridgeReady,
+	pluginFetchViaBridge,
+	waitForPluginBridge,
+} from "./plugin-bridge.js"
+
+/**
+ * 本地导出插件 API（独立于平台 /plat）
+ * 优先经 Chrome 扩展桥接；无扩展时直连 127.0.0.1
+ */
+const PLUGIN_HOST = "http://127.0.0.1:12000"
+
+const pluginRequest = axios.create({
+	baseURL: `${PLUGIN_HOST}/plugin`,
+	timeout: 15000,
+})
+
+/** GET 不携带 Content-Type，避免多余的非简单请求预检 */
+pluginRequest.interceptors.request.use((config) => {
+	const method = (config.method || "get").toLowerCase()
+	if (method === "get" && config.headers) {
+		delete config.headers["Content-Type"]
+		delete config.headers["content-type"]
+	}
+	return config
+})
+
+pluginRequest.interceptors.response.use(
+	(response) => response.data,
+	(error) => Promise.reject(error),
+)
+
+function pluginApiDebugLog(...args) {
+	if (typeof localStorage !== "undefined" && localStorage.getItem("LAGRANGE_PLUGIN_BRIDGE_DEBUG") === "1") {
+		console.log("[plugin-api]", ...args)
+	}
+}
+
+/**
+ * @param {string} method
+ * @param {string} path
+ * @param {object} [body]
+ */
+async function pluginRequestUnified(method, path, body) {
+	await waitForPluginBridge()
+	if (isPluginBridgeReady()) {
+		pluginApiDebugLog("via extension bridge", method, path)
+		try {
+			return await pluginFetchViaBridge(method, path, body)
+		} catch (err) {
+			console.warn("[plugin-api] 扩展桥接失败:", err?.message || err)
+			throw err
+		}
+	}
+	pluginApiDebugLog("fallback axios → 127.0.0.1", method, path)
+	const config = { method, url: path }
+	if (body !== undefined && body !== null) {
+		config.data = body
+	}
+	return pluginRequest.request(config)
+}
+
+/**
+ * 将对象拼成 query string（跳过空值）
+ * @param {Record<string, any>} params
+ * @returns {string}
+ */
+function toQueryString(params = {}) {
+	const query = new URLSearchParams()
+	Object.entries(params).forEach(([key, value]) => {
+		if (value === undefined || value === null || value === "") return
+		query.set(key, String(value))
+	})
+	const qs = query.toString()
+	return qs ? `?${qs}` : ""
+}
+
+export const pluginApi = {
+	health: () => pluginRequestUnified("GET", "/health"),
+	getDiskList: () => pluginRequestUnified("GET", "/listdir"),
+	getDirList: (dirname = "/") => pluginRequestUnified("PUT", "/listdir", { dirname }),
+	createFolder: (dirname, foldername) => pluginRequestUnified("POST", "/listdir", { dirname, foldername }),
+	getDefaultDir: () => pluginRequestUnified("GET", "/dirname"),
+	setDefaultDir: (dirname) => pluginRequestUnified("PATCH", "/dirname", { dirname }),
+	/** 导出作业列表（无入参） */
+	getExportTasks: () => pluginRequestUnified("GET", "/export"),
+	/**
+	 * 导出作业列表（分页）
+	 * @param {{ farm: string, page_size?: number, current_page?: number, kind?: string }} params
+	 */
+	getExportTasksPage: (params = {}) => pluginRequestUnified("GET", `/exports${toQueryString(params)}`),
+	createExport: (params) => pluginRequestUnified("POST", "/export", params),
+	controlExport: (id, params) => pluginRequestUnified("PATCH", `/export/${id}`, params),
+}

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

@@ -0,0 +1,94 @@
+import { ref, onBeforeUnmount, unref } from "vue"
+import { pluginApi } from "../api/plugin.js"
+import { PLUGIN_HEALTH_INTERVAL } from "../utils/size.js"
+
+/**
+ * 触发导出插件安装包下载
+ * @param {string} [url]
+ */
+function _downloadPlugin(url = "") {
+	if (!url) {
+		window.$message?.info?.("请联系管理员获取导出插件安装包")
+		return
+	}
+	const link = document.createElement("a")
+	link.href = url
+	link.download = ""
+	document.body.appendChild(link)
+	link.click()
+	link.remove()
+}
+
+/**
+ * 导出插件 health：单次检测 + 安装后轮询，就绪后自动停止
+ * @param {{ interval?: number, downloadUrl?: string | import('vue').Ref<string> | (() => string) }} [options]
+ */
+export function usePluginHealth(options = {}) {
+	const intervalMs = options.interval ?? PLUGIN_HEALTH_INTERVAL
+	const pluginReady = ref(false)
+	const polling = ref(false)
+	let timerId = null
+
+	const resolveDownloadUrl = () => {
+		const raw = options.downloadUrl
+		if (typeof raw === "function") return raw() || ""
+		return unref(raw) || ""
+	}
+
+	const stopPoll = () => {
+		if (timerId != null) {
+			clearInterval(timerId)
+			timerId = null
+		}
+		polling.value = false
+	}
+
+	/**
+	 * 检测插件是否可用；就绪时自动停止轮询
+	 * @returns {Promise<boolean>}
+	 */
+	const checkHealth = async () => {
+		try {
+			const res = await pluginApi.health()
+			pluginReady.value = res?.code === 200
+		} catch {
+			pluginReady.value = false
+		}
+		if (pluginReady.value) {
+			stopPoll()
+		}
+		return pluginReady.value
+	}
+
+	/**
+	 * 开始轮询 health；插件激活后自动停止；重复调用不会叠加定时器
+	 */
+	const startPoll = () => {
+		if (pluginReady.value || polling.value) return
+		polling.value = true
+		checkHealth()
+		timerId = setInterval(() => {
+			checkHealth()
+		}, intervalMs)
+	}
+
+	/**
+	 * 下载安装包并启动 health 轮询
+	 * @param {string} [url] 优先使用入参，否则取 options.downloadUrl
+	 */
+	const triggerInstall = (url) => {
+		_downloadPlugin(url || resolveDownloadUrl())
+		startPoll()
+	}
+
+	onBeforeUnmount(stopPoll)
+
+	return {
+		pluginReady,
+		polling,
+		checkHealth,
+		startPoll,
+		stopPoll,
+		triggerInstall,
+	}
+}

package/src/service/export_plugin/index.js

@@ -0,0 +1,15 @@
+/**
+ * 导出插件服务模块
+ *
+ * 对外：
+ * - pluginApi：可独立引用
+ * - PluginLocalExport：平台/插件导出区组合组件
+ *
+ * @example
+ * import { pluginApi, PluginLocalExport } from "zkqh-lagrange-utils/export_plugin"
+ * import { pluginApi } from "zkqh-lagrange-utils/export_plugin/api"
+ */
+
+export { pluginApi } from "./api/plugin.js"
+export { PluginLocalExport } from "./PluginLocalExport.jsx"
+export { default } from "./PluginLocalExport.jsx"

package/src/service/export_plugin/internal/create-folder-modal.jsx

@@ -0,0 +1,102 @@
+import { defineComponent, ref, computed } from "vue"
+import { pluginApi } from "../api/plugin.js"
+import { formatPathDisplay, normalizeDir } from "../utils/plugin-dir.js"
+import "./styles/export-plugin-modals.less"
+
+/**
+ * 新建文件夹弹窗（由父级 v-if 控制挂载，内部组件不对外）
+ */
+export const CreateFolderModal = defineComponent({
+	name: "CreateFolderModal",
+	props: {
+		/** 父目录路径 */
+		parentPath: { type: String, default: "" },
+	},
+	emits: ["close", "created"],
+	setup(props, { emit }) {
+		const folderName = ref("")
+		const parentDir = ref(normalizeDir(props.parentPath))
+		const parentDisplay = computed(() => formatPathDisplay(parentDir.value))
+
+		const close = () => {
+			emit("close")
+		}
+
+		/**
+		 * 新建文件夹
+		 * @param {string} name
+		 * @param {string} dir
+		 * @returns {Promise<{ parentDir: string, newPath: string } | null>}
+		 */
+		const createFolder = async (name, dir) => {
+			try {
+				const res = await pluginApi.createFolder(dir, name)
+				if (res.code !== 200) {
+					window.$message?.error?.(res.msg || "创建失败")
+					return null
+				}
+
+				const newPath = normalizeDir(res.data?.path || `${dir}${name}`)
+				window.$message?.success?.(res.msg || "创建成功")
+				return { parentDir: dir, newPath }
+			} catch (e) {
+				console.error(e)
+				window.$message?.error?.("创建失败，请确认插件可用")
+				return null
+			}
+		}
+
+		const onConfirm = async () => {
+			const name = folderName.value.trim()
+			if (!name) {
+				window.$message?.warning?.("请输入文件夹名称")
+				return false
+			}
+			if (/[\\/:*?"<>|]/.test(name)) {
+				window.$message?.warning?.('名称不能包含 \\ / : * ? " < > |')
+				return false
+			}
+			if (!parentDir.value) {
+				window.$message?.warning?.("请选择要创建的父目录")
+				return false
+			}
+
+			const result = await createFolder(name, parentDir.value)
+			if (!result) return false
+
+			emit("created", result)
+			close()
+			return true
+		}
+
+		return () => (
+			<n-modal
+				show={true}
+				onUpdate:show={(v) => {
+					if (!v) close()
+				}}
+				preset="dialog"
+				title="新建文件夹"
+				positiveText="确认"
+				negativeText="取消"
+				maskClosable={false}
+				onPositiveClick={onConfirm}>
+				<div class="export_plugin_modals_hint lc-fs-s">将在以下目录下创建：{parentDisplay.value}</div>
+				<n-input
+					value={folderName.value}
+					onUpdate:value={(v) => {
+						folderName.value = v
+					}}
+					size="small"
+					placeholder="请输入文件夹名称"
+					class="mt-8"
+					onKeyup={(e) => {
+						if (e.key === "Enter") onConfirm()
+					}}
+				/>
+			</n-modal>
+		)
+	},
+})
+
+export default CreateFolderModal