hd-garden 0.3.8 → 0.3.10

package/app/lib/repository-path.mjs

@@ -30,3 +30,58 @@ export function repositoryPostPath(sourcePath) {
   }
   return `content/${relativePath}`;
 }
+
+const unsafeSegment = (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;
+  }
+};
+
+/**
+ * Repository path of a Markdown file the admin may read: inside content/posts
+ * or content/thoughts, never escaping it.
+ *
+ * @param {string} value
+ */
+export function repositoryContentPath(value) {
+  const path = String(value ?? "").replace(/^\/+/u, "");
+  const withRoot = path.startsWith("content/") ? path : `content/${path}`;
+  const segments = withRoot.split("/");
+  if (
+    segments.length < 3 ||
+    !["posts", "thoughts"].includes(segments[1]) ||
+    !withRoot.endsWith(".md") ||
+    segments.some(unsafeSegment)
+  ) {
+    throw new Error("稿件路径不合法。");
+  }
+  return withRoot;
+}
+
+const ASSET_TYPES = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  svg: "image/svg+xml",
+  html: "text/html; charset=utf-8",
+  pdf: "application/pdf",
+  csv: "text/csv; charset=utf-8",
+  json: "application/json; charset=utf-8",
+};
+
+/**
+ * Content type for a same-name-directory file the draft preview may proxy,
+ * or null when the extension is not allowed.
+ *
+ * @param {string} path
+ */
+export function previewAssetType(path) {
+  const extension = String(path).split(".").pop()?.toLowerCase() ?? "";
+  return Object.hasOwn(ASSET_TYPES, extension) ? ASSET_TYPES[extension] : null;
+}

package/app/lib/ui-content.ts

@@ -0,0 +1,79 @@
+import matter from "gray-matter";
+import { parse as parseYaml } from "yaml";
+import { scanMarkdown } from "../../ui/core/scan.mjs";
+import { canonicalSiteDate } from "../../scripts/site-date.mjs";
+import {
+  isContentRepositoryConfigured,
+  listContentMarkdown,
+  readRepositoryBlob,
+  readRepositoryFile,
+  readRepositoryRaw,
+} from "./github-content";
+
+const matterOptions = { engines: { yaml: { parse: (input: string) => parseYaml(input) ?? {} } } };
+
+export const REPOSITORY_REQUIRED = "这一页从内容仓库读取稿件：请配置 CONTENT_REPOSITORY 和 CONTENT_GITHUB_TOKEN。";
+
+function requireRepository() {
+  if (!isContentRepositoryConfigured()) throw new Error(REPOSITORY_REQUIRED);
+}
+
+export async function readMarkdown(repoPath: string, sha?: string) {
+  requireRepository();
+  if (sha) return { source: await readRepositoryBlob(sha), sha };
+  return readRepositoryFile(repoPath);
+}
+
+export async function readRaw(repoPath: string): Promise<ArrayBuffer | null> {
+  requireRepository();
+  return readRepositoryRaw(repoPath);
+}
+
+export async function readText(repoPath: string) {
+  const raw = await readRaw(repoPath);
+  return raw ? new TextDecoder().decode(raw) : undefined;
+}
+
+export function frontMatterOf(source: string) {
+  try {
+    const { data } = matter(source, matterOptions);
+    const publish = canonicalSiteDate(data.publishAt ?? data.date);
+    return {
+      title: typeof data.title === "string" ? data.title : null,
+      draft: data.draft === true || (Boolean(publish) && Date.parse(publish as string) > Date.now()),
+    };
+  } catch {
+    return { title: null, draft: false };
+  }
+}
+
+type BlockSummary = ReturnType<typeof scanMarkdown>[number];
+export type FileBlocks = { path: string; sha: string; title: string | null; draft: boolean; blocks: BlockSummary[] };
+
+const scanCache = new Map<string, FileBlocks>();
+
+/** All blocks in the repository, scanned once per blob sha. */
+export async function scanRepositoryBlocks() {
+  requireRepository();
+  const files = await listContentMarkdown();
+  const results: FileBlocks[] = [];
+  const queue = [...files];
+  const workers = Array.from({ length: 8 }, async () => {
+    while (queue.length) {
+      const file = queue.shift();
+      if (!file) break;
+      const cached = scanCache.get(file.sha);
+      if (cached) {
+        results.push(cached);
+        continue;
+      }
+      const source = await readRepositoryBlob(file.sha);
+      const blocks = scanMarkdown(source, { markdownPath: file.path, skipData: true });
+      const entry: FileBlocks = { path: file.path, sha: file.sha, ...frontMatterOf(source), blocks };
+      scanCache.set(file.sha, entry);
+      results.push(entry);
+    }
+  });
+  await Promise.all(workers);
+  return results.filter((file) => file.blocks.length).sort((a, b) => a.path.localeCompare(b.path));
+}

package/app/lib/ui-model.ts

@@ -0,0 +1,145 @@
+import rules from "../../ui/prompt/rules.md?raw";
+import studio from "../../ui/prompt/studio.md?raw";
+import paramBench from "../../ui/prompt/recipes/param-bench.md?raw";
+import stepper from "../../ui/prompt/recipes/stepper.md?raw";
+import inspectGrid from "../../ui/prompt/recipes/inspect-grid.md?raw";
+import compare from "../../ui/prompt/recipes/compare.md?raw";
+import trace from "../../ui/prompt/recipes/trace.md?raw";
+import converter from "../../ui/prompt/recipes/converter.md?raw";
+import plan from "../../ui/prompt/recipes/plan.md?raw";
+import dataChart from "../../ui/prompt/recipes/data-chart.md?raw";
+import codeWalkthrough from "../../ui/prompt/recipes/code-walkthrough.md?raw";
+import { findBlocks, intentHash, setCompiled, splitUiBody } from "../../ui/core/fence.mjs";
+import { checkUiBlock } from "../../ui/core/validate.mjs";
+import { buildPrompt, RECIPE_FILES } from "../../ui/prompt/build.mjs";
+
+const recipeText: Record<string, string> = {
+  "param-bench.md": paramBench,
+  "stepper.md": stepper,
+  "inspect-grid.md": inspectGrid,
+  "compare.md": compare,
+  "trace.md": trace,
+  "converter.md": converter,
+  "plan.md": plan,
+  "data-chart.md": dataChart,
+  "code-walkthrough.md": codeWalkthrough,
+};
+
+export const recipeSources = RECIPE_FILES.map((file) => ({ file, markdown: recipeText[file] ?? "" }));
+
+const systemPrompt = buildPrompt({ rules, recipes: recipeSources.map((recipe) => recipe.markdown), studio });
+
+export type DraftDiagnostic = { code: string; line: number; message: string; severity: "error" | "warning" };
+export type DraftUsage = { prompt_tokens: number; completion_tokens: number; total_tokens: number };
+export type DraftResult = {
+  fence: string | null;
+  note: string | null;
+  diagnostics: DraftDiagnostic[];
+  rounds: number;
+  usage: DraftUsage;
+  error?: string;
+  raw?: string;
+};
+
+export function modelConfig() {
+  const baseUrl = process.env.UI_MODEL_BASE_URL;
+  const apiKey = process.env.UI_MODEL_API_KEY;
+  const model = process.env.UI_MODEL_NAME;
+  if (!baseUrl || !apiKey || !model) return null;
+  return { baseUrl: baseUrl.replace(/\/+$/u, ""), apiKey, model };
+}
+
+const hourlyLimit = () => {
+  const value = Number(process.env.UI_DRAFT_RATE_LIMIT ?? 60);
+  return Number.isFinite(value) && value > 0 ? Math.floor(value) : 60;
+};
+
+// Per process: exact for a single Node admin, approximate across Worker isolates.
+const recentDrafts = new Map<string, number[]>();
+
+export function remainingDrafts(login: string) {
+  const cutoff = Date.now() - 60 * 60 * 1000;
+  const recent = (recentDrafts.get(login) ?? []).filter((time) => time > cutoff);
+  recentDrafts.set(login, recent);
+  return Math.max(0, hourlyLimit() - recent.length);
+}
+
+export function consumeDraft(login: string) {
+  if (remainingDrafts(login) <= 0) return false;
+  recentDrafts.get(login)?.push(Date.now());
+  return true;
+}
+
+type Message = { role: "system" | "user" | "assistant"; content: string };
+
+async function complete(messages: Message[]) {
+  const config = modelConfig();
+  if (!config) throw new Error("后台还没接上模型：请配置 UI_MODEL_BASE_URL、UI_MODEL_API_KEY 和 UI_MODEL_NAME。");
+  const response = await fetch(`${config.baseUrl}/chat/completions`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${config.apiKey}` },
+    body: JSON.stringify({ model: config.model, messages, temperature: 0.2 }),
+    signal: AbortSignal.timeout(120_000),
+  });
+  const result = (await response.json().catch(() => ({}))) as {
+    choices?: Array<{ message?: { content?: string } }>;
+    usage?: Partial<DraftUsage>;
+    error?: { message?: string };
+  };
+  if (!response.ok) throw new Error(result.error?.message ?? `模型接口返回 ${response.status}`);
+  return { content: result.choices?.[0]?.message?.content ?? "", usage: result.usage ?? {} };
+}
+
+function extract(content: string) {
+  const fence = findBlocks(content).find((block) => block.lang === "ui" && block.closed);
+  const before = fence ? content.slice(0, fence.start) : content;
+  const note = /^提醒[:：]\s*(.+)$/mu.exec(before)?.[1]?.trim() ?? null;
+  return { fence, note };
+}
+
+/**
+ * One workbench generation: create from an instruction, or revise the current
+ * fence. Diagnostics go back to the model for up to two repair rounds.
+ */
+export async function draftUiBlock(input: { mode: "create" | "revise"; instruction: string; fence?: string }): Promise<DraftResult> {
+  const usage: DraftUsage = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+  const messages: Message[] = [
+    { role: "system", content: systemPrompt },
+    {
+      role: "user",
+      content: input.mode === "revise" && input.fence
+        ? `当前围栏：\n\n${input.fence}\n\n修改要求：${input.instruction}`
+        : input.instruction,
+    },
+  ];
+  let lastContent = "";
+  for (let round = 0; round <= 2; round += 1) {
+    const reply = await complete(messages);
+    lastContent = reply.content;
+    usage.prompt_tokens += reply.usage.prompt_tokens ?? 0;
+    usage.completion_tokens += reply.usage.completion_tokens ?? 0;
+    usage.total_tokens += reply.usage.total_tokens ?? 0;
+    const { fence, note } = extract(reply.content);
+    if (!fence) {
+      if (round === 2) break;
+      messages.push({ role: "assistant", content: reply.content }, { role: "user", content: "回复里没有 ui 围栏。请只回复一个完整的 ui 围栏。" });
+      continue;
+    }
+    // lineOffset 1: in the workbench editor the fence starts on line 1.
+    const check = checkUiBlock(fence.body, { lineOffset: 1, skipData: true });
+    const errors = (check.diagnostics as DraftDiagnostic[]).filter((item) => item.severity === "error");
+    const { header } = splitUiBody(fence.body);
+    const stamped = typeof header?.intent === "string" ? setCompiled(fence.raw, intentHash(header.intent)) : fence.raw;
+    if (!errors.length || round === 2) {
+      return { fence: stamped, note, diagnostics: check.diagnostics as DraftDiagnostic[], rounds: round, usage };
+    }
+    messages.push(
+      { role: "assistant", content: reply.content },
+      {
+        role: "user",
+        content: `程序校验发现这些问题：\n${errors.map((item) => `- 第 ${item.line} 行 ${item.code}：${item.message}`).join("\n")}\n请修正后重新给出完整的 ui 围栏，格式不变。`,
+      },
+    );
+  }
+  return { fence: null, note: null, diagnostics: [], rounds: 2, usage, error: "模型没有给出 ui 围栏", raw: lastContent };
+}

package/app/raw.d.ts

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

package/app/rss.xml/route.ts

@@ -2,6 +2,7 @@ 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";
+import { contentForFeed } from "../../ui/core/transform.mjs";
 
 const escapeXml = (value: string) =>
   value
@@ -31,7 +32,7 @@ export async function GET() {
 
   const items = entries
     .map((entry) => {
-      const body = marked.parse(entry.content, {
+      const body = marked.parse(contentForFeed(entry.content, { pageUrl: `${origin}${entry.path}`, siteUrl: origin }), {
         async: false,
         gfm: true,
         breaks: true,

package/app/ui-parity/page.tsx

@@ -0,0 +1,120 @@
+const slices = [
+  { label: "商品销售", value: 78.2, color: "#539af8" },
+  { label: "平台与营销服务", value: 9.4, color: "#6bc67f" },
+  { label: "物流及其他服务", value: 12.4, color: "#ef8b57" },
+];
+
+function ring(start: number, sweep: number) {
+  const cx = 371;
+  const cy = 181;
+  const outer = 137.28;
+  const inner = 70.4;
+  const end = start + sweep;
+  const point = (radius: number, angle: number) => [cx + radius * Math.cos(angle), cy + radius * Math.sin(angle)];
+  const large = sweep > Math.PI ? 1 : 0;
+  const [x0, y0] = point(outer, start);
+  const [x1, y1] = point(outer, end);
+  const [x2, y2] = point(inner, end);
+  const [x3, y3] = point(inner, start);
+  return `M ${x0} ${y0} A ${outer} ${outer} 0 ${large} 1 ${x1} ${y1} L ${x2} ${y2} A ${inner} ${inner} 0 ${large} 0 ${x3} ${y3} Z`;
+}
+
+function Arrow() {
+  return (
+    <svg className="garden-ui-flow-arrow" viewBox="0 0 24 24" aria-hidden="true">
+      <path fill="currentColor" fillRule="evenodd" d="M12.707 18.707a1 1 0 0 1-1.414 0l-5-5a1 1 0 1 1 1.414-1.414L11 15.586V6a1 1 0 1 1 2 0v9.586l3.293-3.293a1 1 0 0 1 1.414 1.414l-5 5Z" clipRule="evenodd" />
+    </svg>
+  );
+}
+
+function Loop() {
+  return (
+    <svg className="garden-ui-flow-loop" viewBox="0 0 24 24" aria-hidden="true">
+      <path fill="currentColor" d="M3.06956 10.8763C3.6233 6.43564 7.40965 3 12 3C14.2823 3 16.4028 3.85067 18.0118 5.25439V4C18.0118 3.44772 18.4595 3 19.0118 3C19.5641 3 20.0118 3.44772 20.0118 4V8C20.0118 8.55228 19.5641 9 19.0118 9H15C14.4477 9 14 8.55228 14 8C14 7.44772 14.4477 7 15 7H16.9571C15.6756 5.76379 13.9101 5 12 5C8.43107 5 5.48465 7.67174 5.05419 11.1237C4.98585 11.6718 4.48617 12.0607 3.93813 11.9923C3.39009 11.924 3.00122 11.4243 3.06956 10.8763ZM20.0618 12.0077C20.6099 12.076 20.9987 12.5757 20.9304 13.1237C20.3767 17.5644 16.5903 21 12 21C9.72321 21 7.6076 20.1535 5.99998 18.7559V20C5.99998 20.5523 5.55226 21 4.99998 21C4.44769 21 3.99998 20.5523 3.99998 20V16C3.99998 15.4477 4.44769 15 4.99998 15H8.99998C9.55226 15 9.99998 15.4477 9.99998 16C9.99998 16.5523 9.55226 17 8.99998 17H7.04283C8.32432 18.2362 10.0899 19 12 19C15.5689 19 18.5153 16.3283 18.9458 12.8763C19.0141 12.3282 19.5138 11.9393 20.0618 12.0077Z" />
+    </svg>
+  );
+}
+
+export default function UiParityPage() {
+  const total = slices.reduce((sum, slice) => sum + slice.value, 0);
+  let angle = -Math.PI / 2;
+  const arcs = slices.map((slice) => {
+    const sweep = (slice.value / total) * Math.PI * 2;
+    const path = ring(angle, sweep);
+    angle += sweep;
+    return { ...slice, path };
+  });
+  const rows = [
+    ["消费者状态", "不选择拼多多的原因", "对应的经济学概念"],
+    ["不知道拼多多更便宜", "没有进行跨平台比价", "信息不对称、搜索成本"],
+    ["知道更便宜，但不放心", "怀疑商品品质、商家或售后", "感知风险、信任成本"],
+    ["知道更便宜，也相信是正品", "习惯使用天猫，不想迁移", "转换成本、消费惯性"],
+  ];
+  return (
+    <main className="garden-ui" lang="en-US" style={{ margin: 0, border: 0, background: "#fff", padding: 32 }}>
+      <section id="parity-stat" className="garden-ui-card" style={{ width: 768, marginBottom: 32 }}>
+        <p className="garden-ui-kicker">2025 抖音电商发展数据报告</p>
+        <p className="garden-ui-title-2xl">+49%</p>
+        <p className="garden-ui-subtitle">货架场景成交额同比增长</p>
+        <p className="garden-ui-text-sm">统计期为 2024 年 8 月至 2025 年 8 月。</p>
+        <p className="garden-ui-caption">
+          {"抖音电商官方报告，经新华社报道。该增速不能直接代表抖音电商整体 GMV 增速。"}<a id="parity-cite" className="garden-ui-cite" href="https://www.news.cn">
+            <img src="https://www.google.com/s2/favicons?domain=www.news.cn&sz=32" alt="" width={12} height={12} />
+            Xinhua Net
+          </a>
+        </p>
+      </section>
+      <section id="parity-card" className="garden-ui-card" style={{ width: 378, marginBottom: 32 }}>
+        <p className="garden-ui-kicker">2025 年淘宝天猫商品索引规模</p>
+        <p className="garden-ui-title-2xl">20 亿+</p>
+        <p className="garden-ui-text-xs">商品条目</p>
+        <p className="garden-ui-caption">
+          {"阿里巴巴披露其 AI 搜索推荐系统索引了超过 20 亿商品条目。"}<a className="garden-ui-cite" href="https://www.alibabagroup.com">
+            <img src="https://www.google.com/s2/favicons?domain=www.alibabagroup.com&sz=32" alt="" width={12} height={12} />
+            Alibaba Group
+          </a>
+        </p>
+      </section>
+      <section id="parity-pie" className="garden-ui-pie" style={{ width: 742, marginBottom: 32 }}>
+        <div className="garden-ui-pie-chart">
+          <svg viewBox="0 0 742 400" role="img" aria-label="收入结构">
+            {arcs.map((arc) => <path key={arc.label} d={arc.path} fill={arc.color} />)}
+          </svg>
+          <ul className="garden-ui-legend">
+            {arcs.map((arc) => (
+              <li key={arc.label}><span className="garden-ui-swatch" style={{ background: arc.color }} />{arc.label}</li>
+            ))}
+          </ul>
+        </div>
+        <p className="garden-ui-pie-note">京东集团2025财年；商品与服务收入的会计确认方式不同。</p>
+      </section>
+      <section id="parity-table" style={{ width: 768, marginBottom: 32 }}>
+        <table className="garden-ui-table" style={{ tableLayout: "fixed" }}>
+          <colgroup>
+            <col style={{ width: 265.9 }} />
+            <col style={{ width: 278.5 }} />
+            <col style={{ width: 223.6 }} />
+          </colgroup>
+          <thead>
+            <tr>{rows[0].map((cell) => <th key={cell}>{cell}</th>)}</tr>
+          </thead>
+          <tbody>
+            {rows.slice(1).map((row) => (
+              <tr key={row[0]}>{row.map((cell) => <td key={cell}>{cell}</td>)}</tr>
+            ))}
+          </tbody>
+        </table>
+      </section>
+      <section id="parity-flow" className="garden-ui-card garden-ui-flow" style={{ width: 768 }}>
+        <p>丰富的商家与商品供给</p>
+        <Arrow />
+        <p>吸引更多具有不同需求的消费者</p>
+        <Arrow />
+        <p>更大的潜在成交机会吸引商家</p>
+        <Arrow />
+        <p>更丰富的供给与交易数据</p>
+        <Loop />
+      </section>
+    </main>
+  );
+}

package/bin/garden.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { randomBytes } from "node:crypto";
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
@@ -189,6 +190,42 @@ function ensureSiteKit(destinationRoot = siteRoot) {
   }
 
   installSkill(destinationRoot, { onlyMissing: true });
+  if (process.env.GARDEN_SKIP_HOOKS !== "1") installHook(destinationRoot, { quiet: true });
+}
+
+const HOOK_MARKER = "# garden: ui check";
+const HOOK_SCRIPT = `#!/bin/sh
+${HOOK_MARKER}
+if [ ! -d node_modules/hd-garden ]; then
+  echo "garden 还没安装（先运行 npm install），这次跳过 ui 检查。" >&2
+  exit 0
+fi
+exec npx --no-install garden ui check --staged --quiet
+`;
+
+/** Installs the pre-commit hook unless the repository already has one. */
+function installHook(destinationRoot = siteRoot, { quiet = false, force = false } = {}) {
+  const result = spawnSync("git", ["rev-parse", "--git-path", "hooks/pre-commit"], { cwd: destinationRoot, encoding: "utf8" });
+  if (result.status !== 0) {
+    if (!quiet) process.stdout.write("这里不是 git 仓库，没有安装提交前检查。\n");
+    return;
+  }
+  const hookPath = path.resolve(destinationRoot, result.stdout.trim());
+  if (fs.existsSync(hookPath)) {
+    const current = fs.readFileSync(hookPath, "utf8");
+    if (current.includes(HOOK_MARKER) && !force) {
+      if (!quiet) process.stdout.write("提交前检查已经装好了。\n");
+      return;
+    }
+    if (!current.includes(HOOK_MARKER)) {
+      process.stdout.write(`已有 pre-commit 钩子，没有覆盖。请把这一行加进 ${path.relative(destinationRoot, hookPath)}：\n  npx --no-install garden ui check --staged --quiet\n`);
+      return;
+    }
+  }
+  fs.mkdirSync(path.dirname(hookPath), { recursive: true });
+  fs.writeFileSync(hookPath, HOOK_SCRIPT, { mode: 0o755 });
+  fs.chmodSync(hookPath, 0o755);
+  process.stdout.write("已安装提交前检查：提交时会检查暂存稿件里的 ui 块。\n");
 }
 
 function prepare() {
@@ -207,6 +244,31 @@ function sync() {
   runNode("scripts/build-content.mjs");
 }
 
+function upsertEnv(text, key, value) {
+  const pattern = new RegExp(`^${key}=.*$`, "m");
+  if (pattern.test(text)) return text.replace(pattern, `${key}=${value}`);
+  return `${text.endsWith("\n") || text.length === 0 ? text : `${text}\n`}${key}=${value}\n`;
+}
+
+function currentGitHubToken() {
+  const result = spawnSync("gh", ["auth", "token"], { encoding: "utf8" });
+  if (result.status !== 0) return "";
+  return result.stdout.trim();
+}
+
+/** Local dev signs in as the gh user. Production keeps the OAuth app on the worker. */
+function ensureDevGitHubLogin() {
+  const local = path.join(siteRoot, ".env.local");
+  let text = fs.existsSync(local) ? fs.readFileSync(local, "utf8") : "";
+  text = upsertEnv(text, "GARDEN_DEV", "1");
+  const token = currentGitHubToken();
+  if (token) text = upsertEnv(text, "GITHUB_DEV_TOKEN", token);
+  if (!/^GITHUB_SESSION_SECRET=\S+/m.test(text)) {
+    text = upsertEnv(text, "GITHUB_SESSION_SECRET", randomBytes(32).toString("base64url"));
+  }
+  fs.writeFileSync(local, text.endsWith("\n") ? text : `${text}\n`);
+}
+
 function runVinext(vinextArgs, { copyDist = false } = {}) {
   sync();
   const cwd = vinextRoot();
@@ -294,6 +356,8 @@ function help() {
   garden embed            拉取外链摘要
   garden init [目录]      创建只含稿和配置的新站点
   garden check <文章.md>  检查一篇博文的硬性结构
+  garden ui <子命令>      Intelligent UI：scan、check、apply、prompt、schema、catalog
+  garden hooks            安装提交前检查（检查暂存稿件里的 ui 块）
   garden skill            把引擎自带的 skill 装进当前站点
   garden pages:validate   检查 dist/client
   garden pages:prepare    写入公开产物仓库
@@ -311,6 +375,7 @@ switch (command) {
     sync();
     break;
   case "dev":
+    ensureDevGitHubLogin();
     runVinext(["dev", ...rest]);
     break;
   case "build":
@@ -328,6 +393,12 @@ switch (command) {
   case "check":
     runNode("scripts/check-post.mjs", rest);
     break;
+  case "ui":
+    runNode("scripts/ui-cli.mjs", rest, { cwd: process.cwd() });
+    break;
+  case "hooks":
+    installHook(siteRoot, { force: rest.includes("--force") });
+    break;
   case "init":
     initSite();
     break;

package/eslint.config.mjs

@@ -13,6 +13,9 @@ const eslintConfig = defineConfig([
     "build/**",
     ".garden/**",
     "templates/**",
+    // Bundled output of the editor preview and plugins.
+    "ui/preview/dist/**",
+    "editors/*/dist/**",
     "next-env.d.ts",
   ]),
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",
@@ -31,6 +31,7 @@
     "public/images",
     "scripts",
     "templates",
+    "ui",
     "worker",
     ".agents",
     ".env.example",
@@ -62,21 +63,33 @@
     "admin:local": "npm run start -- --host 0.0.0.0 --port 3000",
     "admin:cloudflare": "npm run build && wrangler deploy --config dist/server/wrangler.json",
     "test": "npm run build && node --test tests/*.test.mjs",
+    "ui:build": "node scripts/build-ui-preview.mjs",
+    "editors:build": "node editors/vscode/build.mjs && node editors/obsidian/build.mjs && node editors/typora/build.mjs",
+    "prepack": "node scripts/build-ui-preview.mjs",
     "lint": "node bin/garden.mjs sync && eslint . --ignore-pattern dist --ignore-pattern .next --ignore-pattern .garden --ignore-pattern templates"
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "1.37.1",
+    "@codemirror/commands": "^6.11.1",
+    "@codemirror/state": "^6.7.6",
+    "@codemirror/view": "^6.43.14",
     "@phosphor-icons/react": "^2.1.10",
     "@tailwindcss/postcss": "4.2.1",
     "@vitejs/plugin-react": "6.0.4",
     "@vitejs/plugin-rsc": "0.5.30",
+    "acorn": "^8.19.0",
     "fuse.js": "^7.5.0",
     "github-slugger": "^2.0.0",
     "gray-matter": "^4.0.3",
     "katex": "^0.16.47",
     "marked": "^16.4.2",
+    "mdast-util-from-markdown": "^2.1.0",
+    "mdast-util-mdx-expression": "^2.0.1",
+    "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-to-string": "^4.0.0",
     "mermaid": "^11.16.0",
+    "micromark-extension-mdx-expression": "^3.0.1",
+    "micromark-extension-mdx-jsx": "^3.0.2",
     "next": "16.3.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
@@ -105,6 +118,7 @@
     "@types/node": "22.19.19",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
+    "esbuild": "^0.28.2",
     "eslint": "9.39.4",
     "eslint-config-next": "16.2.12"
   },