# Kova

> Kova（扣瓦）是一个桌面端 AI 助手：Tauri v2 原生应用，Next.js + assistant-ui 会话界面，本地 agent 运行时驱动模型对话、工具执行与会话持久化。

## 开始

### 入门

- [Kova 扣瓦](https://docs.openkova.site/index.md): 跑在你自己桌面上的 AI 助手：原生窗口、本地 agent 运行时、可约束的权限模型、任意 MCP 服务器接入，以及能带出门的移动端。
- [快速开始](https://docs.openkova.site/quickstart.md): 环境要求、安装桌面端、从源码跑起来，以及 dev 与正式版的数据隔离。

## 功能

### 会话与 Agent

- [对话工作区](https://docs.openkova.site/features/conversation.md): 多线程会话、附件与 @ 提及、提示词排队、检查点回溯、模型选择器与语音输入。
- [Agent 引擎](https://docs.openkova.site/features/agent-engine.md): 本地 sidecar 运行时、内置工具、会话模式与权限档位、上下文压缩、长期记忆与子代理。
- [循环视图](https://docs.openkova.site/features/agent-loop.md): 看清 agent 每一轮在想什么、调了什么工具、为什么停下来——以及进程崩了之后还能看到多少。
- [模型服务](https://docs.openkova.site/features/model-providers.md): 接入自定义端点、从其他工具导入配置、覆盖模型属性——决定扣瓦能调哪些模型，以及每个模型的思考档位怎么映射。
- [提示词排队](https://docs.openkova.site/features/prompt-queue.md): 排队、并入当前轮、立即发送——以及为什么队列状态要用全量快照而不是增量。
- [提示词缓存](https://docs.openkova.site/features/prompt-cache.md): prompt_cache_key 分片路由、会话亲和头、与聊天同形的压缩摘要请求，以及缓存命中率的两种口径。
- [模式总览](https://docs.openkova.site/features/modes.md): 一个应用里五个常被叫作「模式」的东西：会话模式、权限档位、工作模式、自动化权限档，以及那些其实不是模式的。
- [目标模式](https://docs.openkova.site/features/goal-mode.md): goal 档：显式状态机、两条停机阀、过期护栏，以及为什么没有 token 预算。
- [子代理](https://docs.openkova.site/features/subagents.md): Task 四件套、四层发现、主代理自建定义、独立上下文与 token 结算，以及活动过程的持久化回放。
- [子代理能力模型](https://docs.openkova.site/features/subagent-capabilities.md): 工具、技能、MCP、知识源、记忆——五个正交维度，一条纪律：未声明即不可达。

### 扩展与场景

- [MCP](https://docs.openkova.site/features/mcp.md): 接入 Model Context Protocol 服务器，让 agent 用上 GitHub、数据库、内部服务等外部能力——而不动工具表、不牺牲提示词缓存。
- [插件与工作台](https://docs.openkova.site/features/plugins.md): 技能装载、面板系统、本地插件市场，以及仓库自带的 office / canvas / ui-design 三个工作台。
- [自动化与定时任务](https://docs.openkova.site/features/automation.md): 定时 Agent 任务：独立会话执行、错过补跑、无人值守的权限档与降级策略，以及 Webhook 通知。
- [远程访问与移动端](https://docs.openkova.site/features/remote-mobile.md): 桌面端网关、配对码换 token、三种网络接入方式，以及 Expo 构建的移动 App。

## 开发

### 开发者文档

- [架构总览](https://docs.openkova.site/developers/architecture.md): Tauri 宿主、Next.js 前端、pi-agent sidecar 与协议层的职责划分和数据流向。
- [扩展开发](https://docs.openkova.site/developers/extending.md): 写一个插件、接一个 MCP 服务器、加一个技能，以及 NDJSON 协议与跨端契约的约定。
- [构建与发布](https://docs.openkova.site/developers/release.md): 一键打包脚本、Tauri 打包配置、产物位置，以及打包与发版之间的区别。

## 参考

### 参考

- [路线图](https://docs.openkova.site/reference/roadmap.md): 已落地的能力、正在推进的移动端与远程能力增强，以及待办事项。
- [开源许可与致谢](https://docs.openkova.site/reference/license.md): Apache License 2.0，二次开发时的声明要求，以及项目所依赖的开源项目。

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (21 pages)](https://docs.openkova.site/_llms/en.txt): Documentation for English.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.