# kai

**Repository Path**: dtapps/kai

## Basic Information

- **Project Name**: kai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kai

常驻系统托盘的翻译工具，支持划词、截图与输入翻译，并内置 OCR。

[English](./README_EN.md) | [中文](./README.md)

## 1. 产品功能

| 功能 | 默认快捷键 | 默认启用 | 说明 |
|------|------------|----------|------|
| 输入翻译 | mac: `⌥+A` / win: `Alt+A` | 是 | 唤起翻译主窗口，手动输入文本翻译 |
| 截图翻译 | mac: `⌥+S` / win: `Alt+S` | 否（需在设置中手动开启） | 框选区域 → 识别文字 → 翻译，结果在截图窗口展示 |

> 全局快捷键仅上述两类。另有复制键（`⌘+C` / `Ctrl+C`），用于把选中文本送入剪贴板供翻译读取。

- **翻译引擎**：内置 DeepL、Google、OpenAI、百度、腾讯、有道，以及 macOS 系统翻译。Google 与系统翻译开箱即用；其余需自行填入 API Key
- **OCR**：macOS 使用系统离线识别（无需安装）；也可选装本机 tesseract。区域截图触发仅 macOS 支持
- **界面语言**：内置中文 / 英文，可跟随系统或在设置中切换
- **自动更新**：启动静默检查 + 托盘菜单「检查更新」；更新源默认按界面语言选择（中文走 CNB，英文走 GitHub），也可手动指定；开启预发布通道可收到每日 nightly 版本

## 2. 平台说明
- **macOS**：完整能力（系统翻译 / 系统 OCR / 复制键 / 自动更新）
- **Windows**：在线翻译与 OCR（需本机装 tesseract）可用，复制键可用，自动更新可用；系统翻译不支持
- 当前仅支持 macOS 与 Windows，不支持 Linux

## 3. 仓库与发布

### 仓库
| 平台 | 地址 |
|------|------|
| CNB | https://cnb.cool/dtapp/kai |
| GitHub | https://github.com/dtapps/kai |
| Gitea | https://gitea.com/dtapps/kai |
| GitLab | https://gitlab.com/dtapps/kai |
| Gitee | https://gitee.com/dtapps/kai |
| GitCode | https://gitcode.com/dtapp/kai |

### 发布
- **正式发布**：手动触发 Release 工作流并输入版本号，macOS / Windows 双平台构建并发布
- **每日构建（Nightly）**：每日自动构建 `nightly` 预发布版本
- 构建产物从 GitHub Release 下载，再发布到 CNB

## 4. 许可证
详见仓库 `LICENSE` 文件。

## 5. 已知问题

> 以下为当前版本（Wails v3 beta.9）的已知限制，多为上游框架或 macOS 平台行为所致，非本应用逻辑缺陷。

- **macOS 快捷键首次唤起截图窗口可能被遮挡**：在其它应用处于前台时，通过快捷键（`⌥+S`）第一次唤起截图翻译窗口，偶发被原前台应用窗口盖住。再次唤起（窗口已存在于事件循环中）则正常。原因：Kai 为无 Dock 图标的辅助型（accessory）应用，在 macOS（尤其 Tahoe / macOS 27）下从后台抢回前台焦点的能力受系统限制，纯 Wails 方案下首次存在竞态。托盘菜单点击唤起不受影响（系统原生点击天然带前台转移）。**临时规避**：若窗口被挡，可先点击一下 Kai 托盘图标或再次触发快捷键。
- **自定义标题栏需点击才能激活**：macOS 上自绘标题栏（frameless + 透明标题栏，用于跟随应用内浅/深主题）在窗口刚唤起时，红绿灯（关闭/最小化/全屏）偶尔需多点击一次才响应。这是 accessory 应用窗口激活时机的平台行为，激活后交互正常。

## 6. 致谢
设计灵感参考 [Bob](https://github.com/ripperhe/Bob) 与 [Easydict](https://github.com/tisfeng/Easydict)。