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.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
"""官网主题教程(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": "保存时会检查文字和背景的对比度。看不清的颜色会提示出来,但仍然可以保存。主题文件可以发给朋友,对方导入即可。",
"bg_title": "换背景图",
"bg_steps": [
"进入 <b>设置 › 外观</b>,滚到 <b>背景图</b>,点 <b>选择图片…</b>,选一张 JPEG、PNG 或 GIF。",
"图片铺满侧边栏和页面后面,侧边栏和列表底板变成半透明。正在用自带主题时,会先复制一份再改,自带主题本身不变。",
"<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三档;<b>用图片配色</b> 把强调色换成图片的主色;也可以让 <b>快捷粘贴窗口也显示</b>。",
"不想要了点 <b>移除</b>。手机上在 <b>设置 › 外观 › 背景图</b> 里选照片。",
],
"bg_note": "文字始终看得清:隔空贴按主题的文字颜色和这张图,算出遮罩至少要多浓,只会比它更浓。深色的图配深色模式、浅色的图配浅色模式,图露得最多。",
"bg_alt": "像素主题深色模式铺了一张落日山景的背景图:侧边栏和列表半透明,图从后面透出来",
"bg_alt2": "设置 › 外观 › 背景图:更换、移除,模糊、遮罩、面板三档,用图片配色,快捷粘贴窗口也显示",
"scene_title": "换风景",
"scene_steps": [
"风景是页面顶部那条宽图和侧边栏底部的小图。像素主题这里默认画像素风景和小营地,其他主题默认没有。",
"在 <b>设置 › 外观 › 风景</b> 里,<b>页面顶部</b>、<b>侧边栏底部</b> 各点 <b>选择图片…</b> 换成自己的图,任何主题都能用。页面标题会自动盖一层遮罩,字照样看得清。",
"<b>恢复默认</b> 换回原来的样子;关掉 <b>显示风景</b> 两处都不画。设置了整窗背景图时不显示风景。",
],
"scene_alt": "像素主题深色模式:页面顶部和侧边栏底部换成了落日山景的图",
"file_title": "主题文件长什么样",
"file_intro": "主题是一份 JSON。只写想改的地方就行,没写的从 <code>base</code> 指定的主题补齐。下面这份以像素主题为底,只换了强调色和几处底色:",
"file_fields_title": "常用字段",
"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>。"),
("<code>background</code>", "整窗背景图:<code>image</code>(导入后的 <code>user:<sha256></code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些窗口显示)、<code>accentFromImage</code>。"),
("<code>scenery</code>、<code>scene</code>", "风景开关,以及换成自己的图:<code>scene.header</code>(页面顶部)、<code>scene.sidebar</code>(侧边栏底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式与每个颜色用在哪里:",
"ai_title": "让 AI 帮你做主题",
"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": [
"帮我做一套赛博朋克风的主题,霓虹粉配深紫,然后应用上。",
"以像素主题为底,做一套落日色调的,深色模式用暖一点的底色。",
"现在这套主题的灰色文字看不清,帮我调亮一点。",
"把我的主题导出给我看看,再做一个浅色版本。",
"用 ~/Pictures/海边.jpg 当背景,按照片的颜色配一套主题。",
"把像素主题顶部的风景换成 ~/Pictures/雪山.png。",
],
"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": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
"bg_title": "換背景圖",
"bg_steps": [
"進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,點 <b>選擇圖片…</b>,選一張 JPEG、PNG 或 GIF。",
"圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內建主題時,會先複製一份再改,內建主題本身不變。",
"<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;也可以讓 <b>快速貼上視窗也顯示</b>。",
"不想要了點 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裡選照片。",
],
"bg_note": "文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,算出遮罩至少要多濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。",
"bg_alt": "像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來",
"bg_alt2": "設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示",
"scene_title": "換風景",
"scene_steps": [
"風景是頁面頂部那條寬圖和側邊欄底部的小圖。像素主題這裡預設畫像素風景和小營地,其他主題預設沒有。",
"在 <b>設定 › 外觀 › 風景</b> 裡,<b>頁面頂部</b>、<b>側邊欄底部</b> 各點 <b>選擇圖片…</b> 換成自己的圖,任何主題都能用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。",
"<b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。",
],
"scene_alt": "像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖",
"file_title": "主題檔案長什麼樣",
"file_intro": "主題是一份 JSON。只寫想改的地方就好,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
"file_fields_title": "常用欄位",
"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>。"),
("<code>background</code>", "整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:<sha256></code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。"),
("<code>scenery</code>、<code>scene</code>", "風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式與每個顏色用在哪裡:",
"ai_title": "讓 AI 幫你做主題",
"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": [
"幫我做一套賽博龐克風的主題,霓虹粉配深紫,然後套用上。",
"以像素主題為底,做一套落日色調的,深色模式用暖一點的底色。",
"現在這套主題的灰色文字看不清楚,幫我調亮一點。",
"把我的主題匯出給我看看,再做一個淺色版本。",
"用 ~/Pictures/海邊.jpg 當背景,按照片的顏色配一套主題。",
"把像素主題頂部的風景換成 ~/Pictures/雪山.png。",
],
"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": "儲存時會檢查文字和背景的對比度。看不清楚的顏色會提示出來,但仍然可以儲存。主題檔案可以傳給朋友,對方匯入即可。",
"bg_title": "換背景圖",
"bg_steps": [
"進入 <b>設定 › 外觀</b>,捲到 <b>背景圖</b>,按 <b>選擇圖片…</b>,揀一張 JPEG、PNG 或 GIF。",
"圖片鋪滿側邊欄和頁面後面,側邊欄和列表底板變成半透明。正在用內置主題時,會先複製一份再改,內置主題本身不變。",
"<b>模糊</b>、<b>遮罩</b>、<b>面板</b> 各有三檔;<b>用圖片配色</b> 把強調色換成圖片的主色;亦可以讓 <b>快速貼上視窗也顯示</b>。",
"唔想要就按 <b>移除</b>。手機上在 <b>設定 › 外觀 › 背景圖</b> 裏揀相片。",
],
"bg_note": "文字始終看得清楚:隔空貼按主題的文字顏色和這張圖,計出遮罩最少要幾濃,只會比它更濃。深色的圖配深色模式、淺色的圖配淺色模式,圖露得最多。",
"bg_alt": "像素主題深色模式鋪了一張落日山景的背景圖:側邊欄和列表半透明,圖從後面透出來",
"bg_alt2": "設定 › 外觀 › 背景圖:更換、移除,模糊、遮罩、面板三檔,用圖片配色,快速貼上視窗也顯示",
"scene_title": "換風景",
"scene_steps": [
"風景是頁面頂部那條闊圖和側邊欄底部的小圖。像素主題這裏預設畫像素風景和小營地,其他主題預設沒有。",
"在 <b>設定 › 外觀 › 風景</b> 裏,<b>頁面頂部</b>、<b>側邊欄底部</b> 各按 <b>選擇圖片…</b> 換成自己的圖,任何主題都可以用。頁面標題會自動蓋一層遮罩,字照樣看得清楚。",
"<b>恢復預設</b> 換回原來的樣子;關掉 <b>顯示風景</b> 兩處都不畫。設定了整個視窗的背景圖時不顯示風景。",
],
"scene_alt": "像素主題深色模式:頁面頂部和側邊欄底部換成了落日山景的圖",
"file_title": "主題檔案是怎樣的",
"file_intro": "主題是一份 JSON。只寫想改的地方就可以,沒寫的從 <code>base</code> 指定的主題補齊。下面這份以像素主題為底,只換了強調色和幾處底色:",
"file_fields_title": "常用欄位",
"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>。"),
("<code>background</code>", "整個視窗的背景圖:<code>image</code>(匯入後的 <code>user:<sha256></code>)、<code>blur</code>、<code>scrim</code>(遮罩)、<code>surfaceOpacity</code>(面板不透明度)、<code>scope</code>(哪些視窗顯示)、<code>accentFromImage</code>。"),
("<code>scenery</code>、<code>scene</code>", "風景開關,以及換成自己的圖:<code>scene.header</code>(頁面頂部)、<code>scene.sidebar</code>(側邊欄底部),深色模式可另配 <code>headerDark</code>、<code>sidebarDark</code>。"),
],
"file_more": "完整的格式與每個顏色用在哪裏:",
"ai_title": "讓 AI 幫你做主題",
"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": [
"幫我做一套賽博朋克風的主題,霓虹粉配深紫,然後套用上。",
"以像素主題為底,做一套日落色調的,深色模式用暖一點的底色。",
"現在這套主題的灰色文字看不清楚,幫我調亮一點。",
"把我的主題匯出給我看看,再做一個淺色版本。",
"用 ~/Pictures/海邊.jpg 做背景,按相片的顏色配一套主題。",
"把像素主題頂部的風景換成 ~/Pictures/雪山.png。",
],
"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.",
"bg_title": "Use a background image",
"bg_steps": [
"Open <b>Settings › Appearance</b>, scroll to <b>Background image</b>, click <b>Choose Image…</b> and pick a JPEG, PNG or GIF.",
"The image fills the window behind the sidebar and pages, and the sidebar and lists become translucent. If a built-in theme is in use, a copy is made first; the built-in theme itself stays the same.",
"<b>Blur</b>, <b>Scrim</b> and <b>Panels</b> have three steps each. <b>Use image colors</b> takes the accent color from the image, and <b>Also show in Quick Paste</b> shows it there too.",
"Click <b>Remove</b> to go back. On Android, pick a photo under <b>Settings › Appearance › Background image</b>.",
],
"bg_note": "Text always stays readable: PasteFerry works out how strong the scrim must be for the theme's text colors on this image and never shows it lighter. Dark images with dark mode, and light images with light mode, show the most of the picture.",
"bg_alt": "Pixel theme in dark mode with a sunset hills background: the sidebar and list are translucent and the picture shows through",
"bg_alt2": "Settings › Appearance › Background image: change, remove, three steps for blur, scrim and panels, use image colors, also show in Quick Paste",
"scene_title": "Change the scenery",
"scene_steps": [
"The scenery is the wide picture at the top of pages and the small one at the bottom of the sidebar. The pixel theme draws a pixel landscape and a small camp there; other themes have none.",
"Under <b>Settings › Appearance › Scenery</b>, click <b>Choose Image…</b> next to <b>Page header</b> or <b>Sidebar bottom</b> to use your own pictures, with any theme. A scrim is added under the page title so it stays readable.",
"<b>Reset</b> brings back the original; turn off <b>Show scenery</b> to hide both. Scenery is hidden while a background image fills the window.",
],
"scene_alt": "Pixel theme in dark mode with the page header and sidebar bottom replaced by a sunset hills picture",
"file_title": "What a theme file looks like",
"file_intro": "A theme is a JSON file. Write only what you want to change; everything else comes from the theme named in <code>base</code>. This one starts from Pixel and changes the accent and a few backgrounds:",
"file_fields_title": "Common fields",
"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>."),
("<code>background</code>", "Window background image: <code>image</code> (<code>user:<sha256></code> after importing), <code>blur</code>, <code>scrim</code>, <code>surfaceOpacity</code> (panel opacity), <code>scope</code> (which windows show it), <code>accentFromImage</code>."),
("<code>scenery</code>, <code>scene</code>", "Scenery on/off, and your own pictures: <code>scene.header</code> (page header) and <code>scene.sidebar</code> (sidebar bottom), with optional <code>headerDark</code> and <code>sidebarDark</code> for dark mode."),
],
"file_more": "The full format and where each color is used:",
"ai_title": "Let an AI make a theme",
"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.",
"Use ~/Pictures/beach.jpg as the background and match the colors to the photo.",
"Replace the pixel theme's header landscape with ~/Pictures/mountains.png.",
],
"ai_does_title": "What the AI can do",
"ai_does": [
"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 a picture from this computer as a window background or scenery, and analyze its brightness and main colors.",
],
"ai_safe_title": "What it can’t do",
"ai_safe": "The MCP server runs only on this computer and opens no network port. It can read and write themes and background images only: it can’t see your history, devices or friends, or change other settings. Background images must be local files; nothing is downloaded from the internet.",
"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."),
("Will text be hard to read on my picture?", "No. The scrim strength is worked out from the theme's text colors and is never lighter than needed. For a busy picture, raise the blur or panel opacity."),
],
"more_title": "More",
"more_links": [("Let an AI make a theme (full guide)", "guide/ai-themes.md"), ("Theme format and design", "design/themes.md"), ("MCP tools", "design/mcp.md")],
},
"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": "保存時に文字のコントラストを確認し、読みにくい色を知らせます(そのまま保存もできます)。テーマファイルは共有でき、相手は読み込むだけで使えます。",
"bg_title": "背景画像を使う",
"bg_steps": [
"<b>設定 › 外観</b> を開き、<b>背景画像</b> までスクロールして <b>画像を選択…</b> を押し、JPEG、PNG、GIF を選びます。",
"画像がサイドバーとページの後ろに敷かれ、サイドバーとリストの下地は半透明になります。内蔵テーマを使っているときは、先に複製してから変更します(内蔵テーマ自体は変わりません)。",
"<b>ぼかし</b>、<b>スクリム</b>、<b>パネル</b> はそれぞれ 3 段階。<b>画像の色を使う</b> でアクセントカラーを画像の主な色に、<b>クイックペーストにも表示</b> でそちらにも表示します。",
"やめるときは <b>削除</b>。Android では <b>設定 › 外観 › 背景画像</b> で写真を選びます。",
],
"bg_note": "文字は常に読みやすいまま:テーマの文字色とこの画像から必要なスクリムの濃さを計算し、それより薄くはしません。暗い画像はダークモード、明るい画像はライトモードと組み合わせると画像がよく見えます。",
"bg_alt": "ダークモードのピクセルテーマに夕焼けの山の背景画像:サイドバーとリストが半透明で、画像が透けて見える",
"bg_alt2": "設定 › 外観 › 背景画像:変更、削除、ぼかし・スクリム・パネルの 3 段階、画像の色を使う、クイックペーストにも表示",
"scene_title": "風景を変える",
"scene_steps": [
"風景とは、ページ上部の横長の画像とサイドバー下部の小さな画像です。ピクセルテーマではピクセルの風景と小さなキャンプを描き、ほかのテーマにはありません。",
"<b>設定 › 外観 › 風景</b> で <b>ページ上部</b>、<b>サイドバー下部</b> の <b>画像を選択…</b> を押すと自分の画像に変えられます(どのテーマでも可)。ページタイトルが読めるようにスクリムを自動で重ねます。",
"<b>元に戻す</b> で元の絵に、<b>風景を表示</b> をオフにすると両方とも消えます。ウインドウ全体の背景画像があるときは風景を表示しません。",
],
"scene_alt": "ダークモードのピクセルテーマ:ページ上部とサイドバー下部を夕焼けの山の画像に変えたところ",
"file_title": "テーマファイルの中身",
"file_intro": "テーマは JSON ファイルです。変えたいところだけ書けば、残りは <code>base</code> のテーマから補われます。次の例はピクセルをもとに、アクセントといくつかの背景色だけを変えています。",
"file_fields_title": "よく使う項目",
"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>。"),
("<code>background</code>", "ウインドウ全体の背景画像:<code>image</code>(読み込み後の <code>user:<sha256></code>)、<code>blur</code>、<code>scrim</code>、<code>surfaceOpacity</code>(パネルの不透明度)、<code>scope</code>(表示するウインドウ)、<code>accentFromImage</code>。"),
("<code>scenery</code>、<code>scene</code>", "風景のオン・オフと自分の画像:<code>scene.header</code>(ページ上部)、<code>scene.sidebar</code>(サイドバー下部)。ダークモード用に <code>headerDark</code>、<code>sidebarDark</code> も指定できます。"),
],
"file_more": "完全な形式と各色の使われる場所:",
"ai_title": "AI にテーマを作ってもらう",
"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": [
"ネオンピンクと深い紫のサイバーパンク風テーマを作って、適用して。",
"ピクセルテーマをもとに夕焼け色のテーマを作って。ダークは暖かい背景色にして。",
"今のテーマの灰色の文字が読みにくいので、明るくして。",
"今のテーマを書き出して見せて。それからライト版も作って。",
"~/Pictures/beach.jpg を背景にして、写真の色に合わせたテーマを作って。",
"ピクセルテーマの上部の風景を ~/Pictures/mountains.png に変えて。",
],
"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")],
},
}