Use this command to install Kivio with WinGet:
winget install --id=ZMGID.Kivio -e Copy WinGet command to clipboard Kivio is a compact desktop AI client with a built-in agent runtime. It stays in the tray or menu bar, opens when you need it, and keeps a much smaller footprint than a browser-based AI workspace.
- Kivio Agent — chat, projects, assistants, memory, file/image attachments, MCP, Skills, and native tools (file ops, shell, web fetch/search, Pyodide run_python).
- Lens — screenshot-based visual Q&A, OCR, formula extraction, text polishing, and optional web-aware answers.
- Fast translation — typed text, selected text, windows, and arbitrary screen regions.
- Bring your own models — OpenAI-compatible providers and Anthropic Messages, with per-feature model routing and multi-key failover.
- Document-ready — PDF / Word / Excel workflows run on a bundled offline Pyodide sandbox, no first-run CDN download required.
- Private by default — no telemetry; API keys and conversation data stay on your machine.
常驻托盘。热键翻译输入、选中文字或屏幕内容，框选后直接问 AI。打开客户端则是完整 Agent：工具、子代理、Skills、MCP、知识库、多模型并排。
自带 Key，无账号、无中转；数据只留本机，无遥测。
❤️ 赞助
> 想出现在这里？欢迎通过 GitHub Issues 或 QQ 群 1104450740 联系。
点击折叠
感谢 合租巴士 赞助本项目。合租巴士 提供 GPT / Claude 等多款模型的官方稳定极速 API 中转服务，支持企业级定制、报销开票、7×16h 专属技术支持，更有独家适配的 WebSocket 连接方式，畅享极速首字速度。Codex 补贴倍率低至 0.08。点此注册 。
为什么用 Kivio
屏幕上的字、框选的画面、本机已装的编码 CLI，不必拆成三套软件。Kivio 把它们收进同一个托盘应用：热键随时呼出，对话走你自己的供应商。
一个循环，多种宿主 — 内置 Agent、只读研究用的 Kivio Chat、以及本机外部 CLI（Claude Code、Codex、Cursor、OpenCode、Gemini、Kimi、Pi、Hermes、Grok、DeepSeek Harness），共用同一套聊天界面屏幕级工具 — 快速翻译、选中翻译、截图翻译、替换翻译（译文画回原位置）；Lens 冻结屏幕后提问、标注，并可把对话交回客户端自带 Key — OpenAI Chat Completions / Responses、Anthropic、Gemini、Grok（xAI Responses）；翻译、截图、Lens、每条对话可各用不同模型扩展 — Skills、MCP、知识库、子代理、插件、连接器；右侧 Dock 带文件树、Git 与终端跨平台 — macOS（Apple Silicon）与 Windows 10/11，Tauri 2 原生应用
截图
聊天客户端 设置
功能
完整记录见 Releases · 当前版本说明：v2.9.8
聊天与 Agent
工具循环、子代理、Skills、MCP、知识库、附件；一问多模型对比
三种运行时：Kivio Agent（完整工具）、Kivio Chat（检索 / 抓取 / 知识库等只读能力）、外部 CLI
对话可交给本机已装的 Claude Code、Codex、Cursor、OpenCode、Gemini、Kimi、Pi、Hermes、Grok 或 DeepSeek Harness
可从本机 CLI 导入原生会话（钉在原 CLI 与原工作目录上续聊）
翻译与 Lens
快速翻译、选中翻译、截图 OCR 翻译、替换翻译
Lens：热键冻结屏幕，框选（macOS 可点窗口）后提问，可画箭头 / 矩形 / 马赛克，可把对话交回客户端
OCR：系统引擎（Apple Vision / Windows OCR）或可选 RapidOCR 离线包
系统
全局热键（可改、带冲突检测）、托盘常驻、浅色 / 深色
用量统计、生命周期钩子、可选聊天窗口保活（关闭后隐藏而不是销毁）
热键
都是开关，可在设置里改。
功能 macOS Windows 打开聊天 ⌘⇧KCtrl+Shift+K快速翻译 ⌘⌥TCtrl+Alt+T截图翻译 ⌘⇧ACtrl+Shift+A选中翻译 ⌘⇧TCtrl+Shift+T替换翻译 ⌘⇧RCtrl+Shift+RLens ⌘⇧GCtrl+Shift+G
下载安装
系统要求
macOS ：Apple Silicon（.dmg 未签名）Windows ：Windows 10 / 11（需要 Edge WebView2，系统通常已带）
从 Releases 下载：
macOS：Kivio.Desktop_*_aarch64.dmg
Windows 安装包：Kivio.Desktop_*_x64-setup.exe
Windows 便携版：Kivio.Desktop_*_x64-portable.zip（解压即用）
macOS 首次请右键打开，或：
xattr -cr "/Applications/Kivio Desktop.app"
macOS 需要辅助功能 与屏幕录制 权限。启动后按引导填供应商即可。
帮助
快速开始
安装并打开 Kivio，完成首次引导（供应商 + 热键）。
添加供应商 ：设置 → 供应商 → 添加驱动 → 选预设（或自定义），填入 API Key。聊天 ：⌘⇧K / Ctrl+Shift+K 打开客户端，选模型后发送。需要本机 CLI 时，在运行时选择器里切换。屏幕 ：用热键翻译或打开 Lens；需要的权限在系统设置里打开。
常见问题
需要注册账号吗？数据存在哪？
不需要账号。Key 写在本机 settings.json 里，对话、知识库、笔记都在应用数据目录：
Windows：%APPDATA%\com.zmair.kivio
macOS：~/Library/Application Support/com.zmair.kivio
无遥测，请求只发往你配置的供应商。
支持哪些外部 CLI？
本机已安装即可作为对话后端：Claude Code、Codex、Cursor、OpenCode、Gemini、Kimi、Pi、Hermes、Grok、DeepSeek Harness。可用性按本机探测；模型列表按所选 CLI 懒加载。
macOS 提示已损坏 / 无法打开？
安装包未签名。请右键 → 打开，或执行 xattr -cr "/Applications/Kivio Desktop.app"。截图与替换翻译还需要屏幕录制权限。
导入的 CLI 对话为什么不能换模型续聊？
导入只做显示快照，历史真身仍在原 CLI。续聊走该 CLI 的原生会话，并钉在原来的工作目录。详见 ADR-0001 、ADR-0002 。
开发
环境与命令
需要 Node.js、npm、Rust，以及 Tauri 2 的平台依赖。macOS 上 OCR sidecar 还需要 Swift。
npm install
npm run dev # Rust + UI（macOS 会编 Swift sidecar）
npm run dev:ui # 只开 Vite
npm run lint
npm run typecheck
npm test
Rust 测试：
# macOS / Linux
cargo test --manifest-path src-tauri/Cargo.toml
# Windows（请用脚本；直接 cargo test 的测试二进制可能起不来）
powershell -File scripts/win-cargo-test.ps1
协议类型由 Rust 生成，改协议后需要：
npm run protocol:generate
npm run protocol:check
架构总览
┌─────────────────────────────────────────────────────────────┐
│ 前端（React 18 + Vite + Tailwind） │
│ 同一套 bundle，四个窗口：main / chat / lens / translate │
└────────────────────────┬────────────────────────────────────┘
│ Tauri IPC · chat-protocol
┌────────────────────────▼────────────────────────────────────┐
│ 后端（Tauri 2 + Rust） │
│ AgentHost 循环（prepare → planning → rounds → synthesis） │
│ ├─ GUI 聊天 │
│ ├─ 外部 CLI 代理 │
│ └─ 子代理 │
└─────────────────────────────────────────────────────────────┘
实时聊天走版本化 chat-protocol（npm run protocol:check 校验生成物）
供应商适配器：OpenAI Chat、Anthropic Messages、Gemini、OpenAI Responses（含 xAI Grok）
设置存在 settings.json（含 API Key），对话在 conversations/，崩溃草稿走 JSONL journal
更细的模块地图见 CLAUDE.md 。
贡献
欢迎 Issues 与 PR。提交前请确保：
npm run lintnpm run typechecknpm test
较大的功能请先开 issue 讨论。议题约定见 docs/agents/issue-tracker.md 。
Star History
License
GPL-3.0-or-later © ZM
