Kiri 一个本地优先、快速且功能强大的截图、标注、OCR（文字识别）与区域录屏工具 | 极客的赛博空间

这份详细的部署教程将指引您安装和使用 Kiri——一个本地优先、快速且功能强大的截图、标注、OCR（文字识别）与区域录屏工具。

Kiri 主打本地优先和隐私保护，所有处理（尤其是OCR）默认在设备本地完成。它主要在 macOS 上开发和测试，Windows 支持尚在完善中。

你可以根据自己的操作系统，从 GitHub Releases 下载最新的安装包。

下载：从 GitHub Releases 页面下载适用于 Apple Silicon（arm64）或 Intel（x64）芯片的 .dmg 文件。
安装：打开 .dmg 文件，将 Kiri.app 拖入“应用程序”文件夹。
首次打开与权限：
- 由于当前发布包未经 Apple 公证，首次启动可能需要按住 Control 键点按应用图标，选择“打开”，或在“系统设置 → 隐私与安全性”中手动选择“仍要打开”。
- 应用正常运行需要授予屏幕与系统音频录制权限。如果需要录制麦克风（macOS 15+），则需额外授予麦克风权限；如果需要显示点击高亮，则需授予输入监控权限。权限请求会在首次使用相关功能时弹出。

下载：从 GitHub Releases 页面下载最新的 Windows 安装程序（.exe）。
安装：运行安装程序即可。请注意，安装程序未经过 Authenticode 签名，因此 SmartScreen 筛选器可能会弹出警告，选择“仍要运行”即可继续。
权限：屏幕捕获不需要额外系统授权，麦克风权限由 Windows 系统的隐私设置控制。

重要提示：当前 v1.4.4 发布包不包含可重编辑标注和灵活的素材库位置管理等最新功能。这些功能已在代码主分支 (main) 中实现，并会包含在未来的正式发布版本中。

安装并授予权限后，你可以通过全局快捷键呼出 Kiri 开始工作。

启动截图/录屏：按下全局快捷键 ⇧⌘A (macOS) 或 Shift+Ctrl+A (Windows)。
选择区域：点击窗口或拖拽选择屏幕上的一个区域。
选择功能：在屏幕底部弹出的工具栏中，选择“截图”、“标注”、“OCR”或“录屏”。
处理结果：
- 截图：会复制到剪贴板，并保存在本地素材库。
- 标注：在标注界面使用画笔、形状、文字、马赛克等工具编辑后，可保存为带标注的截图。
- OCR：默认使用系统本地引擎（macOS Vision 或 Windows.Media.Ocr）识别文字，完全离线。你也可以配置远程OCR服务（需手动确认发送图片）。
- 录屏：选择录制区域，可选系统声音、麦克风、鼠标指针和点击高亮，输出为 MP4 或 GIF。

所有截图、录屏和GIF都保存在本地素材库中，支持：

如果你想从源代码构建并运行最新开发版，请按以下步骤操作。请注意：开发版可能不稳定，且包含实验性功能。

安装依赖：
- Rust 1.88 或更高版本。
- Node.js 20.19+（或 22.12+）和 pnpm。
- macOS 还需要安装 Xcode Command Line Tools。

克隆与安装：

1
2
3

git clone https://github.com/yuxino/kiri.git
cd kiri
pnpm install

运行开发版：
1
pnpm tauri dev
注意：macOS 开发版需要一个有效的签名身份，否则命令会报错。请不要直接运行 cargo build 生成的二进制文件，因为它不包含前端界面资源。
构建应用（不打包）：
1
pnpm tauri build --no-bundle

隐私与数据安全：Kiri 默认所有处理在本地完成。即使使用可选的远程OCR，图片也需要你手动确认发送。标注功能中，被马赛克等工具遮盖的原图部分仍可能存在于本地文件中，直到你永久删除截图才会一并移除。
FFmpeg 依赖：录屏和GIF转换功能依赖 FFmpeg。如果系统没有安装，Kiri 会在你首次使用录屏或手动转换GIF时自动下载并缓存，不会在浏览素材库时提前下载。
已知限制：Windows 版本尚未经过全面真机测试，部分功能可能存在问题。请关注项目后续更新。

如果在安装或使用中遇到问题，可以查阅项目的 GitHub Issues 或参考隐私说明与路线图。