跳过主要内容

你的 Agent你的代码

MkAgent 是一套由 Pi 驱动、开源且本地优先的 AI Agent 工作台，为希望自主掌控 AI 工作的人而设计。你可以通过桌面端、WebUI 或 CLI 运行可持久保存、随时恢复的会话，连接已在使用的模型，并始终掌控每个工作区。

下载GitHub
macOS Windows Linux WebUI CLI
工作区
发布设置界面改版
Pi · Claude Sonnet · 询问模式
审查设置流程，完成新版界面，并验证桌面端构建。
MkAgent

我已梳理当前状态，找到 3 个共用界面。接下来会统一更新，再从桌面端完成验证。

允许运行构建命令？
bun run electron:build
让 MkAgent 在这个仓库中开始工作…

无论在哪里工作，都从同一个工作区继续

桌面端、WebUI 和 CLI 共享同一套身份验证 RPC、会话历史、Skills、权限与本地文件。

为真实 Agent 工作打造的工作台

从阅读代码、调用工具到授权操作，所有工作都围绕同一个持久工作区展开。每段会话都可随时检查，也能在桌面端、WebUI 或 CLI 中继续。

步骤01

打开一个工作区

~/.mkagent/workspaces/<slug>

将 MkAgent 指向真实的工作目录。会话、Skills、权限和视图都会限定在这个工作区内。

步骤02

选择模型连接

OAuth · API Key · Ollama

使用 ChatGPT Plus、Claude Pro/Max、服务商 API Key、兼容接口或本地 Ollama 模型。

步骤03

看得见 Agent 的工作过程

流式输出 · 工具 · 产物

在一段连续的会话中查看思考过程、工具调用、代码差异、计划、浏览器操作和结构丰富的文档产物。

步骤04

在任意端继续

Desktop ↔ WebUI ↔ CLI

在桌面端、WebUI 或 CLI 继续同一个本地会话，无需重新建立上下文。

Fork 一套可用的产品，而不是演示技术栈

MkAgent 是用于打造自有品牌桌面 Agent 的开源基础。Electron 打包、共享 WebUI 与 CLI、安全连接、权限、更新、国际化与测试都已打通。

GitHub下载
项目基础
MkThingsHQ/mkagent
Apache-2.0
  • 面向 macOS、Windows 与 Linux 的 Electron 打包
  • 桌面端、WebUI 与 CLI 共享会话协议
  • 支持订阅、API Key 与本地模型连接的 Pi 后端
  • Skills、浏览器、附件、文档与权限流程
  • 完整的中英文产品体验
克隆并运行
git clone https://github.com/MkThingsHQ/mkagent.git
bun install
bun run electron:start

一个产品，一套共享核心

MkAgent 是一个 Bun Monorepo，由三个客户端、一套经过身份验证的 WebSocket RPC 协议，以及一个 Pi Agent 后端组成。

Electron 桌面端
WebUI
CLI
共享 React UI + 服务端核心
Authenticated WebSocket RPC
Pi Agent 子进程
JSONL event stream
本地工作区 + JSONL 会话
~/.mkagent

聚焦，是有意为之

MkAgent 始于 Craft Agents 的开源基础，随后有意将产品聚焦在本地 Agent 工作台上。以下是明确的产品边界，而非尚未完成的占位功能。

  1. Pi 是唯一的 Agent 运行时

    Claude、ChatGPT、服务商 API Key、兼容接口与 Ollama 都通过 Pi 连接。MkAgent 不包含 Claude Agent SDK 或 GitHub Copilot 后端。

    为什么这样取舍

    统一执行契约，让权限、会话、工具与测试保持一致。

  2. Skills 是核心能力，Sources 不在产品范围内

    全局、工作区与项目级 Skills 均支持实时发现与编辑。MkAgent 不包含 Craft 的通用 API/MCP Sources、用户可配置的 MCP 连接池以及 Source OAuth 流程。

    为什么这样取舍

    更小的凭证与工具边界更容易检查、安全维护和二次定制。

  3. OpenConnector 仅作为有限的桌面端集成

    Electron 内置固定版本的 OpenConnector 辅助进程，只向 Pi 提供 5 个固定工具。WebUI 和 CLI 不开放该能力，也不会因此恢复通用 MCP Sources。

    为什么这样取舍

    外部操作依然明确、受权限控制，同时不把核心产品变成集成平台。

  4. 先做好本地工作，再考虑托管协作

    Projects 与看板、消息网关、公开会话分享、远程工作区、产品自动化和图片生成不属于当前版本。

    为什么这样取舍

    这些功能需要独立的托管服务与运维契约。MkAgent 保持本地优先，也保持易于 Fork。

开发者最先会问的问题

两者都是。它既是一套可直接运行的本地 Agent 产品，也是一个可以 Fork 成自有跨平台 Agent 应用的开源代码库。

MkAgent 通过 Pi 后端支持 ChatGPT Plus 与 Claude Pro/Max 订阅、服务商 API Key、兼容 OpenAI 或 Anthropic 的接口，以及本地 Ollama 模型。

工作区、会话、Skills 与视图都保存在本地 MkAgent 配置目录中。模型凭证由操作系统凭证管理器安全保存。

可以。代码库集中管理产品标识、路径、软件包、协议处理和桌面端构建配置，方便你完成品牌定制。

不是。Pi 是统一的 Agent 运行时，并不限制模型服务商。它可以连接 ChatGPT Plus、Claude Pro/Max、服务商 API Key、兼容 OpenAI 或 Anthropic 的接口，以及本地 Ollama 模型。

MkAgent 有意不包含 Claude Agent SDK、Copilot、通用 API/MCP Sources、Projects 与看板、消息网关、公开分享、远程工作区、产品自动化和图片生成。

打造一款真正由用户掌控的 Agent 产品

从一套可直接运行的本地产品开始，再围绕你的用户定制模型、工具、工作流程与品牌。

下载GitHub