KIAgent

KIAgent

你的个人 AI 大脑——本地运行、开源，并支持 MCP。

网站 · 下载 · 架构文档

每个人都在为公司构建一个大脑——一个摄取组织所知一切的知识层，让 AI 能结合真实背景进行回答和行动。**KIAgent 就是专属于你的知识层。**公司的大脑存在于他人的云端，属于你的雇主；你的个人 AI 大脑运行在自己的设备上，适用于你选择的任何 AI，并且永远属于你。

具体来说，KIAgent 是一款桌面应用，可在你自己的设备上摄取个人数据——邮件、文档、聊天记录、笔记——将其存储在本地数据库中，并通过 MCP 提供给 AI 助手。所有内容都保留在你的电脑上：摄取、解析、OCR 和视觉处理均在本地运行——并由 llama.cpp 提供设备端推理能力——因此，AI 助手无需让你的数据离开设备，就能了解你的世界。

KIAgent 的核心是一个平台：一组精简的宿主能力（MCP、数据库、本地 LLM、文件系统、Web 访问）由摄取引擎连接起来，再加上插件／扩展系统，让沙盒中的连接器利用这些能力引入新的数据来源。

flowchart TB
    GMAIL(["Gmail"])
    DRIVE(["Drive"])
    SLACK(["Slack"])
    NOTION(["Notion"])
    MORE(["…"])

    PLUGINS["Plugins / extensions"]

    WEB["Web"]
    LLM["Local LLM"]
    FS["Filesystem"]
    DB[("DB")]
    MCP["MCP"]

    GMAIL --> PLUGINS
    DRIVE --> PLUGINS
    SLACK --> PLUGINS
    NOTION --> PLUGINS
    MORE --> PLUGINS
    PLUGINS <--> WEB
    PLUGINS <--> LLM
    PLUGINS <--> FS
    PLUGINS <--> DB
    DB --> MCP

    classDef service fill:#e8f0fe,stroke:#4285f4,color:#1a3c78
    classDef core fill:#e6f4ea,stroke:#34a853,color:#1e4620
    classDef hub fill:#fce8e6,stroke:#ea4335,color:#7a1c14,stroke-width:2px

    class GMAIL,DRIVE,SLACK,NOTION,MORE service
    class WEB,LLM,FS,DB,MCP core
    class PLUGINS hub

插件处于核心位置：每个插件都会连接第三方服务（Gmail、Drive、Slack、Notion 等）或本地文件系统，提取你的数据，使用本地 LLM 进行处理，然后将其写入数据库——MCP 再将这些数据提供给 AI 助手。访问权限由中介管理，并受权限控制；插件无法直接使用这些能力。

本仓库：kiagent-core

本仓库是构建 KIAgent 所用的 MIT 许可核心项目，其理念与 VS Code 和 Code-OSS 相同：

• kiagent-core（本仓库）——开源核心。运行 npm run package:oss 可生成未使用品牌标识的 kiagent-core 构建版本，你可以在 MIT 许可证下运行和再分发。
• KIAgent——基于此核心构建并经过签名的品牌产品，可通过 localkiagent.com/download 获取。

基于 OAuth 的来源（Gmail、Microsoft）会在构建时从环境中读取客户端凭据——请参阅 .env.example／CI secrets。Fork 和 OSS 构建版本需提供自己的 OAuth 客户端 ID。

主要组件

• 摄取引擎（src/main/core/engine）——按计划从来源批量拉取数据，将原始条目（邮件、PDF、图像）转换为已编入索引的文档，并提交到存储中。内置来源位于 src/main/sources（Gmail、IMAP、Microsoft 365、本地文件夹）。
• 数据库（src/main/core/store、src/main/db）——SQLite 语料库（better-sqlite3），用于存储文档、元数据和搜索索引，由应用写入、由 MCP 进程读取。
• MCP 服务（src/main/core/mcp、src/main/mcp）——通过两种共用同一工具注册表的传输方式，将语料库提供给 AI 助手使用：应用内的 HTTP 服务，以及独立的 stdio 入口，Claude Desktop 等客户端可直接启动该入口。
• 本地大模型（src/main/providers/local-llm、src/main/providers/apple-vision）——通过随附的 llama.cpp 服务在设备上运行推理（自动检测后端、精选模型档位），并提供原生 OCR/视觉辅助功能，用于处理扫描文档和图像。
• 文件系统——本地文件夹摄取、模型存储，以及供转换工作进程使用的临时工作区（src/main/workers、src/main/converter）。
• Web——用于来源 API、OAuth 流程（src/main/auth、src/main/platform/oauth-providers.ts）和市场下载的出站 HTTP 请求。
• 插件 / 扩展系统（src/main/platform、src/main/marketplace）——连接器在隔离的宿主进程中运行，并根据清单声明获得受权限控制的平台视图（来源、身份验证、存储、网络）。由 GitHub 支持的市场负责发现、安装和更新。另一个权限更高的层级允许产品构建在应用程序包内随附第一方扩展——完整模型（包括捆绑版 / unsafe.mainProcess 层级和 product.json）请参阅 docs/architecture/extension-platform.md。
• 渲染器（src/renderer）——React UI：来源设置、市场、MCP 连接状态、设置和日志。

开发

npm install
npm start          # run in development (hot reload)

其他实用脚本：

npm test                 # jest test suites
npm run lint             # eslint + prettier
npm run typecheck        # tsc, no emit
npm run package          # build a distributable
npm run package:oss      # build an unbranded kiagent-core distributable
npm run vendor:inference # fetch llama.cpp server + build vision helper

仓库结构

src/main       Electron main process: engine, store, MCP, platform, sources, providers
src/renderer   React UI (screens: Sources, Marketplace, Connection, Settings)
src/shared     Contracts and UI primitives shared across processes
concept/       Types-only blueprint for the core redesign
docs/          Design specs and implementation plans
native/        Native helper sources (vision/OCR)
scripts/       Build and vendoring scripts

MCP 目录

KIAgent 已发布到官方 MCP 注册表，名称为 com.localkiagent/kiagent（参见 server.json），并列入 Glama：

致谢

KIAgent 的设备端推理由 llama.cpp 提供支持，该项目由 Georgi Gerganov 创建，并由 ggml-org 社区维护（MIT 许可证）。应用随附从官方 llama.cpp 发行版获取的预构建 llama-server 二进制文件（npm run vendor:inference 会在构建时下载这些文件）。得益于他们的工作，才能在消费级硬件上私密地运行高性能模型——感谢他们。

许可证

MIT——参见 LICENSE。