Kun 完整上手教程：一条主线从安装到交付可交互 UI 设计稿

Kun 完整上手教程：一条主线从安装到交付可交互 UI 设计稿

【免费下载链接】KunLocal-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.项目地址: https://gitcode.com/gh_mirrors/de/Kun

第一次接触 Kun，你可能会被"本地优先的 AI Agent 工作台"这个定位弄得有点摸不着头脑。简单说，Kun 是一个把代码、写作、设计、研究和自动化放进同一个桌面的 AI 工作台，桌面 GUI 与终端 TUI 共用一套运行时。这篇文章会用一次真实的小型交付——从零做出一个可交互的网页设计稿——把 Kun 从安装配置、设计生成、原地迭代到交给编码 Agent 落地的完整链路走一遍，读完你就能照着动手。

一张能力地图读懂 Kun 的五个工作区

与其把 Kun 当成"又一个聊天框"，不如把它看作一条完整流水线：需求澄清 → 设计 / 写作 / 编码 → 计划执行 → 审查测试 → 验收交付。每个环节都有对应的工作区承接。

• Code 工作区：直接打开真实代码库，搜索文件、编辑代码、跑命令、看 Diff 和测试结果，负责把方案变成可运行的产品。
• Write 工作区：面向长文档写作，支持大纲生成、内联补全、选中文本润色，可导出 HTML、PDF、DOCX 甚至可编辑的 PPTX。
• Design 工作区：本文的主角。输入一句需求或参考图，AI 产出单文件交互式 HTML 原型，画布实时渲染，还能反向把已有界面变成可迭代的稿子。
• Research 工作区：丢进 PDF、图片、网页线索，AI 负责阅读、提取证据、组织结论，把研究过程沉淀成可持续使用的上下文。
• Automate 工作区：把重复劳动交给定时任务、可视化 Loop、Hook、MCP 与 Skills，让机器在后台持续干活。

这套设计决定了它的适用人群相当广：需要改代码的开发者、要交稿的写作者、想做界面原型的 UI 设计师、啃文献的研究人员，以及想把日常重复工作外包给 AI 的个人和小团队。你不需要在多个软件之间搬运上下文，因为任务、计划、审批和记录都长在同一个运行时里。

五分钟完成安装与首次启动的三个动作

Kun 支持 macOS、Windows x64 和 Linux x64，上手方式有两种，按需选择即可。

方式一：安装桌面版（推荐新手）。从官方 Release 页下载对应平台的安装包——macOS 用.dmg/.zip，Windows 用.exe，Linux 用.AppImage或.deb。桌面版已经内置 TUI，装好后打开终端输入kun，就能在同一台机器的同一个运行时里切换 GUI 和终端两种界面。

方式二：从源码跑起来。想尝鲜最新能力或参与开发，可以克隆仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/de/Kun cd Kun npm install

启动桌面开发环境用npm run dev，只想启动终端版用npm run dev:tui。国内网络慢的话，安装依赖时可加镜像参数npm install --registry=https://registry.npmmirror.com。

无论哪种方式，首次启动都只需完成三个动作：

1. 选择界面语言，Kun 会记住你的偏好；
2. 配置模型 Provider——这一步是重点。Kun 不绑定任何单一模型，订阅登录、Coding Plan、Token Plan、按量 API、OpenAI / Anthropic 兼容服务、自托管模型都可以在同一个 Provider 入口管理，常见生态如 Claude、Gemini、DeepSeek、Kimi、Qwen、Ollama 都有预设；
3. 打开一个本地项目或新建工作区，发一条"目标清楚、范围有限、可以验证"的短任务，先感受一下 Agent 的真实工作方式。

到这里你已经站在起跑线上了。接下来认识一下每天要面对的主界面。

GUI 工作台布局拆解：左栏、画布与 Agent 面板

Kun 的工作台采用经典的三栏布局，逻辑非常直观：

• 左侧栏：项目与会话的入口，集中管理项目列表、对话历史、定时任务、插件与扩展；顶部还有新建任务、搜索的快捷按钮。
• 中间主区：任务输入与画布所在地。输入任务后，这里会逐步呈现计划、文件改动、工具调用结果与最终产出。
• 右侧面板：Agent 的"工位"。输入提示词、查看工作进度、调整当前工作区的专用配置，都在这边完成。

值得一提的设计是 GUI 与 TUI 的共享运行时：桌面窗口和终端里的kun连接的是同一个本地服务，线程、计划、审批、用量和后台任务完全互通。你可以在窗口里发起一个长任务，切到终端继续盯进度，甚至关掉 GUI 让它在后台跑完。

主线实战：把落地页从一句需求做成可交付原型

下面进入正题。我们用"为一个新产品做一个落地页"作为贯穿全程的案例，走完从需求到原型交付的完整链路。每一步都说明做什么、为什么这么做、预期看到什么结果。

第 1 步：写下可验收的目标。别急着打开画布，先明确"成功长什么样"。例如：一个响应式落地页，包含导航、产品特性、用例和行动号召四个区块，主色为海军蓝配青色。Kun 会把这条目标作为后续所有工作的验收基准。

第 2 步：进入 Design 工作区并选择项目目录。在顶部分页切换到 Design，新建一个设计线程，并指定它要落盘的目录。设计产物会作为独立文件保存在项目的.kun-design/文件夹下，每个版本都有编号，可随时回溯。

第 3 步：配置设计上下文。这是 Kun 设计模式最有特色的环节——不用在长提示词里反复描述风格，而是通过表单结构化地告诉 AI：品牌主色、整体调性（tone）、设计系统预设（内置 shadcn、material、iOS、brutalism 等 14 套风格）、以及圆角、密度、字体等设计令牌。选好预设，AI 生成的内容天然自带一套统一的排版和间距规范。

第 4 步：描述需求，看画布实时生长。在右侧输入"帮我设计一个落地页"，AI 会先写出一个精简骨架，再逐步补全成一份自包含的 HTML 文件，而中间画布会边写边刷新。你不需要等它全部完成，中途看到不满意的地方就能打断纠偏。

第 5 步：原地迭代，而不是推倒重来。第一版出来后，继续在同一个线程里提修改意见："把特性区改成三列卡片""行动号召按钮换成品牌色"。每一轮对话都会追加一个新版本文件，历史版本全部保留，改坏了随时回退。这样积累出来的稿子，比一次性让 AI"生个完美的"可靠得多。

第 6 步：一键交给编码 Agent 落地。设计稿定稿后，点击 Implement in code。Kun 会做三件事：把设计上下文沉淀为共享的DESIGN_SYSTEM.md、打开一个全新的代码线程、把实现任务连同设计规范一起派发下去。这一步的意义在于，设计与代码共用同一份设计系统，实现阶段不会"走样"。

第 7 步：预览、导出、对照验收。画布提供 preview（静态预览）、code（查看源码）和 live（真实运行的应用）三种视图，其中 live 视图直接加载代码模式起的开发服务器，看到的就是最终产品的样子。满意后可以从画布工具栏导出独立 HTML 或 PDF 文件，再回到第 1 步写的验收标准逐条核对。

老手提速的三条心法

把上面的流程跑顺之后，再送你三条能显著提效的心法。

心法一：让设计与代码形成双向闭环。除了"设计 → 实现"这一方向，Kun 还支持反向设计：在代码模式的预览面板里选中一个已有界面，直接"重设计"成可迭代的 HTML 稿。更贴心的是漂移标记——设计稿在实现之后又改了，会显示"重新实现"提示；反之，若共享设计系统更新而实现还是旧版，会出现警告徽章，避免两边悄悄脱节。

心法二：把重复劳动交给定时任务。如果你经常做"每周汇总""例行巡检"这类固定动作，可以在 Automate 工作区创建 Schedule 任务，设定频率和提示词，Kun 到点自动执行并把结果留档。界面里能清楚看到任务状态、下次运行时间和最近一次的结果明细，适合团队周报、每日竞品跟进等场景。

心法三：用 TUI 保持手不离键盘。终端版并不比桌面版"低人一等"，它和 GUI 共享同一套任务与运行时。输入任务按回车即发，支持Ctrl+P调出命令面板、滚轮翻历史，还能直接Ctrl+V粘贴截图作为输入。写代码、改配置这类场景，终端往往比鼠标快得多。

避坑实录：新手最容易踩的五个翻车点

坑一：以为必须绑定某一家模型。不少用户一上来就问"Kun 是不是只能用某个模型"。答案是都不必——Provider 入口统一管理订阅、套餐与 API，按默认 Agent、线程、Design、Write、Schedule 或子代理分别选模型都可以。先把自己手头已有的账号或 Key 配进去即可。

坑二：把"本地优先"理解成"数据绝不离机"。会话、偏好和运行时数据默认保存在本机，但一旦你选择云端 Provider，提示词、附件和任务上下文就会发送给对应模型服务。涉及敏感内容前，务必确认所用 Provider 的数据政策。

坑三：导出稿格式不对就怪工具。导出前先确认格式与分辨率设置；导出 PDF 走的是内置打印管线，若页面被裁切，检查画布视口尺寸是否匹配目标页面。升级到最新版本通常也能顺手解决不少导出怪问题。

坑四：GUI 和 TUI 任务"对不上"。两者连接的是同一个本地kun serve运行时，正常情况下状态完全同步。如果出现不一致，多半是开了多个运行时实例，确认只保留一个服务即可。

坑五：复杂任务一律上 Agent Graph。Graph 模式适合跨文件、多阶段、可明确验收的任务，但简单问答和单点修改用它反而慢。记住一个原则：轻活走 Direct，重活再上 Graph，调度器会按依赖关系派发子代理并做验收，而不是把所有事压给一个长对话。

收尾：把 Kun 纳入你的日常工作流

回到开头的那个问题：Kun 到底值不值得花一下午上手？答案取决于你是否厌倦了在聊天框、编辑器、文档和终端之间手动搬运上下文。Kun 的价值不在于某个单点功能多惊艳，而在于它把"从想法到可验收交付"这件事完整地串了起来——设计稿不再停在截图，而是带着设计系统一路走进代码；定时任务不再依赖人工提醒，而是自动跑完并留好证据。

如果你想深入了解某个方向，仓库里的文档是最佳下一站：设计模式的画布与 Design→Code 机制见 docs/DESIGN_MODE.md，终端版完整用法看 docs/kun-tui.md，复杂任务的 Agent Graph 调度与恢复机制在 docs/graph-mode.md，扩展开发入门可以从 docs/extensions/README.md 开始。建议你先照着本文做一次完整的小型交付，再决定要往哪条纵深路线走——毕竟，工具是拿来干活的，只有真正跑通一次，你才会知道自己需要它为你省下多少时间。

【免费下载链接】KunLocal-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.项目地址: https://gitcode.com/gh_mirrors/de/Kun