# Misskey 中文优化


在使用 Misskey 时，碰到一些体验上的小问题，于是 fork 了一份，做些中文阅读和个人偏好上的调整，也加了几套主题。这里记录一下这次的修改。

<!--more-->

## 缘由

Misskey 这个产品做得很好，细节很到位。一个维护了多年的产品，确实还是很有东西。 不过有些地方放到中文环境下，用着不太顺手，有些功能的使用方式也不太好理解。 比如配置备份，同一个账号、同一台设备该怎么用，我对着文档看，也还是有点摸不着头脑 😅

另外，帖子发布后也不能直接编辑，想改内容只能删除后重新发布……也看了 Sharkey 的相关改动，不过考虑到兼容性、改动范围，以及以后和上游同步的维护成本，这些功能还是先不动，界面上只做一些 UI 和阅读体验的调整。

上次安全升级 Node.js 时，我直接在[本地重新打包了 Docker 镜像]({{< relref "posts/醒了就干：给 Docker 里的 Misskey 重打镜像，升级Node.js 安全更新/index.md" >}})。

后来考虑了一下，既然已经要自己打镜像，不如 fork 一份，维护一个自己的分支，把针对中文体验和个人小偏好的修改放进去。这次以 Misskey **2026.10.1** 为基础，也顺便加了一些活泼一点的配色 🎨。复杂的一点没动，方便升级 😅。

## 新加 5 套主题，最喜欢葡萄软糖

这次一共加了五套主题，每套都有浅色和深色版本。原有主题仍然保留，只有新加的主题使用中文名字。最喜欢的还是「葡萄软糖」，默认也用了这套风格。名字有点甜，都是 Codex 起的 😅

下面是本地测试环境的 H5 截图，使用同一组测试内容，左边浅色、右边深色，方便比较。点击图片可以放大查看。

### 蜜桃汽水

这是最早做的一套。浅桃色背景搭配暖白面板，以偏玫红的蜜桃色作为主色，链接用青绿色，整体比较柔和。

{{< style "display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; max-width: 792px; margin: 1.5rem auto; > figure { min-width: 0; margin: 0; } img { width: 100%; height: auto; }" >}}
{{< image src="peach-mobile.jpg" alt="蜜桃汽水浅色主题的手机时间线" width="390" caption="蜜桃汽水 · 浅色" >}}
{{< image src="peach-dark-mobile.jpg" alt="蜜桃汽水深色主题的手机时间线" width="390" caption="蜜桃汽水 · 深色" >}}
{{< /style >}}

### 青柠游乐场

浅黄绿色的页面背景，配接近白色的淡绿面板，按钮和选中状态用青柠绿，再搭一点橙色。整体比较清新，颜色活泼，但大块背景很淡。

{{< style "display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; max-width: 792px; margin: 1.5rem auto; > figure { min-width: 0; margin: 0; } img { width: 100%; height: auto; }" >}}
{{< image src="lime-mobile.jpg" alt="青柠游乐场浅色主题的手机时间线" width="390" caption="青柠游乐场 · 浅色" >}}
{{< image src="lime-dark-mobile.jpg" alt="青柠游乐场深色主题的手机时间线" width="390" caption="青柠游乐场 · 深色" >}}
{{< /style >}}

### 晴空俱乐部

浅蓝底色搭配蓝白面板，以蓝色作为主色，辅以珊瑚红。相比青柠，这套更清爽，按钮和链接的层次也比较明确。

{{< style "display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; max-width: 792px; margin: 1.5rem auto; > figure { min-width: 0; margin: 0; } img { width: 100%; height: auto; }" >}}
{{< image src="sky-mobile.jpg" alt="晴空俱乐部浅色主题的手机时间线" width="390" caption="晴空俱乐部 · 浅色" >}}
{{< image src="sky-dark-mobile.jpg" alt="晴空俱乐部深色主题的手机时间线" width="390" caption="晴空俱乐部 · 深色" >}}
{{< /style >}}

### 葡萄软糖

页面是淡淡的灰粉色，按钮和选中状态保留葡萄紫。帖子和通用面板的底色来回试了几次，最后选了 **`#f8f5f7`**：比之前更白一点，又没有纯白那么亮，带一点纸张的感觉。

正文保持深灰色，紫色主要用来强调操作和选中状态。深色版本则用灰紫底色搭配浅紫色强调色。

{{< style "display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; max-width: 792px; margin: 1.5rem auto; > figure { min-width: 0; margin: 0; } img { width: 100%; height: auto; }" >}}
{{< image src="grape-mobile.jpg" alt="葡萄软糖浅色主题的手机时间线" width="390" caption="葡萄软糖 · 浅色" >}}
{{< image src="grape-dark-mobile.jpg" alt="葡萄软糖深色主题的手机时间线" width="390" caption="葡萄软糖 · 深色" >}}
{{< /style >}}

### 琥珀电台

奶油色背景搭配暖白面板，主色是偏焦糖的琥珀色，链接带一点绿。这套更暖，也有一点复古的感觉，和前面几套的方向不太一样。

{{< style "display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; max-width: 792px; margin: 1.5rem auto; > figure { min-width: 0; margin: 0; } img { width: 100%; height: auto; }" >}}
{{< image src="amber-mobile.jpg" alt="琥珀电台浅色主题的手机时间线" width="390" caption="琥珀电台 · 浅色" >}}
{{< image src="amber-dark-mobile.jpg" alt="琥珀电台深色主题的手机时间线" width="390" caption="琥珀电台 · 深色" >}}
{{< /style >}}

## 其它修改

除了主题，主要还是调整每天刷时间线时能感觉到的细节：

- **中文阅读更松一点。** 中文为主的帖子正文使用 1.5 倍行高，英文保留原来的行距；字号最终回到原版默认，同时使用适合中英文的系统字体回退。
- **减少帖子外围的留白。** 桌面端上下边距调到 18px，手机保留原有间距。时间线保留原有的连续面板和细横线分隔。
- **昵称和正文分得更清楚。** 正文上方留 2px；显示服务器标签时，这段间距放在标签下方。账号和发布时间用次级文字色，正文与昵称保持清晰。左侧导航的文字也不再额外缩小。
- **操作反馈更明显。** 鼠标移到回复、转发等按钮上时，会出现淡淡的圆形背景，图标跟随主题变色。葡萄软糖里就是淡紫底配紫色图标。
- **个人主页补充关系提示。** 关注、被关注、互相关注等关系更容易看清。
- **系统邮件改成中英双语。** 验证、登录提醒、密码重置等邮件，标题统一为“中文 / English”，正文一行中文、一行英文，不用再只看英文或日文猜邮件的用途。

这些修改主要围绕阅读和日常使用。已有的主题与个人偏好会保留，新默认值用于尚未设置的环境。

## Docker 镜像

使用镜像：

```bash
docker pull ghcr.io/yuehei/misskey:2026.10.1
```

这个分支以自用为主，有时间会继续跟进上游的稳定版本，保留这些中文体验和个人偏好的修改。


---

> 作者: [xxd](/authors/xxd/), [Codex](/authors/codex/)  
> URL: https://33.ax/posts/misskey-chinese-ui/