如何在一个 AI 工作空间中整合代码、设计和文本 — 体验 Kun
使用 AI 助手的典型工作流程看起来很混乱。开发者从 IDE 复制一段代码到 ChatGPT 浏览器窗口,要求修复逻辑,再粘贴回结果,运行测试,发现错误,又急匆匆回到网页界面。如果再加上文档撰写或 UI 原型绘制任务,在标签页之间切换就变得没完没了。
Kun 项目的开发者决定将代码编写、文本、设计和自动化功能整合到一个统一的本地环境中。这个工具的核心特点是共享运行时机制,能够同时连接图形界面和终端。

一个运行时同时支持图形窗口和控制台
Kun 基于服务器进程 kun serve 构建。它在本地机器上启动,负责会话管理、任务历史、LLM 连接和命令执行。
你可以启动桌面 Electron 应用,同时在项目文件夹中打开终端,只需输入命令:
kun
两个界面立即共享相同的工作上下文。需要快速发送简短说明而不想离开键盘——就在 TUI 中输入。想查看文件差异、编辑可视化画布,或分析带截图的 PDF 文档——切换到 GUI。所有更改、行动计划,和工具调用历史都保持同步。
五个工作空间应对不同任务
作者没有将项目局限于基本的"AI 编程"。工作空间被划分为五个专业模块。

- Code。完整的仓库操作模式。代理可以搜索文件、进行编辑、执行控制台命令、运行测试,并输出内部变更差异。
- Write。用于准备文档、文章或报告的环境。支持内联文本补全和编辑,可导出为 Markdown、HTML、PDF、DOCX 和 PPTX 格式。

- Design。用于布局交互式 HTML/CSS 原型和生成设计系统文件(
DESIGN_SYSTEM.md)的模式。绘制的界面可以直接传递给编码模块。

- Research。处理多模态上下文的工作模式。你可以上传 PDF 文件、图表或截图,代理从中提取事实、收集论据并生成最终笔记。
- Automate。用于运行后台任务的模块。你可以在此配置计划、重复循环、钩子,并通过 MCP(Model Context Protocol)连接外部工具。

Agent Graph 如何处理复杂任务
对于简短问题或定向编辑,Kun 有 Direct 模式——无需繁琐流程的快速对话。但如果任务涉及数十个文件并需要顺序验证,实验性的 Agent Graph 模式就会启动。
在此模式中,主代理(Lead Agent)首先构建依赖图。然后将任务分解为小型子任务,并委托给隔离的子代理。每个子代理仅获得其阶段所需的权限、工具和文件访问权限。
工作结果只有在主代理验证更改并确认测试通过后才会沿链传递。如果任何步骤发生失败,图不会假装一切顺利。任务可以暂停、手动修正,或将单独节点重新发送执行。
本地数据和自由选择模型
Kun 采用本地优先原则设计。整个会话数据库、日志、本地设置和项目文件都仅存储在你的磁盘上。
同时,项目不强制使用特定的神经网络。通过统一的设置菜单,你可以连接几乎任何提供商:
- 通过 Ollama 使用本地模型
- OpenAI、Anthropic、Gemini、DeepSeek、Qwen 或 Kimi 的云 API
- 任何兼容 OpenAI Chat Completions 或 Anthropic Messages 的第三方服务
如果你选择云提供商,具体的请求数据和附加文件将被发送到其服务器。在处理公司专有代码时,这一点值得注意。
如何部署和体验
项目的 releases 页面提供 macOS(Intel 和 Apple Silicon)、Windows 和 Linux 的预构建包。如果你想从源码运行或修改后端代码,需要 Node.js 22.19 或更高版本。
从仓库启动的标准流程如下:
git clone https://github.com/KunAgent/Kun.git
cd Kun
npm ci
npm run dev
还提供了一个特殊命令来单独启动终端客户端:
npm run dev:tui
首次启动后,只需配置至少一个 API 密钥或 Ollama 中的本地模型,然后就可以打开所需的项目。
值得安装吗
Kun 看起来是一个可行的尝试,将开发者分散的工具包整合到一个统一的可管理系统中。TUI 和 GUI 之间的无缝运行时确实消除了在控制台和浏览器窗口之间复制上下文的需求。
需要注意的是 PolyForm Noncommercial 1.0.0 许可证。对于个人项目、研究和学习,该工具完全免费。但商业使用或嵌入付费产品需要获得作者的单独许可。不过,公司可以通过发送电子邮件向开发者申请免费书面许可,供内部员工使用。
相关项目