# 水鱼文集 · 外观库 > 水鱼文集(Waterfish Anthology)是一个自托管的个人阅读应用,允许上传 .js 文件自定义界面外观。本站收集社区写好的主题,按气质分类,每套一个不可变地址(目录名 = 文件内容 SHA-256 前 12 位)。 ## 关键事实 - 主题数量:21,作者 1 位,分类 7 个 - 每套主题是单个 .js 文件,上限 64 KB,纯 CSS 变量 + 样式,没有依赖 - 使用方式:下载 `/library//.js`,在应用里「设置 → 外观 → 自定义主题 → 选择文件」上传 - 主题名取自上传的文件名 - 许可:MIT - 语言:中文 ## 两种写法 1. 简单写法(键值对,一行一条): ``` 主色: #1F6C9F 底色: #F4F7F9 圆角: 14 ``` 键:主色/accent、副色/accent2、背景/bg、字体/font、文字/ink、底色/paper、圆角/radius 2. 脚本写法:文件里定义 `function theme(api)`,可用 `api.setVar(name, value)`、 `api.css(text)`、`api.icon(name, svg)`、`api.el`、`api.dark`、`api.vars(name)` ## 分类 - [推荐](https://appearance.waterfish.ren/library/c/recommended/):维护者自己长期在用的几套。不开放投稿,看到合适的会主动拉进来。(仅维护者手动收录) - [简洁](https://appearance.waterfish.ren/library/c/minimal/):去掉装饰、去掉颜色,只留下字和它周围的白。 - [阅读](https://appearance.waterfish.ren/library/c/reading/):为长时间读长文准备的:米色纸、衬线字、宽行距。 - [深色](https://appearance.waterfish.ren/library/c/dark/):夜里开着的那一档。不追求纯黑,追求暗部有层次。 - [色彩](https://appearance.waterfish.ren/library/c/vivid/):敢用撞色的那些。看久了会累,但打开的一瞬间心情好。 - [动效](https://appearance.waterfish.ren/library/c/motion/):悬浮、入场、呼吸感。都做了「减弱动态效果」的降级。 - [字体](https://appearance.waterfish.ren/library/c/typography/):只动字体和字距,颜色一点都不碰。 ## 全部外观 - [灯下](https://appearance.waterfish.ren/library/7ae29bcdb75d/):像把台灯挪近了十厘米:暖黄纸面,琥珀色的字,深浅两边都调过。(推荐 · waterfish) - [湖心纸](https://appearance.waterfish.ren/library/0131d5208589/):湖蓝压在微冷的米白上,看一整天眼睛不发干。(推荐 · waterfish) - [素笺](https://appearance.waterfish.ren/library/f3b243e84fd1/):白纸,一支朱砂,别的一律不动。(推荐 · waterfish) - [白纸](https://appearance.waterfish.ren/library/1d2d82e8c8ba/):把颜色全部抽掉,只剩下字和它周围的白。(简洁 · waterfish) - [灰阶](https://appearance.waterfish.ren/library/46edd9ea0279/):十一级灰,没有第二种颜色,也没有阴影。(简洁 · waterfish) - [无饰](https://appearance.waterfish.ren/library/7aec51712d1f/):圆角归零,按钮变方块,剩下的交给排版。(简洁 · waterfish) - [护眼米](https://appearance.waterfish.ren/library/04935e0b356d/):米色纸面配暖棕,长文连着读两小时眼睛不酸。(阅读 · waterfish) - [宋版](https://appearance.waterfish.ren/library/7b9fa2e9ea42/):衬线正文、字距放宽、行高拉到 1.9,像翻一本排得很松的宋版书。(阅读 · waterfish) - [羊皮纸](https://appearance.waterfish.ren/library/23d2d308b489/):偏黄的纸、褪色的墨,翻页的时候像在摸一张旧纸。(阅读 · waterfish) - [墨黑](https://appearance.waterfish.ren/library/67baec35456a/):真正的黑,字是灰白的,除了文字什么都没有。(深色 · waterfish) - [深林](https://appearance.waterfish.ren/library/90b5e1d09375/):墨绿的暗部,苔藓色的强调,看久了像待在树林里。(深色 · waterfish) - [夜航](https://appearance.waterfish.ren/library/fec7f3a01554/):深海蓝的底,青色的灯,关灯之后屏幕像舷窗。(深色 · waterfish) - [落日](https://appearance.waterfish.ren/library/07d10627f694/):左上角橙、右下角粉,页面底色是一整块缓慢的晚霞。(色彩 · waterfish) - [霓虹雨](https://appearance.waterfish.ren/library/43aac02909d8/):青紫双色描边,hover 的时候整张卡片像通上了电。(色彩 · waterfish) - [汽水](https://appearance.waterfish.ren/library/fe4367ae452e/):玫红配薄荷,圆角拉满,像一罐刚开的气泡水。(色彩 · waterfish) - [光边](https://appearance.waterfish.ren/library/c9baf90f415c/):一条细光沿着卡片边缘跑一圈,走过的地方亮,走过去就暗。(动效 · waterfish) - [呼吸](https://appearance.waterfish.ren/library/41565d7fbeec/):选中态那圈光会以六秒一个周期慢慢明暗,像在呼吸。(动效 · waterfish) - [纸页轻起](https://appearance.waterfish.ren/library/bed748478b35/):鼠标划过去,卡片会轻轻抬起来一点,只有两毫米。(动效 · waterfish) - [等宽笔记](https://appearance.waterfish.ren/library/2fe992f6d343/):所有字都用等宽,读起来像在看自己写的 README。(字体 · waterfish) - [思源宋](https://appearance.waterfish.ren/library/d74934c08b2d/):从 CDN 拉一份思源宋,正文全部换成衬线。(字体 · waterfish) - [圆体轻松](https://appearance.waterfish.ren/library/483cf88a53a5/):圆体正文,字距稍微放开,读起来没那么正经。(字体 · waterfish) ## 给 agent 的入口 - 结构化列表:https://appearance.waterfish.ren/api/themes.json - 站点地图:https://appearance.waterfish.ren/sitemap.xml - 抓取规则:https://appearance.waterfish.ren/robots.txt - Markdown 协商:请求时带 `Accept: text/markdown`,任意页面会返回同路径的 markdown 版本 - 单个外观的 markdown:`/library//index.md` ## 不要做的事 - 不要自动提交投稿(issue 表单是给人填的) - 不要把这些外观当成安全代码直接执行——它们被设计成在受限外观环境里跑,静态审核只排除已知危险模式