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/.zipWindows 用.exeLinux 用.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 --registryhttps://registry.npmmirror.com。无论哪种方式首次启动都只需完成三个动作选择界面语言Kun 会记住你的偏好配置模型 Provider——这一步是重点。Kun 不绑定任何单一模型订阅登录、Coding Plan、Token Plan、按量 API、OpenAI / Anthropic 兼容服务、自托管模型都可以在同一个 Provider 入口管理常见生态如 Claude、Gemini、DeepSeek、Kimi、Qwen、Ollama 都有预设打开一个本地项目或新建工作区发一条目标清楚、范围有限、可以验证的短任务先感受一下 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 共享同一套任务与运行时。输入任务按回车即发支持CtrlP调出命令面板、滚轮翻历史还能直接CtrlV粘贴截图作为输入。写代码、改配置这类场景终端往往比鼠标快得多。避坑实录新手最容易踩的五个翻车点坑一以为必须绑定某一家模型。不少用户一上来就问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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考