@windcoder/astro-theme-orchid 0.2.1 → 0.4.0

package/src/i18n/ru.ts

@@ -0,0 +1,213 @@
+/**
+ * Русский языковой пакет：Record<UiKey, string> 强制与中文键源一一对应，缺译会在编译期报错。
+ */
+import type { UiKey } from "./zh-CN.js";
+
+const ru: Record<UiKey, string> = {
+	skipToContent: "Перейти к основному содержанию",
+	scrollDown: "Прокрутить вниз",
+	backToTop: "Наверх",
+	mainNav: "Главная навигация",
+	toggleMode: "Переключить тёмную тему",
+	menu: "Меню",
+	palette: "Цвет темы",
+	paletteTitle: "Акцентный цвет",
+	reset: "Сброс",
+	hueValue: "Оттенок {n}",
+	pinned: "Закреплено",
+	wordsCount: "{n} слов",
+	minutesCount: "≈ {n} мин",
+	prevNext: "Предыдущая / следующая",
+	prevPost: "Предыдущая",
+	nextPost: "Следующая",
+	firstPost: "Это самая ранняя запись",
+	lastPost: "Это самая свежая запись",
+	relatedPosts: "Похожие записи",
+	randomPosts: "Случайные записи",
+	smartRecommend: "Умное",
+	randomRecommend: "Случайное",
+	noRelatedPosts: "Нет похожих записей",
+	noRandomPosts: "Нет случайных записей",
+	licensePrefix: "Эта запись распространяется по лицензии",
+	licenseSuffix: ". При перепубликации указывайте автора и первоисточник.",
+	toc: "Оглавление",
+	tocTitle: "Оглавление",
+	pagination: "Постраничная навигация",
+	prevPage: "Назад",
+	nextPage: "Вперёд",
+	pageOf: "Страница {current} из {total}",
+	closeAnnouncement: "Закрыть объявление",
+	closeAd: "Закрыть рекламу",
+	categories: "Категории",
+	tags: "Метки",
+	friendLinks: "Друзья",
+	siteInfo: "О сайте",
+	posts: "Записи",
+	running: "Работает",
+	daysCount: "{n} дн.",
+	dayPostsCount: "{n}",
+	heatWeekTip: "{m}, неделя {w} · {n}",
+	tagsMore: "…ещё",
+	calendarHome: "Текущий месяц",
+	calendarPick: "Выбрать год и месяц",
+	layoutSwitch: "Переключить список / сетку",
+	layoutList: "Список",
+	layoutGrid: "Сетка",
+	emptyPosts: "Записей пока нет. Напишите первую в content/posts.",
+	pageN: "Страница {n}",
+	archive: "Архив",
+	home: "Главная",
+	categoryNav: "Навигация по категориям",
+	more: "Ещё",
+	totalPosts: "Всего записей: {n}",
+	postsInYear: "{n}",
+	yearUnit: "{n} г.",
+	totalTags: "Всего меток: {n}",
+	tagTitle: "Метка: {tag}",
+	totalCategories: "Всего категорий: {n}",
+	categoryTitle: "Категория: {category}",
+	publishedOn: "Опубликовано {date}",
+	updatedOn: "Обновлено {date}",
+	pageviews: "Просмотры",
+	notFound: "Страница не найдена",
+	notFoundDesc: "Страница не существует или была перемещена.",
+	backHome: "На главную",
+	about: "О себе",
+	aboutEmpty: "Напишите эту страницу в src/content/spec/about.md",
+	avatarAlt: "Аватар {name}",
+	noFriends: "Ссылок пока нет",
+	applyFriend: "Заявка на обмен ссылками",
+	/* Страница отслеживания аниме */
+	bangumiEmpty: "Пока ничего не смотрю",
+	bangumiFail:
+		"Не удалось получить данные. Пересоберите сайт и повторите попытку",
+	epProgress: "Серия {n} / {total}",
+	epProgressOpen: "Серия {n}",
+	myRate: "Моя оценка {n}",
+	guestbook: "Гостевая книга",
+	guestbookSub: "Оставьте свой след",
+	commentComingSoon: "Комментарии скоро появятся. Оставайтесь с нами.",
+	qrAlt: "QR-код {name}",
+	goSponsor: "Поддержать",
+	qrPlaceholder: "Заполнитель QR-кода",
+	sponsorList: "Спонсоры",
+	noSponsors: "Пока никто не поддержал. Будьте первым",
+	search: "Поиск",
+	searchShortcut: "Нажмите / или Ctrl+K для поиска",
+	searchLoading: "Поиск…",
+	searchNoResults: "Ничего не найдено",
+	searchUnavailable: "Поисковый индекс доступен после сборки",
+	searchTypeSomething: "Введите ключевые слова",
+	searchMore: "Показать все результаты ({n})",
+	searchResultsTotal: "Результатов: {n}",
+	galleryPhotos: "{n} фото",
+	backToAlbums: "К альбомам",
+	searchAlbums: "Поиск альбомов…",
+	allTags: "Все",
+	galleryNoAlbums:
+		"Альбомов пока нет. Добавьте их в настройках темы gallery.albums.",
+	galleryNoPhotos: "В этом альбоме нет фотографий",
+	/* Страница заметок */
+	momentsTitle: "Заметки",
+	momentsEmpty: "Заметок пока нет.",
+	encryptedAlbum: "Зашифрованный альбом",
+	searchAlbumNoResults: "Подходящих альбомов нет",
+	postEncrypted: "Зашифровано",
+	passwordProtected: "Защита паролем",
+	passwordProtectedDesc:
+		"Содержимое защищено паролем. Введите пароль для просмотра.",
+	passwordHint: "Подсказка",
+	passwordPlaceholder: "Введите пароль",
+	passwordSubmit: "Разблокировать",
+	passwordError: "Неверный пароль, попробуйте снова.",
+	close: "Закрыть",
+	prevImage: "Предыдущее изображение",
+	nextImage: "Следующее изображение",
+	copied: "Скопировано",
+	fullscreen: "Полный экран",
+	slideshow: "Слайдшоу",
+	thumbs: "Миниатюры",
+	/* Постер для-sharing */
+	sharePoster: "Создать постер",
+	generatingPoster: "Создание постера…",
+	copyLink: "Копировать ссылку",
+	savePoster: "Сохранить постер",
+	scanToRead: "Сканируйте, чтобы читать",
+	author: "Автор",
+	supportTitle: "Поддержать",
+	supportDesc:
+		"Если запись была полезной, поддержите автора или поделитесь ею.",
+	sponsorMe: "Поддержать",
+	lastModifiedPrefix: "Последнее обновление: ",
+	lastModifiedDaysAgo: ", {days} дн. назад",
+	lastModifiedOutdated: "Часть информации может быть устаревшей.",
+	/* Серии */
+	series: "Серии",
+	seriesTotal: "Всего серий: {n}",
+	seriesPostsCount: "{n}",
+	seriesUpdated: "Обновлено {date}",
+	seriesEmpty:
+		"Серий пока нет. Заполните поле series в frontmatter записи, чтобы создать.",
+	seriesProgress: "{cur} / {total}",
+	seriesCatalog: "Содержание серии",
+	/* Музыкальный плеер */
+	musicOpen: "Музыкальный плеер",
+	musicClose: "Свернуть плеер",
+	musicPlay: "Воспроизвести",
+	musicPause: "Пауза",
+	musicPrev: "Предыдущий трек",
+	musicNext: "Следующий трек",
+	musicModeList: "По списку",
+	musicModeOne: "Повтор трека",
+	musicModeRandom: "Случайно",
+	musicLyrics: "Текст песни",
+	musicPlaylist: "Плейлист",
+	musicNoLyrics: "Нет текста",
+	musicEmpty: "Плейлист пуст",
+	musicSeek: "Прогресс воспроизведения",
+	musicVolume: "Громкость",
+	l2dHome: "На главную",
+	l2dScrollTop: "Наверх",
+	l2dSleep: "Отдохнуть",
+	l2dSwitchModel: "Сменить модель",
+	/* Сворачивание кода */
+	codeFoldExpand: "Развернуть код",
+	codeFoldCollapse: "Свернуть код",
+	codeFoldExpanded: "Блок кода развёрнут",
+	codeFoldCollapsed: "Блок кода свёрнут",
+	/* Обои */
+	wpPlay: "Воспроизвести видео обоев",
+	wpPause: "Приостановить видео обоев",
+	wpPrev: "Предыдущее видео",
+	wpNext: "Следующее видео",
+	wpMode: "Переключить режим обоев",
+	/* Панель настроек отображения（§4.103）：шестерёнка + три вкладки + группы */
+	displaySettings: "Настройки отображения",
+	tabAppearance: "Внешний вид",
+	tabWallpaper: "Обои",
+	tabEffects: "Эффекты",
+	wallpaperMode: "Режим обоев",
+	modeBanner: "Баннер",
+	modeFullscreen: "Полноэкранные",
+	modeOverlay: "Прозрачный оверлей",
+	modeNone: "Сплошной цвет",
+	fullscreenLayout: "Полноэкранный макет",
+	layoutClassic: "Классический",
+	layoutHero: "Hero",
+	wallpaperSettings: "Настройки обоев",
+	homeWallpaperTitle: "Заголовок на обоях",
+	wallpaperCarousel: "Карусель обоев",
+	wavesAnimation: "Анимация волн",
+	gradientTransition: "Градиентный переход",
+	overlaySettings: "Прозрачность",
+	wallpaperOpacity: "Непрозрачность обоев",
+	backgroundBlur: "Размытие фона",
+	cardOpacity: "Непрозрачность карточек",
+	sakuraEffect: "Эффект сакуры",
+	/* Всего слов в информации о сайте */
+	totalWords: "Всего слов",
+	/* Музыкальный виджет в боковой панели */
+	musicWidget: "Музыка",
+};
+
+export default ru;

package/src/i18n/zh-CN.ts

@@ -6,6 +6,7 @@
 const zhCN = {
 	/* 全局框架（BaseLayout） */
 	skipToContent: "跳到主要内容",
+	scrollDown: "向下滚动",
 	backToTop: "回到顶部",
 	/* Header */
 	mainNav: "主导航",
@@ -90,6 +91,12 @@ const zhCN = {
 	avatarAlt: "{name} 的头像",
 	noFriends: "还没有友链",
 	applyFriend: "申请友链",
+	/* 番组追番页（§4.93） */
+	bangumiEmpty: "还没有在看中的番剧",
+	bangumiFail: "番组数据拉取失败，请重新构建站点后重试",
+	epProgress: "看到 {n} / {total} 集",
+	epProgressOpen: "看到 {n} 集",
+	myRate: "我的评分 {n}",
 	guestbook: "留言板",
 	guestbookSub: "欢迎留下你的足迹",
 	commentComingSoon: "评论区即将开放，敬请期待。",
@@ -105,6 +112,9 @@ const zhCN = {
 	searchNoResults: "没有找到相关结果",
 	searchUnavailable: "搜索索引需构建后可用",
 	searchTypeSomething: "输入关键词开始搜索",
+	/* 独立搜索页（§4.104）：浮层「查看全部」入口 + 结果页计数；分页文案复用 pagination 键 */
+	searchMore: "查看全部 {n} 条结果",
+	searchResultsTotal: "共 {n} 条结果",
 	/* 画廊（M3b-b8）：title/description 走主题配置，这里只放 UI 通用文案 */
 	galleryPhotos: "{n} 张照片",
 	backToAlbums: "返回相册",
@@ -181,6 +191,39 @@ const zhCN = {
 	codeFoldCollapse: "收起代码",
 	codeFoldExpanded: "代码已展开",
 	codeFoldCollapsed: "代码已收起",
+	/* 壁纸（§4.98）：Header 控制按钮 aria-label/title */
+	wpPlay: "播放壁纸视频",
+	wpPause: "暂停壁纸视频",
+	wpPrev: "上一段视频",
+	wpNext: "下一段视频",
+	wpMode: "切换壁纸模式",
+	/* 显示设置面板（§4.103）：齿轮入口 + 三 Tab + 各组控件 */
+	displaySettings: "显示设置",
+	tabAppearance: "外观",
+	tabWallpaper: "壁纸",
+	tabEffects: "特效",
+	wallpaperMode: "壁纸模式",
+	modeBanner: "横幅壁纸",
+	modeFullscreen: "全屏壁纸",
+	modeOverlay: "覆盖透明",
+	modeNone: "纯色背景",
+	fullscreenLayout: "全屏布局",
+	layoutClassic: "经典模式",
+	layoutHero: "Hero 模式",
+	wallpaperSettings: "壁纸设置",
+	homeWallpaperTitle: "首页壁纸标题",
+	wallpaperCarousel: "壁纸轮播",
+	wavesAnimation: "水波纹动画",
+	gradientTransition: "渐变过渡",
+	overlaySettings: "透明设置",
+	wallpaperOpacity: "壁纸透明度",
+	backgroundBlur: "背景模糊度",
+	cardOpacity: "卡片透明度",
+	sakuraEffect: "樱花特效",
+	/* 站点信息总字数（§4.99）：Sidebar siteInfo 卡 */
+	totalWords: "总字数",
+	/* 侧栏音乐 widget（§4.100）：标题；播放/切歌等文案复用 music* 键 */
+	musicWidget: "音乐",
 } as const;
 
 export type UiKey = keyof typeof zhCN;

package/src/i18n/zh-TW.ts

@@ -0,0 +1,208 @@
+/**
+ * 繁体中文语言包：Record<UiKey, string> 强制与中文键源一一对应，缺译会在编译期报错。
+ */
+import type { UiKey } from "./zh-CN.js";
+
+const zhTW: Record<UiKey, string> = {
+	skipToContent: "跳至主要內容",
+	scrollDown: "向下捲動",
+	backToTop: "回到頂端",
+	mainNav: "主導覽",
+	toggleMode: "切換深淺模式",
+	menu: "選單",
+	palette: "調色",
+	paletteTitle: "主題色",
+	reset: "重設",
+	hueValue: "色相 {n}",
+	pinned: "置頂",
+	wordsCount: "{n} 字",
+	minutesCount: "約 {n} 分鐘",
+	prevNext: "上下篇",
+	prevPost: "上一篇",
+	nextPost: "下一篇",
+	firstPost: "已經是最早的一篇",
+	lastPost: "已經是最新的一篇",
+	relatedPosts: "相關文章",
+	randomPosts: "隨機文章",
+	smartRecommend: "智慧推薦",
+	randomRecommend: "隨機推薦",
+	noRelatedPosts: "暫無相關文章",
+	noRandomPosts: "暫無隨機文章",
+	licensePrefix: "本文採用",
+	licenseSuffix: "授權，轉載請註明出處與作者。",
+	toc: "目錄",
+	tocTitle: "目 錄",
+	pagination: "分頁",
+	prevPage: "上一頁",
+	nextPage: "下一頁",
+	pageOf: "第 {current} / {total} 頁",
+	closeAnnouncement: "關閉公告",
+	closeAd: "關閉廣告",
+	categories: "分類",
+	tags: "標籤",
+	friendLinks: "友鏈",
+	siteInfo: "網站資訊",
+	posts: "文章",
+	running: "已運行",
+	daysCount: "{n} 天",
+	dayPostsCount: "{n} 篇",
+	heatWeekTip: "{m}第{w}週 · {n}",
+	tagsMore: "…更多",
+	calendarHome: "回到本月",
+	calendarPick: "選擇年月",
+	layoutSwitch: "切換列表 / 網格檢視",
+	layoutList: "列表檢視",
+	layoutGrid: "網格檢視",
+	emptyPosts: "還沒有文章，去 content/posts 寫一篇吧。",
+	pageN: "第 {n} 頁",
+	archive: "彙整",
+	home: "首頁",
+	categoryNav: "分類導覽",
+	more: "更多",
+	totalPosts: "共 {n} 篇文章",
+	postsInYear: "{n} 篇",
+	yearUnit: "{n} 年",
+	totalTags: "共 {n} 個標籤",
+	tagTitle: "標籤：{tag}",
+	totalCategories: "共 {n} 個分類",
+	categoryTitle: "分類：{category}",
+	publishedOn: "{date} 發布",
+	updatedOn: "{date} 更新",
+	pageviews: "瀏覽量",
+	notFound: "頁面不存在",
+	notFoundDesc: "頁面不存在，或已被移動到別處。",
+	backHome: "返回首頁",
+	about: "關於",
+	aboutEmpty: "在 src/content/spec/about.md 中撰寫本頁內容",
+	avatarAlt: "{name} 的頭像",
+	noFriends: "還沒有友鏈",
+	applyFriend: "申請友鏈",
+	/* 番組追番頁 */
+	bangumiEmpty: "還沒有在看中的番劇",
+	bangumiFail: "番組資料拉取失敗，請重新建置網站後重試",
+	epProgress: "看到 {n} / {total} 集",
+	epProgressOpen: "看到 {n} 集",
+	myRate: "我的評分 {n}",
+	guestbook: "留言板",
+	guestbookSub: "歡迎留下你的足跡",
+	commentComingSoon: "留言區即將開放，敬請期待。",
+	qrAlt: "{name} 收款碼",
+	goSponsor: "前往打賞",
+	qrPlaceholder: "收款碼佔位",
+	sponsorList: "打賞名單",
+	noSponsors: "還沒有打賞，快來做第一個吧",
+	search: "搜尋",
+	searchShortcut: "按 / 或 Ctrl+K 快速搜尋",
+	searchLoading: "搜尋中…",
+	searchNoResults: "沒有找到相關結果",
+	searchUnavailable: "搜尋索引需建置後可用",
+	searchTypeSomething: "輸入關鍵字開始搜尋",
+	searchMore: "查看全部 {n} 筆結果",
+	searchResultsTotal: "共 {n} 筆結果",
+	galleryPhotos: "{n} 張照片",
+	backToAlbums: "返回相簿",
+	searchAlbums: "搜尋相簿…",
+	allTags: "全部",
+	galleryNoAlbums: "還沒有相簿，在主題設定 gallery.albums 中新增。",
+	galleryNoPhotos: "相簿裡還沒有照片",
+	/* 說說頁 */
+	momentsTitle: "說說",
+	momentsEmpty: "還沒有說說。",
+	encryptedAlbum: "加密相簿",
+	searchAlbumNoResults: "沒有符合的相簿",
+	postEncrypted: "已加密",
+	passwordProtected: "密碼保護",
+	passwordProtectedDesc: "此內容已被密碼保護，請輸入密碼查看。",
+	passwordHint: "提示",
+	passwordPlaceholder: "請輸入密碼",
+	passwordSubmit: "解鎖",
+	passwordError: "密碼錯誤，請重試。",
+	close: "關閉",
+	prevImage: "上一張",
+	nextImage: "下一張",
+	copied: "已複製",
+	fullscreen: "全螢幕",
+	slideshow: "自動播放",
+	thumbs: "縮圖列",
+	/* 分享海報 */
+	sharePoster: "產生分享海報",
+	generatingPoster: "海報產生中…",
+	copyLink: "複製連結",
+	savePoster: "儲存海報",
+	scanToRead: "掃碼閱讀全文",
+	author: "作者",
+	supportTitle: "支持一下",
+	supportDesc: "如果這篇文章對你有幫助，歡迎打賞或分享。",
+	sponsorMe: "打賞支持",
+	lastModifiedPrefix: "最後更新於 ",
+	lastModifiedDaysAgo: "，距今已過 {days} 天",
+	lastModifiedOutdated: "部分內容可能已過時，請注意資訊時效。",
+	/* 專題 */
+	series: "專題",
+	seriesTotal: "共 {n} 個專題",
+	seriesPostsCount: "{n} 篇",
+	seriesUpdated: "更新於 {date}",
+	seriesEmpty: "還沒有專題，在文章 frontmatter 中填寫 series 欄位即可建立。",
+	seriesProgress: "{cur} / {total}",
+	seriesCatalog: "專題目錄",
+	/* 音樂播放器 */
+	musicOpen: "音樂播放器",
+	musicClose: "收起播放器",
+	musicPlay: "播放",
+	musicPause: "暫停",
+	musicPrev: "上一首",
+	musicNext: "下一首",
+	musicModeList: "清單循環",
+	musicModeOne: "單曲循環",
+	musicModeRandom: "隨機播放",
+	musicLyrics: "歌詞",
+	musicPlaylist: "播放清單",
+	musicNoLyrics: "暫無歌詞",
+	musicEmpty: "播放清單為空",
+	musicSeek: "播放進度",
+	musicVolume: "音量",
+	l2dHome: "回到首頁",
+	l2dScrollTop: "回到頂端",
+	l2dSleep: "休息一下",
+	l2dSwitchModel: "換個模型",
+	/* 程式碼摺疊 */
+	codeFoldExpand: "展開程式碼",
+	codeFoldCollapse: "收合程式碼",
+	codeFoldExpanded: "程式碼已展開",
+	codeFoldCollapsed: "程式碼已收合",
+	/* 桌布 */
+	wpPlay: "播放桌布影片",
+	wpPause: "暫停桌布影片",
+	wpPrev: "上一段影片",
+	wpNext: "下一段影片",
+	wpMode: "切換桌布模式",
+	/* 顯示設定面板（§4.103）：齒輪入口 + 三 Tab + 各組控制項 */
+	displaySettings: "顯示設定",
+	tabAppearance: "外觀",
+	tabWallpaper: "桌布",
+	tabEffects: "特效",
+	wallpaperMode: "桌布模式",
+	modeBanner: "橫幅桌布",
+	modeFullscreen: "全螢幕桌布",
+	modeOverlay: "覆蓋透明",
+	modeNone: "純色背景",
+	fullscreenLayout: "全螢幕佈局",
+	layoutClassic: "經典模式",
+	layoutHero: "Hero 模式",
+	wallpaperSettings: "桌布設定",
+	homeWallpaperTitle: "首頁桌布標題",
+	wallpaperCarousel: "桌布輪播",
+	wavesAnimation: "水波紋動畫",
+	gradientTransition: "漸變過渡",
+	overlaySettings: "透明設定",
+	wallpaperOpacity: "桌布透明度",
+	backgroundBlur: "背景模糊度",
+	cardOpacity: "卡片透明度",
+	sakuraEffect: "櫻花特效",
+	/* 網站資訊總字數 */
+	totalWords: "總字數",
+	/* 側欄音樂小工具 */
+	musicWidget: "音樂",
+};
+
+export default zhTW;

package/src/index.ts

@@ -41,6 +41,7 @@ import {
 	rehypeExternalLinks,
 	rehypeFigure,
 	rehypeFirstImage,
+	rehypeImageEnhance,
 	rehypeNoReferrer,
 } from "./plugins/rehype.js";
 import {
@@ -59,6 +60,7 @@ import { remarkReadingTime } from "./plugins/remark-reading-time.js";
 import { type ThemeConfig, themeConfigSchema } from "./schema.js";
 import {
 	overridesPlugin,
+	pagefindDevPlugin,
 	themeConfigPlugin,
 	themeLqipsPlugin,
 } from "./vite.js";
@@ -128,6 +130,8 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 					rehypeExternalLinks,
 					// 图片防盗链（§4.87）：命中域名外链图加 no-referrer（domains 空时插件空转）
 					[rehypeNoReferrer, { domains: config.noReferrer.domains }],
+					// 正文图片增强（§4.106）：lazy/decoding 注入 + public 图 LQIP 渐变背景
+					rehypeImageEnhance,
 					rehypeCallouts,
 					rehypeFigure,
 					rehypeFirstImage,
@@ -310,6 +314,8 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 					["/", "index.astro"],
 					["/page/[page]", "page/[page].astro"],
 					["/archive", "archive.astro"],
+					// 独立搜索页（§4.104）：浮层「查看全部」入口的目标页，客户端查询分页
+					["/search", "search.astro"],
 					["/tags", "tags/index.astro"],
 					// §4.87 分类/标签分页：第一页 /tags/<tag>/（page 段省略），后续 /2/ 起
 					["/tags/[tag]/[...page]", "tags/[tag]/[...page].astro"],
@@ -344,6 +350,10 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 				if (config.pages.moments) {
 					routes.push(["/moments/[...page]", "moments/[...page].astro"]);
 				}
+				// 番组追番页（§4.93）：构建期拉 bgm.tv「在看」收藏；enabled + userId 双条件才注入
+				if (config.bangumi.enabled && config.bangumi.userId.trim()) {
+					routes.push(["/bangumi", "bangumi.astro"]);
+				}
 				// 相关/随机文章推荐（P1-12）：随机栏数据源
 				if (config.relatedPosts.enabled) {
 					routes.push(["/api/allPostMeta.json", "api/allPostMeta.json.ts"]);
@@ -352,6 +362,12 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 				if (config.og.enabled) {
 					routes.push(["/og/[...slug]", "og/[...slug].ts"]);
 				}
+				// PWA（§4.95）：manifest 与 Service Worker 为构建期生成的端点，enabled 才注入；
+				// head 里的 manifest 链接与 SW 注册脚本由 BaseLayout 按 pwa.enabled 输出
+				if (config.pwa.enabled) {
+					routes.push(["/manifest.webmanifest", "manifest.webmanifest.ts"]);
+					routes.push(["/sw.js", "sw.js.ts"]);
+				}
 				for (const [pattern, file] of routes) {
 					injectRoute({
 						pattern,
@@ -368,6 +384,9 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 							themeConfigPlugin(config),
 							themeLqipsPlugin(),
 							overridesPlugin(),
+							// dev 下把 dist/pagefind 经前置中间件直接服务（astro-pagefind
+							// 同款方案），开发期无需构建即可搜索；索引缺失时放行走 404
+							pagefindDevPlugin(),
 						],
 					},
 				});
@@ -385,6 +404,10 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 						`  const lqips: Record<string, string>;`,
 						`  export default lqips;`,
 						`}`,
+						`declare module 'virtual:theme/thumbs' {`,
+						`  const thumbs: Record<string, { thumb: string; width: number; height: number }>;`,
+						`  export default thumbs;`,
+						`}`,
 						`declare module 'virtual:theme/*' {`,
 						`  const Component: any;`,
 						`  export default Component;`,

package/src/plugins/rehype.ts

@@ -1,13 +1,17 @@
 /**
  * rehype 插件集（M3a，全部零依赖手写 hast 遍历）
  *
- * 挂载顺序（index.ts）：externalLinks → callouts → figure → firstImage → anchor
+ * 挂载顺序（index.ts）：externalLinks → noReferrer → imageEnhance → callouts
+ *   → figure → firstImage → anchor
  * 代码块渲染自 §4.61 起由 Expressive Code 接管（index.ts 直连 rehype 内核），
  * 本文件不再包含代码块插件。
  * 注意：hast 节点类名有两种形态——shiki/EC 产出用 HTML 属性名直接写 properties
  * （class 为字符串而非 className 数组）；remark-rehype 原始节点则是 className
  * 数组。读取类名务必走 getClassList 兼容两种形态。
  */
+import fs from "node:fs";
+import path from "node:path";
+
 type Transformer = (tree: any, file: any) => void;
 
 /** 浅遍历辅助：对 node.children 逐个调用 fn，fn 可通过返回 'skip' 跳过子树 */
@@ -35,12 +39,20 @@ function getClassList(props: any): string[] {
 /* ---------------------------------------------------------------- 外链 */
 
 /**
- * 外链新窗口打开：http(s) 绝对链接追加 target="_blank" rel="noopener noreferrer"
+ * 外链新窗口打开：http(s) 绝对链接追加 target="_blank" rel="noopener noreferrer"；
+ * 外链 <img> 追加 data-external 标记（暗色外链图适配 §4.89 的 CSS 挂点，标记本身零副作用）
  */
 export function rehypeExternalLinks(): Transformer {
 	return (tree) => {
 		visit(tree, (node) => {
-			if (node.type !== "element" || node.tagName !== "a") return;
+			if (node.type !== "element") return;
+			if (node.tagName === "img") {
+				if (/^https?:\/\//i.test(String(node.properties?.src ?? ""))) {
+					node.properties["data-external"] = "true";
+				}
+				return;
+			}
+			if (node.tagName !== "a") return;
 			const href = String(node.properties?.href ?? "");
 			if (!/^https?:\/\//i.test(href)) return;
 			node.properties.target = "_blank";
@@ -225,7 +237,67 @@ export function rehypeCallouts(): Transformer {
 	};
 }
 
-/* ---------------------------------------------------------------- figure */
+/* -------------------------------------------------------- 正文图片增强 */
+
+/**
+ * 正文图片增强（§4.106；§4.107 扩展外链）：
+ * 1. 注入 loading="lazy" + decoding="async"（已有值不覆盖——作者显式声明优先）；
+ * 2. 图片注入 LQIP 渐变背景：直接内联在 img style 上，图片加载后位图自然
+ *    盖住渐变，无需 wrapper 结构与客户端 JS。本地 public 图（src 以 / 开头）
+ *    查 `public:` 键，外链图（http(s) 绝对 URL）查 `url:` 键——键规则与
+ *    scripts/generate-lqips.mjs 一致，外链 URL 须与渲染期逐字符一致。
+ * lqips.json 读站点根（file.cwd）并模块级缓存——rehype transformer 运行于
+ * 纯 Node，拿不到 vite 虚拟模块；缓存按构建进程生命周期，dev 下改 lqips.json
+ * 需重启 dev server（与 vite 插件 configResolved 的读取时机一致）。
+ */
+let lqipTable: Record<string, string> | null = null;
+
+function loadLqipTable(cwd: string): Record<string, string> {
+	if (lqipTable) return lqipTable;
+	// content layer 的 VFile cwd 不一定是站点根，依次尝试 file.cwd 与 process.cwd()
+	for (const dir of [cwd, process.cwd()]) {
+		try {
+			lqipTable = JSON.parse(
+				fs.readFileSync(path.join(dir, "lqips.json"), "utf8"),
+			);
+			break;
+		} catch {
+			/* 目录不对，尝试下一个 */
+		}
+	}
+	lqipTable ??= {};
+	return lqipTable;
+}
+
+/** src → lqips.json 键（本地 public: 前缀 / 外链 url: 前缀），非两者返回 null */
+function lqipKey(src: string): string | null {
+	if (src.startsWith("/")) return `public:${src.replace(/^\//, "")}`;
+	if (/^https?:\/\//i.test(src)) return `url:${src}`;
+	return null;
+}
+
+export function rehypeImageEnhance(): Transformer {
+	return (tree, file) => {
+		const lqips = loadLqipTable(String(file.cwd ?? ""));
+		visit(tree, (node) => {
+			if (node.type !== "element" || node.tagName !== "img") return;
+			node.properties.loading ??= "lazy";
+			node.properties.decoding ??= "async";
+			const src = String(node.properties.src ?? "");
+			const key = lqipKey(src);
+			if (!key) return;
+			const hex = lqips[key];
+			if (!hex || !/^[0-9a-f]{18}$/i.test(hex)) return;
+			const grad = `linear-gradient(135deg, #${hex.slice(0, 6)} 0%, #${hex.slice(6, 12)} 50%, #${hex.slice(12, 18)} 100%)`;
+			const style = String(node.properties.style ?? "");
+			node.properties.style = style
+				? `${style};background:${grad}`
+				: `background:${grad}`;
+		});
+	};
+}
+
+/* -------------------------------------------------------------- figure */
 
 /**
  * 独立段落中的单图 → <figure>；img 的 title 属性 → <figcaption>。