hd-garden 0.8.0 → 0.8.2

package/.agents/skills/garden-ui/SKILL.md

@@ -11,7 +11,7 @@ description: >-
 
 # 编译 Garden 交互块
 
-作者在稿里用不带名字的 `garden` 围栏写一句想法，这个 skill 把它变成 `garden interactive` 或别的 `garden` 组件。交互组件和设计规则在 `npx garden ui prompt` 的输出里，9 个 `garden` 组件的用途和示例在 `node_modules/hd-garden/templates/garden-blocks.md`（在引擎仓库里是 `templates/garden-blocks.md`），以这两份为准，不凭记忆写组件。
+作者在稿里用不带名字的 `garden` 围栏写一句想法，这个 skill 把它变成 `garden interactive` 或别的 `garden` 组件。交互组件和设计规则在 `npx garden ui prompt` 的输出里，12 个 `garden` 组件的用途和示例在 `node_modules/hd-garden/templates/garden-blocks.md`（在引擎仓库里是 `templates/garden-blocks.md`），以这两份为准，不凭记忆写组件。
 
 作者提交时，提交前钩子跑的是同一个 `npx garden ui check`。你用来找块、写回、自查的命令，和拦住作者提交的命令是同一套。
 
@@ -48,7 +48,7 @@ description: >-
    - **写回正文**：一句话、一张表或一张 Mermaid 就能说清时。
    - **写 `garden interactive`**：读者需要拖、点、翻才能看懂时。
    - **写一段 `diff`**：想法紧跟在一段完整代码后面，说的是「和上一版比改了什么」时。按原话写出 diff，用一段普通 Markdown 写回（只有这一个 `diff` 围栏）。写回后它紧挨着那段代码，页面会合成「代码 / 对比上一版」切换；diff 里的新行要和上面的完整代码一致。
-   - **写别的 `garden` 组件**：一张资源卡、几个指标、两种做法并排、一条时间线、一张静态图表、一张结构图、一份下载文件。
+   - **写别的 `garden` 组件**：一张或多张资源卡（`card` / `cards`）、几个指标（`stat`）、两种做法并排或好坏对照（`compare` / `verdict: good|bad`）、一条时间线（`timeline`）、一张静态图表（`chart`）、一张分区结构图（`figure`）、一份下载文件（`file`）、3～6 个要素的关系图（`relations`）、紧凑图标列表或分步列表（`list`）、两三个选项的选择卡（`choice`）。字段与校验约束见 `npx garden ui prompt` 与 `templates/garden-blocks.md`。
    - **写 `garden html`**：目录表达不了的画布动画、音频、物理模拟等。按 [garden-interactive-chart](../garden-interactive-chart/SKILL.md) 在同名目录写 HTML，用 `title` 写下判断。
 
 4. 写 `garden interactive` 时：

package/.env.en.example

@@ -0,0 +1,67 @@
+# Public blog canonical URL without a trailing slash. Used by GitHub Pages builds and the standalone admin studio.
+SITE_URL=https://your-name.github.io
+NEXT_PUBLIC_SITE_URL=https://your-name.github.io
+
+# Standalone admin studio URL; static exports redirect /admin here.
+ADMIN_URL=https://admin.example.com
+
+# Optional: explicit GitHub OAuth callback URL when behind a reverse proxy or multiple domains.
+# GITHUB_OAUTH_REDIRECT_URI=https://admin.example.com/api/auth/github/callback
+
+# Comments are disabled by default. Open https://giscus.app, install the app, uncomment below, and fill in real values.
+# The repository must be public (owner/name) with Discussions enabled.
+# Also add the same four variables under GitHub Actions Variables for production builds.
+# To publish without comments, set the Actions Variable GISCUS_DISABLED to 1.
+# GISCUS_REPO=
+# GISCUS_REPO_ID=
+# GISCUS_CATEGORY=
+# GISCUS_CATEGORY_ID=
+
+# Webmention.io: set your domain (without https://) after registering a custom domain.
+WEBMENTION_IO_DOMAIN=example.com
+
+# Optional: override the default Webmention.io endpoint when self-hosting.
+# WEBMENTION_ENDPOINT=https://example.com/webmention
+
+# Optional: display exact commit counts, pinned repositories, and contribution graph on /about locally. Server-only.
+# GITHUB_TOKEN=github_pat_xxx
+
+# Optional: cookie-free analytics, such as Plausible.
+# NEXT_PUBLIC_ANALYTICS_DOMAIN=example.com
+# NEXT_PUBLIC_ANALYTICS_SCRIPT=https://plausible.io/js/script.js
+
+# Optional: include drafts and future-dated posts during local builds.
+# CONTENT_INCLUDE_DRAFTS=1
+
+# Admin studio: GitHub OAuth App, allowed logins, and fine-grained PAT for writing to the content repository.
+# Callback URL: https://admin.example.com/api/auth/github/callback
+# CONTENT_REPOSITORY=owner/repository
+# CONTENT_BRANCH=main
+# CONTENT_GITHUB_TOKEN=github_pat_xxxxxxxxxxxx
+# GITHUB_OAUTH_CLIENT_ID=Ov23li_xxxxxxxxxxxx
+# GITHUB_OAUTH_CLIENT_SECRET=xxxxxxxxxxxxxxxx
+# GITHUB_SESSION_SECRET=use-a-random-string-at-least-32-characters-long
+# ADMIN_GITHUB_LOGINS=your-github-login
+
+# Admin media: Alibaba Cloud OSS. AccessKeys stay on the admin server and are never sent to the browser.
+# OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
+# OSS_BUCKET=your-public-media-bucket
+# OSS_ACCESS_KEY_ID=LTAIxxxxxxxx
+# OSS_ACCESS_KEY_SECRET=xxxxxxxx
+# OSS_PREFIX=blog-media
+# OSS_PUBLIC_BASE_URL=https://media.example.com
+# OSS_MAX_UPLOAD_MB=200
+
+# Admin UI studio: OpenAI-compatible endpoint. API keys stay on the admin server only.
+# UI_MODEL_BASE_URL=https://api.openai.com/v1
+# UI_MODEL_API_KEY=sk-xxxxxxxx
+# UI_MODEL_NAME=gpt-5.6
+# UI_DRAFT_RATE_LIMIT=60
+# Optional: GitHub Enterprise or local mock API base URL.
+# GITHUB_API_URL=https://api.github.com
+
+# Content distribution: X uses a user access token with write permissions; other platforms use your webhook bridges.
+# X_USER_ACCESS_TOKEN=xxxxxxxx
+# CSDN_SYNC_WEBHOOK=https://publisher.example.com/csdn
+# ZHIHU_SYNC_WEBHOOK=https://publisher.example.com/zhihu
+# JUEJIN_SYNC_WEBHOOK=https://publisher.example.com/juejin

package/README.en.md

@@ -29,7 +29,7 @@ Where you want a component or interactive calculation, write an unnamed `garden`
 ```
 ````
 
-Ask your Agent to compile the post using the bundled `garden-ui` skill: it runs `npx garden ui scan` to locate uncompiled or broken blocks, reads the component catalog from `npx garden ui prompt`, generates a `garden interactive` block (or `card`, `stat`, `compare`, `timeline`, `chart`, `figure`, `html`, `file`, or a `diff` block right below a code snippet), and writes only that fence back via `npx garden ui apply`. If you run `git commit` before compiling, the pre-commit hook runs `npx --no-install garden ui check --staged --quiet`, stops the commit, and prints a ready-to-paste fix prompt for your AI.
+Ask your Agent to compile the post using the bundled `garden-ui` skill: it runs `npx garden ui scan` to locate uncompiled or broken blocks, reads the component catalog from `npx garden ui prompt`, generates a `garden interactive` block (or `card`, `stat`, `compare`, `timeline`, `chart`, `figure`, `html`, `file`, `relations`, `list`, `choice`, or a `diff` block right below a code snippet), and writes only that fence back via `npx garden ui apply`. If you run `git commit` before compiling, the pre-commit hook runs `npx --no-install garden ui check --staged --quiet`, stops the commit, and prints a ready-to-paste fix prompt for your AI.
 
 ## 3. Common commands
 
@@ -48,7 +48,7 @@ npx garden ui catalog                           # Generate an offline component
 
 Start `make dev` and open `/garden/en` (Chinese at `/garden`), or read the markdown sources directly:
 
-- **[Garden Handbook (English)](docs/handbook/en/index.md)** · **[Garden 使用说明（中文）](docs/handbook/index.md)**: [Quick Start](docs/handbook/en/start.md), [Writing with AI](docs/handbook/en/ai-writing.md), [Site & Column Configuration](docs/handbook/en/config.md), [Deploy to GitHub Pages](docs/handbook/en/deploy.md), [Writing Posts & Thoughts](docs/handbook/en/writing.md), [How Reading Layout Works](docs/handbook/en/design.md), [9 Built-in Components](docs/handbook/en/components.md), and [Checking & Shortcuts](docs/handbook/en/workflow.md).
+- **[Garden Handbook (English)](docs/handbook/en/index.md)** · **[Garden 使用说明（中文）](docs/handbook/index.md)**: [Quick Start](docs/handbook/en/start.md), [Writing with AI](docs/handbook/en/ai-writing.md), [Site & Column Configuration](docs/handbook/en/config.md), [Deploy to GitHub Pages](docs/handbook/en/deploy.md), [Writing Posts & Thoughts](docs/handbook/en/writing.md), [How Reading Layout Works](docs/handbook/en/design.md), [12 Built-in Components](docs/handbook/en/components.md), and [Checking & Shortcuts](docs/handbook/en/workflow.md).
 - **[Quick Start Guide](docs/quick-start.md)** and **[GitHub Pages Deployment](docs/github-pages.md)**: single public repository or private source + public output repository setup, plus Giscus comments.
 - **[Admin Service](docs/admin-service.md)**: optional `/admin` server (local, Docker, or Cloudflare Workers) for posting thoughts from the web, uploading media to Alibaba Cloud OSS, and using the `/admin/ui` workbench.
 

package/README.md

@@ -31,7 +31,7 @@ make dev
 ```
 ````
 
-让 Agent 按站点里的 `garden-ui` skill 处理这篇稿件：Agent 先用 `npx garden ui scan` 读取待编译块的哈希，再读 `npx garden ui prompt` 的组件规则，生成 `garden interactive`（或 `card`、`stat`、`compare`、`timeline`、`chart`、`figure`、`html`、`file` 等内置组件，或在完整代码下方生成 `diff`），最后用 `npx garden ui apply` 只替换该围栏。如果你在编译前直接 `git commit`，pre-commit 钩子会运行同一条 `npx --no-install garden ui check --staged --quiet` 拦下提交，并打印一段可直接粘贴给 AI 的修复提示词。
+让 Agent 按站点里的 `garden-ui` skill 处理这篇稿件：Agent 先用 `npx garden ui scan` 读取待编译块的哈希，再读 `npx garden ui prompt` 的组件规则，生成 `garden interactive`（或 `card`、`stat`、`compare`、`timeline`、`chart`、`figure`、`html`、`file`、`relations`、`list`、`choice` 等内置组件，或在完整代码下方生成 `diff`），最后用 `npx garden ui apply` 只替换该围栏。如果你在编译前直接 `git commit`，pre-commit 钩子会运行同一条 `npx --no-install garden ui check --staged --quiet` 拦下提交，并打印一段可直接粘贴给 AI 的修复提示词。
 
 ## 3. 常用命令
 
@@ -50,7 +50,7 @@ npx garden ui catalog                          # 在 .garden/ui-catalog.html 生
 
 本地运行 `make dev` 后访问 `/garden`（英文版在 `/garden/en`），或直接阅读仓库内的文档：
 
-- **[Garden 使用说明（中文）](docs/handbook/index.md)** · **[Garden Handbook (English)](docs/handbook/en/index.md)**：快速开始、[用 AI 写作](docs/handbook/ai-writing.md)、[站点与专栏配置](docs/handbook/config.md)、[发布到 GitHub Pages](docs/handbook/deploy.md)、[写文章与随想](docs/handbook/writing.md)、[阅读排版](docs/handbook/design.md)、[9 个内置组件](docs/handbook/components.md) 与 [语法检查](docs/handbook/workflow.md)。
+- **[Garden 使用说明（中文）](docs/handbook/index.md)** · **[Garden Handbook (English)](docs/handbook/en/index.md)**：快速开始、[用 AI 写作](docs/handbook/ai-writing.md)、[站点与专栏配置](docs/handbook/config.md)、[发布到 GitHub Pages](docs/handbook/deploy.md)、[写文章与随想](docs/handbook/writing.md)、[阅读排版](docs/handbook/design.md)、[12 个内置组件](docs/handbook/components.md) 与 [语法检查](docs/handbook/workflow.md)。
 - **[从零开始](docs/quick-start.md)** 与 **[GitHub Pages 部署](docs/github-pages.md)**：单公开仓库或「私有源码仓库 + 公开页面仓库」的 Actions 配置与 Giscus 评论接入。
 - **[独立管理后台](docs/admin-service.md)**：可选的 `/admin` 服务（本地、Docker 或 Cloudflare Workers），支持网页发随想、阿里云 OSS 媒体直传与 `/admin/ui` 组件工作台。
 

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

@@ -7,6 +7,7 @@ import { TableOfContents } from "../../components/TableOfContents";
 import { a2WordCounts } from "@garden/generated-content";
 import { demoDateLabel, demoDateTime } from "../../lib/a2-meta";
 import { extractHeadings } from "../../lib/content";
+import { siteLang, ui } from "../../lib/i18n";
 import { a2Slugs, readA2Article } from "../../lib/a2-preview";
 import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
 
@@ -37,9 +38,9 @@ export default async function A2ArticlePage({ params }: { params: Promise<{ slug
           <ArticleTitle title={article.title.replace(/（互动版）$/u, "")} />
           <ul className="meta article-meta">
             <li>Hedon</li>
-            {article.date ? <li><time dateTime={demoDateTime(article.date)}>{demoDateLabel(article.date)}</time></li> : null}
-            <li>约 {wordCount.toLocaleString("en-US")} 字</li>
-            {article.original ? <li><a className="orig ext" href={article.original} target="_blank" rel="noopener noreferrer">原文 ↗</a></li> : null}
+            {article.date ? <li><time dateTime={demoDateTime(article.date)}>{demoDateLabel(article.date, siteLang)}</time></li> : null}
+            <li>{siteLang === "en" ? ui().wordCount(wordCount) : <>约 {wordCount.toLocaleString("en-US")} 字</>}</li>
+            {article.original ? <li><a className="orig ext" href={article.original} target="_blank" rel="noopener noreferrer">{siteLang === "en" ? "Original ↗" : "原文 ↗"}</a></li> : null}
           </ul>
           {article.cover ? (
             <figure className="article-hero article-cover cover-card cover-img">

package/app/a2/page.tsx

@@ -1,9 +1,10 @@
 import Link from "next/link";
 import { siteHref } from "../lib/site-href";
 import { a2Slugs, readA2Article } from "../lib/a2-preview";
+import { ui } from "../lib/i18n";
 
 export const metadata = {
-  title: "A2 对照",
+  title: ui().a2IndexTitle,
   robots: { index: false, follow: false },
 };
 
@@ -12,8 +13,8 @@ export default function A2Index() {
   return (
     <main className="page-shell index-page">
       <header className="sh-head">
-        <h1>A2 对照</h1>
-        <p className="sh-deck">对照参考文章的版式。正文没有改字。</p>
+        <h1>{ui().a2IndexTitle}</h1>
+        <p className="sh-deck">{ui().a2IndexDeck}</p>
       </header>
       <ul className="sh-rows">
         {articles.map((article) => (

package/app/about/page.tsx

@@ -5,16 +5,15 @@ import { PageIntro } from "../components/PageIntro";
 import { siteConfig } from "../site.config";
 import { siteHref } from "../lib/site-href";
 import { pageAlternates } from "../lib/page-alternates";
+import { ui } from "../lib/i18n";
 
+const t = ui();
 const about = siteConfig.pages.about;
-const heading = about.heading ?? "关于";
-const paragraphs = about.paragraphs ?? [
-  "一名工程师。平时写代码，也把想清楚的问题记下来。",
-  "这里放文章、随想和专栏。",
-];
+const heading = about.heading ?? t.aboutFallbackHeading;
+const paragraphs = about.paragraphs ?? t.aboutFallbackParagraphs;
 const quote = about.quote ?? "";
-const focus = about.focus ?? ["软件", "笔记", "日常"];
-const cta = about.cta ?? { href: "/blog", label: "浏览博文" };
+const focus = about.focus ?? t.aboutFallbackFocus;
+const cta = about.cta ?? { href: "/blog", label: t.aboutFallbackCta };
 
 export const metadata = {
   title: { absolute: siteConfig.name },
@@ -26,7 +25,7 @@ export default function AboutPage() {
   return (
     <main className="page-shell about-page">
       <PageIntro
-        eyebrow="关于"
+        eyebrow={t.aboutEyebrow}
         title={about.title}
         subtitle={about.subtitle}
       />
@@ -40,7 +39,7 @@ export default function AboutPage() {
           {quote ? <blockquote>{quote}</blockquote> : null}
         </section>
         <aside className="about-facts">
-          <span>现在关注</span>
+          <span>{t.aboutFocusHeading}</span>
           <ul>
             {focus.map((item) => (
               <li key={item}>{item}</li>

package/app/admin/page.tsx

@@ -6,6 +6,7 @@ import { columns, posts, thoughts } from "../lib/content";
 import { isContentRepositoryConfigured, listRepositoryThoughts } from "../lib/github-content";
 import { getSiteUrl } from "../lib/site";
 import { siteConfig } from "../site.config";
+import { ui } from "../lib/i18n";
 import { modelConfig, remainingDrafts } from "../lib/ui-model";
 import { CATALOG_VERSION } from "../../ui/core/catalog.mjs";
 import packageJson from "../../package.json";
@@ -13,7 +14,7 @@ import packageJson from "../../package.json";
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
 
 export const metadata = {
-  title: "内容管理",
+  title: ui().adminTitleMain,
   robots: { index: false, follow: false },
 };
 
@@ -27,17 +28,17 @@ export default async function AdminPage({
     return (
       <main className="admin-access-page">
         <div className="admin-access-card">
-          <h1>后台在另一个地址。</h1>
-          <p>这个页面是公开博客。写随想、上传和转发，去后台。</p>
+          <h1>{ui().staticAdminHeading}</h1>
+          <p>{ui().staticAdminRootBody}</p>
           <div className="admin-access-actions">
             {adminUrl ? (
               <a className="admin-github-login" href={adminUrl}>
-                打开后台 <ArrowSquareOut size={15} />
+                {`${ui().staticAdminOpen} `}<ArrowSquareOut size={15} />
               </a>
             ) : (
-              <p>还没有填写后台地址。</p>
+              <p>{ui().staticAdminNoUrl}</p>
             )}
-            <Link href="/">返回公开博客</Link>
+            <Link href="/">{ui().staticAdminBack}</Link>
           </div>
         </div>
       </main>

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

@@ -7,12 +7,13 @@ import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } fro
 import { MarkdownArticle } from "../../../components/MarkdownArticle";
 import { repositoryContentPath } from "../../../lib/repository-path.mjs";
 import { readMarkdown, readText } from "../../../lib/ui-content";
+import { ui } from "../../../lib/i18n";
 import { formatInlineLink, replaceInlineLinks } from "../../../../ui/garden/markdown-destination.mjs";
 import { STATIC_PLACEHOLDER, staticParams } from "../../../../ui/garden/static-params.mjs";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
 export const dynamicParams = false;
-export const metadata = { title: "草稿预览", robots: { index: false, follow: false } };
+export const metadata = { title: ui().adminTitlePreview, robots: { index: false, follow: false } };
 
 /** Draft preview is served by the admin worker. The public static export has no paths here. */
 export function generateStaticParams() {

package/app/admin/ui/blocks/page.tsx

@@ -1,9 +1,10 @@
 import { AdminBlocks } from "../../../components/AdminUiPanels";
 import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } from "../../../components/AdminUiShell";
+import { ui } from "../../../lib/i18n";
 import { getSiteUrl } from "../../../lib/site";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
-export const metadata = { title: "交互块", robots: { index: false, follow: false } };
+export const metadata = { title: ui().adminTitleBlocks, robots: { index: false, follow: false } };
 
 export default async function UiBlocksPage() {
   if (isStaticExport()) return <StaticAdminNotice />;

package/app/admin/ui/catalog/page.tsx

@@ -1,9 +1,10 @@
 import { AdminCatalog } from "../../../components/AdminUiPanels";
 import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } from "../../../components/AdminUiShell";
+import { ui } from "../../../lib/i18n";
 import { recipeSources } from "../../../lib/ui-model";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
-export const metadata = { title: "组件清单", robots: { index: false, follow: false } };
+export const metadata = { title: ui().adminTitleCatalog, robots: { index: false, follow: false } };
 
 export default async function UiCatalogPage() {
   if (isStaticExport()) return <StaticAdminNotice />;

package/app/admin/ui/evals/page.tsx

@@ -2,10 +2,11 @@ import { parse as parseYaml } from "yaml";
 import casesSource from "../../../../ui/evals/cases.yaml?raw";
 import { AdminEvals } from "../../../components/AdminUiPanels";
 import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } from "../../../components/AdminUiShell";
+import { ui } from "../../../lib/i18n";
 import { modelConfig } from "../../../lib/ui-model";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
-export const metadata = { title: "模型自检", robots: { index: false, follow: false } };
+export const metadata = { title: ui().adminTitleEvals, robots: { index: false, follow: false } };
 
 export default async function UiEvalsPage() {
   if (isStaticExport()) return <StaticAdminNotice />;

package/app/admin/ui/page.tsx

@@ -1,9 +1,10 @@
 import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } from "../../components/AdminUiShell";
 import { UiStudio } from "../../components/UiStudio";
+import { ui } from "../../lib/i18n";
 import { modelConfig, recipeSources, remainingDrafts } from "../../lib/ui-model";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
-export const metadata = { title: "写作台", robots: { index: false, follow: false } };
+export const metadata = { title: ui().adminTitleUi, robots: { index: false, follow: false } };
 
 export default async function UiStudioPage() {
   if (isStaticExport()) return <StaticAdminNotice />;

package/app/blog/[...path]/page.tsx

@@ -28,7 +28,7 @@ import {
 } from "../../lib/site";
 import { githubUrl, siteConfig } from "../../site.config";
 import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
-import { ui } from "../../lib/i18n";
+import { siteLang, ui } from "../../lib/i18n";
 
 export function generateStaticParams() {
   return staticParams(posts.map((post) => ({ path: post.path.split("/") })), { path: [STATIC_PLACEHOLDER] });
@@ -86,12 +86,13 @@ export default async function PostPage({
   const canonicalUrl = absoluteUrl(pathname, baseUrl);
   const wordCount = estimateWordCount(post.content);
   const { prev, next } = adjacentByDate(posts, (item: { path: string }) => item.path === post.path);
+  const t = ui();
 
   return (
     <main className="reading-page post-reading-page">
       <article className="post-article h-entry">
         <Link className="u-url sr-only" href={pathname}>
-          {post.title} 永久链接
+          {siteLang === "en" ? t.permalinkLabel(post.title) : <>{post.title} 永久链接</>}
         </Link>
         <a
           className="p-author h-card sr-only"
@@ -109,18 +110,18 @@ export default async function PostPage({
                 {formatDate(post.date)}
               </time>
             </li>
-            {post.updated ? <li>更新于 {formatDate(post.updated)}</li> : null}
-            <li>{ui().wordCount(wordCount)}</li>
+            {post.updated ? <li>{siteLang === "en" ? t.updatedOn(formatDate(post.updated)) : <>更新于 {formatDate(post.updated)}</>}</li> : null}
+            <li>{t.wordCount(wordCount)}</li>
             {originalUrl(post) ? (
               <li>
-                <a className="orig ext" href={originalUrl(post)} target="_blank" rel="noopener noreferrer">原文 ↗</a>
+                <a className="orig ext" href={originalUrl(post)} target="_blank" rel="noopener noreferrer">{t.originalLink}</a>
               </li>
             ) : null}
           </ul>
           <ArticleTags tags={post.tags} />
           {post.cover && (
             <figure className="article-hero article-cover cover-card cover-img">
-              <CoverImage className="u-photo" src={post.cover} image={post.coverImage} alt={`${post.title} 封面`} sizes="(max-width: 852px) calc(100vw - 40px), 812px" priority />
+              <CoverImage className="u-photo" src={post.cover} image={post.coverImage} alt={t.coverLabel(post.title)} sizes="(max-width: 852px) calc(100vw - 40px), 812px" priority />
             </figure>
           )}
         </header>

package/app/blog/page.tsx

@@ -4,6 +4,7 @@ import { BlogArchive, BlogArchiveFallback } from "../components/BlogArchive";
 import { posts } from "../lib/content";
 import { archivePosts, archiveSeries } from "../lib/archive";
 import { pageAlternates } from "../lib/page-alternates";
+import { siteLang, ui } from "../lib/i18n";
 
 export const metadata = {
   title: siteDocumentTitle,
@@ -12,13 +13,14 @@ export const metadata = {
 };
 
 export default function BlogIndex() {
+  const t = ui();
   const list = archivePosts();
   const series = archiveSeries();
   return (
     <main className="sh-main" id="content">
       <div className="sh-head">
-        <h1 id="sh-title">文章</h1>
-        <p className="sh-deck">阶段性的完整沉淀，关于工程、架构与技术思考。共 {posts.length} 篇，按年份归档。</p>
+        <h1 id="sh-title">{t.blogHeading}</h1>
+        <p className="sh-deck">{siteLang === "en" ? t.blogDeck(posts.length) : <>阶段性的完整沉淀，关于工程、架构与技术思考。共 {posts.length} 篇，按年份归档。</>}</p>
       </div>
       <Suspense fallback={<BlogArchiveFallback posts={list} series={series} />}>
         <BlogArchive posts={list} series={series} />

package/app/columns/[column]/[...path]/page.tsx

@@ -29,7 +29,7 @@ import {
 import { githubUrl, siteConfig } from "../../../site.config";
 import { siteHref } from "../../../lib/site-href";
 import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../../ui/garden/static-params.mjs";
-import { ui } from "../../../lib/i18n";
+import { columnStatusLabel, siteLang, ui } from "../../../lib/i18n";
 
 export function generateStaticParams() {
   return staticParams(
@@ -96,15 +96,16 @@ export default async function ColumnEntryPage({
   const baseUrl = await getSiteUrl();
   const pathname = columnHref(entry);
   const canonicalUrl = absoluteUrl(pathname, baseUrl);
+  const t = ui();
 
   return (
     <main className="column-reading-page">
       <aside className="series-nav">
         <Link href={siteHref("/columns")} className="back-link">
           <ArrowLeft size={15} />
-          所有专栏
+          {t.allColumnsBack}
         </Link>
-        <p>主题专栏</p>
+        <p>{t.seriesEyebrow}</p>
         <h2>{entry.columnTitle}</h2>
         <ol>
           {listed.map((item) => (
@@ -113,12 +114,12 @@ export default async function ColumnEntryPage({
             </li>
           ))}
         </ol>
-        <small>{series.length} 篇 · 持续更新</small>
+        <small>{ui().columnSideCount(series.length, columnStatusLabel(entry.columnStatus))}</small>
       </aside>
 
       <article className="article-column series-article h-entry">
         <Link className="u-url sr-only" href={pathname}>
-          {entry.title} 永久链接
+          {siteLang === "en" ? t.permalinkLabel(entry.title) : <>{entry.title} 永久链接</>}
         </Link>
         <a
           className="p-author h-card sr-only"
@@ -137,13 +138,13 @@ export default async function ColumnEntryPage({
               </time>
             </li>
             {originalUrl(entry) ? (
-              <li><a className="orig ext" href={originalUrl(entry)} target="_blank" rel="noopener noreferrer">原文 ↗</a></li>
+              <li><a className="orig ext" href={originalUrl(entry)} target="_blank" rel="noopener noreferrer">{t.originalLink}</a></li>
             ) : null}
           </ul>
           <ArticleTags tags={entry.tags} />
           {entry.cover && (
             <figure className="article-hero article-cover cover-img">
-              <CoverImage className="u-photo" src={entry.cover} image={entry.coverImage} alt={`${entry.title} 封面`} sizes="(max-width: 852px) calc(100vw - 40px), 812px" priority />
+              <CoverImage className="u-photo" src={entry.cover} image={entry.coverImage} alt={siteLang === "en" ? t.coverLabel(entry.title) : `${entry.title} 封面`} sizes="(max-width: 852px) calc(100vw - 40px), 812px" priority />
             </figure>
           )}
         </header>

package/app/columns/page.tsx

@@ -4,6 +4,7 @@ import { columnHref, columns } from "../lib/content";
 import { ContentEmptyState } from "../components/ContentEmptyState";
 import { siteConfig, siteDocumentTitle } from "../site.config";
 import { pageAlternates } from "../lib/page-alternates";
+import { columnStatusLabel, ui } from "../lib/i18n";
 
 export const metadata = {
   title: siteDocumentTitle,
@@ -23,6 +24,7 @@ function day(value: string) {
 }
 
 export default function ColumnsPage() {
+  const t = ui();
   const grouped = Array.from(
     columns.reduce((result, entry) => {
       const existing = result.get(entry.column ?? "");
@@ -39,19 +41,21 @@ export default function ColumnsPage() {
   return (
     <main className="sh-main" id="content">
       <div className="sh-head">
-        <h1>{siteConfig.pages.columns.title || "专栏"}</h1>
+        <h1>{siteConfig.pages.columns.title || t.homeColumns}</h1>
         {siteConfig.pages.columns.subtitle ? <p className="sh-deck">{siteConfig.pages.columns.subtitle}</p> : null}
       </div>
       {grouped.length ? grouped.map(({ slug, first, entries }) => (
-        <section className="sh-series" aria-labelledby={slug} key={slug}>
-          <div className="cover" style={{ background: "var(--well)" }}>
-            {first.columnCover ? <img className="column-feature-cover" src={first.columnCover} alt={first.columnCoverAlt ?? `${first.columnTitle} 封面`} /> : null}
-          </div>
+        <section className={first.columnCover ? "sh-series" : "sh-series no-cover"} aria-labelledby={slug} key={slug}>
+          {first.columnCover ? (
+            <div className="cover" style={{ background: "var(--well)" }}>
+              <img className="column-feature-cover" src={first.columnCover} alt={first.columnCoverAlt ?? t.columnCoverAlt(first.columnTitle)} />
+            </div>
+          ) : null}
           <div className="body">
             <h2 id={slug}>{first.columnTitle}</h2>
-            <p className="count">阅读清单，{entries.length} 篇，{first.columnStatus ?? "持续更新"}</p>
-            <p className="desc">{first.columnDescription ?? first.description ?? "按顺序组织的专题文章系列。"}</p>
-            <ol aria-label={`${first.columnTitle}，从新到旧`}>
+            <p className="count">{t.columnReadingList(entries.length, columnStatusLabel(first.columnStatus))}</p>
+            <p className="desc">{first.columnDescription ?? first.description ?? t.columnFallbackDesc}</p>
+            <ol aria-label={t.columnNewestFirst(first.columnTitle)}>
               {entries.map((entry) => (
                 <li key={entry.path}>
                   <Link href={columnHref(entry)}>{entry.title}</Link>

package/app/components/AdminUiShell.tsx

@@ -2,6 +2,7 @@ import Link from "next/link";
 import { redirect } from "next/navigation";
 import type { ReactNode } from "react";
 import { getAdminUser } from "../lib/admin-auth";
+import { ui } from "../lib/i18n";
 
 const SECTIONS = [
   { href: "/admin", label: "总览" },
@@ -23,9 +24,9 @@ export function StaticAdminNotice() {
   return (
     <main className="admin-access-page">
       <div className="admin-access-card">
-        <h1>后台在另一个地址。</h1>
-        <p>公开博客上看不到这一页。写随想和改交互，去单独部署的后台。</p>
-        <Link href="/">返回公开博客</Link>
+        <h1>{ui().staticAdminHeading}</h1>
+        <p>{ui().staticAdminBody}</p>
+        <Link href="/">{ui().staticAdminBack}</Link>
       </div>
     </main>
   );

package/app/components/ArticleMeasure.tsx

@@ -92,8 +92,11 @@ export function ArticleMeasure() {
       const articleBox = (article.querySelector(".markdown-body") ?? article).getBoundingClientRect();
       const viewport = root.clientWidth;
       let docMaxRoom: number | null = null;
-      if (docPage) {
-        const sidebar = docPage.querySelector<HTMLElement>(".gdoc-sidebar");
+      // A left rail (the doc sidebar, or a column's article list) bounds the
+      // breakout on both sides, so wide content never runs under it.
+      const columnNav = docPage ? null : document.querySelector<HTMLElement>(".series-nav");
+      if (docPage || columnNav) {
+        const sidebar = docPage ? docPage.querySelector<HTMLElement>(".gdoc-sidebar") : columnNav;
         let leftLimit = 24;
         if (sidebar && getComputedStyle(sidebar).position === "sticky") {
           const sbBox = sidebar.getBoundingClientRect();
@@ -102,7 +105,7 @@ export function ArticleMeasure() {
           }
         }
         let rightLimit = viewport - 24;
-        if (toc && getComputedStyle(toc).display !== "none") {
+        if (docPage && toc && getComputedStyle(toc).display !== "none") {
           const tocBox = toc.getBoundingClientRect();
           if (tocBox.width > 0 && tocBox.left >= articleBox.right - 1) {
             rightLimit = tocBox.left - translatedX(toc) - 16;

package/app/components/ArticleReferences.tsx

@@ -1,4 +1,5 @@
 import { referenceColumns, referenceDomain } from "../../ui/garden/references.mjs";
+import { ui, type UiLang } from "../lib/i18n";
 
 type ReferenceItem = {
   title: string;
@@ -8,8 +9,10 @@ type ReferenceItem = {
 
 export function ArticleReferences({
   references,
+  lang,
 }: {
   references?: ReferenceItem[];
+  lang?: UiLang;
 }) {
   if (!references?.length) return null;
   const split = referenceColumns(references.length) === 2;
@@ -19,7 +22,7 @@ export function ArticleReferences({
       className={split ? "article-references is-split" : "article-references"}
       aria-labelledby="article-references-heading"
     >
-      <h2 id="article-references-heading">参考</h2>
+      <h2 id="article-references-heading">{ui(lang).referencesHeading}</h2>
       <ol>
         {references.map((item, index) => {
           const domain = item.domain ?? referenceDomain(item.url);

package/app/components/ArticleTags.tsx

@@ -1,13 +1,14 @@
 import Link from "next/link";
 import { articleTagHref } from "../lib/tag-filter";
 import { siteHref } from "../lib/site-href";
+import { ui, type UiLang } from "../lib/i18n";
 
 /** Tags under an article title. Link, so following one is a client navigation like the rest of the site. */
-export function ArticleTags({ tags }: { tags?: string[] }) {
+export function ArticleTags({ tags, lang }: { tags?: string[]; lang?: UiLang }) {
   const list = (tags ?? []).filter(Boolean);
   if (!list.length) return null;
   return (
-    <ul className="article-tagrow" aria-label="标签">
+    <ul className="article-tagrow" aria-label={ui(lang).articleTagsLabel}>
       {list.map((tag) => (
         <li key={tag}>
           <Link className="tag-chip p-category" href={siteHref(articleTagHref(tag))}>