@windcoder/astro-theme-orchid 0.4.4 → 0.4.6

package/package.json

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

package/src/components/PostResources.astro

@@ -0,0 +1,75 @@
+---
+/**
+ * 文章资源区：frontmatter resources（name/url/password）在正文后渲染资源卡。
+ * 按 url 域名识别品牌图标（gitee/github），其余地址用通用外链图标；
+ * password 有值时展示提取码。新地址类型无需改组件，直接复用 name/url 展示。
+ */
+import { t } from "../i18n/index.js";
+
+interface ResourceItem {
+	name: string;
+	url: string;
+	password?: string;
+}
+
+interface Props {
+	resources?: ResourceItem[];
+}
+
+const { resources } = Astro.props;
+const items = (resources ?? []).filter((r) => r.url && r.url.trim() !== "");
+
+type IconKind = "gitee" | "github" | "link";
+function iconFor(url: string): IconKind {
+	let host = "";
+	try {
+		host = new URL(url).hostname.replace(/^www\./, "");
+	} catch {
+		return "link";
+	}
+	if (host === "gitee.com") return "gitee";
+	if (host === "github.com") return "github";
+	return "link";
+}
+---
+
+{
+  items.length > 0 && (
+    <section class="post-resources card reveal" aria-label={t("postResources")}>
+      <h2 class="post-resources-title">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z"/><path d="m3.3 7 8.7 5 8.7-5"/><path d="M12 22V12"/></svg>
+        {t("postResources")}
+      </h2>
+      <ul class="post-resources-list">
+        {items.map((r) => {
+          const kind = iconFor(r.url);
+          return (
+            <li class="post-resources-item">
+              <a href={r.url} target="_blank" rel="noopener">
+                <span class="post-resources-icon" aria-hidden="true">
+                  {kind === "gitee" && (
+                    <svg viewBox="0 0 1024 1024" fill="currentColor"><path d="M512 1024C229.222 1024 0 794.778 0 512S229.222 0 512 0s512 229.222 512 512-229.222 512-512 512zm259.149-568.883h-290.74a25.293 25.293 0 0 0-25.292 25.293l-0.081 63.206c0 13.952 11.315 25.293 25.267 25.293h177.024c13.978 0 25.293 11.315 25.293 25.267v12.646a75.853 75.853 0 0 1-75.853 75.853h-240.23a25.293 25.293 0 0 1-25.267-25.293V417.203a75.853 75.853 0 0 1 75.827-75.853h353.946a25.293 25.293 0 0 0 25.267-25.292l0.077-63.207a25.293 25.293 0 0 0-25.268-25.293H417.152a189.62 189.62 0 0 0-189.62 189.645V771.15c0 13.977 11.316 25.293 25.294 25.293h372.94a170.65 170.65 0 0 0 170.65-170.65V480.384a25.293 25.293 0 0 0-25.267-25.267z"/></svg>
+                  )}
+                  {kind === "github" && (
+                    <svg viewBox="0 0 16 16" fill="currentColor"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8z"/></svg>
+                  )}
+                  {kind === "link" && (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg>
+                  )}
+                </span>
+                <span class="post-resources-name">{r.name}</span>
+                {r.password && r.password.trim() !== "" && (
+                  <span class="post-resources-password">
+                    {t("resourcePassword")}
+                    <code>{r.password}</code>
+                  </span>
+                )}
+                <svg class="post-resources-ext" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/></svg>
+              </a>
+            </li>
+          );
+        })}
+      </ul>
+    </section>
+  )
+}

package/src/i18n/en.ts

@@ -78,6 +78,14 @@ const en: Record<UiKey, string> = {
 	avatarAlt: "Avatar of {name}",
 	noFriends: "No friend links yet",
 	applyFriend: "Apply for a link",
+	friendSearch: "Search links…",
+	friendAll: "All",
+	noFriendMatch: "No matching links",
+	copy: "Copy",
+	friendSiteName: "Site name",
+	friendSiteDesc: "Site description",
+	friendSiteUrl: "Site URL",
+	friendAvatarUrl: "Avatar URL",
 	/* Bangumi watching page (§4.93) */
 	bangumiEmpty: "Nothing being watched yet",
 	bangumiFail: "Failed to fetch Bangumi data. Rebuild the site to retry.",
@@ -146,6 +154,9 @@ const en: Record<UiKey, string> = {
 		"No series yet. Add a series field to a post's frontmatter to create one.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "Series catalog",
+	/* Post resources: resource card rendered from frontmatter resources */
+	postResources: "Related resources",
+	resourcePassword: "Code",
 	/* Music player (§4.36) */
 	musicOpen: "Music player",
 	musicClose: "Collapse player",

package/src/i18n/ja.ts

@@ -78,6 +78,14 @@ const ja: Record<UiKey, string> = {
 	avatarAlt: "{name} のアバター",
 	noFriends: "リンクはまだありません",
 	applyFriend: "リンク申請",
+	friendSearch: "リンクを検索…",
+	friendAll: "すべて",
+	noFriendMatch: "該当するリンクがありません",
+	copy: "コピー",
+	friendSiteName: "サイト名",
+	friendSiteDesc: "サイト説明",
+	friendSiteUrl: "サイトURL",
+	friendAvatarUrl: "アバターURL",
 	/* 番組視聴ページ */
 	bangumiEmpty: "視聴中の番組はまだありません",
 	bangumiFail:
@@ -150,6 +158,9 @@ const ja: Record<UiKey, string> = {
 		"シリーズがまだありません。記事の frontmatter に series を記入すると作成できます。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "シリーズ目次",
+	/* 記事リソース：frontmatter resources から描画されるリソースカード */
+	postResources: "関連リソース",
+	resourcePassword: "パスワード",
 	/* 音楽プレイヤー */
 	musicOpen: "音楽プレイヤー",
 	musicClose: "プレイヤーを閉じる",

package/src/i18n/ko.ts

@@ -77,6 +77,14 @@ const ko: Record<UiKey, string> = {
 	avatarAlt: "{name}의 아바타",
 	noFriends: "아직 링크가 없습니다",
 	applyFriend: "링크 신청",
+	friendSearch: "링크 검색…",
+	friendAll: "전체",
+	noFriendMatch: "일치하는 링크가 없습니다",
+	copy: "복사",
+	friendSiteName: "사이트 이름",
+	friendSiteDesc: "사이트 설명",
+	friendSiteUrl: "사이트 URL",
+	friendAvatarUrl: "아바타 URL",
 	/* 애니 시청 페이지 */
 	bangumiEmpty: "시청 중인 애니메이션이 없습니다",
 	bangumiFail:
@@ -149,6 +157,9 @@ const ko: Record<UiKey, string> = {
 		"아직 시리즈가 없습니다. 글 frontmatter에 series를 입력하면 생성됩니다.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "시리즈 목차",
+	/* 게시글 리소스: frontmatter resources 로 렌더링되는 리소스 카드 */
+	postResources: "관련 자료",
+	resourcePassword: "추출 코드",
 	/* 음악 플레이어 */
 	musicOpen: "음악 플레이어",
 	musicClose: "플레이어 접기",

package/src/i18n/ru.ts

@@ -77,6 +77,14 @@ const ru: Record<UiKey, string> = {
 	avatarAlt: "Аватар {name}",
 	noFriends: "Ссылок пока нет",
 	applyFriend: "Заявка на обмен ссылками",
+	friendSearch: "Поиск ссылок…",
+	friendAll: "Все",
+	noFriendMatch: "Ничего не найдено",
+	copy: "Копировать",
+	friendSiteName: "Название сайта",
+	friendSiteDesc: "Описание сайта",
+	friendSiteUrl: "Ссылка на сайт",
+	friendAvatarUrl: "Ссылка на аватар",
 	/* Страница отслеживания аниме */
 	bangumiEmpty: "Пока ничего не смотрю",
 	bangumiFail:
@@ -150,6 +158,9 @@ const ru: Record<UiKey, string> = {
 		"Серий пока нет. Заполните поле series в frontmatter записи, чтобы создать.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "Содержание серии",
+	/* Ресурсы статьи: карточка из frontmatter resources */
+	postResources: "Материалы",
+	resourcePassword: "Код доступа",
 	/* Музыкальный плеер */
 	musicOpen: "Музыкальный плеер",
 	musicClose: "Свернуть плеер",

package/src/i18n/zh-CN.ts

@@ -91,6 +91,14 @@ const zhCN = {
 	avatarAlt: "{name} 的头像",
 	noFriends: "还没有友链",
 	applyFriend: "申请友链",
+	friendSearch: "搜索友链…",
+	friendAll: "全部",
+	noFriendMatch: "没有匹配的友链",
+	copy: "复制",
+	friendSiteName: "站点名称",
+	friendSiteDesc: "站点描述",
+	friendSiteUrl: "站点链接",
+	friendAvatarUrl: "头像链接",
 	/* 番组追番页（§4.93） */
 	bangumiEmpty: "还没有在看中的番剧",
 	bangumiFail: "番组数据拉取失败，请重新构建站点后重试",
@@ -166,6 +174,9 @@ const zhCN = {
 	seriesEmpty: "还没有专题，在文章 frontmatter 中填写 series 字段即可创建。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "专题目录",
+	/* 文章资源区：frontmatter resources 渲染的资源卡 */
+	postResources: "相关资源",
+	resourcePassword: "提取码",
 	/* 音乐播放器（§4.36）：data-labels 经组件 data-labels 属性带入客户端 */
 	musicOpen: "音乐播放器",
 	musicClose: "收起播放器",

package/src/i18n/zh-TW.ts

@@ -77,6 +77,14 @@ const zhTW: Record<UiKey, string> = {
 	avatarAlt: "{name} 的頭像",
 	noFriends: "還沒有友鏈",
 	applyFriend: "申請友鏈",
+	friendSearch: "搜尋友鏈…",
+	friendAll: "全部",
+	noFriendMatch: "沒有符合的友鏈",
+	copy: "複製",
+	friendSiteName: "站點名稱",
+	friendSiteDesc: "站點描述",
+	friendSiteUrl: "站點連結",
+	friendAvatarUrl: "頭像連結",
 	/* 番組追番頁 */
 	bangumiEmpty: "還沒有在看中的番劇",
 	bangumiFail: "番組資料拉取失敗，請重新建置網站後重試",
@@ -145,6 +153,9 @@ const zhTW: Record<UiKey, string> = {
 	seriesEmpty: "還沒有專題，在文章 frontmatter 中填寫 series 欄位即可建立。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "專題目錄",
+	/* 文章資源區：frontmatter resources 渲染的資源卡 */
+	postResources: "相關資源",
+	resourcePassword: "提取碼",
 	/* 音樂播放器 */
 	musicOpen: "音樂播放器",
 	musicClose: "收起播放器",

package/src/routes/friends.astro

@@ -22,19 +22,47 @@ const friendImgs = await Promise.all(
 	),
 );
 
-// 可选 spec 正文（src/content/spec/friends.md），渲染在卡片列表上方
+// 可选 spec 正文（src/content/spec/friends.md），渲染在区块卡上方
 const entry = await getEntry("spec", "friends").catch(() => null);
 const { Content } = entry ? await render(entry) : { Content: null };
 
-const apply = config.friends.apply;
----
+const friendsCfg = config.friends;
+const apply = friendsCfg.apply;
+const siteInfo = friendsCfg.siteInfo;
+const notice = friendsCfg.notice;
+
+// 分组 pills：由 list tags 聚合去重（保持首次出现顺序），无 tags 自动隐藏
+const groupTags = [...new Set(friends.flatMap((f) => f.tags))].filter(Boolean);
+const showGroups = friendsCfg.filter.groups && groupTags.length > 0;
+const showSearch = friendsCfg.filter.search;
+
+// 本站信息卡：name/desc/site/avatar 任一非空才渲染
+const siteInfoRows = (
+	[
+		[t("friendSiteName"), siteInfo.name],
+		[t("friendSiteDesc"), siteInfo.desc],
+		[t("friendSiteUrl"), siteInfo.site],
+		[t("friendAvatarUrl"), siteInfo.avatar],
+	] as [string, string][]
+).filter(([, v]) => v);
+const hasSiteInfo = siteInfoRows.length > 0;
+// 本站头像三格式解析（§4.97），空串跳过用字头像兜底
+const siteAvatar = siteInfo.avatar
+	? await resolveSiteImage(siteInfo.avatar)
+	: "";
+
+// 申请模板整块复制文本：label: value 每行一条（模板块右上角一键复制）
+const applyTemplateText = apply.template
+	.map((r) => `${r.label}: ${r.value}`)
+	.join("\n");
 
-<BaseLayout title={config.friends.title} page="friends">
-  <header class="archive-head reveal">
-    <h1 class="page-title">{config.friends.title}</h1>
-    {config.friends.description && <p class="page-sub">{config.friends.description}</p>}
-  </header>
+// 申请卡：有步骤或模板时渲染富卡（与站点信息并排）；否则回退旧的横向申请条
+const hasApplyRich = Boolean(
+	apply.title && (apply.steps.length > 0 || apply.template.length > 0),
+);
+---
 
+<BaseLayout title={friendsCfg.title} page="friends">
   {
     Content && (
       <article class="card page-card prose reveal" data-lightbox-gallery>
@@ -43,14 +71,87 @@ const apply = config.friends.apply;
     )
   }
 
-  {
-    friends.length > 0 ? (
-      <div class="friend-grid reveal">
-        {friends.map((f, i) => (
-          <a class="friend-card card" href={f.site} target="_blank" rel="noopener">
+  <section class="friend-zone card reveal" data-friend-zone>
+    <div class="friend-toolbar">
+      <div class="friend-zone-title">
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          stroke-width="2"
+          stroke-linecap="round"
+          stroke-linejoin="round"
+          aria-hidden="true"
+        >
+          <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" />
+          <path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" />
+        </svg>
+        <span>{friendsCfg.title}</span>
+      </div>
+      {
+        showSearch && (
+          <div class="friend-search">
+            <svg
+              xmlns="http://www.w3.org/2000/svg"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              aria-hidden="true"
+            >
+              <circle cx="11" cy="11" r="8" />
+              <path d="m21 21-4.3-4.3" />
+            </svg>
+            <input
+              type="search"
+              placeholder={t("friendSearch")}
+              aria-label={t("friendSearch")}
+              data-friend-search
+            />
+          </div>
+        )
+      }
+    </div>
+    {friendsCfg.description && <p class="friend-zone-desc">{friendsCfg.description}</p>}
+    {
+      showGroups && (
+        <div class="friend-pills" role="group" aria-label={t("friendAll")}>
+          <button type="button" class="chip is-on" data-friend-pill="">
+            {t("friendAll")}
+          </button>
+          {groupTags.map((gt) => (
+            <button type="button" class="chip" data-friend-pill={gt}>
+              {gt}
+            </button>
+          ))}
+        </div>
+      )
+    }
+    <div class="friend-grid">
+      {
+        friends.map((f, i) => (
+          <a
+            class="friend-card card"
+            href={f.site}
+            target="_blank"
+            rel="noopener"
+            data-friend-card
+            data-search={[f.title, f.desc, ...f.tags]
+              .filter(Boolean)
+              .join(" ")
+              .toLowerCase()}
+            data-tags={JSON.stringify(f.tags)}
+          >
             <div class="friend-avatar">
               {f.image ? (
-                <img src={friendImgs[i]} alt={t('avatarAlt', { name: f.title })} loading="lazy" />
+                <img
+                  src={friendImgs[i]}
+                  alt={t("avatarAlt", { name: f.title })}
+                  loading="lazy"
+                />
               ) : (
                 <span class="avatar-fallback">{f.title.slice(0, 1)}</span>
               )}
@@ -67,15 +168,191 @@ const apply = config.friends.apply;
               )}
             </div>
           </a>
-        ))}
+        ))
+      }
+    </div>
+    <p class="tag-empty" data-friend-empty hidden>
+      {t("noFriendMatch")}
+    </p>
+  </section>
+
+  {
+    (hasSiteInfo || hasApplyRich) && (
+      <div class="friend-duo">
+        {hasSiteInfo && (
+          <section class="friend-siteinfo card reveal">
+            <div class="friend-card-title">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                aria-hidden="true"
+              >
+                <path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" />
+                <polyline points="9 22 9 12 15 12 15 22" />
+              </svg>
+              <span>{siteInfo.title}</span>
+            </div>
+            <div class="siteinfo-head">
+              <div
+                class="siteinfo-avatar"
+                data-siteinfo-avatar
+                data-avatar-name={siteInfo.name}
+              >
+                {siteAvatar ? (
+                  <img src={siteAvatar} alt={siteInfo.name} loading="lazy" />
+                ) : (
+                  <span class="avatar-fallback">
+                    {(siteInfo.name || "?").slice(0, 1)}
+                  </span>
+                )}
+              </div>
+              <div class="siteinfo-meta">
+                <div class="siteinfo-name">{siteInfo.name}</div>
+                {siteInfo.desc && <p class="siteinfo-desc">{siteInfo.desc}</p>}
+              </div>
+            </div>
+            {siteInfoRows.map(([label, value]) => (
+              <div class="kv-row">
+                <div class="kv-main">
+                  <span class="kv-label">{label}</span>
+                  <span class="kv-value">{value}</span>
+                </div>
+                <button
+                  type="button"
+                  class="copy-btn"
+                  data-copy={value}
+                  aria-label={t("copy")}
+                  title={t("copy")}
+                >
+                  <svg
+                    class="icon-copy"
+                    xmlns="http://www.w3.org/2000/svg"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="2"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    aria-hidden="true"
+                  >
+                    <rect width="14" height="14" x="8" y="8" rx="2" />
+                    <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
+                  </svg>
+                  <svg
+                    class="icon-check"
+                    xmlns="http://www.w3.org/2000/svg"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="2"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    aria-hidden="true"
+                  >
+                    <path d="M20 6 9 17l-5-5" />
+                  </svg>
+                </button>
+              </div>
+            ))}
+          </section>
+        )}
+        {hasApplyRich && (
+          <section class="friend-apply-card card reveal">
+            <div class="friend-card-title">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                aria-hidden="true"
+              >
+                <rect width="20" height="16" x="2" y="4" rx="2" />
+                <path d="m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7" />
+              </svg>
+              <span>{apply.title}</span>
+            </div>
+            {apply.description && <p class="fa-desc">{apply.description}</p>}
+            {apply.steps.length > 0 && (
+              <ol class="apply-steps">
+                {apply.steps.map((s, i) => (
+                  <li class="apply-step">
+                    <span class="apply-step-num">{i + 1}</span>
+                    <div>
+                      <div class="apply-step-title">{s.title}</div>
+                      {s.description && <p class="apply-step-desc">{s.description}</p>}
+                    </div>
+                  </li>
+                ))}
+              </ol>
+            )}
+            {apply.template.length > 0 && (
+              <div class="apply-template">
+                <button
+                  type="button"
+                  class="copy-btn"
+                  data-copy={applyTemplateText}
+                  aria-label={t("copy")}
+                  title={t("copy")}
+                >
+                  <svg
+                    class="icon-copy"
+                    xmlns="http://www.w3.org/2000/svg"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="2"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    aria-hidden="true"
+                  >
+                    <rect width="14" height="14" x="8" y="8" rx="2" />
+                    <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
+                  </svg>
+                  <svg
+                    class="icon-check"
+                    xmlns="http://www.w3.org/2000/svg"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="2"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    aria-hidden="true"
+                  >
+                    <path d="M20 6 9 17l-5-5" />
+                  </svg>
+                </button>
+                <div class="apply-template-text">
+                  {apply.template.map((row) => (
+                    <div class="apply-template-line">
+                      {row.label}: {row.value}
+                    </div>
+                  ))}
+                </div>
+              </div>
+            )}
+            {apply.link && (
+              <a class="btn" href={apply.link}>
+                {apply.label || t("applyFriend")}
+              </a>
+            )}
+          </section>
+        )}
       </div>
-    ) : (
-      <p class="tag-empty reveal">{t('noFriends')}</p>
     )
   }
 
   {
-    apply.title && (
+    // 兼容旧配置：无步骤无模板时保留原横向申请条
+    apply.title && !hasApplyRich && (
       <section class="friend-apply card reveal">
         <div>
           <div class="fa-title">{apply.title}</div>
@@ -83,13 +360,116 @@ const apply = config.friends.apply;
         </div>
         {apply.link && (
           <a class="btn" href={apply.link}>
-            {apply.label || t('applyFriend')}
+            {apply.label || t("applyFriend")}
           </a>
         )}
       </section>
     )
   }
 
+  {
+    notice.items.length > 0 && (
+      <section class="friend-notice card reveal">
+        <div class="friend-card-title">
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            aria-hidden="true"
+          >
+            <path d="M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9" />
+            <path d="M10.3 21a1.94 1.94 0 0 0 3.4 0" />
+          </svg>
+          <span>{notice.title}</span>
+        </div>
+        <dl class="notice-list">
+          {notice.items.map((item) => (
+            <div class="notice-item">
+              <dt>{item.term}</dt>
+              {item.description && <dd>{item.description}</dd>}
+            </div>
+          ))}
+        </dl>
+      </section>
+    )
+  }
+
   <!-- §4.113：友链页评论区，支持直接留言申请友链（provider 未启用时自动 no-op） -->
   <Comment path="/friends" />
 </BaseLayout>
+
+<script>
+	// 友链区块卡：搜索 + 分组 pills 叠加过滤
+	const zone = document.querySelector<HTMLElement>("[data-friend-zone]");
+	if (zone) {
+		const search = zone.querySelector<HTMLInputElement>("[data-friend-search]");
+		const pills = Array.from(
+			zone.querySelectorAll<HTMLButtonElement>("[data-friend-pill]"),
+		);
+		const cards = Array.from(
+			zone.querySelectorAll<HTMLElement>("[data-friend-card]"),
+		);
+		const empty = zone.querySelector<HTMLElement>("[data-friend-empty]");
+		let keyword = "";
+		let group = "";
+		const applyFilter = () => {
+			let visible = 0;
+			for (const card of cards) {
+				const okKeyword =
+					!keyword || (card.dataset.search || "").includes(keyword);
+				let tags: string[] = [];
+				try {
+					tags = JSON.parse(card.dataset.tags || "[]") as string[];
+				} catch {
+					/* data-tags 解析失败时按无分组处理 */
+				}
+				const okGroup = !group || tags.includes(group);
+				const show = okKeyword && okGroup;
+				card.hidden = !show;
+				if (show) visible++;
+			}
+			if (empty) empty.hidden = visible > 0;
+		};
+		search?.addEventListener("input", () => {
+			keyword = (search.value || "").trim().toLowerCase();
+			applyFilter();
+		});
+		for (const pill of pills) {
+			pill.addEventListener("click", () => {
+				group = pill.dataset.friendPill || "";
+				for (const p of pills) p.classList.toggle("is-on", p === pill);
+				applyFilter();
+			});
+		}
+	}
+
+	// 复制按钮：点击复制 data-copy 内容，短暂切换成功态
+	for (const btn of document.querySelectorAll<HTMLButtonElement>("[data-copy]")) {
+		btn.addEventListener("click", async () => {
+			const value = btn.dataset.copy || "";
+			try {
+				await navigator.clipboard.writeText(value);
+			} catch {
+				/* 剪贴板不可用时静默降级（按钮仍给出成功反馈） */
+			}
+			btn.classList.add("is-copied");
+			setTimeout(() => btn.classList.remove("is-copied"), 1500);
+		});
+	}
+
+	// 本站头像加载失败时回退字头像（外链头像 404 / 防盗链兜底）
+	const avatarBox = document.querySelector<HTMLElement>("[data-siteinfo-avatar]");
+	const avatarImg = avatarBox?.querySelector("img");
+	if (avatarBox && avatarImg) {
+		avatarImg.addEventListener("error", () => {
+			const fb = document.createElement("span");
+			fb.className = "avatar-fallback";
+			fb.textContent = (avatarBox.dataset.avatarName || "?").slice(0, 1);
+			avatarImg.replaceWith(fb);
+		});
+	}
+</script>

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

@@ -10,6 +10,7 @@ import EncryptedContent from "virtual:theme/components/EncryptedContent.astro";
 import License from "virtual:theme/components/License.astro";
 import OutdatedCard from "virtual:theme/components/OutdatedCard.astro";
 import PostNav from "virtual:theme/components/PostNav.astro";
+import PostResources from "virtual:theme/components/PostResources.astro";
 import RecommendedPost from "virtual:theme/components/RecommendedPost.astro";
 import Sidebar from "virtual:theme/components/Sidebar.astro";
 import Toc from "virtual:theme/components/Toc.astro";
@@ -303,6 +304,8 @@ const jsonLd = {
     {/* 过时提醒（§4.11）：许可卡之前展示；加密文章不渲染 */}
     {!d.password && <OutdatedCard updated={d.updated ?? d.published} published={d.published} />}
     <License licenseName={d.licenseName} licenseUrl={d.licenseUrl} enabled={d.license} />
+    {/* 文章资源区：frontmatter resources 非空时渲染；加密文章随正文语义一并隐藏 */}
+    {!d.password && <PostResources resources={d.resources} />}
     <PostNav prev={prev ?? undefined} next={next ?? undefined} />
   {/* 支持卡（P2）：打赏入口 + 分享海报（share-poster.ts 仍按 #qy-share-btn 与 data-* 绑定） */}
   {

package/src/schema.ts

@@ -706,6 +706,29 @@ export const themeConfigSchema = z.object({
 			description: z.string().default(""),
 			/** 页面级排序：weight 权重降序 / random 随机（构建期） */
 			sort: z.enum(["weight", "random"]).default("weight"),
+			/** 友链区块卡工具条：搜索框与分组 pills 开关（分组由 list tags 聚合，无 tags 自动隐藏） */
+			filter: z
+				.object({
+					search: z.boolean().default(true),
+					groups: z.boolean().default(true),
+				})
+				.default({ search: true, groups: true }),
+			/** 本站信息卡（name/desc/site/avatar 任一非空才渲染整卡） */
+			siteInfo: z
+				.object({
+					title: z.string().default("本站信息"),
+					name: z.string().default(""),
+					desc: z.string().default(""),
+					site: z.string().default(""),
+					avatar: z.string().default(""),
+				})
+				.default({
+					title: "本站信息",
+					name: "",
+					desc: "",
+					site: "",
+					avatar: "",
+				}),
 			/** 申请友链卡片（title 留空则整卡不渲染） */
 			apply: z
 				.object({
@@ -714,8 +737,47 @@ export const themeConfigSchema = z.object({
 					/** 申请入口链接（mailto 或表单页） */
 					link: z.string().default(""),
 					label: z.string().default("申请友链"),
+					/** 申请步骤（空数组不渲染） */
+					steps: z
+						.array(
+							z.object({
+								title: z.string(),
+								description: z.string().default(""),
+							}),
+						)
+						.default([]),
+					/** 可复制申请资料模板行（空数组不渲染） */
+					template: z
+						.array(
+							z.object({
+								label: z.string(),
+								value: z.string(),
+							}),
+						)
+						.default([]),
+				})
+				.default({
+					title: "",
+					description: "",
+					link: "",
+					label: "申请友链",
+					steps: [],
+					template: [],
+				}),
+			/** 注意事项卡（items 为空不渲染） */
+			notice: z
+				.object({
+					title: z.string().default("注意事项"),
+					items: z
+						.array(
+							z.object({
+								term: z.string(),
+								description: z.string().default(""),
+							}),
+						)
+						.default([]),
 				})
-				.default({ title: "", description: "", link: "", label: "申请友链" }),
+				.default({ title: "注意事项", items: [] }),
 			list: z
 				.array(
 					z.object({
@@ -738,7 +800,17 @@ export const themeConfigSchema = z.object({
 			title: "友链",
 			description: "",
 			sort: "weight",
-			apply: { title: "", description: "", link: "", label: "申请友链" },
+			filter: { search: true, groups: true },
+			siteInfo: { title: "本站信息", name: "", desc: "", site: "", avatar: "" },
+			apply: {
+				title: "",
+				description: "",
+				link: "",
+				label: "申请友链",
+				steps: [],
+				template: [],
+			},
+			notice: { title: "注意事项", items: [] },
 			list: [],
 		}),
 	/**
@@ -1639,6 +1711,20 @@ export function definePostSchema(extensions: z.ZodRawShape = {}) {
 			 * 组名直接来自本字段文本，无 i18n 参与。
 			 */
 			seriesGroup: z.string().optional(),
+			/**
+			 * 文章相关资源：正文后渲染资源卡区。name 展示名、url 跳转地址、
+			 * password 提取码（可空）。按 url 域名识别品牌图标（gitee/github），
+			 * 其余地址类型直接复用通用外链图标展示，无需再改 schema。
+			 */
+			resources: z
+				.array(
+					z.object({
+						name: z.string(),
+						url: z.string(),
+						password: z.string().optional(),
+					}),
+				)
+				.optional(),
 		})
 		.extend(extensions);
 }

package/src/scripts/share-poster.ts

@@ -451,6 +451,8 @@ export async function openSharePoster(btn: HTMLElement) {
 			img.src = poster;
 			img.hidden = false;
 		}
+		/* 生成完成：移除 loading（否则转圈常驻在海报上方） */
+		modal.querySelector<HTMLElement>(".poster-loading")?.remove();
 		if (saveBtn) {
 			saveBtn.disabled = false;
 			saveBtn.addEventListener("click", () => {

package/src/styles/global.css

@@ -3339,6 +3339,96 @@ html.dark .outdated-warning {
 	border-radius: var(--radius-sm);
 	background: var(--bg-soft);
 }
+/* 文章资源区：frontmatter resources 渲染的资源卡（License 之后、上下篇之前） */
+.post-resources {
+	margin-top: 28px;
+	padding: 16px 20px;
+}
+.post-resources-title {
+	display: flex;
+	align-items: center;
+	gap: 8px;
+	margin: 0 0 10px;
+	font-size: 15.5px;
+	font-weight: 700;
+	color: var(--ink);
+}
+.post-resources-title svg {
+	width: 16px;
+	height: 16px;
+	color: var(--accent);
+}
+.post-resources-list {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+	display: grid;
+	gap: 4px;
+}
+.post-resources-item a {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	padding: 7px 8px;
+	border-radius: var(--radius-sm);
+	font-size: 14px;
+	color: var(--ink-2);
+	transition:
+		background 0.15s ease,
+		color 0.15s ease;
+}
+.post-resources-item a:hover {
+	background: var(--bg-soft);
+	color: var(--accent-deep);
+}
+.post-resources-icon {
+	flex: none;
+	display: inline-flex;
+	width: 18px;
+	height: 18px;
+	color: var(--muted);
+}
+.post-resources-item a:hover .post-resources-icon {
+	color: var(--accent);
+}
+.post-resources-icon svg {
+	width: 100%;
+	height: 100%;
+}
+.post-resources-name {
+	min-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+.post-resources-password {
+	flex: none;
+	display: inline-flex;
+	align-items: center;
+	gap: 4px;
+	margin-left: auto;
+	font-size: 12.5px;
+	color: var(--muted);
+}
+.post-resources-password code {
+	padding: 1px 6px;
+	border-radius: 4px;
+	border: 1px solid var(--border);
+	background: var(--bg-soft);
+	font-size: 12px;
+	color: var(--ink-2);
+}
+.post-resources-ext {
+	flex: none;
+	width: 14px;
+	height: 14px;
+	color: var(--muted);
+	opacity: 0.6;
+}
+.post-resources-item a:hover .post-resources-ext {
+	color: var(--accent);
+	opacity: 1;
+}
 .post-nav {
 	margin-top: 24px;
 	display: grid;
@@ -4526,6 +4616,320 @@ html.dark .friend-card:hover .friend-name {
 	padding: 1px 9px;
 }
 
+/* ---------- 10.3 友链区块卡（标题 + 搜索 + 分组 + 网格） ---------- */
+.friend-zone {
+	margin-top: 26px;
+	padding: 22px 24px;
+}
+.friend-toolbar {
+	display: flex;
+	align-items: center;
+	gap: 12px;
+	flex-wrap: wrap;
+}
+.friend-zone-title {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	font-family: var(--font-display);
+	font-weight: 700;
+	font-size: 17px;
+}
+.friend-zone-title svg {
+	flex: none;
+	width: 20px;
+	height: 20px;
+	color: var(--accent);
+}
+.friend-zone-desc {
+	margin-top: 6px;
+	font-size: 14px;
+	color: var(--muted);
+	line-height: 1.7;
+}
+.friend-search {
+	margin-left: auto;
+	display: flex;
+	align-items: center;
+	gap: 8px;
+	width: min(230px, 100%);
+	padding: 7px 12px;
+	border: 1px solid var(--border);
+	border-radius: 999px;
+	background: var(--bg-soft);
+	transition: border-color 0.15s;
+}
+.friend-search:focus-within {
+	border-color: var(--accent);
+}
+.friend-search svg {
+	flex: none;
+	width: 15px;
+	height: 15px;
+	color: var(--muted);
+}
+.friend-search input {
+	flex: 1;
+	min-width: 0;
+	border: none;
+	background: transparent;
+	outline: none;
+	font-size: 13.5px;
+	color: var(--ink);
+}
+.friend-search input::placeholder {
+	color: var(--muted);
+}
+.friend-pills {
+	margin-top: 14px;
+	display: flex;
+	flex-wrap: wrap;
+	gap: 8px;
+}
+.friend-pills .chip {
+	cursor: pointer;
+	font-family: inherit;
+}
+.friend-zone .friend-grid {
+	margin-top: 18px;
+}
+/* .friend-card 的 display:flex 会覆盖 UA 的 [hidden]，需显式收回 */
+.friend-card[hidden],
+.tag-empty[hidden] {
+	display: none;
+}
+.friend-zone .tag-empty {
+	margin-top: 18px;
+}
+
+/* ---------- 10.4 本站信息 / 申请友链 双卡与注意事项 ---------- */
+.friend-duo {
+	margin-top: 20px;
+	display: grid;
+	grid-template-columns: repeat(2, minmax(0, 1fr));
+	gap: 20px;
+}
+.friend-duo > .card:only-child {
+	grid-column: 1 / -1;
+}
+@media (max-width: 767px) {
+	.friend-duo {
+		grid-template-columns: 1fr;
+	}
+}
+.friend-siteinfo,
+.friend-apply-card {
+	display: flex;
+	flex-direction: column;
+}
+.friend-siteinfo,
+.friend-apply-card,
+.friend-notice {
+	padding: 22px 24px;
+}
+.friend-card-title {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	font-family: var(--font-display);
+	font-weight: 700;
+	font-size: 17px;
+}
+.friend-card-title svg {
+	flex: none;
+	width: 18px;
+	height: 18px;
+	color: var(--accent);
+}
+/* 本站信息卡头：头像 + 名称 + 描述（对齐参考布局） */
+.siteinfo-head {
+	display: flex;
+	align-items: center;
+	gap: 12px;
+	margin-top: 16px;
+}
+.siteinfo-avatar {
+	flex: none;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	width: 48px;
+	height: 48px;
+	border-radius: 50%;
+	overflow: hidden;
+	border: 1px solid var(--border);
+	background: var(--bg-soft);
+}
+.siteinfo-avatar img {
+	width: 100%;
+	height: 100%;
+	object-fit: cover;
+}
+.siteinfo-meta {
+	min-width: 0;
+}
+.siteinfo-name {
+	font-family: var(--font-display);
+	font-weight: 700;
+	font-size: 15px;
+}
+.siteinfo-desc {
+	margin-top: 2px;
+	font-size: 13px;
+	color: var(--muted);
+	line-height: 1.5;
+}
+.kv-row {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	margin-top: 10px;
+	padding: 10px 12px;
+	background: var(--bg-soft);
+	border: 1px solid var(--border);
+	border-radius: 8px;
+}
+.kv-main {
+	flex: 1;
+	min-width: 0;
+	display: flex;
+	flex-direction: column;
+	gap: 2px;
+}
+.kv-label {
+	font-size: 12px;
+	color: var(--muted);
+}
+.kv-value {
+	font-size: 13.5px;
+	color: var(--ink);
+	line-height: 1.5;
+	word-break: break-all;
+}
+.copy-btn {
+	flex: none;
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	width: 26px;
+	height: 26px;
+	border: 1px solid var(--border);
+	border-radius: 6px;
+	background: transparent;
+	color: var(--muted);
+	cursor: pointer;
+	transition:
+		color 0.15s,
+		border-color 0.15s;
+}
+.copy-btn:hover {
+	color: var(--accent-ink);
+	border-color: var(--accent);
+}
+.copy-btn svg {
+	width: 14px;
+	height: 14px;
+}
+.copy-btn .icon-check {
+	display: none;
+}
+.copy-btn.is-copied {
+	color: var(--accent-ink);
+	border-color: var(--accent);
+}
+.copy-btn.is-copied .icon-copy {
+	display: none;
+}
+.copy-btn.is-copied .icon-check {
+	display: block;
+}
+.friend-apply-card .fa-desc {
+	margin-top: 6px;
+	font-size: 14px;
+	color: var(--muted);
+	line-height: 1.7;
+}
+.apply-steps {
+	list-style: none;
+	margin: 16px 0 0;
+	padding: 0;
+	display: grid;
+	gap: 12px;
+}
+.apply-step {
+	display: flex;
+	align-items: flex-start;
+	gap: 12px;
+}
+.apply-step-num {
+	flex: none;
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	width: 22px;
+	height: 22px;
+	border-radius: 50%;
+	background: var(--accent-soft);
+	color: var(--accent-ink);
+	font-size: 12px;
+	font-weight: 700;
+	margin-top: 1px;
+}
+.apply-step-title {
+	font-weight: 600;
+	font-size: 14.5px;
+}
+.apply-step-desc {
+	margin-top: 2px;
+	font-size: 13px;
+	color: var(--muted);
+	line-height: 1.6;
+}
+/* 申请资料模板：整块展示 + 右上角一键复制（对齐参考布局） */
+.apply-template {
+	position: relative;
+	margin-top: 14px;
+	padding: 12px 46px 12px 16px;
+	background: var(--bg-soft);
+	border: 1px solid var(--border);
+	border-radius: 8px;
+}
+.apply-template .copy-btn {
+	position: absolute;
+	top: 8px;
+	right: 8px;
+}
+.apply-template-line {
+	font-size: 13px;
+	color: var(--ink);
+	line-height: 1.9;
+	word-break: break-all;
+}
+.friend-apply-card .btn {
+	margin-top: 16px;
+	width: 100%;
+	justify-content: center;
+}
+.friend-notice {
+	margin-top: 20px;
+}
+.notice-list {
+	margin: 14px 0 0;
+	padding: 0;
+	display: grid;
+	gap: 12px;
+}
+.notice-item dt {
+	font-weight: 700;
+	font-size: 14px;
+}
+.notice-item dd {
+	margin: 2px 0 0;
+	font-size: 13.5px;
+	color: var(--muted);
+	line-height: 1.7;
+}
+
 /* ---------- 10.1 字头像兜底（友链/打赏名单无图时） ---------- */
 .avatar-fallback {
 	display: inline-flex;
@@ -5592,6 +5996,10 @@ a[data-encoded-email] {
 	height: auto;
 	border-radius: var(--radius-sm);
 }
+/* display:block 会覆盖 [hidden] 的 UA 样式，显式声明防生成前空框露出 */
+.poster-img[hidden] {
+	display: none;
+}
 .poster-loading {
 	display: flex;
 	align-items: center;