Files
jiang13-forum/docs/rebuild-spec/10-design-system.md
freefire 3bd0b990a1 feat: 公开页设计系统与壳层重绘
落墨青冷纸 token 与设计规格,重绘顶栏/三栏/Feed/帖详情壳层并同步暗色。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-30 05:22:15 +08:00

100 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 10 · 公开页设计系统
> **读者**:实现公开页视觉 / CSS 的 AI
> **前置**[01-product.md](01-product.md)、[06-pages-ux.md](06-pages-ux.md)
> **实现**[`web_src/css/site.css`](../../web_src/css/site.css)、[`templates/base/`](../../templates/base/)
> **品牌**:默认「姜十三论坛」(安装/后台可改 `site_name`
视觉可重设;**信息架构与关键操作流以 06 为准**。本文件只约定公开页壳层与内容表面的视觉语言。
---
## 1. 气质
| 项 | 约定 |
|----|------|
| 关键词 | 墨青、编辑式、冷静、可读、偏内容 |
| 密度 | 接近 V2EX / NGA一屏多信息非营销留白 |
| 反模式 | 紫渐变、暖奶油底、大圆角卡片墙、全幅 hero、Inter/Roboto 默认堆 |
---
## 2. Token
### 2.1 色CSS 变量 `--j13-*`
| Token | 浅色 | 暗色 | 用途 |
|-------|------|------|------|
| `--j13-bg` | `#f3f4f6` | `#0f1419` | 页底(冷纸 / 墨底) |
| `--j13-surface` | `#ffffff` | `#1a222c` | 顶栏、主栏底 |
| `--j13-text` | `#14212b` | `#e8eef2` | 正文 |
| `--j13-muted` | `#5b6b76` | `#8b9aab` | 次要 |
| `--j13-accent` | `#0d9488` | `#2dd4bf` | 链接 / 强调 |
| `--j13-accent-ink` | `#134e4a` | `#99f6e4` | 品牌字、强强调 |
| `--j13-on-accent` | `#ffffff` | `#134e4a` | 主按钮字 |
| `--j13-border` | `#d5dde3` | `#2c3844` | 分隔线 |
| `--j13-hover` | `#e8eef0` | `#243040` | 行 hover |
语义色ok / warn / err / pin / feat继续用既有 `--j13-ok-*` 等,随主题成对定义。
### 2.2 字号与字重
| 阶 | 尺寸 | 用途 |
|----|------|------|
| `xs` | 0.75rem | 口号、辅助 |
| `sm` | 0.8125rem | 元信息、侧栏 |
| `md` | 0.9375rem | 正文默认 |
| `lg` | 1.125rem | Feed 标题 |
| `xl` | 1.35rem | 帖标题 |
| `brand` | 1.25rem / 700 | 顶栏站点名 |
字体栈:西文优先 `IBM Plex Sans`(本机有则用),中文 `PingFang SC` / `Hiragino Sans GB` / `Noto Sans SC` / `Microsoft YaHei`;代码 `IBM Plex Mono` / `Cascadia Code` / `Consolas`。不引入 Inter/Roboto。
### 2.3 间距与圆角
- 栅格4px 基准;常用 `0.5 / 0.75 / 1 / 1.25 / 1.5 rem`
- 圆角:`--j13-radius: 6px`(控件);列表行无大圆角卡片
- 阴影:仅 sticky 顶栏微阴影 `0 1px 0 var(--j13-border)` + `0 4px 12px rgba(0,0,0,.04)`(滚动时)
### 2.4 动效
| 处 | 行为 |
|----|------|
| 主题 | `color` / `background` / `border-color` `150ms ease` |
| Feed 行 | hover 背景 `120ms ease` |
| 顶栏 | sticky 时阴影淡入 |
---
## 3. 布局
| 断点 | 行为 |
|------|------|
| ≥901px | 三栏:左 ~200px / 中 1fr / 右 ~240px总宽 ~1120px |
| ≤900px | 隐藏右栏(抽屉化 **下一刀** |
主栏与侧栏之间用细线或间距,**不**用大卡片包住整栏。
---
## 4. 组件约定
| 组件 | 规则 |
|------|------|
| 顶栏 | 品牌一级信号nav 次级;主题钮弱边框 |
| 侧栏链 | 字号 smactive 用左边框或 accent 字重,无厚底块 |
| Feed 行 | 细线分隔;标题 lg无白盒卡片 |
| 标签 | 小圆角色块;语义色见 token |
| 按钮 | 主accent 底边框文字linkbtn |
| 评论 | 楼层号强调;嵌套左边线;密度高于卡片堆 |
| 门控壳 | 虚线/淡底提示锁定,不抢正文 |
---
## 5. 范围边界
- **本系统覆盖**公开页壳层顶栏、三栏、Feed、帖详情、暗色
- **不覆盖**Admin 深度重绘、移动抽屉、虚拟滚动、TipTap
交叉:[06-pages-ux.md](06-pages-ux.md) 路由与操作流 · [09-ssr-progress.md](09-ssr-progress.md) 进度