后台单页和公告改为正文优先编辑，保存与发布分开。

列表按列对照真实路径和状态，避免把 /p/ 前缀和发布操作混在一起。

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

frontend/app/admin/announcements/AnnouncementAdmin.tsx

@@ -1,38 +1,48 @@
 "use client";
 
-import { useCallback, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import Link from "next/link";
+import { useRouter, useSearchParams } from "next/navigation";
+import { Ellipsis, ExternalLink, Loader2, Megaphone, Plus } from "lucide-react";
 import {
-  Plus,
-  Pencil,
-  Trash2,
-  Loader2,
-  ExternalLink,
-  Megaphone,
-  Pin,
-} from "lucide-react";
-import {
-  apiAdminListAnnouncements,
   apiAdminDeleteAnnouncement,
+  apiAdminListAnnouncements,
   apiAdminToggleAnnouncementPin,
   type Announcement,
 } from "@/lib/api";
-import { formatRelative } from "@/lib/format";
+import { formatDateTime, formatRelative } from "@/lib/format";
 import { toast } from "@/lib/toast";
 import ConfirmDialog from "@/components/ConfirmDialog";
 import {
   AdminEmpty,
-  AdminIconButton,
   AdminPageHeader,
   AdminSegmented,
-  AdminSettingsPage,
   AdminStatusChip,
 } from "@/components/admin";
+import { announcementPublicPath } from "./announcementColors";
 
 type StatusFilter = "all" | "published" | "draft";
 
-/** 粗略去掉 Markdown，取一行摘要 */
-function plainSummary(md: string, max = 96): string {
+function readStatus(raw: string | null): StatusFilter {
+  if (raw === "published" || raw === "draft") return raw;
+  return "all";
+}
+
+function listHref(status: StatusFilter): string {
+  return status === "all" ? "/admin/announcements" : `/admin/announcements?status=${status}`;
+}
+
+function newHref(status: StatusFilter): string {
+  return status === "all" ? "/admin/announcements/new" : `/admin/announcements/new?status=${status}`;
+}
+
+function editHref(id: number, status: StatusFilter): string {
+  const base = `/admin/announcements/${id}/edit`;
+  return status === "all" ? base : `${base}?status=${status}`;
+}
+
+/** 粗略去掉 Markdown，取一行摘要。只用于列表预览，不改库存正文。 */
+function plainSummary(md: string, max = 80): string {
   const text = md
     .replace(/```[\s\S]*?```/g, " ")
     .replace(/!\[[^\]]*\]\([^)]+\)/g, " ")
@@ -50,12 +60,17 @@ export default function AnnouncementAdmin({
   initial: Announcement[];
   initError: string;
 }) {
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const statusFilter = readStatus(searchParams.get("status"));
   const [list, setList] = useState(initial);
   const [loadError, setLoadError] = useState(initError);
-  const [statusFilter, setStatusFilter] = useState<StatusFilter>("all");
   const [pinningId, setPinningId] = useState<number | null>(null);
   const [deletingId, setDeletingId] = useState<number | null>(null);
   const [deleteTarget, setDeleteTarget] = useState<Announcement | null>(null);
+  const [menuId, setMenuId] = useState<number | null>(null);
+  const [menuUp, setMenuUp] = useState(false);
+  const menuRef = useRef<HTMLDivElement>(null);
 
   const publishedCount = useMemo(() => list.filter((a) => a.published).length, [list]);
   const draftCount = useMemo(() => list.filter((a) => !a.published).length, [list]);
@@ -76,14 +91,32 @@ export default function AnnouncementAdmin({
     }
   }, []);
 
+  useEffect(() => {
+    if (menuId == null) return;
+    const onPointer = (e: MouseEvent) => {
+      if (menuRef.current && !menuRef.current.contains(e.target as Node)) setMenuId(null);
+    };
+    const onKey = (e: KeyboardEvent) => {
+      if (e.key === "Escape") setMenuId(null);
+    };
+    document.addEventListener("mousedown", onPointer);
+    document.addEventListener("keydown", onKey);
+    return () => {
+      document.removeEventListener("mousedown", onPointer);
+      document.removeEventListener("keydown", onKey);
+    };
+  }, [menuId]);
+
+  function setStatus(next: StatusFilter) {
+    router.replace(listHref(next), { scroll: false });
+  }
+
   async function togglePin(a: Announcement) {
     if (pinningId != null) return;
     setPinningId(a.id);
     try {
-      const res = await apiAdminToggleAnnouncementPin(a.id);
-      setList((prev) => prev.map((x) => (x.id === a.id ? res.announcement : x)));
-      toast(res.announcement.pinned ? "已置顶" : "已取消置顶", "ok");
-      // 置顶后列表顺序可能变化，重新拉一次对齐后端排序
+      await apiAdminToggleAnnouncementPin(a.id);
+      toast(a.pinned ? "已取消置顶" : "已置顶", "ok");
       await load();
     } catch (e) {
       toast(e instanceof Error ? e.message : "置顶失败");
@@ -103,17 +136,18 @@ export default function AnnouncementAdmin({
     } finally {
       setDeletingId(null);
       setDeleteTarget(null);
+      setMenuId(null);
     }
   }
 
   return (
-    <AdminSettingsPage>
+    <div className="admin-doc-page admin-doc-list">
       <AdminPageHeader
         icon={Megaphone}
         title="站点公告管理"
-        description="发布、编辑与下线右栏站点公告，支持置顶与自定义标签色"
+        description="已发布的公告出现在首页右栏，置顶的排在前面。"
         actions={
-          <Link href="/admin/announcements/new" className="btn btn-primary">
+          <Link href={newHref(statusFilter)} className="btn btn-primary">
             <Plus size={15} /> 新建公告
           </Link>
         }
@@ -124,7 +158,7 @@ export default function AnnouncementAdmin({
           ariaLabel="公告状态筛选"
           size="sm"
           value={statusFilter}
-          onChange={setStatusFilter}
+          onChange={setStatus}
           options={[
             { key: "all", label: "全部", count: list.length },
             { key: "published", label: "已发布", count: publishedCount },
@@ -133,7 +167,7 @@ export default function AnnouncementAdmin({
         />
       </div>
 
-      <div className="panel overflow-hidden min-w-0">
+      <div className="panel min-w-0">
         <div
           className="px-4 sm:px-5 py-3 flex items-center justify-between"
           style={{ borderBottom: "1px solid var(--line)" }}
@@ -155,108 +189,141 @@ export default function AnnouncementAdmin({
             }
           />
         ) : (
-          filtered.map((a, idx) => {
-            const summary = plainSummary(a.content);
-            return (
-              <div
-                key={a.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">
-                  <span
-                    className={`j13-anno-dot is-${a.tag_color} mt-1.5 shrink-0`}
-                    aria-hidden
-                    data-tip={a.tag}
-                  />
-                  <div className="min-w-0 flex-1">
-                    <div className="flex items-center gap-1.5 flex-wrap">
-                      {a.pinned ? (
-                        <span className="badge-pin shrink-0">置顶</span>
-                      ) : null}
-                      <p
-                        className="text-[14px] font-medium truncate max-w-full"
-                        style={{ color: "var(--ink)" }}
-                        data-tip={a.title}
-                      >
-                        {a.title}
-                      </p>
-                      <span className={`j13-anno-tag is-${a.tag_color}`}>{a.tag}</span>
-                      <AdminStatusChip tone={a.published ? "ok" : "warn"}>
-                        {a.published ? "已发布" : "草稿"}
-                      </AdminStatusChip>
-                      <span className="meta text-[11px] tabular-nums shrink-0">
-                        {formatRelative(a.updated_at || a.created_at)}
-                      </span>
-                    </div>
-                    {summary ? (
-                      <p className="meta text-[12.5px] mt-1 line-clamp-1">{summary}</p>
-                    ) : null}
-                  </div>
-                  <span className="inline-flex items-center gap-0.5 shrink-0">
-                    <AdminIconButton
-                      tip={a.pinned ? "取消置顶" : "置顶"}
-                      ariaLabel={a.pinned ? "取消置顶" : "置顶公告"}
-                      disabled={pinningId === a.id}
-                      onClick={() => void togglePin(a)}
-                    >
-                      {pinningId === a.id ? (
-                        <Loader2 size={14} className="animate-spin" />
-                      ) : (
-                        <Pin size={14} style={{ color: a.pinned ? "var(--accent)" : undefined }} />
-                      )}
-                    </AdminIconButton>
-                    {a.published ? (
-                      <AdminIconButton
-                        href={`/announcement/${a.id}`}
-                        tip="查看前台"
-                        ariaLabel="查看公告"
-                      >
-                        <ExternalLink size={14} />
-                      </AdminIconButton>
-                    ) : null}
-                    <AdminIconButton
-                      href={`/admin/announcements/${a.id}/edit`}
-                      tip="编辑"
-                      ariaLabel="编辑公告"
-                    >
-                      <Pencil size={14} />
-                    </AdminIconButton>
-                    <AdminIconButton
-                      tip="删除"
-                      ariaLabel="删除公告"
-                      tone="danger"
-                      disabled={deletingId === a.id}
-                      onClick={() => setDeleteTarget(a)}
-                    >
-                      {deletingId === a.id ? (
-                        <Loader2 size={14} className="animate-spin" />
-                      ) : (
-                        <Trash2 size={14} />
-                      )}
-                    </AdminIconButton>
-                  </span>
-                </div>
-              </div>
-            );
-          })
+          <div className="admin-doc-table-wrap">
+            <table className="admin-doc-table">
+              <caption className="sr-only">公告列表</caption>
+              <thead>
+                <tr>
+                  <th scope="col">公告</th>
+                  <th scope="col">状态</th>
+                  <th scope="col">置顶</th>
+                  <th scope="col">最近更新</th>
+                  <th scope="col">操作</th>
+                </tr>
+              </thead>
+              <tbody>
+                {filtered.map((a) => {
+                  const summary = plainSummary(a.content);
+                  const updated = a.updated_at || "";
+                  return (
+                    <tr key={a.id}>
+                      <td data-label="公告">
+                        <Link href={editHref(a.id, statusFilter)} className="admin-doc-title" title={a.title}>
+                          {a.title}
+                        </Link>
+                        <p className="admin-doc-path">
+                          <span className={`j13-anno-tag is-${a.tag_color}`} title={a.tag}>
+                            {a.tag}
+                          </span>
+                          {a.published ? <code>{announcementPublicPath(a.id)}</code> : null}
+                        </p>
+                        {summary ? <p className="admin-doc-excerpt" title={summary}>{summary}</p> : null}
+                      </td>
+                      <td data-label="状态">
+                        <AdminStatusChip tone={a.published ? "ok" : "warn"}>
+                          {a.published ? "已发布" : "草稿"}
+                        </AdminStatusChip>
+                      </td>
+                      <td data-label="置顶">{a.pinned ? "置顶" : "未置顶"}</td>
+                      <td data-label="最近更新">
+                        {updated ? (
+                          <time dateTime={updated} title={formatDateTime(updated)}>
+                            {formatRelative(updated)}
+                          </time>
+                        ) : (
+                          "—"
+                        )}
+                      </td>
+                      <td data-label="操作">
+                        <div className="admin-doc-row-actions">
+                          <Link href={editHref(a.id, statusFilter)} className="admin-doc-textbtn">
+                            编辑
+                          </Link>
+                          {a.published ? (
+                            <a
+                              href={announcementPublicPath(a.id)}
+                              target="_blank"
+                              rel="noopener noreferrer"
+                              className="admin-doc-textbtn"
+                            >
+                              <ExternalLink size={14} aria-hidden />
+                              查看
+                            </a>
+                          ) : null}
+                          <button
+                            type="button"
+                            className="admin-doc-textbtn"
+                            disabled={pinningId === a.id}
+                            onClick={() => void togglePin(a)}
+                          >
+                            {pinningId === a.id ? (
+                              <Loader2 size={14} className="animate-spin" aria-hidden />
+                            ) : null}
+                            {a.pinned ? "取消置顶" : "置顶"}
+                          </button>
+                          <div className="admin-doc-more" ref={menuId === a.id ? menuRef : undefined}>
+                            <button
+                              type="button"
+                              className="admin-doc-textbtn"
+                              aria-haspopup="menu"
+                              aria-expanded={menuId === a.id}
+                              aria-label={`「${a.title}」的更多操作`}
+                              onClick={(e) => {
+                                const rect = e.currentTarget.getBoundingClientRect();
+                                setMenuUp(rect.bottom > window.innerHeight - 140);
+                                setMenuId((cur) => (cur === a.id ? null : a.id));
+                              }}
+                            >
+                              <Ellipsis size={16} aria-hidden />
+                              更多
+                            </button>
+                            {menuId === a.id ? (
+                              <div className={`admin-doc-menu${menuUp ? " is-up" : ""}`} role="menu">
+                                <button
+                                  type="button"
+                                  role="menuitem"
+                                  className="admin-doc-menu-item is-danger"
+                                  disabled={deletingId === a.id}
+                                  onClick={() => {
+                                    setMenuId(null);
+                                    setDeleteTarget(a);
+                                  }}
+                                >
+                                  删除
+                                </button>
+                              </div>
+                            ) : null}
+                          </div>
+                        </div>
+                      </td>
+                    </tr>
+                  );
+                })}
+              </tbody>
+            </table>
+          </div>
         )}
 
         {list.length === 0 && !loadError ? (
           <div className="px-4 sm:px-5 pb-5 -mt-2 flex justify-center">
-            <Link href="/admin/announcements/new" className="btn btn-primary">
+            <Link href={newHref(statusFilter)} className="btn btn-primary">
               <Plus size={15} /> 新建第一条公告
             </Link>
           </div>
         ) : null}
+        {list.length >= 100 ? (
+          <p className="meta text-[12px] px-4 sm:px-5 py-3">后台一次最多列出 100 条。</p>
+        ) : null}
       </div>
 
       <ConfirmDialog
         open={!!deleteTarget}
         title="删除公告"
-        message={deleteTarget ? `确定删除公告「${deleteTarget.title}」吗？此操作不可撤销。` : ""}
+        message={
+          deleteTarget
+            ? `确定删除「${deleteTarget.title}」吗？当前为${deleteTarget.published ? "已发布" : "草稿"}。删除后前台不再显示，后台也不能恢复。`
+            : ""
+        }
         danger
         busy={deletingId != null}
         confirmLabel="删除"
@@ -265,6 +332,6 @@ export default function AnnouncementAdmin({
           if (deleteTarget) void remove(deleteTarget);
         }}
       />
-    </AdminSettingsPage>
+    </div>
   );
 }

frontend/app/admin/announcements/AnnouncementComposeClient.tsx

@@ -1,9 +1,9 @@
 "use client";
 
-import { useMemo, useRef, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { ArrowLeft, Megaphone } from "lucide-react";
+import { useRouter, useSearchParams } from "next/navigation";
+import { ArrowLeft, Copy, ExternalLink, Loader2 } from "lucide-react";
 import {
   apiAdminCreateAnnouncement,
   apiAdminUpdateAnnouncement,
@@ -13,21 +13,13 @@ import {
 } from "@/lib/api";
 import { toast } from "@/lib/toast";
 import MarkdownEditor from "@/components/MarkdownEditor";
-import {
-  AdminField,
-  AdminPageHeader,
-  AdminSegmented,
-  AdminSettingsActions,
-  AdminSettingsGroup,
-  AdminSettingsPage,
-  AdminSettingsRow,
-  AdminSwitch,
-} from "@/components/admin";
+import { AdminField, AdminSegmented, AdminStatusChip, AdminSwitch } from "@/components/admin";
 import ConfirmDialog from "@/components/ConfirmDialog";
 import useUnsavedGuard from "@/hooks/useUnsavedGuard";
-import { ANNOUNCEMENT_COLORS } from "./announcementColors";
+import { ANNOUNCEMENT_COLORS, announcementPublicPath } from "./announcementColors";
 
 type PublishKey = "published" | "draft";
+type StatusFilter = "all" | "published" | "draft";
 
 type FormState = {
   title: string;
@@ -38,6 +30,14 @@ type FormState = {
   pinned: boolean;
 };
 
+type FieldErrors = {
+  title?: string;
+  content?: string;
+  tag?: string;
+  tag_color?: string;
+  form?: string;
+};
+
 function toForm(a?: Announcement | null): FormState {
   return {
     title: a?.title ?? "",
@@ -60,6 +60,51 @@ function sameForm(a: FormState, b: FormState): boolean {
   );
 }
 
+function runeCount(s: string): number {
+  return Array.from(s).length;
+}
+
+function validate(form: FormState): FieldErrors {
+  const errors: FieldErrors = {};
+  const title = form.title.trim();
+  if (!title) errors.title = "标题不能为空";
+  else if (runeCount(title) > 200) errors.title = "标题不能超过 200 字";
+
+  if (!form.content.trim()) errors.content = "内容不能为空";
+
+  const tag = form.tag.trim();
+  if (tag && runeCount(tag) > 32) errors.tag = "标签不能超过 32 字";
+  return errors;
+}
+
+function errorsFromServer(msg: string): FieldErrors {
+  if (msg.includes("标题")) return { title: msg };
+  if (msg.includes("颜色")) return { tag_color: msg };
+  if (msg.includes("标签")) return { tag: msg };
+  if (msg.includes("内容") || msg.includes("隐藏") || msg.includes("回复")) return { content: msg };
+  return { form: msg };
+}
+
+function hasErrors(errors: FieldErrors): boolean {
+  return Object.values(errors).some(Boolean);
+}
+
+function readStatus(raw: string | null): StatusFilter {
+  if (raw === "published" || raw === "draft") return raw;
+  return "all";
+}
+
+function listHref(status: StatusFilter): string {
+  return status === "all" ? "/admin/announcements" : `/admin/announcements?status=${status}`;
+}
+
+function primaryLabel(savedPublished: boolean | null, targetPublished: boolean): string {
+  if (savedPublished !== true && !targetPublished) return "保存草稿";
+  if (savedPublished !== true && targetPublished) return "发布公告";
+  if (savedPublished && targetPublished) return "保存并更新";
+  return "转为草稿";
+}
+
 export default function AnnouncementComposeClient({
   mode,
   initial,
@@ -68,13 +113,26 @@ export default function AnnouncementComposeClient({
   initial?: Announcement | null;
 }) {
   const router = useRouter();
-  const baseline = useMemo(() => toForm(initial), [initial]);
-  const [form, setForm] = useState<FormState>(baseline);
+  const searchParams = useSearchParams();
+  const status = readStatus(searchParams.get("status"));
+  const backHref = listHref(status);
+  const loaded = useMemo(() => toForm(initial), [initial]);
+  const [baseline, setBaseline] = useState<FormState>(loaded);
+  const [saved, setSaved] = useState<Announcement | null>(initial ?? null);
+  const [form, setForm] = useState<FormState>(loaded);
   const formRef = useRef(form);
   const [saving, setSaving] = useState(false);
-  const isEdit = mode === "edit" && initial != null;
+  const [errors, setErrors] = useState<FieldErrors>({});
+  const [origin, setOrigin] = useState("");
+  const [confirmUnpublish, setConfirmUnpublish] = useState(false);
+  const isEdit = mode === "edit" && saved != null;
   const dirty = !sameForm(form, baseline);
   const { leaveOpen, confirmLeave, cancelLeave } = useUnsavedGuard(dirty && !saving);
+  const savedPublished = isEdit ? baseline.published : null;
+
+  useEffect(() => {
+    setOrigin(window.location.origin);
+  }, []);
 
   const patchForm = (patch: Partial<FormState> | ((prev: FormState) => FormState)) => {
     setForm((prev) => {
@@ -84,7 +142,10 @@ export default function AnnouncementComposeClient({
     });
   };
 
-  async function save() {
+  const canViewOnline = saved?.published === true && saved.id > 0;
+  const publicPath = saved ? announcementPublicPath(saved.id) : "";
+
+  async function commit() {
     if (saving) return;
     const current = formRef.current;
     const payload: AnnouncementInput = {
@@ -95,135 +156,275 @@ export default function AnnouncementComposeClient({
       published: current.published,
       pinned: current.pinned,
     };
-    if (!payload.title || !payload.content) {
-      toast("标题和内容不能为空");
-      return;
-    }
     setSaving(true);
+    setErrors({});
     try {
-      if (isEdit) {
-        await apiAdminUpdateAnnouncement(initial.id, payload);
-        toast("公告已更新", "ok");
+      if (isEdit && saved) {
+        const res = await apiAdminUpdateAnnouncement(saved.id, payload);
+        const nextItem = res.announcement;
+        const next = toForm(nextItem);
+        const wasPublished = baseline.published;
+        formRef.current = next;
+        setForm(next);
+        setBaseline(next);
+        setSaved(nextItem);
+        const nowPublished = nextItem.published;
+        const msg = !wasPublished && nowPublished
+          ? "公告已发布"
+          : wasPublished && !nowPublished
+            ? "已转为草稿"
+            : wasPublished
+              ? "公告已更新"
+              : "草稿已保存";
+        toast(msg, "ok");
+        router.refresh();
       } else {
-        await apiAdminCreateAnnouncement(payload);
+        const res = await apiAdminCreateAnnouncement(payload);
         toast(payload.published ? "公告已发布" : "草稿已保存", "ok");
+        const id = res.announcement?.id;
+        if (id) {
+          const q = status === "all" ? "" : `?status=${status}`;
+          router.replace(`/admin/announcements/${id}/edit${q}`);
+        } else {
+          router.push(backHref);
+        }
+        router.refresh();
       }
-      router.push("/admin/announcements");
-      router.refresh();
     } catch (e) {
-      toast(e instanceof Error ? e.message : "保存失败");
+      const msg = e instanceof Error ? e.message : "保存失败";
+      setErrors(errorsFromServer(msg));
+      toast(msg);
     } finally {
       setSaving(false);
+      setConfirmUnpublish(false);
     }
   }
 
-  const saveLabel = isEdit ? "保存修改" : form.published ? "发布公告" : "保存草稿";
+  function requestSave() {
+    if (saving) return;
+    const current = formRef.current;
+    const nextErrors = validate(current);
+    if (hasErrors(nextErrors)) {
+      setErrors(nextErrors);
+      toast("请先修正标出的字段");
+      return;
+    }
+    if (isEdit && baseline.published && !current.published) {
+      setConfirmUnpublish(true);
+      return;
+    }
+    void commit();
+  }
+
+  function discard() {
+    formRef.current = baseline;
+    setForm(baseline);
+    setErrors({});
+  }
+
+  async function copyAddress() {
+    if (!saved) return;
+    const url = `${(origin || window.location.origin).replace(/\/$/, "")}${announcementPublicPath(saved.id)}`;
+    try {
+      await navigator.clipboard.writeText(url);
+      toast("已复制访问地址", "ok");
+    } catch {
+      toast("复制失败");
+    }
+  }
+
+  const saveLabel = primaryLabel(savedPublished, form.published);
+  const statusText = saving
+    ? "正在保存…"
+    : errors.form
+      ? errors.form
+      : dirty
+        ? "有未保存的修改"
+        : isEdit
+          ? "已保存"
+          : "尚未保存";
 
   return (
-    <AdminSettingsPage className="is-fill">
-      <AdminPageHeader
-        icon={Megaphone}
-        title={isEdit ? "编辑公告" : "新建公告"}
-        description="标签与置顶会出现在首页右栏；正文支持 Markdown。"
-        actions={
-          <Link href="/admin/announcements" className="btn btn-line btn-sm">
-            <ArrowLeft size={14} /> 返回列表
+    <div className="admin-doc-page admin-doc-editor">
+      <header className="admin-doc-head">
+        <div className="min-w-0">
+          <Link href={backHref} className="admin-doc-back">
+            <ArrowLeft size={14} aria-hidden /> 返回列表
           </Link>
-        }
-      />
+          <div className="admin-doc-head-title">
+            <h1>{isEdit ? "编辑公告" : "新建公告"}</h1>
+            <AdminStatusChip tone={savedPublished ? "ok" : savedPublished === false ? "warn" : "accent"}>
+              {savedPublished ? "已发布" : savedPublished === false ? "草稿" : "尚未保存"}
+            </AdminStatusChip>
+          </div>
+        </div>
+        {canViewOnline ? (
+          <a
+            href={publicPath}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="btn btn-line"
+            title="打开已发布内容。未保存的修改不会出现在这里。"
+          >
+            <ExternalLink size={14} aria-hidden /> 查看线上页面
+          </a>
+        ) : null}
+      </header>
 
-      <div className="admin-settings-main admin-settings-stack">
-        <AdminSettingsGroup title="发布设置" description="标签色与置顶只影响前台展示，不改正文。">
-          <AdminSettingsRow label="标签" htmlFor="anno-tag">
+      <div className="admin-doc-split">
+        <div className="admin-doc-main">
+          <AdminField
+            id="anno-title"
+            label="标题"
+            maxLength={200}
+            value={form.title}
+            error={errors.title}
+            onChange={(title) => {
+              setErrors((prev) => ({ ...prev, title: undefined }));
+              patchForm({ title });
+            }}
+            placeholder="请输入公告标题"
+          />
+          <div className="admin-doc-md">
+            <label className="admin-doc-label" htmlFor="anno-content">
+              正文
+            </label>
+            <MarkdownEditor
+              id="anno-content"
+              value={form.content}
+              onChange={(content) => {
+                setErrors((prev) => ({ ...prev, content: undefined }));
+                patchForm({ content });
+              }}
+              allowHide
+              allowReplyHide={false}
+              placeholder="请输入公告正文，支持 Markdown…"
+              rows={16}
+              onSubmitShortcut={requestSave}
+            />
+            {errors.content ? (
+              <p className="admin-settings-row-error" role="alert">
+                {errors.content}
+              </p>
+            ) : null}
+          </div>
+        </div>
+
+        <details className="admin-doc-rail" open>
+          <summary>公告设置</summary>
+          <div className="admin-doc-rail-body">
             <AdminField
               id="anno-tag"
               label="标签"
-              embed
-              className="admin-settings-control-text"
+              hint="显示在首页右栏和公告列表的标题旁。留空保存时会写成「公告」。"
               maxLength={32}
               value={form.tag}
-              onChange={(tag) => patchForm({ tag })}
+              error={errors.tag}
+              onChange={(tag) => {
+                setErrors((prev) => ({ ...prev, tag: undefined }));
+                patchForm({ tag });
+              }}
               placeholder="公告"
             />
-          </AdminSettingsRow>
-          <AdminSettingsRow label="标签颜色">
-            <div className="flex items-center gap-2 flex-wrap">
-              {ANNOUNCEMENT_COLORS.map((c) => (
-                <button
-                  key={c.value}
-                  type="button"
-                  data-tip={c.label}
-                  aria-label={c.label}
-                  aria-pressed={form.tag_color === c.value}
-                  className={`j13-anno-dot is-${c.value}`}
-                  onClick={() => patchForm({ tag_color: c.value })}
-                />
-              ))}
-            </div>
-          </AdminSettingsRow>
-          <AdminSettingsRow label="发布状态">
-            <AdminSegmented<PublishKey>
-              role="group"
-              ariaLabel="发布状态"
-              value={form.published ? "published" : "draft"}
-              onChange={(key) => patchForm({ published: key === "published" })}
-              options={[
-                { key: "published", label: "立即发布" },
-                { key: "draft", label: "存为草稿" },
-              ]}
-            />
-          </AdminSettingsRow>
-          <AdminSettingsRow label="置顶" hintBelow="置顶后优先显示在首页右栏">
-            <AdminSwitch
-              checked={form.pinned}
-              onChange={() => patchForm((f) => ({ ...f, pinned: !f.pinned }))}
-              label="置顶公告"
-            />
-          </AdminSettingsRow>
-        </AdminSettingsGroup>
 
-        <AdminSettingsGroup
-          className="is-fill"
-          title="标题与正文"
-          footer={
-            <AdminSettingsActions
-              dirty={dirty}
-              saving={saving}
-              saveLabel={saveLabel}
-              onSave={() => void save()}
-              onDiscard={() => {
-                formRef.current = baseline;
-                setForm(baseline);
-              }}
-            />
-          }
-        >
-          <AdminSettingsRow label="标题" htmlFor="anno-title" wide>
-            <AdminField
-              id="anno-title"
-              label="标题"
-              embed
-              maxLength={200}
-              value={form.title}
-              onChange={(title) => patchForm({ title })}
-              placeholder="请输入公告标题"
-            />
-          </AdminSettingsRow>
-          <AdminSettingsRow className="admin-settings-md-editor" label="正文" htmlFor="anno-content" wide>
-            <div className="admin-settings-md">
-              <MarkdownEditor
-                id="anno-content"
-                value={form.content}
-                onChange={(content) => patchForm({ content })}
-                allowHide
-                allowReplyHide={false}
-                placeholder="请输入公告正文，支持 Markdown…"
-                rows={18}
-                onSubmitShortcut={() => void save()}
-              />
+            <div className="admin-doc-field">
+              <p className="admin-doc-label">标签颜色</p>
+              <div className="admin-doc-colors" role="radiogroup" aria-label="标签颜色">
+                {ANNOUNCEMENT_COLORS.map((c) => (
+                  <button
+                    key={c.value}
+                    type="button"
+                    role="radio"
+                    aria-checked={form.tag_color === c.value}
+                    data-tip={c.label}
+                    aria-label={c.label}
+                    className={`j13-anno-dot is-${c.value}`}
+                    onClick={() => patchForm({ tag_color: c.value })}
+                  />
+                ))}
+              </div>
+              <p className="admin-doc-hint">只影响标签颜色，不改正文。</p>
+              {errors.tag_color ? (
+                <p className="admin-settings-row-error" role="alert">
+                  {errors.tag_color}
+                </p>
+              ) : null}
             </div>
-          </AdminSettingsRow>
-        </AdminSettingsGroup>
+
+            <div className="admin-doc-field">
+              <p className="admin-doc-label">置顶</p>
+              <div className="admin-doc-switchline">
+                <AdminSwitch
+                  checked={form.pinned}
+                  onChange={() => patchForm((f) => ({ ...f, pinned: !f.pinned }))}
+                  label="置顶公告"
+                />
+                <span>置顶公告</span>
+              </div>
+              <p className="admin-doc-hint">
+                已发布且置顶的公告排在首页右栏前面。草稿即使勾选也不会出现在前台。
+              </p>
+            </div>
+
+            {isEdit && saved ? (
+              <div className="admin-doc-field">
+                <p className="admin-doc-label">访问地址</p>
+                <p className="admin-doc-hint">
+                  {publicPath}
+                  {origin ? ` · ${origin.replace(/\/$/, "")}${publicPath}` : ""}
+                </p>
+                <p className="admin-doc-hint">地址按公告编号生成，不能改成自定义路径。</p>
+                <button type="button" className="btn btn-line admin-doc-copy" onClick={() => void copyAddress()}>
+                  <Copy size={14} aria-hidden /> 复制地址
+                </button>
+              </div>
+            ) : (
+              <p className="admin-doc-hint">保存后才会有公开地址 /announcement/编号。草稿没有公开入口。</p>
+            )}
+
+            <div className="admin-doc-field">
+              <p className="admin-doc-label">保存后状态</p>
+              <AdminSegmented<PublishKey>
+                role="group"
+                ariaLabel="保存后状态"
+                size="sm"
+                value={form.published ? "published" : "draft"}
+                onChange={(key) => patchForm({ published: key === "published" })}
+                options={[
+                  { key: "draft", label: "草稿" },
+                  { key: "published", label: "已发布" },
+                ]}
+              />
+              <p className="admin-doc-hint">点选只改变这次要保存的状态，不会立刻发布或下线。</p>
+            </div>
+          </div>
+        </details>
+
+        <div className="admin-doc-actions" aria-busy={saving || undefined}>
+          <div className="admin-doc-actions-btns">
+            <button type="button" className="btn btn-line" disabled={!dirty || saving} onClick={discard}>
+              撤销修改
+            </button>
+            <button
+              type="button"
+              className="btn btn-primary"
+              disabled={!dirty || saving}
+              onClick={requestSave}
+            >
+              {saving ? <Loader2 size={15} className="animate-spin" aria-hidden /> : null}
+              {saving ? "保存中…" : saveLabel}
+            </button>
+            <p className={`admin-doc-status${errors.form ? " is-error" : ""}`} aria-live="polite">
+              {statusText}
+            </p>
+          </div>
+          <p className="admin-doc-hint">一次保存会写入标题、正文和公告设置。Ctrl/⌘ + Enter 与这个按钮相同。</p>
+          {canViewOnline ? (
+            <p className="admin-doc-hint">查看线上页面打开的是已发布内容，未保存的修改不会出现在那里。</p>
+          ) : (
+            <p className="admin-doc-hint">草稿没有公开地址。要看正文，用编辑器里的预览。</p>
+          )}
+        </div>
       </div>
 
       <ConfirmDialog
@@ -235,6 +436,18 @@ export default function AnnouncementComposeClient({
         onCancel={cancelLeave}
         onConfirm={confirmLeave}
       />
-    </AdminSettingsPage>
+      <ConfirmDialog
+        open={confirmUnpublish}
+        title="转为草稿"
+        message="转为草稿后，前台将无法打开此公告。这里没有单独的修订版本，线上内容会一起下线，不会保留旧版。"
+        confirmLabel="转为草稿"
+        danger
+        busy={saving}
+        onCancel={() => {
+          if (!saving) setConfirmUnpublish(false);
+        }}
+        onConfirm={() => void commit()}
+      />
+    </div>
   );
 }

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

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { Suspense } from "react";
 import { cookies } from "next/headers";
 import { authCookieHeader } from "@/lib/cookies";
 import { getMeCached } from "@/lib/serverData";
@@ -27,5 +28,9 @@ export default async function AdminAnnouncementEditPage({ params }: PageProps) {
     return <Forbidden text="无效的公告 ID。" />;
   }
 
-  return <AnnouncementEditLoader id={numId} />;
+  return (
+    <Suspense fallback={<p className="meta px-1 py-6">加载编辑器…</p>}>
+      <AnnouncementEditLoader id={numId} />
+    </Suspense>
+  );
 }

frontend/app/admin/announcements/announcementColors.ts

@@ -15,3 +15,8 @@ export const ANNOUNCEMENT_COLORS: { value: AnnouncementColor; label: string }[]
   { value: "indigo", label: "靛蓝" },
   { value: "rose", label: "玫红" },
 ];
+
+/** 公告公开路径。前台是 /announcement/[id]，列表和线上查看用同一条。 */
+export function announcementPublicPath(id: number): string {
+  return `/announcement/${id}`;
+}

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

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { Suspense } from "react";
 import { cookies } from "next/headers";
 import { authCookieHeader } from "@/lib/cookies";
 import { getMeCached } from "@/lib/serverData";
@@ -17,5 +18,9 @@ export default async function AdminAnnouncementNewPage() {
     return <Forbidden text="公告管理仅管理员及以上角色可操作。" />;
   }
 
-  return <AnnouncementComposeClient mode="create" />;
+  return (
+    <Suspense fallback={<p className="meta px-1 py-6">加载编辑器…</p>}>
+      <AnnouncementComposeClient mode="create" />
+    </Suspense>
+  );
 }

frontend/app/admin/announcements/page.tsx

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { Suspense } from "react";
 import { cookies } from "next/headers";
 import AnnouncementAdmin from "./AnnouncementAdmin";
 import { authCookieHeader } from "@/lib/cookies";
@@ -28,5 +29,9 @@ export default async function AdminAnnouncementsPage() {
     initError = e instanceof Error ? e.message : "加载公告失败";
   }
 
-  return <AnnouncementAdmin initial={initial} initError={initError} />;
+  return (
+    <Suspense fallback={<p className="meta px-1 py-6">加载公告列表…</p>}>
+      <AnnouncementAdmin initial={initial} initError={initError} />
+    </Suspense>
+  );
 }