@windcoder/astro-theme-orchid 0.2.0 → 0.3.0

package/src/components/analytics/WebVitals.astro

@@ -0,0 +1,72 @@
+---
+/**
+ * Web Vitals 通用上报（§4.91）：与统计厂商无关的 Core Web Vitals 采集。
+ * Google 官方 web-vitals 库经 Astro bundled script 打包（约 2KB gzip），
+ * LCP/CLS/INP/FCP/TTFB 五指标就绪即上报。
+ * 载荷以 text/plain 载 JSON 经 sendBeacon 发送（CORS 安全清单类型，免预检），
+ * sendBeacon 排队失败回退 fetch keepalive。endpoint 留空由 Analytics.astro 门控不注入。
+ * 配置经 DOM data 属性传入（bundled script 无 define:vars，SakuraEffect 同款惯例）。
+ */
+interface Props {
+	/** 上报端点（POST） */
+	endpoint: string;
+	/** 站点标识 */
+	siteId?: string;
+	/** 采样率 0~1 */
+	sampleRate?: number;
+	/** 控制台打印载荷（调试） */
+	debug?: boolean;
+}
+
+const { endpoint, siteId = "", sampleRate = 1, debug = false } = Astro.props;
+---
+
+<div
+	id="orchid-webvitals"
+	data-endpoint={endpoint}
+	data-site-id={siteId}
+	data-sample-rate={sampleRate}
+	data-debug={debug ? "true" : undefined}
+	hidden
+></div>
+
+<script>
+	import { onCLS, onFCP, onINP, onLCP, onTTFB, type Metric } from "web-vitals";
+
+	const el = document.getElementById("orchid-webvitals");
+	const endpoint = el?.dataset.endpoint ?? "";
+	const siteId = el?.dataset.siteId ?? "";
+	const sampleRate = Number(el?.dataset.sampleRate ?? 1);
+	const debug = el?.dataset.debug === "true";
+
+	if (endpoint && Math.random() < sampleRate) {
+		const send = (metric: Metric) => {
+			const payload = JSON.stringify({
+				name: metric.name,
+				value: Math.round(metric.value),
+				rating: metric.rating,
+				delta: Math.round(metric.delta),
+				id: metric.id,
+				navType: metric.navigationType ?? "",
+				path: location.pathname,
+				site: siteId,
+			});
+			if (debug) console.log("[web-vitals]", payload);
+			const blob = new Blob([payload], { type: "text/plain;charset=UTF-8" });
+			if (!navigator.sendBeacon(endpoint, blob)) {
+				// 排队失败（页面卸载瞬间的兜底）
+				fetch(endpoint, {
+					method: "POST",
+					body: payload,
+					keepalive: true,
+					headers: { "content-type": "text/plain;charset=UTF-8" },
+				}).catch(() => {});
+			}
+		};
+		onCLS(send);
+		onFCP(send);
+		onINP(send);
+		onLCP(send);
+		onTTFB(send);
+	}
+</script>

package/src/i18n/en.ts

@@ -77,6 +77,12 @@ const en: Record<UiKey, string> = {
 	avatarAlt: "Avatar of {name}",
 	noFriends: "No friend links yet",
 	applyFriend: "Apply for a link",
+	/* Bangumi watching page (§4.93) */
+	bangumiEmpty: "Nothing being watched yet",
+	bangumiFail: "Failed to fetch Bangumi data. Rebuild the site to retry.",
+	epProgress: "Ep. {n} / {total}",
+	epProgressOpen: "Ep. {n}",
+	myRate: "My rating {n}",
 	guestbook: "Guestbook",
 	guestbookSub: "Leave your trace here",
 	commentComingSoon: "Comments are coming soon. Stay tuned.",
@@ -97,6 +103,9 @@ const en: Record<UiKey, string> = {
 	allTags: "All",
 	galleryNoAlbums: "No albums yet. Add one in theme config gallery.albums.",
 	galleryNoPhotos: "No photos in this album",
+	/* 说说页（§4.87） */
+	momentsTitle: "Moments",
+	momentsEmpty: "No moments yet.",
 	encryptedAlbum: "Encrypted album",
 	searchAlbumNoResults: "No matching albums",
 	postEncrypted: "Encrypted",

package/src/i18n/zh-CN.ts

@@ -90,6 +90,12 @@ const zhCN = {
 	avatarAlt: "{name} 的头像",
 	noFriends: "还没有友链",
 	applyFriend: "申请友链",
+	/* 番组追番页（§4.93） */
+	bangumiEmpty: "还没有在看中的番剧",
+	bangumiFail: "番组数据拉取失败，请重新构建站点后重试",
+	epProgress: "看到 {n} / {total} 集",
+	epProgressOpen: "看到 {n} 集",
+	myRate: "我的评分 {n}",
 	guestbook: "留言板",
 	guestbookSub: "欢迎留下你的足迹",
 	commentComingSoon: "评论区即将开放，敬请期待。",
@@ -112,6 +118,9 @@ const zhCN = {
 	allTags: "全部",
 	galleryNoAlbums: "还没有相册，在主题配置 gallery.albums 中添加。",
 	galleryNoPhotos: "相册里还没有照片",
+	/* 说说页（§4.87） */
+	momentsTitle: "说说",
+	momentsEmpty: "还没有说说。",
 	encryptedAlbum: "加密相册",
 	searchAlbumNoResults: "没有匹配的相册",
 	/* 加密文章（M3b-b7）：postEncrypted 用于列表/文章 meta 标记，其余构建期渲染进锁 UI */

package/src/index.ts

@@ -41,6 +41,7 @@ import {
 	rehypeExternalLinks,
 	rehypeFigure,
 	rehypeFirstImage,
+	rehypeNoReferrer,
 } from "./plugins/rehype.js";
 import {
 	rehypeDiagramPanZoom,
@@ -125,6 +126,8 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 					// GitHub 仓库卡片（§4.10）：github 标签 → 卡片（自带 target，须在外链处理前）
 					rehypeGithubCard,
 					rehypeExternalLinks,
+					// 图片防盗链（§4.87）：命中域名外链图加 no-referrer（domains 空时插件空转）
+					[rehypeNoReferrer, { domains: config.noReferrer.domains }],
 					rehypeCallouts,
 					rehypeFigure,
 					rehypeFirstImage,
@@ -308,9 +311,13 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 					["/page/[page]", "page/[page].astro"],
 					["/archive", "archive.astro"],
 					["/tags", "tags/index.astro"],
-					["/tags/[tag]", "tags/[tag].astro"],
+					// §4.87 分类/标签分页：第一页 /tags/<tag>/（page 段省略），后续 /2/ 起
+					["/tags/[tag]/[...page]", "tags/[tag]/[...page].astro"],
 					["/categories", "categories/index.astro"],
-					["/categories/[category]", "categories/[category].astro"],
+					[
+						"/categories/[category]/[...page]",
+						"categories/[category]/[...page].astro",
+					],
 					["/posts/[...slug]", "posts/[...slug].astro"],
 					// sitemap（§4.63）：改由官方 @astrojs/sitemap integration 产出
 					// sitemap-index.xml，原手写 /sitemap.xml 路由移除
@@ -333,6 +340,14 @@ export function defineTheme(userConfig: ThemeConfig): AstroIntegration[] {
 					routes.push(["/series", "series/index.astro"]);
 					routes.push(["/series/[name]", "series/[name].astro"]);
 				}
+				// 说说页（§4.87）：moments collection 时间流；站点需先定义该集合（默认关）
+				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"]);
@@ -341,6 +356,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,

package/src/plugins/rehype.ts

@@ -35,12 +35,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";
@@ -53,6 +61,44 @@ export function rehypeExternalLinks(): Transformer {
 	};
 }
 
+/**
+ * 图片防盗链（§4.87）：部分图床/CDN（如 B 站）校验 Referer 头，站内引用返回 403。
+ * 为匹配域名的外链 <img> 追加 referrerpolicy="no-referrer"（浏览器请求图片时不发
+ * Referer，绕过防盗链限制），仅影响外链图片与匹配域名，本地图片不受影响。
+ */
+export interface NoReferrerOptions {
+	/** 域名列表：裸域名匹配自身与全部子域；*.example.com 只匹配子域 */
+	domains: string[];
+}
+
+export function rehypeNoReferrer(options: NoReferrerOptions): Transformer {
+	if (!options.domains.length) return () => {};
+	const matchers = options.domains.map((domain) => {
+		const d = domain.toLowerCase();
+		if (d.startsWith("*.")) {
+			const base = d.slice(2);
+			return (host: string) => host.endsWith(`.${base}`) && host !== base;
+		}
+		return (host: string) => host === d || host.endsWith(`.${d}`);
+	});
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "element" || node.tagName !== "img") return;
+			const src = String(node.properties?.src ?? "");
+			if (!/^https?:\/\//i.test(src)) return;
+			let host: string;
+			try {
+				host = new URL(src).hostname.toLowerCase();
+			} catch {
+				return;
+			}
+			if (matchers.some((match) => match(host))) {
+				node.properties.referrerPolicy = "no-referrer";
+			}
+		});
+	};
+}
+
 /* -------------------------------------------------------------- callouts */
 
 const CALLOUT_META: Record<

package/src/routes/bangumi.astro

@@ -0,0 +1,110 @@
+---
+import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import config from "virtual:theme/config";
+import { t } from "../i18n/index.js";
+
+/* 番组追番页（§4.93）：构建期从 bgm.tv v0 API 拉取用户「在看」动画收藏，
+   渲染为静态页。外部依赖 fail-soft：请求失败不中断构建，页面照常生成并提示。 */
+
+interface BgmSubject {
+	id: number;
+	name: string;
+	name_cn?: string;
+	score?: number;
+	eps?: number;
+	images?: { common?: string; medium?: string; large?: string };
+}
+interface BgmCollection {
+	updated_at?: string;
+	subject: BgmSubject;
+	ep_status?: number;
+	rate?: number;
+}
+
+const LIMIT = 50;
+/* 50 * 20 = 1000 条安全上限：防止分页异常（total 失真）导致构建挂死 */
+const MAX_PAGES = 20;
+const UA =
+	"astro-theme-orchid (+https://github.com/iwinder/qy-astro-theme-orchid)";
+
+let items: BgmCollection[] = [];
+let failed = false;
+
+try {
+	const headers = { "User-Agent": UA, Accept: "application/json" };
+	for (let offset = 0; offset < LIMIT * MAX_PAGES; offset += LIMIT) {
+		const url = `https://api.bgm.tv/v0/users/${config.bangumi.userId}/collections?subject_type=2&type=3&limit=${LIMIT}&offset=${offset}`;
+		const res = await fetch(url, {
+			headers,
+			signal: AbortSignal.timeout(10_000),
+		});
+		if (!res.ok) throw new Error(`bgm.tv responded ${res.status}`);
+		const page = (await res.json()) as { data?: BgmCollection[] };
+		const batch = page.data ?? [];
+		items = items.concat(batch);
+		if (batch.length < LIMIT) break;
+	}
+	/* 最近在看优先：按收藏更新时间倒序 */
+	items.sort((a, b) => (b.updated_at ?? "").localeCompare(a.updated_at ?? ""));
+} catch {
+	failed = true;
+}
+
+/* 进度文案：eps 有值时 clamp 到总集数并显示 x/y，否则只显示已看集数 */
+function progress(item: BgmCollection): string {
+	const eps = item.subject.eps ?? 0;
+	const watched = item.ep_status ?? 0;
+	return eps > 0
+		? t("epProgress", {
+				n: Math.min(watched, eps),
+				total: eps,
+			})
+		: t("epProgressOpen", { n: watched });
+}
+---
+
+<BaseLayout title={config.bangumi.title} description={config.bangumi.description} page="bangumi">
+  <header class="archive-head reveal">
+    <h1 class="page-title">{config.bangumi.title}</h1>
+    {
+      config.bangumi.description && (
+        <p class="page-sub">{config.bangumi.description}</p>
+      )
+    }
+  </header>
+
+  {
+    items.length > 0 ? (
+      <div class="bangumi-grid reveal">
+        {items.map((item) => {
+          const s = item.subject;
+          const cover = s.images?.common ?? s.images?.medium ?? s.images?.large;
+          return (
+            <a
+              class="bangumi-card card"
+              href={`https://bgm.tv/subject/${s.id}`}
+              target="_blank"
+              rel="noopener nofollow"
+            >
+              <div class="bangumi-cover">
+                {cover && <img src={cover} alt={s.name_cn || s.name} loading="lazy" decoding="async" />}
+                {typeof s.score === "number" && s.score > 0 && (
+                  <span class="bangumi-score">{s.score.toFixed(1)}</span>
+                )}
+              </div>
+              <div class="bangumi-title">{s.name_cn || s.name}</div>
+              <div class="bangumi-meta">
+                <span class="bangumi-progress">{progress(item)}</span>
+                {typeof item.rate === "number" && item.rate > 0 && (
+                  <span class="bangumi-rate">{t("myRate", { n: item.rate })}</span>
+                )}
+              </div>
+            </a>
+          );
+        })}
+      </div>
+    ) : (
+      <p class="tag-empty reveal">{failed ? t("bangumiFail") : t("bangumiEmpty")}</p>
+    )
+  }
+</BaseLayout>

package/src/routes/categories/[category]/[...page].astro

@@ -0,0 +1,53 @@
+---
+import { getCollection } from "astro:content";
+import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import Pagination from "virtual:theme/components/Pagination.astro";
+import config from "virtual:theme/config";
+import { t } from "../../../i18n/index.js";
+import {
+	collectCategories,
+	formatDate,
+	getSortedPosts,
+} from "../../../utils.js";
+
+/**
+ * 分类详情（§4.87 分页）：每分类按 postList.pageSize 分页，第一页
+ * /categories/<category>/（page 段省略），后续 /categories/<category>/2/ 起。
+ * paginate() helper 生成 Page 对象（props.page），Page.data 即当前页文章。
+ */
+export async function getStaticPaths({ paginate }: { paginate: any }) {
+	const all = await getCollection("posts", ({ data }) =>
+		import.meta.env.PROD ? !data.draft : true,
+	);
+	// 先排序再聚合，保证每个分类内文章按新→旧排列
+	const sorted = getSortedPosts(all);
+	return [...collectCategories(sorted).entries()].flatMap(([category, posts]) =>
+		paginate(posts, {
+			params: { category },
+			props: { category },
+			pageSize: config.postList.pageSize,
+		}),
+	);
+}
+
+const { page, category } = Astro.props;
+const posts = page.data;
+---
+
+<BaseLayout title={t('categoryTitle', { category })} page="categories">
+  <header class="archive-head reveal">
+    <h1 class="page-title">{category}</h1>
+    <p class="page-sub">{t('totalPosts', { n: page.total })}</p>
+  </header>
+  <div class="tag-list">
+    {
+      posts.map((post: any) => (
+        <a class="related-card card tag-item reveal" href={`/posts/${post.id}/`}>
+          <div class="rc-title">{post.data.title}</div>
+          <div class="rc-meta">{formatDate(post.data.published)}</div>
+        </a>
+      ))
+    }
+  </div>
+  <Pagination page={page.currentPage} total={page.lastPage} basePath={`/categories/${category}/`} />
+</BaseLayout>

package/src/routes/manifest.webmanifest.ts

@@ -0,0 +1,33 @@
+import config from "virtual:theme/config";
+import type { APIRoute } from "astro";
+
+/**
+ * PWA manifest（§4.95）：构建期产出 /manifest.webmanifest。
+ * - scope/start_url 由 site 根路径派生（主题假定部署在站点根路径）；
+ * - name/description 留空回落站点 title/description，short_name 留空回落 name；
+ * - icons 按 pwa.icons 全字段映射（可安装性至少需要 192x192 + 512x512 各一张）；
+ * - enabled=false 时本端点根本不注入（index.ts 门控）。
+ */
+export const GET: APIRoute = ({ site }) => {
+	const base = new URL("/", site ?? new URL("https://blog.example.com"))
+		.pathname;
+	const manifest = {
+		name: config.pwa.name || config.title,
+		short_name: config.pwa.shortName || config.pwa.name || config.title,
+		description: config.pwa.description || config.description,
+		start_url: base,
+		scope: base,
+		display: config.pwa.display,
+		background_color: config.pwa.backgroundColor,
+		theme_color: config.pwa.themeColor,
+		icons: config.pwa.icons.map((icon) => ({
+			src: icon.src,
+			sizes: icon.sizes,
+			type: icon.type,
+			purpose: icon.purpose,
+		})),
+	};
+	return new Response(JSON.stringify(manifest, null, 2), {
+		headers: { "Content-Type": "application/manifest+json; charset=utf-8" },
+	});
+};

package/src/routes/moments/[...page].astro

@@ -0,0 +1,80 @@
+---
+import { getCollection, render } from "astro:content";
+import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import Pagination from "virtual:theme/components/Pagination.astro";
+import config from "virtual:theme/config";
+import { t } from "../../i18n/index.js";
+import { formatDate } from "../../utils.js";
+
+/**
+ * 说说页（§4.87）：moments collection 时间流，按 published 新→旧，
+ * 每页 20 条（第一页 /moments/，后续 /moments/2/）。
+ * 正文走主题统一 markdown processor（全部增强语法可用）；配图 images 网格
+ * 展示并接入通用灯箱（data-lightbox-group 组浏览）。
+ */
+export async function getStaticPaths({ paginate }: { paginate: any }) {
+	const all = await getCollection("moments", ({ data }) =>
+		import.meta.env.PROD ? !data.draft : true,
+	);
+	const sorted = [...all].sort(
+		(a, b) => b.data.published.valueOf() - a.data.published.valueOf(),
+	);
+	return paginate(sorted, { pageSize: 20 });
+}
+
+const { page } = Astro.props;
+const rendered = await Promise.all(
+	page.data.map(async (moment: any) => {
+		const { Content } = await render(moment);
+		return { moment, Content };
+	}),
+);
+---
+
+<BaseLayout title={t('momentsTitle')} page="moments">
+  <header class="archive-head reveal">
+    <h1 class="page-title">{t('momentsTitle')}</h1>
+  </header>
+
+  {
+    rendered.length === 0 ? (
+      <p class="gallery-empty reveal">{t('momentsEmpty')}</p>
+    ) : (
+      <div class="moments-list">
+        {rendered.map(({ moment, Content }) => (
+          <article class="moment card reveal">
+            <div class="moment-meta">
+              <time datetime={moment.data.published.toISOString()}>
+                {formatDate(moment.data.published)}
+              </time>
+              {moment.data.mood && <span class="moment-mood">{moment.data.mood}</span>}
+            </div>
+            <div class="moment-content">
+              <Content />
+            </div>
+            {moment.data.images.length > 0 && (
+              <div class="moment-images" data-lightbox-group>
+                {moment.data.images.map((src: string) => (
+                  <figure class="moment-img">
+                    <img src={src} alt={t('momentsTitle')} loading="lazy" decoding="async" />
+                  </figure>
+                ))}
+              </div>
+            )}
+            {moment.data.tags.length > 0 && (
+              <div class="moment-tags">
+                {moment.data.tags.map((tg: string) => (
+                  <a class="moment-tag" href={`/tags/${tg}/`}>
+                    {tg}
+                  </a>
+                ))}
+              </div>
+            )}
+          </article>
+        ))}
+      </div>
+    )
+  }
+
+  <Pagination page={page.currentPage} total={page.lastPage} basePath="/moments/" />
+</BaseLayout>

package/src/routes/rss.xml.ts

@@ -1,32 +1,59 @@
-import { getCollection } from "astro:content";
+import { getCollection, render } from "astro:content";
 import config from "virtual:theme/config";
 import rss from "@astrojs/rss";
 import type { APIContext, APIRoute } from "astro";
+import { experimental_AstroContainer as AstroContainer } from "astro/container";
 import { getSortedPosts } from "../utils.js";
 
 /**
- * RSS（§4.63 官方 @astrojs/rss 端点）：item description 使用 frontmatter
- * description，不做全文输出（避免 RSS 端点再渲染全部 Markdown）。
- * channel 头部、atom:link self、XML 转义由官方库负责；trailingSlash 与
- * 主题 trailingSlash: "always" 口径一致（/posts/xxx/）。
+ * RSS（§4.63 官方 @astrojs/rss 端点）：
+ * - 默认 item description 使用 frontmatter description（摘要输出）；
+ * - rss.fullText 开启后 item 追加 content:encoded 全文（§4.87）——经
+ *   AstroContainer 逐篇容器渲染 Markdown（与文章页同一套 remark/rehype 插件产物），
+ *   构建时间随文章数增加，默认关；
+ * - 条数 rss.limit（默认 20）；channel 头部、atom:link self、XML 转义由官方库负责；
+ *   trailingSlash 与主题 trailingSlash: "always" 口径一致（/posts/xxx/）。
  */
 export const GET: APIRoute = async (context: APIContext) => {
 	const all = await getCollection("posts", ({ data }) => !data.draft);
-	const posts = getSortedPosts(all).slice(0, 20);
+	const posts = getSortedPosts(all).slice(0, config.rss.limit);
 	const site = context.site ?? new URL("https://blog.example.com");
 
+	const items = await Promise.all(
+		posts.map(async (post) => {
+			const item: {
+				title: string;
+				description: string;
+				link: string;
+				pubDate: Date;
+				content?: string;
+			} = {
+				title: post.data.title,
+				description: post.data.description,
+				link: `/posts/${post.id}/`,
+				pubDate: post.data.published,
+			};
+			if (config.rss.fullText && !post.data.password) {
+				// 加密文章不进 RSS 全文（内容构建期加密，明文进 RSS 会绕过密码）
+				const { Content } = await render(post);
+				const container = await AstroContainer.create();
+				item.content = await container.renderToString(Content);
+			}
+			return item;
+		}),
+	);
+
 	return rss({
 		title: config.title,
 		description: config.description,
 		site,
-		items: posts.map((post) => ({
-			title: post.data.title,
-			description: post.data.description,
-			link: `/posts/${post.id}/`,
-			pubDate: post.data.published,
-		})),
-		// atom 命名空间 + feed 自引用（v4 不再自动生成，保持对原手写版的兼容）
-		xmlns: { atom: "http://www.w3.org/2005/Atom" },
+		items,
+		// atom 命名空间 + feed 自引用（v4 不再自动生成，保持对原手写版的兼容）；
+		// content 命名空间供 fullText 的 content:encoded 使用
+		xmlns: {
+			atom: "http://www.w3.org/2005/Atom",
+			content: "http://purl.org/rss/1.0/modules/content/",
+		},
 		// RSS <language> 通道级语言标记（跟随站点语言）
 		customData: [
 			`<language>${config.lang}</language>`,