使用文档

开始使用

打开 App，「概览」会列出还需要完成的步骤：添加翻译模型、下载本地模型、在 Safari 中启用扩展。

「翻译模型」→ 选择一个服务（OpenAI、Anthropic、DeepSeek、OpenRouter 或 OpenAI 兼容服务）→ 填入 API Key 和模型 ID → 「测试连接」→ 保存。可以添加多个，在「翻译设置」里切换当前使用的模型。

API Key 只保存在本机钥匙串里。识别出的文字会发给你选择的服务；开启「图像辅助翻译」时还会附带一张页面缩略图。

设置 → App → Safari 浏览器 → 扩展 → Translating Charm → 打开「允许扩展」。第一次在某个网站上使用时，Safari 会询问是否允许访问该网站，选「始终允许在此网站上」即可。

整页翻译：点地址栏左侧的页面菜单 → Translating Charm → 「翻译本页」。
左划翻译单张图：在漫画图片上单指向左划；再划一次或向右划切回原图。在左右翻页的阅读器上（如 pixiv 手机版）改为双指，也可以在「Safari 扩展」设置里改为双指或关闭。
悬浮球：点一下开启自动翻译，滚动到的大图会自动翻译；长按打开菜单（翻译全部、看原图、在此网站隐藏）。可拖动，每个网站记住自己的位置。

交给 App 处理（默认）：页面交给 App，用完整模型和 GPU 处理。App 已在运行（前台、分屏、侧拉或正在后台处理）时会静默接手；否则 App 会被打开约 1 秒来启动后台处理，然后自动回到 Safari，结果陆续出现在页面上，系统会显示后台进度。

在 Safari 内处理：完全在扩展里处理，不打开 App。扩展内存有限，只加载放得下的模型，其余用系统文字识别和纯色擦字。

「本地模型」里下载漫画文字检测、manga-ocr 编码器 / 解码器和 LaMa 擦字模型（共约 330 MB）。未安装时会退回系统的文字识别和纯色擦字。

下载后 App 会在本机实测每个模型在 CPU、GPU、神经网络引擎上的速度并核对结果，自动选最快的；也可以在「处理设备」里手动指定，或「重新测速」。「内存」里可以设置模型空闲多久后释放；内存紧张或电量低时会自动释放。

「导入图片」可以从照片或文件选择漫画页，处理结果在「任务」里查看，可对照原图、查看识别和翻译的文字、分享译图。

「缓存」里可以浏览和删除译图与译文记忆，设置保留天数和容量上限。超过期限或容量时最久没用的先删除。

「同步」可选 iCloud 或 WebDAV（例如自建的 Nextcloud、群晖）。同步全部设置，翻译缓存可选。两台设备都改过设置时，会让你选择保留哪一边。API Key 可以通过 iCloud 钥匙串同步，或用你设置的口令加密后上传到 WebDAV；口令只保存在本机。

「关于与许可 → 诊断」显示这次安装实际获得的能力（App Group、钥匙串共享、iCloud、内存上限、后台 GPU）以及对功能的影响，可以一键复制诊断信息（不含 Key 和密码）发给我们。

在 Safari 的页面菜单里允许 Translating Charm 访问该网站，然后刷新页面。

部分网站有防盗链。扩展会用 App 的网络请求按 Safari 的方式附带来源页面下载图片；仍失败时，刷新页面后重试，或用 App 的「导入图片」。

检测与 manga-ocr 模型仅支持日文原文。其它语言会使用系统文字识别。

确认已下载本地模型，并在「本地模型 → 处理设备」查看测速结果；首次加载模型需要几秒，之后会保持在内存里。

App 会给出原因（Key 无效、额度不足、模型不存在等）。可在「翻译模型」里「测试连接」。