# 网鱼论坛视觉规范

版本：2026-10-30。适用于网鱼论坛及明确要求沿用网鱼风格的页面。

## 设计语言

以内容阅读为中心：蓝色主操作、白色或深灰内容表面、细边线、克制投影、柔和超椭圆。工具图标清晰统一，Banner 用温暖的小鱼场景表达社区气质。界面不使用表情符号、表情包作为导航、标题或按钮装饰。

## 颜色

| 用途 | 浅色 | 说明 |
| --- | --- | --- |
| 品牌 / 主要操作 / 最新回复 | #0052D9 | `--pd-color-primary`；深色链接使用 #0098FD |
| 最新发表 | #17A34A | 首页语义色 |
| 热门 | #ED8500 | 首页语义色 |
| 精华 | #7856C8 | 首页语义色 |
| 正文 | #111827 | 深色 #E8E8E8 |
| 辅助文字 | #6B7280 | 深色 #B0B0B0 |
| 内容表面 | #FFFFFF | 深色 #202020 |
| 边线 | #E5E7EB | 深色 #3A3A3A |

状态色保留各自语义。W06 按钮填色为蓝 #0052D9、灰 #657080（深色 #4E596A）、绿 #117F3A、红 #C73540；不可用首页发表绿替换按钮绿。实体按钮文字为白色，深浅主题保持按钮主色，表面照明随尺寸收敛。

## 字体、字号与行高

使用论坛系统无衬线字体栈。界面系统栈为 `-apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", "Segoe UI", Arial, sans-serif`；主题正文 / 标题栈沿用项目当前 `--pd-content-font` / `--pd-title-font`，不下载另一套正文中文字体。代码及既有等宽号码、邀请码、IP 等使用 `--pd-font-mono`，首选自托管 Space Mono Latin 400 / 700，再回退系统等宽字体。普通正文中的数字和仅开启 `tabular-nums` 的统计数字继续沿用各自正文字体，不全站替换。Space Mono 使用 SIL OFL 1.1，完整许可随字体资源保存。文字型方章保留既有字形资源，不把其字体扩展到正文。

| 用途 | 字号 | 字重 | 行高 |
| --- | --- | --- | --- |
| 页面主标题 / 关于页 | 24px | 600 | 1.4 |
| 普通页面或主题标题 | 20px | 500–600 | 1.4 |
| 区块标题 | 16px | 600 | 1.5 |
| 正文、列表标题、按钮、输入 | 14px | 400；按钮 600 | 正文 1.75；控件 1.4–1.5 |
| 辅助说明、时间、页脚 | 12px | 400–500 | 1.5–1.75 |
| 紧凑元信息 | 10–11px | 400 | 仅保留既有紧凑组件用途 |

常规正文不额外拉字距；长文行高可用 1.85–1.95，限制阅读宽度约 56em。数字使用等宽数字特性；长号码和长文本不挤出容器。32px 展示字号留给特定大数字，不把普通说明页做成巨大营销标题。

## 间距与布局

| 令牌 | 值 | 常见用途 |
| --- | --- | --- |
| `--pd-space-1` | 8px | 图标与文本、标签与输入 |
| `--pd-space-2` | 12px | 行内操作、帖子卡片之间 |
| `--pd-space-3` | 16px | 常规卡片内边距、手机页边距 |
| `--pd-space-4` | 24px | 桌面内边距、分组间距 |
| `--pd-space-5` | 32px | 章节间距 |

基于 4px 网格。小间距可由令牌计算 4px，避免增加 7px、13px 之类的近似尺寸。关于页长内容分组沿用 44px，不以此扩大所有页面间距。

页面最大宽度 1200px，桌面居中，页内通常左右 24px，手机 16px。主栏自适应、论坛右侧栏 300px。网格使用 `minmax(0, 1fr)`；手机按阅读顺序变成单列。表格只在自身容器内横向滚动。卡片标题、正文与操作区对齐，减少卡片套卡片。

## 原生超椭圆

使用项目 `.squircle` 和 `--sq-r`。支持时设置 `corner-shape: squircle`；普通圆角回退为半径 × 0.54。不要使用旧 SVG 遮罩切卡片边框与阴影。

| 组件 | 原生半径 |
| --- | --- |
| 常规实体按钮 | 实际高度 × 0.46（36px 高对应 16.56px） |
| 小按钮 | 32 × 0.46 = 14.72px |
| 列表帖子卡 | 18px |
| 侧栏卡 | 20px |
| 内容卡 / 面板 | 22px |

按钮、导航悬浮底与选中背景、标签控件、客服和返回顶部的按钮底、方底图标都使用超椭圆。按钮以实际高度计算半径，48px 高约为 22px。嵌套选中块从外框半径扣除内边距及边框。图标图形、状态圆点和圆形头像沿用各自的轮廓。

```css
/* 已加载论坛 squircle.css 时，只需指定尺寸。 */
.example-card {
  --sq-r: 22px;
  padding: var(--pd-space-4);
  border: 1px solid var(--pd-color-border);
  background: var(--pd-color-surface);
}
```

```html
<section class="example-card squircle">内容</section>
```

## 按钮与控件

现行按钮是 W06「下沿水光」比例修饰版：轻微顶缘高光、底部局部水光、细描边与约 1px 深度，尺寸越小照明越弱。不是全屏玻璃或大面积磨砂。生产页面复用当前 `.btn` / `.pd-btn` 类和主题规则，不重新手绘另一个渐变。

| 尺寸 | 高度 | 水平内边距 | 字号 |
| --- | --- | --- | --- |
| 小 | 32px | 12px | 12px |
| 标准 | 36px | 16px | 14px |
| 大 | 40px | 20px | 14px |

行内图标 16px，图文间隔 8px。图标独立按钮提供可访问名称与可见焦点。每组一个主要操作，保存、返回、取消为次级操作；绿色用于完成 / 已关注，红色用于危险操作。

悬停轻微增亮，按下约 1px 下移；禁用约 46% 不透明度，使用原生 disabled。处理中显示文字状态、阻止重复操作，并向辅助技术说明忙碌状态。减少动态效果时取消位移动画，不影响功能。演示页的示例不运行真实发布或删除。

输入框一般高 36px、圆角 6px、标签间距 8px、表单项间距 16px；采用细边线与蓝色焦点。错误同时提供文字并与输入关联，不能只变红。

弹窗复用论坛 `components/dialog/Modal.tsx`、`lib/modal-system.ts`、`styles/dialog-system.css`。保留统一关闭按钮、焦点管理、滚动锁，不在各页面自行添加另一套浮层。

## 导航与下载按钮

网鱼独立说明与规范页的顶部返回入口、独立页脚导航、下载规范等操作入口，使用 W06 超椭圆实体按钮。默认次级操作用中性灰，复制或提交等主操作用蓝色；不使用裸蓝色下划线链接表达这些独立操作。

上述实体按钮约定不应用到论坛首页的现有页脚图标工具。首页页脚保留当前 `SiteFooter.tsx` 与 `.site-footer-tool` 外观，不能因为规范页按钮调整而一并改造。

标准小按钮高 32px、字号 12px、水平内边距 12px，原生超椭圆半径 14.72px。标准 / 大尺寸仍遵循 36 / 40px 及对应内边距。同组保持高度、间距和垂直对齐；悬停、按下、键盘焦点均沿用组件样式，按钮悬停不出现文字下划线。

保留语义：跳转使用 `<a href>`，下载继续带 `download`，只触发当前页动作才使用 `<button type="button">`。生产论坛复用现有 `.btn` / `.pd-btn` 与中性变体；静态 UI 页面使用已提取的 `.pd-ui-btn is-small is-neutral`。不要给链接套一个真实 button，也不要把正文里的引用、说明链接全部变成按钮。

```html
<!-- 静态规范页示例；业务页面使用其现有公共按钮类。 -->
<a class="pd-ui-btn is-small is-neutral" href="/">返回论坛</a>
<a class="pd-ui-btn is-small is-neutral"
   href="/assets/ui/netfish-design-guide.md" download>下载完整规范</a>
```

“游于网络，创造于数字世界。”等品牌口号与纯展示标题默认是非交互文字：不包在链接中，不设置点击动作、指针光标或悬停下划线。具有明确导航用途的 Logo / 标题入口可按任务要求保留。

## 主题切换：共享行为，按页面保留外观

两处共用现有主题图标与三态切换行为，外观按页面分别维护：

| 页面 | 页脚主题入口 | 修改边界 |
| --- | --- | --- |
| UI 规范页 `/ui.html` | 与旁边三个导航按钮一致的中性灰 W06 实体按钮，高 32px，保留现有图标 | 只调整规范页的标记与专用样式 |
| 论坛首页 | 保留现有透明背景图标按钮，沿用 `SiteFooter.tsx` 与 `.site-footer-tool.site-footer-theme` | 不套用规范页的 W06 实体外观，不随规范页一并修改 |

修改任一处外观都不联动另一处；只有用户明确另行要求，才扩大修改范围。共享偏好逻辑与图标资源不意味着共享按钮外壳。规范页样式使用 `.pd-ui-*` 等限定范围，不能为实现规范页外观去覆盖论坛公共 `.site-footer-tool`。

- 论坛原页脚沿用 `.site-footer-tool.site-footer-theme`；静态规范页使用 `.pd-ui-btn.is-small.is-neutral.is-icon.site-footer-theme`，复用同一套按钮表面、圆角、悬停与按下效果，32px 高且宽 32px。两处保留 `.pd-footer-icon`，以及 `theme-light.svg`、`theme-dark.svg`、`theme-system.svg`。只显示当前模式的一枚图标；默认灰阶与 0.72 不透明度，悬停 / 聚焦恢复原色，图标保持 20px，不因按钮外观改变而缩放或重新绘制。组件基准为 32px 点击区，焦点样式沿用所在页面公共按钮。
- 规范页将主题切换放在页脚，顶部保留标题与返回论坛。与页脚导航按钮同排时，使用 32px 点击区并垂直居中；手机可换行，不拉伸图标或额外放大按钮。焦点轮廓须在所在背景上清楚可见。
- 点击顺序固定为“跟随系统 → 浅色 → 深色 → 跟随系统”。名称和提示说明当前模式；不以二态 `aria-pressed` 代替三态含义。
- 共用 `apps/web/src/lib/theme-preference.ts` 的偏好读取、`cycleTheme`、`subscribeTheme`、`getThemePreference`，使用原有 `pdThemeMode` 存储键。刷新保留选择，系统模式响应系统明暗变化，其他标签页变更同步；存储不可用时本页仍可切换。
- 论坛 React 页面使用 `theme.ts` 的原有接口；静态规范页使用 `ui-theme.ts`，由 `scripts/build-ui-primitives.mjs` 构建 `theme-init.js`。不要复制一套独立的状态逻辑，或把预览按钮改成只对本页临时生效的两态开关。
- 静态页在首次绘制前应用共享偏好；框架页面沿用已有启动脚本和生命周期。使用相同逻辑，不要求不相关页面更换框架。

修改主题逻辑后，验证循环顺序、当前图标、刷新记忆、系统变化、跨标签同步和不可写存储的回退。静态页面同时重新生成主题脚本；代码检查与浏览器检查以本次变更涉及的范围为准。

## 图标与功能小标识

- 本页只收录本站 SVG 图形，不展示通用字体图标库。功能图标沿用项目现有资源，保持同组线宽和视觉尺寸；行内 14–16px，独立工具 20px，展示 24px。
- 分类和排序方章复用 `assets/badges/*.svg`，蓝 / 绿 / 橙 / 紫按首页语义分配。优先当前代码实际引用的图标；旧探索稿只在历史区。
- 装饰图标 `aria-hidden="true"`；有旁边文字的图片可用空 alt；独立操作必须命名。
- 新增小 Logo 优先在同组现有轮廓、色彩、线宽上扩展，保留透明背景，提供 SVG。品牌标识用对应品牌图形，不强改成普通线性图标。

## Banner 与插画

延续已有蓝、橙、黄三位小鱼伙伴，温暖柔和的立体场景，带适量手作质感与自然光。可参考首页四季图、关于页庭院图与对应版块工坊图。先查现有素材是否适用，再决定是否新增。

桌面常见横幅为 2400 × 478，主体居中，左侧留 Logo 安全区，底部避让导航。手机优先使用同系列 `-mobile.webp` 的独立构图，不能只把宽图硬裁后让主体出框。侧栏图与版块方图分别设计构图，不拉伸宽幅图。具体尺寸以文件真实尺寸为准。

不在插画中烘焙页面标题或业务按钮；天气、季节、主题变化在同一角色体系中完成。不把 W06 水光材质延伸到全部卡片或背景。

## Logo 与品牌

标准标识为 `/logo.svg`，原始 viewBox 1065 × 490。浅色表面使用原蓝色渐变；复杂或深色背景可用保留轮廓的单色白色。不要变形、旋转、描边、加投影或重画一个近似 Logo。安全留白至少为可见标识高度的 1/4。

小尺寸使用现成 `/assets/icons/favicon-32x32.png`；应用入口使用既有 `/assets/icons/apple-touch-icon.png` 等尺寸。功能标记遵循方章体系，不能每个入口另造一套 Logo。

## 正文图片加载与进度

灰鱼固定在真实图片尺寸占位的正中心，取消下方圆圈。未知总大小时轻微拉长、回弹；收到有效总大小后停止拉伸，按实际下载字节从左到右填充淡蓝色 `#92bce7`。下载结束并准备显示后，整张图替换占位；失败保留尺寸与文字提示。减少动态效果时不播放拉伸。

UI 规范页的滑块与固定百分比仅用于外观演示，不发起真实下载，也不能作为业务进度。生产样式来自 `apps/web/src/styles/image-placeholder.css`，遮罩来自 `apps/web/src/assets/image-placeholder-logo.svg`；运行 `node scripts/build-ui-primitives.mjs` 同步到规范页，不另写一套鱼形、填色或动画。

## 组件来源与维护

- 令牌与 W06：`apps/web/src/assets/main.css`。
- 角形：`apps/web/src/styles/squircle.css`、`squircle-base.css`、`squircle-cards.css`、`squircle-avatars.css`。
- 共享主题：`apps/web/src/lib/theme-preference.ts`；论坛适配 `theme.ts`，静态规范页适配 `ui-theme.ts`。
- 实际外壳：`apps/web/src/components/SiteHeader.tsx`、`SiteFooter.tsx`。
- 页面排版：`apps/web/src/styles/info-page-layout.css`，对照关于页、首页与帖子页实际组件。
- 图形资源：`apps/web/src/assets/badges/`、`apps/web/public/assets/banner/`、`apps/web/public/logo.svg`。
- 静态设计规范页：`apps/web/public/ui.html`；收录清单：`apps/web/public/assets/ui/catalog.json`。
- 运行 `node scripts/build-ui-primitives.mjs` 从论坛主题重新生成规范页令牌与按钮表面。同时生成 `apps/web/public/assets/ui/forum-primitives.css` 和 `theme-init.js`；生成文件不直接修改。

清单按实际用途展示：Banner 横幅、侧栏插画、版块插画、首页排序、帖子类型、版块分类、交易状态、帖子状态、身份、页脚工具、帖子印章、Logo。分类入口与大按钮集中在同一区域，字体、间距与卡片规范置后。不收录表情或通用字体图标库；同一含义的徽章全站保留一版，避免重复展示。已处理与未处理各自使用一枚固定配色 SVG，深浅主题共用；同名旧探索稿删除，不继续作为可下载的替代版本。规范快照与现行源码不一致时，以当前实际组件为准，并更新对应说明。

## 验证与范围

只修改指定页面或组件，保留业务规则与服务开关。素材中出现某项业务不代表该服务当前开放。浏览器只用 Google Chrome，按任务需要检查桌面与约 390px、深浅色、焦点、长文本换行和交互。完成相关格式、类型与构建检查；没有执行的验证不能声称通过。设计修改不自动包含生产发布。

## 功能图标

菜单栏使用白色细线 SVG，默认 18 px。搜索使用单环放大镜，推广使用侧面扩音喇叭。站内功能使用彩色分层 SVG，沿用行内控件尺寸。图标素材在 /ui.html#badges，可按名称检索。
