Skip to content
/ Yomi Public

macOS Japanese learning companion with instant clipboard OCR, system-integrated Furigana, and TTS. Built with Swift 6. (macOS 日语学习伴侣,提供即时剪贴板 OCR、系统级注音与 TTS。基于 Swift 6 构建。

License

Notifications You must be signed in to change notification settings

rainux/Yomi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Yomi - 日语伴读 (Yomi: Japanese Companion)

Build Status License Language

让日语,触耳可及。

「Yomi」 是一款专为 macOS 设计的日语学习辅助工具。它像一个安静的伙伴,默默守护在你的剪贴板旁。当你遇到不认识的日语句子、图片中的假名或是难以读准的汉字,只需「复制」一下,「Yomi」 便会为你读出声音、标注读音并翻译含义。


🌟 核心特性

  • 智能剪贴板监听:后台自动检测剪贴板动态,支持文本自动处理。
  • 全局图像 OCR:集成系统 Vision 框架,即时识别截图中的日语文字,并支持竖排布局识别。
  • 注音标注 (Furigana):利用 macOS 原生分词引擎,自动为日文汉字标注平假名。
  • 语音朗读 (TTS)
    • 系统集成:调用 macOS 内置语音合成引擎 (AVSpeechSynthesizer)。
    • 即时响应:新内容到来时自动打断当前朗读,提供流畅的听觉反馈。
  • 文本翻译:调用系统 Translation 框架,将日语翻译为系统语言(默认为简体中文),辅助理解。
  • 轻量化交互:遵循 macOS 原生设计语言,提供无干扰的伴随式体验。

🛡️ 安全与隐私声明

由于本应用涉及「剪贴板监控」这一高敏感权限,我们在此郑重承诺:

  1. 完全开源:所有的源代码均已公开,你可以随时审计关于剪贴板监听及数据处理的逻辑。
  2. 本地化处理:所有的文字提取、OCR 识别逻辑均在你的 Mac 本地完成。
  3. 隐私透明:我们不收集、不上传任何关于你的阅读习惯或剪贴板内容的统计数据。

📦 安装与系统要求

系统要求

  • macOS 15.0 (Sequoia) 或更高版本
  • 硬件支持:支持 Apple Silicon 及 Intel Mac (Universal)。
  • 版本说明:由于竖排 OCR 识别模型和新版 Translation API 均依赖 macOS 15,因此无法支持旧版系统。

安装指南

由于本项目目前处于早期开源阶段,尚未通过 Apple 开发者签名公证,安装时请遵循以下步骤:

  1. 前往 Releases 页面下载最新的 .zip 压缩包。
  2. 解压并将 Yomi.app 拖入你的 应用程序 (Applications) 文件夹。
  3. 首次启动注意
    • 如果你看到「无法打开 Yomi,因为身份不明的开发者」的警告:
    • 请在「应用程序」文件夹中,右键点击 Yomi.app,选择「打开」。
    • 在随后弹出的窗口中再次点击「打开」即可正常运行。

🛠️ 技术栈

  • 语言:Swift 6 (Strict Concurrency Enabled)
  • 界面:SwiftUI
  • 技术框架:Combine, Vision, Translation, AVFoundation
  • 辅助开发:本项目由 Google Antigravity (Agentic Coding Tool) 辅助构建。

📄 开源协议

本项目采用 GPLv3 协议开源,作者保留所有权利。


© 2025 Rainux Luo

About

macOS Japanese learning companion with instant clipboard OCR, system-integrated Furigana, and TTS. Built with Swift 6. (macOS 日语学习伴侣,提供即时剪贴板 OCR、系统级注音与 TTS。基于 Swift 6 构建。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages