hd-garden 0.3.0

package/scripts/fetch-embed.mjs

@@ -0,0 +1,189 @@
+import { lookup } from "node:dns/promises";
+import { isIP } from "node:net";
+
+const timeoutMs = 8000;
+const maxBytes = 1_000_000;
+const maxRedirects = 3;
+
+const option = (name) => (process.env[`GARDEN_EMBED_${name}`] ?? "").trim();
+
+function fail(message) {
+  throw new Error(message);
+}
+
+function decodeEntities(value) {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll(""", '"')
+    .replaceAll("'", "'")
+    .replaceAll("'", "'")
+    .replaceAll("&lt;", "<")
+    .replaceAll("&gt;", ">")
+    .replace(/&#(\d+);/gu, (_, code) => String.fromCodePoint(Number(code)))
+    .replace(/&#x([0-9a-f]+);/giu, (_, code) => String.fromCodePoint(Number.parseInt(code, 16)))
+    .replaceAll("&nbsp;", " ")
+    .trim();
+}
+
+function isBlockedHostname(hostname) {
+  const host = hostname.replace(/\.$/u, "").toLowerCase();
+  return (
+    host === "localhost" ||
+    host.endsWith(".localhost") ||
+    host.endsWith(".local") ||
+    host === "0.0.0.0" ||
+    host === "::" ||
+    host === "[::1]"
+  );
+}
+
+function isBlockedAddress(address) {
+  const ip = address.toLowerCase().replace(/^\[|\]$/gu, "");
+  if (ip === "127.0.0.1" || ip === "::1" || ip === "::" || ip === "0.0.0.0") return true;
+  if (ip.startsWith("fe80:") || ip.startsWith("fc") || ip.startsWith("fd")) return true;
+  if (ip.startsWith("::ffff:")) return isBlockedAddress(ip.slice(7));
+
+  const parts = ip.split(".").map(Number);
+  if (parts.length !== 4 || parts.some((part) => Number.isNaN(part))) return false;
+  if (parts[0] === 0 || parts[0] === 10 || parts[0] === 127) return true;
+  if (parts[0] === 169 && parts[1] === 254) return true;
+  if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true;
+  if (parts[0] === 192 && parts[1] === 168) return true;
+  return false;
+}
+
+async function assertPublicHttpUrl(raw) {
+  let url;
+  try {
+    url = new URL(raw);
+  } catch {
+    fail("URL 无效。");
+  }
+  if (!["http:", "https:"].includes(url.protocol)) fail("只接受 http 或 https。");
+  if (url.username || url.password) fail("URL 不能带用户名或密码。");
+  if (isBlockedHostname(url.hostname) || isIP(url.hostname) && isBlockedAddress(url.hostname)) {
+    fail("不能抓取本机、内网或链路本地地址。");
+  }
+
+  const records = await lookup(url.hostname, { all: true, verbatim: true });
+  if (records.some((record) => isBlockedAddress(record.address))) {
+    fail("不能抓取解析到内网或本机的地址。");
+  }
+  return url;
+}
+
+function metaContent(html, keys) {
+  for (const key of keys) {
+    const escaped = key.replaceAll(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    const patterns = [
+      new RegExp(
+        `<meta\\b[^>]*?(?:property|name)=["']${escaped}["'][^>]*?\\bcontent=["']([^"']*)["'][^>]*>`,
+        "iu",
+      ),
+      new RegExp(
+        `<meta\\b[^>]*?\\bcontent=["']([^"']*)["'][^>]*?(?:property|name)=["']${escaped}["'][^>]*>`,
+        "iu",
+      ),
+    ];
+    for (const pattern of patterns) {
+      const match = html.match(pattern)?.[1];
+      if (match) return decodeEntities(match);
+    }
+  }
+  return undefined;
+}
+
+function pageTitle(html) {
+  const match = html.match(/<title[^>]*>([\s\S]*?)<\/title>/iu)?.[1];
+  return match ? decodeEntities(match.replaceAll(/\s+/gu, " ")) : undefined;
+}
+
+function yamlScalar(value) {
+  return JSON.stringify(value);
+}
+
+async function readLimited(response) {
+  const type = response.headers.get("content-type") ?? "";
+  if (!/text\/html|application\/xhtml\+xml/iu.test(type) && type !== "") {
+    fail(`响应不是 HTML（${type}）。`);
+  }
+
+  const reader = response.body?.getReader();
+  if (!reader) fail("响应没有正文。");
+
+  const chunks = [];
+  let size = 0;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.byteLength;
+    if (size > maxBytes) fail("页面过大，已停止抓取。");
+    chunks.push(value);
+  }
+  return new TextDecoder("utf-8").decode(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))));
+}
+
+async function fetchPublic(url, redirectsLeft) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, {
+      redirect: "manual",
+      signal: controller.signal,
+      headers: {
+        accept: "text/html,application/xhtml+xml",
+        "user-agent": "GardenEmbedSnapshot/1.0",
+      },
+    });
+    if ([301, 302, 303, 307, 308].includes(response.status)) {
+      if (redirectsLeft <= 0) fail("重定向次数过多。");
+      const location = response.headers.get("location");
+      if (!location) fail("重定向缺少 Location。");
+      const next = await assertPublicHttpUrl(new URL(location, url).toString());
+      return fetchPublic(next, redirectsLeft - 1);
+    }
+    if (!response.ok) fail(`抓取失败：HTTP ${response.status}。`);
+    return readLimited(response);
+  } catch (error) {
+    if (error?.name === "AbortError") fail("抓取超时。");
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function main() {
+  const raw = option("URL") || process.argv[2] || "";
+  if (!raw) fail('用法：make embed URL="https://example.com/article"');
+
+  const url = await assertPublicHttpUrl(raw);
+  const html = await fetchPublic(url, maxRedirects);
+  const title = metaContent(html, ["og:title", "twitter:title"]) ?? pageTitle(html);
+  const description = metaContent(html, ["og:description", "twitter:description", "description"]);
+  const image = metaContent(html, ["og:image", "twitter:image", "twitter:image:src"]);
+
+  if (image) {
+    try {
+      const imageUrl = new URL(image, url);
+      if (!["http:", "https:"].includes(imageUrl.protocol)) fail("封面地址不是 http(s)。");
+    } catch {
+      fail("封面地址无效。");
+    }
+  }
+
+  const lines = ["```embed", `url: ${url.toString()}`];
+  if (title) lines.push(`title: ${yamlScalar(title)}`);
+  if (description) lines.push(`description: ${yamlScalar(description)}`);
+  if (image) lines.push(`image: ${yamlScalar(new URL(image, url).toString())}`);
+  lines.push("```");
+
+  process.stdout.write(`${lines.join("\n")}\n`);
+  if (!title && !description) {
+    process.stderr.write("已生成围栏，但页面没有标题或摘要，请手工补全。\n");
+  }
+}
+
+main().catch((error) => {
+  console.error(`拉取失败：${error.message}`);
+  process.exitCode = 1;
+});

package/scripts/garden-paths.mjs

@@ -0,0 +1,21 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const gardenPackageRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "..",
+);
+
+export function gardenSiteRoot() {
+  if (process.env.GARDEN_SITE) return path.resolve(process.env.GARDEN_SITE);
+  const yaml = path.join(process.cwd(), "site.config.yaml");
+  if (fs.existsSync(yaml)) {
+    return path.dirname(fs.realpathSync(yaml));
+  }
+  return process.cwd();
+}
+
+export function gardenCacheDir(root = gardenSiteRoot()) {
+  return path.join(root, ".garden");
+}

package/scripts/new-post.mjs

@@ -0,0 +1,73 @@
+import { randomUUID } from "node:crypto";
+import { lstat, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+const root = path.resolve(process.env.GARDEN_SITE || process.cwd());
+const option = (name) => (process.env[`GARDEN_NEW_${name}`] ?? "").trim();
+
+async function main() {
+  const title = option("TITLE") || "新文章";
+  const date = new Date().toISOString();
+  const titleSlug = title.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-|-$/gu, "");
+  const slug = option("SLUG") || titleSlug || `post-${date.slice(0, 10)}-${randomUUID().slice(0, 8)}`;
+  const directory = option("DIR");
+  const topic = option("TOPIC") || "未分类";
+
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(slug)) {
+    throw new Error("SLUG 只能包含小写字母、数字和连字符，不含 .md 后缀。");
+  }
+  const segments = directory ? directory.split("/") : [];
+  if (segments.some((segment) => !/^[\p{L}\p{N}_-]+$/u.test(segment))) {
+    throw new Error("DIR 应为 content/posts 下的相对目录，各级只使用文字、数字、下划线或连字符，例如 go/runtime。");
+  }
+
+  let parent = root;
+  for (const segment of ["content", "posts", ...segments]) {
+    parent = path.join(parent, segment);
+    try {
+      await mkdir(parent);
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+    }
+    if (!(await lstat(parent)).isDirectory()) {
+      throw new Error(`目录不可用（不支持符号链接）：${parent}`);
+    }
+  }
+
+  const destination = path.join(parent, `${slug}.md`);
+  // JSON strings are valid YAML scalars, including quotes, colons and newlines.
+  const markdown = [
+    "---",
+    `title: ${JSON.stringify(title)}`,
+    `slug: ${slug}`,
+    `date: ${date}`,
+    `description: ${JSON.stringify("请填写一句话摘要。")}`,
+    `topic: ${JSON.stringify(topic)}`,
+    "tags: []",
+    "draft: true",
+    "---",
+    "",
+    "## 起因",
+    "",
+    "从这里开始写正文。",
+    "",
+  ].join("\n");
+  try {
+    await writeFile(destination, markdown, { flag: "wx" });
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      throw new Error(`文章已存在，未覆盖：${path.relative(root, destination)}。请换一个 SLUG。`);
+    }
+    throw error;
+  }
+
+  console.log(`已创建草稿：${path.relative(root, destination)}`);
+  console.log(`文章路径：/blog/${[...segments, slug].join("/")}/`);
+  console.log("预览：CONTENT_INCLUDE_DRAFTS=1 make dev");
+  console.log("发布前请完善摘要、分类与正文，并将 draft 改为 false，再运行 make update。");
+}
+
+main().catch((error) => {
+  console.error(`创建失败：${error.message}`);
+  process.exitCode = 1;
+});

package/scripts/prepare-pages-output.mjs

@@ -0,0 +1,182 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const forbiddenDirectoryNames = new Set([
+  ".git",
+  ".github",
+  "app",
+  "content",
+  "node_modules",
+  "scripts",
+  "tests",
+]);
+const forbiddenFileNames = new Set([
+  "Makefile",
+  "eslint.config.mjs",
+  "site.config.yaml",
+  "tsconfig.json",
+  "vinext.config.ts",
+  "wrangler.jsonc",
+]);
+const forbiddenExtensions = new Set([".map", ".md", ".ts", ".tsx"]);
+const deploymentVersionPlaceholder = "00000000-0000-4000-8000-000000000000";
+
+function fail(message) {
+  throw new Error(`Pages 产物无效：${message}`);
+}
+
+async function assertDirectory(directory, label) {
+  let stat;
+  try {
+    stat = await fs.stat(directory);
+  } catch {
+    fail(`${label}不存在：${directory}`);
+  }
+  if (!stat.isDirectory()) fail(`${label}不是目录：${directory}`);
+}
+
+async function inspectTree(root, directory = root) {
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+  for (const entry of entries) {
+    const absolutePath = path.join(directory, entry.name);
+    const relativePath = path.relative(root, absolutePath).split(path.sep).join("/");
+    const stat = await fs.lstat(absolutePath);
+
+    if (stat.isSymbolicLink()) fail(`不允许软链接：${relativePath}`);
+    if (forbiddenDirectoryNames.has(entry.name)) {
+      fail(`不允许源码目录：${relativePath}`);
+    }
+    if (entry.name.startsWith(".env")) fail(`不允许环境文件：${relativePath}`);
+    if (/^package(?:-lock)?\.json$/u.test(entry.name)) {
+      fail(`不允许依赖清单：${relativePath}`);
+    }
+    if (forbiddenFileNames.has(entry.name)) {
+      fail(`不允许源码配置：${relativePath}`);
+    }
+    if (entry.isFile() && forbiddenExtensions.has(path.extname(entry.name))) {
+      fail(`不允许源码或 Source Map：${relativePath}`);
+    }
+    if (entry.isDirectory()) await inspectTree(root, absolutePath);
+  }
+}
+
+function normalizeDeploymentVersion(content, replacement) {
+  return content
+    .replace(
+      /("deploymentVersion":")[^"]+(")/gu,
+      `$1${replacement}$2`,
+    )
+    .replace(
+      /(\\["]deploymentVersion\\["]:\\["])[^"\\]+(\\["])/gu,
+      `$1${replacement}$2`,
+    );
+}
+
+async function listFiles(root, directory = root) {
+  const files = [];
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+  entries.sort((left, right) => left.name.localeCompare(right.name));
+  for (const entry of entries) {
+    if (entry.name === ".git") continue;
+    const absolutePath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await listFiles(root, absolutePath));
+    } else {
+      files.push({
+        absolutePath,
+        relativePath: path.relative(root, absolutePath).split(path.sep).join("/"),
+      });
+    }
+  }
+  return files;
+}
+
+async function stabilizeDeploymentVersion(root) {
+  const hash = crypto.createHash("sha256");
+  const normalizedFiles = new Map();
+
+  for (const file of await listFiles(root)) {
+    const original = await fs.readFile(file.absolutePath);
+    let normalized = original;
+    if ([".html", ".rsc"].includes(path.extname(file.relativePath))) {
+      const text = original.toString("utf8");
+      normalized = Buffer.from(
+        normalizeDeploymentVersion(text, deploymentVersionPlaceholder),
+        "utf8",
+      );
+      normalizedFiles.set(file.absolutePath, normalized);
+    }
+    hash.update(file.relativePath);
+    hash.update("\0");
+    hash.update(normalized);
+    hash.update("\0");
+  }
+
+  const digest = hash.digest("hex");
+  const version = [
+    digest.slice(0, 8),
+    digest.slice(8, 12),
+    `4${digest.slice(13, 16)}`,
+    `8${digest.slice(17, 20)}`,
+    digest.slice(20, 32),
+  ].join("-");
+
+  for (const [filePath, content] of normalizedFiles) {
+    const stabilized = normalizeDeploymentVersion(content.toString("utf8"), version);
+    await fs.writeFile(filePath, stabilized);
+  }
+}
+
+export async function validateStaticOutput(sourceDirectory) {
+  const source = path.resolve(sourceDirectory);
+  await assertDirectory(source, "静态产物目录");
+  await fs.access(path.join(source, "index.html")).catch(() => {
+    fail(`缺少入口文件：${path.join(source, "index.html")}`);
+  });
+  await inspectTree(source);
+  return source;
+}
+
+export async function preparePagesOutput(sourceDirectory, destinationDirectory) {
+  const source = await validateStaticOutput(sourceDirectory);
+  const destination = path.resolve(destinationDirectory);
+  await assertDirectory(destination, "Pages 仓库目录");
+  await fs.access(path.join(destination, ".git")).catch(() => {
+    fail(`目标不是 Git 仓库：${destination}`);
+  });
+
+  const relativeFromDestination = path.relative(destination, source);
+  if (!relativeFromDestination.startsWith("..") && !path.isAbsolute(relativeFromDestination)) {
+    fail("静态产物目录不能位于目标仓库内部");
+  }
+
+  for (const entry of await fs.readdir(destination, { withFileTypes: true })) {
+    if (entry.name === ".git") continue;
+    await fs.rm(path.join(destination, entry.name), { recursive: true, force: true });
+  }
+
+  await fs.cp(source, destination, { recursive: true, force: true });
+  await fs.writeFile(path.join(destination, ".nojekyll"), "");
+  await fs.writeFile(
+    path.join(destination, "README.md"),
+    "# Garden 静态站点\n\n此仓库只保存 Garden 自动生成的公开静态文件，请勿手工编辑。\n",
+  );
+  await stabilizeDeploymentVersion(destination);
+}
+
+const invokedDirectly = process.argv[1] &&
+  import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
+
+if (invokedDirectly) {
+  const [, , sourceDirectory, destinationDirectory] = process.argv;
+  if (!sourceDirectory || process.argv.length > 4) {
+    throw new Error("用法：node scripts/prepare-pages-output.mjs <静态产物目录> [Pages 仓库目录]");
+  }
+  if (destinationDirectory) {
+    await preparePagesOutput(sourceDirectory, destinationDirectory);
+  } else {
+    await validateStaticOutput(sourceDirectory);
+  }
+}

package/scripts/send-webmentions.mjs

@@ -0,0 +1,27 @@
+const siteUrl = (process.env.SITE_URL ?? process.env.NEXT_PUBLIC_SITE_URL)?.replace(
+  /\/+$/u,
+  "",
+);
+
+if (!siteUrl || siteUrl.includes("example.com")) {
+  throw new Error("请先通过 SITE_URL 配置已经公开访问的正式站点地址。");
+}
+
+const feedUrl = `${siteUrl}/rss.xml`;
+const endpoint = new URL("https://webmention.app/check");
+endpoint.searchParams.set("url", feedUrl);
+
+const response = await fetch(endpoint, {
+  method: "POST",
+  headers: { Accept: "application/json" },
+});
+
+if (!response.ok) {
+  throw new Error(
+    `发送 Webmentions 失败：${response.status} ${response.statusText}`,
+  );
+}
+
+const results = await response.json();
+const sent = Array.isArray(results) ? results.length : 0;
+console.log(`Checked ${feedUrl}; discovered ${sent} outgoing Webmention targets.`);

package/site.config.yaml

@@ -0,0 +1,48 @@
+name: Garden
+tagline: 写作 · 构建 · 保持好奇
+description: 一个可 fork、可长期维护的 Markdown 个人博客系统。
+locale: zh_CN
+
+author:
+  name: Your Name
+  github: your-github-id
+  githubBio: Write a short introduction for your GitHub profile card.
+  # 可选：本地没有 GITHUB_TOKEN 时用作置顶仓库降级数据。
+  githubPinned: []
+
+# 一级页面配置标题和副标题。关于页还可以写 heading / paragraphs / quote / focus / cta。
+pages:
+  home:
+    title: |-
+      把复杂的事，
+      慢慢想明白。
+    subtitle: 在这里记录产品、工程、学习与日常生活中值得慢慢想明白的事。
+  blog:
+    title: 长期写下去，偶尔回头整理。
+    subtitle: 这里是完整文章：有明确主题、有持续论证，也允许自己在更新里修正旧判断。
+  thoughts:
+    title: 不够写成文章的，也值得留下。
+    subtitle: 私人朋友圈式的轻量记录：短文字、照片、声音、影像，以及偶然遇见的链接。
+  columns:
+    title: 把一个主题，写到足够深入。
+    subtitle: 专栏不是标签集合，而是一条有顺序的阅读路径。左侧章节导航会在阅读时始终陪着你。
+  about:
+    title: 你好，我是 Your Name。
+    subtitle: 在这里写下你关心的问题、长期的方向，以及你希望如何与世界保持联系。
+    heading: 这个网站为什么存在
+    paragraphs:
+      - 我需要一个不被信息流推着走的地方。长文可以慢慢展开，随想可以轻轻放下；同一个主题也可以沿着清晰的顺序持续生长。
+      - 所有文章都从本地 Markdown 文件开始。这意味着我可以继续在 Typora 里写作，也意味着内容不会被某个编辑器或平台锁住。
+    quote: 写作不是把已经想明白的东西记下来，而是在句子之间发现自己还没有想明白什么。
+    focus:
+      - 将自己的关注方向写在这里
+      - 用文章积累可迁移的知识
+      - 为长期写作留出稳定的空间
+    cta:
+      href: /blog
+      label: 从博文开始
+  garden:
+    title: 一个基于 Markdown 的个人博客框架。
+    subtitle: ""
+
+footer: 保持独立，持续写作。

package/templates/site/Makefile

@@ -0,0 +1,46 @@
+MESSAGE ?= 更新博客
+
+.DEFAULT_GOAL := help
+
+.PHONY: help new embed skill prepare dev check build update
+
+unexport TITLE SLUG DIR TOPIC URL
+export GARDEN_NEW_TITLE := $(value TITLE)
+export GARDEN_NEW_SLUG := $(value SLUG)
+export GARDEN_NEW_DIR := $(value DIR)
+export GARDEN_NEW_TOPIC := $(value TOPIC)
+export GARDEN_EMBED_URL := $(value URL)
+
+help:
+	@printf "%s\n" "Garden 常用命令：" "  make new                 创建文章草稿（无需安装 npm 依赖）" '  make new TITLE="文章标题" SLUG=my-post DIR=writing TOPIC="写作"' '  make embed URL="https://example.com"  拉取外部网页摘要' "  make skill               安装可交互图表 skill" "  make dev                 安装依赖并本地预览" "  make build               构建公开站点" "  make update              检查、提交并触发自动发布"
+
+new:
+	@node scripts/new-post.mjs
+
+embed:
+	@npx garden embed
+
+skill: prepare
+	npx garden skill
+
+prepare:
+	@if [ ! -d node_modules ]; then npm install; fi
+
+dev: prepare
+	npx garden dev
+
+check: prepare
+	npx garden sync && npx garden build
+
+build: prepare
+	npx garden build
+
+update:
+	@if git diff --quiet && git diff --cached --quiet && [ -z "$$(git ls-files --others --exclude-standard)" ]; then \
+		echo "没有需要发布的改动"; \
+	else \
+		$(MAKE) check && \
+		git add -A && \
+		git commit -m "$(MESSAGE)" && \
+		git push origin HEAD; \
+	fi

package/templates/site/README.md

@@ -0,0 +1,13 @@
+# 我的 Garden
+
+这个仓库只保存稿件和站点身份：`content/` 与 `site.config.yaml`。页面引擎来自 [Garden](https://github.com/hedon954/garden)。
+
+```bash
+npm install
+make new TITLE="你好，世界" SLUG=hello
+make dev
+```
+
+第一次 `npx garden dev` 会补齐 Makefile、写稿脚本和图表 skill。Cursor / Codex 打开这个仓库后会读到 `.agents/skills/garden-interactive-chart`。要更新 skill，再运行 `npx garden skill`。
+
+升级引擎：把 `package.json` 里的 `hd-garden` 改到新版本，例如 `^0.4.0`，再运行 `npm install`。

package/templates/site/content/columns.yaml

@@ -0,0 +1 @@
+columns: []

package/templates/site/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-garden",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "dev": "garden dev",
+    "build": "garden build",
+    "start": "garden start",
+    "sync": "garden sync",
+    "pages:validate": "garden pages:validate",
+    "pages:prepare": "garden pages:prepare"
+  },
+  "dependencies": {
+    "hd-garden": "^0.3.0"
+  }
+}

package/templates/site/site.config.yaml

@@ -0,0 +1,46 @@
+name: Garden
+tagline: 写作 · 构建 · 保持好奇
+description: 一个可长期维护的 Markdown 个人博客。
+locale: zh_CN
+
+author:
+  name: Your Name
+  github: your-github-id
+  githubBio: Write a short introduction for your GitHub profile card.
+  githubPinned: []
+
+pages:
+  home:
+    title: |-
+      把复杂的事，
+      慢慢想明白。
+    subtitle: 在这里记录产品、工程、学习与日常生活中值得慢慢想明白的事。
+  blog:
+    title: 长期写下去，偶尔回头整理。
+    subtitle: 这里是完整文章：有明确主题、有持续论证，也允许自己在更新里修正旧判断。
+  thoughts:
+    title: 不够写成文章的，也值得留下。
+    subtitle: 私人朋友圈式的轻量记录：短文字、照片、声音、影像，以及偶然遇见的链接。
+  columns:
+    title: 把一个主题，写到足够深入。
+    subtitle: 专栏不是标签集合，而是一条有顺序的阅读路径。
+  about:
+    title: 你好，我是 Your Name。
+    subtitle: 在这里写下你关心的问题、长期的方向，以及你希望如何与世界保持联系。
+    heading: 这个网站为什么存在
+    paragraphs:
+      - 我需要一个不被信息流推着走的地方。长文可以慢慢展开，随想可以轻轻放下；同一个主题也可以沿着清晰的顺序持续生长。
+      - 所有文章都从本地 Markdown 文件开始。这意味着我可以继续在 Typora 里写作，也意味着内容不会被某个编辑器或平台锁住。
+    quote: 写作不是把已经想明白的东西记下来，而是在句子之间发现自己还没有想明白什么。
+    focus:
+      - 将自己的关注方向写在这里
+      - 用文章积累可迁移的知识
+      - 为长期写作留出稳定的空间
+    cta:
+      href: /blog
+      label: 从博文开始
+  garden:
+    title: 一个基于 Markdown 的个人博客框架。
+    subtitle: ""
+
+footer: 保持独立，持续写作。