PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.
隔空贴:主题、背景图与 AI(MCP)
方案稿 · 2026-11-06 · 第 1 期已实现;第 3 期(像素主题)提前做了界面部分,切换入口要等第 2 期
- 标「待验证」的条目,要实测或做出原型后再定。
1. 概览
这次一共四项改动:
- 主题:「外观」里可以换主题。首发两套内置主题:
- 默认:就是现在的样子,浅色与深色各一套。
- 像素:颜色、字体、形状、图标、动效整体换成像素风格(第 5 节)。
- 自定义主题:基于任一主题新建,改颜色、圆角、字体,导入与导出主题文件(第 6 节)。
- 背景图:任何主题都可以加背景图,自动保证文字看得清(第 7 节)。
- AI 改主题:新增
pasteferry-cli mcp,AI 通过 MCP 读取主题说明、生成主题、校验、预览并应用(第 9 节)。
实现上:
- 主题由一份带版本号的 JSON 描述(第 3 节)。内置主题、自定义主题、AI 生成的主题都用这一种格式。
- 主题与背景图存在后台服务里,桌面主窗口、快捷粘贴窗口、手机三处共用(第 4 节)。
- 设备之间的协议不变,服务器不变。后台服务的本机接口要加几个字段和 RPC。每一期按新功能升 MINOR。
2. 现状
- 颜色在
ui/lib/theme.dart的AppPalette里:15 个语义颜色,浅色、深色各一套,写死在代码里。页面基本只用context.palette。 - 形状和字体还不能替换:
- 页面里直接写了几十处
BorderRadius.circular(...),还有一些写死的Color(0x…)、Colors.white、阴影,集中在widgets/common.dart、pages/send_page.dart、mobile/ui.dart、widgets/avatar.dart。 - 字号写死在
buildTheme的TextTheme里,字体跟随系统。
- 页面里直接写了几十处
buildTheme有三处调用:桌面main.dart、快捷窗口picker/picker_view.dart、手机mobile/mobile_app.dart。- 图标统一在
ui/lib/icons.dart里按平台挑选。 - 深浅模式只能跟随系统。
- 没有 MCP。最接近的是 2.9 的
pasteferry-cli -json只读查询(design/cli-json.md)。
3. 主题的格式
{
"schema": 1,
"id": "pixel",
"name": { "zh-Hans": "像素", "en": "Pixel", "ja": "ピクセル" },
"base": "default",
"modes": {
"light": { "accent": "#3B5DC9", "background": "#F4F4F4", "surface": "#FFFFFF", "border": "#1A1C2C", "text": "#1A1C2C" },
"dark": { "accent": "#41A6F6", "background": "#1A1C2C", "surface": "#333C57", "border": "#0E0F18", "text": "#F4F4F4" }
},
"typography": { "family": "fusion-pixel-12", "sizes": [12, 24], "pixelSnap": true },
"shape": { "radius": { "sm": 0, "md": 0, "lg": 0 }, "corner": "notch", "borderWidth": 2 },
"elevation": { "shadow": "hard", "offset": [3, 3] },
"motion": "stepped",
"icons": "pixel",
"background": null
}
base继承:只写想改的字段,其余从base补齐。只改一个强调色,也是合法的主题。继承最多两层,不能成环。modes:颜色就是现在AppPalette的 15 个角色,名字不变。只写了一个模式时,另一个模式由它推算(反转明度、保留色相),推算结果同样要过对比度检查。typography:family只能是 App 自带的字体或system;sizes是允许的字号阶梯,像素字体只能用设计字号的整数倍。shape.corner:round(圆角)、square(直角)、notch(像素角:四角各切掉一个方格)。elevation.shadow:soft(现在的投影)、hard(不模糊的偏移投影)、none。motion:smooth(现在的动画)、stepped(逐帧,4 到 6 档)、reduced(尽量不动)。系统开了「减少动态效果」时一律按reduced。icons:system(现在的 Cupertino / Fluent)或pixel。background、scenery、scene:背景图与风景,见第 7 节。- 未知字段忽略,
schema比本机认识的新时拒绝导入并提示升级。
Dart 里对应四个 ThemeExtension,页面代码只读这些名字,不判断当前是什么主题:
| 扩展 | 内容 |
|---|---|
AppPalette |
15 个颜色,加上强调色底上的文字 onAccent、提示条的底 inverse 与文字 onInverse |
AppShape |
三级圆角、投影;第 3 期加角的样式、边框宽度 |
AppTypography |
等宽字体;第 3 期加正文字体与字号阶梯 |
AppMotion |
动画时长与曲线:平滑、逐帧、不做动画 |
三处界面都调用 buildTheme(brightness, spec: …)(手机在它上面调整字号与触控尺寸),spec 是一套主题 AppThemeSpec。
像素字号不改页面:页面里写死的字号有几十处。像素主题经 MediaQuery 换一个 TextScaler,把所有字号吸附到允许的阶梯上,页面代码不用动。
4. 存在哪里
和界面语言一样存在后台服务里:
- 快捷粘贴窗口是单独的进程,要用同一套主题。
- CLI 与 MCP 只能经后台服务修改主题。
- Windows 托盘菜单由后台服务画,以后可以跟着主题变。
本机接口:
Config加theme_id(空字符串表示默认主题)与theme_mode(跟随系统、浅色、深色)。- 自定义主题存在数据目录
themes/<id>.json,背景图存在backgrounds/(第 7.3 节)。 - 新增 RPC:
ListThemes、GetTheme、PutTheme、DeleteTheme、ImportBackground、DeleteBackground。 PutTheme在后台服务里统一校验:格式、字段范围、继承关系,以及对比度(第 8 节)。界面、CLI、MCP 走同一套校验。- 换主题时经
Subscribe推送事件,三处界面立即刷新。 - 主题只在本机,不在设备之间同步。
5. 像素主题
| 方面 | 做法 |
|---|---|
| 颜色 | 16 色的有限调色板(参考 Sweetie 16)。深色「CRT 夜」:深蓝黑底、亮蓝强调色,绿、橙、红表示在线、警告、错误。浅色「纸面」:浅灰白底、黑色描边、钴蓝强调色。 |
| 文字 | 缝合像素字体(Fusion Pixel Font,OFL),12px 版本;等宽版用于配对码与指纹。字号只用 12 与 24,字间距 0,行高取整数像素。英文标题可另用 Silkscreen(OFL)。 |
| 形状 | 圆角全为 0。容器边框 2px 实线,四角切掉 2px 方格(PixelBorder)。阴影向右下偏 3px,不模糊。 |
| 控件 | 方块开关,按格填充的进度条,方格复选框配像素勾,闪烁光标,选中项反色。 |
| 图标 | Pixelarticons(MIT)。icons.dart 里加一套映射,缺的先用原图标。 |
| 动效 | 逐帧;雷达改成按格子扩散。 |
| 背景 | 内置 3 到 4 张平铺小图:星空、网格纸、远山剪影、CRT 扫描线。整数倍放大,不插值。 |
字体体积(待验证):完整的中日文像素字体每种语言可能有几 MB。打算只打包简体与拉丁字母两份,繁体与日文第一次切到像素主题时下载,下载后核对 SHA-256。实测体积可以接受的话就全部打包。
6. 自定义主题
「设置 › 外观」:
- 主题卡片:默认、像素、我的主题。每张卡片是一块真实渲染的小预览。
- 深浅模式:跟随系统、浅色、深色。
- 「基于当前主题新建」:改强调色、背景、文字颜色;圆角选「圆 / 方 / 像素角」;字体选「系统 / 像素」。旁边实时预览,对比度不够时直接提示。
- 导入与导出
.pasteferry-theme文件(第 7.4 节)。 - 字体只能选 App 自带的或
system,不能导入字体文件。
7. 背景图与风景
背景图铺满整个窗口;风景只换掉页面顶部的宽图与侧边栏底部的小图(像素主题在这两处画像素风景与小营地)。两样都是主题的一部分,图片先用 ImportBackground 导入,主题里写 user:<sha256>。2.10.1 起界面才真正显示它们(2.10.0 只有后台服务与 MCP 支持)。
7.1 字段
"background": {
"image": "user:3f9a…c1",
"imageDark": "user:7b20…9e",
"fit": "cover",
"align": "center",
"blur": 12,
"scrim": { "color": "#000000", "opacity": 0.35 },
"surfaceOpacity": 0.82,
"scope": ["main", "mobile"],
"accentFromImage": false
},
"scenery": true,
"scene": {
"header": "user:…", "headerDark": "user:…",
"sidebar": "user:…", "sidebarDark": "user:…"
}
image:user:<sha256>是导入的图;imageDark是深色模式另用的一张,不写时两种模式同一张。asset:<名字>预留给 App 自带的图,现在还没有自带的图,界面不显示,MCP 的格式说明里也不提供。fit:cover、contain、tile。tile只按整数倍放大,不插值(像素画)。blur:0 到 40。0 是原图,20 及以上全用模糊版,中间把模糊版按比例叠在原图上。scrim:盖在图上的一层颜色,不写颜色时用主题的background。浓度不写时取下限(7.2),写了比下限淡时按下限显示。surfaceOpacity:侧边栏与分组面板的不透明度,0.6 到 1,默认 0.85。对话框、菜单、悬停预览不透明。scope:main(主窗口)、picker(快捷粘贴)、mobile(手机)。默认main与mobile:快捷粘贴窗口小,主要用来快速认字。accentFromImage:用图片分析出的第一个主色作强调色,强调色上的字取黑或白里对比度高的。scenery:风景的总开关,默认开。关掉后像素主题也不画像素风景。scene:风景换成的图,任何主题都能用。header铺在页面标题后面(约 180 高,裁切铺满,底部渐隐进页面);sidebar在侧边栏底部(200×96,顶部渐隐进侧边栏)。没写的那一处,像素主题画原来的像素画,其他主题不画。显示整窗背景图时不显示风景。手机 App 没有这两处,不显示风景。
7.2 文字要看得清
- 导入时分析:后台服务算出平均亮度、亮度的标准差、3 到 5 种主色,以及纯白字、纯黑字在 90% 的区域达到 4.5:1 所需的黑、白遮罩浓度(
min_scrim_dark、min_scrim_light)。遮罩按 sRGB 数值叠加来算,与界面画出来的一致;按线性亮度混合会算得偏淡。 - 遮罩下限:界面拿缩到 64 宽的图自己再算一遍(
ui/lib/scrim.dart):用主题的text、textDim,要求在图上、以及隔着半透明的侧边栏与面板都达到 4.5:1,取 95% 的小块都够用的浓度。实际遮罩不会比它淡;「外观」里的「自动」就是它,「更浓」「很浓」在上面加 0.15、0.3。页眉的风景图同样按它加遮罩(面板不透明)。 - 配色:「用图片配色」用分析出的主色作强调色。
浅色模式配深色的图(或反过来)时,遮罩会很浓,图露得少;这时建议用 imageDark 给两种模式各配一张。
7.3 处理与存储
ImportBackground的参数与SetAvatar一样:文件路径或图片数据。返回哈希与分析结果。- 重新编码,去掉 EXIF。很多照片带 GPS 坐标,分享主题时不能把位置带出去。
- 长边最长 3840px。模糊版本导入时就算好、另存一份(长边 960),运行时不做全窗口实时模糊:在 Windows 与 Linux 上很耗显卡。
- 存在
backgrounds/<sha256>.jpg(平铺的小图保留 PNG)。主题还在用(背景或风景)的图不能删;「外观」里换图、移除时,旧图没有主题再用就一并删掉。 - 支持 JPEG、PNG,GIF 取第一帧。WebP、HEIC 不支持。不做动图与视频背景。
- 输入最大 20 MB。
7.4 主题文件
导出的仍是一份 JSON,图片不打包进去,导到别的设备上图片引用找不到会被拒绝。打包成带图片的 .pasteferry-theme(zip)还没做。
7.5 界面
- MaterialApp 的 builder 里套
ThemedBackdrop(ui/lib/widgets/backdrop.dart):背景图、遮罩、内容三层。有背景图时scaffoldBackgroundColor透明,大块面板用context.panel()按surfaceOpacity半透明。主窗口、快捷粘贴窗口、手机 App 各一个,按scope决定显示与否。 - 图片按窗口大小解码一次(长边按 512 取整,拖动窗口时不反复解码)。
- 风景由
SceneHeader、SceneSidebar画:主题换了图画图,否则像素主题画PixelScene、PixelCamp。 - 「外观」里有「风景」与「背景图」两节:选图、更换、恢复或移除;模糊、遮罩、面板各三档;「用图片配色」「快捷粘贴窗口也显示」。AI 通过 MCP 写的任意数值显示为最接近的一档。
- 自带主题不能改:第一次改背景或风景时,先复制一份自带主题并换上,提示「已复制为……」。
- 手机端在「设置 › 外观 › 背景图」里选照片或移除,各设备分开保存。
8. 校验
后台服务对每个主题检查:
- 正文(
text)与background、surface的对比度 ≥ 4.5;textDim≥ 4.5;textFaint只用于提示文字,≥ 3。 - 强调色上的白字(按钮文字)≥ 4.5。
- 有背景图时,按 7.2 节的分析结果,算上遮罩与面板透明度后再检查一遍。
- 不达标的内置主题在 CI 里直接失败;用户与 AI 的主题允许保存,但界面上标出警告,MCP 返回具体哪一对颜色不达标、差多少。
9. AI 与 MCP
新增 pasteferry-cli mcp:stdio 方式的 MCP 服务,复用 CLI 已有的本地 RPC 认证,不开端口。Claude Desktop、Claude Code、Cursor 等在配置里加一行命令即可。
工具:
| 工具 | 作用 |
|---|---|
theme_list |
主题列表与当前主题 |
theme_get |
合并 base 之后的完整主题 |
theme_schema |
JSON Schema,每个字段附说明,例如「separator:容器内行与行之间的分隔线,比 border 浅」。AI 靠它知道每个颜色用在哪里 |
theme_validate |
格式错误与对比度问题,AI 可以自己改后再提交 |
theme_save / theme_apply / theme_delete |
保存、应用、删除 |
theme_preview |
用截图工具的渲染方式,返回几个主要页面的 PNG |
background_import |
只接受本机路径或 base64 数据,不接受网址 |
background_analyze |
亮度、主色、建议的遮罩浓度 |
资源:pasteferry://themes/schema、pasteferry://themes/{id}。
权限:CLI 的 JSON 模式现在拒绝一切修改。MCP 只放开主题与背景图这一类低风险修改。复制记录、设备、好友这类敏感内容不经 MCP 提供;以后要提供,需要设置里单独开关,默认关闭。
10. 分期
| 期 | 内容 | 依赖 |
|---|---|---|
| 1 | 整理主题结构:加 AppThemeSpec、AppShape、AppTypography、AppMotion;三处 buildTheme 统一;页面里写死的圆角、强调色上的白色、投影、等宽字体、过渡动画改为读主题。默认主题的截图与改动前一致。只改界面 |
— |
| 2 | 后台服务:Config 字段、主题 RPC 与校验、背景图导入与分析、切换事件;「外观」里选主题、深浅模式 |
1 |
| 3 | 像素主题:字体与字号吸附、PixelBorder 与边框宽度、像素控件、图标、雷达、内置平铺背景 |
2 |
| 4 | 自定义主题与背景设置:编辑器、导入导出、ThemedBackdrop 与半透明分层 |
2 |
| 5 | MCP:pasteferry-cli mcp、全部工具 |
2 |
第 3、4、5 期互不依赖,可以并行。
像素主题提前做了界面部分(2026-11-06):为了先看到效果,第 3 期在第 2 期之前完成了渲染。还没有切换入口,现在用编译参数试:
flutter run -d macos --dart-define=PASTEFERRY_THEME=pixel
截图工具用 SCREENSHOT_THEME=pixel 渲染像素主题。视觉设计见 design/pixel-theme.md。字体与图标由 tools/pixel-theme/build_assets.py 生成,放在 ui/assets/fonts/,许可证在同一目录。还没做的:见 design/pixel-theme.md 第 11 节,另外繁体与日文的像素字形(现在都用简体字形)、手机端逐页检查。
11. 第 1 期的验证(2026-11-06)
flutter analyze没有问题,flutter test全部通过。- 用
ui/tool/screenshots在改动前后各渲染一次简体中文截图(39 张)。34 张逐字节相同;另 5 张只有相对时间与时刻不同(「40 秒前」与「41 秒前」、18:26 与 18:33),是两次渲染的时间差,其余像素相同。 - 新增
ui/test/theme_test.dart:默认主题的关键值不变;直角、无投影、逐帧的主题能传到按钮、对话框与分段控件;主题之间的过渡正确。 - 留在原处、不跟主题变的颜色:头像底色(按设备区分)、头像上的白字、网页传输二维码的黑白两色(扫码需要)。
- 雷达的扩散动画在 CustomPainter 里,第 3 期换成像素雷达时一起改。