Skip to content

yen-shi-lun/claude-ocr-overlay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude OCR Overlay|Claude 桌面版 OCR 中文化浮層

透過 Windows 內建 OCR 引擎,將 Claude Desktop 的英文介面即時翻譯為繁體中文的浮層工具。

A floating overlay that uses Windows built-in OCR to translate the Claude Desktop UI into Traditional Chinese in real-time.


✨ 特色 Features

  • 🔒 零侵入:完全不修改 Claude 任何檔案,不違反 ToS
  • 🎯 智慧匹配:五層查找策略,自動處理 OCR 圖示誤判
  • 🛠️ 自訂優先:使用者偏好永遠覆蓋預設翻譯
  • 📚 完整字典:1100+ 條翻譯,涵蓋設定頁、對話介面、按鈕、提示
  • 🤖 自動模式:可設定定時自動掃描翻譯(5 秒或 3 秒)
  • 💯 純 Windows:使用 Windows 內建 OCR + PowerShell,無需額外安裝

🎬 為什麼用 OCR 方案?

Claude 桌面版的 UI 由兩部分組成,兩者都無法直接翻譯

UI 元件 來源 為什麼無法直接改
原生 UI(選單、設定視窗等) app.asar (Electron) MSIX 完整性檢查阻擋修改
網頁 UI(對話介面、按鈕等) claude.ai 伺服器 由 Anthropic 伺服器渲染

OCR 浮層方案:在 Claude 視窗上疊加透明浮層,OCR 識別英文後,旁邊顯示中文翻譯。完全不動 Claude 本身。


📋 系統需求 Requirements

項目 需求
作業系統 Windows 10 (1903+) 或 Windows 11
PowerShell 5.1+(Windows 內建)
Windows OCR 需安裝「English (United States)」語言套件
Node.js 16+(僅更新字典時需要)

安裝英文 OCR 語言套件

  1. 開啟 Windows 設定 →「時間與語言」→「語言與地區」
  2. 點擊「新增語言」→ 搜尋並新增「English (United States)」
  3. 確認勾選「光學字元辨識(OCR)」附加元件

🚀 快速開始 Quick Start

安裝

git clone https://github.com/yen-shi-lun/claude-ocr-overlay.git
cd claude-ocr-overlay

啟動

雙擊 ocr-overlay/啟動 Claude OCR 浮層.bat 即可。

啟動後右下角會出現控制面板:

按鈕 功能
OCR 立即執行一次螢幕擷取與翻譯
Clear 清除目前顯示的翻譯標籤
Auto 切換自動模式
5s / 3s 自動模式間隔時間
Close 關閉浮層工具

使用流程

  1. 打開 Claude Desktop 應用程式
  2. 啟動 OCR 浮層工具
  3. 切換到您想翻譯的 Claude 畫面
  4. 點擊 OCR 按鈕,等 1~2 秒
  5. 英文字串旁會出現對應的繁體中文(金色文字)

📁 專案結構

claude-ocr-overlay/
├── ocr-overlay/                          ← OCR 浮層核心
│   ├── claude-ocr-overlay.ps1            主程式(PowerShell)
│   ├── 啟動 Claude OCR 浮層.bat           雙擊啟動器
│   ├── translations.json                 翻譯字典(1100+ 條)
│   └── user-overrides.json.example       使用者偏好範本
│
├── dictionary/                           ← 字典管理工具
│   ├── update-dict.js                    字典更新核心
│   ├── translations-web-ui.txt           網頁 UI 字典主檔
│   ├── add-translations.txt              新翻譯加入區
│   ├── 更新字典.bat                       雙擊更新
│   ├── 互動新增翻譯.bat                    命令列互動模式
│   ├── 檢查未翻譯.bat                     檢查缺漏
│   ├── claude-zh-dict-ocr.txt            OCR 字典文字版
│   ├── claude-zh-dict.json               JSON 格式
│   └── claude-zh-dict.tsv                試算表格式
│
├── docs/
│   └── Claude_OCR_Overlay_Manual.docx    使用手冊(Word)
│
├── README.md
├── LICENSE
└── .gitignore

🎨 自訂翻譯

方法一:新增翻譯(推薦)

編輯 dictionary/add-translations.txt

Memory
記憶

Search and reference chats
搜尋並參考過往對話

然後雙擊 dictionary/更新字典.bat

方法二:互動模式

雙擊 dictionary/互動新增翻譯.bat,依提示輸入。

方法三:個人偏好覆寫

  1. 複製 ocr-overlay/user-overrides.json.exampleocr-overlay/user-overrides.json
  2. 編輯為您喜歡的翻譯,例如:
{
  "Artifacts": "成品",
  "New chat": "新對話",
  "How can I help you today?": "今天我可以怎麼幫你?"
}
  1. 執行 更新字典.bat,您的偏好永遠優先於預設翻譯

🔍 翻譯查找邏輯

PowerShell 腳本採用五層匹配策略

  1. 完全匹配"New chat"新對話
  2. 剝除 UI 項目符號"+ New chat"新對話
  3. 剝除單字母前綴(OCR 把圖示誤判為字母):"K Cowork"協作
  4. 剝除多字元符號:處理更複雜的圖示誤判
  5. 詞級備援:拆字逐個查詢

🐛 疑難排解

PowerShell 解析錯誤 Unexpected token }

檔案編碼問題。執行:

$file = "ocr-overlay\claude-ocr-overlay.ps1"
$content = [System.IO.File]::ReadAllText($file)
$utf8Bom = New-Object System.Text.UTF8Encoding($true)
[System.IO.File]::WriteAllText($file, $content, $utf8Bom)

Windows OCR engine for en-US is not available

未安裝英文 OCR 語言套件,請依「系統需求」章節安裝。

字典更新後沒生效

PowerShell 腳本在啟動時讀取字典 → 重啟浮層工具即可。


🤝 貢獻 Contributing

歡迎 PR!特別需要:

  • 補充缺漏的翻譯(請編輯 dictionary/translations-web-ui.txt
  • 改善 PowerShell 腳本的查找邏輯
  • 跨平台支援(macOS / Linux 的 OCR 整合)

請保持 user-overrides.json 不要提交到 PR(已加入 .gitignore)。


⚖️ 免責聲明 Disclaimer

  • 本專案為非官方社群工具,與 Anthropic 無關
  • 不修改 Claude 應用程式檔案,僅以浮層方式疊加翻譯
  • 翻譯內容由社群維護,可能與 Anthropic 官方未來提供的繁體中文版本不一致
  • Claude 桌面版及其商標屬於 Anthropic, PBC

📜 授權 License

MIT License — 自由使用、修改、散布。

About

Floating overlay translator for Claude Desktop using Windows OCR | 透過 Windows OCR 為 Claude 桌面版提供即時繁體中文翻譯浮層

Topics

Resources

License

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors