夜雨聆风你打开一个AI编程工具，说"帮我写个登录页面"，它吐出一堆代码。你复制粘贴，跑起来，发现忘了限制密码长度。你回去改，又发现忘了做错误提示。来回折腾三圈，登录页写了一整天。
你根本没想清楚"登录页面"到底需要什么，AI写的代码再好也白搭。
KunAgent团队为此做了Kun。它先追问你：密码要多少位？要不要记住登录状态？手机号登录还是邮箱登录？等你答完这些，它生成一份需求文档，一份设计方案，一份实施计划，然后才动手编码。
Kun是一个桌面AI Agent工作台，定位"需求先行的下一代coding范式"。
截至2026年6月17日，Kun收获了4420个Star，发布19个版本（最新v0.2.13），v0.2.11到v0.2.13只用了3天。项目由KunAgent团队开发，2026年5月21日创建，还不到一个月。
许可证注意：Kun采用PolyForm Noncommercial 1.0.0许可证。个人学习和研究免费使用，但商业用途需要书面授权。教育机构可以非商业教学使用。这和MIT、Apache等传统开源协议不同。
官网：https://github.com/KunAgent/Kun
亮点一：需求先行的6阶段闭环
大多数AI编码工具的工作流是：你提需求→AI写代码→你检查代码。单向，线性，没有回路。
Kun的工作流是6阶段闭环：
这个闭环的关键是第6步回到验收。Agent写完代码后，拿着最初的需求文档和验收标准对照检查：密码长度限制做到了吗？错误提示做了吗？记住登录状态做了吗？
你可以在项目根目录下找到.kunsdd文件夹，里面有完整的需求草稿和实施计划。Agent帮你生成这些文档，你也可以手动修改。
亮点二：三个工作台，一个运行时
Code编码工作台
绑定你的本地代码仓库。Agent读取项目上下文，执行shell命令，修改文件，提交前让你审查变更。
Write写作工作台
长文写作空间。Markdown文件树，四种视图。FIM补全（650ms/96token）、灵感长补全（2.8s/256token）、选区inline agent。导出HTML/PDF/DOC/DOCX。
Connect手机连接/自动化
后台自动化。接入飞书/Lark频道，设置webhook/relay，创建定时任务。你不在电脑前，Agent替你回复飞书消息。
三个工作台通过同一个Kun HTTP/SSE边界通信，共享你的API Key和模型设置。切换工作台不需要重新配置。
亮点三：本地优先，数据全在你手里
Kun的设计原则第一条是"Local-first"。
你的请求走你自己的DeepSeek API Key，代码和需求文档留在本地磁盘。
Kun运行时是一个本地HTTP服务器（127.0.0.1:7878），Electron壳通过HTTP/SSE和它通信。Agent逻辑全部在Kun运行时进程里，React渲染器只负责显示，不实现任何Agent逻辑。
亮点四：可观察，可控制
可观察
Agent执行的工具调用、文件变更、推理步骤，在界面中可见。你能看到Agent做了什么决定，读了哪些文件，执行了什么命令。
可控制：审批策略（5级）
可控制：沙箱模式（4级）
你可以在Agent运行中途打断它（interrupt），也可以中途追加指令（steering）。Agent正在写代码，你发现方向偏了，发一条消息纠正，Agent在下一个安全边界接收你的指令。
变更审查面板在右侧Inspector里，展示所有文件修改，支持内联diff对比。你点Allow才写入文件。
亮点五：缓存优化省token
Kun的Agent Loop是"cache-first"设计。系统提示词、工具定义、固定约束、few-shots组成一个Immutable Prefix，带sha256指纹。每次模型调用前验证指纹一致性，漂移立即报错。
实测cache hit rate
94.7%
12轮对话
95.2%
24轮对话
你多轮对话中不到6%的token是新鲜计算的，其余命中缓存。相比没有缓存的工具，token消耗省60%以上。
上下文压缩阈值：软阈值16k tokens，硬阈值24k tokens。超过阈值后，Agent自动折叠长历史为一条compaction记录，始终保留Immutable Prefix中的固定约束。
模型组合：DeepSeek+MiMo+MiniMax
使用前提：你需要至少一个API Key。DeepSeek是主力模型，没有DeepSeek Key无法正常使用编码功能。
DeepSeek API价格（截至2026年6月）：v4-flash缓存命中0.02元/百万token；v4-pro缓存命中0.025元/百万token。配合90%+缓存命中率，日常编码一天不到1元。
实操演示：从模糊想法到完整代码
假设你想给一个React项目加一个用户反馈功能。你打开Kun Code工作台，输入：
"我想加个用户反馈功能"
Kun先追问你：反馈类型有哪些？要上传截图吗？反馈提交后给用户什么回应？管理员在哪里看反馈？
你逐条回答后，Kun生成需求草稿。你修改验收标准（比如"管理员必须在24小时内回复"）。输入/plan，Kun生成实施计划。点击Build，Agent开始编码。编码完成后，输入/review，Kun对照需求检查代码。
整个流程：需求→设计→计划→编码→验收→再编码→再验收。
竞品对比
Kun的.kunsdd需求文档体系，目前其他竞品没有类似机制。
上手指南
第一步：安装 下载地址：https://github.com/KunAgent/Kun/releases 。macOS选arm64/x64的dmg，Windows选x64的exe，Linux选AppImage或从源码编译。
第二步：配置API Key 首次启动进入设置页面，填入DeepSeek API Key。获取地址：https://platform.deepseek.com
第三步：打开Code工作台 选择你的项目目录，Agent绑定后可读取文件、执行命令、修改代码。
第四步：开始对话 输入你的需求，或输入/plan直接进入计划模式。
适合谁用
注意事项1. 许可证：PolyForm Noncommercial 1.0.0，商业用途需书面授权2. 项目早期：v0.2.x阶段，可能不稳定3. 需要DeepSeek API Key，非开箱即用4. 只有桌面端，无手机版和网页版5. Linux自动更新器不支持，需手动下载
总结
Kun解决的是你想清楚要写什么了吗。
✅ 6阶段闭环：澄清→沉淀→设计→计划→编码→验收
✅ 5级审批+4级沙箱：关键操作可控
✅ 90%+缓存命中率：token花费每天几毛钱
✅ 本地优先：代码和需求文档留在你的磁盘
如果你厌倦了"AI写代码你修bug"的来回折腾，试试Kun。先答问题再写代码。
官网：https://github.com/KunAgent/Kun
