Skip to content

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.

docs(site): explain background images and scenery

baiyuzea73990b7b2a5
diff --git a/design/mcp.md b/design/mcp.md
index a89ce24..39f90f6 100644
--- a/design/mcp.md
+++ b/design/mcp.md
@@ -32,7 +32,7 @@
| `theme_save` | `theme` | 保存:`saved`、`id`、`warnings[]` |
| `theme_apply` | `id`,`mode`(可选:system、light、dark) | `current`、`mode`。主窗口、快捷粘贴窗口、手机 App 立即换 |
| `theme_delete` | `id` | `deleted`。删的是正在用的主题时换回默认主题 |
-| `background_import` | `path` 或 `base64`(二选一) | `sha256`、`reference`(`user:<sha256>`,写进主题的 `background.image`)、宽高、格式、`luminance`、`luminance_spread`、`colors[]`、`min_scrim_dark`、`min_scrim_light` |
+| `background_import` | `path` 或 `base64`(二选一) | `sha256`、`reference`(`user:<sha256>`,写进主题的 `background.image`,或风景的 `scene.header`、`scene.sidebar`)、宽高、格式、`luminance`、`luminance_spread`、`colors[]`、`min_scrim_dark`、`min_scrim_light` |
| `background_analyze` | `sha256`(可带 `user:` 前缀) | 与上面相同的分析结果 |
- 工具的说明与参数说明都用英文写,写清每个字段的用途,模型照着就能用。
diff --git a/design/themes.md b/design/themes.md
index 262ff6c..bf85a34 100644
--- a/design/themes.md
+++ b/design/themes.md
@@ -60,7 +60,7 @@
- **`elevation.shadow`**:`soft`(现在的投影)、`hard`(不模糊的偏移投影)、`none`。
- **`motion`**:`smooth`(现在的动画)、`stepped`(逐帧,4 到 6 档)、`reduced`(尽量不动)。系统开了「减少动态效果」时一律按 `reduced`。
- **`icons`**:`system`(现在的 Cupertino / Fluent)或 `pixel`。
-- **`background`**:见第 7 节。
+- **`background`、`scenery`、`scene`**:背景图与风景,见第 7 节。
- 未知字段忽略,`schema` 比本机认识的新时拒绝导入并提示升级。
Dart 里对应四个 `ThemeExtension`,页面代码只读这些名字,不判断当前是什么主题:
@@ -117,13 +117,16 @@ Dart 里对应四个 `ThemeExtension`,页面代码只读这些名字,不判
- 导入与导出 `.pasteferry-theme` 文件(第 7.4 节)。
- 字体只能选 App 自带的或 `system`,不能导入字体文件。
-## 7. 背景图
+## 7. 背景图与风景
+
+背景图铺满整个窗口;风景只换掉页面顶部的宽图与侧边栏底部的小图(像素主题在这两处画像素风景与小营地)。两样都是主题的一部分,图片先用 `ImportBackground` 导入,主题里写 `user:<sha256>`。2.11.0 起界面才真正显示它们(2.10.0 只有后台服务与 MCP 支持)。
### 7.1 字段
```json
"background": {
"image": "user:3f9a…c1",
+ "imageDark": "user:7b20…9e",
"fit": "cover",
"align": "center",
"blur": 12,
@@ -131,43 +134,53 @@ Dart 里对应四个 `ThemeExtension`,页面代码只读这些名字,不判
"surfaceOpacity": 0.82,
"scope": ["main", "mobile"],
"accentFromImage": false
+},
+"scenery": true,
+"scene": {
+ "header": "user:…", "headerDark": "user:…",
+ "sidebar": "user:…", "sidebarDark": "user:…"
}
```
-- `image`:`asset:<名字>` 是内置图,`user:<sha256>` 是用户导入的图。也可以写在 `modes.light` / `modes.dark` 里,两个模式用不同的图。
-- `fit`:`cover`、`contain`、`tile`。`tile` 只按整数倍缩放,并关闭插值。
-- `blur`:0 到 40。
-- `scrim`:盖在图上的一层颜色,用来压暗或提亮。
-- `surfaceOpacity`:侧边栏、分组框、对话框的不透明度,0.6 到 1。
-- `scope`:`main`、`picker`、`mobile`。快捷粘贴窗口默认不显示背景:它很小,主要用来快速认字。
-- `accentFromImage`:用图片的主色作强调色。
+- `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 文字要看得清
-1. **导入时分析**:后台服务算出平均亮度、各区域的亮度差异、3 到 5 种主色,和图片一起保存。
-2. **遮罩下限**:按分析结果与文字颜色,算出遮罩至少多浓,正文才能达到 WCAG AA。用户只能调得更浓。图片很花时,自动提高面板不透明度。
-3. **配色建议**:从主色里给出强调色建议,点一下就用。
+1. **导入时分析**:后台服务算出平均亮度、亮度的标准差、3 到 5 种主色,以及纯白字、纯黑字在 90% 的区域达到 4.5:1 所需的黑、白遮罩浓度(`min_scrim_dark`、`min_scrim_light`)。遮罩按 sRGB 数值叠加来算,与界面画出来的一致;按线性亮度混合会算得偏淡。
+2. **遮罩下限**:界面拿缩到 64 宽的图自己再算一遍(`ui/lib/scrim.dart`):用主题的 `text`、`textDim`,要求在图上、以及隔着半透明的侧边栏与面板都达到 4.5:1,取 95% 的小块都够用的浓度。实际遮罩不会比它淡;「外观」里的「自动」就是它,「更浓」「很浓」在上面加 0.15、0.3。页眉的风景图同样按它加遮罩(面板不透明)。
+3. **配色**:「用图片配色」用分析出的主色作强调色。
+
+浅色模式配深色的图(或反过来)时,遮罩会很浓,图露得少;这时建议用 `imageDark` 给两种模式各配一张。
### 7.3 处理与存储
- `ImportBackground` 的参数与 `SetAvatar` 一样:文件路径或图片数据。返回哈希与分析结果。
- **重新编码,去掉 EXIF**。很多照片带 GPS 坐标,分享主题时不能把位置带出去。
-- 长边最长 3840px。模糊版本导入时就算好、另存一份,**运行时不做全窗口实时模糊**:在 Windows 与 Linux 上很耗显卡。
-- 存在 `backgrounds/<sha256>.jpg`(平铺图保留 PNG)。没有主题再用到的图片自动清理。
-- 支持 JPEG、PNG、WebP,GIF 取第一帧。HEIC 第一版不支持。不做动图与视频背景。
+- 长边最长 3840px。模糊版本导入时就算好、另存一份(长边 960),**运行时不做全窗口实时模糊**:在 Windows 与 Linux 上很耗显卡。
+- 存在 `backgrounds/<sha256>.jpg`(平铺的小图保留 PNG)。主题还在用(背景或风景)的图不能删;「外观」里换图、移除时,旧图没有主题再用就一并删掉。
+- 支持 JPEG、PNG,GIF 取第一帧。WebP、HEIC 不支持。不做动图与视频背景。
- 输入最大 20 MB。
### 7.4 主题文件
-`.pasteferry-theme` 是 zip:`theme.json` 加用到的图片。导入时逐项校验,图片同样重新编码。
+导出的仍是一份 JSON,图片不打包进去,导到别的设备上图片引用找不到会被拒绝。打包成带图片的 `.pasteferry-theme`(zip)还没做。
### 7.5 界面
-- `Shell` 外面套 `ThemedBackdrop`:背景图、遮罩、内容三层。有背景图时 `scaffoldBackgroundColor` 透明。
-- 侧边栏、分组框、对话框按 `surfaceOpacity` 半透明。面板上不加实时模糊;只有侧边栏可以开「毛玻璃」,默认关。
-- 图片按窗口实际尺寸解码一次;窗口大小变化时,等停止拖动再重新解码。
-- 「外观 › 背景」:选图、拖入或粘贴,实时预览,调模糊、遮罩和面板透明度,「用图片配色」。
-- 手机端同样可以设置,各设备分开保存。
+- MaterialApp 的 builder 里套 `ThemedBackdrop`(`ui/lib/widgets/backdrop.dart`):背景图、遮罩、内容三层。有背景图时 `scaffoldBackgroundColor` 透明,大块面板用 `context.panel()` 按 `surfaceOpacity` 半透明。主窗口、快捷粘贴窗口、手机 App 各一个,按 `scope` 决定显示与否。
+- 图片按窗口大小解码一次(长边按 512 取整,拖动窗口时不反复解码)。
+- 风景由 `SceneHeader`、`SceneSidebar` 画:主题换了图画图,否则像素主题画 `PixelScene`、`PixelCamp`。
+- 「外观」里有「风景」与「背景图」两节:选图、更换、恢复或移除;模糊、遮罩、面板各三档;「用图片配色」「快捷粘贴窗口也显示」。AI 通过 MCP 写的任意数值显示为最接近的一档。
+- 自带主题不能改:第一次改背景或风景时,先复制一份自带主题并换上,提示「已复制为……」。
+- 手机端在「设置 › 外观 › 背景图」里选照片或移除,各设备分开保存。
## 8. 校验
diff --git a/docs/assets/screenshots/bg-appearance-background-dark.png b/docs/assets/screenshots/bg-appearance-background-dark.png
new file mode 100644
index 0000000..d64bc01
Binary files /dev/null and b/docs/assets/screenshots/bg-appearance-background-dark.png differ
diff --git a/docs/assets/screenshots/bg-history-dark.png b/docs/assets/screenshots/bg-history-dark.png
new file mode 100644
index 0000000..1ec7c63
Binary files /dev/null and b/docs/assets/screenshots/bg-history-dark.png differ
diff --git a/docs/assets/screenshots/bg-scene-history-dark.png b/docs/assets/screenshots/bg-scene-history-dark.png
new file mode 100644
index 0000000..490f5b1
Binary files /dev/null and b/docs/assets/screenshots/bg-scene-history-dark.png differ
diff --git a/docs/assets/screenshots/en/bg-appearance-background-dark.png b/docs/assets/screenshots/en/bg-appearance-background-dark.png
new file mode 100644
index 0000000..0c26a85
Binary files /dev/null and b/docs/assets/screenshots/en/bg-appearance-background-dark.png differ
diff --git a/docs/assets/screenshots/en/bg-history-dark.png b/docs/assets/screenshots/en/bg-history-dark.png
new file mode 100644
index 0000000..95239a0
Binary files /dev/null and b/docs/assets/screenshots/en/bg-history-dark.png differ
diff --git a/docs/assets/screenshots/en/bg-scene-history-dark.png b/docs/assets/screenshots/en/bg-scene-history-dark.png
new file mode 100644
index 0000000..096d47e
Binary files /dev/null and b/docs/assets/screenshots/en/bg-scene-history-dark.png differ
diff --git a/docs/assets/screenshots/ja/bg-appearance-background-dark.png b/docs/assets/screenshots/ja/bg-appearance-background-dark.png
new file mode 100644
index 0000000..7c6147b
Binary files /dev/null and b/docs/assets/screenshots/ja/bg-appearance-background-dark.png differ
diff --git a/docs/assets/screenshots/ja/bg-history-dark.png b/docs/assets/screenshots/ja/bg-history-dark.png
new file mode 100644
index 0000000..b36c4b9
Binary files /dev/null and b/docs/assets/screenshots/ja/bg-history-dark.png differ
diff --git a/docs/assets/screenshots/ja/bg-scene-history-dark.png b/docs/assets/screenshots/ja/bg-scene-history-dark.png
new file mode 100644
index 0000000..b6ed710
Binary files /dev/null and b/docs/assets/screenshots/ja/bg-scene-history-dark.png differ
diff --git a/docs/assets/screenshots/zh-hk/bg-appearance-background-dark.png b/docs/assets/screenshots/zh-hk/bg-appearance-background-dark.png
new file mode 100644
index 0000000..9eeb90c
Binary files /dev/null and b/docs/assets/screenshots/zh-hk/bg-appearance-background-dark.png differ
diff --git a/docs/assets/screenshots/zh-hk/bg-history-dark.png b/docs/assets/screenshots/zh-hk/bg-history-dark.png
new file mode 100644
index 0000000..86c582d
Binary files /dev/null and b/docs/assets/screenshots/zh-hk/bg-history-dark.png differ
diff --git a/docs/assets/screenshots/zh-hk/bg-scene-history-dark.png b/docs/assets/screenshots/zh-hk/bg-scene-history-dark.png
new file mode 100644
index 0000000..0d4434d
Binary files /dev/null and b/docs/assets/screenshots/zh-hk/bg-scene-history-dark.png differ
diff --git a/docs/assets/screenshots/zh-tw/bg-appearance-background-dark.png b/docs/assets/screenshots/zh-tw/bg-appearance-background-dark.png
new file mode 100644
index 0000000..13c43e8
Binary files /dev/null and b/docs/assets/screenshots/zh-tw/bg-appearance-background-dark.png differ
diff --git a/docs/assets/screenshots/zh-tw/bg-history-dark.png b/docs/assets/screenshots/zh-tw/bg-history-dark.png
new file mode 100644
index 0000000..b4b2064
Binary files /dev/null and b/docs/assets/screenshots/zh-tw/bg-history-dark.png differ
diff --git a/docs/assets/screenshots/zh-tw/bg-scene-history-dark.png b/docs/assets/screenshots/zh-tw/bg-scene-history-dark.png
new file mode 100644
index 0000000..1095ef6
Binary files /dev/null and b/docs/assets/screenshots/zh-tw/bg-scene-history-dark.png differ
diff --git a/docs/en/themes/index.html b/docs/en/themes/index.html
index c6bbdf1..7c4c09d 100644
--- a/docs/en/themes/index.html
+++ b/docs/en/themes/index.html
@@ -104,6 +104,21 @@
<ol class="steps"><li>In <b>Settings › Appearance</b>, hover over a theme, click <b>⋯</b> and choose <b>Duplicate</b>. The copy appears under Custom.</li><li>In the copy’s <b>⋯</b> menu, choose <b>Export…</b> to save a <code>.pasteferry-theme.json</code> file.</li><li>Change the colors, name and so on in any text editor (the format is described below).</li><li>Back on the Appearance page, click <b>Import theme…</b> and choose the file. A theme with the same id is replaced, and the imported theme is applied.</li><li>To remove a custom theme, choose <b>Delete theme</b> in its <b>⋯</b> menu. Built-in themes can’t be deleted.</li></ol>
<p class="note">Text contrast is checked when a theme is saved. Hard-to-read colors are pointed out, but you can still save. Theme files can be shared: the other person just imports it.</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>Use a background image</h2>
+ <ol class="steps"><li>Open <b>Settings › Appearance</b>, scroll to <b>Background image</b>, click <b>Choose Image…</b> and pick a JPEG, PNG or GIF.</li><li>The image fills the window behind the sidebar and pages, and the sidebar and lists become translucent. If a built-in theme is in use, a copy is made first; the built-in theme itself stays the same.</li><li><b>Blur</b>, <b>Scrim</b> and <b>Panels</b> have three steps each. <b>Use image colors</b> takes the accent color from the image, and <b>Also show in Quick Paste</b> shows it there too.</li><li>Click <b>Remove</b> to go back. On Android, pick a photo under <b>Settings › Appearance › Background image</b>.</li></ol>
+ <p class="note">Text always stays readable: PasteFerry works out how strong the scrim must be for the theme&#x27;s text colors on this image and never shows it lighter. Dark images with dark mode, and light images with light mode, show the most of the picture.</p>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/en/bg-history-dark.png?v=f0dce04080" width="2112" height="1472" loading="lazy" alt="Pixel theme in dark mode with a sunset hills background: the sidebar and list are translucent and the picture shows through">
+ <img src="../../assets/screenshots/en/bg-appearance-background-dark.png?v=e0e6e129df" width="2112" height="1472" loading="lazy" alt="Settings › Appearance › Background image: change, remove, three steps for blur, scrim and panels, use image colors, also show in Quick Paste">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>Change the scenery</h2>
+ <div class="os-grid"><ol class="steps"><li>The scenery is the wide picture at the top of pages and the small one at the bottom of the sidebar. The pixel theme draws a pixel landscape and a small camp there; other themes have none.</li><li>Under <b>Settings › Appearance › Scenery</b>, click <b>Choose Image…</b> next to <b>Page header</b> or <b>Sidebar bottom</b> to use your own pictures, with any theme. A scrim is added under the page title so it stays readable.</li><li><b>Reset</b> brings back the original; turn off <b>Show scenery</b> to hide both. Scenery is hidden while a background image fills the window.</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/en/bg-scene-history-dark.png?v=9038deb323" width="2112" height="1472" loading="lazy" alt="Pixel theme in dark mode with the page header and sidebar bottom replaced by a sunset hills picture"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>What a theme file looks like</h2>
<p class="intro">A theme is a JSON file. Write only what you want to change; everything else comes from the theme named in <code>base</code>. This one starts from Pixel and changes the accent and a few backgrounds:</p>
@@ -121,7 +136,7 @@
}</code></pre>
</div>
<h3>Common fields</h3>
- <dl class="fields"><dt><code>id</code></dt><dd>The theme’s identifier: lowercase letters, digits and <code>-</code>. It can’t be <code>default</code> or <code>pixel</code>.</dd><dt><code>name</code></dt><dd>The name in each language, such as <code>zh-Hans</code>, <code>zh-Hant-TW</code>, <code>zh-Hant-HK</code>, <code>en</code> and <code>ja</code>.</dd><dt><code>base</code></dt><dd>The theme to start from: <code>default</code>, <code>pixel</code> or another custom theme.</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>Colors for light and dark, as <code>#RRGGBB</code> or <code>#AARRGGBB</code> with alpha. Common ones: <code>accent</code>, <code>background</code> (content area), <code>sidebar</code>, <code>surface</code> (groups and dialogs), <code>border</code>, <code>text</code>, <code>textDim</code>, <code>textFaint</code> and <code>onAccent</code> (text on the accent).</dd><dt><code>typography</code></dt><dd>Fonts: <code>family</code> is <code>system</code> or the built-in pixel font <code>FusionPixel</code>.</dd><dt><code>shape</code></dt><dd>Shapes: <code>corner</code> is <code>round</code> or <code>pixel</code> (notched), plus radii, border width and shadow style.</dd><dt><code>motion</code>, <code>icons</code></dt><dd>Motion <code>smooth</code> / <code>stepped</code> / <code>reduced</code>; icons <code>system</code> / <code>pixel</code>.</dd></dl>
+ <dl class="fields"><dt><code>id</code></dt><dd>The theme’s identifier: lowercase letters, digits and <code>-</code>. It can’t be <code>default</code> or <code>pixel</code>.</dd><dt><code>name</code></dt><dd>The name in each language, such as <code>zh-Hans</code>, <code>zh-Hant-TW</code>, <code>zh-Hant-HK</code>, <code>en</code> and <code>ja</code>.</dd><dt><code>base</code></dt><dd>The theme to start from: <code>default</code>, <code>pixel</code> or another custom theme.</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>Colors for light and dark, as <code>#RRGGBB</code> or <code>#AARRGGBB</code> with alpha. Common ones: <code>accent</code>, <code>background</code> (content area), <code>sidebar</code>, <code>surface</code> (groups and dialogs), <code>border</code>, <code>text</code>, <code>textDim</code>, <code>textFaint</code> and <code>onAccent</code> (text on the accent).</dd><dt><code>typography</code></dt><dd>Fonts: <code>family</code> is <code>system</code> or the built-in pixel font <code>FusionPixel</code>.</dd><dt><code>shape</code></dt><dd>Shapes: <code>corner</code> is <code>round</code> or <code>pixel</code> (notched), plus radii, border width and shadow style.</dd><dt><code>motion</code>, <code>icons</code></dt><dd>Motion <code>smooth</code> / <code>stepped</code> / <code>reduced</code>; icons <code>system</code> / <code>pixel</code>.</dd><dt><code>background</code></dt><dd>Window background image: <code>image</code> (<code>user:&lt;sha256&gt;</code> after importing), <code>blur</code>, <code>scrim</code>, <code>surfaceOpacity</code> (panel opacity), <code>scope</code> (which windows show it), <code>accentFromImage</code>.</dd><dt><code>scenery</code>, <code>scene</code></dt><dd>Scenery on/off, and your own pictures: <code>scene.header</code> (page header) and <code>scene.sidebar</code> (sidebar bottom), with optional <code>headerDark</code> and <code>sidebarDark</code> for dark mode.</dd></dl>
<p class="note">The full format and where each color is used: <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">design/themes.md</a></p>
</div></section>
<section class="section" id="ai"><div class="wrap official-copy">
@@ -150,15 +165,15 @@
</div>
<p class="note">Restart the AI app after changing its configuration. Keep PasteFerry running: the AI changes themes through its background service on this computer.</p>
<h3>3. Say what you want</h3>
- <ul class="prompts"><li>“Make me a cyberpunk theme with neon pink and deep purple, then apply it.”</li><li>“Start from the Pixel theme and make a sunset version with a warmer dark background.”</li><li>“The gray text in my current theme is hard to read. Make it lighter.”</li><li>“Export my theme so I can see it, then make a light version.”</li></ul>
+ <ul class="prompts"><li>“Make me a cyberpunk theme with neon pink and deep purple, then apply it.”</li><li>“Start from the Pixel theme and make a sunset version with a warmer dark background.”</li><li>“The gray text in my current theme is hard to read. Make it lighter.”</li><li>“Export my theme so I can see it, then make a light version.”</li><li>“Use ~/Pictures/beach.jpg as the background and match the colors to the photo.”</li><li>“Replace the pixel theme&#x27;s header landscape with ~/Pictures/mountains.png.”</li></ul>
<h3>What the AI can do</h3>
- <ul><li>list themes and read a theme in full;</li><li>read the theme format: where each color is used and the contrast it needs;</li><li>check a theme without saving it, to find colors with too little contrast;</li><li>save, apply and delete custom themes, and switch light and dark;</li><li>import an image from this computer as a background and analyze its brightness and main colors.</li></ul>
+ <ul><li>list themes and read a theme in full;</li><li>read the theme format: where each color is used and the contrast it needs;</li><li>check a theme without saving it, to find colors with too little contrast;</li><li>save, apply and delete custom themes, and switch light and dark;</li><li>Import a picture from this computer as a window background or scenery, and analyze its brightness and main colors.</li></ul>
<h3>What it can’t do</h3>
<p>The MCP server runs only on this computer and opens no network port. It can read and write themes and background images only: it can’t see your history, devices or friends, or change other settings. Background images must be local files; nothing is downloaded from the internet.</p>
</div></section>
<section class="section" id="faq"><div class="wrap official-copy">
<h2>Questions</h2>
- <div class="faq"><details><summary>Are themes synced to my other devices?</summary><p>No. A theme applies only to the device you set it on. To use the same theme elsewhere, export it and import it there.</p></details><details><summary>The AI made a mess of my theme. How do I go back?</summary><p>Choose Default or Pixel in Settings › Appearance. Delete custom themes you don’t want.</p></details><details><summary>Importing says some text may be hard to read.</summary><p>Some text and background colors have low contrast. Lighten or darken those colors as suggested, or ask the AI to fix them.</p></details><details><summary>Do older versions support themes?</summary><p>You need 2.10 or later. The device protocol is unchanged, so old and new versions still work together.</p></details></div>
+ <div class="faq"><details><summary>Are themes synced to my other devices?</summary><p>No. A theme applies only to the device you set it on. To use the same theme elsewhere, export it and import it there.</p></details><details><summary>The AI made a mess of my theme. How do I go back?</summary><p>Choose Default or Pixel in Settings › Appearance. Delete custom themes you don’t want.</p></details><details><summary>Importing says some text may be hard to read.</summary><p>Some text and background colors have low contrast. Lighten or darken those colors as suggested, or ask the AI to fix them.</p></details><details><summary>Do older versions support themes?</summary><p>You need 2.10 or later. The device protocol is unchanged, so old and new versions still work together.</p></details><details><summary>Will text be hard to read on my picture?</summary><p>No. The scrim strength is worked out from the theme&#x27;s text colors and is never lighter than needed. For a busy picture, raise the blur or panel opacity.</p></details></div>
<p class="note">More:<a href="https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.md">Let an AI make a theme (full guide)</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">Theme format and design</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/mcp.md">MCP tools</a></p>
</div></section>
</main>
diff --git a/docs/ja/themes/index.html b/docs/ja/themes/index.html
index 9fe6c0c..612314f 100644
--- a/docs/ja/themes/index.html
+++ b/docs/ja/themes/index.html
@@ -104,6 +104,21 @@
<ol class="steps"><li><b>設定 › 外観</b> でテーマにポインタを合わせ、<b>⋯</b> から <b>複製</b> を選びます。複製は「カスタム」に表示されます。</li><li>複製の <b>⋯</b> から <b>書き出す…</b> を選び、<code>.pasteferry-theme.json</code> ファイルを保存します。</li><li>テキストエディタで色や名前などを変えます(形式は次の節を参照)。</li><li>外観のページに戻り、<b>テーマを読み込む…</b> でファイルを選びます。同じ id のテーマは置き換えられ、読み込んだテーマが適用されます。</li><li>不要なカスタムテーマは <b>⋯</b> から <b>テーマを削除</b> を選びます。内蔵テーマは削除できません。</li></ol>
<p class="note">保存時に文字のコントラストを確認し、読みにくい色を知らせます(そのまま保存もできます)。テーマファイルは共有でき、相手は読み込むだけで使えます。</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>背景画像を使う</h2>
+ <ol class="steps"><li><b>設定 › 外観</b> を開き、<b>背景画像</b> までスクロールして <b>画像を選択…</b> を押し、JPEG、PNG、GIF を選びます。</li><li>画像がサイドバーとページの後ろに敷かれ、サイドバーとリストの下地は半透明になります。内蔵テーマを使っているときは、先に複製してから変更します(内蔵テーマ自体は変わりません)。</li><li><b>ぼかし</b>、<b>スクリム</b>、<b>パネル</b> はそれぞれ 3 段階。<b>画像の色を使う</b> でアクセントカラーを画像の主な色に、<b>クイックペーストにも表示</b> でそちらにも表示します。</li><li>やめるときは <b>削除</b>。Android では <b>設定 › 外観 › 背景画像</b> で写真を選びます。</li></ol>
+ <p class="note">文字は常に読みやすいまま:テーマの文字色とこの画像から必要なスクリムの濃さを計算し、それより薄くはしません。暗い画像はダークモード、明るい画像はライトモードと組み合わせると画像がよく見えます。</p>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/ja/bg-history-dark.png?v=7dd6b082b3" width="2112" height="1472" loading="lazy" alt="ダークモードのピクセルテーマに夕焼けの山の背景画像:サイドバーとリストが半透明で、画像が透けて見える">
+ <img src="../../assets/screenshots/ja/bg-appearance-background-dark.png?v=2060fbb4ee" width="2112" height="1472" loading="lazy" alt="設定 › 外観 › 背景画像:変更、削除、ぼかし・スクリム・パネルの 3 段階、画像の色を使う、クイックペーストにも表示">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>風景を変える</h2>
+ <div class="os-grid"><ol class="steps"><li>風景とは、ページ上部の横長の画像とサイドバー下部の小さな画像です。ピクセルテーマではピクセルの風景と小さなキャンプを描き、ほかのテーマにはありません。</li><li><b>設定 › 外観 › 風景</b> で <b>ページ上部</b>、<b>サイドバー下部</b> の <b>画像を選択…</b> を押すと自分の画像に変えられます(どのテーマでも可)。ページタイトルが読めるようにスクリムを自動で重ねます。</li><li><b>元に戻す</b> で元の絵に、<b>風景を表示</b> をオフにすると両方とも消えます。ウインドウ全体の背景画像があるときは風景を表示しません。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/ja/bg-scene-history-dark.png?v=61a2dacfce" width="2112" height="1472" loading="lazy" alt="ダークモードのピクセルテーマ:ページ上部とサイドバー下部を夕焼けの山の画像に変えたところ"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>テーマファイルの中身</h2>
<p class="intro">テーマは JSON ファイルです。変えたいところだけ書けば、残りは <code>base</code> のテーマから補われます。次の例はピクセルをもとに、アクセントといくつかの背景色だけを変えています。</p>
@@ -121,7 +136,7 @@
}</code></pre>
</div>
<h3>よく使う項目</h3>
- <dl class="fields"><dt><code>id</code></dt><dd>テーマの識別子。小文字、数字、<code>-</code> のみで、<code>default</code> と <code>pixel</code> は使えません。</dd><dt><code>name</code></dt><dd>各言語の名前。<code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code> など。</dd><dt><code>base</code></dt><dd>もとにするテーマ:<code>default</code>、<code>pixel</code>、またはほかのカスタムテーマ。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>ライトとダークの色。<code>#RRGGBB</code> か透明度付きの <code>#AARRGGBB</code>。よく使うのは <code>accent</code>、<code>background</code>(内容の背景)、<code>sidebar</code>、<code>surface</code>(グループとダイアログ)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(アクセント上の文字)。</dd><dt><code>typography</code></dt><dd>フォント:<code>family</code> は <code>system</code> か内蔵のピクセルフォント <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形:<code>corner</code> は <code>round</code>(角丸)か <code>pixel</code>(切り欠き)。角の大きさ、枠の太さ、影の種類も指定できます。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動き <code>smooth</code> / <code>stepped</code> / <code>reduced</code>、アイコン <code>system</code> / <code>pixel</code>。</dd></dl>
+ <dl class="fields"><dt><code>id</code></dt><dd>テーマの識別子。小文字、数字、<code>-</code> のみで、<code>default</code> と <code>pixel</code> は使えません。</dd><dt><code>name</code></dt><dd>各言語の名前。<code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code> など。</dd><dt><code>base</code></dt><dd>もとにするテーマ:<code>default</code>、<code>pixel</code>、またはほかのカスタムテーマ。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>ライトとダークの色。<code>#RRGGBB</code> か透明度付きの <code>#AARRGGBB</code>。よく使うのは <code>accent</code>、<code>background</code>(内容の背景)、<code>sidebar</code>、<code>surface</code>(グループとダイアログ)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(アクセント上の文字)。</dd><dt><code>typography</code></dt><dd>フォント:<code>family</code> は <code>system</code> か内蔵のピクセルフォント <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形:<code>corner</code> は <code>round</code>(角丸)か <code>pixel</code>(切り欠き)。角の大きさ、枠の太さ、影の種類も指定できます。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動き <code>smooth</code> / <code>stepped</code> / <code>reduced</code>、アイコン <code>system</code> / <code>pixel</code>。</dd><dt><code>background</code></dt><dd>ウインドウ全体の背景画像:<code>image</code>(読み込み後の <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>、<code>surfaceOpacity</code>(パネルの不透明度)、<code>scope</code>(表示するウインドウ)、<code>accentFromImage</code>。</dd><dt><code>scenery</code>、<code>scene</code></dt><dd>風景のオン・オフと自分の画像:<code>scene.header</code>(ページ上部)、<code>scene.sidebar</code>(サイドバー下部)。ダークモード用に <code>headerDark</code>、<code>sidebarDark</code> も指定できます。</dd></dl>
<p class="note">完全な形式と各色の使われる場所: <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">design/themes.md</a></p>
</div></section>
<section class="section" id="ai"><div class="wrap official-copy">
@@ -150,15 +165,15 @@
</div>
<p class="note">設定を変えたら AI アプリを再起動します。PasteFerry は起動したままにしてください。AI はこのパソコンのバックグラウンドサービスを通じてテーマを変えます。</p>
<h3>3. ほしいものを伝える</h3>
- <ul class="prompts"><li>“ネオンピンクと深い紫のサイバーパンク風テーマを作って、適用して。”</li><li>“ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。”</li><li>“今のテーマの灰色の文字が読みにくいので、明るくして。”</li><li>“今のテーマを書き出して見せて。それからライト版も作って。”</li></ul>
+ <ul class="prompts"><li>“ネオンピンクと深い紫のサイバーパンク風テーマを作って、適用して。”</li><li>“ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。”</li><li>“今のテーマの灰色の文字が読みにくいので、明るくして。”</li><li>“今のテーマを書き出して見せて。それからライト版も作って。”</li><li>“~/Pictures/beach.jpg を背景にして、写真の色に合わせたテーマを作って。”</li><li>“ピクセルテーマの上部の風景を ~/Pictures/mountains.png に変えて。”</li></ul>
<h3>AI ができること</h3>
- <ul><li>テーマの一覧と、テーマの完全な内容の読み取り</li><li>テーマ形式の説明(各色の使われる場所と必要なコントラスト)の読み取り</li><li>保存せずに確認し、コントラストが足りない色を見つける</li><li>カスタムテーマの保存・適用・削除、ライトとダークの切り替え</li><li>このパソコンの画像を背景として読み込み、明るさと主な色を分析</li></ul>
+ <ul><li>テーマの一覧と、テーマの完全な内容の読み取り</li><li>テーマ形式の説明(各色の使われる場所と必要なコントラスト)の読み取り</li><li>保存せずに確認し、コントラストが足りない色を見つける</li><li>カスタムテーマの保存・適用・削除、ライトとダークの切り替え</li><li>このコンピュータの画像を読み込み、ウインドウの背景や風景に設定し、明るさと主な色を分析する。</li></ul>
<h3>できないこと</h3>
<p>MCP サーバーはこのパソコンの中だけで動き、ネットワークのポートは開きません。扱えるのはテーマと背景画像だけで、履歴、デバイス、友だちは見えず、ほかの設定も変えられません。背景画像はローカルのファイルのみで、インターネットからは取得しません。</p>
</div></section>
<section class="section" id="faq"><div class="wrap official-copy">
<h2>よくある質問</h2>
- <div class="faq"><details><summary>テーマはほかのデバイスに同期されますか?</summary><p>されません。テーマは設定したデバイスだけに適用されます。別のパソコンで使うときは、書き出して読み込んでください。</p></details><details><summary>AI がテーマを崩してしまいました。</summary><p>設定 › 外観 でデフォルトかピクセルを選べば戻ります。不要なカスタムテーマは削除できます。</p></details><details><summary>読み込み時に「読みにくい」と表示されます。</summary><p>文字と背景のコントラストが低いところがあります。表示に従って色を明るく・暗くするか、AI に直してもらってください。</p></details><details><summary>古いバージョンでもテーマは使えますか?</summary><p>2.10 以降が必要です。デバイス間のプロトコルは変わっていないので、新旧のバージョンは引き続き連携できます。</p></details></div>
+ <div class="faq"><details><summary>テーマはほかのデバイスに同期されますか?</summary><p>されません。テーマは設定したデバイスだけに適用されます。別のパソコンで使うときは、書き出して読み込んでください。</p></details><details><summary>AI がテーマを崩してしまいました。</summary><p>設定 › 外観 でデフォルトかピクセルを選べば戻ります。不要なカスタムテーマは削除できます。</p></details><details><summary>読み込み時に「読みにくい」と表示されます。</summary><p>文字と背景のコントラストが低いところがあります。表示に従って色を明るく・暗くするか、AI に直してもらってください。</p></details><details><summary>古いバージョンでもテーマは使えますか?</summary><p>2.10 以降が必要です。デバイス間のプロトコルは変わっていないので、新旧のバージョンは引き続き連携できます。</p></details><details><summary>画像の上で文字が読みにくくならない?</summary><p>なりません。スクリムの濃さはテーマの文字色から計算し、必要より薄くはしません。にぎやかな画像なら、ぼかしやパネルの不透明度を上げてください。</p></details></div>
<p class="note">さらに詳しく:<a href="https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.md">AI でテーマを作る(詳しいガイド)</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">テーマの形式と設計</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/mcp.md">MCP ツール</a></p>
</div></section>
</main>
diff --git a/docs/themes/index.html b/docs/themes/index.html
index 26007fe..e7f0306 100644
--- a/docs/themes/index.html
+++ b/docs/themes/index.html
@@ -104,6 +104,21 @@
<ol class="steps"><li>在 <b>设置 › 外观</b> 里,鼠标移到一张主题卡片上,点右下角的 <b>⋯</b>,选 <b>复制一份</b>。新主题出现在「自定义」里。</li><li>在副本的 <b>⋯</b> 里选 <b>导出…</b>,得到一个 <code>.pasteferry-theme.json</code> 文件。</li><li>用任意文本编辑器改里面的颜色、名字等(格式见下一节)。</li><li>回到外观页,点 <b>导入主题…</b> 选这个文件。同一个 id 会覆盖原来那份,导入后自动应用。</li><li>不要的自定义主题,在 <b>⋯</b> 里选 <b>删除主题</b>。自带主题不能删除。</li></ol>
<p class="note">保存时会检查文字和背景的对比度。看不清的颜色会提示出来,但仍然可以保存。主题文件可以发给朋友,对方导入即可。</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>换背景图</h2>
+ <ol class="steps"><li>进入 <b>设置 › 外观</b>,滚到 <b>背景图</b>,点 <b>选择图片…</b>,选一张 JPEG、PNG 或 GIF。</li><li>图片铺满侧边栏和页面后面,侧边栏和列表底板变成半透明。正在用自带主题时,会先复制一份再改,自带主题本身不变。</li><li><b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三档;<b>用图片配色</b> 把强调色换成图片的主色;也可以让 <b>快捷粘贴窗口也显示</b>。</li><li>不想要了点 <b>移除</b>。手机上在 <b>设置 › 外观 › 背景图</b> 里选照片。</li></ol>
+ <p class="note">文字始终看得清:隔空贴按主题的文字颜色和这张图,算出遮罩至少要多浓,只会比它更浓。深色的图配深色模式、浅色的图配浅色模式,图露得最多。</p>
+ <div class="f-pair">
+ <img src="../assets/screenshots/bg-history-dark.png?v=43710a00b1" width="2112" height="1472" loading="lazy" alt="像素主题深色模式铺了一张落日山景的背景图:侧边栏和列表半透明,图从后面透出来">
+ <img src="../assets/screenshots/bg-appearance-background-dark.png?v=56d20aff81" width="2112" height="1472" loading="lazy" alt="设置 › 外观 › 背景图:更换、移除,模糊、遮罩、面板三档,用图片配色,快捷粘贴窗口也显示">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>换风景</h2>
+ <div class="os-grid"><ol class="steps"><li>风景是页面顶部那条宽图和侧边栏底部的小图。像素主题这里默认画像素风景和小营地,其他主题默认没有。</li><li>在 <b>设置 › 外观 › 风景</b> 里,<b>页面顶部</b>、<b>侧边栏底部</b> 各点 <b>选择图片…</b> 换成自己的图,任何主题都能用。页面标题会自动盖一层遮罩,字照样看得清。</li><li><b>恢复默认</b> 换回原来的样子;关掉 <b>显示风景</b> 两处都不画。设置了整窗背景图时不显示风景。</li></ol>
+ <figure class="shot"><img src="../assets/screenshots/bg-scene-history-dark.png?v=981f8af26c" width="2112" height="1472" loading="lazy" alt="像素主题深色模式:页面顶部和侧边栏底部换成了落日山景的图"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>主题文件长什么样</h2>
<p class="intro">主题是一份 JSON。只写想改的地方就行,没写的从 <code>base</code> 指定的主题补齐。下面这份以像素主题为底,只换了强调色和几处底色:</p>
@@ -121,7 +136,7 @@
}</code></pre>
</div>
<h3>常用字段</h3>
- <dl class="fields"><dt><code>id</code></dt><dd>主题的标识,只能用小写字母、数字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各语言的名字,比如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主题为底:<code>default</code>、<code>pixel</code> 或另一套自定义主题。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>浅色、深色两套颜色,写成 <code>#RRGGBB</code> 或带透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(强调色)、<code>background</code>(内容区底色)、<code>sidebar</code>、<code>surface</code>(分组与对话框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(强调色上的文字)。</dd><dt><code>typography</code></dt><dd>字体:<code>family</code> 可选 <code>system</code> 或自带的像素字体 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形状:<code>corner</code> 是 <code>round</code>(圆角)或 <code>pixel</code>(像素切角),还有圆角大小、边框粗细、投影样式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>动效 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;图标 <code>system</code> / <code>pixel</code>。</dd></dl>
+ <dl class="fields"><dt><code>id</code></dt><dd>主题的标识,只能用小写字母、数字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各语言的名字,比如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主题为底:<code>default</code>、<code>pixel</code> 或另一套自定义主题。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>浅色、深色两套颜色,写成 <code>#RRGGBB</code> 或带透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(强调色)、<code>background</code>(内容区底色)、<code>sidebar</code>、<code>surface</code>(分组与对话框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(强调色上的文字)。</dd><dt><code>typography</code></dt><dd>字体:<code>family</code> 可选 <code>system</code> 或自带的像素字体 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形状:<code>corner</code> 是 <code>round</code>(圆角)或 <code>pixel</code>(像素切角),还有圆角大小、边框粗细、投影样式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>动效 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;图标 <code>system</code> / <code>pixel</code>。</dd><dt><code>background</code></dt><dd>整窗背景图:<code>image</code>(导入后的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些窗口显示)、<code>accentFromImage</code>。</dd><dt><code>scenery</code>、<code>scene</code></dt><dd>风景开关,以及换成自己的图:<code>scene.header</code>(页面顶部)、<code>scene.sidebar</code>(侧边栏底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。</dd></dl>
<p class="note">完整的格式与每个颜色用在哪里: <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">design/themes.md</a></p>
</div></section>
<section class="section" id="ai"><div class="wrap official-copy">
@@ -150,15 +165,15 @@
</div>
<p class="note">改完配置后重启 AI 应用。隔空贴要保持运行,AI 通过它在本机的后台服务改主题。</p>
<h3>3. 直接说你想要什么</h3>
- <ul class="prompts"><li>“帮我做一套赛博朋克风的主题,霓虹粉配深紫,然后应用上。”</li><li>“以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。”</li><li>“现在这套主题的灰色文字看不清,帮我调亮一点。”</li><li>“把我的主题导出给我看看,再做一个浅色版本。”</li></ul>
+ <ul class="prompts"><li>“帮我做一套赛博朋克风的主题,霓虹粉配深紫,然后应用上。”</li><li>“以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。”</li><li>“现在这套主题的灰色文字看不清,帮我调亮一点。”</li><li>“把我的主题导出给我看看,再做一个浅色版本。”</li><li>“用 ~/Pictures/海边.jpg 当背景,按照片的颜色配一套主题。”</li><li>“把像素主题顶部的风景换成 ~/Pictures/雪山.png。”</li></ul>
<h3>AI 能做什么</h3>
- <ul><li>列出主题、读取某套主题的完整内容;</li><li>读取主题格式说明:每个颜色用在哪里、要和谁达到多少对比度;</li><li>只校验不保存,看看哪对颜色对比度不够;</li><li>保存、应用、删除自定义主题,切换浅色深色;</li><li>导入本机的一张图片作为背景,并分析亮度和主色。</li></ul>
+ <ul><li>列出主题、读取某套主题的完整内容;</li><li>读取主题格式说明:每个颜色用在哪里、要和谁达到多少对比度;</li><li>只校验不保存,看看哪对颜色对比度不够;</li><li>保存、应用、删除自定义主题,切换浅色深色;</li><li>导入本机的图片,设为整窗背景图或换掉风景,并分析亮度和主色。</li></ul>
<h3>安全范围</h3>
<p>MCP 服务只在本机运行,不开网络端口。它只能读写主题和背景图,看不到复制记录、设备和好友,也不能改其他设置;背景图只接受本机文件,不会去网上下载。</p>
</div></section>
<section class="section" id="faq"><div class="wrap official-copy">
<h2>常见问题</h2>
- <div class="faq"><details><summary>主题会同步到我的其他设备吗?</summary><p>不会。主题只用于设置它的那台设备。想在别的电脑上用同一套,导出再导入即可。</p></details><details><summary>AI 把主题改乱了怎么办?</summary><p>在 设置 › 外观 里点回 默认 或 像素 就恢复了;不要的自定义主题可以删除。</p></details><details><summary>导入时提示文字可能看不清?</summary><p>说明有几处文字和底色的对比度偏低。可以照提示改亮或改暗对应的颜色,也可以直接让 AI 帮你调。</p></details><details><summary>旧版本能用主题吗?</summary><p>需要 2.10 或更新的版本。设备之间的协议没有变化,新旧版本照常互传。</p></details></div>
+ <div class="faq"><details><summary>主题会同步到我的其他设备吗?</summary><p>不会。主题只用于设置它的那台设备。想在别的电脑上用同一套,导出再导入即可。</p></details><details><summary>AI 把主题改乱了怎么办?</summary><p>在 设置 › 外观 里点回 默认 或 像素 就恢复了;不要的自定义主题可以删除。</p></details><details><summary>导入时提示文字可能看不清?</summary><p>说明有几处文字和底色的对比度偏低。可以照提示改亮或改暗对应的颜色,也可以直接让 AI 帮你调。</p></details><details><summary>旧版本能用主题吗?</summary><p>需要 2.10 或更新的版本。设备之间的协议没有变化,新旧版本照常互传。</p></details><details><summary>图放上去字会看不清吗?</summary><p>不会。遮罩浓度按主题的文字颜色算,只会比需要的更浓。图太花可以调高模糊或面板不透明度。</p></details></div>
<p class="note">更多:<a href="https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.zh-CN.md">让 AI 帮你做主题(详细说明)</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">主题格式与设计</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/mcp.md">MCP 工具说明</a></p>
</div></section>
</main>
diff --git a/docs/zh-hk/themes/index.html b/docs/zh-hk/themes/index.html
index fe34552..4cf28c3 100644
--- a/docs/zh-hk/themes/index.html
+++ b/docs/zh-hk/themes/index.html
@@ -104,6 +104,21 @@
<ol class="steps"><li>在 <b>設定 › 外觀</b> 裏,滑鼠移到一張主題卡片上,按右下角的 <b>⋯</b>,選 <b>複製一份</b>。新主題出現在「自訂」裏。</li><li>在副本的 <b>⋯</b> 裏選 <b>匯出…</b>,得到一個 <code>.pasteferry-theme.json</code> 檔案。</li><li>用任何文字編輯器修改裏面的顏色、名稱等(格式見下一節)。</li><li>回到外觀頁,按 <b>匯入主題…</b> 選這個檔案。同一個 id 會覆蓋原來那份,匯入後自動套用。</li><li>不要的自訂主題,在 <b>⋯</b> 裏選 <b>刪除主題</b>。內置主題不能刪除。</li></ol>
<p class="note">儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>換背景圖</h2>
+ <ol class="steps"><li>進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,按 <b>選擇圖片…</b>,揀一張 JPEG、PNG 或 GIF。</li><li>圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內置主題時,會先複製一份再改,內置主題本身不變。</li><li><b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;亦可以讓 <b>快速貼上視窗也顯示</b>。</li><li>唔想要就按 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裏揀相片。</li></ol>
+ <p class="note">文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,計出遮罩最少要幾濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。</p>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/zh-hk/bg-history-dark.png?v=89f9be0b94" width="2112" height="1472" loading="lazy" alt="像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來">
+ <img src="../../assets/screenshots/zh-hk/bg-appearance-background-dark.png?v=9c16d0ff2f" width="2112" height="1472" loading="lazy" alt="設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>換風景</h2>
+ <div class="os-grid"><ol class="steps"><li>風景是頁面頂部那條闊圖和側邊欄底部的小圖。像素主題這裏預設畫像素風景和小營地,其他主題預設沒有。</li><li>在 <b>設定 › 外觀 › 風景</b> 裏,<b>頁面頂部</b>、<b>側邊欄底部</b> 各按 <b>選擇圖片…</b> 換成自己的圖,任何主題都可以用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。</li><li><b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/zh-hk/bg-scene-history-dark.png?v=2e34144b33" width="2112" height="1472" loading="lazy" alt="像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>主題檔案是怎樣的</h2>
<p class="intro">主題是一份 JSON。只寫想改的地方就可以,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:</p>
@@ -121,7 +136,7 @@
}</code></pre>
</div>
<h3>常用欄位</h3>
- <dl class="fields"><dt><code>id</code></dt><dd>主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>淺色、深色兩套顏色,寫成 <code>#RRGGBB</code> 或帶透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(強調色)、<code>background</code>(內容區底色)、<code>sidebar</code>、<code>surface</code>(分組與對話框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(強調色上的文字)。</dd><dt><code>typography</code></dt><dd>字型:<code>family</code> 可選 <code>system</code> 或內置的像素字型 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗幼、陰影樣式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。</dd></dl>
+ <dl class="fields"><dt><code>id</code></dt><dd>主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>淺色、深色兩套顏色,寫成 <code>#RRGGBB</code> 或帶透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(強調色)、<code>background</code>(內容區底色)、<code>sidebar</code>、<code>surface</code>(分組與對話框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(強調色上的文字)。</dd><dt><code>typography</code></dt><dd>字型:<code>family</code> 可選 <code>system</code> 或內置的像素字型 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗幼、陰影樣式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。</dd><dt><code>background</code></dt><dd>整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。</dd><dt><code>scenery</code>、<code>scene</code></dt><dd>風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。</dd></dl>
<p class="note">完整的格式與每個顏色用在哪裏: <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">design/themes.md</a></p>
</div></section>
<section class="section" id="ai"><div class="wrap official-copy">
@@ -150,15 +165,15 @@
</div>
<p class="note">改完設定後重新啟動 AI 應用程式。隔空貼要保持運行,AI 透過它在本機的背景服務修改主題。</p>
<h3>3. 直接說你想要甚麼</h3>
- <ul class="prompts"><li>“幫我做一套賽博朋克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li></ul>
+ <ul class="prompts"><li>“幫我做一套賽博朋克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li><li>“用 ~/Pictures/海邊.jpg 做背景,按相片的顏色配一套主題。”</li><li>“把像素主題頂部的風景換成 ~/Pictures/雪山.png。”</li></ul>
<h3>AI 能做甚麼</h3>
- <ul><li>列出主題、讀取某套主題的完整內容;</li><li>讀取主題格式說明:每個顏色用在哪裏、要和誰達到多少對比度;</li><li>只檢查不儲存,看看哪對顏色對比度不夠;</li><li>儲存、套用、刪除自訂主題,切換淺色深色;</li><li>匯入本機的一張圖片作為背景,並分析亮度和主色。</li></ul>
+ <ul><li>列出主題、讀取某套主題的完整內容;</li><li>讀取主題格式說明:每個顏色用在哪裏、要和誰達到多少對比度;</li><li>只檢查不儲存,看看哪對顏色對比度不夠;</li><li>儲存、套用、刪除自訂主題,切換淺色深色;</li><li>匯入本機的圖片,設為整個視窗的背景圖或換掉風景,並分析亮度和主色。</li></ul>
<h3>安全範圍</h3>
<p>MCP 服務只在本機運行,不開網絡連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網上下載。</p>
</div></section>
<section class="section" id="faq"><div class="wrap official-copy">
<h2>常見問題</h2>
- <div class="faq"><details><summary>主題會同步到我的其他裝置嗎?</summary><p>不會。主題只用於設定它的那部裝置。想在別部電腦上用同一套,匯出再匯入即可。</p></details><details><summary>AI 把主題改亂了怎麼辦?</summary><p>在 設定 › 外觀 裏按回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。</p></details><details><summary>匯入時提示文字可能看不清楚?</summary><p>代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。</p></details><details><summary>舊版本能用主題嗎?</summary><p>需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。</p></details></div>
+ <div class="faq"><details><summary>主題會同步到我的其他裝置嗎?</summary><p>不會。主題只用於設定它的那部裝置。想在別部電腦上用同一套,匯出再匯入即可。</p></details><details><summary>AI 把主題改亂了怎麼辦?</summary><p>在 設定 › 外觀 裏按回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。</p></details><details><summary>匯入時提示文字可能看不清楚?</summary><p>代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。</p></details><details><summary>舊版本能用主題嗎?</summary><p>需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。</p></details><details><summary>圖放上去字會唔會睇唔清?</summary><p>唔會。遮罩濃度按主題的文字顏色計,只會比需要的更濃。圖太花可以調高模糊或面板不透明度。</p></details></div>
<p class="note">更多:<a href="https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.zh-CN.md">讓 AI 幫你做主題(詳細說明)</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">主題格式與設計</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/mcp.md">MCP 工具說明</a></p>
</div></section>
</main>
diff --git a/docs/zh-tw/themes/index.html b/docs/zh-tw/themes/index.html
index d8b30ad..034a308 100644
--- a/docs/zh-tw/themes/index.html
+++ b/docs/zh-tw/themes/index.html
@@ -104,6 +104,21 @@
<ol class="steps"><li>在 <b>設定 › 外觀</b> 裡,滑鼠移到一張主題卡片上,點右下角的 <b>⋯</b>,選 <b>複製一份</b>。新主題出現在「自訂」裡。</li><li>在副本的 <b>⋯</b> 裡選 <b>匯出…</b>,得到一個 <code>.pasteferry-theme.json</code> 檔案。</li><li>用任何文字編輯器修改裡面的顏色、名稱等(格式見下一節)。</li><li>回到外觀頁,點 <b>匯入主題…</b> 選這個檔案。同一個 id 會覆蓋原來那份,匯入後自動套用。</li><li>不要的自訂主題,在 <b>⋯</b> 裡選 <b>刪除主題</b>。內建主題不能刪除。</li></ol>
<p class="note">儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>換背景圖</h2>
+ <ol class="steps"><li>進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,點 <b>選擇圖片…</b>,選一張 JPEG、PNG 或 GIF。</li><li>圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內建主題時,會先複製一份再改,內建主題本身不變。</li><li><b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;也可以讓 <b>快速貼上視窗也顯示</b>。</li><li>不想要了點 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裡選照片。</li></ol>
+ <p class="note">文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,算出遮罩至少要多濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。</p>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/zh-tw/bg-history-dark.png?v=de96258d3b" width="2112" height="1472" loading="lazy" alt="像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來">
+ <img src="../../assets/screenshots/zh-tw/bg-appearance-background-dark.png?v=56dbd80f6d" width="2112" height="1472" loading="lazy" alt="設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>換風景</h2>
+ <div class="os-grid"><ol class="steps"><li>風景是頁面頂部那條寬圖和側邊欄底部的小圖。像素主題這裡預設畫像素風景和小營地,其他主題預設沒有。</li><li>在 <b>設定 › 外觀 › 風景</b> 裡,<b>頁面頂部</b>、<b>側邊欄底部</b> 各點 <b>選擇圖片…</b> 換成自己的圖,任何主題都能用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。</li><li><b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/zh-tw/bg-scene-history-dark.png?v=c2dfa93fce" width="2112" height="1472" loading="lazy" alt="像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>主題檔案長什麼樣</h2>
<p class="intro">主題是一份 JSON。只寫想改的地方就好,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:</p>
@@ -121,7 +136,7 @@
}</code></pre>
</div>
<h3>常用欄位</h3>
- <dl class="fields"><dt><code>id</code></dt><dd>主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>淺色、深色兩套顏色,寫成 <code>#RRGGBB</code> 或帶透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(強調色)、<code>background</code>(內容區底色)、<code>sidebar</code>、<code>surface</code>(分組與對話框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(強調色上的文字)。</dd><dt><code>typography</code></dt><dd>字型:<code>family</code> 可選 <code>system</code> 或內建的像素字型 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗細、陰影樣式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。</dd></dl>
+ <dl class="fields"><dt><code>id</code></dt><dd>主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。</dd><dt><code>name</code></dt><dd>各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。</dd><dt><code>base</code></dt><dd>以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。</dd><dt><code>modes.light</code> / <code>modes.dark</code></dt><dd>淺色、深色兩套顏色,寫成 <code>#RRGGBB</code> 或帶透明度的 <code>#AARRGGBB</code>。常用的有 <code>accent</code>(強調色)、<code>background</code>(內容區底色)、<code>sidebar</code>、<code>surface</code>(分組與對話框)、<code>border</code>、<code>text</code>、<code>textDim</code>、<code>textFaint</code>、<code>onAccent</code>(強調色上的文字)。</dd><dt><code>typography</code></dt><dd>字型:<code>family</code> 可選 <code>system</code> 或內建的像素字型 <code>FusionPixel</code>。</dd><dt><code>shape</code></dt><dd>形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗細、陰影樣式。</dd><dt><code>motion</code>、<code>icons</code></dt><dd>動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。</dd><dt><code>background</code></dt><dd>整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。</dd><dt><code>scenery</code>、<code>scene</code></dt><dd>風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。</dd></dl>
<p class="note">完整的格式與每個顏色用在哪裡: <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">design/themes.md</a></p>
</div></section>
<section class="section" id="ai"><div class="wrap official-copy">
@@ -150,15 +165,15 @@
</div>
<p class="note">改完設定後重新啟動 AI 應用程式。隔空貼要保持執行,AI 透過它在本機的背景服務修改主題。</p>
<h3>3. 直接說你想要什麼</h3>
- <ul class="prompts"><li>“幫我做一套賽博龐克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li></ul>
+ <ul class="prompts"><li>“幫我做一套賽博龐克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li><li>“用 ~/Pictures/海邊.jpg 當背景,按照片的顏色配一套主題。”</li><li>“把像素主題頂部的風景換成 ~/Pictures/雪山.png。”</li></ul>
<h3>AI 能做什麼</h3>
- <ul><li>列出主題、讀取某套主題的完整內容;</li><li>讀取主題格式說明:每個顏色用在哪裡、要和誰達到多少對比度;</li><li>只檢查不儲存,看看哪對顏色對比度不夠;</li><li>儲存、套用、刪除自訂主題,切換淺色深色;</li><li>匯入本機的一張圖片作為背景,並分析亮度和主色。</li></ul>
+ <ul><li>列出主題、讀取某套主題的完整內容;</li><li>讀取主題格式說明:每個顏色用在哪裡、要和誰達到多少對比度;</li><li>只檢查不儲存,看看哪對顏色對比度不夠;</li><li>儲存、套用、刪除自訂主題,切換淺色深色;</li><li>匯入本機的圖片,設為整個視窗的背景圖或換掉風景,並分析亮度和主色。</li></ul>
<h3>安全範圍</h3>
<p>MCP 服務只在本機執行,不開網路連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網路上下載。</p>
</div></section>
<section class="section" id="faq"><div class="wrap official-copy">
<h2>常見問題</h2>
- <div class="faq"><details><summary>主題會同步到我的其他裝置嗎?</summary><p>不會。主題只用於設定它的那台裝置。想在別台電腦上用同一套,匯出再匯入即可。</p></details><details><summary>AI 把主題改亂了怎麼辦?</summary><p>在 設定 › 外觀 裡點回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。</p></details><details><summary>匯入時提示文字可能看不清楚?</summary><p>代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。</p></details><details><summary>舊版本能用主題嗎?</summary><p>需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。</p></details></div>
+ <div class="faq"><details><summary>主題會同步到我的其他裝置嗎?</summary><p>不會。主題只用於設定它的那台裝置。想在別台電腦上用同一套,匯出再匯入即可。</p></details><details><summary>AI 把主題改亂了怎麼辦?</summary><p>在 設定 › 外觀 裡點回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。</p></details><details><summary>匯入時提示文字可能看不清楚?</summary><p>代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。</p></details><details><summary>舊版本能用主題嗎?</summary><p>需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。</p></details><details><summary>圖放上去字會看不清楚嗎?</summary><p>不會。遮罩濃度按主題的文字顏色算,只會比需要的更濃。圖太花可以調高模糊或面板不透明度。</p></details></div>
<p class="note">更多:<a href="https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.zh-CN.md">讓 AI 幫你做主題(詳細說明)</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/themes.md">主題格式與設計</a> · <a href="https://github.com/baiyuze/pasteferry/blob/main/design/mcp.md">MCP 工具說明</a></p>
</div></section>
</main>
diff --git a/guide/ai-themes.md b/guide/ai-themes.md
index 2c71c61..7f01571 100644
--- a/guide/ai-themes.md
+++ b/guide/ai-themes.md
@@ -63,6 +63,8 @@ Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` in a proje
- "Make a matcha green theme based on the default one, light and dark, with readable text."
- "Change the pixel theme's accent to coral, save it as a new theme and use it."
- "Use ~/Pictures/beach.jpg as the background and match the colors to the photo."
+- "Replace the pixel theme's header landscape with ~/Pictures/mountains.png and put ~/Pictures/cat.png at the bottom of the sidebar."
+- "The background is too busy: blur it a little and make the panels less see-through."
- "Delete the theme you just made."
Themes made by AI appear in Settings → Appearance next to the built-in ones, so you can switch back at any time.
@@ -75,6 +77,12 @@ Open PasteFerry (or check in Settings that the background service is running), t
**The AI reports low contrast**
PasteFerry checks that body and secondary text reach 4.5:1 against the background, hint text 3:1, and button text 4.5:1 against the button. Ask the AI to adjust those colors. The theme saves anyway, but that text may be hard to read.
+**Background image or scenery?**
+A background image (`background`) fills the whole window, and the sidebar and lists become translucent so it shows through. Scenery (`scene`) only replaces the wide picture at the top of pages and the small one at the bottom of the sidebar, where the pixel theme draws its landscape and camp; nothing else changes. Scenery is hidden while a background image shows. You can change both yourself in Settings → Appearance, without AI.
+
+**Will text stay readable on my picture?**
+Yes. PasteFerry works out how strong the scrim over the picture must be for the theme's text colors and never shows it lighter; the AI or you can only make it stronger. Dark pictures with dark mode, and light pictures with light mode, let more of the picture show.
+
**Can I use an image from the web?**
Not by URL. Download the image first, then give the AI the file. The image is re-encoded on import, so location data from photos is not kept.
diff --git a/guide/ai-themes.zh-CN.md b/guide/ai-themes.zh-CN.md
index 746d912..272f315 100644
--- a/guide/ai-themes.zh-CN.md
+++ b/guide/ai-themes.zh-CN.md
@@ -63,6 +63,8 @@ claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/paste
- 「基于默认主题做一套抹茶绿的主题,浅色和深色都要,文字要看得清。」
- 「把像素主题的强调色换成珊瑚橙,存成一套新主题并用上。」
- 「用 ~/Pictures/海边.jpg 当背景,按照片的颜色配一套主题。」
+- 「把像素主题顶部的风景换成 ~/Pictures/雪山.png,侧边栏底下放 ~/Pictures/猫.png。」
+- 「背景图太花了,模糊一点,面板也不要那么透。」
- 「删掉刚才那套主题。」
AI 做好的主题会出现在「设置 → 外观」里,和内置主题放在一起,随时可以换回来。
@@ -75,6 +77,12 @@ AI 做好的主题会出现在「设置 → 外观」里,和内置主题放在
**AI 说某些颜色对比度不够**
这是隔空贴的检查:正文和说明文字与背景的对比度要达到 4.5:1,提示文字 3:1,按钮上的字与按钮 4.5:1。让 AI 按警告调深或调浅那几个颜色即可;不改也能保存,只是那几处字可能看不清。
+**背景图和风景有什么不同**
+背景图(`background`)铺满整个窗口,侧边栏和列表底板变成半透明,让图透出来;风景(`scene`)只换掉页面顶部那条宽图和侧边栏底部的小图,其他地方不变,像素主题原来的像素风景、小营地就在这两处。有整窗背景图时不显示风景。两样都可以在「设置 → 外观」里自己换,不用 AI。
+
+**图放上去字会不会看不清**
+不会。隔空贴按主题的文字颜色和这张图算出遮罩至少要多浓,比这个淡时按这个浓度显示;AI 或你只能调得更浓。深色的图配深色模式、浅色的图配浅色模式,图会露得更多。
+
**能不能用网上的图片当背景**
不能直接给网址。先把图片下载到电脑上,再让 AI 用这个文件。导入时会重新编码,照片里的拍摄位置等信息不会保留。
diff --git a/tools/screenshots/background/blur.img b/tools/screenshots/background/blur.img
new file mode 100644
index 0000000..03371dd
Binary files /dev/null and b/tools/screenshots/background/blur.img differ
diff --git a/tools/screenshots/background/info.json b/tools/screenshots/background/info.json
new file mode 100644
index 0000000..a579a5b
--- /dev/null
+++ b/tools/screenshots/background/info.json
@@ -0,0 +1,17 @@
+{
+ "SHA256": "85bb7c7be92c5092a0fa31d8506384bb4a63886f0571574a271e07dca900d3ed",
+ "Width": 1920,
+ "Height": 1200,
+ "Format": "jpeg",
+ "Luminance": 0.094,
+ "LuminanceSpread": 0.12,
+ "Colors": [
+ "#683070",
+ "#2E1C4B",
+ "#AC4677",
+ "#D66469",
+ "#EF915D"
+ ],
+ "MinScrimDark": 0.107,
+ "MinScrimLight": 0.389
+}
diff --git a/tools/screenshots/background/pixelscape.py b/tools/screenshots/background/pixelscape.py
new file mode 100644
index 0000000..4324a61
--- /dev/null
+++ b/tools/screenshots/background/pixelscape.py
@@ -0,0 +1,56 @@
+# 截图用的背景图:像素风的落日山景,240×150 画好再按 8 倍放大(无插值),写成 PPM。
+# 是程序画的原创图,可以放进官网截图。用法:
+# python3 pixelscape.py scape.ppm 8 && ffmpeg -i scape.ppm scape.png
+# 再用后台服务的 ImportBackground 导入(重新编码、算模糊版与分析结果),得到这个目录里的
+# sharp.img、blur.img 与 info.json。
+import math, random, sys
+W, H = 240, 150
+random.seed(7)
+sky = [(43,27,74),(74,40,104),(122,52,120),(178,71,122),(222,104,104),(245,158,91),(255,206,140)]
+bayer = [[0,8,2,10],[12,4,14,6],[3,11,1,9],[15,7,13,5]]
+img = [[(0,0,0)]*W for _ in range(H)]
+for y in range(H):
+ t = y / (H*0.78) * (len(sky)-1)
+ for x in range(W):
+ i = min(int(t + (bayer[y%4][x%4]/16 - 0.5)), len(sky)-1)
+ img[y][x] = sky[max(i,0)]
+# 太阳
+cx, cy, r = 168, 92, 20
+for y in range(H):
+ for x in range(W):
+ if (x-cx)**2 + (y-cy)**2 <= r*r and (y < cy-6 or (y-cy) % 4 != 0):
+ img[y][x] = (255, 228, 160)
+# 星星
+for _ in range(40):
+ x, y = random.randrange(W), random.randrange(40)
+ img[y][x] = (255, 236, 200)
+def ridge(base, amp, freq, seed, color, dither=None):
+ random.seed(seed)
+ ph = [random.random()*6 for _ in range(3)]
+ for x in range(W):
+ h = base - amp*(0.6*math.sin(x*freq+ph[0]) + 0.3*math.sin(x*freq*2.3+ph[1]) + 0.15*math.sin(x*freq*5.1+ph[2]))
+ h = int(round(h/2)*2)
+ for y in range(max(h,0), H):
+ c = color
+ if dither and y < h+3 and (x+y) % 2 == 0:
+ c = dither
+ img[y][x] = c
+ridge(100, 22, 0.035, 1, (96,48,108), (140,64,120))
+ridge(116, 16, 0.05, 2, (62,34,84), (96,48,108))
+ridge(132, 10, 0.08, 3, (34,22,56), (62,34,84))
+# 松树
+random.seed(11)
+for _ in range(26):
+ x0 = random.randrange(W); top = random.randrange(128, 140); hgt = random.randrange(8, 14)
+ for k in range(hgt):
+ w = k//2
+ for dx in range(-w, w+1):
+ if 0 <= x0+dx < W and top+k < H: img[top+k][x0+dx] = (22,16,38)
+S = int(sys.argv[2]) if len(sys.argv) > 2 else 8
+with open(sys.argv[1], 'wb') as f:
+ f.write(b'P6 %d %d 255\n' % (W*S, H*S))
+ for y in range(H):
+ row = bytearray()
+ for x in range(W):
+ row += bytes(img[y][x]) * S
+ f.write(bytes(row) * S)
diff --git a/tools/screenshots/background/scene-theme.json b/tools/screenshots/background/scene-theme.json
new file mode 100644
index 0000000..aa274a6
--- /dev/null
+++ b/tools/screenshots/background/scene-theme.json
@@ -0,0 +1,16 @@
+{
+ "schema": 1,
+ "id": "pixel-sunset-scene",
+ "name": {
+ "zh-Hans": "落日营地",
+ "zh-Hant-TW": "落日營地",
+ "zh-Hant-HK": "落日營地",
+ "en": "Sunset Camp",
+ "ja": "夕焼けキャンプ"
+ },
+ "base": "pixel",
+ "scene": {
+ "header": "user:85bb7c7be92c5092a0fa31d8506384bb4a63886f0571574a271e07dca900d3ed",
+ "sidebar": "user:85bb7c7be92c5092a0fa31d8506384bb4a63886f0571574a271e07dca900d3ed"
+ }
+}
diff --git a/tools/screenshots/background/sharp.img b/tools/screenshots/background/sharp.img
new file mode 100644
index 0000000..0b0fd34
Binary files /dev/null and b/tools/screenshots/background/sharp.img differ
diff --git a/tools/screenshots/background/theme.json b/tools/screenshots/background/theme.json
new file mode 100644
index 0000000..6c004df
--- /dev/null
+++ b/tools/screenshots/background/theme.json
@@ -0,0 +1,18 @@
+{
+ "schema": 1,
+ "id": "pixel-sunset-photo",
+ "name": {
+ "zh-Hans": "落日山景",
+ "zh-Hant-TW": "落日山景",
+ "zh-Hant-HK": "落日山景",
+ "en": "Sunset Hills",
+ "ja": "夕焼けの山"
+ },
+ "base": "pixel",
+ "background": {
+ "image": "user:85bb7c7be92c5092a0fa31d8506384bb4a63886f0571574a271e07dca900d3ed",
+ "fit": "cover",
+ "align": "bottom",
+ "blur": 0
+ }
+}
diff --git a/tools/screenshots/render-background.sh b/tools/screenshots/render-background.sh
new file mode 100755
index 0000000..fc9a973
--- /dev/null
+++ b/tools/screenshots/render-background.sh
@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# 官网主题教程里「背景图」「风景」两节的截图:像素主题加一张图(background/ 里程序画的落日山景),
+# 铺满整个窗口或只换掉风景。各语言输出到 docs/assets/screenshots/(及 zh-tw/、zh-hk/、en/、ja/)
+# 下的 bg-*.png。
+#
+# ./tools/screenshots/render-background.sh
+#
+# 需要的环境与 render.sh 相同。
+set -euo pipefail
+cd "$(dirname "$0")/../.."
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+python3 tools/screenshots/prepare_fonts.py "$TMP/fonts" >/dev/null
+BG=$PWD/tools/screenshots/background
+
+for lang in zh zh-tw zh-hk en ja; do
+ out=docs/assets/screenshots
+ [ "$lang" = zh ] || out="$out/$lang"
+ echo "▶ 背景图截图(${lang})"
+ rm -rf "$TMP/raw" "$TMP/framed"
+ # theme.json:整窗背景图;scene-theme.json:只把风景(页眉与侧边栏底部)换成这张图
+ shoot() { # 主题文件, 截图名, 输出前缀
+ rm -rf "$TMP/raw" "$TMP/framed"
+ (cd ui && SCREENSHOT_THEME_FILE="$BG/$1" SCREENSHOT_BACKGROUND="$BG" SCREENSHOT_OUT="$TMP/raw" \
+ SCREENSHOT_FONTS="$TMP/fonts" SCREENSHOT_LANG="$lang" \
+ flutter test tool/screenshots/screenshots_test.dart --plain-name "$2" 2>&1 | tail -1)
+ swift tools/screenshots/frame.swift "$TMP/raw" "$TMP/framed" >/dev/null
+ mkdir -p "$out"
+ cp "$TMP/framed/$2.png" "$out/$3$2.png"
+ }
+ shoot theme.json history-dark bg-
+ shoot theme.json appearance-background-dark bg-
+ shoot scene-theme.json history-dark bg-scene-
+done
diff --git a/tools/site/build.py b/tools/site/build.py
index b255ea5..0832a2e 100644
--- a/tools/site/build.py
+++ b/tools/site/build.py
@@ -2950,7 +2950,7 @@ def privacy_page(code: str) -> str:
def themes_page(code: str) -> str:
- """主题教程:换主题、做自己的主题、主题文件格式、让 AI 通过 MCP 做主题。文案在 content/themes.py"""
+ """主题教程:换主题、做自己的主题、背景图与风景、主题文件格式、让 AI 通过 MCP 做主题。文案在 content/themes.py"""
c = load(code)
t = THEMES_COPY[code]
path = LANGS[code][0]
@@ -2992,6 +2992,21 @@ def themes_page(code: str) -> str:
<ol class="steps">{ol(t['custom_steps'])}</ol>
<p class="note">{esc(t['custom_note'])}</p>
</div></section>
+ <section class="section" id="background"><div class="wrap official-copy">
+ <h2>{esc(t['bg_title'])}</h2>
+ <ol class="steps">{ol(t['bg_steps'])}</ol>
+ <p class="note">{esc(t['bg_note'])}</p>
+ <div class="f-pair">
+ <img src="{shots}bg-history-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(t['bg_alt'])}">
+ <img src="{shots}bg-appearance-background-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(t['bg_alt2'])}">
+ </div>
+ </div></section>
+ <section class="section" id="scenery"><div class="wrap">
+ <h2>{esc(t['scene_title'])}</h2>
+ <div class="os-grid"><ol class="steps">{ol(t['scene_steps'])}</ol>
+ <figure class="shot"><img src="{shots}bg-scene-history-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(t['scene_alt'])}"></figure>
+ </div>
+ </div></section>
<section class="section" id="format"><div class="wrap official-copy">
<h2>{esc(t['file_title'])}</h2>
<p class="intro">{t['file_intro']}</p>
diff --git a/tools/site/content/themes.py b/tools/site/content/themes.py
index 7bc569c..d3c24f0 100644
--- a/tools/site/content/themes.py
+++ b/tools/site/content/themes.py
@@ -62,6 +62,23 @@ COPY = {
"不要的自定义主题,在 <b>⋯</b> 里选 <b>删除主题</b>。自带主题不能删除。",
],
"custom_note": "保存时会检查文字和背景的对比度。看不清的颜色会提示出来,但仍然可以保存。主题文件可以发给朋友,对方导入即可。",
+ "bg_title": "换背景图",
+ "bg_steps": [
+ "进入 <b>设置 › 外观</b>,滚到 <b>背景图</b>,点 <b>选择图片…</b>,选一张 JPEG、PNG 或 GIF。",
+ "图片铺满侧边栏和页面后面,侧边栏和列表底板变成半透明。正在用自带主题时,会先复制一份再改,自带主题本身不变。",
+ "<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三档;<b>用图片配色</b> 把强调色换成图片的主色;也可以让 <b>快捷粘贴窗口也显示</b>。",
+ "不想要了点 <b>移除</b>。手机上在 <b>设置 › 外观 › 背景图</b> 里选照片。",
+ ],
+ "bg_note": "文字始终看得清:隔空贴按主题的文字颜色和这张图,算出遮罩至少要多浓,只会比它更浓。深色的图配深色模式、浅色的图配浅色模式,图露得最多。",
+ "bg_alt": "像素主题深色模式铺了一张落日山景的背景图:侧边栏和列表半透明,图从后面透出来",
+ "bg_alt2": "设置 › 外观 › 背景图:更换、移除,模糊、遮罩、面板三档,用图片配色,快捷粘贴窗口也显示",
+ "scene_title": "换风景",
+ "scene_steps": [
+ "风景是页面顶部那条宽图和侧边栏底部的小图。像素主题这里默认画像素风景和小营地,其他主题默认没有。",
+ "在 <b>设置 › 外观 › 风景</b> 里,<b>页面顶部</b>、<b>侧边栏底部</b> 各点 <b>选择图片…</b> 换成自己的图,任何主题都能用。页面标题会自动盖一层遮罩,字照样看得清。",
+ "<b>恢复默认</b> 换回原来的样子;关掉 <b>显示风景</b> 两处都不画。设置了整窗背景图时不显示风景。",
+ ],
+ "scene_alt": "像素主题深色模式:页面顶部和侧边栏底部换成了落日山景的图",
"file_title": "主题文件长什么样",
"file_intro": "主题是一份 JSON。只写想改的地方就行,没写的从 <code>base</code> 指定的主题补齐。下面这份以像素主题为底,只换了强调色和几处底色:",
"file_fields_title": "常用字段",
@@ -73,6 +90,8 @@ COPY = {
("<code>typography</code>", "字体:<code>family</code> 可选 <code>system</code> 或自带的像素字体 <code>FusionPixel</code>。"),
("<code>shape</code>", "形状:<code>corner</code> 是 <code>round</code>(圆角)或 <code>pixel</code>(像素切角),还有圆角大小、边框粗细、投影样式。"),
("<code>motion</code>、<code>icons</code>", "动效 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;图标 <code>system</code> / <code>pixel</code>。"),
+ ("<code>background</code>", "整窗背景图:<code>image</code>(导入后的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些窗口显示)、<code>accentFromImage</code>。"),
+ ("<code>scenery</code>、<code>scene</code>", "风景开关,以及换成自己的图:<code>scene.header</code>(页面顶部)、<code>scene.sidebar</code>(侧边栏底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式与每个颜色用在哪里:",
"ai_title": "让 AI 帮你做主题",
@@ -94,6 +113,8 @@ COPY = {
"以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。",
"现在这套主题的灰色文字看不清,帮我调亮一点。",
"把我的主题导出给我看看,再做一个浅色版本。",
+ "用 ~/Pictures/海边.jpg 当背景,按照片的颜色配一套主题。",
+ "把像素主题顶部的风景换成 ~/Pictures/雪山.png。",
],
"ai_does_title": "AI 能做什么",
"ai_does": [
@@ -101,7 +122,7 @@ COPY = {
"读取主题格式说明:每个颜色用在哪里、要和谁达到多少对比度;",
"只校验不保存,看看哪对颜色对比度不够;",
"保存、应用、删除自定义主题,切换浅色深色;",
- "导入本机的一张图片作为背景,并分析亮度和主色。",
+ "导入本机的图片,设为整窗背景图或换掉风景,并分析亮度和主色。",
],
"ai_safe_title": "安全范围",
"ai_safe": "MCP 服务只在本机运行,不开网络端口。它只能读写主题和背景图,看不到复制记录、设备和好友,也不能改其他设置;背景图只接受本机文件,不会去网上下载。",
@@ -111,6 +132,7 @@ COPY = {
("AI 把主题改乱了怎么办?", "在 设置 › 外观 里点回 默认 或 像素 就恢复了;不要的自定义主题可以删除。"),
("导入时提示文字可能看不清?", "说明有几处文字和底色的对比度偏低。可以照提示改亮或改暗对应的颜色,也可以直接让 AI 帮你调。"),
("旧版本能用主题吗?", "需要 2.10 或更新的版本。设备之间的协议没有变化,新旧版本照常互传。"),
+ ("图放上去字会看不清吗?", "不会。遮罩浓度按主题的文字颜色算,只会比需要的更浓。图太花可以调高模糊或面板不透明度。"),
],
"more_title": "更多",
"more_links": [("让 AI 帮你做主题(详细说明)", "guide/ai-themes.zh-CN.md"), ("主题格式与设计", "design/themes.md"), ("MCP 工具说明", "design/mcp.md")],
@@ -149,6 +171,23 @@ COPY = {
"不要的自訂主題,在 <b>⋯</b> 裡選 <b>刪除主題</b>。內建主題不能刪除。",
],
"custom_note": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
+ "bg_title": "換背景圖",
+ "bg_steps": [
+ "進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,點 <b>選擇圖片…</b>,選一張 JPEG、PNG 或 GIF。",
+ "圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內建主題時,會先複製一份再改,內建主題本身不變。",
+ "<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;也可以讓 <b>快速貼上視窗也顯示</b>。",
+ "不想要了點 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裡選照片。",
+ ],
+ "bg_note": "文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,算出遮罩至少要多濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。",
+ "bg_alt": "像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來",
+ "bg_alt2": "設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示",
+ "scene_title": "換風景",
+ "scene_steps": [
+ "風景是頁面頂部那條寬圖和側邊欄底部的小圖。像素主題這裡預設畫像素風景和小營地,其他主題預設沒有。",
+ "在 <b>設定 › 外觀 › 風景</b> 裡,<b>頁面頂部</b>、<b>側邊欄底部</b> 各點 <b>選擇圖片…</b> 換成自己的圖,任何主題都能用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。",
+ "<b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。",
+ ],
+ "scene_alt": "像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖",
"file_title": "主題檔案長什麼樣",
"file_intro": "主題是一份 JSON。只寫想改的地方就好,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
"file_fields_title": "常用欄位",
@@ -160,6 +199,8 @@ COPY = {
("<code>typography</code>", "字型:<code>family</code> 可選 <code>system</code> 或內建的像素字型 <code>FusionPixel</code>。"),
("<code>shape</code>", "形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗細、陰影樣式。"),
("<code>motion</code>、<code>icons</code>", "動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。"),
+ ("<code>background</code>", "整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。"),
+ ("<code>scenery</code>、<code>scene</code>", "風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式與每個顏色用在哪裡:",
"ai_title": "讓 AI 幫你做主題",
@@ -181,6 +222,8 @@ COPY = {
"以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。",
"現在這套主題的灰色文字看不清楚,幫我調亮一點。",
"把我的主題匯出給我看看,再做一個淺色版本。",
+ "用 ~/Pictures/海邊.jpg 當背景,按照片的顏色配一套主題。",
+ "把像素主題頂部的風景換成 ~/Pictures/雪山.png。",
],
"ai_does_title": "AI 能做什麼",
"ai_does": [
@@ -188,7 +231,7 @@ COPY = {
"讀取主題格式說明:每個顏色用在哪裡、要和誰達到多少對比度;",
"只檢查不儲存,看看哪對顏色對比度不夠;",
"儲存、套用、刪除自訂主題,切換淺色深色;",
- "匯入本機的一張圖片作為背景,並分析亮度和主色。",
+ "匯入本機的圖片,設為整個視窗的背景圖或換掉風景,並分析亮度和主色。",
],
"ai_safe_title": "安全範圍",
"ai_safe": "MCP 服務只在本機執行,不開網路連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網路上下載。",
@@ -198,6 +241,7 @@ COPY = {
("AI 把主題改亂了怎麼辦?", "在 設定 › 外觀 裡點回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。"),
("匯入時提示文字可能看不清楚?", "代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。"),
("舊版本能用主題嗎?", "需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。"),
+ ("圖放上去字會看不清楚嗎?", "不會。遮罩濃度按主題的文字顏色算,只會比需要的更濃。圖太花可以調高模糊或面板不透明度。"),
],
"more_title": "更多",
"more_links": [("讓 AI 幫你做主題(詳細說明)", "guide/ai-themes.zh-CN.md"), ("主題格式與設計", "design/themes.md"), ("MCP 工具說明", "design/mcp.md")],
@@ -236,6 +280,23 @@ COPY = {
"不要的自訂主題,在 <b>⋯</b> 裏選 <b>刪除主題</b>。內置主題不能刪除。",
],
"custom_note": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
+ "bg_title": "換背景圖",
+ "bg_steps": [
+ "進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,按 <b>選擇圖片…</b>,揀一張 JPEG、PNG 或 GIF。",
+ "圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內置主題時,會先複製一份再改,內置主題本身不變。",
+ "<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;亦可以讓 <b>快速貼上視窗也顯示</b>。",
+ "唔想要就按 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裏揀相片。",
+ ],
+ "bg_note": "文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,計出遮罩最少要幾濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。",
+ "bg_alt": "像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來",
+ "bg_alt2": "設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示",
+ "scene_title": "換風景",
+ "scene_steps": [
+ "風景是頁面頂部那條闊圖和側邊欄底部的小圖。像素主題這裏預設畫像素風景和小營地,其他主題預設沒有。",
+ "在 <b>設定 › 外觀 › 風景</b> 裏,<b>頁面頂部</b>、<b>側邊欄底部</b> 各按 <b>選擇圖片…</b> 換成自己的圖,任何主題都可以用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。",
+ "<b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。",
+ ],
+ "scene_alt": "像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖",
"file_title": "主題檔案是怎樣的",
"file_intro": "主題是一份 JSON。只寫想改的地方就可以,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
"file_fields_title": "常用欄位",
@@ -247,6 +308,8 @@ COPY = {
("<code>typography</code>", "字型:<code>family</code> 可選 <code>system</code> 或內置的像素字型 <code>FusionPixel</code>。"),
("<code>shape</code>", "形狀:<code>corner</code> 是 <code>round</code>(圓角)或 <code>pixel</code>(像素切角),還有圓角大小、邊框粗幼、陰影樣式。"),
("<code>motion</code>、<code>icons</code>", "動態 <code>smooth</code> / <code>stepped</code> / <code>reduced</code>;圖示 <code>system</code> / <code>pixel</code>。"),
+ ("<code>background</code>", "整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。"),
+ ("<code>scenery</code>、<code>scene</code>", "風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式與每個顏色用在哪裏:",
"ai_title": "讓 AI 幫你做主題",
@@ -268,6 +331,8 @@ COPY = {
"以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。",
"現在這套主題的灰色文字看不清楚,幫我調亮一點。",
"把我的主題匯出給我看看,再做一個淺色版本。",
+ "用 ~/Pictures/海邊.jpg 做背景,按相片的顏色配一套主題。",
+ "把像素主題頂部的風景換成 ~/Pictures/雪山.png。",
],
"ai_does_title": "AI 能做甚麼",
"ai_does": [
@@ -275,7 +340,7 @@ COPY = {
"讀取主題格式說明:每個顏色用在哪裏、要和誰達到多少對比度;",
"只檢查不儲存,看看哪對顏色對比度不夠;",
"儲存、套用、刪除自訂主題,切換淺色深色;",
- "匯入本機的一張圖片作為背景,並分析亮度和主色。",
+ "匯入本機的圖片,設為整個視窗的背景圖或換掉風景,並分析亮度和主色。",
],
"ai_safe_title": "安全範圍",
"ai_safe": "MCP 服務只在本機運行,不開網絡連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網上下載。",
@@ -285,6 +350,7 @@ COPY = {
("AI 把主題改亂了怎麼辦?", "在 設定 › 外觀 裏按回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。"),
("匯入時提示文字可能看不清楚?", "代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。"),
("舊版本能用主題嗎?", "需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。"),
+ ("圖放上去字會唔會睇唔清?", "唔會。遮罩濃度按主題的文字顏色計,只會比需要的更濃。圖太花可以調高模糊或面板不透明度。"),
],
"more_title": "更多",
"more_links": [("讓 AI 幫你做主題(詳細說明)", "guide/ai-themes.zh-CN.md"), ("主題格式與設計", "design/themes.md"), ("MCP 工具說明", "design/mcp.md")],
@@ -323,6 +389,23 @@ COPY = {
"To remove a custom theme, choose <b>Delete theme</b> in its <b>⋯</b> menu. Built-in themes can’t be deleted.",
],
"custom_note": "Text contrast is checked when a theme is saved. Hard-to-read colors are pointed out, but you can still save. Theme files can be shared: the other person just imports it.",
+ "bg_title": "Use a background image",
+ "bg_steps": [
+ "Open <b>Settings › Appearance</b>, scroll to <b>Background image</b>, click <b>Choose Image…</b> and pick a JPEG, PNG or GIF.",
+ "The image fills the window behind the sidebar and pages, and the sidebar and lists become translucent. If a built-in theme is in use, a copy is made first; the built-in theme itself stays the same.",
+ "<b>Blur</b>, <b>Scrim</b> and <b>Panels</b> have three steps each. <b>Use image colors</b> takes the accent color from the image, and <b>Also show in Quick Paste</b> shows it there too.",
+ "Click <b>Remove</b> to go back. On Android, pick a photo under <b>Settings › Appearance › Background image</b>.",
+ ],
+ "bg_note": "Text always stays readable: PasteFerry works out how strong the scrim must be for the theme's text colors on this image and never shows it lighter. Dark images with dark mode, and light images with light mode, show the most of the picture.",
+ "bg_alt": "Pixel theme in dark mode with a sunset hills background: the sidebar and list are translucent and the picture shows through",
+ "bg_alt2": "Settings › Appearance › Background image: change, remove, three steps for blur, scrim and panels, use image colors, also show in Quick Paste",
+ "scene_title": "Change the scenery",
+ "scene_steps": [
+ "The scenery is the wide picture at the top of pages and the small one at the bottom of the sidebar. The pixel theme draws a pixel landscape and a small camp there; other themes have none.",
+ "Under <b>Settings › Appearance › Scenery</b>, click <b>Choose Image…</b> next to <b>Page header</b> or <b>Sidebar bottom</b> to use your own pictures, with any theme. A scrim is added under the page title so it stays readable.",
+ "<b>Reset</b> brings back the original; turn off <b>Show scenery</b> to hide both. Scenery is hidden while a background image fills the window.",
+ ],
+ "scene_alt": "Pixel theme in dark mode with the page header and sidebar bottom replaced by a sunset hills picture",
"file_title": "What a theme file looks like",
"file_intro": "A theme is a JSON file. Write only what you want to change; everything else comes from the theme named in <code>base</code>. This one starts from Pixel and changes the accent and a few backgrounds:",
"file_fields_title": "Common fields",
@@ -334,6 +417,8 @@ COPY = {
("<code>typography</code>", "Fonts: <code>family</code> is <code>system</code> or the built-in pixel font <code>FusionPixel</code>."),
("<code>shape</code>", "Shapes: <code>corner</code> is <code>round</code> or <code>pixel</code> (notched), plus radii, border width and shadow style."),
("<code>motion</code>, <code>icons</code>", "Motion <code>smooth</code> / <code>stepped</code> / <code>reduced</code>; icons <code>system</code> / <code>pixel</code>."),
+ ("<code>background</code>", "Window background image: <code>image</code> (<code>user:&lt;sha256&gt;</code> after importing), <code>blur</code>, <code>scrim</code>, <code>surfaceOpacity</code> (panel opacity), <code>scope</code> (which windows show it), <code>accentFromImage</code>."),
+ ("<code>scenery</code>, <code>scene</code>", "Scenery on/off, and your own pictures: <code>scene.header</code> (page header) and <code>scene.sidebar</code> (sidebar bottom), with optional <code>headerDark</code> and <code>sidebarDark</code> for dark mode."),
],
"file_more": "The full format and where each color is used:",
"ai_title": "Let an AI make a theme",
@@ -355,6 +440,8 @@ COPY = {
"Start from the Pixel theme and make a sunset version with a warmer dark background.",
"The gray text in my current theme is hard to read. Make it lighter.",
"Export my theme so I can see it, then make a light version.",
+ "Use ~/Pictures/beach.jpg as the background and match the colors to the photo.",
+ "Replace the pixel theme's header landscape with ~/Pictures/mountains.png.",
],
"ai_does_title": "What the AI can do",
"ai_does": [
@@ -362,7 +449,7 @@ COPY = {
"read the theme format: where each color is used and the contrast it needs;",
"check a theme without saving it, to find colors with too little contrast;",
"save, apply and delete custom themes, and switch light and dark;",
- "import an image from this computer as a background and analyze its brightness and main colors.",
+ "Import a picture from this computer as a window background or scenery, and analyze its brightness and main colors.",
],
"ai_safe_title": "What it can’t do",
"ai_safe": "The MCP server runs only on this computer and opens no network port. It can read and write themes and background images only: it can’t see your history, devices or friends, or change other settings. Background images must be local files; nothing is downloaded from the internet.",
@@ -372,6 +459,7 @@ COPY = {
("The AI made a mess of my theme. How do I go back?", "Choose Default or Pixel in Settings › Appearance. Delete custom themes you don’t want."),
("Importing says some text may be hard to read.", "Some text and background colors have low contrast. Lighten or darken those colors as suggested, or ask the AI to fix them."),
("Do older versions support themes?", "You need 2.10 or later. The device protocol is unchanged, so old and new versions still work together."),
+ ("Will text be hard to read on my picture?", "No. The scrim strength is worked out from the theme's text colors and is never lighter than needed. For a busy picture, raise the blur or panel opacity."),
],
"more_title": "More",
"more_links": [("Let an AI make a theme (full guide)", "guide/ai-themes.md"), ("Theme format and design", "design/themes.md"), ("MCP tools", "design/mcp.md")],
@@ -410,6 +498,23 @@ COPY = {
"不要なカスタムテーマは <b>⋯</b> から <b>テーマを削除</b> を選びます。内蔵テーマは削除できません。",
],
"custom_note": "保存時に文字のコントラストを確認し、読みにくい色を知らせます(そのまま保存もできます)。テーマファイルは共有でき、相手は読み込むだけで使えます。",
+ "bg_title": "背景画像を使う",
+ "bg_steps": [
+ "<b>設定 › 外観</b> を開き、<b>背景画像</b> までスクロールして <b>画像を選択…</b> を押し、JPEG、PNG、GIF を選びます。",
+ "画像がサイドバーとページの後ろに敷かれ、サイドバーとリストの下地は半透明になります。内蔵テーマを使っているときは、先に複製してから変更します(内蔵テーマ自体は変わりません)。",
+ "<b>ぼかし</b>、<b>スクリム</b>、<b>パネル</b> はそれぞれ 3 段階。<b>画像の色を使う</b> でアクセントカラーを画像の主な色に、<b>クイックペーストにも表示</b> でそちらにも表示します。",
+ "やめるときは <b>削除</b>。Android では <b>設定 › 外観 › 背景画像</b> で写真を選びます。",
+ ],
+ "bg_note": "文字は常に読みやすいまま:テーマの文字色とこの画像から必要なスクリムの濃さを計算し、それより薄くはしません。暗い画像はダークモード、明るい画像はライトモードと組み合わせると画像がよく見えます。",
+ "bg_alt": "ダークモードのピクセルテーマに夕焼けの山の背景画像:サイドバーとリストが半透明で、画像が透けて見える",
+ "bg_alt2": "設定 › 外観 › 背景画像:変更、削除、ぼかし・スクリム・パネルの 3 段階、画像の色を使う、クイックペーストにも表示",
+ "scene_title": "風景を変える",
+ "scene_steps": [
+ "風景とは、ページ上部の横長の画像とサイドバー下部の小さな画像です。ピクセルテーマではピクセルの風景と小さなキャンプを描き、ほかのテーマにはありません。",
+ "<b>設定 › 外観 › 風景</b> で <b>ページ上部</b>、<b>サイドバー下部</b> の <b>画像を選択…</b> を押すと自分の画像に変えられます(どのテーマでも可)。ページタイトルが読めるようにスクリムを自動で重ねます。",
+ "<b>元に戻す</b> で元の絵に、<b>風景を表示</b> をオフにすると両方とも消えます。ウインドウ全体の背景画像があるときは風景を表示しません。",
+ ],
+ "scene_alt": "ダークモードのピクセルテーマ:ページ上部とサイドバー下部を夕焼けの山の画像に変えたところ",
"file_title": "テーマファイルの中身",
"file_intro": "テーマは JSON ファイルです。変えたいところだけ書けば、残りは <code>base</code> のテーマから補われます。次の例はピクセルをもとに、アクセントといくつかの背景色だけを変えています。",
"file_fields_title": "よく使う項目",
@@ -421,6 +526,8 @@ COPY = {
("<code>typography</code>", "フォント:<code>family</code> は <code>system</code> か内蔵のピクセルフォント <code>FusionPixel</code>。"),
("<code>shape</code>", "形:<code>corner</code> は <code>round</code>(角丸)か <code>pixel</code>(切り欠き)。角の大きさ、枠の太さ、影の種類も指定できます。"),
("<code>motion</code>、<code>icons</code>", "動き <code>smooth</code> / <code>stepped</code> / <code>reduced</code>、アイコン <code>system</code> / <code>pixel</code>。"),
+ ("<code>background</code>", "ウインドウ全体の背景画像:<code>image</code>(読み込み後の <code>user:&lt;sha256&gt;</code>)、<code>blur</code>、<code>scrim</code>、<code>surfaceOpacity</code>(パネルの不透明度)、<code>scope</code>(表示するウインドウ)、<code>accentFromImage</code>。"),
+ ("<code>scenery</code>、<code>scene</code>", "風景のオン・オフと自分の画像:<code>scene.header</code>(ページ上部)、<code>scene.sidebar</code>(サイドバー下部)。ダークモード用に <code>headerDark</code>、<code>sidebarDark</code> も指定できます。"),
],
"file_more": "完全な形式と各色の使われる場所:",
"ai_title": "AI にテーマを作ってもらう",
@@ -442,6 +549,8 @@ COPY = {
"ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。",
"今のテーマの灰色の文字が読みにくいので、明るくして。",
"今のテーマを書き出して見せて。それからライト版も作って。",
+ "~/Pictures/beach.jpg を背景にして、写真の色に合わせたテーマを作って。",
+ "ピクセルテーマの上部の風景を ~/Pictures/mountains.png に変えて。",
],
"ai_does_title": "AI ができること",
"ai_does": [
@@ -449,7 +558,7 @@ COPY = {
"テーマ形式の説明(各色の使われる場所と必要なコントラスト)の読み取り",
"保存せずに確認し、コントラストが足りない色を見つける",
"カスタムテーマの保存・適用・削除、ライトとダークの切り替え",
- "このパソコンの画像を背景として読み込み、明るさと主な色を分析",
+ "このコンピュータの画像を読み込み、ウインドウの背景や風景に設定し、明るさと主な色を分析する。",
],
"ai_safe_title": "できないこと",
"ai_safe": "MCP サーバーはこのパソコンの中だけで動き、ネットワークのポートは開きません。扱えるのはテーマと背景画像だけで、履歴、デバイス、友だちは見えず、ほかの設定も変えられません。背景画像はローカルのファイルのみで、インターネットからは取得しません。",
@@ -459,6 +568,7 @@ COPY = {
("AI がテーマを崩してしまいました。", "設定 › 外観 でデフォルトかピクセルを選べば戻ります。不要なカスタムテーマは削除できます。"),
("読み込み時に「読みにくい」と表示されます。", "文字と背景のコントラストが低いところがあります。表示に従って色を明るく・暗くするか、AI に直してもらってください。"),
("古いバージョンでもテーマは使えますか?", "2.10 以降が必要です。デバイス間のプロトコルは変わっていないので、新旧のバージョンは引き続き連携できます。"),
+ ("画像の上で文字が読みにくくならない?", "なりません。スクリムの濃さはテーマの文字色から計算し、必要より薄くはしません。にぎやかな画像なら、ぼかしやパネルの不透明度を上げてください。"),
],
"more_title": "さらに詳しく",
"more_links": [("AI でテーマを作る(詳しいガイド)", "guide/ai-themes.md"), ("テーマの形式と設計", "design/themes.md"), ("MCP ツール", "design/mcp.md")],