KunAgent/Kun · 上手攻略
- 仓库：KunAgent/Kun
- 链接：https://github.com/KunAgent/Kun
- 分类：agent
- 作者：Tom
- 更新：2026-07-12
这是什么
Kun 是一个面向"需求先行"编程方式的桌面 AI Agent 工作站。它不只聊天，也不只是给程序员的 CLI 外壳——而是通过 Code（代码）、Design（设计）、Write（写作）三大并列模式，把需求澄清、UI 设计、计划执行、编码验证串成完整闭环。
核心思路：从需求开始，而不是从一句话改代码开始。在 GUI 中新建需求草稿 → AI 帮你澄清问题、做调研 → 生成设计稿或交互原型 → 进入实施计划 → Agent 执行编码 → 验收审查。每个环节都有 AI 参与，每个环节的产物都能沉淀下来。
Kun 默认不绑死单一模型供应商，而是用 DeepSeek（文本推理）、Xiaomi MiMo（多模态语音）、MiniMax（媒体生成）三个中国高性价比厂商组合，覆盖文本、代码、视觉、语音、图片、音乐、视频全链路。
解决什么问题
- 传统 AI coding 太碎片：大多数 AI 编程工具只做"问答 + 改代码"，没有需求澄清、设计到交付的完整链路。
- 模型成本高导致流程跑不起来：完整的需求驱动流程比普通聊天更长更贵，三家中国厂商组合让每千 Token 成本可控。
- 文件读写/命令执行的信任问题：Agent 读写本地文件、执行 shell 命令时，Kun 提供工具审批、权限模式和变更审查面板，安全感更强。
- 设计稿无法衔接代码：Design 模式生成的设计稿和 HTML 原型可以直接交给 Code 模式实现，设计到代码不再断档。
快速安装
方式一：下载安装包（推荐普通用户）
前往 GitHub Releases 下载最新版本，当前最新每日构建为 v0.2.25-dev：
| 平台 | 安装包 | 架构 |
|---|---|---|
| macOS | .dmg 或 .zip | Intel / Apple Silicon |
| Windows | .exe（NSIS 安装器） | x64 |
| Linux | .AppImage | x64 |
首次启动按引导选择界面语言、填写 API Key 即可。
方式二：从源码运行（开发者）
# 依赖
# Node.js 20+
# npm
git clone https://github.com/KunAgent/Kun.git
cd Kun
npm install
# 开发模式（ Electron 开发环境 + Kun 运行时）
npm run dev
⚠️ 中国大陆访问 npm 较慢时可加镜像：
bash npm install --registry=https://registry.npmmirror.com
常用开发命令：
| 命令 | 说明 |
|---|---|
npm run dev |
构建运行时 + 启动 Electron 开发环境 |
npm run build |
生产构建 |
npm run typecheck |
TypeScript 类型检查 |
npm run test |
Vitest 测试 |
npm run dist:mac |
构建 macOS .dmg 和 .zip |
npm run dist:win |
构建 Windows NSIS 安装器 |
npm run dist:linux |
构建 Linux AppImage |
模型 Provider 配置
启动后首次设置引导中填写 Provider，凭据支持：
- DeepSeek（默认）：deepseek-v4-pro / deepseek-v4-flash
- Xiaomi MiMo：长上下文文本、视觉输入、ASR 语音转写、TTS 语音生成
- MiniMax：图片生成、音乐生成、视频生成
- 自定义 OpenAI 兼容接口：填入 Base URL、模型列表即可
核心用法
Code 模式：面向真实代码库工作
绑定本地项目目录，Kun Agent 读取项目上下文、搜索代码、执行 shell 命令、修改文件。关键功能：
/plan/create_plan：从需求生成 GUI 管理的实施计划（.kunsdd/plan/...）- Todo 关联：计划步骤可关联到需求，变更需求时提示重规划
- 变更审查：提交前审查每次文件变更，内联 diff
- 会话管理：压缩、恢复、分叉（fork）、归档
Design 模式：AI 生成 UI 设计稿与交互原型
从自然语言描述、需求片段或现有界面截图出发，生成： - UI 设计稿 - 交互式 HTML 原型 - 节点式设计流程图 - 共享 DESIGN_SYSTEM.md
版本可迭代，画布可预览，设计系统可导出，并支持一键交给 Code 模式实现（Design → Code 闭环）。
Write 模式：Markdown 长文档工作区
- 文件树、Live / Source / Split / Preview 多种视图
- 补全、选区改写、图片附件
- 导出格式：HTML / PDF / DOC / DOCX
需求先行工作流（Kun 最核心的理念）
需求草稿 → AI 澄清与结构化 → 需求文档（.kunsdd/draft/.../requirement.md）
→ 设计稿 / 交互原型（Design 模式）
→ 实施计划（/plan）
→ Todo → Agent 编码 → 变更审查 → 验收（/review）
自动化 Loop（节点式工作流）
类似 n8n / Dify 的可视化节点编排画布，把多步 Agent 流程画成可运行、可复用工作流。触发器丰富，支持本地运行 API，可绑定到 hook 阶段。
MCP 与 Skills
支持接入 Model Context Protocol 服务器，以及项目级/全局 Skills，让 Agent 按任务获得更专门的工具集。
远程入口：飞书 / Lark / 微信
把桌面会话接到 IM 工具，支持本地 webhook、relay 和定时任务，飞书/Lark/微信均可触发后台 Agent 任务。
典型适用场景
场景一：从需求文档到代码交付的完整流程 产品经理在 Write 模式写好 PRD → Design 模式生成 UI 草图 → Code 模式生成实施计划 → Agent 编码 → /review 验收，全程不离开 Kun。
场景二：UI 原型快速迭代 设计师用 Design 模式生成多版 UI 方案，通过画布对比，选定方案直接交给 Code 模式实现，避免手动切图和规格传递。
场景三：后台定时任务触发 通过飞书/Lark/微信配置 webhook，飞书里 @bot 触发一个需要运行 2 小时的代码分析任务，完成后结果推回 IM。
场景四：文件变更安全审查 Kun 修改文件前强制内联 diff 显示改动内容，开发者确认后才落地，适合代码规范要求严格的团队。
坑与注意
- 许可证限制（重要）：Kun 采用 PolyForm Noncommercial License，禁止任何商业使用。商业产品集成、SaaS/托管服务、二次销售均需作者单独书面授权。公益教育机构可用于非商业教学研究。
- v0.2.25 仍为 pre-release：
v0.2.25是每日构建版本号，不是语义化 release，企业生产使用前建议等待稳定版发布。 - 首启动需要模型凭据：没有 DeepSeek/MiMo/MiniMax 或 OpenAI 兼容 API Key 时，Kun 核心功能无法使用。
- 文件读写/命令执行有风险：Code 模式下 Agent 会读写本地文件和执行 shell 命令，虽然有权限模式和审批，但首次使用建议从备份过的项目或测试目录开始。
- 国内 npm 镜像问题：从源码安装时中国大陆网络可能很慢，务必加
--registry=https://registry.npmmirror.com。 - 与 VS Code / JetBrains 插件不同定位：Kun 是独立桌面应用，不是 IDE 插件；如果你习惯在编辑器里用 Copilot，Kun 走的是另一个方向（更完整的流程而非更深的代码补全）。
与同类对比
| 方案 | 定位 | 模型组合 | 许可证 | 特色 |
|---|---|---|---|---|
| KunAgent/Kun | 需求先行桌面 Agent | DeepSeek + MiMo + MiniMax（可自定义） | PolyForm Noncommercial | 需求→设计→计划→代码完整闭环，Design↔Code 双向衔接 |
| AutoGPT | 自主任务完成 Agent | OpenAI（可自定义） | Apache-2.0 | 纯 Agent 自主执行，无 GUI，无设计模式 |
| Goose | 本地 CLI Agent | OpenAI / Anthropic（可自定义） | Apache-2.0 | 本地文件操作强，无桌面 GUI，流程管理轻量 |
| Cursor | AI 代码编辑器 | OpenAI / Claude（可自定义） | 专有 | 深度 IDE 集成，代码补全强，无独立需求/设计流程 |
| Kun | 独立桌面应用 | 三家中国厂商组合 | 非商业 | 完整 GUI 工作流，适合非程序员或产品/设计角色 |
核心差异：Kun 的护城河是"需求→设计→计划→代码"全链路 GUI 化，其他工具要么只做代码（Cursor、Copilot），要么纯 CLI 无 GUI（Goose、AutoGPT），要么没有 Design 环节。
一句话推荐结论
如果你希望 AI coding 从"问答改代码"升级为"需求驱动的完整软件生产流程"，且不介意其非商业许可证，Kun 是目前将需求澄清、UI 设计、计划执行和代码交付无缝串在一起的最佳桌面级方案；配合 DeepSeek/MiMo/MiniMax 的高性价比组合，完整工作流的使用成本也相对可控。