feat: 外观支持自定义 CSS/JS，并升级发帖工作台与积分存量看板

后台可注入全站 CSS/JS（SSR 生效，CSS 可热换）；发帖/编辑改为锁一屏工作室；经济看板增加存量健康度；主题令牌与弹层误关一并收紧。

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

frontend/lib/api.ts

@@ -677,6 +677,10 @@ export interface PublicSettings {
   attachment_max_count: number;
   /** 正文插图上限 MB；缺省 5 */
   image_max_mb: number;
+  /** 全站自定义 CSS；空串=无 */
+  custom_css: string;
+  /** 全站自定义 JS；空串=无（保存后整页加载生效） */
+  custom_js: string;
 }
 
 /** 与后端 DefaultAttachmentExts 保持同步 */
@@ -711,6 +715,8 @@ const DEFAULT_PUBLIC_SETTINGS: PublicSettings = {
   attachment_max_mb: 20,
   attachment_max_count: 10,
   image_max_mb: 5,
+  custom_css: "",
+  custom_js: "",
 };
 
 function normalizeAttachmentExts(raw: unknown): string[] {
@@ -780,6 +786,8 @@ function normalizePublicSettings(data: Partial<PublicSettings> | null | undefine
     attachment_max_mb: maxMB,
     attachment_max_count: maxCount,
     image_max_mb: imageMB,
+    custom_css: typeof data?.custom_css === "string" ? data.custom_css : "",
+    custom_js: typeof data?.custom_js === "string" ? data.custom_js : "",
   };
 }
 
@@ -2136,6 +2144,8 @@ export type UpdateSiteSettingsBody = {
   attachment_max_mb?: number;
   attachment_max_count?: number;
   image_max_mb?: number;
+  custom_css?: string;
+  custom_js?: string;
   timeline_git_import?: string;
 };
 

frontend/lib/customCode.ts

@@ -0,0 +1,100 @@
+// 全站自定义 CSS：SSR <style id="j13-custom-css"> + 客户端 #j13-custom-css-runtime。
+// 禁止对 SSR 节点 remove/改写；预览时 disable SSR，由 runtime 作为唯一源。
+
+export const MAX_CUSTOM_CSS_CHARS = 48000;
+export const MAX_CUSTOM_JS_CHARS = 48000;
+
+/** 空配置时展示的注释模板：保存前不生效，全部注释故误保存也无副作用 */
+export const SAMPLE_CUSTOM_CSS = `/* 姜十三 · 自定义 CSS 示例
+ * 覆盖 globals.css 令牌或组件类。保存后对全站访客生效。
+ * 勿写入 </style>
+ *
+ * 常用令牌：
+ *   --bg / --panel / --ink / --accent
+ *   --bg-halo            顶部光晕色（建议 ≤ 0.04）
+ *   --bg-noise-opacity   噪点层透明度
+ *   --r / --shadow-sm    卡片圆角与阴影
+ */
+
+/* 改底色与光晕（浅 / 暗成对改）
+:root {
+  --bg: #f7f7f5;
+  --bg-halo: rgba(7, 192, 95, 0.04);
+  --bg-noise-opacity: 0.03;
+  --panel: #ffffff;
+  --r: 12px;
+  --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.05);
+}
+.dark {
+  --bg: #101211;
+  --bg-halo: rgba(7, 192, 95, 0.03);
+  --bg-noise-opacity: 0.04;
+}
+*/
+
+/* 关掉光晕和噪点
+body::before,
+body::after {
+  display: none;
+}
+*/
+
+/* 隐藏页脚
+footer { display: none; }
+*/
+`;
+
+export const SAMPLE_CUSTOM_JS = `// 姜十三 · 自定义 JS 示例
+// 仅整页加载执行一次（F5 / 首次进入），站内软导航不会重跑。
+// 勿写入 </script>
+//
+// 给 <html> 打标记，便于 CSS 写 html[data-custom] .panel { ... }
+// document.documentElement.dataset.custom = "1";
+//
+// 等 DOM 就绪后再改节点
+// document.addEventListener("DOMContentLoaded", function () {
+//   // document.querySelector("footer")?.remove();
+// });
+`;
+
+const SSR_STYLE_ID = "j13-custom-css";
+const RUNTIME_STYLE_ID = "j13-custom-css-runtime";
+
+export function clipCustomSnippet(raw: string, max: number): string {
+  const s = (raw || "").replace(/\u0000/g, "");
+  if (s.length <= max) return s;
+  return [...s].slice(0, max).join("");
+}
+
+function ensureRuntimeStyle(): HTMLStyleElement {
+  let el = document.getElementById(RUNTIME_STYLE_ID) as HTMLStyleElement | null;
+  if (el) return el;
+  el = document.createElement("style");
+  el.id = RUNTIME_STYLE_ID;
+  el.setAttribute("data-custom-css-source", "runtime");
+  document.body.appendChild(el);
+  return el;
+}
+
+function removeRuntimeStyle(): void {
+  document.getElementById(RUNTIME_STYLE_ID)?.remove();
+}
+
+function ssrStyle(): HTMLStyleElement | null {
+  return document.getElementById(SSR_STYLE_ID) as HTMLStyleElement | null;
+}
+
+/** 将自定义 CSS 应用到当前文档。preview=true 时忽略 SSR 节点（外观页草稿）。 */
+export function applyCustomCSS(css: string, preview = false): void {
+  if (typeof document === "undefined") return;
+  const text = clipCustomSnippet(css, MAX_CUSTOM_CSS_CHARS).trim();
+  const ssr = ssrStyle();
+  if (ssr) ssr.disabled = preview;
+
+  if (!text) {
+    removeRuntimeStyle();
+    if (!preview && ssr) ssr.disabled = false;
+    return;
+  }
+  ensureRuntimeStyle().textContent = text;
+}

frontend/lib/postMeta.ts

@@ -1,11 +1,11 @@
 /** 帖子类型 / 可见性 / 展示文案（前后端共用约定） */
 
 export const POST_TYPES = [
-  { value: "discussion", label: "讨论", hint: "默认讨论帖" },
+  { value: "discussion", label: "讨论", hint: "日常交流" },
   { value: "question", label: "问答", hint: "提问求解" },
-  { value: "poll", label: "投票", hint: "发起投票，读者可参与" },
-  { value: "bounty", label: "悬赏", hint: "发布时托管积分，采纳后发放" },
-  { value: "lottery", label: "抽奖", hint: "奖品类型+数量入池，评论后锁定奖品" },
+  { value: "poll", label: "投票", hint: "收集选项意见" },
+  { value: "bounty", label: "悬赏", hint: "积分托管求解" },
+  { value: "lottery", label: "抽奖", hint: "评论参与开奖" },
 ] as const;
 
 export type PostTypeValue = (typeof POST_TYPES)[number]["value"];

frontend/lib/realtime.ts

@@ -59,6 +59,8 @@ export interface RtSettingsData {
   attachment_max_mb?: number;
   attachment_max_count?: number;
   image_max_mb?: number;
+  custom_css?: string;
+  custom_js?: string;
 }
 
 // 群聊新消息：data 为落库的 ChatMessage（含 sender）

frontend/lib/theme.ts

@@ -157,7 +157,7 @@ function clampForLight(hex: string): string {
 function deriveDark(hex: string): string {
   const [h, s, lRaw] = rgbToHsl(hexToRgb(hex));
   let l = Math.max(lRaw, 0.62);
-  const surfaces = ["#181b21", "#0f1115", "#10162b"];
+  const surfaces = ["#181b21", "#101211", "#10162b"];
   let cur = hex;
   for (let i = 0; i < 120; i++) {
     cur = rgbToHex(hslToRgb([h, s, l]));
@@ -207,18 +207,18 @@ function buildAccentCSS(input: string): string {
     `--accent-hi:${hi};`,
     `--accent-soft:${rgba(light, 0.1)};`,
     `--accent-on:#ffffff;`,
-    `--nav-active-bg:${rgba(light, 0.1)};`,
+    `--nav-active-bg:var(--panel);`,
     `--nav-active-ink:${light};`,
-    `--nav-active-line:${rgba(light, 0.22)};`,
+    `--nav-active-line:${rgba(light, 0.38)};`,
     `}`,
     `.dark{`,
     `--accent:${dark};`,
     `--accent-hi:${darkHi};`,
     `--accent-soft:${rgba(dark, 0.16)};`,
     `--accent-on:#10162b;`,
-    `--nav-active-bg:${rgba(dark, 0.14)};`,
+    `--nav-active-bg:var(--panel);`,
     `--nav-active-ink:${darkHi};`,
-    `--nav-active-line:${rgba(dark, 0.3)};`,
+    `--nav-active-line:${rgba(dark, 0.38)};`,
     `}`,
   ].join("");
 }