@windcoder/astro-theme-orchid 0.4.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@windcoder/astro-theme-orchid",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"description": "清新简约的 Astro 博客主题，以 Integration 形式提供，支持版本化升级与组件覆盖",
 	"type": "module",
 	"keywords": [

package/scripts/generate-lqips.mjs

@@ -169,8 +169,10 @@ function collectRemoteUrls() {
 		const walkMd = (dir) => {
 			const out = [];
 			for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-				if (entry.isDirectory()) out.push(...walkMd(path.join(dir, entry.name)));
-				else if (/\.(md|mdx)$/i.test(entry.name)) out.push(path.join(dir, entry.name));
+				if (entry.isDirectory())
+					out.push(...walkMd(path.join(dir, entry.name)));
+				else if (/\.(md|mdx)$/i.test(entry.name))
+					out.push(path.join(dir, entry.name));
 			}
 			return out;
 		};
@@ -229,7 +231,9 @@ async function mapPool(items, limit, fn) {
 			try {
 				out[idx] = await fn(items[idx]);
 			} catch (err) {
-				console.warn(`[lqip] 外链抓取失败，跳过: ${items[idx]} — ${err.message}`);
+				console.warn(
+					`[lqip] 外链抓取失败，跳过: ${items[idx]} — ${err.message}`,
+				);
 			}
 		}
 	}
@@ -282,11 +286,12 @@ try {
 
 	fs.writeFileSync(
 		lqipFile,
-		JSON.stringify(Object.fromEntries(lqipEntries), null, 2) + "\n",
+		// tab 缩进与 Biome format 一致：生成物入库即合规，重跑不会反复触发 CI format 报错
+		JSON.stringify(Object.fromEntries(lqipEntries), null, "\t") + "\n",
 	);
 	fs.writeFileSync(
 		thumbsFile,
-		JSON.stringify(Object.fromEntries(thumbEntries), null, 2) + "\n",
+		JSON.stringify(Object.fromEntries(thumbEntries), null, "\t") + "\n",
 	);
 	console.log(
 		`[lqip] public ${files.length} 张 + 外链 ${remoteUrls.length - pending.length + fetched.filter(Boolean).length} 条 → ${path.relative(cwd, lqipFile)} + ${path.relative(cwd, thumbsFile)}`,

package/src/components/BaseLayout.astro

@@ -97,7 +97,8 @@ const staticSub = typerOn ? "" : wpSubs.length ? wpPick(wpSubs) : "";
 const heroTitle = isActualHome ? homeText.title : title;
 const heroSub = isActualHome ? staticSub : "";
 const heroTyperOn = isActualHome && typerOn;
-const heroInStage = Boolean(stageMode) && (isActualHome ? hasHeroText : Boolean(title));
+const heroInStage =
+	Boolean(stageMode) && (isActualHome ? hasHeroText : Boolean(title));
 /* 底部装饰分端归一化：布尔简写展开为两端同值 */
 const wpWaves =
 	typeof wp.common.waves === "boolean"

package/src/components/PostCard.astro

@@ -1,6 +1,7 @@
 ---
 import config from "virtual:theme/config";
 import { t } from "../i18n/index.js";
+import { resolveSiteImage } from "../utils/image.js";
 import { getLqipStyle } from "../utils/lqip.js";
 import { getThumbInfo } from "../utils/thumb.js";
 import { formatDate, type PostLike, resolveCover } from "../utils.js";
@@ -25,7 +26,10 @@ const { cover: rawCover, retries } = resolveCover(
 	config.postList.randomCover.apis,
 	post.id,
 );
-const cover = config.postList.showCover ? rawCover : null;
+/* §4.110：封面三格式统一语义（对齐 §4.108 其余消费点）——相对路径（站点 src/
+   下）构建期解析为产物 URL，public / 外链原样直通 */
+const resolvedCover = rawCover ? await resolveSiteImage(rawCover) : rawCover;
+const cover = config.postList.showCover ? resolvedCover : null;
 /* §4.106：列表封面用缩略图（外链/未命中自动回退原图；点击进文章页看正文原图） */
 const thumb = cover ? getThumbInfo(cover) : null;
 const classes = [

package/src/index.ts

@@ -257,6 +257,17 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 				updateConfig({
 					// 主题路由全部按尾斜杠组织（如 /posts/xxx/），统一强制，dev 与 prod 行为一致
 					trailingSlash: "always",
+					// 尾斜杠强制的连带修复（§4.109）：trailingSlash:"always" 会把 astro
+					// 内部图片端点 /_image 的注册 pattern 变成 ^/_image/$（routing/pattern.js
+					// getPattern 按 trailingSlash 生成），而图片服务生成的 URL 恒为
+					// /_image?href=...（assets/services/service.js getURL 不加尾斜杠），
+					// 两者永远匹配不上 → dev 下 /_image 全量 404（落到 404 兜底页，
+					// 头像/md 内联图/封面等所有走图片管线的图全部裂图）。
+					// 端点路由改为带尾斜杠的 /_image/：注册 pattern（parseRoute 对
+					// "/_image/" 同样生成 ^/_image/$）与生成 URL（getURL 直接取本配置
+					// 拼 query）自动同步；parseURL 只读 query 不看 pathname，不受影响。
+					// 静态构建不走该端点（构建期直接编码出图），仅影响 dev/SSR 行为。
+					image: { endpoint: { route: "/_image/" } },
 					vite: {
 						plugins: [tailwindcss()],
 						// 构建优化说明（§4.63）：参考站的 vite.build 块（minify:"esbuild"、

package/src/routes/posts/[...slug].astro

@@ -15,6 +15,7 @@ import Sidebar from "virtual:theme/components/Sidebar.astro";
 import Toc from "virtual:theme/components/Toc.astro";
 import config from "virtual:theme/config";
 import { t } from "../../i18n/index.js";
+import { resolveSiteImage } from "../../utils/image.js";
 import { getLqipStyle } from "../../utils/lqip.js";
 import { getRelatedPosts } from "../../utils/related.js";
 import {
@@ -98,14 +99,18 @@ export async function getStaticPaths() {
 
 const { post, prev, next, related, posts, seriesInfo } = Astro.props;
 const d = post.data;
-/* 封面解析（§4.33）：image:"api" 时取确定性随机图；figure 与分享海报共用同一 URL */
-const { cover: articleCover, retries: coverRetries } = resolveCover(
+/* 封面解析（§4.33）：image:"api" 时取确定性随机图；figure 与分享海报共用同一 URL。
+   §4.110：三格式统一语义（同 PostCard）——相对路径构建期解析为产物 URL */
+const { cover: rawArticleCover, retries: coverRetries } = resolveCover(
 	d.image,
 	d.firstImage,
 	config.postList.fallbackCover,
 	config.postList.randomCover.apis,
 	post.id,
 );
+const articleCover = rawArticleCover
+	? await resolveSiteImage(rawArticleCover)
+	: rawArticleCover;
 const { Content, headings, remarkPluginFrontmatter } = await render(post);
 const { words, minutes } = remarkPluginFrontmatter as {
 	words?: number;

package/src/schema.ts

@@ -42,7 +42,8 @@ const sidebarWidgetBase = z.object({
  * 四种模式 html[data-wallpaper-mode] 驱动：banner 横幅 / fullscreen 全屏首屏 /
  * overlay 覆盖透明垫底 / none 纯色不渲染。
  * 图源遵循三格式约定（§4.97）："/" 开头按 public 路径原样输出；http(s)://、//、data:
- * 外链原样输出；其余相对路径相对站点 src/ 目录解析（构建期查表，支持 assets 内图片）。
+ * 外链原样输出；其余相对路径相对站点 src/ 目录解析（构建期查表，支持图片/视频，
+ * §4.108：不写死 assets/ 前缀）。
  * 提取为模块级 const 以便使用函数默认值 .default(() => wallpaperSchema.parse({}))：
  * Zod 的 .default(x) 在输入缺失时直接取 x、不做二次 parse（v3/v4 行为一致），
  * 本段嵌套深达 4 层，最外层再写一份完整字面量维护成本过高；改用 parse({}) 在

package/src/scripts/app.ts

@@ -196,7 +196,10 @@ async function initLightbox() {
 		   优先打开原图；无数据时沿用 img 自身 src 与 natural 尺寸 */
 		if (img.dataset.fullSrc) {
 			itemData.src = img.dataset.fullSrc;
-			if (Number(img.dataset.fullWidth) > 0 && Number(img.dataset.fullHeight) > 0) {
+			if (
+				Number(img.dataset.fullWidth) > 0 &&
+				Number(img.dataset.fullHeight) > 0
+			) {
 				itemData.width = Number(img.dataset.fullWidth);
 				itemData.height = Number(img.dataset.fullHeight);
 			}
@@ -685,13 +688,16 @@ function pagerNums(page: number, total: number): Array<number | "ellipsis"> {
 
 function searchPageHref(q: string, page: number): string {
 	return (
-		"/search/?q=" +
-		encodeURIComponent(q) +
-		(page > 1 ? "&page=" + page : "")
+		"/search/?q=" + encodeURIComponent(q) + (page > 1 ? "&page=" + page : "")
 	);
 }
 
-function renderSearchPager(pager: HTMLElement, q: string, cur: number, pages: number) {
+function renderSearchPager(
+	pager: HTMLElement,
+	q: string,
+	cur: number,
+	pages: number,
+) {
 	if (pages <= 1) {
 		pager.hidden = true;
 		return;
@@ -712,7 +718,8 @@ function renderSearchPager(pager: HTMLElement, q: string, cur: number, pages: nu
 		s.textContent = label;
 		return s;
 	};
-	if (cur > 1) nums.appendChild(mk(searchPageHref(q, cur - 1), "‹", "page-item"));
+	if (cur > 1)
+		nums.appendChild(mk(searchPageHref(q, cur - 1), "‹", "page-item"));
 	else nums.appendChild(span("‹"));
 	for (const n of pagerNums(cur, pages)) {
 		if (n === "ellipsis") {
@@ -730,19 +737,22 @@ function renderSearchPager(pager: HTMLElement, q: string, cur: number, pages: nu
 			nums.appendChild(mk(searchPageHref(q, n), String(n), "page-item"));
 		}
 	}
-	if (cur < pages) nums.appendChild(mk(searchPageHref(q, cur + 1), "›", "page-item"));
+	if (cur < pages)
+		nums.appendChild(mk(searchPageHref(q, cur + 1), "›", "page-item"));
 	else nums.appendChild(span("›"));
 
 	const adj = doc.createElement("div");
 	adj.className = "pg-adj";
-	if (cur > 1) adj.appendChild(mk(searchPageHref(q, cur - 1), ui("prevPage"), "pg-prev"));
+	if (cur > 1)
+		adj.appendChild(mk(searchPageHref(q, cur - 1), ui("prevPage"), "pg-prev"));
 	else adj.appendChild(span(ui("prevPage")));
 	const mid = doc.createElement("span");
 	mid.textContent = ui("pageOf")
 		.replace("{current}", String(cur))
 		.replace("{total}", String(pages));
 	adj.appendChild(mid);
-	if (cur < pages) adj.appendChild(mk(searchPageHref(q, cur + 1), ui("nextPage"), "pg-next"));
+	if (cur < pages)
+		adj.appendChild(mk(searchPageHref(q, cur + 1), ui("nextPage"), "pg-next"));
 	else adj.appendChild(span(ui("nextPage")));
 
 	pager.replaceChildren(nums, adj);
@@ -750,7 +760,9 @@ function renderSearchPager(pager: HTMLElement, q: string, cur: number, pages: nu
 
 async function renderSearchPage() {
 	const seq = ++searchPageSeq;
-	const input = doc.getElementById("searchPageInput") as HTMLInputElement | null;
+	const input = doc.getElementById(
+		"searchPageInput",
+	) as HTMLInputElement | null;
 	const meta = doc.getElementById("searchPageMeta");
 	const box = doc.getElementById("searchPageResults");
 	const pager = doc.getElementById("searchPagePager");

package/src/styles/global.css

@@ -710,7 +710,9 @@ html.dark #modeToggle .i-sun {
 	border-radius: 12px;
 	background: var(--surface);
 	color: var(--muted);
-	transition: border-color 0.15s, color 0.15s;
+	transition:
+		border-color 0.15s,
+		color 0.15s;
 }
 .search-page-bar:focus-within {
 	border-color: var(--accent-ink);
@@ -790,7 +792,9 @@ html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home]):not(
 	height: var(--banner-h, 60vh);
 	margin-top: calc(-1 * var(--header-h));
 }
-html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout="hero"]
+html[data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-is-home]
+	)[data-wp-fs-layout="hero"]
 	.wp-stage {
 	position: fixed;
 	inset: 0;
@@ -886,7 +890,9 @@ html[data-wallpaper-mode="fullscreen"][data-wp-is-home] .wp-img {
 /* overlay 形态的图片模糊/放大补偿（服务端算好 scale 防边缘露底），与 body 级旧口径一致；
    非首页 fullscreen-hero 降级为 overlay，复用同一套模糊参数 */
 html[data-wallpaper-mode="overlay"] .wp-img,
-html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout="hero"]
+html[data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-is-home]
+	)[data-wp-fs-layout="hero"]
 	.wp-img {
 	filter: blur(var(--wp-overlay-blur, 0px));
 	transform: scale(var(--wp-overlay-scale, 1));
@@ -1119,7 +1125,8 @@ html[data-wallpaper-mode="fullscreen"][data-wp-is-home] .wp-scroll-hint {
 }
 /* hero 布局：stage fixed 且 pointer-events:none，箭头需单独恢复可点击；
    滚动后随 .wp-hero 同步淡出 */
-html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"] .wp-scroll-hint {
+html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"]
+.wp-scroll-hint {
 	pointer-events: auto;
 }
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"].wp-scrolled
@@ -1169,7 +1176,7 @@ html[data-wallpaper-mode="overlay"] .card {
    classic 滚下后正文区纯色背景（旧行为，无需额外规则）。
    首屏两种布局一致：壁纸占满一屏 + 中央 hero 文案。 */
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
-	.wp-stage {
+.wp-stage {
 	position: fixed;
 	inset: 0;
 	height: auto;
@@ -1180,15 +1187,14 @@ html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home
 /* 首屏让给 hero：正文流向下推一屏，滚上后覆盖 fixed 壁纸；
    stage 隐藏（homeOnly 非首页 / JS 切走）时取消下推，避免顶部整屏空白 */
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]:not(
-		[data-wp-stage-hidden]
-	)
-	.site-main {
+	[data-wp-stage-hidden]
+) .site-main {
 	margin-top: 100vh;
 }
 /* hero 交互：fixed 后 pointer-events 被关，hero 文案纯展示无需点击（打字机亦然） */
 /* hero 文字滚动淡出：滚离首屏后标题/副标题渐隐，不盖在正文区模糊壁纸上 */
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
-	.wp-hero {
+.wp-hero {
 	transition: opacity 0.5s ease;
 }
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home].wp-scrolled
@@ -1198,7 +1204,7 @@ html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home
 /* 滚动模糊过渡：滚过 40px（html.wp-scrolled，app.ts updateWallpaperScroll）后
    壁纸加模糊 + 放大补偿 + 底部渐隐蒙层加深，保证模糊渐变在 blur=0 时也可见 */
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
-	.wp-img {
+.wp-img {
 	transition:
 		opacity 0.8s ease,
 		transform 0.8s ease,
@@ -1228,16 +1234,22 @@ html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home
    文章列表 .post-card 与分页 .page-item 不走 .card 类，需一并覆盖；
    非首页 fullscreen-hero 降级为 overlay，同样需要半透明卡片 */
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
-	.card,
+.card,
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
 	.post-card,
 html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"][data-wp-is-home]
 	.page-item,
-html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout="hero"]
+html[data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-is-home]
+	)[data-wp-fs-layout="hero"]
 	.card,
-html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout="hero"]
+html[data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-is-home]
+	)[data-wp-fs-layout="hero"]
 	.post-card,
-html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout="hero"]
+html[data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-is-home]
+	)[data-wp-fs-layout="hero"]
 	.page-item {
 	background: color-mix(
 		in srgb,
@@ -1258,7 +1270,9 @@ html[data-wallpaper-mode="fullscreen"]:not([data-wp-is-home])[data-wp-fs-layout=
    文字职责交还内容区标题（.page-title/.post-title-lg 等，见下方规则） */
 html[data-wallpaper-mode="overlay"] .wp-hero,
 html[data-wallpaper-mode="none"] .wp-hero,
-html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"]:not([data-wp-is-home])
+html[data-wallpaper-mode="fullscreen"][data-wp-fs-layout="hero"]:not(
+		[data-wp-is-home]
+	)
 	.wp-hero {
 	display: none;
 }
@@ -1272,10 +1286,22 @@ html[data-wp-hero="visible"][data-wallpaper-mode="banner"] .page-title,
 html[data-wp-hero="visible"][data-wallpaper-mode="banner"] .page-sub,
 html[data-wp-hero="visible"][data-wallpaper-mode="banner"] .post-title-lg,
 html[data-wp-hero="visible"][data-wallpaper-mode="banner"] .archive-head,
-html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not([data-wp-fs-layout="hero"]) .page-title,
-html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not([data-wp-fs-layout="hero"]) .page-sub,
-html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not([data-wp-fs-layout="hero"]) .post-title-lg,
-html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not([data-wp-fs-layout="hero"]) .archive-head {
+html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-fs-layout="hero"]
+	)
+	.page-title,
+html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-fs-layout="hero"]
+	)
+	.page-sub,
+html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-fs-layout="hero"]
+	)
+	.post-title-lg,
+html[data-wp-hero="visible"][data-wallpaper-mode="fullscreen"]:not(
+		[data-wp-fs-layout="hero"]
+	)
+	.archive-head {
 	display: none;
 }
 html[data-wp-waves="off"] .wp-waves {

package/src/utils/image.ts

@@ -6,19 +6,21 @@
  *    构建期解析，且经 sharp image service 重编码（默认 webp + 压缩，
  *    §4.106 升级），返回优化产物 URL（唯一被优化的格式）。
  *
- * 解析机制：import.meta.glob("/src/assets/...") 的 `/` 前缀相对 Vite 项目根，
- * 主题包组件运行在站点构建管线中，因此命中站点项目的 src/assets；
- * 非 eager 按需 await，仅实际用到的图片进入构建产物。
+ * 解析机制：import.meta.glob 匹配站点根下 src 全目录的媒体扩展名，`/` 前缀
+ * 相对 Vite 项目根，主题包组件运行在站点构建管线中，因此命中站点项目的 src/
+ * （§4.108：不写死 assets/ 前缀，src 下任意目录的图片/视频均可解析；
+ * ⚠️ 本段注释不可出现 glob 的双星斜杠字面量——含块注释终止符子串会提前闭合）；
+ * 非 eager 按需 await，仅实际用到的媒体进入构建产物。
  * svg（矢量）与 gif（动图）不做 sharp 编码——转码会破坏矢量/动画，原样输出。
  * ico 不参与 glob（favicon 走 public / 远程，无优化需求）。
  */
 
 import { getImage, type ImageMetadata } from "astro:assets";
 
-/** glob 命中的资源元数据 */
-type AssetMeta = ImageMetadata;
+/** glob 命中的资源元数据：图片为 ImageMetadata，视频等为产物 URL 字符串 */
+type AssetMeta = ImageMetadata | string;
 
-/** 三格式判定：true = 相对 src/ 的本地资源（需构建期解析） */
+/** 三格式判定：true = 相对 src/ 的本地媒体资源（需构建期解析） */
 export function isLocalImagePath(src: string): boolean {
 	if (!src) return false;
 	return !(
@@ -30,21 +32,26 @@ export function isLocalImagePath(src: string): boolean {
 	);
 }
 
-/** 相对路径 → glob key："assets/avatar.png" → "/src/assets/avatar.png" */
+/**
+ * 相对路径 → glob key：不写死 assets/ 前缀（§4.108），相对路径不加 `/` 即
+ * 相对站点 src/ 目录——"assets/images/avatar.png" → /src/assets/images/avatar.png，
+ * "styles/x.svg" → /src/styles/x.svg，src 下任意目录均可解析。
+ */
 export function toAssetKey(src: string): string {
-	return `/src/assets/${src.replace(/^\.?\//, "")}`;
+	return `/src/${src.replace(/^\.?\//, "")}`;
 }
 
 type AssetModules = Record<string, () => Promise<AssetMeta>>;
 
 /**
- * 解析单张站点图片为可直接用于 <img src> 的 URL。
+ * 解析单张站点静态媒体（图片/视频）为可直接引用的 URL。
  * public / 外链原样返回；相对路径查 glob 表，命中则 await 产物元数据；
  * 未命中（文件不存在）时 console.warn 并原样返回，页面不断构建。
  *
  * §4.106：位图（png/jpg/webp/avif）额外经 getImage() 走 sharp image service
  * 构建期重编码（默认转 webp + 质量压缩，Astro 同图同参有编码缓存）；
  * svg/gif 保持原始产物 URL 不转码。失败时降级原样返回，页面不断构建。
+ * §4.108：视频（mp4/webm/mov）glob 导出为产物 URL 字符串，直接返回。
  *
  * 注意：import.meta.glob 第一参数必须是字符串字面量（vite 编译期静态分析，
  * 变量/常量在 dev 下直接报 Invalid glob import syntax），模式不能提取为常量。
@@ -52,23 +59,27 @@ type AssetModules = Record<string, () => Promise<AssetMeta>>;
 export async function resolveSiteImage(src: string): Promise<string> {
 	if (!isLocalImagePath(src)) return src;
 	const modules = import.meta.glob(
-		"/src/assets/**/*.{png,jpg,jpeg,webp,avif,gif,svg}",
+		"/src/**/*.{png,jpg,jpeg,webp,avif,gif,svg,mp4,webm,mov}",
 		{ import: "default" },
 	) as unknown as AssetModules;
 	const loader = modules[toAssetKey(src)];
 	if (!loader) {
 		console.warn(
-			`[orchid-theme] 图片未找到: ${toAssetKey(src)}（相对站点 src/ 目录解析）`,
+			`[orchid-theme] 媒体文件未找到: ${toAssetKey(src)}（相对路径不带 / 时相对站点 src/ 目录解析）`,
 		);
 		return src;
 	}
 	const meta = await loader();
+	if (typeof meta === "string") return meta;
 	if (meta.format === "svg" || meta.format === "gif") return meta.src;
 	try {
 		const encoded = await getImage({ src: meta });
 		return encoded.src;
 	} catch (err) {
-		console.warn(`[orchid-theme] 图片优化失败，回退原图: ${toAssetKey(src)}`, err);
+		console.warn(
+			`[orchid-theme] 图片优化失败，回退原图: ${toAssetKey(src)}`,
+			err,
+		);
 		return meta.src;
 	}
 }

package/src/utils/thumb.ts

@@ -20,7 +20,12 @@ export interface ThumbInfo {
 export function getThumbInfo(src: string): ThumbInfo {
 	const hit = thumbs[`public:${src.replace(/^\//, "")}`];
 	if (hit?.thumb && hit.width > 0 && hit.height > 0) {
-		return { full: src, src: `/${hit.thumb}`, width: hit.width, height: hit.height };
+		return {
+			full: src,
+			src: `/${hit.thumb}`,
+			width: hit.width,
+			height: hit.height,
+		};
 	}
 	return { full: src, src };
 }