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): add a themes guide

baiyuze188268c1f00a
diff --git a/docs/cloud/index.html b/docs/cloud/index.html
index f981373..f236633 100644
--- a/docs/cloud/index.html
+++ b/docs/cloud/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/download/index.html b/docs/download/index.html
index a5ac8f2..6f6d6c8 100644
--- a/docs/download/index.html
+++ b/docs/download/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/en/cloud/index.html b/docs/en/cloud/index.html
index 571849c..ba7baef 100644
--- a/docs/en/cloud/index.html
+++ b/docs/en/cloud/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/download/index.html b/docs/en/download/index.html
index be2b3f2..4b9a4a4 100644
--- a/docs/en/download/index.html
+++ b/docs/en/download/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/faq/index.html b/docs/en/faq/index.html
index 056067f..b090e4f 100644
--- a/docs/en/faq/index.html
+++ b/docs/en/faq/index.html
@@ -171,6 +171,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="./" aria-current="page">FAQ</a></li>
diff --git a/docs/en/features/index.html b/docs/en/features/index.html
index e53e62a..65d286e 100644
--- a/docs/en/features/index.html
+++ b/docs/en/features/index.html
@@ -58,6 +58,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
@@ -183,6 +184,7 @@
<img src="../../assets/screenshots/en/pixel-send-dark.png?v=30d0886626" width="2552" height="1632" loading="lazy" alt="Send Files in the Pixel theme (dark): night mountains and a moon in the header, a dotted radar and pixel-block devices">
</div>
<p class="f-note">Themes apply only to the device you set them on (on a computer, the main window and quick paste); they aren’t synced. The Android app has its own Settings › Appearance. Pixel themes can add CRT scanlines. The AI can only read and write themes, never your history or devices.</p>
+ <p class="more"><a href="../themes/">Themes guide →</a></p>
</div>
</section>
diff --git a/docs/en/feedback/index.html b/docs/en/feedback/index.html
index ad52401..d998b25 100644
--- a/docs/en/feedback/index.html
+++ b/docs/en/feedback/index.html
@@ -45,6 +45,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/how/index.html b/docs/en/how/index.html
index 5aaea73..f95512f 100644
--- a/docs/en/how/index.html
+++ b/docs/en/how/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="./" aria-current="page">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/index.html b/docs/en/index.html
index 67feb86..03aeb4c 100644
--- a/docs/en/index.html
+++ b/docs/en/index.html
@@ -113,6 +113,7 @@
<ul>
<li class="narrow"><a href="start/">Quick start</a></li>
<li class="narrow"><a href="start/#server">Ways to connect</a></li>
+ <li><a href="themes/">Themes guide</a></li>
<li><a href="how/">How it works</a></li>
<li><a href="security/">Security</a></li>
<li><a href="faq/">FAQ</a></li>
@@ -184,7 +185,7 @@
<figure class="spot wide" data-reveal>
<img src="../assets/screenshots/en/pixel-history-dark.png?v=aaa7f233a7" width="2112" height="1472" loading="lazy" alt="History in the Pixel theme (dark): night mountains, pines and a moon in the header, a tent and campfire at the bottom of the sidebar, and bitmap type">
</figure>
- <p class="more"><a href="features/#themes">More about themes →</a></p>
+ <p class="more"><a href="features/#themes">More about themes →</a><a href="themes/">Themes guide →</a></p>
</div>
</section>
diff --git a/docs/en/lan/index.html b/docs/en/lan/index.html
index 868ff8e..1ac7a87 100644
--- a/docs/en/lan/index.html
+++ b/docs/en/lan/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/official/index.html b/docs/en/official/index.html
index bf38e21..d3ebf1b 100644
--- a/docs/en/official/index.html
+++ b/docs/en/official/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/privacy/index.html b/docs/en/privacy/index.html
index 0a03f31..1148554 100644
--- a/docs/en/privacy/index.html
+++ b/docs/en/privacy/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/security/index.html b/docs/en/security/index.html
index bc6e2f1..eaf9179 100644
--- a/docs/en/security/index.html
+++ b/docs/en/security/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="./" aria-current="page">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/server/index.html b/docs/en/server/index.html
index 8f3a7ba..c88777a 100644
--- a/docs/en/server/index.html
+++ b/docs/en/server/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/start/index.html b/docs/en/start/index.html
index 4a55bd4..a385398 100644
--- a/docs/en/start/index.html
+++ b/docs/en/start/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="./" aria-current="page">Quick start</a></li>
<li class="narrow"><a href="#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/tailscale/index.html b/docs/en/tailscale/index.html
index ff1016b..a45fdab 100644
--- a/docs/en/tailscale/index.html
+++ b/docs/en/tailscale/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../en/start/">Quick start</a></li>
<li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
diff --git a/docs/en/themes/index.html b/docs/en/themes/index.html
new file mode 100644
index 0000000..c6bbdf1
--- /dev/null
+++ b/docs/en/themes/index.html
@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <script>
+ (function () {
+ if (location.hostname !== "baiyuze.github.io") return;
+ var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
+ if (!prefix) return;
+ var path = location.pathname.slice(prefix[0].length) || "/";
+ location.replace("https://pasteferry.cc" + path + location.search + location.hash);
+ })();
+ </script>
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Themes guide — PasteFerry</title>
+ <meta name="description" content="Change themes in PasteFerry, switch light and dark, make your own theme, and let AI apps such as Claude and Cursor design and apply themes over MCP.">
+ <link rel="canonical" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/">
+ <meta name="theme-color" content="#141416">
+ <meta property="og:type" content="article">
+ <meta property="og:site_name" content="PasteFerry">
+ <meta property="og:title" content="Themes guide — PasteFerry">
+ <meta property="og:description" content="Change themes in PasteFerry, switch light and dark, make your own theme, and let AI apps such as Claude and Cursor design and apply themes over MCP.">
+ <meta property="og:url" content="https://pasteferry.cc/en/themes/">
+ <meta property="og:image" content="https://pasteferry.cc/assets/og-en.png">
+ <meta property="og:locale" content="en_US">
+ <meta name="twitter:card" content="summary_large_image">
+ <link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
+ <link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
+ <link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
+ <link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
+ <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
+</head>
+<body>
+ <a class="skip" href="#main">Skip to content</a>
+
+ <header class="bar">
+ <div class="wrap">
+ <a class="brand" href="../../en/" aria-label="PasteFerry home"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">PasteFerry</a>
+ <nav aria-label="Page">
+ <a href="../../en/features/">Features</a>
+ <a class="mid" href="../../en/start/">Quick start</a>
+ <a class="wide" href="../../en/start/#server">Ways to connect</a>
+ <a href="../../en/download/">Download</a>
+ <details class="menu">
+ <summary aria-label="More pages" class="current"><span>More</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li class="narrow"><a href="../../en/start/">Quick start</a></li>
+ <li class="narrow"><a href="../../en/start/#server">Ways to connect</a></li>
+ <li><a href="./" aria-current="page">Themes guide</a></li>
+ <li><a href="../../en/how/">How it works</a></li>
+ <li><a href="../../en/security/">Security</a></li>
+ <li><a href="../../en/faq/">FAQ</a></li>
+ <li><a href="../../en/feedback/">Discussion & feedback</a></li>
+ <li class="sep" role="separator"></li>
+ <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">Changelog</a></li>
+ <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
+ </ul>
+ </details>
+ <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="Star PasteFerry on GitHub"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
+ <details class="lang">
+ <summary aria-label="Language:English"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>English</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li><a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
+ <li><a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
+ <li><a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
+ <li><a href="../../en/themes/" hreflang="en" lang="en" data-lang="en" aria-current="page">English</a></li>
+ <li><a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a></li>
+ </ul>
+ </details>
+ </nav>
+ </div>
+ </header>
+
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="../../en/">PasteFerry</a> / Themes guide</p>
+ <h1 class="display">Change it, make it,<br>or let an AI make it.</h1>
+ <p class="lede">From 2.10, PasteFerry has themes: Default and Pixel are built in, you can duplicate one and make it yours, or ask an AI to design one. A theme applies only to the device you set it on.</p>
+ <a class="button" href="../../en/download/"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>Download 2.10</a>
+ <p class="more"><a href="#ai">Skip to themes made by AI ↓</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>Change the theme</h2>
+ <div class="os-grid"><ol class="steps"><li>Open PasteFerry and go to <b>Settings › Appearance</b>.</li><li>Click a theme under Built in or Custom. The window changes right away, and so does Quick Paste.</li><li>Under Light and dark, choose <b>Match system</b>, <b>Light</b> or <b>Dark</b>.</li><li>With a pixel theme you can also turn on <b>Scanlines</b>, faint CRT lines over the whole window.</li><li>On Android, choose in the app’s own <b>Settings › Appearance</b>; computers and phones don’t affect each other.</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/en/pixel-appearance-dark.png?v=3f1dca08ee" width="2112" height="1472" alt="Settings › Appearance: the built-in Default and Pixel themes, two custom themes, Import theme, Ask AI to make a theme, light and dark, and scanlines"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>The two built-in themes</h2>
+ <ul><li><b>Default</b>: The quiet, system-style look PasteFerry has always had.</li><li><b>Pixel</b>: Bitmap type, notched borders and bevelled buttons, graphite and paper palettes with pixel green. A night or daytime scene up top, a paper plane while sending and a burst of stars when it arrives.</li></ul>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/en/history.png?v=8c41b3d9ce" width="2112" height="1472" loading="lazy" alt="History in the Default theme (light)">
+ <img src="../../assets/screenshots/en/pixel-history-dark.png?v=aaa7f233a7" width="2112" height="1472" loading="lazy" alt="History in the Pixel theme (dark): mountains and a moon in the header, a tent and campfire at the bottom of the sidebar">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>Make your own theme</h2>
+ <p class="intro">The easiest way is to duplicate a built-in theme and change it:</p>
+ <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="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>
+ <div class="code">
+ <button class="copy" type="button" data-done="Copied">Copy</button>
+<pre><code>{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}</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>
+ <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">
+ <h2>Let an AI make a theme</h2>
+ <p class="intro">PasteFerry includes an MCP server, <code>pasteferry-cli mcp</code>. Add it to an AI app that supports MCP, such as Claude Desktop, Claude Code or Cursor, and describe the look you want in one sentence. The AI reads the theme format, picks colors, checks contrast, then saves and applies the theme.</p>
+ <h3>1. Find pasteferry-cli</h3>
+ <dl class="fields"><dt>Mac</dt><dd><code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code> (with Homebrew, just <code>pasteferry-cli</code>)</dd><dt>Windows</dt><dd><code>%LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe</code></dd><dt>Linux</dt><dd>deb: <code>/usr/bin/pasteferry-cli</code>; tar.gz: <code>PasteFerry/pasteferry-cli</code> in the extracted folder</dd></dl>
+ <p class="note">Or copy the ready-made configuration for this computer from <b>Settings › Appearance › Ask AI to make a theme</b>.</p>
+ <h3>2. Add it to your AI app</h3>
+ <p>Claude Desktop (Settings › Developer › Edit Config) and Cursor (<code>~/.cursor/mcp.json</code>) use the same configuration. On a Mac:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="Copied">Copy</button>
+<pre><code>{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}</code></pre>
+ </div>
+ <p>For Claude Code, run in a terminal:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="Copied">Copy</button>
+<pre><code>claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp</code></pre>
+ </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>
+ <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>
+ <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>
+ <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>
+
+ <footer class="footer">
+ <div class="wrap">
+ <p>PasteFerry is open source under the GNU AGPL-3.0.</p>
+ <nav aria-label="Footer">
+ <a href="https://github.com/baiyuze/pasteferry/releases">All releases</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">Changelog</a>
+ <a href="https://pasteferry.cc/design/nat-traversal.html">Design notes (Chinese)</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">License</a>
+ <a href="https://github.com/baiyuze/pasteferry/issues">Report an issue</a>
+ <a href="../../en/privacy/">Privacy</a>
+ <a href="../../en/feedback/">Discussion & feedback</a>
+ </nav>
+ <nav aria-label="Language">
+ <a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
+ <a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
+ <a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
+ <a href="../../en/themes/" hreflang="en" lang="en" data-lang="en" aria-current="page">English</a>
+ <a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a>
+ </nav>
+ </div>
+ </footer>
+
+ <script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
+ <script src="/assets/analytics.js?v=e2777f714d" defer></script>
+ <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
+</body>
+</html>
diff --git a/docs/faq/index.html b/docs/faq/index.html
index 3effaf5..be156f9 100644
--- a/docs/faq/index.html
+++ b/docs/faq/index.html
@@ -171,6 +171,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="./" aria-current="page">常见问题</a></li>
diff --git a/docs/features/index.html b/docs/features/index.html
index 6bca8e4..2b032a7 100644
--- a/docs/features/index.html
+++ b/docs/features/index.html
@@ -58,6 +58,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
@@ -183,6 +184,7 @@
<img src="../assets/screenshots/pixel-send-dark.png?v=b2de0529a7" width="2552" height="1632" loading="lazy" alt="像素主题的隔空传送页(深色):页眉是夜里的远山和月亮,雷达是点阵圆圈,设备是像素小方块">
</div>
<p class="f-note">主题只作用于这一台设备(电脑上包括主窗口和快捷粘贴窗口),不在设备之间同步;安卓 App 在自己的「设置 › 外观」里单独选。像素主题还能打开 CRT 扫描线。AI 只能读写主题,看不到复制记录和设备。</p>
+ <p class="more"><a href="../themes/">主题教程 →</a></p>
</div>
</section>
diff --git a/docs/feedback/index.html b/docs/feedback/index.html
index c222549..864a64d 100644
--- a/docs/feedback/index.html
+++ b/docs/feedback/index.html
@@ -45,6 +45,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/how/index.html b/docs/how/index.html
index 4b0720d..b11c1a9 100644
--- a/docs/how/index.html
+++ b/docs/how/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="./" aria-current="page">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/index.html b/docs/index.html
index 9dc4795..bae7167 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -138,6 +138,7 @@
<ul>
<li class="narrow"><a href="start/">快速开始</a></li>
<li class="narrow"><a href="start/#server">连接方式</a></li>
+ <li><a href="themes/">主题教程</a></li>
<li><a href="how/">工作原理</a></li>
<li><a href="security/">安全与隐私</a></li>
<li><a href="faq/">常见问题</a></li>
@@ -209,7 +210,7 @@
<figure class="spot wide" data-reveal>
<img src="assets/screenshots/pixel-history-dark.png?v=f242b14be0" width="2112" height="1472" loading="lazy" alt="像素主题的复制记录(深色):页眉是夜里的远山、松树和月亮,侧边栏底下有帐篷和篝火,字是点阵字体">
</figure>
- <p class="more"><a href="features/#themes">了解主题 →</a></p>
+ <p class="more"><a href="features/#themes">了解主题 →</a><a href="themes/">主题教程 →</a></p>
</div>
</section>
diff --git a/docs/ja/cloud/index.html b/docs/ja/cloud/index.html
index 60303fc..6841360 100644
--- a/docs/ja/cloud/index.html
+++ b/docs/ja/cloud/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/download/index.html b/docs/ja/download/index.html
index 7705a88..593ccee 100644
--- a/docs/ja/download/index.html
+++ b/docs/ja/download/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/faq/index.html b/docs/ja/faq/index.html
index 8c0523a..f92cd29 100644
--- a/docs/ja/faq/index.html
+++ b/docs/ja/faq/index.html
@@ -171,6 +171,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="./" aria-current="page">よくある質問</a></li>
diff --git a/docs/ja/features/index.html b/docs/ja/features/index.html
index c50c4ed..ef0a325 100644
--- a/docs/ja/features/index.html
+++ b/docs/ja/features/index.html
@@ -58,6 +58,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
@@ -183,6 +184,7 @@
<img src="../../assets/screenshots/ja/pixel-send-dark.png?v=eb8af1d3de" width="2552" height="1632" loading="lazy" alt="ピクセルテーマのファイル送信ページ(ダーク):上部に夜の山と月、ドットのレーダー、ピクセルのブロックで描かれたデバイス">
</div>
<p class="f-note">テーマは設定したデバイスだけに適用され(パソコンではメインウインドウとクイックペースト)、デバイス間で同期されません。Android アプリは自分の「設定 › 外観」で選びます。ピクセルテーマには CRT 走査線も。AI が扱えるのはテーマだけで、履歴やデバイスは見えません。</p>
+ <p class="more"><a href="../themes/">テーマガイド →</a></p>
</div>
</section>
diff --git a/docs/ja/feedback/index.html b/docs/ja/feedback/index.html
index 986ac65..02677c8 100644
--- a/docs/ja/feedback/index.html
+++ b/docs/ja/feedback/index.html
@@ -45,6 +45,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/how/index.html b/docs/ja/how/index.html
index f675a6b..a8508d1 100644
--- a/docs/ja/how/index.html
+++ b/docs/ja/how/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="./" aria-current="page">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/index.html b/docs/ja/index.html
index 3c964c0..2c85f48 100644
--- a/docs/ja/index.html
+++ b/docs/ja/index.html
@@ -113,6 +113,7 @@
<ul>
<li class="narrow"><a href="start/">はじめかた</a></li>
<li class="narrow"><a href="start/#server">接続方法</a></li>
+ <li><a href="themes/">テーマガイド</a></li>
<li><a href="how/">しくみ</a></li>
<li><a href="security/">セキュリティ</a></li>
<li><a href="faq/">よくある質問</a></li>
@@ -184,7 +185,7 @@
<figure class="spot wide" data-reveal>
<img src="../assets/screenshots/ja/pixel-history-dark.png?v=06bddfa070" width="2112" height="1472" loading="lazy" alt="ピクセルテーマの履歴(ダーク):上部に夜の山と松と月、サイドバーの下にテントとたき火、文字はドットフォント">
</figure>
- <p class="more"><a href="features/#themes">テーマについて →</a></p>
+ <p class="more"><a href="features/#themes">テーマについて →</a><a href="themes/">テーマガイド →</a></p>
</div>
</section>
diff --git a/docs/ja/lan/index.html b/docs/ja/lan/index.html
index ba364c5..7562e4e 100644
--- a/docs/ja/lan/index.html
+++ b/docs/ja/lan/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/official/index.html b/docs/ja/official/index.html
index d61b2c4..497aa84 100644
--- a/docs/ja/official/index.html
+++ b/docs/ja/official/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/privacy/index.html b/docs/ja/privacy/index.html
index 44b3b42..9d11a81 100644
--- a/docs/ja/privacy/index.html
+++ b/docs/ja/privacy/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/security/index.html b/docs/ja/security/index.html
index 9d57662..967ad63 100644
--- a/docs/ja/security/index.html
+++ b/docs/ja/security/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="./" aria-current="page">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/server/index.html b/docs/ja/server/index.html
index 3f5ff5f..1e0574e 100644
--- a/docs/ja/server/index.html
+++ b/docs/ja/server/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/start/index.html b/docs/ja/start/index.html
index 218a172..ea726bb 100644
--- a/docs/ja/start/index.html
+++ b/docs/ja/start/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="./" aria-current="page">はじめかた</a></li>
<li class="narrow"><a href="#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/tailscale/index.html b/docs/ja/tailscale/index.html
index b427f76..b394d76 100644
--- a/docs/ja/tailscale/index.html
+++ b/docs/ja/tailscale/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
<li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="../../ja/themes/">テーマガイド</a></li>
<li><a href="../../ja/how/">しくみ</a></li>
<li><a href="../../ja/security/">セキュリティ</a></li>
<li><a href="../../ja/faq/">よくある質問</a></li>
diff --git a/docs/ja/themes/index.html b/docs/ja/themes/index.html
new file mode 100644
index 0000000..9fe6c0c
--- /dev/null
+++ b/docs/ja/themes/index.html
@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="ja">
+<head>
+ <meta charset="utf-8">
+ <script>
+ (function () {
+ if (location.hostname !== "baiyuze.github.io") return;
+ var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
+ if (!prefix) return;
+ var path = location.pathname.slice(prefix[0].length) || "/";
+ location.replace("https://pasteferry.cc" + path + location.search + location.hash);
+ })();
+ </script>
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>テーマガイド — PasteFerry</title>
+ <meta name="description" content="PasteFerry でテーマを変える、ライトとダークを切り替える、自分のテーマを作る、Claude や Cursor などの AI に MCP でテーマを作って適用してもらう方法。">
+ <link rel="canonical" href="https://pasteferry.cc/ja/themes/">
+ <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/">
+ <meta name="theme-color" content="#141416">
+ <meta property="og:type" content="article">
+ <meta property="og:site_name" content="PasteFerry">
+ <meta property="og:title" content="テーマガイド — PasteFerry">
+ <meta property="og:description" content="PasteFerry でテーマを変える、ライトとダークを切り替える、自分のテーマを作る、Claude や Cursor などの AI に MCP でテーマを作って適用してもらう方法。">
+ <meta property="og:url" content="https://pasteferry.cc/ja/themes/">
+ <meta property="og:image" content="https://pasteferry.cc/assets/og-en.png">
+ <meta property="og:locale" content="ja_JP">
+ <meta name="twitter:card" content="summary_large_image">
+ <link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
+ <link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
+ <link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
+ <link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
+ <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
+</head>
+<body>
+ <a class="skip" href="#main">本文へ移動</a>
+
+ <header class="bar">
+ <div class="wrap">
+ <a class="brand" href="../../ja/" aria-label="PasteFerry ホーム"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">PasteFerry</a>
+ <nav aria-label="ページ内の移動">
+ <a href="../../ja/features/">機能</a>
+ <a class="mid" href="../../ja/start/">はじめかた</a>
+ <a class="wide" href="../../ja/start/#server">接続方法</a>
+ <a href="../../ja/download/">ダウンロード</a>
+ <details class="menu">
+ <summary aria-label="その他のページ" class="current"><span>その他</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li class="narrow"><a href="../../ja/start/">はじめかた</a></li>
+ <li class="narrow"><a href="../../ja/start/#server">接続方法</a></li>
+ <li><a href="./" aria-current="page">テーマガイド</a></li>
+ <li><a href="../../ja/how/">しくみ</a></li>
+ <li><a href="../../ja/security/">セキュリティ</a></li>
+ <li><a href="../../ja/faq/">よくある質問</a></li>
+ <li><a href="../../ja/feedback/">ディスカッションとフィードバック</a></li>
+ <li class="sep" role="separator"></li>
+ <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新履歴</a></li>
+ <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
+ </ul>
+ </details>
+ <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="GitHub で PasteFerry にスターを付ける"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
+ <details class="lang">
+ <summary aria-label="言語:日本語"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>日本語</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li><a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
+ <li><a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
+ <li><a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
+ <li><a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a></li>
+ <li><a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja" aria-current="page">日本語</a></li>
+ </ul>
+ </details>
+ </nav>
+ </div>
+ </header>
+
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="../../ja/">PasteFerry</a> / テーマガイド</p>
+ <h1 class="display">変える、作る、<br>AI に作ってもらう。</h1>
+ <p class="lede">PasteFerry 2.10 からテーマに対応しました。デフォルトとピクセルの 2 つを内蔵し、複製して自分好みにしたり、AI に作ってもらったりできます。テーマは設定したデバイスにだけ適用されます。</p>
+ <a class="button" href="../../ja/download/"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>2.10 をダウンロード</a>
+ <p class="more"><a href="#ai">AI でテーマを作る方法へ ↓</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>テーマを変える</h2>
+ <div class="os-grid"><ol class="steps"><li>PasteFerry を開き、<b>設定 › 外観</b> に進みます。</li><li>「内蔵」か「カスタム」のテーマをクリックすると、すぐに切り替わります。クイックペーストも同じテーマになります。</li><li>「ライトとダーク」で <b>システムに合わせる</b>、<b>ライト</b>、<b>ダーク</b> から選びます。</li><li>ピクセルテーマでは <b>走査線</b> もオンにでき、ウインドウ全体に薄い CRT 走査線を重ねます。</li><li>Android ではアプリの <b>設定 › 外観</b> で個別に選びます。パソコンとスマートフォンは互いに影響しません。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/ja/pixel-appearance-dark.png?v=d5bec0d64c" width="2112" height="1472" alt="設定 › 外観:内蔵のデフォルトとピクセル、2 つのカスタムテーマ、テーマを読み込む、AI にテーマを作ってもらう、ライトとダーク、走査線"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>内蔵の 2 つのテーマ</h2>
+ <ul><li><b>デフォルト</b>:これまでの PasteFerry と同じ、落ち着いたシステム風の見た目です。</li><li><b>ピクセル</b>:ドット文字、切り欠きの太枠、立体的なボタン。グラファイトとペーパーの配色にピクセルグリーン。上部には夜や昼の風景、送信中は紙飛行機が飛び、届くと星がはじけます。</li></ul>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/ja/history.png?v=f0f7f7d9f2" width="2112" height="1472" loading="lazy" alt="デフォルトテーマ(ライト)の履歴">
+ <img src="../../assets/screenshots/ja/pixel-history-dark.png?v=06bddfa070" width="2112" height="1472" loading="lazy" alt="ピクセルテーマ(ダーク)の履歴:上部に夜の山と月、サイドバーの下にテントとたき火">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>自分のテーマを作る</h2>
+ <p class="intro">いちばん簡単なのは、内蔵テーマを複製して変える方法です。</p>
+ <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="format"><div class="wrap official-copy">
+ <h2>テーマファイルの中身</h2>
+ <p class="intro">テーマは JSON ファイルです。変えたいところだけ書けば、残りは <code>base</code> のテーマから補われます。次の例はピクセルをもとに、アクセントといくつかの背景色だけを変えています。</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="コピーしました">コピー</button>
+<pre><code>{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}</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>
+ <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">
+ <h2>AI にテーマを作ってもらう</h2>
+ <p class="intro">PasteFerry には MCP サーバー <code>pasteferry-cli mcp</code> が付いています。Claude Desktop、Claude Code、Cursor など MCP に対応した AI アプリに追加し、ほしい見た目をひとことで伝えてください。AI がテーマの形式を読み、配色を考え、コントラストを確認して保存・適用します。</p>
+ <h3>1. pasteferry-cli の場所</h3>
+ <dl class="fields"><dt>Mac</dt><dd><code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(Homebrew の場合は <code>pasteferry-cli</code> だけで可)</dd><dt>Windows</dt><dd><code>%LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe</code></dd><dt>Linux</dt><dd>deb:<code>/usr/bin/pasteferry-cli</code>、tar.gz:展開したフォルダの <code>PasteFerry/pasteferry-cli</code></dd></dl>
+ <p class="note"><b>設定 › 外観 › AI にテーマを作ってもらう</b> から、このパソコン用の設定をそのままコピーすることもできます。</p>
+ <h3>2. AI アプリに追加する</h3>
+ <p>Claude Desktop(設定 › 開発者 › 構成を編集)と Cursor(<code>~/.cursor/mcp.json</code>)は同じ設定です。Mac の例:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="コピーしました">コピー</button>
+<pre><code>{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}</code></pre>
+ </div>
+ <p>Claude Code ではターミナルで実行します。</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="コピーしました">コピー</button>
+<pre><code>claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp</code></pre>
+ </div>
+ <p class="note">設定を変えたら AI アプリを再起動します。PasteFerry は起動したままにしてください。AI はこのパソコンのバックグラウンドサービスを通じてテーマを変えます。</p>
+ <h3>3. ほしいものを伝える</h3>
+ <ul class="prompts"><li>“ネオンピンクと深い紫のサイバーパンク風テーマを作って、適用して。”</li><li>“ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。”</li><li>“今のテーマの灰色の文字が読みにくいので、明るくして。”</li><li>“今のテーマを書き出して見せて。それからライト版も作って。”</li></ul>
+ <h3>AI ができること</h3>
+ <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>
+ <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>
+
+ <footer class="footer">
+ <div class="wrap">
+ <p>PasteFerry は GNU AGPL-3.0 のオープンソースです。</p>
+ <nav aria-label="フッターのリンク">
+ <a href="https://github.com/baiyuze/pasteferry/releases">すべてのリリース</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新履歴</a>
+ <a href="https://pasteferry.cc/design/nat-traversal.html">技術資料(中国語)</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">ライセンス</a>
+ <a href="https://github.com/baiyuze/pasteferry/issues">問題を報告</a>
+ <a href="../../ja/privacy/">プライバシー</a>
+ <a href="../../ja/feedback/">ディスカッションとフィードバック</a>
+ </nav>
+ <nav aria-label="言語">
+ <a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
+ <a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
+ <a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
+ <a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a>
+ <a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja" aria-current="page">日本語</a>
+ </nav>
+ </div>
+ </footer>
+
+ <script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
+ <script src="/assets/analytics.js?v=e2777f714d" defer></script>
+ <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
+</body>
+</html>
diff --git a/docs/lan/index.html b/docs/lan/index.html
index 27aeeef..fd71160 100644
--- a/docs/lan/index.html
+++ b/docs/lan/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/llms.txt b/docs/llms.txt
index ec4ee2a..3fccd13 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -39,6 +39,7 @@ Key facts:
- [README (English)](https://github.com/baiyuze/pasteferry/blob/main/README.md): features and getting started ([中文](https://github.com/baiyuze/pasteferry/blob/main/README.zh-CN.md))
- [How it works](https://github.com/baiyuze/pasteferry/blob/main/guide/how-it-works.md): architecture, NAT traversal, security model, fallbacks, lessons learned
- [Troubleshooting](https://github.com/baiyuze/pasteferry/blob/main/guide/troubleshooting.md) and known limitations
+- [Themes guide](https://pasteferry.cc/en/themes/): change themes, light and dark, make your own theme, the theme file format, and AI-made themes over MCP ([中文](https://pasteferry.cc/themes/), [日本語](https://pasteferry.cc/ja/themes/))
- [Make a theme with AI](https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.md): configure `pasteferry-cli mcp` in Claude Desktop, Claude Code or Cursor ([中文](https://github.com/baiyuze/pasteferry/blob/main/guide/ai-themes.zh-CN.md))
- [Server deployment](https://github.com/baiyuze/pasteferry/blob/main/server/deploy/README.md): Windows, macOS, Linux (systemd), Docker and manual setup
- [Licensing](https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md): AGPL-3.0 terms; versions 1.2.0 and earlier remain MIT
diff --git a/docs/official/index.html b/docs/official/index.html
index a345f90..94ba352 100644
--- a/docs/official/index.html
+++ b/docs/official/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/privacy/index.html b/docs/privacy/index.html
index aa2caac..a8abce4 100644
--- a/docs/privacy/index.html
+++ b/docs/privacy/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/security/index.html b/docs/security/index.html
index 0f85d83..79388f9 100644
--- a/docs/security/index.html
+++ b/docs/security/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="./" aria-current="page">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/server/index.html b/docs/server/index.html
index 712338a..efc4a59 100644
--- a/docs/server/index.html
+++ b/docs/server/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index ef01409..3bc7f2f 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -681,6 +681,51 @@
<xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/feedback/"/>
<xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/feedback/"/>
</url>
+ <url>
+ <loc>https://pasteferry.cc/themes/</loc>
+ <lastmod>2026-11-04</lastmod>
+ <xhtml:link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/"/>
+ <xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/"/>
+ <xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/"/>
+ </url>
+ <url>
+ <loc>https://pasteferry.cc/zh-tw/themes/</loc>
+ <lastmod>2026-11-04</lastmod>
+ <xhtml:link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/"/>
+ <xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/"/>
+ <xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/"/>
+ </url>
+ <url>
+ <loc>https://pasteferry.cc/zh-hk/themes/</loc>
+ <lastmod>2026-11-04</lastmod>
+ <xhtml:link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/"/>
+ <xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/"/>
+ <xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/"/>
+ </url>
+ <url>
+ <loc>https://pasteferry.cc/en/themes/</loc>
+ <lastmod>2026-11-04</lastmod>
+ <xhtml:link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/"/>
+ <xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/"/>
+ <xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/"/>
+ </url>
+ <url>
+ <loc>https://pasteferry.cc/ja/themes/</loc>
+ <lastmod>2026-11-04</lastmod>
+ <xhtml:link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/"/>
+ <xhtml:link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/"/>
+ <xhtml:link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/"/>
+ <xhtml:link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/"/>
+ </url>
<url>
<loc>https://pasteferry.cc/design/nat-traversal.html</loc>
<lastmod>2026-11-04</lastmod>
diff --git a/docs/start/index.html b/docs/start/index.html
index 502c084..f42c2c4 100644
--- a/docs/start/index.html
+++ b/docs/start/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="./" aria-current="page">快速开始</a></li>
<li class="narrow"><a href="#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/tailscale/index.html b/docs/tailscale/index.html
index 50e84e8..7580fd5 100644
--- a/docs/tailscale/index.html
+++ b/docs/tailscale/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../start/">快速开始</a></li>
<li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="../themes/">主题教程</a></li>
<li><a href="../how/">工作原理</a></li>
<li><a href="../security/">安全与隐私</a></li>
<li><a href="../faq/">常见问题</a></li>
diff --git a/docs/themes/index.html b/docs/themes/index.html
new file mode 100644
index 0000000..26007fe
--- /dev/null
+++ b/docs/themes/index.html
@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+ <meta charset="utf-8">
+ <script>
+ (function () {
+ if (location.hostname !== "baiyuze.github.io") return;
+ var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
+ if (!prefix) return;
+ var path = location.pathname.slice(prefix[0].length) || "/";
+ location.replace("https://pasteferry.cc" + path + location.search + location.hash);
+ })();
+ </script>
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>主题与换肤教程 — 隔空贴</title>
+ <meta name="description" content="在隔空贴里换主题、切换浅色深色、做自己的主题,以及让 Claude、Cursor 等 AI 通过 MCP 帮你设计并应用主题。">
+ <link rel="canonical" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/">
+ <meta name="theme-color" content="#141416">
+ <meta property="og:type" content="article">
+ <meta property="og:site_name" content="隔空贴">
+ <meta property="og:title" content="主题与换肤教程 — 隔空贴">
+ <meta property="og:description" content="在隔空贴里换主题、切换浅色深色、做自己的主题,以及让 Claude、Cursor 等 AI 通过 MCP 帮你设计并应用主题。">
+ <meta property="og:url" content="https://pasteferry.cc/themes/">
+ <meta property="og:image" content="https://pasteferry.cc/assets/og.png">
+ <meta property="og:locale" content="zh_CN">
+ <meta name="twitter:card" content="summary_large_image">
+ <link rel="icon" href="../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
+ <link rel="icon" href="../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
+ <link rel="apple-touch-icon" href="../assets/apple-touch-icon.png?v=bcbf406cb8">
+ <link rel="stylesheet" href="../assets/site.css?v=dbae55d27c">
+ <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
+</head>
+<body>
+ <a class="skip" href="#main">跳到正文</a>
+
+ <header class="bar">
+ <div class="wrap">
+ <a class="brand" href=".././" aria-label="隔空贴首页"><img src="../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">隔空贴</a>
+ <nav aria-label="页面导航">
+ <a href="../features/">功能</a>
+ <a class="mid" href="../start/">快速开始</a>
+ <a class="wide" href="../start/#server">连接方式</a>
+ <a href="../download/">下载</a>
+ <details class="menu">
+ <summary aria-label="更多页面" class="current"><span>更多</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li class="narrow"><a href="../start/">快速开始</a></li>
+ <li class="narrow"><a href="../start/#server">连接方式</a></li>
+ <li><a href="./" aria-current="page">主题教程</a></li>
+ <li><a href="../how/">工作原理</a></li>
+ <li><a href="../security/">安全与隐私</a></li>
+ <li><a href="../faq/">常见问题</a></li>
+ <li><a href="../feedback/">讨论与反馈</a></li>
+ <li class="sep" role="separator"></li>
+ <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新记录</a></li>
+ <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
+ </ul>
+ </details>
+ <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="在 GitHub 上给隔空贴点 Star"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
+ <details class="lang">
+ <summary aria-label="语言:简体中文"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>简体中文</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li><a href="../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh" aria-current="page">简体中文</a></li>
+ <li><a href="../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
+ <li><a href="../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
+ <li><a href="../en/themes/" hreflang="en" lang="en" data-lang="en">English</a></li>
+ <li><a href="../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a></li>
+ </ul>
+ </details>
+ </nav>
+ </div>
+ </header>
+
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="../">隔空贴</a> / 主题教程</p>
+ <h1 class="display">换主题,<br>做主题,让 AI 帮你做。</h1>
+ <p class="lede">隔空贴 2.10 起支持主题:自带默认和像素两套,也可以复制一份改成自己的,或者让 AI 帮你配一套。主题只用于设置它的那台设备。</p>
+ <a class="button" href="../download/"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>下载 2.10</a>
+ <p class="more"><a href="#ai">直接看 AI 怎么做主题 ↓</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>换一个主题</h2>
+ <div class="os-grid"><ol class="steps"><li>打开隔空贴,进入 <b>设置 › 外观</b>。</li><li>在「软件自带」或「自定义」里点一张主题卡片,界面马上换好;快捷粘贴窗口也跟着换。</li><li>在「浅色与深色」里选 <b>跟随系统</b>、<b>浅色</b> 或 <b>深色</b>。</li><li>用像素主题时,还可以打开 <b>扫描线</b>,整个窗口叠一层很淡的 CRT 扫描线。</li><li>手机(Android)上在 <b>设置 › 外观</b> 里单独选,电脑和手机互不影响。</li></ol>
+ <figure class="shot"><img src="../assets/screenshots/pixel-appearance-dark.png?v=a89e1bbb7e" width="2112" height="1472" alt="设置 › 外观:自带的默认、像素两套主题,两套自定义主题,导入主题、让 AI 帮你做主题,浅色与深色,扫描线"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>自带的两套主题</h2>
+ <ul><li><b>默认</b>:安静的系统风格,和以前的隔空贴一样。</li><li><b>像素</b>:点阵字、切角粗边、凸起的按钮,石墨与纸两套配色加像素绿;页眉有夜景或白天的场景,发文件时纸飞机飞过去,送达迸出星星。</li></ul>
+ <div class="f-pair">
+ <img src="../assets/screenshots/history.png?v=d423d47d82" width="2112" height="1472" loading="lazy" alt="默认主题(浅色)的复制记录">
+ <img src="../assets/screenshots/pixel-history-dark.png?v=f242b14be0" width="2112" height="1472" loading="lazy" alt="像素主题(深色)的复制记录:页眉是夜里的远山和月亮,侧边栏底下是帐篷和篝火">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>做自己的主题</h2>
+ <p class="intro">最简单的办法是复制一份自带主题再改:</p>
+ <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="format"><div class="wrap official-copy">
+ <h2>主题文件长什么样</h2>
+ <p class="intro">主题是一份 JSON。只写想改的地方就行,没写的从 <code>base</code> 指定的主题补齐。下面这份以像素主题为底,只换了强调色和几处底色:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已复制">复制</button>
+<pre><code>{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}</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>
+ <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">
+ <h2>让 AI 帮你做主题</h2>
+ <p class="intro">隔空贴自带一个 MCP 服务 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支持 MCP 的 AI 应用里,直接用一句话描述你想要的样子,AI 会读取主题格式、配色、检查对比度,再保存并应用。</p>
+ <h3>1. 找到 pasteferry-cli</h3>
+ <dl class="fields"><dt>Mac</dt><dd><code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安装的可以直接写 <code>pasteferry-cli</code>)</dd><dt>Windows</dt><dd><code>%LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe</code></dd><dt>Linux</dt><dd>deb 包:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解压目录里的 <code>PasteFerry/pasteferry-cli</code></dd></dl>
+ <p class="note">也可以在 <b>设置 › 外观 › 让 AI 帮你做主题</b> 里直接复制本机的完整配置,路径已经填好。</p>
+ <h3>2. 加到 AI 应用里</h3>
+ <p>Claude Desktop(设置 › 开发者 › 编辑配置)和 Cursor(<code>~/.cursor/mcp.json</code>)的配置相同,以 Mac 为例:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已复制">复制</button>
+<pre><code>{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}</code></pre>
+ </div>
+ <p>Claude Code 在终端里运行:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已复制">复制</button>
+<pre><code>claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp</code></pre>
+ </div>
+ <p class="note">改完配置后重启 AI 应用。隔空贴要保持运行,AI 通过它在本机的后台服务改主题。</p>
+ <h3>3. 直接说你想要什么</h3>
+ <ul class="prompts"><li>“帮我做一套赛博朋克风的主题,霓虹粉配深紫,然后应用上。”</li><li>“以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。”</li><li>“现在这套主题的灰色文字看不清,帮我调亮一点。”</li><li>“把我的主题导出给我看看,再做一个浅色版本。”</li></ul>
+ <h3>AI 能做什么</h3>
+ <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>
+ <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>
+
+ <footer class="footer">
+ <div class="wrap">
+ <p>隔空贴以 GNU AGPL-3.0 开源。</p>
+ <nav aria-label="页脚链接">
+ <a href="https://github.com/baiyuze/pasteferry/releases">所有版本</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新记录</a>
+ <a href="https://pasteferry.cc/design/nat-traversal.html">技术方案</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">许可说明</a>
+ <a href="https://github.com/baiyuze/pasteferry/issues">反馈问题</a>
+ <a href="../privacy/">隐私说明</a>
+ <a href="../feedback/">讨论与反馈</a>
+ </nav>
+ <nav aria-label="语言">
+ <a href="../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh" aria-current="page">简体中文</a>
+ <a href="../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
+ <a href="../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
+ <a href="../en/themes/" hreflang="en" lang="en" data-lang="en">English</a>
+ <a href="../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a>
+ </nav>
+ </div>
+ </footer>
+
+ <script src="../assets/site.js?v=fb60f6e5ce" defer></script>
+ <script src="/assets/analytics.js?v=e2777f714d" defer></script>
+ <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
+</body>
+</html>
diff --git a/docs/zh-hk/cloud/index.html b/docs/zh-hk/cloud/index.html
index a503c1c..236947f 100644
--- a/docs/zh-hk/cloud/index.html
+++ b/docs/zh-hk/cloud/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/download/index.html b/docs/zh-hk/download/index.html
index 582f86f..6acae28 100644
--- a/docs/zh-hk/download/index.html
+++ b/docs/zh-hk/download/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/faq/index.html b/docs/zh-hk/faq/index.html
index 3bfe105..fe31d0b 100644
--- a/docs/zh-hk/faq/index.html
+++ b/docs/zh-hk/faq/index.html
@@ -171,6 +171,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="./" aria-current="page">常見問題</a></li>
diff --git a/docs/zh-hk/features/index.html b/docs/zh-hk/features/index.html
index 3754863..2fba29f 100644
--- a/docs/zh-hk/features/index.html
+++ b/docs/zh-hk/features/index.html
@@ -58,6 +58,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
@@ -183,6 +184,7 @@
<img src="../../assets/screenshots/zh-hk/pixel-send-dark.png?v=6c6f688ae6" width="2552" height="1632" loading="lazy" alt="像素主題的隔空傳送頁(深色):頁首是夜裏的遠山和月亮,雷達是點陣圓圈,裝置是像素小方塊">
</div>
<p class="f-note">主題只作用於這一部裝置(電腦上包括主視窗和快速貼上視窗),不在裝置之間同步;安卓 App 在自己的「設定 › 外觀」裏單獨揀。像素主題還可以開啟 CRT 掃描線。AI 只能讀寫主題,看不到複製記錄和裝置。</p>
+ <p class="more"><a href="../themes/">主題教學 →</a></p>
</div>
</section>
diff --git a/docs/zh-hk/feedback/index.html b/docs/zh-hk/feedback/index.html
index 30cf2c7..34de246 100644
--- a/docs/zh-hk/feedback/index.html
+++ b/docs/zh-hk/feedback/index.html
@@ -45,6 +45,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/how/index.html b/docs/zh-hk/how/index.html
index f2c0da9..6e56b4f 100644
--- a/docs/zh-hk/how/index.html
+++ b/docs/zh-hk/how/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="./" aria-current="page">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/index.html b/docs/zh-hk/index.html
index 25dbe1a..501dd0b 100644
--- a/docs/zh-hk/index.html
+++ b/docs/zh-hk/index.html
@@ -113,6 +113,7 @@
<ul>
<li class="narrow"><a href="start/">快速開始</a></li>
<li class="narrow"><a href="start/#server">連接方式</a></li>
+ <li><a href="themes/">主題教學</a></li>
<li><a href="how/">運作原理</a></li>
<li><a href="security/">安全與私隱</a></li>
<li><a href="faq/">常見問題</a></li>
@@ -184,7 +185,7 @@
<figure class="spot wide" data-reveal>
<img src="../assets/screenshots/zh-hk/pixel-history-dark.png?v=14cd2ed298" width="2112" height="1472" loading="lazy" alt="像素主題的複製記錄(深色):頁首是夜裏的遠山、松樹和月亮,側邊欄底下有帳篷和營火,字是點陣字型">
</figure>
- <p class="more"><a href="features/#themes">了解主題 →</a></p>
+ <p class="more"><a href="features/#themes">了解主題 →</a><a href="themes/">主題教學 →</a></p>
</div>
</section>
diff --git a/docs/zh-hk/lan/index.html b/docs/zh-hk/lan/index.html
index d41d082..f78fd6d 100644
--- a/docs/zh-hk/lan/index.html
+++ b/docs/zh-hk/lan/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/official/index.html b/docs/zh-hk/official/index.html
index 05cd013..56e68f6 100644
--- a/docs/zh-hk/official/index.html
+++ b/docs/zh-hk/official/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/privacy/index.html b/docs/zh-hk/privacy/index.html
index efc9cf9..b157d41 100644
--- a/docs/zh-hk/privacy/index.html
+++ b/docs/zh-hk/privacy/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/security/index.html b/docs/zh-hk/security/index.html
index 814eb69..fc53e30 100644
--- a/docs/zh-hk/security/index.html
+++ b/docs/zh-hk/security/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="./" aria-current="page">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/server/index.html b/docs/zh-hk/server/index.html
index 9a3aa4c..d0fcde8 100644
--- a/docs/zh-hk/server/index.html
+++ b/docs/zh-hk/server/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/start/index.html b/docs/zh-hk/start/index.html
index 0e0e985..e361d49 100644
--- a/docs/zh-hk/start/index.html
+++ b/docs/zh-hk/start/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="./" aria-current="page">快速開始</a></li>
<li class="narrow"><a href="#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/tailscale/index.html b/docs/zh-hk/tailscale/index.html
index f2d4d22..a2504ad 100644
--- a/docs/zh-hk/tailscale/index.html
+++ b/docs/zh-hk/tailscale/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
<li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="../../zh-hk/themes/">主題教學</a></li>
<li><a href="../../zh-hk/how/">運作原理</a></li>
<li><a href="../../zh-hk/security/">安全與私隱</a></li>
<li><a href="../../zh-hk/faq/">常見問題</a></li>
diff --git a/docs/zh-hk/themes/index.html b/docs/zh-hk/themes/index.html
new file mode 100644
index 0000000..fe34552
--- /dev/null
+++ b/docs/zh-hk/themes/index.html
@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="zh-HK">
+<head>
+ <meta charset="utf-8">
+ <script>
+ (function () {
+ if (location.hostname !== "baiyuze.github.io") return;
+ var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
+ if (!prefix) return;
+ var path = location.pathname.slice(prefix[0].length) || "/";
+ location.replace("https://pasteferry.cc" + path + location.search + location.hash);
+ })();
+ </script>
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>主題與換膚教學 — 隔空貼</title>
+ <meta name="description" content="在隔空貼裏換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。">
+ <link rel="canonical" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/">
+ <meta name="theme-color" content="#141416">
+ <meta property="og:type" content="article">
+ <meta property="og:site_name" content="隔空貼">
+ <meta property="og:title" content="主題與換膚教學 — 隔空貼">
+ <meta property="og:description" content="在隔空貼裏換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。">
+ <meta property="og:url" content="https://pasteferry.cc/zh-hk/themes/">
+ <meta property="og:image" content="https://pasteferry.cc/assets/og-zh-hant.png">
+ <meta property="og:locale" content="zh_HK">
+ <meta name="twitter:card" content="summary_large_image">
+ <link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
+ <link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
+ <link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
+ <link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
+ <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
+</head>
+<body>
+ <a class="skip" href="#main">跳至主要內容</a>
+
+ <header class="bar">
+ <div class="wrap">
+ <a class="brand" href="../../zh-hk/" aria-label="隔空貼首頁"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">隔空貼</a>
+ <nav aria-label="頁面導覽">
+ <a href="../../zh-hk/features/">功能</a>
+ <a class="mid" href="../../zh-hk/start/">快速開始</a>
+ <a class="wide" href="../../zh-hk/start/#server">連接方式</a>
+ <a href="../../zh-hk/download/">下載</a>
+ <details class="menu">
+ <summary aria-label="更多頁面" class="current"><span>更多</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li class="narrow"><a href="../../zh-hk/start/">快速開始</a></li>
+ <li class="narrow"><a href="../../zh-hk/start/#server">連接方式</a></li>
+ <li><a href="./" aria-current="page">主題教學</a></li>
+ <li><a href="../../zh-hk/how/">運作原理</a></li>
+ <li><a href="../../zh-hk/security/">安全與私隱</a></li>
+ <li><a href="../../zh-hk/faq/">常見問題</a></li>
+ <li><a href="../../zh-hk/feedback/">討論與意見</a></li>
+ <li class="sep" role="separator"></li>
+ <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新記錄</a></li>
+ <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
+ </ul>
+ </details>
+ <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="在 GitHub 上給隔空貼按 Star"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
+ <details class="lang">
+ <summary aria-label="語言:繁體中文(香港)"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>繁體中文(香港)</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li><a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
+ <li><a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
+ <li><a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk" aria-current="page">繁體中文(香港)</a></li>
+ <li><a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a></li>
+ <li><a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a></li>
+ </ul>
+ </details>
+ </nav>
+ </div>
+ </header>
+
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="../../zh-hk/">隔空貼</a> / 主題教學</p>
+ <h1 class="display">換主題,<br>做主題,讓 AI 幫你做。</h1>
+ <p class="lede">隔空貼 2.10 起支援主題:內置預設和像素兩套,也可以複製一份改成自己的,或者讓 AI 幫你配一套。主題只用於設定它的那部裝置。</p>
+ <a class="button" href="../../zh-hk/download/"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>下載 2.10</a>
+ <p class="more"><a href="#ai">直接看 AI 點樣做主題 ↓</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>換一個主題</h2>
+ <div class="os-grid"><ol class="steps"><li>打開隔空貼,進入 <b>設定 › 外觀</b>。</li><li>在「內置」或「自訂」裏按一張主題卡片,介面即時換好;快速貼上視窗也跟着換。</li><li>在「淺色與深色」裏選 <b>跟隨系統</b>、<b>淺色</b> 或 <b>深色</b>。</li><li>用像素主題時,還可以開啟 <b>掃描線</b>,整個視窗疊一層很淡的 CRT 掃描線。</li><li>手機(Android)上在 <b>設定 › 外觀</b> 裏單獨選,電腦和手機互不影響。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/zh-hk/pixel-appearance-dark.png?v=6d323fd353" width="2112" height="1472" alt="設定 › 外觀:內置的預設、像素兩套主題,兩套自訂主題,匯入主題、讓 AI 幫你做主題,淺色與深色,掃描線"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>內置的兩套主題</h2>
+ <ul><li><b>預設</b>:安靜的系統風格,和以前的隔空貼一樣。</li><li><b>像素</b>:點陣字、切角粗邊、凸起的按鈕,石墨與紙兩套配色加像素綠;頁首有夜景或日間的場景,傳檔案時紙飛機飛過去,送達迸出星星。</li></ul>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/zh-hk/history.png?v=57e318efb8" width="2112" height="1472" loading="lazy" alt="預設主題(淺色)的複製記錄">
+ <img src="../../assets/screenshots/zh-hk/pixel-history-dark.png?v=14cd2ed298" width="2112" height="1472" loading="lazy" alt="像素主題(深色)的複製記錄:頁首是夜裏的遠山和月亮,側邊欄底下是帳篷和營火">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>做自己的主題</h2>
+ <p class="intro">最簡單的方法是複製一份內置主題再改:</p>
+ <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="format"><div class="wrap official-copy">
+ <h2>主題檔案是怎樣的</h2>
+ <p class="intro">主題是一份 JSON。只寫想改的地方就可以,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}</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>
+ <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">
+ <h2>讓 AI 幫你做主題</h2>
+ <p class="intro">隔空貼內置一個 MCP 服務 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支援 MCP 的 AI 應用程式裏,直接用一句話描述你想要的樣子,AI 會讀取主題格式、配色、檢查對比度,再儲存並套用。</p>
+ <h3>1. 找到 pasteferry-cli</h3>
+ <dl class="fields"><dt>Mac</dt><dd><code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安裝的可以直接寫 <code>pasteferry-cli</code>)</dd><dt>Windows</dt><dd><code>%LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe</code></dd><dt>Linux</dt><dd>deb 套件:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解壓目錄裏的 <code>PasteFerry/pasteferry-cli</code></dd></dl>
+ <p class="note">也可以在 <b>設定 › 外觀 › 讓 AI 幫你做主題</b> 裏直接複製本機的完整設定,路徑已經填好。</p>
+ <h3>2. 加到 AI 應用程式裏</h3>
+ <p>Claude Desktop(設定 › 開發者 › 編輯設定)和 Cursor(<code>~/.cursor/mcp.json</code>)的設定相同,以 Mac 為例:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}</code></pre>
+ </div>
+ <p>Claude Code 在終端機裏執行:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp</code></pre>
+ </div>
+ <p class="note">改完設定後重新啟動 AI 應用程式。隔空貼要保持運行,AI 透過它在本機的背景服務修改主題。</p>
+ <h3>3. 直接說你想要甚麼</h3>
+ <ul class="prompts"><li>“幫我做一套賽博朋克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li></ul>
+ <h3>AI 能做甚麼</h3>
+ <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>
+ <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>
+
+ <footer class="footer">
+ <div class="wrap">
+ <p>隔空貼以 GNU AGPL-3.0 開源。</p>
+ <nav aria-label="頁尾連結">
+ <a href="https://github.com/baiyuze/pasteferry/releases">所有版本</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新記錄</a>
+ <a href="https://pasteferry.cc/design/nat-traversal.html">技術方案</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">授權說明</a>
+ <a href="https://github.com/baiyuze/pasteferry/issues">回報問題</a>
+ <a href="../../zh-hk/privacy/">私隱說明</a>
+ <a href="../../zh-hk/feedback/">討論與意見</a>
+ </nav>
+ <nav aria-label="語言">
+ <a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
+ <a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
+ <a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk" aria-current="page">繁體中文(香港)</a>
+ <a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a>
+ <a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a>
+ </nav>
+ </div>
+ </footer>
+
+ <script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
+ <script src="/assets/analytics.js?v=e2777f714d" defer></script>
+ <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
+</body>
+</html>
diff --git a/docs/zh-tw/cloud/index.html b/docs/zh-tw/cloud/index.html
index fa3d3cd..5120f56 100644
--- a/docs/zh-tw/cloud/index.html
+++ b/docs/zh-tw/cloud/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/download/index.html b/docs/zh-tw/download/index.html
index 600751f..51df023 100644
--- a/docs/zh-tw/download/index.html
+++ b/docs/zh-tw/download/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/faq/index.html b/docs/zh-tw/faq/index.html
index 9a2adfe..1bfe49a 100644
--- a/docs/zh-tw/faq/index.html
+++ b/docs/zh-tw/faq/index.html
@@ -171,6 +171,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="./" aria-current="page">常見問題</a></li>
diff --git a/docs/zh-tw/features/index.html b/docs/zh-tw/features/index.html
index cc991df..6fc7141 100644
--- a/docs/zh-tw/features/index.html
+++ b/docs/zh-tw/features/index.html
@@ -58,6 +58,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
@@ -183,6 +184,7 @@
<img src="../../assets/screenshots/zh-tw/pixel-send-dark.png?v=32499e2fd1" width="2552" height="1632" loading="lazy" alt="像素主題的隔空傳送頁(深色):頁首是夜裡的遠山和月亮,雷達是點陣圓圈,裝置是像素小方塊">
</div>
<p class="f-note">主題只作用於這一台裝置(電腦上包括主視窗和快速貼上視窗),不在裝置之間同步;安卓 App 在自己的「設定 › 外觀」裡單獨選。像素主題還能開啟 CRT 掃描線。AI 只能讀寫主題,看不到複製記錄和裝置。</p>
+ <p class="more"><a href="../themes/">主題教學 →</a></p>
</div>
</section>
diff --git a/docs/zh-tw/feedback/index.html b/docs/zh-tw/feedback/index.html
index 9910c7d..2bc6c18 100644
--- a/docs/zh-tw/feedback/index.html
+++ b/docs/zh-tw/feedback/index.html
@@ -45,6 +45,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/how/index.html b/docs/zh-tw/how/index.html
index 616701b..570845f 100644
--- a/docs/zh-tw/how/index.html
+++ b/docs/zh-tw/how/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="./" aria-current="page">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/index.html b/docs/zh-tw/index.html
index c729219..474e804 100644
--- a/docs/zh-tw/index.html
+++ b/docs/zh-tw/index.html
@@ -113,6 +113,7 @@
<ul>
<li class="narrow"><a href="start/">快速入門</a></li>
<li class="narrow"><a href="start/#server">連線方式</a></li>
+ <li><a href="themes/">主題教學</a></li>
<li><a href="how/">運作原理</a></li>
<li><a href="security/">安全與隱私</a></li>
<li><a href="faq/">常見問題</a></li>
@@ -184,7 +185,7 @@
<figure class="spot wide" data-reveal>
<img src="../assets/screenshots/zh-tw/pixel-history-dark.png?v=7e8c234d01" width="2112" height="1472" loading="lazy" alt="像素主題的複製記錄(深色):頁首是夜裡的遠山、松樹和月亮,側邊欄底下有帳篷和營火,字是點陣字型">
</figure>
- <p class="more"><a href="features/#themes">了解主題 →</a></p>
+ <p class="more"><a href="features/#themes">了解主題 →</a><a href="themes/">主題教學 →</a></p>
</div>
</section>
diff --git a/docs/zh-tw/lan/index.html b/docs/zh-tw/lan/index.html
index 2989da4..dfdd086 100644
--- a/docs/zh-tw/lan/index.html
+++ b/docs/zh-tw/lan/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/official/index.html b/docs/zh-tw/official/index.html
index 0ee2e96..7a15f51 100644
--- a/docs/zh-tw/official/index.html
+++ b/docs/zh-tw/official/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/privacy/index.html b/docs/zh-tw/privacy/index.html
index 3fd46b4..3ab2a06 100644
--- a/docs/zh-tw/privacy/index.html
+++ b/docs/zh-tw/privacy/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/security/index.html b/docs/zh-tw/security/index.html
index 7634aba..6a36e94 100644
--- a/docs/zh-tw/security/index.html
+++ b/docs/zh-tw/security/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="./" aria-current="page">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/server/index.html b/docs/zh-tw/server/index.html
index 1da2a0b..afddb0b 100644
--- a/docs/zh-tw/server/index.html
+++ b/docs/zh-tw/server/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/start/index.html b/docs/zh-tw/start/index.html
index d0c176e..ae0c0e7 100644
--- a/docs/zh-tw/start/index.html
+++ b/docs/zh-tw/start/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="./" aria-current="page">快速入門</a></li>
<li class="narrow"><a href="#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/tailscale/index.html b/docs/zh-tw/tailscale/index.html
index 6d1cb35..77a7751 100644
--- a/docs/zh-tw/tailscale/index.html
+++ b/docs/zh-tw/tailscale/index.html
@@ -51,6 +51,7 @@
<ul>
<li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
<li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="../../zh-tw/themes/">主題教學</a></li>
<li><a href="../../zh-tw/how/">運作原理</a></li>
<li><a href="../../zh-tw/security/">安全與隱私</a></li>
<li><a href="../../zh-tw/faq/">常見問題</a></li>
diff --git a/docs/zh-tw/themes/index.html b/docs/zh-tw/themes/index.html
new file mode 100644
index 0000000..d8b30ad
--- /dev/null
+++ b/docs/zh-tw/themes/index.html
@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="zh-TW">
+<head>
+ <meta charset="utf-8">
+ <script>
+ (function () {
+ if (location.hostname !== "baiyuze.github.io") return;
+ var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
+ if (!prefix) return;
+ var path = location.pathname.slice(prefix[0].length) || "/";
+ location.replace("https://pasteferry.cc" + path + location.search + location.hash);
+ })();
+ </script>
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>主題與換膚教學 — 隔空貼</title>
+ <meta name="description" content="在隔空貼裡換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。">
+ <link rel="canonical" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/themes/">
+ <link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/themes/">
+ <link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/themes/">
+ <link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/themes/">
+ <link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/themes/">
+ <meta name="theme-color" content="#141416">
+ <meta property="og:type" content="article">
+ <meta property="og:site_name" content="隔空貼">
+ <meta property="og:title" content="主題與換膚教學 — 隔空貼">
+ <meta property="og:description" content="在隔空貼裡換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。">
+ <meta property="og:url" content="https://pasteferry.cc/zh-tw/themes/">
+ <meta property="og:image" content="https://pasteferry.cc/assets/og-zh-hant.png">
+ <meta property="og:locale" content="zh_TW">
+ <meta name="twitter:card" content="summary_large_image">
+ <link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
+ <link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
+ <link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
+ <link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
+ <script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
+</head>
+<body>
+ <a class="skip" href="#main">跳到主要內容</a>
+
+ <header class="bar">
+ <div class="wrap">
+ <a class="brand" href="../../zh-tw/" aria-label="隔空貼首頁"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">隔空貼</a>
+ <nav aria-label="頁面導覽">
+ <a href="../../zh-tw/features/">功能</a>
+ <a class="mid" href="../../zh-tw/start/">快速入門</a>
+ <a class="wide" href="../../zh-tw/start/#server">連線方式</a>
+ <a href="../../zh-tw/download/">下載</a>
+ <details class="menu">
+ <summary aria-label="更多頁面" class="current"><span>更多</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li class="narrow"><a href="../../zh-tw/start/">快速入門</a></li>
+ <li class="narrow"><a href="../../zh-tw/start/#server">連線方式</a></li>
+ <li><a href="./" aria-current="page">主題教學</a></li>
+ <li><a href="../../zh-tw/how/">運作原理</a></li>
+ <li><a href="../../zh-tw/security/">安全與隱私</a></li>
+ <li><a href="../../zh-tw/faq/">常見問題</a></li>
+ <li><a href="../../zh-tw/feedback/">討論與回饋</a></li>
+ <li class="sep" role="separator"></li>
+ <li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新記錄</a></li>
+ <li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
+ </ul>
+ </details>
+ <a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="在 GitHub 上給隔空貼點 Star"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
+ <details class="lang">
+ <summary aria-label="語言:繁體中文(台灣)"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>繁體中文(台灣)</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
+ <ul>
+ <li><a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
+ <li><a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw" aria-current="page">繁體中文(台灣)</a></li>
+ <li><a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
+ <li><a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a></li>
+ <li><a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a></li>
+ </ul>
+ </details>
+ </nav>
+ </div>
+ </header>
+
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="../../zh-tw/">隔空貼</a> / 主題教學</p>
+ <h1 class="display">換主題,<br>做主題,讓 AI 幫你做。</h1>
+ <p class="lede">隔空貼 2.10 起支援主題:內建預設和像素兩套,也可以複製一份改成自己的,或者讓 AI 幫你配一套。主題只用於設定它的那台裝置。</p>
+ <a class="button" href="../../zh-tw/download/"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>下載 2.10</a>
+ <p class="more"><a href="#ai">直接看 AI 怎麼做主題 ↓</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>換一個主題</h2>
+ <div class="os-grid"><ol class="steps"><li>打開隔空貼,進入 <b>設定 › 外觀</b>。</li><li>在「內建」或「自訂」裡點一張主題卡片,介面馬上換好;快速貼上視窗也跟著換。</li><li>在「淺色與深色」裡選 <b>跟隨系統</b>、<b>淺色</b> 或 <b>深色</b>。</li><li>用像素主題時,還可以打開 <b>掃描線</b>,整個視窗疊一層很淡的 CRT 掃描線。</li><li>手機(Android)上在 <b>設定 › 外觀</b> 裡單獨選,電腦和手機互不影響。</li></ol>
+ <figure class="shot"><img src="../../assets/screenshots/zh-tw/pixel-appearance-dark.png?v=15888aa7b9" width="2112" height="1472" alt="設定 › 外觀:內建的預設、像素兩套主題,兩套自訂主題,匯入主題、讓 AI 幫你做主題,淺色與深色,掃描線"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>內建的兩套主題</h2>
+ <ul><li><b>預設</b>:安靜的系統風格,和以前的隔空貼一樣。</li><li><b>像素</b>:點陣字、切角粗邊、凸起的按鈕,石墨與紙兩套配色加像素綠;頁首有夜景或白天的場景,傳檔案時紙飛機飛過去,送達迸出星星。</li></ul>
+ <div class="f-pair">
+ <img src="../../assets/screenshots/zh-tw/history.png?v=bb5b4ab8cc" width="2112" height="1472" loading="lazy" alt="預設主題(淺色)的複製記錄">
+ <img src="../../assets/screenshots/zh-tw/pixel-history-dark.png?v=7e8c234d01" width="2112" height="1472" loading="lazy" alt="像素主題(深色)的複製記錄:頁首是夜裡的遠山和月亮,側邊欄底下是帳篷和營火">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>做自己的主題</h2>
+ <p class="intro">最簡單的辦法是複製一份內建主題再改:</p>
+ <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="format"><div class="wrap official-copy">
+ <h2>主題檔案長什麼樣</h2>
+ <p class="intro">主題是一份 JSON。只寫想改的地方就好,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}</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>
+ <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">
+ <h2>讓 AI 幫你做主題</h2>
+ <p class="intro">隔空貼內建一個 MCP 服務 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支援 MCP 的 AI 應用程式裡,直接用一句話描述你想要的樣子,AI 會讀取主題格式、配色、檢查對比度,再儲存並套用。</p>
+ <h3>1. 找到 pasteferry-cli</h3>
+ <dl class="fields"><dt>Mac</dt><dd><code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安裝的可以直接寫 <code>pasteferry-cli</code>)</dd><dt>Windows</dt><dd><code>%LOCALAPPDATA%\Programs\PasteFerry\pasteferry-cli.exe</code></dd><dt>Linux</dt><dd>deb 套件:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解壓目錄裡的 <code>PasteFerry/pasteferry-cli</code></dd></dl>
+ <p class="note">也可以在 <b>設定 › 外觀 › 讓 AI 幫你做主題</b> 裡直接複製本機的完整設定,路徑已經填好。</p>
+ <h3>2. 加到 AI 應用程式裡</h3>
+ <p>Claude Desktop(設定 › 開發者 › 編輯設定)和 Cursor(<code>~/.cursor/mcp.json</code>)的設定相同,以 Mac 為例:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}</code></pre>
+ </div>
+ <p>Claude Code 在終端機裡執行:</p>
+ <div class="code">
+ <button class="copy" type="button" data-done="已複製">複製</button>
+<pre><code>claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp</code></pre>
+ </div>
+ <p class="note">改完設定後重新啟動 AI 應用程式。隔空貼要保持執行,AI 透過它在本機的背景服務修改主題。</p>
+ <h3>3. 直接說你想要什麼</h3>
+ <ul class="prompts"><li>“幫我做一套賽博龐克風的主題,霓虹粉配深紫,然後套用上。”</li><li>“以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。”</li><li>“現在這套主題的灰色文字看不清楚,幫我調亮一點。”</li><li>“把我的主題匯出給我看看,再做一個淺色版本。”</li></ul>
+ <h3>AI 能做什麼</h3>
+ <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>
+ <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>
+
+ <footer class="footer">
+ <div class="wrap">
+ <p>隔空貼以 GNU AGPL-3.0 授權開源。</p>
+ <nav aria-label="頁尾連結">
+ <a href="https://github.com/baiyuze/pasteferry/releases">所有版本</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">更新記錄</a>
+ <a href="https://pasteferry.cc/design/nat-traversal.html">技術說明</a>
+ <a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">授權說明</a>
+ <a href="https://github.com/baiyuze/pasteferry/issues">回報問題</a>
+ <a href="../../zh-tw/privacy/">隱私權說明</a>
+ <a href="../../zh-tw/feedback/">討論與回饋</a>
+ </nav>
+ <nav aria-label="語言">
+ <a href="../../themes/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
+ <a href="../../zh-tw/themes/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw" aria-current="page">繁體中文(台灣)</a>
+ <a href="../../zh-hk/themes/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
+ <a href="../../en/themes/" hreflang="en" lang="en" data-lang="en">English</a>
+ <a href="../../ja/themes/" hreflang="ja" lang="ja" data-lang="ja">日本語</a>
+ </nav>
+ </div>
+ </footer>
+
+ <script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
+ <script src="/assets/analytics.js?v=e2777f714d" defer></script>
+ <script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
+</body>
+</html>
diff --git a/tools/site/build.py b/tools/site/build.py
index cdd0908..49116da 100644
--- a/tools/site/build.py
+++ b/tools/site/build.py
@@ -18,6 +18,7 @@ from pathlib import Path
from content.tour import localized as tour_copy
from content.privacy import COPY as PRIVACY_COPY
+from content.themes import COPY as THEMES_COPY, EXAMPLE as THEME_EXAMPLE, DESKTOP_CONFIG as THEME_DESKTOP, CLAUDE_CODE as THEME_CLAUDE_CODE
from content.official import COPY as OFFICIAL_COPY
from content.features import localized as features_copy
from content.feedback import COPY as FEEDBACK_COPY
@@ -73,8 +74,9 @@ FEATURES = "features/"
HOW = "how/"
SECURITY = "security/"
FAQ = "faq/"
+THEMES = "themes/"
FEEDBACK = "feedback/"
-SUBPAGES = [FEATURES, START, OFFICIAL, LAN, CLOUD, GUIDE, TAILSCALE, DOWNLOAD, TOUR, PRIVACY, HOW, SECURITY, FAQ, FEEDBACK]
+SUBPAGES = [FEATURES, START, OFFICIAL, LAN, CLOUD, GUIDE, TAILSCALE, DOWNLOAD, TOUR, PRIVACY, HOW, SECURITY, FAQ, FEEDBACK, THEMES]
DEPLOY_PAGES = [LAN, CLOUD, GUIDE, TAILSCALE]
# 放到网站上的技术方案:文件名 → 网页名。其他 design/*.md 链接到 GitHub
@@ -313,6 +315,7 @@ def header(c: dict, code: str, up: str, sub: str = "") -> str:
more = [
f'<li class="narrow">{link(START, c["nav_start"])}</li>',
f'<li class="narrow"><a href="{server}">{c["nav_server"]}</a></li>',
+ f'<li>{link(THEMES, THEMES_COPY[code]["name"])}</li>',
f'<li>{link(HOW, c["nav_how"])}</li>',
f'<li>{link(SECURITY, f["nav_security"])}</li>',
f'<li>{link(FAQ, c["nav_faq"])}</li>',
@@ -321,7 +324,7 @@ def header(c: dict, code: str, up: str, sub: str = "") -> str:
f'<li><a href="{REPO}/blob/main/CHANGELOG.md">{f["nav_changelog"]}</a></li>',
f'<li class="narrow-gh"><a href="{REPO}">GitHub</a></li>',
]
- in_more = sub in (HOW, SECURITY, FAQ, FEEDBACK)
+ in_more = sub in (THEMES, HOW, SECURITY, FAQ, FEEDBACK)
return f""" <header class="bar">
<div class="wrap">
@@ -610,7 +613,7 @@ def home(code: str) -> str:
<figure class="spot wide" data-reveal>
<img src="{up}{shots}pixel-history-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(f["home_theme_alt"])}">
</figure>
- <p class="more"><a href="{FEATURES}#themes">{f["home_theme_link"]}</a></p>
+ <p class="more"><a href="{FEATURES}#themes">{f["home_theme_link"]}</a><a href="{THEMES}">{THEMES_COPY[code]["name"]} →</a></p>
</div>
</section>
@@ -940,6 +943,7 @@ def features_page(code: str) -> str:
<img src="{shots}pixel-send-dark.png" width="2552" height="1632" loading="lazy" alt="{esc(f["theme_alt_send"])}">
</div>
<p class="f-note">{f["theme_note"]}</p>
+ <p class="more"><a href="../{THEMES}">{THEMES_COPY[code]["name"]} →</a></p>
</div>
</section>
@@ -2945,6 +2949,85 @@ def privacy_page(code: str) -> str:
+ page_bottom(c, code, PRIVACY))
+def themes_page(code: str) -> str:
+ """主题教程:换主题、做自己的主题、主题文件格式、让 AI 通过 MCP 做主题。文案在 content/themes.py"""
+ c = load(code)
+ t = THEMES_COPY[code]
+ path = LANGS[code][0]
+ up = "../" * (path + THEMES).count("/")
+ base = up + path
+ shots = up + shots_dir(code)
+ ol = lambda xs: "".join(f"<li>{x}</li>" for x in xs)
+ dl = lambda rows: "".join(f"<dt>{k}</dt><dd>{v}</dd>" for k, v in rows)
+ builtin = "".join(f"<li><b>{esc(n)}</b>:{esc(d)}</li>" if code.startswith("zh") or code == "ja"
+ else f"<li><b>{esc(n)}</b>: {esc(d)}</li>" for n, d in t["builtin"])
+ faq = "".join(f"<details><summary>{esc(q)}</summary><p>{esc(a)}</p></details>" for q, a in t["faq"])
+ more = " · ".join(f'<a href="{REPO}/blob/main/{href}">{esc(label)}</a>' for label, href in t["more_links"])
+ return page_top(c, code, THEMES, t["title"], t["summary"]) + f"""
+ <main id="main">
+ <section class="hero guide-hero"><div class="wrap">
+ <p class="crumb"><a href="{base or './'}">{c['brand']}</a> / {esc(t['name'])}</p>
+ <h1 class="display">{t['fit']}</h1>
+ <p class="lede">{esc(t['lede'])}</p>
+ <a class="button" href="{base}{DOWNLOAD}">{DOWN}{esc(t['download'])}</a>
+ <p class="more"><a href="#ai">{esc(t['jump_ai'])}</a></p>
+ </div></section>
+ <section class="section" id="switch"><div class="wrap">
+ <h2>{esc(t['switch_title'])}</h2>
+ <div class="os-grid"><ol class="steps">{ol(t['switch_steps'])}</ol>
+ <figure class="shot"><img src="{shots}pixel-appearance-dark.png" width="2112" height="1472" alt="{esc(t['switch_alt'])}"></figure>
+ </div>
+ </div></section>
+ <section class="section" id="builtin"><div class="wrap official-copy">
+ <h2>{esc(t['builtin_title'])}</h2>
+ <ul>{builtin}</ul>
+ <div class="f-pair">
+ <img src="{shots}history.png" width="2112" height="1472" loading="lazy" alt="{esc(t['builtin_alt_default'])}">
+ <img src="{shots}pixel-history-dark.png" width="2112" height="1472" loading="lazy" alt="{esc(t['builtin_alt_pixel'])}">
+ </div>
+ </div></section>
+ <section class="section" id="custom"><div class="wrap official-copy">
+ <h2>{esc(t['custom_title'])}</h2>
+ <p class="intro">{esc(t['custom_intro'])}</p>
+ <ol class="steps">{ol(t['custom_steps'])}</ol>
+ <p class="note">{esc(t['custom_note'])}</p>
+ </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>
+ {code_block(c, THEME_EXAMPLE)}
+ <h3>{esc(t['file_fields_title'])}</h3>
+ <dl class="fields">{dl(t['file_fields'])}</dl>
+ <p class="note">{esc(t['file_more'])} <a href="{REPO}/blob/main/design/themes.md">design/themes.md</a></p>
+ </div></section>
+ <section class="section" id="ai"><div class="wrap official-copy">
+ <h2>{esc(t['ai_title'])}</h2>
+ <p class="intro">{t['ai_intro']}</p>
+ <h3>{esc(t['ai_step1'])}</h3>
+ <dl class="fields">{dl([(esc(k), v) for k, v in t['ai_paths']])}</dl>
+ <p class="note">{t['ai_paths_note']}</p>
+ <h3>{esc(t['ai_step2'])}</h3>
+ <p>{t['ai_desktop']}</p>
+ {code_block(c, THEME_DESKTOP)}
+ <p>{esc(t['ai_code'])}</p>
+ {code_block(c, THEME_CLAUDE_CODE)}
+ <p class="note">{esc(t['ai_restart'])}</p>
+ <h3>{esc(t['ai_step3'])}</h3>
+ <ul class="prompts">{"".join(f"<li>“{esc(x)}”</li>" for x in t['ai_prompts'])}</ul>
+ <h3>{esc(t['ai_does_title'])}</h3>
+ <ul>{"".join(f"<li>{esc(x)}</li>" for x in t['ai_does'])}</ul>
+ <h3>{esc(t['ai_safe_title'])}</h3>
+ <p>{esc(t['ai_safe'])}</p>
+ </div></section>
+ <section class="section" id="faq"><div class="wrap official-copy">
+ <h2>{esc(t['faq_title'])}</h2>
+ <div class="faq">{faq}</div>
+ <p class="note">{esc(t['more_title'])}:{more}</p>
+ </div></section>
+ </main>
+""" + page_bottom(c, code, THEMES)
+
+
def official_page(code: str) -> str:
c = load(code)
o = c["official"]
@@ -2995,6 +3078,7 @@ def main() -> None:
write(DOCS / path / HOW / "index.html", how_page(code))
write(DOCS / path / SECURITY / "index.html", security_page(code))
write(DOCS / path / FAQ / "index.html", faq_page(code))
+ write(DOCS / path / THEMES / "index.html", themes_page(code))
write(DOCS / path / FEEDBACK / "index.html", feedback_page(code))
for md_name, page in DESIGN_DOCS.items():
write(DOCS / "design" / f"{page}.html", design_page(md_name, page))
diff --git a/tools/site/content/themes.py b/tools/site/content/themes.py
new file mode 100644
index 0000000..7bc569c
--- /dev/null
+++ b/tools/site/content/themes.py
@@ -0,0 +1,466 @@
+"""官网主题教程(themes/),五种语言:怎么换主题、做自己的主题、主题文件的格式、让 AI 通过 MCP 做主题。
+
+写法与其他教程一致:用户视角、一步一句。命令、路径、字段名保持原样。
+用户文档的另一份在 guide/ai-themes*.md,开发说明在 design/themes.md、design/mcp.md。
+"""
+
+# 主题文件的最小例子:以像素主题为底,只换深色的强调色。五种语言共用
+EXAMPLE = """{
+ "schema": 1,
+ "id": "sunset-pixel",
+ "name": { "zh-Hans": "落日像素", "en": "Sunset Pixel" },
+ "base": "pixel",
+ "modes": {
+ "dark": { "accent": "#FF8A5B", "background": "#16110F", "surface": "#1E1714" },
+ "light": { "accent": "#C2410C" }
+ }
+}"""
+
+DESKTOP_CONFIG = """{
+ "mcpServers": {
+ "pasteferry": {
+ "command": "/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli",
+ "args": ["mcp"]
+ }
+ }
+}"""
+
+CLAUDE_CODE = "claude mcp add pasteferry -- /Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli mcp"
+
+COPY = {
+ "zh": {
+ "name": "主题教程",
+ "title": "主题与换肤教程 — 隔空贴",
+ "summary": "在隔空贴里换主题、切换浅色深色、做自己的主题,以及让 Claude、Cursor 等 AI 通过 MCP 帮你设计并应用主题。",
+ "fit": "换主题,<br>做主题,让 AI 帮你做。",
+ "lede": "隔空贴 2.10 起支持主题:自带默认和像素两套,也可以复制一份改成自己的,或者让 AI 帮你配一套。主题只用于设置它的那台设备。",
+ "download": "下载 2.10",
+ "jump_ai": "直接看 AI 怎么做主题 ↓",
+ "switch_title": "换一个主题",
+ "switch_steps": [
+ "打开隔空贴,进入 <b>设置 › 外观</b>。",
+ "在「软件自带」或「自定义」里点一张主题卡片,界面马上换好;快捷粘贴窗口也跟着换。",
+ "在「浅色与深色」里选 <b>跟随系统</b>、<b>浅色</b> 或 <b>深色</b>。",
+ "用像素主题时,还可以打开 <b>扫描线</b>,整个窗口叠一层很淡的 CRT 扫描线。",
+ "手机(Android)上在 <b>设置 › 外观</b> 里单独选,电脑和手机互不影响。",
+ ],
+ "switch_alt": "设置 › 外观:自带的默认、像素两套主题,两套自定义主题,导入主题、让 AI 帮你做主题,浅色与深色,扫描线",
+ "builtin_title": "自带的两套主题",
+ "builtin": [
+ ("默认", "安静的系统风格,和以前的隔空贴一样。"),
+ ("像素", "点阵字、切角粗边、凸起的按钮,石墨与纸两套配色加像素绿;页眉有夜景或白天的场景,发文件时纸飞机飞过去,送达迸出星星。"),
+ ],
+ "builtin_alt_default": "默认主题(浅色)的复制记录",
+ "builtin_alt_pixel": "像素主题(深色)的复制记录:页眉是夜里的远山和月亮,侧边栏底下是帐篷和篝火",
+ "custom_title": "做自己的主题",
+ "custom_intro": "最简单的办法是复制一份自带主题再改:",
+ "custom_steps": [
+ "在 <b>设置 › 外观</b> 里,鼠标移到一张主题卡片上,点右下角的 <b>⋯</b>,选 <b>复制一份</b>。新主题出现在「自定义」里。",
+ "在副本的 <b>⋯</b> 里选 <b>导出…</b>,得到一个 <code>.pasteferry-theme.json</code> 文件。",
+ "用任意文本编辑器改里面的颜色、名字等(格式见下一节)。",
+ "回到外观页,点 <b>导入主题…</b> 选这个文件。同一个 id 会覆盖原来那份,导入后自动应用。",
+ "不要的自定义主题,在 <b>⋯</b> 里选 <b>删除主题</b>。自带主题不能删除。",
+ ],
+ "custom_note": "保存时会检查文字和背景的对比度。看不清的颜色会提示出来,但仍然可以保存。主题文件可以发给朋友,对方导入即可。",
+ "file_title": "主题文件长什么样",
+ "file_intro": "主题是一份 JSON。只写想改的地方就行,没写的从 <code>base</code> 指定的主题补齐。下面这份以像素主题为底,只换了强调色和几处底色:",
+ "file_fields_title": "常用字段",
+ "file_fields": [
+ ("<code>id</code>", "主题的标识,只能用小写字母、数字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。"),
+ ("<code>name</code>", "各语言的名字,比如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。"),
+ ("<code>base</code>", "以哪套主题为底:<code>default</code>、<code>pixel</code> 或另一套自定义主题。"),
+ ("<code>modes.light</code> / <code>modes.dark</code>", "浅色、深色两套颜色,写成 <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>(强调色上的文字)。"),
+ ("<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>。"),
+ ],
+ "file_more": "完整的格式与每个颜色用在哪里:",
+ "ai_title": "让 AI 帮你做主题",
+ "ai_intro": "隔空贴自带一个 MCP 服务 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支持 MCP 的 AI 应用里,直接用一句话描述你想要的样子,AI 会读取主题格式、配色、检查对比度,再保存并应用。",
+ "ai_step1": "1. 找到 pasteferry-cli",
+ "ai_paths": [
+ ("Mac", "<code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安装的可以直接写 <code>pasteferry-cli</code>)"),
+ ("Windows", "<code>%LOCALAPPDATA%\\Programs\\PasteFerry\\pasteferry-cli.exe</code>"),
+ ("Linux", "deb 包:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解压目录里的 <code>PasteFerry/pasteferry-cli</code>"),
+ ],
+ "ai_paths_note": "也可以在 <b>设置 › 外观 › 让 AI 帮你做主题</b> 里直接复制本机的完整配置,路径已经填好。",
+ "ai_step2": "2. 加到 AI 应用里",
+ "ai_desktop": "Claude Desktop(设置 › 开发者 › 编辑配置)和 Cursor(<code>~/.cursor/mcp.json</code>)的配置相同,以 Mac 为例:",
+ "ai_code": "Claude Code 在终端里运行:",
+ "ai_restart": "改完配置后重启 AI 应用。隔空贴要保持运行,AI 通过它在本机的后台服务改主题。",
+ "ai_step3": "3. 直接说你想要什么",
+ "ai_prompts": [
+ "帮我做一套赛博朋克风的主题,霓虹粉配深紫,然后应用上。",
+ "以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。",
+ "现在这套主题的灰色文字看不清,帮我调亮一点。",
+ "把我的主题导出给我看看,再做一个浅色版本。",
+ ],
+ "ai_does_title": "AI 能做什么",
+ "ai_does": [
+ "列出主题、读取某套主题的完整内容;",
+ "读取主题格式说明:每个颜色用在哪里、要和谁达到多少对比度;",
+ "只校验不保存,看看哪对颜色对比度不够;",
+ "保存、应用、删除自定义主题,切换浅色深色;",
+ "导入本机的一张图片作为背景,并分析亮度和主色。",
+ ],
+ "ai_safe_title": "安全范围",
+ "ai_safe": "MCP 服务只在本机运行,不开网络端口。它只能读写主题和背景图,看不到复制记录、设备和好友,也不能改其他设置;背景图只接受本机文件,不会去网上下载。",
+ "faq_title": "常见问题",
+ "faq": [
+ ("主题会同步到我的其他设备吗?", "不会。主题只用于设置它的那台设备。想在别的电脑上用同一套,导出再导入即可。"),
+ ("AI 把主题改乱了怎么办?", "在 设置 › 外观 里点回 默认 或 像素 就恢复了;不要的自定义主题可以删除。"),
+ ("导入时提示文字可能看不清?", "说明有几处文字和底色的对比度偏低。可以照提示改亮或改暗对应的颜色,也可以直接让 AI 帮你调。"),
+ ("旧版本能用主题吗?", "需要 2.10 或更新的版本。设备之间的协议没有变化,新旧版本照常互传。"),
+ ],
+ "more_title": "更多",
+ "more_links": [("让 AI 帮你做主题(详细说明)", "guide/ai-themes.zh-CN.md"), ("主题格式与设计", "design/themes.md"), ("MCP 工具说明", "design/mcp.md")],
+ },
+ "zh-tw": {
+ "name": "主題教學",
+ "title": "主題與換膚教學 — 隔空貼",
+ "summary": "在隔空貼裡換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。",
+ "fit": "換主題,<br>做主題,讓 AI 幫你做。",
+ "lede": "隔空貼 2.10 起支援主題:內建預設和像素兩套,也可以複製一份改成自己的,或者讓 AI 幫你配一套。主題只用於設定它的那台裝置。",
+ "download": "下載 2.10",
+ "jump_ai": "直接看 AI 怎麼做主題 ↓",
+ "switch_title": "換一個主題",
+ "switch_steps": [
+ "打開隔空貼,進入 <b>設定 › 外觀</b>。",
+ "在「內建」或「自訂」裡點一張主題卡片,介面馬上換好;快速貼上視窗也跟著換。",
+ "在「淺色與深色」裡選 <b>跟隨系統</b>、<b>淺色</b> 或 <b>深色</b>。",
+ "用像素主題時,還可以打開 <b>掃描線</b>,整個視窗疊一層很淡的 CRT 掃描線。",
+ "手機(Android)上在 <b>設定 › 外觀</b> 裡單獨選,電腦和手機互不影響。",
+ ],
+ "switch_alt": "設定 › 外觀:內建的預設、像素兩套主題,兩套自訂主題,匯入主題、讓 AI 幫你做主題,淺色與深色,掃描線",
+ "builtin_title": "內建的兩套主題",
+ "builtin": [
+ ("預設", "安靜的系統風格,和以前的隔空貼一樣。"),
+ ("像素", "點陣字、切角粗邊、凸起的按鈕,石墨與紙兩套配色加像素綠;頁首有夜景或白天的場景,傳檔案時紙飛機飛過去,送達迸出星星。"),
+ ],
+ "builtin_alt_default": "預設主題(淺色)的複製記錄",
+ "builtin_alt_pixel": "像素主題(深色)的複製記錄:頁首是夜裡的遠山和月亮,側邊欄底下是帳篷和營火",
+ "custom_title": "做自己的主題",
+ "custom_intro": "最簡單的辦法是複製一份內建主題再改:",
+ "custom_steps": [
+ "在 <b>設定 › 外觀</b> 裡,滑鼠移到一張主題卡片上,點右下角的 <b>⋯</b>,選 <b>複製一份</b>。新主題出現在「自訂」裡。",
+ "在副本的 <b>⋯</b> 裡選 <b>匯出…</b>,得到一個 <code>.pasteferry-theme.json</code> 檔案。",
+ "用任何文字編輯器修改裡面的顏色、名稱等(格式見下一節)。",
+ "回到外觀頁,點 <b>匯入主題…</b> 選這個檔案。同一個 id 會覆蓋原來那份,匯入後自動套用。",
+ "不要的自訂主題,在 <b>⋯</b> 裡選 <b>刪除主題</b>。內建主題不能刪除。",
+ ],
+ "custom_note": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
+ "file_title": "主題檔案長什麼樣",
+ "file_intro": "主題是一份 JSON。只寫想改的地方就好,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
+ "file_fields_title": "常用欄位",
+ "file_fields": [
+ ("<code>id</code>", "主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。"),
+ ("<code>name</code>", "各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。"),
+ ("<code>base</code>", "以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。"),
+ ("<code>modes.light</code> / <code>modes.dark</code>", "淺色、深色兩套顏色,寫成 <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>(強調色上的文字)。"),
+ ("<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>。"),
+ ],
+ "file_more": "完整的格式與每個顏色用在哪裡:",
+ "ai_title": "讓 AI 幫你做主題",
+ "ai_intro": "隔空貼內建一個 MCP 服務 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支援 MCP 的 AI 應用程式裡,直接用一句話描述你想要的樣子,AI 會讀取主題格式、配色、檢查對比度,再儲存並套用。",
+ "ai_step1": "1. 找到 pasteferry-cli",
+ "ai_paths": [
+ ("Mac", "<code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安裝的可以直接寫 <code>pasteferry-cli</code>)"),
+ ("Windows", "<code>%LOCALAPPDATA%\\Programs\\PasteFerry\\pasteferry-cli.exe</code>"),
+ ("Linux", "deb 套件:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解壓目錄裡的 <code>PasteFerry/pasteferry-cli</code>"),
+ ],
+ "ai_paths_note": "也可以在 <b>設定 › 外觀 › 讓 AI 幫你做主題</b> 裡直接複製本機的完整設定,路徑已經填好。",
+ "ai_step2": "2. 加到 AI 應用程式裡",
+ "ai_desktop": "Claude Desktop(設定 › 開發者 › 編輯設定)和 Cursor(<code>~/.cursor/mcp.json</code>)的設定相同,以 Mac 為例:",
+ "ai_code": "Claude Code 在終端機裡執行:",
+ "ai_restart": "改完設定後重新啟動 AI 應用程式。隔空貼要保持執行,AI 透過它在本機的背景服務修改主題。",
+ "ai_step3": "3. 直接說你想要什麼",
+ "ai_prompts": [
+ "幫我做一套賽博龐克風的主題,霓虹粉配深紫,然後套用上。",
+ "以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。",
+ "現在這套主題的灰色文字看不清楚,幫我調亮一點。",
+ "把我的主題匯出給我看看,再做一個淺色版本。",
+ ],
+ "ai_does_title": "AI 能做什麼",
+ "ai_does": [
+ "列出主題、讀取某套主題的完整內容;",
+ "讀取主題格式說明:每個顏色用在哪裡、要和誰達到多少對比度;",
+ "只檢查不儲存,看看哪對顏色對比度不夠;",
+ "儲存、套用、刪除自訂主題,切換淺色深色;",
+ "匯入本機的一張圖片作為背景,並分析亮度和主色。",
+ ],
+ "ai_safe_title": "安全範圍",
+ "ai_safe": "MCP 服務只在本機執行,不開網路連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網路上下載。",
+ "faq_title": "常見問題",
+ "faq": [
+ ("主題會同步到我的其他裝置嗎?", "不會。主題只用於設定它的那台裝置。想在別台電腦上用同一套,匯出再匯入即可。"),
+ ("AI 把主題改亂了怎麼辦?", "在 設定 › 外觀 裡點回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。"),
+ ("匯入時提示文字可能看不清楚?", "代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。"),
+ ("舊版本能用主題嗎?", "需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。"),
+ ],
+ "more_title": "更多",
+ "more_links": [("讓 AI 幫你做主題(詳細說明)", "guide/ai-themes.zh-CN.md"), ("主題格式與設計", "design/themes.md"), ("MCP 工具說明", "design/mcp.md")],
+ },
+ "zh-hk": {
+ "name": "主題教學",
+ "title": "主題與換膚教學 — 隔空貼",
+ "summary": "在隔空貼裏換主題、切換淺色深色、做自己的主題,以及讓 Claude、Cursor 等 AI 透過 MCP 幫你設計並套用主題。",
+ "fit": "換主題,<br>做主題,讓 AI 幫你做。",
+ "lede": "隔空貼 2.10 起支援主題:內置預設和像素兩套,也可以複製一份改成自己的,或者讓 AI 幫你配一套。主題只用於設定它的那部裝置。",
+ "download": "下載 2.10",
+ "jump_ai": "直接看 AI 點樣做主題 ↓",
+ "switch_title": "換一個主題",
+ "switch_steps": [
+ "打開隔空貼,進入 <b>設定 › 外觀</b>。",
+ "在「內置」或「自訂」裏按一張主題卡片,介面即時換好;快速貼上視窗也跟着換。",
+ "在「淺色與深色」裏選 <b>跟隨系統</b>、<b>淺色</b> 或 <b>深色</b>。",
+ "用像素主題時,還可以開啟 <b>掃描線</b>,整個視窗疊一層很淡的 CRT 掃描線。",
+ "手機(Android)上在 <b>設定 › 外觀</b> 裏單獨選,電腦和手機互不影響。",
+ ],
+ "switch_alt": "設定 › 外觀:內置的預設、像素兩套主題,兩套自訂主題,匯入主題、讓 AI 幫你做主題,淺色與深色,掃描線",
+ "builtin_title": "內置的兩套主題",
+ "builtin": [
+ ("預設", "安靜的系統風格,和以前的隔空貼一樣。"),
+ ("像素", "點陣字、切角粗邊、凸起的按鈕,石墨與紙兩套配色加像素綠;頁首有夜景或日間的場景,傳檔案時紙飛機飛過去,送達迸出星星。"),
+ ],
+ "builtin_alt_default": "預設主題(淺色)的複製記錄",
+ "builtin_alt_pixel": "像素主題(深色)的複製記錄:頁首是夜裏的遠山和月亮,側邊欄底下是帳篷和營火",
+ "custom_title": "做自己的主題",
+ "custom_intro": "最簡單的方法是複製一份內置主題再改:",
+ "custom_steps": [
+ "在 <b>設定 › 外觀</b> 裏,滑鼠移到一張主題卡片上,按右下角的 <b>⋯</b>,選 <b>複製一份</b>。新主題出現在「自訂」裏。",
+ "在副本的 <b>⋯</b> 裏選 <b>匯出…</b>,得到一個 <code>.pasteferry-theme.json</code> 檔案。",
+ "用任何文字編輯器修改裏面的顏色、名稱等(格式見下一節)。",
+ "回到外觀頁,按 <b>匯入主題…</b> 選這個檔案。同一個 id 會覆蓋原來那份,匯入後自動套用。",
+ "不要的自訂主題,在 <b>⋯</b> 裏選 <b>刪除主題</b>。內置主題不能刪除。",
+ ],
+ "custom_note": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
+ "file_title": "主題檔案是怎樣的",
+ "file_intro": "主題是一份 JSON。只寫想改的地方就可以,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
+ "file_fields_title": "常用欄位",
+ "file_fields": [
+ ("<code>id</code>", "主題的識別碼,只能用小寫字母、數字和 <code>-</code>;不能是 <code>default</code>、<code>pixel</code>。"),
+ ("<code>name</code>", "各語言的名稱,例如 <code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code>。"),
+ ("<code>base</code>", "以哪套主題為底:<code>default</code>、<code>pixel</code> 或另一套自訂主題。"),
+ ("<code>modes.light</code> / <code>modes.dark</code>", "淺色、深色兩套顏色,寫成 <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>(強調色上的文字)。"),
+ ("<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>。"),
+ ],
+ "file_more": "完整的格式與每個顏色用在哪裏:",
+ "ai_title": "讓 AI 幫你做主題",
+ "ai_intro": "隔空貼內置一個 MCP 服務 <code>pasteferry-cli mcp</code>。把它加到 Claude Desktop、Claude Code、Cursor 等支援 MCP 的 AI 應用程式裏,直接用一句話描述你想要的樣子,AI 會讀取主題格式、配色、檢查對比度,再儲存並套用。",
+ "ai_step1": "1. 找到 pasteferry-cli",
+ "ai_paths": [
+ ("Mac", "<code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(用 Homebrew 安裝的可以直接寫 <code>pasteferry-cli</code>)"),
+ ("Windows", "<code>%LOCALAPPDATA%\\Programs\\PasteFerry\\pasteferry-cli.exe</code>"),
+ ("Linux", "deb 套件:<code>/usr/bin/pasteferry-cli</code>;tar.gz:解壓目錄裏的 <code>PasteFerry/pasteferry-cli</code>"),
+ ],
+ "ai_paths_note": "也可以在 <b>設定 › 外觀 › 讓 AI 幫你做主題</b> 裏直接複製本機的完整設定,路徑已經填好。",
+ "ai_step2": "2. 加到 AI 應用程式裏",
+ "ai_desktop": "Claude Desktop(設定 › 開發者 › 編輯設定)和 Cursor(<code>~/.cursor/mcp.json</code>)的設定相同,以 Mac 為例:",
+ "ai_code": "Claude Code 在終端機裏執行:",
+ "ai_restart": "改完設定後重新啟動 AI 應用程式。隔空貼要保持運行,AI 透過它在本機的背景服務修改主題。",
+ "ai_step3": "3. 直接說你想要甚麼",
+ "ai_prompts": [
+ "幫我做一套賽博朋克風的主題,霓虹粉配深紫,然後套用上。",
+ "以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。",
+ "現在這套主題的灰色文字看不清楚,幫我調亮一點。",
+ "把我的主題匯出給我看看,再做一個淺色版本。",
+ ],
+ "ai_does_title": "AI 能做甚麼",
+ "ai_does": [
+ "列出主題、讀取某套主題的完整內容;",
+ "讀取主題格式說明:每個顏色用在哪裏、要和誰達到多少對比度;",
+ "只檢查不儲存,看看哪對顏色對比度不夠;",
+ "儲存、套用、刪除自訂主題,切換淺色深色;",
+ "匯入本機的一張圖片作為背景,並分析亮度和主色。",
+ ],
+ "ai_safe_title": "安全範圍",
+ "ai_safe": "MCP 服務只在本機運行,不開網絡連接埠。它只能讀寫主題和背景圖,看不到複製記錄、裝置和好友,也不能改其他設定;背景圖只接受本機檔案,不會去網上下載。",
+ "faq_title": "常見問題",
+ "faq": [
+ ("主題會同步到我的其他裝置嗎?", "不會。主題只用於設定它的那部裝置。想在別部電腦上用同一套,匯出再匯入即可。"),
+ ("AI 把主題改亂了怎麼辦?", "在 設定 › 外觀 裏按回 預設 或 像素 就恢復了;不要的自訂主題可以刪除。"),
+ ("匯入時提示文字可能看不清楚?", "代表有幾處文字和底色的對比度偏低。可以照提示把對應的顏色調亮或調暗,也可以直接讓 AI 幫你調。"),
+ ("舊版本能用主題嗎?", "需要 2.10 或更新的版本。裝置之間的協定沒有變化,新舊版本照常互傳。"),
+ ],
+ "more_title": "更多",
+ "more_links": [("讓 AI 幫你做主題(詳細說明)", "guide/ai-themes.zh-CN.md"), ("主題格式與設計", "design/themes.md"), ("MCP 工具說明", "design/mcp.md")],
+ },
+ "en": {
+ "name": "Themes guide",
+ "title": "Themes guide — PasteFerry",
+ "summary": "Change themes in PasteFerry, switch light and dark, make your own theme, and let AI apps such as Claude and Cursor design and apply themes over MCP.",
+ "fit": "Change it, make it,<br>or let an AI make it.",
+ "lede": "From 2.10, PasteFerry has themes: Default and Pixel are built in, you can duplicate one and make it yours, or ask an AI to design one. A theme applies only to the device you set it on.",
+ "download": "Download 2.10",
+ "jump_ai": "Skip to themes made by AI ↓",
+ "switch_title": "Change the theme",
+ "switch_steps": [
+ "Open PasteFerry and go to <b>Settings › Appearance</b>.",
+ "Click a theme under Built in or Custom. The window changes right away, and so does Quick Paste.",
+ "Under Light and dark, choose <b>Match system</b>, <b>Light</b> or <b>Dark</b>.",
+ "With a pixel theme you can also turn on <b>Scanlines</b>, faint CRT lines over the whole window.",
+ "On Android, choose in the app’s own <b>Settings › Appearance</b>; computers and phones don’t affect each other.",
+ ],
+ "switch_alt": "Settings › Appearance: the built-in Default and Pixel themes, two custom themes, Import theme, Ask AI to make a theme, light and dark, and scanlines",
+ "builtin_title": "The two built-in themes",
+ "builtin": [
+ ("Default", "The quiet, system-style look PasteFerry has always had."),
+ ("Pixel", "Bitmap type, notched borders and bevelled buttons, graphite and paper palettes with pixel green. A night or daytime scene up top, a paper plane while sending and a burst of stars when it arrives."),
+ ],
+ "builtin_alt_default": "History in the Default theme (light)",
+ "builtin_alt_pixel": "History in the Pixel theme (dark): mountains and a moon in the header, a tent and campfire at the bottom of the sidebar",
+ "custom_title": "Make your own theme",
+ "custom_intro": "The easiest way is to duplicate a built-in theme and change it:",
+ "custom_steps": [
+ "In <b>Settings › Appearance</b>, hover over a theme, click <b>⋯</b> and choose <b>Duplicate</b>. The copy appears under Custom.",
+ "In the copy’s <b>⋯</b> menu, choose <b>Export…</b> to save a <code>.pasteferry-theme.json</code> file.",
+ "Change the colors, name and so on in any text editor (the format is described below).",
+ "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.",
+ "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.",
+ "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",
+ "file_fields": [
+ ("<code>id</code>", "The theme’s identifier: lowercase letters, digits and <code>-</code>. It can’t be <code>default</code> or <code>pixel</code>."),
+ ("<code>name</code>", "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>."),
+ ("<code>base</code>", "The theme to start from: <code>default</code>, <code>pixel</code> or another custom theme."),
+ ("<code>modes.light</code> / <code>modes.dark</code>", "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)."),
+ ("<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>."),
+ ],
+ "file_more": "The full format and where each color is used:",
+ "ai_title": "Let an AI make a theme",
+ "ai_intro": "PasteFerry includes an MCP server, <code>pasteferry-cli mcp</code>. Add it to an AI app that supports MCP, such as Claude Desktop, Claude Code or Cursor, and describe the look you want in one sentence. The AI reads the theme format, picks colors, checks contrast, then saves and applies the theme.",
+ "ai_step1": "1. Find pasteferry-cli",
+ "ai_paths": [
+ ("Mac", "<code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code> (with Homebrew, just <code>pasteferry-cli</code>)"),
+ ("Windows", "<code>%LOCALAPPDATA%\\Programs\\PasteFerry\\pasteferry-cli.exe</code>"),
+ ("Linux", "deb: <code>/usr/bin/pasteferry-cli</code>; tar.gz: <code>PasteFerry/pasteferry-cli</code> in the extracted folder"),
+ ],
+ "ai_paths_note": "Or copy the ready-made configuration for this computer from <b>Settings › Appearance › Ask AI to make a theme</b>.",
+ "ai_step2": "2. Add it to your AI app",
+ "ai_desktop": "Claude Desktop (Settings › Developer › Edit Config) and Cursor (<code>~/.cursor/mcp.json</code>) use the same configuration. On a Mac:",
+ "ai_code": "For Claude Code, run in a terminal:",
+ "ai_restart": "Restart the AI app after changing its configuration. Keep PasteFerry running: the AI changes themes through its background service on this computer.",
+ "ai_step3": "3. Say what you want",
+ "ai_prompts": [
+ "Make me a cyberpunk theme with neon pink and deep purple, then apply it.",
+ "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.",
+ ],
+ "ai_does_title": "What the AI can do",
+ "ai_does": [
+ "list themes and read a theme in full;",
+ "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.",
+ ],
+ "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.",
+ "faq_title": "Questions",
+ "faq": [
+ ("Are themes synced to my other devices?", "No. A theme applies only to the device you set it on. To use the same theme elsewhere, export it and import it there."),
+ ("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."),
+ ],
+ "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")],
+ },
+ "ja": {
+ "name": "テーマガイド",
+ "title": "テーマガイド — PasteFerry",
+ "summary": "PasteFerry でテーマを変える、ライトとダークを切り替える、自分のテーマを作る、Claude や Cursor などの AI に MCP でテーマを作って適用してもらう方法。",
+ "fit": "変える、作る、<br>AI に作ってもらう。",
+ "lede": "PasteFerry 2.10 からテーマに対応しました。デフォルトとピクセルの 2 つを内蔵し、複製して自分好みにしたり、AI に作ってもらったりできます。テーマは設定したデバイスにだけ適用されます。",
+ "download": "2.10 をダウンロード",
+ "jump_ai": "AI でテーマを作る方法へ ↓",
+ "switch_title": "テーマを変える",
+ "switch_steps": [
+ "PasteFerry を開き、<b>設定 › 外観</b> に進みます。",
+ "「内蔵」か「カスタム」のテーマをクリックすると、すぐに切り替わります。クイックペーストも同じテーマになります。",
+ "「ライトとダーク」で <b>システムに合わせる</b>、<b>ライト</b>、<b>ダーク</b> から選びます。",
+ "ピクセルテーマでは <b>走査線</b> もオンにでき、ウインドウ全体に薄い CRT 走査線を重ねます。",
+ "Android ではアプリの <b>設定 › 外観</b> で個別に選びます。パソコンとスマートフォンは互いに影響しません。",
+ ],
+ "switch_alt": "設定 › 外観:内蔵のデフォルトとピクセル、2 つのカスタムテーマ、テーマを読み込む、AI にテーマを作ってもらう、ライトとダーク、走査線",
+ "builtin_title": "内蔵の 2 つのテーマ",
+ "builtin": [
+ ("デフォルト", "これまでの PasteFerry と同じ、落ち着いたシステム風の見た目です。"),
+ ("ピクセル", "ドット文字、切り欠きの太枠、立体的なボタン。グラファイトとペーパーの配色にピクセルグリーン。上部には夜や昼の風景、送信中は紙飛行機が飛び、届くと星がはじけます。"),
+ ],
+ "builtin_alt_default": "デフォルトテーマ(ライト)の履歴",
+ "builtin_alt_pixel": "ピクセルテーマ(ダーク)の履歴:上部に夜の山と月、サイドバーの下にテントとたき火",
+ "custom_title": "自分のテーマを作る",
+ "custom_intro": "いちばん簡単なのは、内蔵テーマを複製して変える方法です。",
+ "custom_steps": [
+ "<b>設定 › 外観</b> でテーマにポインタを合わせ、<b>⋯</b> から <b>複製</b> を選びます。複製は「カスタム」に表示されます。",
+ "複製の <b>⋯</b> から <b>書き出す…</b> を選び、<code>.pasteferry-theme.json</code> ファイルを保存します。",
+ "テキストエディタで色や名前などを変えます(形式は次の節を参照)。",
+ "外観のページに戻り、<b>テーマを読み込む…</b> でファイルを選びます。同じ id のテーマは置き換えられ、読み込んだテーマが適用されます。",
+ "不要なカスタムテーマは <b>⋯</b> から <b>テーマを削除</b> を選びます。内蔵テーマは削除できません。",
+ ],
+ "custom_note": "保存時に文字のコントラストを確認し、読みにくい色を知らせます(そのまま保存もできます)。テーマファイルは共有でき、相手は読み込むだけで使えます。",
+ "file_title": "テーマファイルの中身",
+ "file_intro": "テーマは JSON ファイルです。変えたいところだけ書けば、残りは <code>base</code> のテーマから補われます。次の例はピクセルをもとに、アクセントといくつかの背景色だけを変えています。",
+ "file_fields_title": "よく使う項目",
+ "file_fields": [
+ ("<code>id</code>", "テーマの識別子。小文字、数字、<code>-</code> のみで、<code>default</code> と <code>pixel</code> は使えません。"),
+ ("<code>name</code>", "各言語の名前。<code>zh-Hans</code>、<code>zh-Hant-TW</code>、<code>zh-Hant-HK</code>、<code>en</code>、<code>ja</code> など。"),
+ ("<code>base</code>", "もとにするテーマ:<code>default</code>、<code>pixel</code>、またはほかのカスタムテーマ。"),
+ ("<code>modes.light</code> / <code>modes.dark</code>", "ライトとダークの色。<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>(アクセント上の文字)。"),
+ ("<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>。"),
+ ],
+ "file_more": "完全な形式と各色の使われる場所:",
+ "ai_title": "AI にテーマを作ってもらう",
+ "ai_intro": "PasteFerry には MCP サーバー <code>pasteferry-cli mcp</code> が付いています。Claude Desktop、Claude Code、Cursor など MCP に対応した AI アプリに追加し、ほしい見た目をひとことで伝えてください。AI がテーマの形式を読み、配色を考え、コントラストを確認して保存・適用します。",
+ "ai_step1": "1. pasteferry-cli の場所",
+ "ai_paths": [
+ ("Mac", "<code>/Applications/PasteFerry.app/Contents/Helpers/pasteferry-cli</code>(Homebrew の場合は <code>pasteferry-cli</code> だけで可)"),
+ ("Windows", "<code>%LOCALAPPDATA%\\Programs\\PasteFerry\\pasteferry-cli.exe</code>"),
+ ("Linux", "deb:<code>/usr/bin/pasteferry-cli</code>、tar.gz:展開したフォルダの <code>PasteFerry/pasteferry-cli</code>"),
+ ],
+ "ai_paths_note": "<b>設定 › 外観 › AI にテーマを作ってもらう</b> から、このパソコン用の設定をそのままコピーすることもできます。",
+ "ai_step2": "2. AI アプリに追加する",
+ "ai_desktop": "Claude Desktop(設定 › 開発者 › 構成を編集)と Cursor(<code>~/.cursor/mcp.json</code>)は同じ設定です。Mac の例:",
+ "ai_code": "Claude Code ではターミナルで実行します。",
+ "ai_restart": "設定を変えたら AI アプリを再起動します。PasteFerry は起動したままにしてください。AI はこのパソコンのバックグラウンドサービスを通じてテーマを変えます。",
+ "ai_step3": "3. ほしいものを伝える",
+ "ai_prompts": [
+ "ネオンピンクと深い紫のサイバーパンク風テーマを作って、適用して。",
+ "ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。",
+ "今のテーマの灰色の文字が読みにくいので、明るくして。",
+ "今のテーマを書き出して見せて。それからライト版も作って。",
+ ],
+ "ai_does_title": "AI ができること",
+ "ai_does": [
+ "テーマの一覧と、テーマの完全な内容の読み取り",
+ "テーマ形式の説明(各色の使われる場所と必要なコントラスト)の読み取り",
+ "保存せずに確認し、コントラストが足りない色を見つける",
+ "カスタムテーマの保存・適用・削除、ライトとダークの切り替え",
+ "このパソコンの画像を背景として読み込み、明るさと主な色を分析",
+ ],
+ "ai_safe_title": "できないこと",
+ "ai_safe": "MCP サーバーはこのパソコンの中だけで動き、ネットワークのポートは開きません。扱えるのはテーマと背景画像だけで、履歴、デバイス、友だちは見えず、ほかの設定も変えられません。背景画像はローカルのファイルのみで、インターネットからは取得しません。",
+ "faq_title": "よくある質問",
+ "faq": [
+ ("テーマはほかのデバイスに同期されますか?", "されません。テーマは設定したデバイスだけに適用されます。別のパソコンで使うときは、書き出して読み込んでください。"),
+ ("AI がテーマを崩してしまいました。", "設定 › 外観 でデフォルトかピクセルを選べば戻ります。不要なカスタムテーマは削除できます。"),
+ ("読み込み時に「読みにくい」と表示されます。", "文字と背景のコントラストが低いところがあります。表示に従って色を明るく・暗くするか、AI に直してもらってください。"),
+ ("古いバージョンでもテーマは使えますか?", "2.10 以降が必要です。デバイス間のプロトコルは変わっていないので、新旧のバージョンは引き続き連携できます。"),
+ ],
+ "more_title": "さらに詳しく",
+ "more_links": [("AI でテーマを作る(詳しいガイド)", "guide/ai-themes.md"), ("テーマの形式と設計", "design/themes.md"), ("MCP ツール", "design/mcp.md")],
+ },
+}