hd-garden 0.3.2 → 0.3.4

package/app/about/page.tsx

@@ -19,8 +19,8 @@ const focus = about.focus ?? [
 const cta = about.cta ?? { href: "/blog", label: "从博文开始" };
 
 export const metadata = {
-  title: about.title,
-  description: about.subtitle,
+  title: { absolute: siteConfig.name },
+  description: about.subtitle || siteConfig.description,
 };
 
 export default function AboutPage() {

package/app/blog/[...path]/page.tsx

@@ -48,7 +48,7 @@ export async function generateMetadata({
         ? new Date(post.updated).toISOString()
         : undefined,
       tags: post.tags,
-      images: post.cover ? [{ url: post.cover, alt: post.coverAlt }] : undefined,
+      images: post.cover ? [{ url: post.cover, alt: post.title }] : undefined,
     },
     twitter: {
       card: "summary_large_image",
@@ -92,7 +92,7 @@ export default async function PostPage({
             <img
               className="u-photo"
               src={post.cover}
-              alt={post.coverAlt ?? `${post.title} 封面`}
+              alt={`${post.title} 封面`}
             />
           </figure>
         )}

package/app/blog/page.tsx

@@ -1,10 +1,10 @@
 import { Suspense } from "react";
-import { siteConfig } from "../site.config";
+import { siteConfig, siteDocumentTitle } from "../site.config";
 import { BlogArchive } from "../components/BlogArchive";
 
 export const metadata = {
-  title: siteConfig.pages.blog.title,
-  description: siteConfig.pages.blog.subtitle,
+  title: siteDocumentTitle,
+  description: siteConfig.pages.blog.subtitle || siteConfig.description,
 };
 
 export default function BlogIndex() {

package/app/columns/[column]/[...path]/page.tsx

@@ -52,7 +52,7 @@ export async function generateMetadata({
         ? new Date(entry.updated).toISOString()
         : undefined,
       tags: entry.tags,
-      images: entry.cover ? [{ url: entry.cover, alt: entry.coverAlt }] : undefined,
+      images: entry.cover ? [{ url: entry.cover, alt: entry.title }] : undefined,
     },
     twitter: {
       card: "summary_large_image",
@@ -115,7 +115,7 @@ export default async function ColumnEntryPage({
             <img
               className="u-photo"
               src={entry.cover}
-              alt={entry.coverAlt ?? `${entry.title} 封面`}
+              alt={`${entry.title} 封面`}
             />
           </figure>
         )}

package/app/columns/page.tsx

@@ -1,13 +1,14 @@
+/* eslint-disable @next/next/no-img-element -- static GitHub Pages assets must keep their exact paths. */
 import Link from "next/link";
 import { ArrowRight } from "@phosphor-icons/react/ssr";
 import { columnHref, columns } from "../lib/content";
 import { PageIntro } from "../components/PageIntro";
 import { ContentEmptyState } from "../components/ContentEmptyState";
-import { siteConfig } from "../site.config";
+import { siteConfig, siteDocumentTitle } from "../site.config";
 
 export const metadata = {
-  title: siteConfig.pages.columns.title,
-  description: siteConfig.pages.columns.subtitle,
+  title: siteDocumentTitle,
+  description: siteConfig.pages.columns.subtitle || siteConfig.description,
 };
 
 export default function ColumnsPage() {
@@ -33,35 +34,45 @@ export default function ColumnsPage() {
       />
 
       {grouped.length > 0 ? <div className="column-feature-list">
-        {grouped.map(({ slug, entries, first }, index) => (
-          <Link
-            href={columnHref(first)}
-            className="column-feature"
-            key={slug}
-          >
-            <div className="column-feature-copy">
-              <span>
-                {first.columnStatus ?? "持续更新"} · {entries.length} 篇 ·{" "}
-                {first.topic ?? "主题写作"}
-              </span>
-              <h2>{first.columnTitle}</h2>
-              <p>
-                {first.columnDescription ??
-                  first.description ??
-                  "沿着一条清晰的阅读路径，把一个主题持续写深。"}
-              </p>
-              <strong>
-                从第一篇开始
-                <ArrowRight size={17} />
-              </strong>
-            </div>
-            <div className="column-feature-index">
-              <span>主题专栏</span>
-              <strong>{String(index + 1).padStart(2, "0")}</strong>
-              <small>{slug.replaceAll("-", " ").toUpperCase()}</small>
-            </div>
-          </Link>
-        ))}
+        {grouped.map(({ slug, entries, first }, index) => {
+          const cover = first.columnCover
+            ? { src: first.columnCover, alt: first.columnCoverAlt ?? `${first.columnTitle} 专栏封面` }
+            : undefined;
+          return (
+            <Link
+              href={columnHref(first)}
+              className="column-feature"
+              key={slug}
+            >
+              <div className="column-feature-copy">
+                <span>
+                  {first.columnStatus ?? "持续更新"} · {entries.length} 篇 ·{" "}
+                  {first.topic ?? "主题写作"}
+                </span>
+                <h2>{first.columnTitle}</h2>
+                <p>
+                  {first.columnDescription ??
+                    first.description ??
+                    "沿着一条清晰的阅读路径，把一个主题持续写深。"}
+                </p>
+                <strong>
+                  从第一篇开始
+                  <ArrowRight size={17} />
+                </strong>
+              </div>
+              <div className="column-feature-index">
+                {cover && (
+                  <img className="column-feature-cover" src={cover.src} alt={cover.alt} />
+                )}
+                <div className="column-feature-index-label">
+                  <span>主题专栏</span>
+                  <strong>{String(index + 1).padStart(2, "0")}</strong>
+                  <small>{slug.replaceAll("-", " ").toUpperCase()}</small>
+                </div>
+              </div>
+            </Link>
+          );
+        })}
       </div> : <ContentEmptyState kind="columns" />}
     </main>
   );

package/app/components/BlogArchive.tsx

@@ -69,7 +69,7 @@ export function BlogArchive() {
                 <img
                   className="archive-cover"
                   src={post.cover}
-                  alt={post.coverAlt ?? `${post.title} 封面`}
+                  alt={`${post.title} 封面`}
                   loading="lazy"
                 />
               )}

package/app/components/GardenContentGuide.tsx

@@ -26,13 +26,12 @@ function SourcePanel({ path, source, language }: SourcePanelProps) {
 
 const postSource = `---
 title: 我的第一篇文章
-slug: first-post
 date: 2026-08-03T09:00:00+08:00
 description: 这篇文章记录我为什么重新开始写博客。
 topic: 写作
 tags: [Markdown, 博客]
 pinned: false
-cover: ./assets/cover.jpg
+cover: writing/first-post.jpg
 ---
 
 正文从这里开始。
@@ -43,7 +42,6 @@ cover: ./assets/cover.jpg
 
 const thoughtSource = `---
 title: 雨后的散步
-slug: walk-after-rain
 date: 2026-08-03T18:30:00+08:00
 tags: [生活]
 media:
@@ -121,9 +119,9 @@ const guides: Guide[] = [
       "随想适合记录几句话、一个链接或一组多媒体。它同样保存在 Git 仓库中，只需要更少的字段，也可以通过可选管理后台发布。",
     steps: [
       <>
-        直接创建 <code>content/thoughts/&lt;slug&gt;.md</code>，或者在管理后台填写内容。
+        直接创建 <code>content/thoughts/&lt;文件名&gt;.md</code>，或者在管理后台填写内容。
       </>,
-      <>填写标题、唯一 slug 和日期；需要暂存时加入草稿状态。</>,
+      <>文件名就是地址。front matter 填写标题和日期；需要暂存时加入草稿状态。</>,
       <>
         在 <code>media</code> 中按顺序添加图片、音频、视频或外部链接。
       </>,

package/app/components/MarkdownArticle.tsx

@@ -11,6 +11,7 @@ import rehypeSlug from "rehype-slug";
 import rehypeAutolinkHeadings from "rehype-autolink-headings";
 import rehypeHighlight from "rehype-highlight";
 import { MermaidDiagram } from "./MermaidDiagram";
+import { MarkdownImage } from "./MarkdownImage";
 import { ExternalEmbed } from "./ExternalEmbed";
 import { WidgetChart } from "./WidgetChart";
 
@@ -106,11 +107,7 @@ export function MarkdownArticle({ content }: { content: string }) {
               </a>
             );
           },
-          img: ({ alt, ...props }) => (
-            // Native images keep Typora-authored relative paths intact.
-            // eslint-disable-next-line @next/next/no-img-element
-            <img loading="lazy" alt={alt ?? ""} {...props} />
-          ),
+          img: MarkdownImage,
           code: CodeBlock,
           pre: ({ children, ...props }) => {
             const child = Children.only(children);

package/app/components/MarkdownImage.tsx

@@ -0,0 +1,65 @@
+"use client";
+
+import { useEffect, useState, type ComponentPropsWithoutRef } from "react";
+
+type MarkdownImageProps = ComponentPropsWithoutRef<"img">;
+
+export function MarkdownImage({ alt = "", src, ...props }: MarkdownImageProps) {
+  const [open, setOpen] = useState(false);
+  const description = alt || "查看原图";
+
+  useEffect(() => {
+    if (!open) return undefined;
+
+    const closeOnEscape = (event: KeyboardEvent) => {
+      if (event.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("keydown", closeOnEscape);
+    document.body.classList.add("image-preview-open");
+
+    return () => {
+      document.removeEventListener("keydown", closeOnEscape);
+      document.body.classList.remove("image-preview-open");
+    };
+  }, [open]);
+
+  if (!src) return null;
+
+  return (
+    <>
+      <button
+        type="button"
+        className="markdown-image-trigger"
+        onClick={() => setOpen(true)}
+        aria-label={`放大查看：${description}`}
+      >
+        {/* Native images preserve Typora-authored relative paths. */}
+        {/* eslint-disable-next-line @next/next/no-img-element */}
+        <img loading="lazy" alt={alt} src={src} {...props} />
+      </button>
+
+      {open ? (
+        <div
+          className="markdown-image-lightbox"
+          role="dialog"
+          aria-modal="true"
+          aria-label={description}
+          onClick={() => setOpen(false)}
+        >
+          <div className="markdown-image-lightbox-content" onClick={(event) => event.stopPropagation()}>
+            {/* eslint-disable-next-line @next/next/no-img-element */}
+            <img src={src} alt={alt} {...props} />
+            <button
+              type="button"
+              className="markdown-image-lightbox-close"
+              onClick={() => setOpen(false)}
+              aria-label="关闭图片预览"
+            >
+              关闭
+            </button>
+          </div>
+        </div>
+      ) : null}
+    </>
+  );
+}

package/app/garden/page.tsx

@@ -7,7 +7,7 @@ import { TableOfContents } from "../components/TableOfContents";
 import { siteConfig } from "../site.config";
 
 export const metadata = {
-  title: `Garden · ${siteConfig.pages.garden.title}`,
+  title: "Garden",
   description:
     "一个以 Markdown 为内容源、通过 GitHub Pages 发布的个人博客框架，支持博文、随想、专栏、搜索、RSS 与多媒体。",
 };

package/app/garden-modules.d.ts

@@ -33,7 +33,6 @@ declare module "@garden/generated-content" {
     columnCoverAlt?: string;
     order?: number;
     cover?: string;
-    coverAlt?: string;
     mediaType?: "image" | "audio" | "video" | "link" | "text";
     media?: string | MediaItem[];
     mediaAlt?: string;

package/app/globals.css

@@ -250,6 +250,11 @@ button {
   margin-top: 72px;
 }
 
+.home-thought-list {
+  display: grid;
+  gap: 24px;
+}
+
 .section-heading {
   min-height: 40px;
   margin-bottom: 21px;
@@ -1443,7 +1448,7 @@ button {
 }
 
 .archive-row.with-cover {
-  grid-template-columns: 128px minmax(0, 1fr) 20px;
+  grid-template-columns: 160px minmax(0, 1fr) 20px;
 }
 
 .archive-row:hover {
@@ -1469,10 +1474,9 @@ button {
 }
 
 .archive-cover {
-  width: 128px;
-  height: 84px;
+  width: 160px;
+  height: auto;
   display: block;
-  object-fit: cover;
   border: 1px solid var(--line);
 }
 
@@ -1752,23 +1756,54 @@ button {
 }
 
 .column-feature-index {
+  position: relative;
+  overflow: hidden;
+  background: var(--ink);
+  color: var(--paper);
+}
+
+.column-feature-cover {
+  width: 100%;
+  height: 100%;
+  display: block;
+  object-fit: cover;
+  object-position: center;
+  transition: transform 280ms ease;
+}
+
+.column-feature:hover .column-feature-cover,
+.column-feature:focus-visible .column-feature-cover {
+  transform: scale(1.035);
+}
+
+.column-feature-index::after {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(180deg, rgb(16 18 23 / 20%), rgb(16 18 23 / 8%) 48%, rgb(16 18 23 / 60%));
+  pointer-events: none;
+}
+
+.column-feature-index-label {
+  position: absolute;
+  z-index: 1;
+  inset: 0;
   padding: 28px;
   display: flex;
   flex-direction: column;
   justify-content: space-between;
-  background: var(--ink);
-  color: var(--paper);
 }
 
-.column-feature-index span,
-.column-feature-index small {
+.column-feature-index-label span,
+.column-feature-index-label small {
   color: var(--faint);
   font-size: 9px;
   letter-spacing: 0.08em;
 }
 
-.column-feature-index strong {
+.column-feature-index-label strong {
   align-self: center;
+  color: white;
   font-size: 82px;
   line-height: 1;
 }
@@ -1805,10 +1840,9 @@ button {
 
 .article-hero img {
   width: 100%;
-  aspect-ratio: 16 / 8.5;
+  height: auto;
   display: block;
-  object-fit: cover;
-  border: 1px solid var(--line);
+  border: 0;
 }
 
 .post-reading-page .article-summary-row {
@@ -1854,14 +1888,6 @@ button {
   margin: 28px 0 34px;
 }
 
-.article-cover img {
-  width: 100%;
-  aspect-ratio: 16 / 8.5;
-  display: block;
-  object-fit: cover;
-  border: 1px solid var(--line);
-}
-
 .article-header h1 {
   margin: 0;
   font-size: clamp(32px, 4.2vw, 48px);
@@ -2107,6 +2133,35 @@ button {
   padding-left: 25px;
 }
 
+.markdown-body ul {
+  list-style: disc outside;
+}
+
+.markdown-body ol {
+  list-style: decimal outside;
+}
+
+.markdown-body ul ul {
+  list-style-type: circle;
+}
+
+.markdown-body ul ul ul {
+  list-style-type: square;
+}
+
+.markdown-body ol ol {
+  list-style-type: lower-alpha;
+}
+
+.markdown-body ol ol ol {
+  list-style-type: lower-roman;
+}
+
+.markdown-body ul.contains-task-list {
+  padding-left: 0;
+  list-style: none;
+}
+
 .markdown-body li {
   margin: 7px 0;
 }
@@ -2498,7 +2553,68 @@ button {
   padding-block: 0;
 }
 
-.markdown-body img {
+.markdown-image-trigger {
+  display: block;
+  max-width: 100%;
+  margin: 34px auto;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  cursor: zoom-in;
+}
+
+.markdown-image-trigger img {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  margin: 0;
+}
+
+.markdown-image-lightbox {
+  position: fixed;
+  z-index: 100;
+  inset: 0;
+  display: grid;
+  place-items: center;
+  padding: 32px;
+  background: color-mix(in srgb, var(--ink) 82%, transparent);
+  cursor: zoom-out;
+}
+
+.markdown-image-lightbox-content {
+  position: relative;
+  max-width: min(1440px, 100%);
+  max-height: 100%;
+}
+
+.markdown-image-lightbox-content img {
+  display: block;
+  max-width: 100%;
+  max-height: calc(100vh - 64px);
+  width: auto;
+  height: auto;
+  margin: 0;
+  object-fit: contain;
+  cursor: default;
+}
+
+.markdown-image-lightbox-close {
+  position: absolute;
+  top: 12px;
+  right: 12px;
+  padding: 7px 10px;
+  border: 1px solid color-mix(in srgb, white 60%, transparent);
+  background: color-mix(in srgb, var(--ink) 72%, transparent);
+  color: white;
+  font-size: 12px;
+  cursor: pointer;
+}
+
+.image-preview-open {
+  overflow: hidden;
+}
+
+.markdown-body > img {
   max-width: 100%;
   height: auto;
   margin: 34px auto;
@@ -3975,12 +4091,12 @@ button {
   }
 
   .archive-row.with-cover {
-    grid-template-columns: 96px minmax(0, 1fr) 16px;
+    grid-template-columns: 112px minmax(0, 1fr) 16px;
   }
 
   .archive-cover {
-    width: 96px;
-    height: 68px;
+    width: 112px;
+    height: auto;
   }
 
   .archive-meta {
@@ -4023,15 +4139,15 @@ button {
   }
 
   .column-feature-index {
-    min-height: 130px;
-    display: grid;
-    grid-template-columns: 1fr auto;
-    align-items: center;
+    aspect-ratio: 4 / 5;
+    min-height: 0;
   }
 
-  .column-feature-index strong {
-    grid-column: 2;
-    grid-row: 1 / 3;
+  .column-feature-index-label {
+    padding: 20px;
+  }
+
+  .column-feature-index-label strong {
     font-size: 58px;
   }
 

package/app/lib/generated-content.ts

@@ -1,4 +1,4 @@
-// Generated by scripts/build-content.mjs. Edit files in content/ instead.
+// Generated by garden sync. Edit files in content/ instead.
 export type MediaItem = {
   type: "image" | "audio" | "video" | "link";
   src: string;
@@ -33,7 +33,6 @@ export type ContentEntry = {
   columnCoverAlt?: string;
   order?: number;
   cover?: string;
-  coverAlt?: string;
   mediaType?: "image" | "audio" | "video" | "link" | "text";
   media?: string | MediaItem[];
   mediaAlt?: string;
@@ -42,11 +41,10 @@ export type ContentEntry = {
   linkDescription?: string;
 };
 
-export const contentHash = "d29583878502";
+export const contentHash = "86dad25b6dba";
 export const posts = [
   {
     "title": "Markdown 复杂语法实验场",
-    "slug": "markdown-lab",
     "description": "用一篇真实文章验证 Typora 常用语法、数学公式、Mermaid、脚注、表格与原生 HTML。",
     "date": "2026-07-25T00:00:00.000Z",
     "topic": "写作系统",
@@ -59,7 +57,7 @@ export const posts = [
     "pinned": false,
     "readingTime": "10 分钟",
     "cover": "https://images.unsplash.com/photo-1761414500824-e280de5a1b37?auto=format&fit=crop&w=1600&q=84",
-    "coverAlt": "彩色阳台构成的现代建筑立面",
+    "slug": "markdown-lab",
     "path": "markdown-lab",
     "kind": "post",
     "draft": false,
@@ -68,7 +66,6 @@ export const posts = [
   },
   {
     "title": "注意力也是一种界面",
-    "slug": "attention-is-an-interface",
     "description": "当工具越来越聪明，真正稀缺的不是功能，而是我们把注意力放在哪里。",
     "date": "2026-07-21T00:00:00.000Z",
     "updated": "2026-07-23T00:00:00.000Z",
@@ -80,7 +77,7 @@ export const posts = [
     "pinned": true,
     "readingTime": "6 分钟",
     "cover": "https://images.unsplash.com/photo-1630234674857-527eb5534837?auto=format&fit=crop&w=1600&q=84",
-    "coverAlt": "彩色几何建筑立面",
+    "slug": "attention-is-an-interface",
     "path": "attention-is-an-interface",
     "kind": "post",
     "draft": false,
@@ -89,7 +86,6 @@ export const posts = [
   },
   {
     "title": "03 · 带着证据发布",
-    "slug": "ship-with-evidence",
     "description": "“我改完了”不是完成，“用户可以确认它好了”才是。",
     "date": "2026-07-18T00:00:00.000Z",
     "topic": "独立开发",
@@ -98,6 +94,7 @@ export const posts = [
       "发布"
     ],
     "readingTime": "5 分钟",
+    "slug": "ship-with-evidence",
     "path": "building-in-public/ship-with-evidence",
     "kind": "post",
     "draft": false,
@@ -106,7 +103,6 @@ export const posts = [
   },
   {
     "title": "我为什么重新选择本地写作",
-    "slug": "local-first-writing",
     "description": "Markdown 文件、可迁移的媒体资源，以及不被平台锁住的长期写作。",
     "date": "2026-07-12T00:00:00.000Z",
     "topic": "写作系统",
@@ -117,7 +113,7 @@ export const posts = [
     "pinned": true,
     "readingTime": "5 分钟",
     "cover": "https://images.unsplash.com/photo-1501525771695-688643efeea4?auto=format&fit=crop&w=1600&q=84",
-    "coverAlt": "木桌上的笔记本与钢笔",
+    "slug": "local-first-writing",
     "path": "local-first-writing",
     "kind": "post",
     "draft": false,
@@ -126,7 +122,6 @@ export const posts = [
   },
   {
     "title": "02 · 让状态变得可靠",
-    "slug": "stable-state",
     "description": "状态设计的关键，是明确谁拥有事实。",
     "date": "2026-07-10T00:00:00.000Z",
     "topic": "独立开发",
@@ -134,6 +129,7 @@ export const posts = [
       "状态管理"
     ],
     "readingTime": "6 分钟",
+    "slug": "stable-state",
     "path": "building-in-public/stable-state",
     "kind": "post",
     "draft": false,
@@ -142,7 +138,6 @@ export const posts = [
   },
   {
     "title": "01 · 从最小闭环开始",
-    "slug": "smallest-closed-loop",
     "description": "先让最重要的一条路径真正跑通。",
     "date": "2026-07-04T00:00:00.000Z",
     "topic": "独立开发",
@@ -151,6 +146,7 @@ export const posts = [
       "工程"
     ],
     "readingTime": "7 分钟",
+    "slug": "smallest-closed-loop",
     "path": "building-in-public/smallest-closed-loop",
     "kind": "post",
     "draft": false,
@@ -159,7 +155,6 @@ export const posts = [
   },
   {
     "title": "做一个 PDF 阅读器之后，我重新理解了「位置」",
-    "slug": "building-a-pdf-reader",
     "description": "阅读位置不是页码，而是一段连续体验的锚点。",
     "date": "2026-06-28T00:00:00.000Z",
     "topic": "构建手记",
@@ -170,7 +165,7 @@ export const posts = [
     "pinned": false,
     "readingTime": "8 分钟",
     "cover": "https://images.unsplash.com/photo-1623276527153-fa38c1616b05?auto=format&fit=crop&w=1600&q=84",
-    "coverAlt": "桌上的平板电脑、笔记本电脑与咖啡",
+    "slug": "building-a-pdf-reader",
     "path": "building-a-pdf-reader",
     "kind": "post",
     "draft": false,
@@ -179,7 +174,6 @@ export const posts = [
   },
   {
     "title": "从逐词生成理解 KV Cache",
-    "slug": "understand-kv-cache",
     "description": "不从公式开始，而是从模型下一次到底重复算了什么开始。",
     "date": "2026-06-09T00:00:00.000Z",
     "topic": "AI 学习",
@@ -190,7 +184,7 @@ export const posts = [
     "pinned": false,
     "readingTime": "9 分钟",
     "cover": "https://images.unsplash.com/photo-1518770660439-4636190af475?auto=format&fit=crop&w=1600&q=84",
-    "coverAlt": "近距离拍摄的电子电路板",
+    "slug": "understand-kv-cache",
     "path": "understand-kv-cache",
     "kind": "post",
     "draft": false,
@@ -201,7 +195,6 @@ export const posts = [
 export const columns = [
   {
     "title": "01 · 从最小闭环开始",
-    "slug": "smallest-closed-loop",
     "description": "先让最重要的一条路径真正跑通。",
     "date": "2026-07-04T00:00:00.000Z",
     "topic": "独立开发",
@@ -210,6 +203,7 @@ export const columns = [
       "工程"
     ],
     "readingTime": "7 分钟",
+    "slug": "smallest-closed-loop",
     "path": "building-in-public/smallest-closed-loop",
     "kind": "column",
     "draft": false,
@@ -223,7 +217,6 @@ export const columns = [
   },
   {
     "title": "02 · 让状态变得可靠",
-    "slug": "stable-state",
     "description": "状态设计的关键，是明确谁拥有事实。",
     "date": "2026-07-10T00:00:00.000Z",
     "topic": "独立开发",
@@ -231,6 +224,7 @@ export const columns = [
       "状态管理"
     ],
     "readingTime": "6 分钟",
+    "slug": "stable-state",
     "path": "building-in-public/stable-state",
     "kind": "column",
     "draft": false,
@@ -244,7 +238,6 @@ export const columns = [
   },
   {
     "title": "03 · 带着证据发布",
-    "slug": "ship-with-evidence",
     "description": "“我改完了”不是完成，“用户可以确认它好了”才是。",
     "date": "2026-07-18T00:00:00.000Z",
     "topic": "独立开发",
@@ -253,6 +246,7 @@ export const columns = [
       "发布"
     ],
     "readingTime": "5 分钟",
+    "slug": "ship-with-evidence",
     "path": "building-in-public/ship-with-evidence",
     "kind": "column",
     "draft": false,
@@ -268,7 +262,6 @@ export const columns = [
 export const thoughts = [
   {
     "title": "雨后的城市",
-    "slug": "rainy-night",
     "date": "2026-07-24T14:36:00.000Z",
     "tags": [
       "摄影"
@@ -307,6 +300,7 @@ export const thoughts = [
         "description": "一条和这晚阅读有关、值得保留上下文的链接。"
       }
     ],
+    "slug": "rainy-night",
     "path": "rainy-night",
     "kind": "thought",
     "draft": false,
@@ -315,7 +309,6 @@ export const thoughts = [
   },
   {
     "title": "今天的声音",
-    "slug": "field-recording",
     "date": "2026-07-22T10:10:00.000Z",
     "tags": [
       "声音"
@@ -328,6 +321,7 @@ export const thoughts = [
         "title": "今天的声音 · 循环片段"
       }
     ],
+    "slug": "field-recording",
     "path": "field-recording",
     "kind": "thought",
     "draft": false,
@@ -336,7 +330,6 @@ export const thoughts = [
   },
   {
     "title": "慢一点看",
-    "slug": "slow-motion",
     "date": "2026-07-19T01:20:00.000Z",
     "tags": [
       "影像"
@@ -349,6 +342,7 @@ export const thoughts = [
         "poster": "https://images.unsplash.com/photo-1544655205-dcbeb868c648?auto=format&fit=crop&w=1400&q=82"
       }
     ],
+    "slug": "slow-motion",
     "path": "slow-motion",
     "kind": "thought",
     "draft": false,
@@ -357,7 +351,6 @@ export const thoughts = [
   },
   {
     "title": "链接不是收藏，是路径",
-    "slug": "links-are-paths",
     "date": "2026-07-16T04:05:00.000Z",
     "tags": [
       "阅读"
@@ -371,6 +364,7 @@ export const thoughts = [
         "description": "让不同网站之间的回复、喜欢与引用重新连接起来。"
       }
     ],
+    "slug": "links-are-paths",
     "path": "links-are-paths",
     "kind": "thought",
     "draft": false,

package/app/lib/github-content.ts

@@ -72,17 +72,23 @@ function isMedia(value: unknown): value is MediaItem[] {
   });
 }
 
-function normalizeThought(source: string, path: string, sha?: string): RepositoryThought | null {
+function fileStem(filePath: string) {
+  return (filePath.split("/").pop() ?? "").replace(/\.md$/u, "");
+}
+
+function normalizeThought(source: string, filePath: string, sha?: string): RepositoryThought | null {
   const parsed = matter(source);
   const data = parsed.data;
-  if (typeof data.title !== "string" || typeof data.slug !== "string" || typeof data.date !== "string") {
+  const slug = fileStem(filePath);
+  if (typeof data.title !== "string" || typeof data.date !== "string" || !slug) {
     return null;
   }
+  if (data.slug !== undefined && data.slug !== slug) return null;
   const media = isMedia(data.media) ? data.media : [];
   const status = data.draft === true ? "draft" : "published";
   return {
-    id: data.slug,
-    slug: data.slug,
+    id: slug,
+    slug,
     title: data.title,
     date: data.date,
     tags: isStringArray(data.tags) ? data.tags : [],
@@ -90,7 +96,7 @@ function normalizeThought(source: string, path: string, sha?: string): Repositor
     media,
     kind: "thought",
     draft: status === "draft",
-    sourcePath: path,
+    sourcePath: filePath,
     content: parsed.content.trim(),
     status,
     sha,
@@ -108,7 +114,6 @@ function serializeThought(thought: {
 }) {
   return matter.stringify(thought.content.trim().concat("\n"), {
     title: thought.title,
-    slug: thought.slug,
     date: thought.date ?? new Date().toISOString(),
     tags: thought.tags,
     mediaType: thought.media[0]?.type ?? "text",
@@ -227,7 +232,7 @@ export async function updateRepositoryPostPinned(input: {
   const existing = await readRepositoryFile(repositoryPath);
   if (!existing) throw new Error("未找到对应博文。");
   const parsed = matter(existing.source);
-  if (parsed.data.slug !== input.slug) {
+  if (fileStem(repositoryPath) !== input.slug) {
     throw new Error("博文标识不匹配，已拒绝修改。");
   }
   const data = { ...parsed.data } as Record<string, unknown>;

package/app/page.tsx

@@ -9,10 +9,10 @@ import { columnHref, columns, formatDate, postHref, posts } from "./lib/content"
 import { ThoughtCard } from "./components/ThoughtCard";
 import { PageIntro } from "./components/PageIntro";
 import { getPublishedThoughts } from "./lib/public-thoughts";
-import { githubUrl, siteConfig } from "./site.config";
+import { githubUrl, siteConfig, siteDocumentTitle } from "./site.config";
 
 export const metadata = {
-  title: `${siteConfig.name} · ${siteConfig.tagline}`,
+  title: siteDocumentTitle,
   description: siteConfig.description,
 };
 

package/app/rss.xml/route.ts

@@ -37,9 +37,7 @@ export async function GET() {
         breaks: true,
       });
       const cover = entry.cover
-        ? `<p><img src="${escapeXml(entry.cover)}" alt="${escapeXml(
-            entry.coverAlt ?? entry.title,
-          )}" /></p>`
+        ? `<p><img src="${escapeXml(entry.cover)}" alt="${escapeXml(entry.title)}" /></p>`
         : "";
       return `
     <item>

package/app/site.config.ts

@@ -33,3 +33,6 @@ export type SiteConfig = {
 /** 站点身份来自根目录 site.config.yaml，由 garden sync 生成。 */
 export const siteConfig = raw as SiteConfig;
 export { githubUrl };
+
+/** 列表页浏览器标题用站点名；页面大标题仍用 pages.*.title。 */
+export const siteDocumentTitle = { absolute: siteConfig.name };

package/app/thoughts/page.tsx

@@ -2,11 +2,11 @@ import { getPublishedThoughts } from "../lib/public-thoughts";
 import { ThoughtCard } from "../components/ThoughtCard";
 import { ContentEmptyState } from "../components/ContentEmptyState";
 import { PageIntro } from "../components/PageIntro";
-import { siteConfig } from "../site.config";
+import { siteConfig, siteDocumentTitle } from "../site.config";
 
 export const metadata = {
-  title: siteConfig.pages.thoughts.title,
-  description: siteConfig.pages.thoughts.subtitle,
+  title: siteDocumentTitle,
+  description: siteConfig.pages.thoughts.subtitle || siteConfig.description,
 };
 
 export default function ThoughtsPage() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",

package/scripts/build-content.mjs

@@ -71,12 +71,13 @@ const isExternalAsset = (value) =>
 
 const assetCache = new Map();
 
-function copyLocalAsset(value, markdownPath, sourcePath) {
+function copyLocalAsset(value, markdownPath, sourcePath, options = {}) {
   if (!value || isExternalAsset(value)) return value;
 
+  const baseDir = options.baseDir ?? path.dirname(markdownPath);
   const [assetPath, suffix = ""] = value.split(/(?=[?#])/u, 2);
   const decodedPath = decodeURIComponent(assetPath.replace(/^<|>$/g, ""));
-  const absoluteSource = path.resolve(path.dirname(markdownPath), decodedPath);
+  const absoluteSource = path.resolve(baseDir, decodedPath);
   const relativeSource = path.relative(contentRoot, absoluteSource);
 
   if (
@@ -85,7 +86,7 @@ function copyLocalAsset(value, markdownPath, sourcePath) {
     !fs.existsSync(absoluteSource) ||
     !fs.statSync(absoluteSource).isFile()
   ) {
-    fail(sourcePath, `找不到本地媒体文件 ${value}`);
+    fail(sourcePath, options.missingMessage ?? `找不到本地媒体文件 ${value}`);
   }
 
   if (!assetCache.has(absoluteSource)) {
@@ -254,9 +255,12 @@ function normalizeMedia(media, markdownPath, sourcePath) {
 
 function validateAndNormalize(data, content, markdownPath, kind, sourcePath) {
   const title = requireString(data, "title", sourcePath);
-  const slug = optionalString(data, "slug", sourcePath) ?? path.basename(markdownPath, ".md");
+  const slug = path.basename(markdownPath, ".md");
   if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(slug)) {
-    fail(sourcePath, "slug 只能包含小写字母、数字和连字符");
+    fail(sourcePath, "文件名只能包含小写字母、数字和连字符");
+  }
+  if (data.slug !== undefined) {
+    fail(sourcePath, "不要写 slug，文件名就是标识");
   }
 
   const date = normalizeDate(data.date, "date", sourcePath);
@@ -286,6 +290,7 @@ function validateAndNormalize(data, content, markdownPath, kind, sourcePath) {
 
   const publishTime = Date.parse(publishAt ?? date);
   if (!includeDrafts && (data.draft === true || publishTime > now)) return null;
+  delete data.coverAlt;
 
   return {
     ...data,
@@ -301,7 +306,10 @@ function validateAndNormalize(data, content, markdownPath, kind, sourcePath) {
     draft: Boolean(data.draft),
     sourcePath,
     cover: data.cover
-      ? copyLocalAsset(data.cover, markdownPath, sourcePath)
+      ? copyLocalAsset(data.cover, markdownPath, sourcePath, {
+          baseDir: path.join(contentRoot, "covers"),
+          missingMessage: `找不到封面 ${data.cover}；本地路径相对 content/covers`,
+        })
       : undefined,
     columnCover: data.columnCover
       ? copyLocalAsset(data.columnCover, markdownPath, sourcePath)
@@ -399,7 +407,7 @@ function readColumnReferences(posts) {
     if (seenColumns.has(slug)) fail(sourcePath, `专栏 slug ${slug} 重复。`);
     seenColumns.add(slug);
     if (!Array.isArray(value.posts) || !value.posts.every((entry) => typeof entry === "string")) {
-      fail(sourcePath, "posts 必须是博文 slug 或相对路径数组。");
+      fail(sourcePath, "posts 必须是博文相对路径数组。");
     }
     const referenced = new Set();
     return value.posts.map((postReference, order) => {
@@ -487,7 +495,6 @@ export type ContentEntry = {
   columnCoverAlt?: string;
   order?: number;
   cover?: string;
-  coverAlt?: string;
   mediaType?: "image" | "audio" | "video" | "link" | "text";
   media?: string | MediaItem[];
   mediaAlt?: string;

package/scripts/new-post.mjs

@@ -39,7 +39,6 @@ async function main() {
   const markdown = [
     "---",
     `title: ${JSON.stringify(title)}`,
-    `slug: ${slug}`,
     `date: ${date}`,
     `description: ${JSON.stringify("请填写一句话摘要。")}`,
     `topic: ${JSON.stringify(topic)}`,

package/templates/site/package.json

@@ -14,6 +14,6 @@
     "pages:prepare": "garden pages:prepare"
   },
   "dependencies": {
-    "hd-garden": "^0.3.2",
+    "hd-garden": "^0.3.3",
   }
 }