karin-plugin-kkk 2.44.1 → 2.45.0-beta.3

package/lib/core_chunk/main.js

@@ -6,7 +6,7 @@ import { createRequire } from "node:module";
 import fs from "node:fs";
 import path, { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import karin, { BOT_CONNECT, app, authMiddleware, checkPkgUpdate, common, config, createBadRequestResponse, createNotFoundResponse, createServerErrorResponse, createSuccessResponse, db, defineConfig, ffmpeg, ffprobe, hooks, isDocker, karin as karin$1, karinPathHtml, logger, logs, mkdirSync, parseChangelog, range, render, restart, segment, updatePkg, watch } from "node-karin";
+import karin, { BOT_CONNECT, app, authMiddleware, checkPkgUpdate, common, config, createBadRequestResponse, createNotFoundResponse, createServerErrorResponse, createSuccessResponse, db, defineConfig, exec, ffmpeg, ffprobe, getPkgVersion, getRemotePkgVersion, hooks, isDocker, karin as karin$1, karinPathHtml, logger, logs, mkdirSync, parseChangelog, range, render, restart, segment, updatePkg, watch } from "node-karin";
 import crypto from "node:crypto";
 import { deflateSync, inflateSync } from "node:zlib";
 import express from "node-karin/express";
@@ -7433,6 +7433,26 @@ var resolveEmojiSrc = (filename) => {
 };
 setUnicodeEmojiSrcResolver(resolveEmojiSrc);
 //#endregion
+//#region src/module/utils/releaseChannel.ts
+var parseReleaseChannel = (version) => {
+	const v = version.trim().replace(/^[vV]/, "").split("+", 1)[0];
+	const match = /^\d+\.\d+\.\d+(?:-(.+))?$/.exec(v);
+	if (!match) return "Canary";
+	if (!match[1]) return "Stable";
+	const pre = match[1].split(".");
+	if (pre[0] === "rc") return "Rc";
+	if (pre[0] === "canary") return "Canary";
+	if (pre[0] === "beta" && pre.length <= 2) return "Beta";
+	return "Canary";
+};
+/** 渠道显示名（中文） */
+var RELEASE_CHANNEL_LABEL = {
+	Stable: "正式版",
+	Beta: "测试版",
+	Rc: "预览版",
+	Canary: "金丝雀"
+};
+//#endregion
 //#region src/module/utils/semver.ts
 /**
 * 语义化版本比较
@@ -7832,7 +7852,7 @@ var Render = async (event, path, data) => {
 			plugin: "karin-plugin",
 			pluginName: "kkk",
 			pluginVersion: Root.pluginVersion,
-			releaseType: /^\d+\.\d+\.\d+$/.test(Root.pluginVersion) ? "Stable" : "Preview",
+			releaseType: parseReleaseChannel(Root.pluginVersion),
 			poweredBy: "Karin",
 			frameworkVersion: Root.karinVersion,
 			hasUpdate
@@ -11413,6 +11433,15 @@ var ViteLogo = ({ className = "w-auto h-12" }) => /* @__PURE__ */ (0, import_jsx
 * @param props 组件属性
 * @returns JSX元素
 */
+/**
+* 渠道徽章文案：ctx.version.releaseType → 中文渠道名（未知值回显原值兜底）
+*/
+var RELEASE_TYPE_LABEL = {
+	Stable: "正式版",
+	Beta: "测试版",
+	Rc: "预览版",
+	Canary: "金丝雀"
+};
 var DefaultLayout = ({ children, ctx, className = "", style = {} }) => {
 	const useDarkTheme = isDark(ctx);
 	const { version } = ctx;
@@ -11480,21 +11509,21 @@ var DefaultLayout = ({ children, ctx, className = "", style = {} }) => {
 									strokeWidth: 3,
 									className: "w-4 h-4"
 								}),
-								!version.hasUpdate && version.releaseType === "Preview" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(TriangleAlert, {
+								!version.hasUpdate && (version.releaseType === "Beta" || version.releaseType === "Rc") && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(TriangleAlert, {
 									strokeWidth: 3,
 									className: "w-4 h-4 text-warning"
 								}),
-								!version.hasUpdate && version.releaseType !== "Stable" && version.releaseType !== "Preview" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Info, {
+								!version.hasUpdate && version.releaseType === "Canary" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Info, {
 									strokeWidth: 3,
 									className: "w-4 h-4"
 								}),
 								/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
-									className: cn(version.hasUpdate && "text-success", !version.hasUpdate && version.releaseType === "Preview" && "text-warning"),
-									children: version.hasUpdate ? "有可用更新" : version.releaseType
+									className: cn(version.hasUpdate && "text-success", !version.hasUpdate && (version.releaseType === "Beta" || version.releaseType === "Rc") && "text-warning"),
+									children: version.hasUpdate ? "有可用更新" : RELEASE_TYPE_LABEL[version.releaseType] ?? version.releaseType
 								})
 							]
 						}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", {
-							className: cn("text-5xl font-bold tracking-wide", version.hasUpdate && "text-success", !version.hasUpdate && version.releaseType === "Preview" && "text-warning"),
+							className: cn("text-5xl font-bold tracking-wide", version.hasUpdate && "text-success", !version.hasUpdate && (version.releaseType === "Beta" || version.releaseType === "Rc") && "text-warning"),
 							children: ["v", version.pluginVersion]
 						})]
 					}),
@@ -23944,7 +23973,7 @@ var qrlogin_default = defineTemplate({
 var RuntimeReport = import_react.memo((props) => {
 	const { data } = props;
 	const dark = isDark(props.ctx);
-	const releaseLabel = data.identity.releaseType.toLowerCase() === "stable" ? "正式版" : data.identity.releaseType.toLowerCase() === "preview" ? "预览版" : data.identity.releaseType;
+	const releaseLabel = RELEASE_TYPE_LABEL[data.identity.releaseType] ?? data.identity.releaseType;
 	const buildStatus = data.build.state === "matched" ? {
 		label: "构建信息一致",
 		icon: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CircleCheck, { className: "h-8 w-8" }),
@@ -24412,6 +24441,463 @@ var runtime_default = defineTemplate({
 	component: RuntimeReport
 });
 //#endregion
+//#region ktr/template/other/updateHelp/components/updateHelp.tsx
+/**
+* `#kkk更新` 用法面板（kkk-design 系统 B × Apple 排版原则）。
+*
+* 主情绪色为深青（teal）——紫罗兰系在 runtime/更新日志等模板已被占用，避开色彩同质化。
+* 构图：横向 Hero 带（左主标题、右当前安装版本，版本号按长度分级缩放防溢出）→
+* 表格式渠道清单（固定列宽 grid，命令列纵向对齐）→ 命令→说明单行对。
+* 状态为完整 semver 比较：有更新 / 已是最新 / 低于当前版本三分，而非笼统布尔。
+* 噪点沿用 runtime 的高对比离散颗粒（深色 0.16 / 浅色 0.12）。
+*/
+/** 完整 semver 比较（core 数字 + prerelease 段，规则与 core 的 semver.ts 一致） */
+var semverCompare = (a, b) => {
+	const parse = (v) => {
+		const [core, pre] = v.trim().replace(/^[vV]/, "").split("+")[0].split("-");
+		const [maj, min, pat] = core.split(".").map((n) => Number.parseInt(n, 10) || 0);
+		return {
+			maj,
+			min,
+			pat,
+			pre: pre ? pre.split(".") : []
+		};
+	};
+	const p = parse(a);
+	const q = parse(b);
+	if (p.maj !== q.maj) return p.maj - q.maj;
+	if (p.min !== q.min) return p.min - q.min;
+	if (p.pat !== q.pat) return p.pat - q.pat;
+	if (p.pre.length === 0 && q.pre.length === 0) return 0;
+	if (p.pre.length === 0) return 1;
+	if (q.pre.length === 0) return -1;
+	const len = Math.min(p.pre.length, q.pre.length);
+	for (let i = 0; i < len; i++) {
+		const an = /^\d+$/.test(p.pre[i]);
+		const bn = /^\d+$/.test(q.pre[i]);
+		if (an !== bn) return an ? -1 : 1;
+		if (p.pre[i] !== q.pre[i]) {
+			if (an && bn) return Number(p.pre[i]) - Number(q.pre[i]);
+			return p.pre[i] > q.pre[i] ? 1 : -1;
+		}
+	}
+	return p.pre.length === q.pre.length ? 0 : p.pre.length > q.pre.length ? 1 : -1;
+};
+/**
+* Hero 版本号布局：
+* - 短版本（纯 semver，≤6 字符）与主标题同行横排，150px；
+* - 长版本（canary 等 prerelease）独占整行堆叠在标题下方，字号按「可用宽 1180px ÷
+*   等宽字符宽 0.6em」自适应，上限仍 150px——标题与版本号不再挤同一行。
+*/
+var heroStacked = (version) => version.trim().replace(/^[vV]/, "").length > 6;
+var heroVersionSize = (version) => {
+	const len = version.trim().replace(/^[vV]/, "").length;
+	if (len <= 6) return 150;
+	return Math.max(72, Math.min(150, Math.floor(1180 / (len * .6))));
+};
+//#endregion
+//#region ktr/template/other/updateHelp/index.tsx
+var updateHelp_default = defineTemplate({
+	name: "更新渠道面板",
+	description: "#kkk更新 用法与各渠道可用版本一览",
+	component: import_react.memo((props) => {
+		const { data } = props;
+		const palette = isDark(props.ctx) ? {
+			background: "#081416",
+			glowPrimary: "rgba(45, 212, 191, 0.28)",
+			glowSecondary: "rgba(56, 130, 246, 0.14)",
+			glowWarm: "rgba(250, 204, 21, 0.12)",
+			bgWord: "#99f6e4",
+			ink: "#effefd",
+			muted: "rgba(239, 254, 253, 0.62)",
+			faint: "rgba(239, 254, 253, 0.36)",
+			pillBg: "rgba(45, 212, 191, 0.12)",
+			pillBorder: "rgba(94, 234, 212, 0.32)",
+			pillText: "#5eead4",
+			accentText: "#5eead4",
+			success: "#4ade80",
+			warning: "#fbbf24",
+			noiseOpacity: .16
+		} : {
+			background: "#effaf8",
+			glowPrimary: "rgba(20, 184, 166, 0.26)",
+			glowSecondary: "rgba(125, 211, 252, 0.40)",
+			glowWarm: "rgba(250, 204, 21, 0.26)",
+			bgWord: "#0c3b38",
+			ink: "#0c3b38",
+			muted: "rgba(12, 59, 56, 0.68)",
+			faint: "rgba(12, 59, 56, 0.42)",
+			pillBg: "rgba(20, 184, 166, 0.10)",
+			pillBorder: "rgba(20, 184, 166, 0.30)",
+			pillText: "#0f766e",
+			accentText: "#0d9488",
+			success: "#15803d",
+			warning: "#8a5a06",
+			noiseOpacity: .12
+		};
+		/**
+		* 渠道状态：文案按具体状态区分（有更新 / 已是最新 / 低于当前版本 / 暂未发布 / 获取失败），
+		* 颜色只分两档 —— 可升级（success）与置灰（faint）：非可升级状态一律不引导行动。
+		* active 供行内所有元素同步置灰。
+		*/
+		const statusView = (channel) => {
+			if (channel.status === "missing") return {
+				dot: palette.faint,
+				text: "该渠道暂未发布",
+				active: false
+			};
+			if (channel.status === "error") return {
+				dot: palette.faint,
+				text: "获取失败",
+				active: false
+			};
+			if (channel.status === "canary") return channel.hasUpdate ? {
+				dot: palette.success,
+				text: "有新构建可升级",
+				active: true
+			} : {
+				dot: palette.accentText,
+				text: "main 分支构建",
+				active: true
+			};
+			const order = semverCompare(channel.version ?? "0.0.0", data.currentVersion);
+			if (order > 0) return {
+				dot: palette.success,
+				text: "有更新可升级",
+				active: true
+			};
+			if (order === 0) return {
+				dot: palette.faint,
+				text: "已是最新",
+				active: false
+			};
+			return {
+				dot: palette.faint,
+				text: "低于当前版本",
+				active: false
+			};
+		};
+		return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DefaultLayout, {
+			...props,
+			className: "relative min-h-440 overflow-hidden",
+			style: { backgroundColor: palette.background },
+			children: [
+				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+					className: "pointer-events-none absolute inset-0 z-0 overflow-hidden",
+					children: [
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+							className: "absolute -left-130 -top-120 h-337.5 w-375 rounded-full blur-[230px]",
+							style: { background: `radial-gradient(ellipse at center, ${palette.glowPrimary} 0%, transparent 70%)` }
+						}),
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+							className: "absolute -right-130 top-[36%] h-312.5 w-300 rounded-full blur-[240px]",
+							style: { background: `radial-gradient(ellipse at center, ${palette.glowSecondary} 0%, transparent 72%)` }
+						}),
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+							className: "absolute -bottom-120 -left-80 h-287.5 w-337.5 rounded-full blur-[260px]",
+							style: { background: `radial-gradient(ellipse at center, ${palette.glowWarm} 0%, transparent 72%)` }
+						}),
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+							className: "pointer-events-none absolute right-14 top-8 select-none font-bold leading-none tracking-[-0.02em]",
+							style: {
+								fontSize: "220px",
+								opacity: .04,
+								color: palette.bgWord
+							},
+							children: "UPDATE"
+						})
+					]
+				}),
+				/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+					className: "pointer-events-none absolute inset-0 z-0",
+					style: { opacity: palette.noiseOpacity },
+					children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", {
+						className: "h-full w-full",
+						xmlns: "http://www.w3.org/2000/svg",
+						children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("filter", {
+							id: "updateHelpNoise",
+							x: "0%",
+							y: "0%",
+							width: "100%",
+							height: "100%",
+							children: [
+								/* @__PURE__ */ (0, import_jsx_runtime.jsx)("feTurbulence", {
+									type: "fractalNoise",
+									baseFrequency: "0.8",
+									numOctaves: "1",
+									stitchTiles: "stitch",
+									result: "noise"
+								}),
+								/* @__PURE__ */ (0, import_jsx_runtime.jsx)("feColorMatrix", {
+									type: "saturate",
+									values: "0",
+									result: "gray"
+								}),
+								/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("feComponentTransfer", { children: [
+									/* @__PURE__ */ (0, import_jsx_runtime.jsx)("feFuncR", {
+										type: "discrete",
+										tableValues: "0 1"
+									}),
+									/* @__PURE__ */ (0, import_jsx_runtime.jsx)("feFuncG", {
+										type: "discrete",
+										tableValues: "0 1"
+									}),
+									/* @__PURE__ */ (0, import_jsx_runtime.jsx)("feFuncB", {
+										type: "discrete",
+										tableValues: "0 1"
+									})
+								] })
+							]
+						}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("rect", {
+							width: "100%",
+							height: "100%",
+							filter: "url(#updateHelpNoise)"
+						})]
+					})
+				}),
+				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("main", {
+					className: "relative z-10 px-22 pb-16 pt-20",
+					children: [
+						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("header", {
+							className: "relative flex items-center justify-between gap-12",
+							children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "flex items-center gap-4",
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "h-3 w-3 rounded-full",
+									style: { background: palette.accentText }
+								}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "whitespace-nowrap text-[24px] font-bold tracking-[0.28em] text-foreground/44",
+									children: "更新面板 · UPDATE PANEL"
+								})]
+							}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+								className: "whitespace-nowrap rounded-full border px-6 py-2 text-[22px] font-bold tracking-[0.14em]",
+								style: {
+									borderColor: palette.pillBorder,
+									background: palette.pillBg,
+									color: palette.pillText
+								},
+								children: data.currentChannel
+							})]
+						}),
+						heroStacked(data.currentVersion) ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("h1", {
+							className: "whitespace-nowrap text-[96px] font-bold leading-[1.04] tracking-[-0.02em] text-foreground",
+							children: "更新渠道"
+						}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
+							className: "mt-6 whitespace-nowrap text-[30px] font-semibold text-foreground/48",
+							children: data.currentChannel === "金丝雀" ? "金丝雀构建跟随 main 分支实时发布，可随时切换回正式渠道" : "各渠道可用版本与 #kkk更新 用法一览"
+						})] }), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+							className: "relative mt-14",
+							children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+								className: "text-[22px] font-bold uppercase tracking-[0.22em] text-foreground/36",
+								children: "当前安装 · INSTALLED"
+							}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "mt-4 whitespace-nowrap font-mono font-bold leading-none tracking-[-0.05em] tabular-nums text-foreground",
+								style: { fontSize: `${heroVersionSize(data.currentVersion)}px` },
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "mr-3 align-top text-[0.42em] font-bold text-foreground/40",
+									children: "v"
+								}), data.currentVersion]
+							})]
+						})] }) : /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+							className: "relative mt-14 flex items-end justify-between gap-12",
+							children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("h1", {
+								className: "whitespace-nowrap text-[96px] font-bold leading-[1.04] tracking-[-0.02em] text-foreground",
+								children: "更新渠道"
+							}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
+								className: "mt-6 whitespace-nowrap text-[30px] font-semibold text-foreground/48",
+								children: data.currentChannel === "金丝雀" ? "金丝雀构建跟随 main 分支实时发布，可随时切换回正式渠道" : "各渠道可用版本与 #kkk更新 用法一览"
+							})] }), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "flex shrink-0 flex-col items-end",
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+									className: "text-[22px] font-bold uppercase tracking-[0.22em] text-foreground/36",
+									children: "当前安装 · INSTALLED"
+								}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+									className: "mt-4 whitespace-nowrap font-mono font-bold leading-none tracking-[-0.05em] tabular-nums text-foreground",
+									style: { fontSize: `${heroVersionSize(data.currentVersion)}px` },
+									children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+										className: "mr-3 align-top text-[0.42em] font-bold text-foreground/40",
+										children: "v"
+									}), data.currentVersion]
+								})]
+							})]
+						}),
+						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("section", {
+							className: "relative mt-24",
+							children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "flex items-center gap-4",
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "h-3 w-3 rounded-full",
+									style: { background: palette.accentText }
+								}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "text-[24px] font-bold tracking-[0.28em] text-foreground/44",
+									children: "可用版本 · AVAILABLE"
+								})]
+							}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+								className: "mt-12 flex flex-col gap-14",
+								children: data.channels.map((channel) => {
+									const status = statusView(channel);
+									const publishedDate = channel.publishedAt ? new Date(channel.publishedAt) : void 0;
+									if (channel.status === "canary") return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+										className: "flex flex-col gap-4",
+										children: [
+											/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+												className: "flex items-center justify-between gap-10",
+												children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+													className: "flex items-center gap-4",
+													children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+														className: "whitespace-nowrap text-[30px] font-semibold",
+														style: { color: status.active ? palette.muted : palette.faint },
+														children: channel.label
+													}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+														className: "whitespace-nowrap rounded-full border px-4 py-0.5 font-mono text-[20px] font-semibold",
+														style: {
+															borderColor: palette.pillBorder,
+															background: palette.pillBg,
+															color: status.active ? palette.pillText : palette.faint
+														},
+														children: channel.tag
+													})]
+												}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+													className: "flex items-center gap-6",
+													children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+														className: "whitespace-nowrap font-mono text-[46px] font-bold leading-none",
+														style: { color: status.active ? palette.ink : palette.faint },
+														children: channel.version
+													}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", {
+														className: "flex items-center gap-3 whitespace-nowrap text-[24px] font-semibold",
+														style: { color: status.dot },
+														children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+															className: "h-2.5 w-2.5 rounded-full",
+															style: { background: status.dot }
+														}), status.text]
+													})]
+												})]
+											}),
+											channel.installCommand && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+												className: "whitespace-nowrap rounded-3xl px-7 py-4 font-mono text-[27px] font-semibold",
+												style: {
+													background: status.active ? palette.pillBg : "transparent",
+													color: status.active ? palette.pillText : palette.faint
+												},
+												children: channel.installCommand
+											}),
+											/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+												className: "flex items-center justify-between gap-10 whitespace-nowrap",
+												children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", {
+													className: "text-[24px] text-foreground/42",
+													children: ["发布于 ", publishedDate && format(publishedDate, "yyyy/MM/dd HH:mm")]
+												}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+													className: "font-mono text-[24px] font-semibold",
+													style: { color: palette.faint },
+													title: channel.publishedAt,
+													children: publishedDate && formatDistanceToNow(publishedDate, {
+														addSuffix: true,
+														locale: zhCN
+													})
+												})]
+											})
+										]
+									}, channel.tag);
+									return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+										className: "grid grid-cols-[11rem_1fr_auto] items-center gap-8",
+										children: [
+											/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+												className: "flex flex-col gap-2",
+												children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+													className: "whitespace-nowrap text-[30px] font-semibold",
+													style: { color: status.active ? palette.muted : palette.faint },
+													children: channel.label
+												}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+													className: "w-fit whitespace-nowrap rounded-full border px-4 py-0.5 font-mono text-[20px] font-semibold",
+													style: {
+														borderColor: palette.pillBorder,
+														background: palette.pillBg,
+														color: status.active ? palette.pillText : palette.faint
+													},
+													children: channel.tag
+												})]
+											}),
+											/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+												className: "whitespace-nowrap font-mono text-[24px] font-semibold",
+												style: { color: status.active ? palette.muted : palette.faint },
+												children: channel.command
+											}),
+											/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+												className: "flex flex-col items-end gap-2.5 whitespace-nowrap",
+												children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+													className: "font-mono text-[56px] font-bold leading-none tracking-[-0.02em] tabular-nums",
+													style: { color: status.active ? palette.ink : palette.faint },
+													children: channel.status === "ok" ? `v${channel.version}` : "—"
+												}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", {
+													className: "flex items-center gap-3 text-[24px] font-semibold",
+													style: { color: status.dot },
+													children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+														className: "h-2.5 w-2.5 rounded-full",
+														style: { background: status.dot }
+													}), status.text]
+												})]
+											})
+										]
+									}, channel.tag);
+								})
+							})]
+						}),
+						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("section", {
+							className: "relative mt-28",
+							children: [
+								/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+									className: "flex items-center gap-4",
+									children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+										className: "h-3 w-3 rounded-full",
+										style: { background: palette.accentText }
+									}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+										className: "text-[24px] font-bold tracking-[0.28em] text-foreground/44",
+										children: "用法 · COMMANDS"
+									})]
+								}),
+								/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+									className: "mt-12 flex flex-col gap-10",
+									children: [
+										{
+											command: "#kkk更新",
+											desc: "更新到最新正式版"
+										},
+										{
+											command: "#kkk更新rc",
+											desc: "更新到预览渠道最新版"
+										},
+										{
+											command: "#kkk更新beta",
+											desc: "更新到测试渠道最新版"
+										},
+										{
+											command: "#kkk更新<版本号>",
+											desc: "更新到指定 stable 版本，例如 #kkk更新2.45.0"
+										}
+									].map((item) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+										className: "grid grid-cols-[24rem_1fr] items-baseline gap-8",
+										children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+											className: "whitespace-nowrap font-mono text-[34px] font-bold text-foreground",
+											children: item.command
+										}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+											className: "whitespace-nowrap text-[26px] font-semibold text-foreground/48",
+											children: item.desc
+										})]
+									}, item.command))
+								}),
+								/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+									className: "mt-16 flex flex-col gap-2 whitespace-nowrap font-mono text-[22px] font-semibold text-foreground/28",
+									children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "金丝雀版本经 pkg.pr.new 分发，不提供渠道订阅与更新推送" }), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "指定低于当前安装版本的版本号属于降级，需回复「确认」才会执行" })]
+								})
+							]
+						})
+					]
+				})
+			]
+		});
+	})
+});
+//#endregion
 //#region ktr/template/other/version_warning/components/VersionWarning.tsx
 var VersionWarning = (props) => {
 	const dark = isDark(props.ctx);
@@ -28329,6 +28815,7 @@ var templates = {
 	"other/live-photo-tip": live_photo_tip_default,
 	"other/qrlogin": qrlogin_default,
 	"other/runtime": runtime_default,
+	"other/updateHelp": updateHelp_default,
 	"other/version_warning": version_warning_default,
 	"statistics/global": global_default,
 	"statistics/group": group_default,
@@ -38114,7 +38601,7 @@ var collectRuntimeReport = (event) => {
 			pluginName: Root.pluginName,
 			pluginVersion: Root.pluginVersion,
 			karinVersion: Root.karinVersion || "未知",
-			releaseType: /^\d+\.\d+\.\d+$/.test(Root.pluginVersion) ? "Stable" : "Preview",
+			releaseType: parseReleaseChannel(Root.pluginVersion),
 			requiredNodeVersion: packageMetadata.engines?.node ?? "未声明",
 			requiredKarinVersion: packageMetadata.karin?.engines ?? packageMetadata.engines?.karin ?? "未声明"
 		},
@@ -39928,6 +40415,7 @@ var getChangelogImage = async (ctx, props) => {
 		const localMeta = getBuildMetadata();
 		if (localMeta?.buildTime) buildTime = formatBuildTime(localMeta.buildTime);
 	}
+	changelog = changelog.replace(/^(## \[\d+\.\d+\.\d+-[^\]]+\][^\r\n]*)/gm, "$1 「测试版」");
 	return await Render(event, "other/changelog", {
 		markdown: changelog,
 		Tip: props.Tip,
@@ -39941,32 +40429,43 @@ var getChangelogImage = async (ctx, props) => {
 //#endregion
 //#region src/apps/update.ts
 var UPDATE_LOCK_KEY = "kkk:update:lock";
-var UPDATE_MSGID_KEY = "kkk:update:msgId";
+var UPDATE_MSGID_KEY = "kkk:update:msgid";
 /**
 * 定时更新检测处理器
-* 主动获取 Bot 列表与好友关系，匹配主人可用的 Bot，
-* 渲染更新日志并私聊通知所有主人。
+* 按订阅渠道检查远程版本（latest 恒参与 —— 装 prerelease 的用户也要收到转正提醒），
+* 候选取 semver 最大且大于本地者，渲染变更日志并私聊通知所有主人。
 *
 * @returns 是否继续后续任务
 */
 var Handler = async () => {
-	let upd;
-	try {
-		upd = await checkPkgUpdate(Root.pluginName, { compare: "semver" });
-	} catch {
-		return true;
-	}
-	if (upd.status === "yes" && !isSemverGreater(upd.remote, upd.local)) return true;
-	if (upd.status !== "yes") return true;
+	const tags = ["latest", ...(Config.app.UpdateNotifyChannels?.length ? Config.app.UpdateNotifyChannels : ["stable"]).filter((c) => c !== "stable")];
+	const installedIsCanary = parseReleaseChannel(Root.pluginVersion) === "Canary";
+	const installedBuildTime = getBuildMetadata()?.buildTimestamp;
+	const remotes = await Promise.all(tags.map(async (tag) => {
+		try {
+			return await getRemotePkgVersion(Root.pluginName, tag) || null;
+		} catch {
+			return null;
+		}
+	}));
+	const canaryInfo = installedIsCanary ? await fetchCanaryInfo() : null;
+	const remote = [...new Set(remotes.filter((v) => !!v))].filter((version) => {
+		if (installedIsCanary && installedBuildTime !== void 0) {
+			const releaseNode = canaryInfo?.nodes.find((n) => n.message.includes(version));
+			if (releaseNode) return releaseNode.time > installedBuildTime;
+		}
+		return isSemverGreater(version, Root.pluginVersion);
+	}).sort((a, b) => isSemverGreater(b, a) ? 1 : -1)[0];
+	if (!remote) return true;
 	try {
 		const lockedVersion = await db.get(UPDATE_LOCK_KEY);
 		if (typeof lockedVersion === "string" && lockedVersion.length > 0) {
 			if (!isSemverGreater(lockedVersion, Root.pluginVersion)) await db.del(UPDATE_LOCK_KEY);
-			else if (!isSemverGreater(upd.remote, lockedVersion)) return true;
+			else if (!isSemverGreater(remote, lockedVersion)) return true;
 		}
 	} catch {}
 	try {
-		await db.set(UPDATE_LOCK_KEY, upd.remote);
+		await db.set(UPDATE_LOCK_KEY, remote);
 	} catch {}
 	const masters = config.master().filter((id) => id !== "console");
 	if (masters.length === 0) return true;
@@ -39977,9 +40476,7 @@ var Handler = async () => {
 		try {
 			const list = await item.bot.getFriendList();
 			friendsMap.set(item.bot.account.selfId, list || []);
-		} catch {
-			friendsMap.set(item.bot.account.selfId, []);
-		}
+		} catch {}
 	}));
 	const masterToBot = /* @__PURE__ */ new Map();
 	for (const owner of masters) {
@@ -39991,7 +40488,7 @@ var Handler = async () => {
 		if (!Array.from(masterToBot.entries()).some(([, b]) => b.account.selfId === item.bot.account.selfId)) continue;
 		const img = await getChangelogImage({ bot: item.bot }, {
 			localVersion: Root.pluginVersion,
-			remoteVersion: upd.remote,
+			remoteVersion: remote,
 			Tip: true
 		});
 		if (img && img.length > 0) botToImage.set(item.bot.account.selfId, [segment.text("karin-plugin-kkk 有新的更新！"), ...img]);
@@ -40033,39 +40530,214 @@ var kkkUpdate = hooks.message.friend(async (e, next) => {
 	}
 	next();
 }, { priority: 100 });
+/** 解析 #kkk更新 的可选参数：缺省/stable=正式版，beta/rc=渠道 tag，其余识别为版本号 */
+var parseUpdateArg = (arg) => {
+	if (!arg) return { type: "latest" };
+	if (arg === "stable" || arg === "latest") return { type: "latest" };
+	if (arg === "beta" || arg === "rc") return {
+		type: "tag",
+		tag: arg
+	};
+	if (/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(arg)) return {
+		type: "version",
+		version: arg
+	};
+	return { type: "unknown" };
+};
+/** 解析目标版本号：latest / 渠道 tag 取对应 dist-tag，指定版本号校验存在性 */
+var resolveUpdateTarget = async (parsed) => {
+	if (parsed.type === "latest") {
+		const version = await getRemotePkgVersion(Root.pluginName).catch(() => "");
+		return version ? {
+			version,
+			tag: "latest"
+		} : { error: "获取远程版本失败" };
+	}
+	if (parsed.type === "tag") {
+		const version = await getRemotePkgVersion(Root.pluginName, parsed.tag).catch(() => "");
+		return version ? {
+			version,
+			tag: parsed.tag
+		} : { error: `渠道 ${parsed.tag} 暂无可用版本` };
+	}
+	if (parsed.type === "version") {
+		const { status, stdout } = await exec(`npm view ${Root.pluginName}@${parsed.version} version`);
+		const found = status ? stdout.toString().trim() : "";
+		return found ? {
+			version: found,
+			tag: ""
+		} : { error: `版本 ${parsed.version} 不存在` };
+	}
+	return { error: "未识别的渠道或版本" };
+};
+/** 安装指定版本并重启（含降级；调用前必须已完成二次确认） */
+var installAndRestart = async (e, version) => {
+	await e.reply(`开始更新 karin-plugin-kkk → ${version} ......`, { reply: true });
+	const { error } = await exec(`pnpm up ${Root.pluginName}@${version}`);
+	if (error) {
+		e.reply(`${Root.pluginName} 更新失败: ${error}`, { reply: true });
+		return;
+	}
+	const installed = await getPkgVersion(Root.pluginName);
+	if (installed !== version) {
+		e.reply(`更新失败：安装后版本为 ${installed}，预期 ${version}。可尝试手动执行 pnpm up ${Root.pluginName}@${version}`, { reply: true });
+		return;
+	}
+	const msgResult = await e.reply(`${Root.pluginName} 更新成功！→ ${version}\n开始执行重启......`);
+	if (msgResult.messageId) try {
+		await db.del(UPDATE_MSGID_KEY);
+		await db.del(UPDATE_LOCK_KEY);
+	} catch {}
+	await restart(e.selfId, e.contact, msgResult.messageId);
+};
+/** pkg.pr.new 仓库（金丝雀数据源，只跟踪 main 分支构建） */
+var PKG_PR_NEW_REPO = "ikenxuan/karin-plugin-kkk";
+/** 拉取 pkg.pr.new 的发布历史与 main 分支最新构建（失败返回 null，由调用方降级展示） */
+var fetchCanaryInfo = async () => {
+	try {
+		const [owner, repo] = PKG_PR_NEW_REPO.split("/");
+		const nodes = (await axios.get(`https://pkg.pr.new/api/repo/commits?owner=${owner}&repo=${repo}`, { timeout: 1e4 })).data?.target?.history?.nodes;
+		if (!Array.isArray(nodes)) return null;
+		const history = nodes.map((n) => ({
+			sha: (n.abbreviatedOid ?? "").slice(0, 7),
+			time: n.authoredDate ? new Date(n.authoredDate).getTime() : 0,
+			message: n.message ?? ""
+		}));
+		const mainNode = nodes.find((n) => n.branch === "main" && n.statusCheckRollup?.contexts?.nodes?.some((c) => c.packages?.some((pkg) => pkg.installUrl)));
+		const pkg = mainNode?.statusCheckRollup?.contexts?.nodes?.flatMap((c) => c.packages ?? []).find((p) => p.installUrl);
+		if (!mainNode?.abbreviatedOid || !pkg?.installUrl) return null;
+		return {
+			channel: {
+				label: "金丝雀",
+				tag: "pkg.pr.new · main",
+				status: "canary",
+				version: mainNode.abbreviatedOid.slice(0, 7),
+				installCommand: `pnpm add ${pkg.installUrl} -w`,
+				publishedAt: mainNode.authoredDate
+			},
+			nodes: history
+		};
+	} catch {
+		return null;
+	}
+};
+/** 渲染 #kkk更新 用法面板（含各渠道可用版本） */
+var getUpdateHelpImage = async (e) => {
+	const { status, stdout } = await exec(`npm view ${Root.pluginName} dist-tags --json`);
+	let distTags = {};
+	if (status) try {
+		distTags = JSON.parse(stdout.toString());
+	} catch {}
+	const canaryInfo = await fetchCanaryInfo();
+	const installedIsCanary = parseReleaseChannel(Root.pluginVersion) === "Canary";
+	const build = getBuildMetadata();
+	const installedBuildTime = build?.buildTimestamp;
+	const channels = [
+		{
+			label: "正式版",
+			tag: "latest",
+			command: "#kkk更新"
+		},
+		{
+			label: "预览版",
+			tag: "rc",
+			command: "#kkk更新rc"
+		},
+		{
+			label: "测试版",
+			tag: "beta",
+			command: "#kkk更新beta"
+		}
+	].map((def) => {
+		if (!status) return {
+			...def,
+			status: "error"
+		};
+		const version = distTags[def.tag];
+		if (!version) return {
+			...def,
+			status: "missing"
+		};
+		if (installedIsCanary && installedBuildTime !== void 0) {
+			const releaseNode = canaryInfo?.nodes.find((n) => n.message.includes(version));
+			if (releaseNode) return {
+				...def,
+				status: "ok",
+				version,
+				hasUpdate: releaseNode.time > installedBuildTime
+			};
+		}
+		return {
+			...def,
+			status: "ok",
+			version,
+			hasUpdate: isSemverGreater(version, Root.pluginVersion)
+		};
+	});
+	const canaryChannel = canaryInfo?.channel ?? {
+		label: "金丝雀",
+		tag: "pkg.pr.new · main",
+		status: "error"
+	};
+	const installedSha = (build?.shortCommitHash ?? "").slice(0, 7);
+	if (installedIsCanary && canaryChannel.status === "canary" && installedSha) canaryChannel.hasUpdate = installedSha !== canaryChannel.version;
+	channels.push(canaryChannel);
+	return await Render(e, "other/updateHelp", {
+		currentVersion: Root.pluginVersion,
+		currentChannel: RELEASE_CHANNEL_LABEL[parseReleaseChannel(Root.pluginVersion)],
+		channels
+	});
+};
 var handleKkkUpdate = wrapWithErrorHandler(async (e) => {
-	const upd = await checkPkgUpdate(Root.pluginName, { compare: "semver" });
-	if (upd.status === "error") {
-		e.reply(`获取远程版本失败：${upd.error?.message ?? String(upd.error)}`);
+	const arg = /^#?kkk更新(?:\s*(\S+))?$/.exec(e.msg)?.[1];
+	const parsed = parseUpdateArg(arg);
+	if (parsed.type === "unknown") {
+		const img = await getUpdateHelpImage(e).catch(() => null);
+		if (img && img.length > 0) e.reply(img, { reply: true });
+		else e.reply("渲染更新面板失败。用法：#kkk更新 | #kkk更新beta | #kkk更新rc | #kkk更新<版本号>", { reply: true });
 		return;
 	}
-	if (upd.status === "no") {
-		e.reply(`当前已是最新版本：${upd.local}`, { reply: true });
+	const resolved = await resolveUpdateTarget(parsed);
+	if ("error" in resolved) {
+		e.reply(resolved.error, { reply: true });
 		return;
 	}
-	if (upd.status === "yes" && !isSemverGreater(upd.remote, upd.local)) {
-		e.reply(`当前已是最新或预览版本：${upd.local}`, { reply: true });
+	const { version: remote } = resolved;
+	const local = Root.pluginVersion;
+	if (remote === local) {
+		e.reply(`当前已是该版本：${local}`, { reply: true });
+		return;
+	}
+	if (!isSemverGreater(remote, local)) {
+		e.reply([
+			`⚠️ 检测到降级更新：当前 ${local} → 目标 ${remote}`,
+			"降级可能带来配置或数据兼容问题，请确认你知道自己在做什么。",
+			"回复「确认」继续更新，回复其他内容放弃（2 分钟内有效）。"
+		].join("\n"), { reply: true });
+		const confirmCtx = await karin.ctx(e, {
+			time: 120,
+			reply: true,
+			throwOnTimeout: false
+		});
+		if (!confirmCtx) return;
+		if (confirmCtx.msg.trim() !== "确认") {
+			e.reply("已放弃降级更新。", { reply: true });
+			return;
+		}
+		await installAndRestart(e, remote);
 		return;
 	}
 	const ChangeLogImg = await getChangelogImage(e, {
-		localVersion: Root.pluginVersion,
-		remoteVersion: upd.remote,
+		localVersion: local,
+		remoteVersion: remote,
 		Tip: false,
 		isRemote: true
 	});
 	if (ChangeLogImg) e.reply([segment.text(`${Root.pluginName} 的更新日志：`), ...ChangeLogImg], { reply: true });
 	else e.reply("获取更新日志失败，更新进程继续......", { reply: true });
-	const result = await updatePkg(Root.pluginName);
-	if (result.status === "ok") {
-		const msgResult = await e.reply(`${Root.pluginName} 更新成功！\n${result.local} -> ${result.remote}\n开始执行重启......`);
-		if (msgResult.messageId) try {
-			await db.del(UPDATE_MSGID_KEY);
-			await db.del(UPDATE_LOCK_KEY);
-		} catch {}
-		await restart(e.selfId, e.contact, msgResult.messageId);
-	} else e.reply(`${Root.pluginName} 更新失败: ${result.data ?? "更新执行失败"}`);
+	await installAndRestart(e, remote);
 }, { businessName: "KKK更新" });
-var kkkUpdateCommand = karin.command(/^#?kkk更新$/, handleKkkUpdate, {
+var kkkUpdateCommand = karin.command(/^#?kkk更新(?:\s*(\S+))?$/, handleKkkUpdate, {
 	name: "kkk-更新",
 	perm: "master"
 });