hd-garden 0.3.0

package/app/lib/oss.ts

@@ -0,0 +1,100 @@
+const encoder = new TextEncoder();
+
+type OssConfig = {
+  accessKeyId: string;
+  accessKeySecret: string;
+  bucket: string;
+  endpoint: string;
+  publicBaseUrl: string;
+  prefix: string;
+  maxUploadBytes: number;
+};
+
+function normalizedUrl(value: string) {
+  return value.replace(/\/+$/u, "");
+}
+
+function getOssConfig(): OssConfig | null {
+  const accessKeyId = process.env.OSS_ACCESS_KEY_ID;
+  const accessKeySecret = process.env.OSS_ACCESS_KEY_SECRET;
+  const bucket = process.env.OSS_BUCKET;
+  const endpoint = process.env.OSS_ENDPOINT;
+  if (!accessKeyId || !accessKeySecret || !bucket || !endpoint) return null;
+
+  const endpointUrl = new URL(endpoint.includes("://") ? endpoint : `https://${endpoint}`);
+  const uploadEndpoint = `${endpointUrl.protocol}//${bucket}.${endpointUrl.host}`;
+  const publicBaseUrl = normalizedUrl(process.env.OSS_PUBLIC_BASE_URL ?? uploadEndpoint);
+  const prefix = (process.env.OSS_PREFIX ?? "blog-media").replace(/^\/+|\/+$/gu, "");
+  const configuredMegabytes = Number(process.env.OSS_MAX_UPLOAD_MB ?? "200");
+  const maxUploadBytes = Number.isFinite(configuredMegabytes) && configuredMegabytes > 0
+    ? Math.floor(configuredMegabytes * 1024 * 1024)
+    : 200 * 1024 * 1024;
+  return { accessKeyId, accessKeySecret, bucket, endpoint: uploadEndpoint, publicBaseUrl, prefix, maxUploadBytes };
+}
+
+export function isOssConfigured() {
+  return Boolean(getOssConfig());
+}
+
+function base64(bytes: Uint8Array) {
+  return btoa(String.fromCharCode(...bytes));
+}
+
+async function signPolicy(policy: string, secret: string) {
+  const key = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(secret),
+    { name: "HMAC", hash: "SHA-1" },
+    false,
+    ["sign"],
+  );
+  return base64(new Uint8Array(await crypto.subtle.sign("HMAC", key, encoder.encode(policy))));
+}
+
+function assetKind(mime: string) {
+  if (mime.startsWith("image/")) return "images";
+  if (mime.startsWith("audio/")) return "audio";
+  if (mime.startsWith("video/")) return "video";
+  return null;
+}
+
+function extension(name: string, mime: string) {
+  const candidate = name.split(".").at(-1)?.toLowerCase();
+  if (candidate && /^[a-z0-9]{1,10}$/u.test(candidate)) return candidate;
+  return mime.split("/")[1]?.replace(/[^a-z0-9]/giu, "").toLowerCase() || "bin";
+}
+
+export async function createOssUploadPolicy(input: { name: string; type: string; size: number }) {
+  const config = getOssConfig();
+  if (!config) throw new Error("尚未配置阿里云 OSS。请设置 OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、OSS_BUCKET 和 OSS_ENDPOINT。");
+  const kind = assetKind(input.type);
+  if (!kind) throw new Error("仅支持图片、音频和视频文件。");
+  if (!input.size || input.size > config.maxUploadBytes) {
+    throw new Error(`单个附件需小于 ${(config.maxUploadBytes / 1024 / 1024).toFixed(0)} MB。`);
+  }
+
+  const fileExtension = extension(input.name, input.type);
+  const key = `${config.prefix}/thoughts/${kind}/${new Date().toISOString().slice(0, 10)}/${crypto.randomUUID()}.${fileExtension}`;
+  const expiresAt = new Date(Date.now() + 10 * 60 * 1000).toISOString();
+  const policy = base64(encoder.encode(JSON.stringify({
+    expiration: expiresAt,
+    conditions: [
+      ["content-length-range", 1, config.maxUploadBytes],
+      ["eq", "$key", key],
+      ["eq", "$success_action_status", "201"],
+    ],
+  })));
+  const signature = await signPolicy(policy, config.accessKeySecret);
+  const encodedKey = key.split("/").map(encodeURIComponent).join("/");
+
+  return {
+    endpoint: config.endpoint,
+    key,
+    policy,
+    signature,
+    accessKeyId: config.accessKeyId,
+    expiresAt,
+    publicUrl: `${config.publicBaseUrl}/${encodedKey}`,
+    maxUploadBytes: config.maxUploadBytes,
+  };
+}

package/app/lib/public-thoughts.ts

@@ -0,0 +1,9 @@
+import { findThought, thoughts } from "./content";
+
+export function getPublishedThoughts() {
+  return thoughts;
+}
+
+export function findPublishedThought(slug: string) {
+  return findThought(slug);
+}

package/app/lib/repository-path.mjs

@@ -0,0 +1,32 @@
+const invalidPostPathMessage = "博文路径不合法，无法修改置顶状态。";
+
+/**
+ * Content entries store paths relative to `content/`, while GitHub's Contents
+ * API expects paths relative to the repository root. Normalize that boundary
+ * without allowing a generated or legacy path to escape `content/posts/`.
+ *
+ * @param {string} sourcePath
+ */
+export function repositoryPostPath(sourcePath) {
+  const relativePath = sourcePath.startsWith("content/")
+    ? sourcePath.slice("content/".length)
+    : sourcePath;
+  const segments = relativePath.split("/");
+  const fileName = segments.at(-1) ?? "";
+  const hasUnsafeSegment = segments.some((segment) => {
+    if (!segment || segment === "." || segment === ".." || segment.includes("\\") || segment.includes("\0")) {
+      return true;
+    }
+    try {
+      const decoded = decodeURIComponent(segment);
+      return decoded === "." || decoded === ".." || decoded.includes("/") || decoded.includes("\\") || decoded.includes("\0");
+    } catch {
+      return true;
+    }
+  });
+
+  if (segments.length < 2 || segments[0] !== "posts" || !fileName.endsWith(".md") || hasUnsafeSegment) {
+    throw new Error(invalidPostPathMessage);
+  }
+  return `content/${relativePath}`;
+}

package/app/lib/site.ts

@@ -0,0 +1,51 @@
+import { headers } from "next/headers";
+import { siteConfig } from "../site.config";
+
+const fallbackUrl = "http://localhost:3000";
+
+export const siteName = siteConfig.name;
+export const siteDescription = siteConfig.description;
+export const githubUsername = siteConfig.author.github;
+
+const normalizeBaseUrl = (value: string) => value.replace(/\/+$/u, "");
+
+export async function getSiteUrl() {
+  const configured = process.env.SITE_URL ?? process.env.NEXT_PUBLIC_SITE_URL;
+  if (configured || process.env.STATIC_EXPORT === "1") {
+    return normalizeBaseUrl(configured ?? fallbackUrl);
+  }
+
+  const requestHeaders = await headers();
+  const host =
+    requestHeaders.get("x-forwarded-host") ??
+    requestHeaders.get("host") ??
+    "localhost:3000";
+  const protocol =
+    requestHeaders.get("x-forwarded-proto") ??
+    (host.startsWith("localhost") ? "http" : "https");
+  return `${protocol}://${host}`;
+}
+
+export function configuredSiteUrl() {
+  return normalizeBaseUrl(
+    process.env.SITE_URL ?? process.env.NEXT_PUBLIC_SITE_URL ?? fallbackUrl,
+  );
+}
+
+export function absoluteUrl(pathname: string, baseUrl: string) {
+  return new URL(pathname, `${normalizeBaseUrl(baseUrl)}/`).toString();
+}
+
+export function webmentionEndpoint() {
+  const explicit = process.env.WEBMENTION_ENDPOINT;
+  if (explicit) return explicit;
+  const domain = process.env.WEBMENTION_IO_DOMAIN;
+  return domain ? `https://webmention.io/${domain}/webmention` : undefined;
+}
+
+export function webmentionApiEndpoint() {
+  const domain = process.env.WEBMENTION_IO_DOMAIN;
+  return domain
+    ? `https://webmention.io/api/mentions.jf2?domain=${encodeURIComponent(domain)}`
+    : undefined;
+}

package/app/page.tsx

@@ -0,0 +1,119 @@
+import Link from "next/link";
+import {
+  ArrowRight,
+  ArrowUpRight,
+  GithubLogo,
+  PushPin,
+} from "@phosphor-icons/react/ssr";
+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";
+
+export const metadata = {
+  title: `${siteConfig.name} · ${siteConfig.tagline}`,
+  description: siteConfig.description,
+};
+
+export default function Home() {
+  const pinned = posts.filter((post) => post.pinned);
+  const thoughts = getPublishedThoughts();
+
+  return (
+    <main className="page-shell home-page">
+      <PageIntro
+        eyebrow="HELLO, WORLD · 你好，世界"
+        title={siteConfig.pages.home.title}
+        subtitle={siteConfig.pages.home.subtitle}
+      >
+        <a
+          className="inline-cta"
+          href={githubUrl}
+          target="_blank"
+          rel="me noopener noreferrer"
+        >
+          <GithubLogo size={21} weight="fill" />
+          在 GitHub 找到我
+          <ArrowUpRight size={16} />
+        </a>
+      </PageIntro>
+
+      {pinned.length > 0 && <section className="home-section">
+        <div className="section-heading accent-heading">
+          <div>
+            <h2>置顶博文</h2>
+          </div>
+          <PushPin size={20} weight="light" aria-hidden="true" />
+        </div>
+        <div className="post-list">
+          {pinned.map((post) => (
+            <Link href={postHref(post)} key={post.path} className="post-row">
+              <time>{formatDate(post.date)}</time>
+              <span>
+                <strong>{post.title}</strong>
+                <small>{post.topic}</small>
+              </span>
+              <ArrowRight size={18} />
+            </Link>
+          ))}
+        </div>
+      </section>}
+
+      {posts.length > 0 && <section className="home-section">
+        <div className="section-heading accent-heading">
+          <div>
+            <h2>最近博文</h2>
+          </div>
+          <Link href="/blog">全部文章 →</Link>
+        </div>
+        <div className="post-list">
+          {posts.slice(0, 5).map((post) => (
+            <Link href={postHref(post)} key={post.path} className="post-row">
+              <time>{formatDate(post.date)}</time>
+              <span>
+                <strong>{post.title}</strong>
+                <small>{post.topic}</small>
+              </span>
+              <ArrowRight size={18} />
+            </Link>
+          ))}
+        </div>
+      </section>}
+
+      {thoughts.length > 0 && <section className="home-section">
+        <div className="section-heading accent-heading">
+          <div>
+            <h2>最近随想</h2>
+          </div>
+          <Link href="/thoughts">进入随想 →</Link>
+        </div>
+        <div className="home-thought-list">
+          {thoughts.slice(0, 5).map((thought) => (
+            <ThoughtCard key={thought.slug} thought={thought} />
+          ))}
+        </div>
+      </section>}
+
+      {columns[0] && <section className="home-section column-preview">
+        <div className="section-heading accent-heading">
+          <div>
+            <h2>主题专栏</h2>
+          </div>
+          <Link href="/columns">全部专栏 →</Link>
+        </div>
+        <Link
+          href={columnHref(columns[0])}
+          className="column-card"
+        >
+          <div>
+            <span>连载中 · {columns.length} 篇</span>
+            <h3>{columns[0].columnTitle}</h3>
+            <p>记录一个人从想法、最小闭环到稳定发布的完整构建过程。</p>
+          </div>
+          <span className="column-number">#01</span>
+        </Link>
+      </section>}
+    </main>
+  );
+}

package/app/robots.ts

@@ -0,0 +1,15 @@
+import type { MetadataRoute } from "next";
+import { absoluteUrl, getSiteUrl } from "./lib/site";
+
+export default async function robots(): Promise<MetadataRoute.Robots> {
+  const baseUrl = await getSiteUrl();
+  return {
+    rules: {
+      userAgent: "*",
+      allow: "/",
+      disallow: ["/api/"],
+    },
+    sitemap: absoluteUrl("/sitemap.xml", baseUrl),
+    host: baseUrl,
+  };
+}

package/app/rss.xml/route.ts

@@ -0,0 +1,84 @@
+import { marked } from "marked";
+import { columnHref, columns, postHref, posts } from "../lib/content";
+import { getPublishedThoughts } from "../lib/public-thoughts";
+import { configuredSiteUrl, siteDescription, siteName } from "../lib/site";
+
+const escapeXml = (value: string) =>
+  value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&apos;");
+
+const cdata = (value: string) => value.replaceAll("]]>", "]]]]><![CDATA[>");
+
+export async function GET() {
+  const origin = configuredSiteUrl();
+  const thoughts = getPublishedThoughts();
+  const entries = [
+    ...posts.map((post) => ({ ...post, path: postHref(post) })),
+    ...columns.map((entry) => ({
+      ...entry,
+      path: columnHref(entry),
+    })),
+    ...thoughts.map((thought) => ({
+      ...thought,
+      description: thought.content.replace(/\s+/gu, " ").slice(0, 180),
+      path: `/thoughts/${thought.slug}`,
+    })),
+  ].sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
+
+  const items = entries
+    .map((entry) => {
+      const body = marked.parse(entry.content, {
+        async: false,
+        gfm: true,
+        breaks: true,
+      });
+      const cover = entry.cover
+        ? `<p><img src="${escapeXml(entry.cover)}" alt="${escapeXml(
+            entry.coverAlt ?? entry.title,
+          )}" /></p>`
+        : "";
+      return `
+    <item>
+      <title>${escapeXml(entry.title)}</title>
+      <link>${origin}${entry.path}</link>
+      <guid isPermaLink="true">${origin}${entry.path}</guid>
+      <pubDate>${new Date(entry.date).toUTCString()}</pubDate>
+      <description>${escapeXml(entry.description ?? "")}</description>
+      ${(entry.tags ?? [])
+        .map((tag) => `<category>${escapeXml(tag)}</category>`)
+        .join("")}
+      <content:encoded><![CDATA[${cdata(`${cover}${body}`)}]]></content:encoded>
+    </item>`;
+    })
+    .join("");
+  const lastBuildDate = new Date(entries.reduce(
+    (latest, entry) => Math.max(latest, Date.parse(entry.updated ?? entry.date)),
+    0,
+  )).toUTCString();
+
+  const xml = `<?xml version="1.0" encoding="UTF-8" ?>
+<rss version="2.0"
+  xmlns:atom="http://www.w3.org/2005/Atom"
+  xmlns:content="http://purl.org/rss/1.0/modules/content/">
+  <channel>
+    <title>${escapeXml(siteName)}</title>
+    <link>${origin}</link>
+    <atom:link href="${origin}/rss.xml" rel="self" type="application/rss+xml" />
+    <description>${escapeXml(siteDescription)}</description>
+    <language>zh-CN</language>
+    <lastBuildDate>${lastBuildDate}</lastBuildDate>
+    ${items}
+  </channel>
+</rss>`;
+
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/rss+xml; charset=utf-8",
+      "Cache-Control": "public, max-age=3600",
+    },
+  });
+}

package/app/site.config.ts

@@ -0,0 +1,35 @@
+import { githubUrl, siteConfig as raw } from "@garden/site-config";
+
+export type PageCopy = {
+  title: string;
+  subtitle: string;
+};
+
+export type AboutPage = PageCopy & {
+  heading?: string;
+  paragraphs?: string[];
+  quote?: string;
+  focus?: string[];
+  cta?: { href: string; label: string };
+};
+
+export type SiteConfig = {
+  name: string;
+  tagline: string;
+  description: string;
+  locale: string;
+  author: { name: string; github: string; githubBio: string; githubPinned?: string[] };
+  pages: {
+    home: PageCopy;
+    blog: PageCopy;
+    thoughts: PageCopy;
+    columns: PageCopy;
+    about: AboutPage;
+    garden: PageCopy;
+  };
+  footer: string;
+};
+
+/** 站点身份来自根目录 site.config.yaml，由 garden sync 生成。 */
+export const siteConfig = raw as SiteConfig;
+export { githubUrl };

package/app/sitemap.ts

@@ -0,0 +1,46 @@
+import type { MetadataRoute } from "next";
+import { columnHref, columns, postHref, posts } from "./lib/content";
+import { absoluteUrl, getSiteUrl } from "./lib/site";
+import { getPublishedThoughts } from "./lib/public-thoughts";
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const baseUrl = await getSiteUrl();
+  const thoughts = getPublishedThoughts();
+  const staticRoutes = [
+    { path: "/", priority: 1, changeFrequency: "weekly" as const },
+    { path: "/blog", priority: 0.9, changeFrequency: "weekly" as const },
+    { path: "/thoughts", priority: 0.8, changeFrequency: "daily" as const },
+    { path: "/columns", priority: 0.8, changeFrequency: "weekly" as const },
+    { path: "/about", priority: 0.5, changeFrequency: "monthly" as const },
+    { path: "/garden", priority: 0.4, changeFrequency: "monthly" as const },
+  ].map((route) => ({
+    url: absoluteUrl(route.path, baseUrl),
+    changeFrequency: route.changeFrequency,
+    priority: route.priority,
+  }));
+
+  return [
+    ...staticRoutes,
+    ...posts.map((post) => ({
+      url: absoluteUrl(postHref(post), baseUrl),
+      lastModified: new Date(post.updated ?? post.date),
+      changeFrequency: "monthly" as const,
+      priority: 0.8,
+    })),
+    ...columns.map((entry) => ({
+      url: absoluteUrl(
+        columnHref(entry),
+        baseUrl,
+      ),
+      lastModified: new Date(entry.updated ?? entry.date),
+      changeFrequency: "monthly" as const,
+      priority: 0.75,
+    })),
+    ...thoughts.map((thought) => ({
+      url: absoluteUrl(`/thoughts/${thought.slug}`, baseUrl),
+      lastModified: new Date(thought.updated ?? thought.date),
+      changeFrequency: "monthly" as const,
+      priority: 0.6,
+    })),
+  ];
+}

package/app/thoughts/[slug]/page.tsx

@@ -0,0 +1,79 @@
+import Link from "next/link";
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { ArrowLeft } from "@phosphor-icons/react/ssr";
+import { Comments } from "../../components/Comments";
+import { ThoughtCard } from "../../components/ThoughtCard";
+import { Webmentions } from "../../components/Webmentions";
+import { thoughts } from "../../lib/content";
+import { findPublishedThought } from "../../lib/public-thoughts";
+import {
+  absoluteUrl,
+  getSiteUrl,
+  webmentionApiEndpoint,
+} from "../../lib/site";
+
+export function generateStaticParams() {
+  return thoughts.map((thought) => ({ slug: thought.slug }));
+}
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const thought = findPublishedThought(slug);
+  if (!thought) return {};
+  const baseUrl = await getSiteUrl();
+  const pathname = `/thoughts/${slug}`;
+  const images = Array.isArray(thought.media)
+    ? thought.media.filter((item) => item.type === "image").slice(0, 4)
+    : [];
+  return {
+    title: thought.title,
+    description: thought.content.replace(/\s+/gu, " ").slice(0, 160),
+    alternates: { canonical: pathname },
+    openGraph: {
+      type: "article",
+      url: absoluteUrl(pathname, baseUrl),
+      title: thought.title,
+      description: thought.content.replace(/\s+/gu, " ").slice(0, 160),
+      publishedTime: new Date(thought.date).toISOString(),
+      images: images.map((item) => ({ url: item.src, alt: item.alt })),
+    },
+    twitter: {
+      card: images.length ? "summary_large_image" : "summary",
+      title: thought.title,
+      description: thought.content.replace(/\s+/gu, " ").slice(0, 160),
+      images: images.map((item) => item.src),
+    },
+  } satisfies Metadata;
+}
+
+export default async function ThoughtPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const thought = findPublishedThought(slug);
+  if (!thought) notFound();
+  const baseUrl = await getSiteUrl();
+  const pathname = `/thoughts/${slug}`;
+
+  return (
+    <main className="page-shell thought-detail-page">
+      <Link href="/thoughts" className="back-link">
+        <ArrowLeft size={16} />
+        返回随想
+      </Link>
+      <ThoughtCard thought={thought} showPermalink={false} />
+      <Webmentions
+        target={absoluteUrl(pathname, baseUrl)}
+        endpoint={webmentionApiEndpoint()}
+      />
+      <Comments slug={`thought:${slug}`} />
+    </main>
+  );
+}

package/app/thoughts/page.tsx

@@ -0,0 +1,33 @@
+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";
+
+export const metadata = {
+  title: siteConfig.pages.thoughts.title,
+  description: siteConfig.pages.thoughts.subtitle,
+};
+
+export default function ThoughtsPage() {
+  const thoughts = getPublishedThoughts();
+
+  return (
+    <main className="page-shell thoughts-page">
+      <PageIntro
+        eyebrow="THOUGHTS / 随想"
+        title={siteConfig.pages.thoughts.title}
+        subtitle={siteConfig.pages.thoughts.subtitle}
+      />
+      {thoughts.length > 0 ? (
+        <div className="thought-stream">
+          {thoughts.map((thought) => (
+            <ThoughtCard key={thought.slug} thought={thought} />
+          ))}
+        </div>
+      ) : (
+        <ContentEmptyState kind="thoughts" />
+      )}
+    </main>
+  );
+}

package/app/yaml.d.ts

@@ -0,0 +1,4 @@
+declare module "*.yaml?raw" {
+  const source: string;
+  export default source;
+}