hd-garden 0.3.8 → 0.3.10

package/scripts/build-content.mjs

@@ -5,6 +5,7 @@ import matter from "gray-matter";
 import { marked } from "marked";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import { canonicalSiteDate } from "./site-date.mjs";
+import { contentForFeed, contentToSearchText, transformUiContent } from "../ui/core/transform.mjs";
 
 function resolveSiteRoot() {
   if (process.env.GARDEN_SITE) return path.resolve(process.env.GARDEN_SITE);
@@ -23,6 +24,8 @@ const gardenDir = path.join(root, ".garden");
 const output = path.join(gardenDir, "generated-content.ts");
 const siteConfigOutput = path.join(gardenDir, "site-config.ts");
 const includeDrafts = process.env.CONTENT_INCLUDE_DRAFTS === "1";
+// Local preview shows broken ui blocks as error cards; public builds fail on them.
+const uiMode = includeDrafts || process.env.GARDEN_CONTENT_MODE === "preview" ? "preview" : "publish";
 const now = Date.now();
 const basePath = (process.env.NEXT_PUBLIC_BASE_PATH ?? "").replace(/\/+$/u, "");
 const siteUrl = (process.env.SITE_URL ?? process.env.NEXT_PUBLIC_SITE_URL ?? "https://example.com")
@@ -249,6 +252,26 @@ function rewriteWidgetFences(content, markdownPath, sourcePath) {
   );
 }
 
+function rewriteUiFences(content, markdownPath, sourcePath, lineOffset) {
+  const { content: transformed, errors } = transformUiContent(content, {
+    mode: uiMode,
+    markdownPath: sourcePath.split(path.sep).join("/"),
+    lineOffset,
+    readData: (src) => {
+      const absolute = path.resolve(path.dirname(markdownPath), src);
+      return fs.existsSync(absolute) && fs.statSync(absolute).isFile() ? fs.readFileSync(absolute, "utf8") : undefined;
+    },
+    resolveAsset: (_sidecarPath, written) => copyLocalAsset(written, markdownPath, sourcePath),
+  });
+  if (errors.length) {
+    fail(
+      sourcePath,
+      `ui 块没有通过检查：\n${errors.map((item) => `  第 ${item.line} 行 ${item.code}：${item.message}`).join("\n")}\n修好后再发布；可以运行 npx garden ui check ${path.join("content", sourcePath)} 拿到修复提示词。`,
+    );
+  }
+  return transformed;
+}
+
 function normalizeMedia(media, markdownPath, sourcePath) {
   if (media === undefined || media === null) return undefined;
   if (typeof media === "string") {
@@ -286,7 +309,7 @@ function normalizeMedia(media, markdownPath, sourcePath) {
   });
 }
 
-function validateAndNormalize(data, content, markdownPath, kind, sourcePath) {
+function validateAndNormalize(data, content, markdownPath, kind, sourcePath, lineOffset = 0) {
   const title = requireString(data, "title", sourcePath);
   const slug = path.basename(markdownPath, ".md");
   if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(slug)) {
@@ -355,13 +378,19 @@ function validateAndNormalize(data, content, markdownPath, kind, sourcePath) {
       : undefined,
     media: normalizeMedia(data.media, markdownPath, sourcePath),
     content: rewriteWidgetFences(
-      rewriteMarkdownAssets(content.trim(), markdownPath, sourcePath),
+      rewriteMarkdownAssets(
+        rewriteUiFences(content.trim(), markdownPath, sourcePath, lineOffset + leadingLines(content)),
+        markdownPath,
+        sourcePath,
+      ),
       markdownPath,
       sourcePath,
     ),
   };
 }
 
+const leadingLines = (content) => (/^\s*/u.exec(content)?.[0].match(/\n/gu) ?? []).length;
+
 function readMarkdownTree(directory, kind) {
   if (!fs.existsSync(directory)) return [];
 
@@ -379,12 +408,14 @@ function readMarkdownTree(directory, kind) {
       },
     });
     const sourcePath = path.relative(contentRoot, fullPath);
+    const frontMatterLines = raw.slice(0, raw.length - parsed.content.length).split("\n").length - 1;
     const normalized = validateAndNormalize(
       parsed.data,
       parsed.content,
       fullPath,
       kind,
       sourcePath,
+      frontMatterLines,
     );
     return normalized ? [normalized] : [];
   });
@@ -591,9 +622,9 @@ function writeRssFeed(fileName, entries) {
       <link>${escapeXml(`${publicBaseUrl}${entry.path}`)}</link>
       <guid isPermaLink="true">${escapeXml(`${publicBaseUrl}${entry.path}`)}</guid>
       <pubDate>${new Date(entry.date).toUTCString()}</pubDate>
-      <description>${escapeXml(entry.description ?? entry.content.replace(/\s+/gu, " ").slice(0, 180))}</description>
+      <description>${escapeXml(entry.description ?? contentToSearchText(entry.content).replace(/\s+/gu, " ").trim().slice(0, 180))}</description>
       ${(entry.tags ?? []).map((tag) => `<category>${escapeXml(tag)}</category>`).join("")}
-      <content:encoded><![CDATA[${cdata(marked.parse(entry.content))}]]></content:encoded>
+      <content:encoded><![CDATA[${cdata(marked.parse(contentForFeed(entry.content, { pageUrl: `${publicBaseUrl}${entry.path}`, siteUrl: publicBaseUrl })))}]]></content:encoded>
     </item>`).join("");
 
   fs.writeFileSync(path.join(publicRoot, fileName), `<?xml version="1.0" encoding="UTF-8" ?>

package/scripts/build-ui-preview.mjs

@@ -0,0 +1,29 @@
+import fs from "node:fs";
+import path from "node:path";
+import { build } from "esbuild";
+import { gardenPackageRoot } from "./garden-paths.mjs";
+
+const root = gardenPackageRoot;
+const out = path.join(root, "ui", "preview", "dist");
+fs.rmSync(out, { recursive: true, force: true });
+fs.mkdirSync(out, { recursive: true });
+
+const shared = {
+  entryPoints: [path.join(root, "ui", "preview", "index.tsx")],
+  bundle: true,
+  minify: true,
+  jsx: "automatic",
+  platform: "browser",
+  target: ["es2020"],
+  define: { "process.env.NODE_ENV": '"production"' },
+  alias: { mermaid: path.join(root, "ui", "preview", "mermaid-shim.ts") },
+  legalComments: "none",
+  logLevel: "warning",
+};
+
+await build({ ...shared, format: "iife", globalName: "GardenUI", outfile: path.join(out, "garden-ui.iife.js") });
+await build({ ...shared, format: "esm", outfile: path.join(out, "garden-ui.esm.js") });
+fs.copyFileSync(path.join(root, "ui", "react", "ui.css"), path.join(out, "garden-ui.css"));
+
+const size = (file) => `${(fs.statSync(path.join(out, file)).size / 1024).toFixed(0)} KB`;
+process.stdout.write(`预览包已生成：garden-ui.iife.js ${size("garden-ui.iife.js")}，garden-ui.esm.js ${size("garden-ui.esm.js")}，garden-ui.css\n`);

package/scripts/check-post.mjs

@@ -4,6 +4,7 @@ import matter from "gray-matter";
 import { parse as parseYaml } from "yaml";
 import { canonicalSiteDate } from "./site-date.mjs";
 import { gardenSiteRoot } from "./garden-paths.mjs";
+import { checkUiBlock } from "../ui/core/validate.mjs";
 
 const siteRoot = gardenSiteRoot();
 const calloutTypes = new Set([
@@ -184,7 +185,22 @@ const checkEmbed = (errors, body, sourcePath, line) => {
   }
 };
 
-const scanBody = (errors, content, markdownPath, sourcePath) => {
+const checkUi = (errors, warnings, body, markdownPath, sourcePath, line) => {
+  const relative = path.relative(path.join(siteRoot, "content"), markdownPath).split(path.sep).join("/");
+  const result = checkUiBlock(body, {
+    lineOffset: line,
+    markdownPath: relative,
+    readData: (src) => {
+      const absolute = path.resolve(path.dirname(markdownPath), src);
+      return fs.existsSync(absolute) ? fs.readFileSync(absolute, "utf8") : undefined;
+    },
+  });
+  for (const item of result.diagnostics) {
+    (item.severity === "warning" ? warnings : errors).push({ code: item.code, line: item.line, message: `${sourcePath}: ${item.message}` });
+  }
+};
+
+const scanBody = (errors, content, markdownPath, sourcePath, { warnings = [], draft = false } = {}) => {
   let fence = null;
   let previousDepth = 1;
   const lines = content.split(/\r?\n/u);
@@ -195,6 +211,10 @@ const scanBody = (errors, content, markdownPath, sourcePath) => {
       if (opener && opener[1][0] === fence.marker && opener[1].length >= fence.marker.length && !opener[2].trim()) {
         if (fence.lang === "widget") checkWidget(errors, fence.body.join("\n"), markdownPath, sourcePath, fence.line);
         if (fence.lang === "embed") checkEmbed(errors, fence.body.join("\n"), sourcePath, fence.line);
+        if (fence.lang === "ui") checkUi(errors, warnings, fence.body.join("\n"), markdownPath, sourcePath, fence.line);
+        if (fence.lang === "intent" && !draft) {
+          error(errors, "intent-uncompiled", fence.line, `${sourcePath}: 还有没编译的 intent 块；对 AI 说「编译这篇」`);
+        }
         fence = null;
       } else {
         fence.body.push(line);
@@ -238,9 +258,10 @@ const checkFile = (filePath) => {
   const absolute = path.resolve(siteRoot, filePath);
   const sourcePath = path.relative(siteRoot, absolute);
   const errors = [];
+  const warnings = [];
   if (!fs.existsSync(absolute)) {
     error(errors, "missing-file", 1, `${sourcePath}: 找不到文件`);
-    return { file: sourcePath, errors };
+    return { file: sourcePath, errors, warnings };
   }
   const parsed = matter(fs.readFileSync(absolute, "utf8"), matterOptions);
   const data = parsed.data ?? {};
@@ -266,8 +287,9 @@ const checkFile = (filePath) => {
     }
   }
   checkReferences(data, sourcePath, errors);
-  scanBody(errors, parsed.content, absolute, sourcePath);
-  return { file: sourcePath, errors };
+  const draft = data.draft === true || (typeof data.publishAt === "string" && Date.parse(canonicalSiteDate(data.publishAt) ?? "") > Date.now());
+  scanBody(errors, parsed.content, absolute, sourcePath, { warnings, draft });
+  return { file: sourcePath, errors, warnings };
 };
 
 const files = process.argv.slice(2);

package/scripts/ui-cli.mjs

@@ -0,0 +1,303 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { parse as parseYaml } from "yaml";
+import { applyBlock, ApplyError } from "../ui/core/apply.mjs";
+import { catalogSchema } from "../ui/core/catalog.mjs";
+import { buildFixPrompt } from "../ui/core/fix-prompt.mjs";
+import { scanMarkdown } from "../ui/core/scan.mjs";
+import { buildPrompt, RECIPE_FILES } from "../ui/prompt/build.mjs";
+import { canonicalSiteDate } from "./site-date.mjs";
+import { gardenPackageRoot, gardenSiteRoot } from "./garden-paths.mjs";
+
+const siteRoot = gardenSiteRoot();
+const [command, ...rest] = process.argv.slice(2);
+
+function fail(message, code = 1) {
+  process.stderr.write(`${message}\n`);
+  process.exit(code);
+}
+
+function flag(name) {
+  return rest.includes(`--${name}`);
+}
+
+function option(name) {
+  const index = rest.indexOf(`--${name}`);
+  if (index < 0) return null;
+  const value = rest[index + 1];
+  if (!value || value.startsWith("--")) fail(`--${name} 需要一个值`);
+  return value;
+}
+
+function positional() {
+  const values = [];
+  for (let index = 0; index < rest.length; index += 1) {
+    const value = rest[index];
+    if (value.startsWith("--")) {
+      if (["id", "at", "intent-hash", "base", "file", "out"].includes(value.slice(2))) index += 1;
+      continue;
+    }
+    values.push(value);
+  }
+  return values;
+}
+
+const promptRoot = path.join(gardenPackageRoot, "ui", "prompt");
+
+function promptText({ studio = false } = {}) {
+  return buildPrompt({
+    rules: fs.readFileSync(path.join(promptRoot, "rules.md"), "utf8"),
+    recipes: RECIPE_FILES.map((file) => fs.readFileSync(path.join(promptRoot, "recipes", file), "utf8")),
+    studio: studio ? fs.readFileSync(path.join(promptRoot, "studio.md"), "utf8") : null,
+  });
+}
+
+const toPosix = (value) => value.split(path.sep).join("/");
+
+function git(args, { input, allowFail = false } = {}) {
+  const result = spawnSync("git", args, { cwd: siteRoot, encoding: "utf8", input, maxBuffer: 64 * 1024 * 1024 });
+  if (result.status !== 0) {
+    if (allowFail) return null;
+    fail(`git ${args.join(" ")} 失败：${(result.stderr || "").trim()}`);
+  }
+  return result.stdout;
+}
+
+function isDraft(markdown) {
+  try {
+    const { data } = matter(markdown, { engines: { yaml: { parse: (input) => parseYaml(input) ?? {} } } });
+    if (data.draft === true) return true;
+    const publish = canonicalSiteDate(data.publishAt ?? data.date);
+    return Boolean(publish) && Date.parse(publish) > Date.now();
+  } catch {
+    return false;
+  }
+}
+
+function listContentFiles(directory) {
+  if (!fs.existsSync(directory)) return [];
+  return fs.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const full = path.join(directory, entry.name);
+    if (entry.isDirectory()) return listContentFiles(full);
+    return entry.name.endsWith(".md") ? [full] : [];
+  });
+}
+
+/** Files to check, each with a reader for itself and its same-name directory. */
+function targets() {
+  if (flag("staged")) {
+    const top = git(["rev-parse", "--show-toplevel"]).trim();
+    const names = git(["diff", "--cached", "--name-only", "--diff-filter=ACMR", "-z"]).split("\0").filter(Boolean);
+    return names
+      .filter((name) => name.endsWith(".md"))
+      .map((name) => ({ absolute: path.join(top, name), repoPath: name }))
+      .filter((item) => toPosix(path.relative(siteRoot, item.absolute)).startsWith("content/"))
+      .map((item) => ({
+        file: toPosix(path.relative(siteRoot, item.absolute)),
+        read: () => git(["show", `:${item.repoPath}`]),
+        readSibling: (relative) => {
+          const repoRelative = toPosix(path.join(path.dirname(item.repoPath), relative));
+          return git(["show", `:${repoRelative}`], { allowFail: true }) ?? undefined;
+        },
+      }));
+  }
+  const files = flag("all") ? listContentFiles(path.join(siteRoot, "content")) : positional().map((file) => path.resolve(siteRoot, file));
+  return files.map((absolute) => ({
+    file: toPosix(path.relative(siteRoot, absolute)),
+    read: () => {
+      if (!fs.existsSync(absolute)) fail(`找不到文件 ${absolute}`);
+      return fs.readFileSync(absolute, "utf8");
+    },
+    readSibling: (relative) => {
+      const target = path.resolve(path.dirname(absolute), relative);
+      return fs.existsSync(target) && fs.statSync(target).isFile() ? fs.readFileSync(target, "utf8") : undefined;
+    },
+  }));
+}
+
+function scanTarget(target) {
+  const markdown = target.read();
+  const blocks = scanMarkdown(markdown, { markdownPath: target.file, readData: target.readSibling });
+  return { markdown, blocks, draft: isDraft(markdown) };
+}
+
+function copyToClipboard(text) {
+  const candidates = process.platform === "darwin"
+    ? [["pbcopy", []]]
+    : process.platform === "win32"
+      ? [["clip", []]]
+      : [["wl-copy", []], ["xclip", ["-selection", "clipboard"]], ["xsel", ["--clipboard", "--input"]]];
+  for (const [binary, args] of candidates) {
+    const result = spawnSync(binary, args, { input: text });
+    if (result.status === 0) return true;
+  }
+  return false;
+}
+
+function commandScan() {
+  const files = targets();
+  if (!files.length) fail("用法：garden ui scan content/posts/文章.md");
+  const output = files.map((target) => {
+    const { blocks, draft } = scanTarget(target);
+    return {
+      file: target.file,
+      draft,
+      blocks: blocks.map((block) => Object.fromEntries(Object.entries(block).filter(([key]) => key !== "raw"))),
+    };
+  });
+  process.stdout.write(`${JSON.stringify(output.length === 1 ? output[0] : output, null, 2)}\n`);
+}
+
+function commandCheck() {
+  const files = targets();
+  if (!files.length) {
+    if (flag("staged")) process.exit(0);
+    fail("用法：garden ui check content/posts/文章.md [--staged] [--all] [--standalone]");
+  }
+  const problems = [];
+  const warnings = [];
+  for (const target of files) {
+    const { blocks, draft } = scanTarget(target);
+    for (const block of blocks) {
+      const errors = block.diagnostics.filter((item) => item.severity === "error");
+      for (const item of block.diagnostics.filter((entry) => entry.severity === "warning")) {
+        warnings.push(`${target.file}:${item.line}  ${block.id ?? "-"}  ${item.code}  ${item.message}`);
+      }
+      if (block.lang === "intent" && !draft) problems.push({ file: target.file, block, diagnostics: [] });
+      else if (errors.length) problems.push({ file: target.file, block, diagnostics: errors });
+    }
+  }
+  for (const line of warnings) process.stderr.write(`提醒  ${line}\n`);
+  if (!problems.length) {
+    if (!flag("quiet")) process.stdout.write(`ui 检查通过（${files.length} 个文件）\n`);
+    return;
+  }
+  for (const problem of problems) {
+    if (problem.block.lang === "intent") {
+      process.stderr.write(`${problem.file}:${problem.block.startLine}  ${problem.block.id ?? "-"}  intent-uncompiled  还有没编译的 intent 块\n`);
+    }
+    for (const item of problem.diagnostics) {
+      process.stderr.write(`${problem.file}:${item.line}  ${problem.block.id ?? "-"}  ${item.code}  ${item.message}\n`);
+    }
+  }
+  const prompt = buildFixPrompt(problems, { standaloneReference: flag("standalone") ? promptText() : null });
+  const separator = "─".repeat(24);
+  process.stderr.write(`\n${separator} 发给 AI 的修复提示词 ${separator}\n${prompt}${separator}${separator}${"─".repeat(12)}\n`);
+  const promptFile = path.join(siteRoot, ".garden", "ui-fix-prompt.md");
+  fs.mkdirSync(path.dirname(promptFile), { recursive: true });
+  fs.writeFileSync(promptFile, prompt);
+  const copied = !flag("no-copy") && process.env.GARDEN_UI_NO_COPY !== "1" && copyToClipboard(prompt);
+  process.stderr.write(`已写入 ${toPosix(path.relative(siteRoot, promptFile))}${copied ? "，并已复制到剪贴板" : ""}。确实要先提交，可以用 git commit --no-verify。\n`);
+  process.exit(1);
+}
+
+function readStdin() {
+  try {
+    return fs.readFileSync(0, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function commandApply() {
+  const [file] = positional();
+  if (!file) fail("用法：garden ui apply content/posts/文章.md --id <id> [--base <哈希>] [--file 新内容.md]");
+  const absolute = path.resolve(siteRoot, file);
+  if (!fs.existsSync(absolute)) fail(`找不到文件 ${file}`);
+  const source = option("file");
+  const replacement = source ? fs.readFileSync(path.resolve(process.cwd(), source), "utf8") : readStdin();
+  if (!replacement.trim()) fail("没有拿到新内容：用 --file 指定，或从标准输入传入");
+  const target = { id: option("id"), at: option("at"), intentHash: option("intent-hash") };
+  try {
+    const markdown = fs.readFileSync(absolute, "utf8");
+    const result = applyBlock(markdown, target, replacement, {
+      base: option("base"),
+      markdownPath: toPosix(path.relative(siteRoot, absolute)),
+      readData: (relative) => {
+        const sibling = path.resolve(path.dirname(absolute), relative);
+        return fs.existsSync(sibling) ? fs.readFileSync(sibling, "utf8") : undefined;
+      },
+    });
+    fs.writeFileSync(absolute, result.markdown);
+    process.stdout.write(`${JSON.stringify({ ok: true, file: toPosix(path.relative(siteRoot, absolute)), kind: result.kind, line: result.block.startLine })}\n`);
+  } catch (error) {
+    if (!(error instanceof ApplyError)) throw error;
+    process.stderr.write(`${JSON.stringify({ ok: false, code: error.code, message: error.message, diagnostics: error.diagnostics }, null, 2)}\n`);
+    process.exit(1);
+  }
+}
+
+function openPath(target) {
+  const opener = process.platform === "darwin" ? ["open", [target]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", target]] : ["xdg-open", [target]];
+  spawnSync(opener[0], opener[1], { stdio: "ignore" });
+}
+
+function commandCatalog() {
+  const dist = path.join(gardenPackageRoot, "ui", "preview", "dist");
+  const script = path.join(dist, "garden-ui.iife.js");
+  const style = path.join(dist, "garden-ui.css");
+  if (!fs.existsSync(script) || !fs.existsSync(style)) {
+    fail("缺少编辑器预览包。在引擎仓库运行 npm run ui:build 后再试。");
+  }
+  const recipes = RECIPE_FILES.map((file) => ({ file, markdown: fs.readFileSync(path.join(promptRoot, "recipes", file), "utf8") }));
+  const json = JSON.stringify(recipes).replaceAll("<", "\\u003c");
+  const html = `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Garden 组件清单</title>
+<style>body{margin:0;background:#f8f8f6;color:#202124}main{max-width:760px;margin:0 auto;padding:32px 20px 80px}@media (prefers-color-scheme: dark){body{background:#171819;color:#ededeb}}</style>
+<style>${fs.readFileSync(style, "utf8")}</style>
+</head>
+<body>
+<main id="catalog"></main>
+<script>${fs.readFileSync(script, "utf8").replaceAll("</script", "<\\/script")}</script>
+<script>
+const root = document.getElementById("catalog");
+if (window.matchMedia("(prefers-color-scheme: dark)").matches) root.setAttribute("data-theme", "dark");
+GardenUI.renderCatalog(root, { recipes: ${json} });
+</script>
+</body>
+</html>
+`;
+  const out = path.resolve(siteRoot, option("out") ?? path.join(".garden", "ui-catalog.html"));
+  fs.mkdirSync(path.dirname(out), { recursive: true });
+  fs.writeFileSync(out, html);
+  process.stdout.write(`组件清单已生成：${toPosix(path.relative(siteRoot, out))}\n`);
+  if (!flag("no-open")) openPath(out);
+}
+
+switch (command) {
+  case "scan":
+    commandScan();
+    break;
+  case "check":
+    commandCheck();
+    break;
+  case "apply":
+    commandApply();
+    break;
+  case "prompt":
+    process.stdout.write(promptText({ studio: flag("studio") }));
+    break;
+  case "schema":
+    process.stdout.write(`${JSON.stringify(catalogSchema(), null, 2)}\n`);
+    break;
+  case "catalog":
+    commandCatalog();
+    break;
+  default:
+    fail(`用法：garden ui <scan|check|apply|prompt|schema|catalog>
+
+  garden ui scan <稿件.md>                 列出块、状态、行号和哈希（JSON）
+  garden ui check <稿件.md>... | --staged | --all [--standalone]
+                                           检查 ui / intent 块，失败时给出修复提示词
+  garden ui apply <稿件.md> --id <id> [--base <哈希>] [--file 新内容.md]
+                                           只替换一块，围栏外逐字节不变
+  garden ui prompt [--studio]              打印写作规则、组件参考和配方
+  garden ui schema                         打印组件目录 JSON
+  garden ui catalog [--out 文件] [--no-open] 生成离线组件清单并打开`);
+}

package/site.config.yaml

@@ -14,35 +14,35 @@ author:
 pages:
   home:
     title: |-
-      把复杂的事，
-      慢慢想明白。
-    subtitle: 在这里记录产品、工程、学习与日常生活中值得慢慢想明白的事。
+      记一些正在做的事，
+      和想清楚的问题。
+    subtitle: 关注软件工程、系统设计与技术实践，也记录偶发的探索和工作笔记。
   blog:
-    title: 长期写下去，偶尔回头整理。
-    subtitle: 这里是完整文章：有明确主题、有持续论证，也允许自己在更新里修正旧判断。
+    title: 博文
+    subtitle: 阶段性的完整梳理与技术总结。
   thoughts:
-    title: 不够写成文章的，也值得留下。
-    subtitle: 私人朋友圈式的轻量记录：短文字、照片、声音、影像，以及偶然遇见的链接。
+    title: 随想
+    subtitle: 碎片的念头、偶遇的灵感、短笔记与链接。
   columns:
-    title: 把一个主题，写到足够深入。
-    subtitle: 专栏不是标签集合，而是一条有顺序的阅读路径。左侧章节导航会在阅读时始终陪着你。
+    title: 专栏
+    subtitle: 按顺序组织的专题系列，沿着清晰的脉络连点成线。
   about:
     title: 你好，我是 Your Name。
-    subtitle: 在这里写下你关心的问题、长期的方向，以及你希望如何与世界保持联系。
-    heading: 这个网站为什么存在
+    subtitle: 欢迎来到我的个人网站。
+    heading: 关于我与这里
     paragraphs:
-      - 我需要一个不被信息流推着走的地方。长文可以慢慢展开，随想可以轻轻放下；同一个主题也可以沿着清晰的顺序持续生长。
-      - 所有文章都从本地 Markdown 文件开始。这意味着我可以继续在 Typora 里写作，也意味着内容不会被某个编辑器或平台锁住。
-    quote: 写作不是把已经想明白的东西记下来，而是在句子之间发现自己还没有想明白什么。
+      - 一名工程师 / 创作者。平时主要关注系统开发、技术探索与软件设计。
+      - 这里是我的公开工作台与数字自留地。比起社交网络上的碎片动态，我更倾向于把探索过程沉淀为有据可查的代码、设计与长篇笔记。
+    quote: ""
     focus:
-      - 将自己的关注方向写在这里
-      - 用文章积累可迁移的知识
-      - 为长期写作留出稳定的空间
+      - 软件工程与系统架构
+      - 原生工具与高质量交互
+      - 个人长期知识沉淀
     cta:
       href: /blog
-      label: 从博文开始
+      label: 浏览博文
   garden:
     title: 一个基于 Markdown 的个人博客框架。
     subtitle: ""
 
-footer: 保持独立，持续写作。
+footer: 持续记录与构建。

package/templates/site/site.config.yaml

@@ -12,35 +12,35 @@ author:
 pages:
   home:
     title: |-
-      把复杂的事，
-      慢慢想明白。
-    subtitle: 在这里记录产品、工程、学习与日常生活中值得慢慢想明白的事。
+      记一些正在做的事，
+      和想清楚的问题。
+    subtitle: 关注软件工程、系统设计与技术实践，也记录偶发的探索和工作笔记。
   blog:
-    title: 长期写下去，偶尔回头整理。
-    subtitle: 这里是完整文章：有明确主题、有持续论证，也允许自己在更新里修正旧判断。
+    title: 博文
+    subtitle: 阶段性的完整梳理与技术总结。
   thoughts:
-    title: 不够写成文章的，也值得留下。
-    subtitle: 私人朋友圈式的轻量记录：短文字、照片、声音、影像，以及偶然遇见的链接。
+    title: 随想
+    subtitle: 碎片的念头、偶遇的灵感、短笔记与链接。
   columns:
-    title: 把一个主题，写到足够深入。
-    subtitle: 专栏不是标签集合，而是一条有顺序的阅读路径。
+    title: 专栏
+    subtitle: 按顺序组织的专题系列，沿着清晰的脉络连点成线。
   about:
     title: 你好，我是 Your Name。
-    subtitle: 在这里写下你关心的问题、长期的方向，以及你希望如何与世界保持联系。
-    heading: 这个网站为什么存在
+    subtitle: 欢迎来到我的个人网站。
+    heading: 关于我与这里
     paragraphs:
-      - 我需要一个不被信息流推着走的地方。长文可以慢慢展开，随想可以轻轻放下；同一个主题也可以沿着清晰的顺序持续生长。
-      - 所有文章都从本地 Markdown 文件开始。这意味着我可以继续在 Typora 里写作，也意味着内容不会被某个编辑器或平台锁住。
-    quote: 写作不是把已经想明白的东西记下来，而是在句子之间发现自己还没有想明白什么。
+      - 一名工程师 / 创作者。平时主要关注系统开发、技术探索与软件设计。
+      - 这里是我的公开工作台与数字自留地。比起社交网络上的碎片动态，我更倾向于把探索过程沉淀为有据可查的代码、设计与长篇笔记。
+    quote: ""
     focus:
-      - 将自己的关注方向写在这里
-      - 用文章积累可迁移的知识
-      - 为长期写作留出稳定的空间
+      - 软件工程与系统架构
+      - 原生工具与高质量交互
+      - 个人长期知识沉淀
     cta:
       href: /blog
-      label: 从博文开始
+      label: 浏览博文
   garden:
     title: 一个基于 Markdown 的个人博客框架。
     subtitle: ""
 
-footer: 保持独立，持续写作。
+footer: 持续记录与构建。

package/tsconfig.json

@@ -30,5 +30,5 @@
     ".next/dev/types/**/*.ts",
     "**/*.mts"
   ],
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules", "editors"]
 }