hd-garden 0.14.1 → 0.14.2

package/app/admin/preview/[...path]/page.tsx

@@ -75,7 +75,7 @@ export default async function DraftPreviewPage({ params }: { params: Promise<{ p
           草稿预览 · {post}{draft ? " · 草稿" : ""} · <Link href="/admin/ui/blocks">回到交互块</Link>
         </p>
         <h1 className="ui-admin-preview-title">{typeof data.title === "string" ? data.title : post}</h1>
-        {typeof data.description === "string" ? <p className="ui-studio-meta">{data.description}</p> : null}
+        {typeof data.description === "string" && data.description.trim() ? <p className="ui-studio-meta">{data.description}</p> : null}
         <article className="article-body">
           <MarkdownArticle content={proxyAssets(content, post)} numbering={data.numbering === false ? false : undefined} />
         </article>

package/docs/handbook/en/workflow.md

@@ -38,7 +38,7 @@ Three commands check your content at different scopes:
 
 | Code | Severity | Cause and Fix |
 | :--- | :--- | :--- |
-| `missing-title` / `missing-description` | Error | Front Matter is missing a non-empty `title` or `description` |
+| `missing-title` / `invalid-description` | Error | The title is missing or empty, or description is neither a string nor null; a blank description is valid |
 | `unexpected-slug` | Error | Front Matter includes a manual `slug` field (remove `slug`; the filename is the slug) |
 | `date-format` | Error | `date` is not a valid `YYYY-MM-DD`, `YYYY-MM-DD HH:mm:ss`, or ISO timestamp with timezone |
 | `missing-cover` / `missing-asset` | Error | A local file referenced by `cover`, a Markdown image, or Compose `file` does not exist |

package/docs/handbook/en/writing.md

@@ -36,7 +36,7 @@ references:
 | :--- | :--- | :--- | :--- |
 | `title` | Yes | String | Post title. Write ` \| ` (with spaces on both sides) to split the heading into two lines and scale the font size to fit |
 | `date` | Yes | Date string | Publication date (such as `2026-10-18` or an ISO timestamp with timezone) |
-| `description` | Yes | String | Summary shown in the article deck, archive lists, and search engine descriptions |
+| `description` | No | String | Summary shown in the article deck, archive lists, and search engine descriptions. Empty (`description: ""`), omitted, null, or whitespace-only values hide the summary; Garden does not substitute an excerpt from the body |
 | `updated` | No | Date string | Last updated date, shown in the article meta bar and used for RSS sorting |
 | `publishAt` | No | Date string | Scheduled publish time; included only when earlier than the build time (or when `CONTENT_INCLUDE_DRAFTS=1`) |
 | `tags` | No | String array | Tags for the post; clicking a tag filters `/blog?t=<tag>` |

package/docs/handbook/workflow.md

@@ -38,7 +38,7 @@ order: 40
 
 | 诊断码 | 级别 | 触发原因与修复方法 |
 | :--- | :--- | :--- |
-| `missing-title` / `missing-description` | 错误 | Front Matter 缺少有效的 `title` 或 `description` |
+| `missing-title` / `invalid-description` | 错误 | `title` 缺失或为空，或 `description` 不是字符串／空值；摘要可以留空 |
 | `unexpected-slug` | 错误 | Front Matter 中手写了 `slug` 字段（文件名即标识，删掉 `slug`） |
 | `date-format` | 错误 | `date` 不是合法的 `YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss` 或带时区的 ISO 时间 |
 | `missing-cover` / `missing-asset` | 错误 | `cover` 封面图、正文图片或 Compose `file` 引用的本地文件不存在 |

package/docs/handbook/writing.md

@@ -36,7 +36,7 @@ references:
 | :--- | :--- | :--- | :--- |
 | `title` | 是 | 字符串 | 文章标题。中间写 `丨`、`｜` 或 ` \| ` 会分成两行并按字数缩放字号 |
 | `date` | 是 | 日期字符串 | 发布日期（如 `2026-10-18` 或带时区的 ISO 时间） |
-| `description` | 是 | 字符串 | 文章摘要，显示在正文开头导语、列表页与搜索引擎摘要中 |
+| `description` | 否 | 字符串 | 文章摘要，显示在正文开头导语、列表页与搜索引擎摘要中；留空（如 `description: ""`）、省略、YAML `null` 或只写空白时，不渲染摘要，也不会自动截取正文替代 |
 | `updated` | 否 | 日期字符串 | 最后更新日期，显示在文章元信息栏并用于 RSS 排序 |
 | `publishAt` | 否 | 日期字符串 | 定时发布时间；早于当前构建时间（或设置 `CONTENT_INCLUDE_DRAFTS=1`）才会发布 |
 | `tags` | 否 | 字符串数组 | 文章标签列表，点击标签会跳转到 `/blog?t=<标签>` 筛选 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",
@@ -71,7 +71,8 @@
     "editors:build": "node editors/vscode/build.mjs && node editors/obsidian/build.mjs && node editors/typora/build.mjs",
     "editors:pack": "node scripts/pack-editors.mjs",
     "prepack": "node scripts/pack-editors.mjs",
-    "lint": "node bin/garden.mjs sync && eslint . --ignore-pattern dist --ignore-pattern .next --ignore-pattern .garden --ignore-pattern templates"
+    "lint": "node bin/garden.mjs sync && eslint . --ignore-pattern dist --ignore-pattern .next --ignore-pattern .garden --ignore-pattern templates",
+    "version": "node scripts/sync-editor-version.mjs && git add editors/vscode/package.json editors/vscode/package-lock.json"
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "1.37.1",

package/scripts/build-content.mjs

@@ -409,7 +409,9 @@ function validateAndNormalize(data, content, markdownPath, kind, sourcePath, lin
   }
 
   if (kind === "post") {
-    requireString(data, "description", sourcePath);
+    const description = optionalString(data, "description", sourcePath);
+    // An explicit blank is intentional: never replace it with an excerpt from the body.
+    if (!description) data.description = "";
   }
   if (kind === "thought" && data.mediaType) {
     if (!["image", "audio", "video", "link", "text"].includes(data.mediaType)) {

package/scripts/check-post.mjs

@@ -215,8 +215,8 @@ const checkFile = (filePath) => {
   if (typeof data.title !== "string" || !data.title.trim()) {
     error(errors, "missing-title", 1, `${sourcePath}: front matter 缺少有效的 title`);
   }
-  if (typeof data.description !== "string" || !data.description.trim()) {
-    error(errors, "missing-description", 1, `${sourcePath}: front matter 缺少有效的 description`);
+  if (data.description != null && typeof data.description !== "string") {
+    error(errors, "invalid-description", 1, `${sourcePath}: description 必须是字符串或留空`);
   }
   if (data.slug !== undefined) {
     error(errors, "unexpected-slug", 1, `${sourcePath}: 不要写 slug，文件名就是标识`);

package/scripts/pack-editors.mjs

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import zlib from "node:zlib";
+import { syncEditorVersion } from "./sync-editor-version.mjs";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const distDir = path.join(root, "editors", "dist");
@@ -16,7 +17,8 @@ function distReady() {
   const vsixDir = path.join(distDir, "vscode");
   const manifest = path.join(distDir, "typora", "manifest.json");
   if (!fs.existsSync(manifest) || !fs.existsSync(vsixDir)) return false;
-  return fs.readdirSync(vsixDir).some((name) => name.endsWith(".vsix"));
+  const version = syncEditorVersion({ check: true });
+  return fs.existsSync(path.join(vsixDir, `garden-ui-${version}.vsix`));
 }
 
 function withPackLock(fn) {
@@ -166,6 +168,7 @@ function vsixManifest(manifest) {
     <Identity Language="en-US" Id="${xmlEscape(manifest.name)}" Version="${xmlEscape(manifest.version)}" Publisher="${xmlEscape(manifest.publisher)}"/>
     <DisplayName>${xmlEscape(manifest.displayName)}</DisplayName>
     <Description xml:space="preserve">${xmlEscape(manifest.description)}</Description>
+    <Icon>extension/${xmlEscape(manifest.icon)}</Icon>
     <Tags>${xmlEscape(tags)}</Tags>
     <Categories>${xmlEscape(categories)}</Categories>
     <GalleryFlags>Public</GalleryFlags>
@@ -179,6 +182,7 @@ function vsixManifest(manifest) {
   </Installation>
   <Dependencies/>
   <Assets>
+    <Asset Type="Microsoft.VisualStudio.Services.Icons.Default" Path="extension/${xmlEscape(manifest.icon)}" Addressable="true"/>
     <Asset Type="Microsoft.VisualStudio.Code.Manifest" Path="extension/package.json" Addressable="true"/>
   </Assets>
 </PackageManifest>
@@ -188,6 +192,13 @@ function vsixManifest(manifest) {
 function packageVsix() {
   const source = path.join(root, "editors", "vscode");
   const manifest = JSON.parse(fs.readFileSync(path.join(source, "package.json"), "utf8"));
+  syncEditorVersion({ check: true });
+  if (manifest.icon !== "dist/icon.png") throw new Error("VS Code extension icon must be dist/icon.png");
+  const icon = fs.readFileSync(path.join(source, manifest.icon));
+  if (icon.subarray(0, 8).toString("hex") !== "89504e470d0a1a0a" || icon.readUInt32BE(16) < 128 || icon.readUInt32BE(20) < 128)
+    throw new Error("VS Code extension icon must be PNG, at least 128 × 128.");
+  if (!icon.equals(fs.readFileSync(path.join(root, "public/apple-touch-icon.png"))))
+    throw new Error("VS Code extension icon must reuse Garden's canonical public/apple-touch-icon.png.");
   const entries = [];
   const license = path.join(root, "LICENSE");
   if (fs.existsSync(license)) entries.push({ name: "extension/LICENSE", data: fs.readFileSync(license) });

package/scripts/sync-editor-version.mjs

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const defaultRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+/** Root Garden version is authoritative. npm version runs this before its release commit. */
+export function syncEditorVersion({ root = defaultRoot, check = false } = {}) {
+  const version = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8")).version;
+  if (!/^\d+\.\d+\.\d+$/u.test(version)) throw new Error("Garden editor releases require a stable major.minor.patch version.");
+  for (const name of ["package.json", "package-lock.json"]) {
+    const file = path.join(root, "editors/vscode", name);
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    const versions = name === "package-lock.json" ? [value, value.packages[""]] : [value];
+    if (versions.every((item) => item.version === version)) continue;
+    if (check) throw new Error(`${file} must match Garden ${version}; run node scripts/sync-editor-version.mjs and commit both editor manifests.`);
+    for (const item of versions) item.version = version;
+    fs.writeFileSync(file, JSON.stringify(value, null, 2) + "\n");
+  }
+  return version;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const version = syncEditorVersion({ check: process.argv.includes("--check") });
+  if (process.env.GITHUB_REF_TYPE === "tag" && process.env.GITHUB_REF_NAME !== `v${version}`)
+    throw new Error(`Release tag ${process.env.GITHUB_REF_NAME} does not match Garden v${version}`);
+  process.stdout.write(`Garden / VS Code extension version: ${version}\n`);
+}