feat: 站点单页、时间线导入与行级 BBCode 短代码

首页右栏接入单页入口与公告置顶/全部页；Markdown 编辑器支持可视化时间线与 Git 导入；隐藏块改为 [hide]/[timeline] 命名闭合，并修复单页/公告 GORM 更新只改 updated_at 的问题。

Co-authored-by: Cursor <cursoragent@cursor.com>

frontend/app/admin/pages/PageComposeClient.tsx

@@ -0,0 +1,263 @@
+"use client";
+
+import { useRef, useState } from "react";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { ArrowLeft, Loader2, Save } from "lucide-react";
+import {
+  apiAdminCreateSitePage,
+  apiAdminUpdateSitePage,
+  type SitePage,
+  type SitePageInput,
+} from "@/lib/api";
+import { toast } from "@/lib/toast";
+import MarkdownEditor from "@/components/MarkdownEditor";
+import { AdminSegmented, AdminSwitch } from "@/components/admin";
+
+type PublishKey = "published" | "draft";
+
+type FormState = {
+  slug: string;
+  title: string;
+  content: string;
+  excerpt: string;
+  published: boolean;
+  show_in_sidebar: boolean;
+  sort_order: number;
+};
+
+function toForm(p?: SitePage | null): FormState {
+  return {
+    slug: p?.slug ?? "",
+    title: p?.title ?? "",
+    content: p?.content ?? "",
+    excerpt: p?.excerpt ?? "",
+    published: p?.published ?? true,
+    show_in_sidebar: p?.show_in_sidebar ?? false,
+    sort_order: p?.sort_order ?? 0,
+  };
+}
+
+/** slug 仅允许小写字母数字与连字符 */
+function normalizeSlug(raw: string): string {
+  return raw
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+export default function PageComposeClient({
+  mode,
+  initial,
+}: {
+  mode: "create" | "edit";
+  initial?: SitePage | null;
+}) {
+  const router = useRouter();
+  const [form, setForm] = useState<FormState>(() => toForm(initial));
+  const formRef = useRef(form);
+  const [saving, setSaving] = useState(false);
+  const isEdit = mode === "edit" && initial != null;
+
+  const patchForm = (patch: Partial<FormState> | ((prev: FormState) => FormState)) => {
+    setForm((prev) => {
+      const next = typeof patch === "function" ? patch(prev) : { ...prev, ...patch };
+      formRef.current = next;
+      return next;
+    });
+  };
+
+  async function save() {
+    if (saving) return;
+    const current = formRef.current;
+    const slug = normalizeSlug(current.slug);
+    const payload: SitePageInput = {
+      slug,
+      title: current.title.trim(),
+      content: current.content.trim(),
+      excerpt: current.excerpt.trim(),
+      published: current.published,
+      show_in_sidebar: current.show_in_sidebar,
+      sort_order: current.sort_order,
+    };
+    if (!payload.slug || !payload.title || !payload.content) {
+      toast("slug、标题和内容不能为空");
+      return;
+    }
+    setSaving(true);
+    try {
+      if (isEdit) {
+        await apiAdminUpdateSitePage(initial.id, payload);
+        toast("页面已更新", "ok");
+      } else {
+        await apiAdminCreateSitePage(payload);
+        toast(payload.published ? "页面已发布" : "草稿已保存", "ok");
+      }
+      router.push("/admin/pages");
+      router.refresh();
+    } catch (e) {
+      toast(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  return (
+    <div className="j13-compose-page w-full">
+      <div className="j13-compose-stage">
+        <header className="j13-compose-toolbar">
+          <h1 className="j13-compose-toolbar-title">{isEdit ? "编辑单页" : "新建单页"}</h1>
+          <div className="j13-compose-toolbar-actions">
+            <Link href="/admin/pages" className="btn btn-line btn-sm">
+              <ArrowLeft size={14} /> 返回列表
+            </Link>
+            <button
+              type="button"
+              className="btn btn-primary btn-sm min-w-[4.5rem]"
+              disabled={saving}
+              onClick={() => void save()}
+            >
+              {saving ? <Loader2 size={14} className="animate-spin" /> : <Save size={14} />}
+              保存
+            </button>
+          </div>
+        </header>
+
+        <div className="j13-compose-body">
+          <section className="j13-compose-section" aria-label="页面设置">
+            <h2 className="j13-compose-section-title">页面设置</h2>
+            <div className="j13-compose-typepanel space-y-4">
+              <div>
+                <label className="field-label" htmlFor="page-slug">
+                  URL slug
+                </label>
+                <div className="flex items-center gap-1.5">
+                  <span className="meta text-[13px]">/p/</span>
+                  <input
+                    id="page-slug"
+                    className="j13-compose-field flex-1 font-mono text-[13px]"
+                    maxLength={64}
+                    value={form.slug}
+                    onChange={(e) => patchForm({ slug: e.target.value })}
+                    onBlur={() =>
+                      patchForm((f) => ({ ...f, slug: normalizeSlug(f.slug) }))
+                    }
+                    placeholder="about"
+                  />
+                </div>
+              </div>
+
+              <div>
+                <label className="field-label" htmlFor="page-excerpt">
+                  摘要（侧栏展示）
+                </label>
+                <textarea
+                  id="page-excerpt"
+                  className="j13-compose-field w-full"
+                  rows={3}
+                  maxLength={300}
+                  value={form.excerpt}
+                  onChange={(e) => patchForm({ excerpt: e.target.value })}
+                  placeholder="一句话介绍本页…"
+                />
+              </div>
+
+              <div>
+                <label className="field-label" htmlFor="page-sort">
+                  排序（越小越靠前）
+                </label>
+                <input
+                  id="page-sort"
+                  type="number"
+                  className="j13-compose-field w-28"
+                  value={form.sort_order}
+                  onChange={(e) =>
+                    patchForm({ sort_order: parseInt(e.target.value, 10) || 0 })
+                  }
+                />
+              </div>
+
+              <div>
+                <p className="field-label">发布状态</p>
+                <AdminSegmented<PublishKey>
+                  role="group"
+                  ariaLabel="发布状态"
+                  value={form.published ? "published" : "draft"}
+                  onChange={(key) => patchForm({ published: key === "published" })}
+                  options={[
+                    { key: "published", label: "立即发布" },
+                    { key: "draft", label: "存为草稿" },
+                  ]}
+                />
+              </div>
+
+              <div className="flex items-center justify-between gap-3 flex-wrap">
+                <div>
+                  <p className="text-[14px] font-medium" style={{ color: "var(--ink)" }}>
+                    显示在首页侧栏
+                  </p>
+                  <p className="meta text-[12px] mt-0.5">开启后出现在「关于本站」模块</p>
+                </div>
+                <AdminSwitch
+                  checked={form.show_in_sidebar}
+                  onChange={() =>
+                    patchForm((f) => ({ ...f, show_in_sidebar: !f.show_in_sidebar }))
+                  }
+                  label="显示在首页侧栏"
+                />
+              </div>
+            </div>
+          </section>
+
+          <section className="j13-compose-section j13-compose-section-writing" aria-label="标题与正文">
+            <h2 className="j13-compose-section-title">标题与正文</h2>
+            <input
+              className="j13-compose-title"
+              maxLength={200}
+              value={form.title}
+              onChange={(e) => patchForm({ title: e.target.value })}
+              placeholder="页面标题"
+              aria-label="页面标题"
+            />
+            <div className="j13-compose-canvas">
+              <MarkdownEditor
+                value={form.content}
+                onChange={(content) => patchForm({ content })}
+                allowHide={false}
+                placeholder="请输入页面正文，支持 Markdown…"
+                rows={18}
+                onSubmitShortcut={() => void save()}
+              />
+            </div>
+          </section>
+        </div>
+
+        <div className="j13-compose-actions">
+          <div className="j13-compose-actions-end">
+            <Link href="/admin/pages" className="btn btn-line">
+              取消
+            </Link>
+            <button
+              type="button"
+              className="btn btn-primary"
+              disabled={saving}
+              onClick={() => void save()}
+            >
+              {saving ? (
+                <>
+                  <Loader2 size={15} className="animate-spin" /> 保存中…
+                </>
+              ) : (
+                <>
+                  <Save size={15} /> {isEdit ? "保存修改" : form.published ? "发布页面" : "保存草稿"}
+                </>
+              )}
+            </button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

frontend/app/admin/pages/PagesAdmin.tsx

@@ -0,0 +1,205 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import Link from "next/link";
+import {
+  Plus,
+  Pencil,
+  Trash2,
+  Loader2,
+  ExternalLink,
+  FileText,
+} from "lucide-react";
+import {
+  apiAdminDeleteSitePage,
+  type SitePage,
+} from "@/lib/api";
+import { formatRelative } from "@/lib/format";
+import { toast } from "@/lib/toast";
+import ConfirmDialog from "@/components/ConfirmDialog";
+import {
+  AdminEmpty,
+  AdminIconButton,
+  AdminPageHeader,
+  AdminSegmented,
+  AdminStatusChip,
+} from "@/components/admin";
+
+type StatusFilter = "all" | "published" | "draft";
+
+export default function PagesAdmin({
+  initial,
+  initError,
+}: {
+  initial: SitePage[];
+  initError: string;
+}) {
+  const [list, setList] = useState(initial);
+  const [loadError, setLoadError] = useState(initError);
+  const [statusFilter, setStatusFilter] = useState<StatusFilter>("all");
+  const [deletingId, setDeletingId] = useState<number | null>(null);
+  const [deleteTarget, setDeleteTarget] = useState<SitePage | null>(null);
+
+  const publishedCount = useMemo(() => list.filter((p) => p.published).length, [list]);
+  const draftCount = useMemo(() => list.filter((p) => !p.published).length, [list]);
+
+  const filtered = useMemo(() => {
+    if (statusFilter === "published") return list.filter((p) => p.published);
+    if (statusFilter === "draft") return list.filter((p) => !p.published);
+    return list;
+  }, [list, statusFilter]);
+
+  async function remove(p: SitePage) {
+    setDeletingId(p.id);
+    try {
+      await apiAdminDeleteSitePage(p.id);
+      setList((l) => l.filter((x) => x.id !== p.id));
+      toast("页面已删除", "ok");
+    } catch (e) {
+      toast(e instanceof Error ? e.message : "删除失败");
+    } finally {
+      setDeletingId(null);
+      setDeleteTarget(null);
+    }
+  }
+
+  return (
+    <div>
+      <AdminPageHeader
+        icon={FileText}
+        title="单页管理"
+        description="关于本站、隐私政策等自定义 Markdown 单页；可展示在首页右栏"
+        actions={
+          <Link href="/admin/pages/new" className="btn btn-primary">
+            <Plus size={15} /> 新建单页
+          </Link>
+        }
+      />
+
+      <div className="mb-4">
+        <AdminSegmented<StatusFilter>
+          ariaLabel="单页状态筛选"
+          size="sm"
+          value={statusFilter}
+          onChange={setStatusFilter}
+          options={[
+            { key: "all", label: "全部", count: list.length },
+            { key: "published", label: "已发布", count: publishedCount },
+            { key: "draft", label: "草稿", count: draftCount },
+          ]}
+        />
+      </div>
+
+      <div className="panel overflow-hidden min-w-0">
+        <div
+          className="px-4 sm:px-5 py-3 flex items-center justify-between"
+          style={{ borderBottom: "1px solid var(--line)" }}
+        >
+          <span className="font-medium text-[14px]" style={{ color: "var(--ink)" }}>
+            单页列表
+          </span>
+          <span className="meta text-[12px] tabular-nums">共 {filtered.length} 条</span>
+        </div>
+
+        {loadError ? (
+          <p className="alert-error m-4">{loadError}</p>
+        ) : filtered.length === 0 ? (
+          <AdminEmpty
+            icon={<FileText size={22} />}
+            title={list.length === 0 ? "还没有单页" : "该状态下暂无单页"}
+            description={list.length === 0 ? "创建关于本站等内容页" : "试试切换筛选条件"}
+          />
+        ) : (
+          filtered.map((p, idx) => (
+            <div
+              key={p.id}
+              className="px-4 sm:px-5 py-3.5"
+              style={{
+                borderTop: idx === 0 ? undefined : "1px solid var(--line)",
+              }}
+            >
+              <div className="flex items-start gap-3 min-w-0">
+                <div className="min-w-0 flex-1">
+                  <div className="flex items-center gap-1.5 flex-wrap">
+                    <p
+                      className="text-[14px] font-medium truncate max-w-full"
+                      style={{ color: "var(--ink)" }}
+                      data-tip={p.title}
+                    >
+                      {p.title}
+                    </p>
+                    <code className="meta text-[11.5px] tabular-nums">/{p.slug}</code>
+                    <AdminStatusChip tone={p.published ? "ok" : "warn"}>
+                      {p.published ? "已发布" : "草稿"}
+                    </AdminStatusChip>
+                    {p.show_in_sidebar ? (
+                      <AdminStatusChip tone="accent">侧栏</AdminStatusChip>
+                    ) : null}
+                    <span className="meta text-[11px] tabular-nums shrink-0">
+                      排序 {p.sort_order} · {formatRelative(p.updated_at || p.created_at)}
+                    </span>
+                  </div>
+                  {p.excerpt ? (
+                    <p className="meta text-[12.5px] mt-1 line-clamp-1">{p.excerpt}</p>
+                  ) : null}
+                </div>
+                <span className="inline-flex items-center gap-0.5 shrink-0">
+                  {p.published ? (
+                    <AdminIconButton
+                      href={`/p/${p.slug}`}
+                      tip="查看前台"
+                      ariaLabel="查看单页"
+                    >
+                      <ExternalLink size={14} />
+                    </AdminIconButton>
+                  ) : null}
+                  <AdminIconButton
+                    href={`/admin/pages/${p.id}/edit`}
+                    tip="编辑"
+                    ariaLabel="编辑单页"
+                  >
+                    <Pencil size={14} />
+                  </AdminIconButton>
+                  <AdminIconButton
+                    tip="删除"
+                    ariaLabel="删除单页"
+                    tone="danger"
+                    disabled={deletingId === p.id}
+                    onClick={() => setDeleteTarget(p)}
+                  >
+                    {deletingId === p.id ? (
+                      <Loader2 size={14} className="animate-spin" />
+                    ) : (
+                      <Trash2 size={14} />
+                    )}
+                  </AdminIconButton>
+                </span>
+              </div>
+            </div>
+          ))
+        )}
+
+        {list.length === 0 && !loadError ? (
+          <div className="px-4 sm:px-5 pb-5 -mt-2 flex justify-center">
+            <Link href="/admin/pages/new" className="btn btn-primary">
+              <Plus size={15} /> 新建第一页
+            </Link>
+          </div>
+        ) : null}
+      </div>
+
+      <ConfirmDialog
+        open={!!deleteTarget}
+        title="删除单页"
+        message={deleteTarget ? `确定删除「${deleteTarget.title}」吗？此操作不可撤销。` : ""}
+        danger
+        busy={deletingId != null}
+        confirmLabel="删除"
+        onCancel={() => deletingId == null && setDeleteTarget(null)}
+        onConfirm={() => {
+          if (deleteTarget) void remove(deleteTarget);
+        }}
+      />
+    </div>
+  );
+}

frontend/app/admin/pages/[id]/edit/PageEditLoader.tsx

@@ -0,0 +1,54 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { Loader2 } from "lucide-react";
+import { apiAdminListSitePages, type SitePage } from "@/lib/api";
+import PageComposeClient from "../../PageComposeClient";
+
+/** 无详情 API：从管理列表按 id 拉取后进入编辑器 */
+export default function PageEditLoader({ id }: { id: number }) {
+  const [item, setItem] = useState<SitePage | null>(null);
+  const [error, setError] = useState("");
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    let alive = true;
+    setLoading(true);
+    apiAdminListSitePages()
+      .then((res) => {
+        if (!alive) return;
+        const found = res.pages.find((p) => p.id === id) ?? null;
+        if (!found) {
+          setError("页面不存在或已删除");
+          setItem(null);
+        } else {
+          setItem(found);
+          setError("");
+        }
+      })
+      .catch((e) => {
+        if (!alive) return;
+        setError(e instanceof Error ? e.message : "加载失败");
+      })
+      .finally(() => {
+        if (alive) setLoading(false);
+      });
+    return () => {
+      alive = false;
+    };
+  }, [id]);
+
+  if (loading) {
+    return (
+      <div className="panel p-10 flex items-center justify-center gap-2 meta">
+        <Loader2 size={18} className="animate-spin" /> 加载页面…
+      </div>
+    );
+  }
+
+  if (error || !item) {
+    return <p className="alert-error">{error || "页面不存在"}</p>;
+  }
+
+  return <PageComposeClient mode="edit" initial={item} />;
+}

frontend/app/admin/pages/[id]/edit/page.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from "next";
+import { cookies } from "next/headers";
+import { authCookieHeader } from "@/lib/cookies";
+import { getMeCached } from "@/lib/serverData";
+import { isAdminOrAbove } from "@/lib/roles";
+import Forbidden from "../../../Forbidden";
+import PageEditLoader from "./PageEditLoader";
+
+export const metadata: Metadata = {
+  title: "编辑单页",
+};
+
+interface PageProps {
+  params: Promise<{ id: string }>;
+}
+
+export default async function AdminPageEditPage({ params }: PageProps) {
+  const { id } = await params;
+  const cookie = authCookieHeader(await cookies());
+  const me = await getMeCached(cookie || undefined);
+  if (!me.user || !isAdminOrAbove(me.user.role)) {
+    return <Forbidden text="单页管理仅管理员及以上角色可操作。" />;
+  }
+
+  const numId = parseInt(id, 10);
+  if (!Number.isFinite(numId) || numId <= 0) {
+    return <Forbidden text="无效的页面 ID。" />;
+  }
+
+  return <PageEditLoader id={numId} />;
+}

frontend/app/admin/pages/new/page.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+import { cookies } from "next/headers";
+import { authCookieHeader } from "@/lib/cookies";
+import { getMeCached } from "@/lib/serverData";
+import { isAdminOrAbove } from "@/lib/roles";
+import Forbidden from "../../Forbidden";
+import PageComposeClient from "../PageComposeClient";
+
+export const metadata: Metadata = {
+  title: "新建单页",
+};
+
+export default async function AdminPageNewPage() {
+  const cookie = authCookieHeader(await cookies());
+  const me = await getMeCached(cookie || undefined);
+  if (!me.user || !isAdminOrAbove(me.user.role)) {
+    return <Forbidden text="单页管理仅管理员及以上角色可操作。" />;
+  }
+
+  return <PageComposeClient mode="create" />;
+}

frontend/app/admin/pages/page.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from "next";
+import { cookies } from "next/headers";
+import PagesAdmin from "./PagesAdmin";
+import { authCookieHeader } from "@/lib/cookies";
+import { fetchAdminSitePages, type SitePage } from "@/lib/api";
+import { getMeCached } from "@/lib/serverData";
+import { isAdminOrAbove } from "@/lib/roles";
+import Forbidden from "../Forbidden";
+
+export const metadata: Metadata = {
+  title: "单页管理",
+};
+
+export default async function AdminPagesPage() {
+  const cookie = authCookieHeader(await cookies());
+  const me = await getMeCached(cookie || undefined);
+  if (!me.user || !isAdminOrAbove(me.user.role)) {
+    return <Forbidden text="单页管理仅管理员及以上角色可操作。" />;
+  }
+
+  let initial: SitePage[] = [];
+  let initError = "";
+  try {
+    const res = await fetchAdminSitePages(cookie || undefined);
+    initial = res.pages ?? [];
+  } catch (e) {
+    initError = e instanceof Error ? e.message : "加载单页失败";
+  }
+
+  return <PagesAdmin initial={initial} initError={initError} />;
+}