从源码运行需 Node.js 22.19+;Linux 的 .deb 要用 sudo apt install ./Kun-*.deb 安装,dpkg -i 不处理依赖;单独用 TUI 需先退出桌面应用,否则用 kun --no-start 连接已有运行时;许可证为 PolyForm Noncommercial 1.0.0,商用需单独授权。

Kun
KunAgent活跃维护本地优先的 AI 智能体工作台,把编码、写作、设计、研究和自动化统一到一个运行时里,桌面 GUI 和终端 TUI 都能用。
Local-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.
git clone --branch develop https://github.com/KunAgent/Kun.git
cd Kun && npm ci && npm run devREADME 未说明具体显存或 GPU 要求;提供 macOS(Apple Silicon/Intel)、Windows x64、Linux x64 安装包,本地模型可接 Ollama。
本地优先的 AI 工作台,桌面 GUI 与终端 TUI 共用一个运行时,写代码、做文档、跑 Agent 协作
本地优先的 AI 智能体工作台,把编码、写作、设计、研究和自动化统一到一个运行时里,桌面 GUI 和终端 TUI 都能用。
核心能力
- Code 模式整合项目、终端、Git 与 Diff,Design 画布先出原型再交给 Agent 实现
- Work 模式用标签页与分屏组织文档、论文和资料,选中文字即可改写或引用到会话
- 可与个人 Agent、Codex、Claude Code、OpenCode 私聊或拉群分派任务
- 会话、记忆、日志存本地,工具与目录权限默认需批准
- 支持 OpenAI/Anthropic 兼容接口及 DeepSeek、Kimi、GLM、Qwen、Ollama 等预设
容易踩的坑
- v0.4.5Kun 0.4.5最新正式版2026-11-09 · 2026-11-09 04:26 UTC
Kun 0.4.5
0.4.5 把 Kun 带到桌面和更多设备:桌面伙伴随时陪你对话,远程访问统一管理手机与电脑,PDF 有了独立标签页和论文助手。同时改进计划任务批量管理、浏览器浮窗预览与扩展手机视图,并修复响应中断、图片保留和跨版本更新问题。
✨ 新功能
- 桌面伙伴:小坤、ikun 和鲸鱼娘来到桌面,支持快捷对话、语音输入和任务气泡。可导入 Codex 宠物包,也可邀请伙伴短暂来访、调整来访频率或暂停来访;默认不显示,需要在“设置 → 宠物”选择并唤醒。自动陪伴感知打字、录音等活动状态,不读取输入文字,也不采集音频;跟随其他软件的录音状态默认关闭。
- 手机与桌面远控:一个远程访问主开关,集中管理手机、桌面远控和浏览器入口。逐设备设置“仅查看”或“查看与控制”,随时撤销授权,并分别提示缺少的屏幕录制或键鼠权限。手机远控需要 Kun 账号与 Plus 及以上权益;电脑之间远控首版支持同账号的 Apple Silicon Mac(macOS 13 及以上)。
- PDF 标签页与论文助手:PDF 使用独立的 Work 标签页,每篇论文都有自己的助手会话。切换标签保留阅读位置和工作文件夹,引文可点回对应页面,选中的原文先进入草稿,由你确认后发送。
- 计划任务批量管理:在可搜索、可筛选的列表中浏览计划任务,通过详情面板查看内容。支持批量启用、停用和删除,删除前确认,并避免误启用已经过期的一次性任务。
- 远控组件与手机直连:远控组件按需下载、独立更新,后台校验后等待空闲启用,失败时回退。手机可通过局域网、Tailscale 或自建隧道直连电脑,用 5 分钟内有效、仅能使用一次的配对信息建立独立授权的加密连接,会话和附件不经过官方中继。手机终端由电脑托管,桌面顶部显示可随时结束的提示。
- 浏览器浮窗预览:浏览器预览支持拖动、方向键移动、缩放和吸附回侧栏。你开始手动操作时 AI 会暂停;空间不足、会话停止或需要清理临时数据时都有明确提示,清理前需要确认。
- 扩展手机视图:扩展 API 可声明轻量的只读原生手机视图,用于展示文本、指标和选项状态。不运行网页脚本或远程动作;未声明手机视图的扩展会标为仅桌面可用。
- Design 预览与缩略图:HTML 画板保留有数量上限的预览与缩略图,按优先级分配预览资源。多画板场景不再同时启动全部预览,减少资源占用。
🐛 修复与改进
- 响应中断:保留已经收到的内容,不再重放请求并拼接第二次生成。模型流中断时明确标为“响应中断”,只在可确认时说明保留了部分内容。
- 外部 Agent 模型列表:Agent 升级或启动路径变化后重新探测模型与模式列表,避免刷新后只剩默认模型。
- 委托与团队提示:及时显示容量不足和启动前失败,重启后恢复失败通知。改善批量分派结果与旧拒绝提示的对应关系,避免静默挂起或重复打扰。
- 更新与安装:改善 Windows 跨版本更新的待处理状态保留和中止安装后的旧版重启。更新状态核对等待运行时就绪,减少新旧实例切换冲突。
- 图片与预览:大工具结果转存为产物时,保留有大小上限的图片内容,避免图片丢失。深色主题下 HTML 预览保持原有对比度。
- 界面与模型选择:文件操作不再遮住长文件名,专注模式下不再弹出瓶子掉落提示。恢复 gpt-6.1-terra 的推理档位选项。
兼容与隐私提示
桌面伙伴仅在桌面应用中可用。系统级打字联动仅支持 macOS 且需要输入监控权限;跟随其他软件录音状态需要 macOS 14.2 及以上,默认关闭。Linux 若不支持点击穿透,会退回有边界的伙伴窗口。
电脑之间远控首版仅支持同账号的 Apple Silicon Mac(macOS 13 及以上),需要屏幕录制与辅助功能权限;桌面授权不自动包含聊天、终端或文件权限。远控组件首次使用需要联网下载。
浏览器入口使用明文 HTTP,仅适合可信网络。手机中继使用 TLS,但目前不提供端到端加密,附件临时经过云存储;直连会话与附件不经过官方中继,仍需先登录 Kun 并允许访问系统安全存储。
English
Kun 0.4.5 brings Kun to your desktop and more devices: desktop companions for quick chats, unified remote access, and PDF tabs with a per-paper assistant. This release also improves scheduled-task management, floating browser previews, and extension mobile views, with fixes for interrupted responses, image retention, and cross-version updates.
Features
- Desktop companions: Meet Xiao Kun, ikun, and Whale Girl, with quick chats, voice input, and task bubbles. Import Codex pet packages, invite friends for short visits, adjust visit frequency, or pause visits. Companions stay hidden until you choose and wake one under Settings → Pets. Automatic reactions observe typing and recording activity states, not typed text or audio; following recording in other apps is off by default.
- Phone and desktop control: One remote-access switch manages phone, desktop control, and browser access. Give each device view-only or view-and-control access, revoke it at any time, and see which screen-recording or input permission is missing. Phone control requires a Kun account with Plus or above; computer-to-computer control initially supports same-account Apple Silicon Macs on macOS 13 or later.
- PDF tabs and paper assistant: PDFs get separate Work tabs, each with an assistant conversation scoped to that paper. Switching tabs preserves your reading position and working folder, citations link back to their page, and selected text enters a draft for you to review before sending.
- Scheduled-task bulk management: Browse scheduled tasks in a searchable, filterable list with a detail panel. Enable, disable, or delete tasks in bulk, confirm before deletion, and avoid re-enabling expired one-time tasks.
- Control package and direct phone connections: Download the control component on demand and update it independently, with background verification, activation when idle, and rollback on failure. Phones can connect over the LAN, Tailscale, or your own tunnel using single-use pairing information that expires after five minutes. The separately authorized encrypted connection keeps sessions and attachments off the official relay. Phone terminals run on the computer, with a desktop stri
- v0.4.4Kun 0.4.42026-11-01 · 2026-11-01 09:33 UTC
查看更新说明
Kun 0.4.4
0.4.4 让资料、对话与产物更紧密地连在一起:Work 用标签页和分屏串起会话与文件,论文库整合为独立空间;Design 支持分区多画板,数据报告可以直接呈现在对话里并保存到产物库。同时带来工作台新版引导、统一应用连接入口、个人助理任务工作流与存储管理,并改善计划交接、并行任务恢复和 Windows 启动稳定性。
✨ 新功能
- Work 标签页与论文空间:会话与文件共用标签栏,支持并排对照和会话内预览,论文库统一为独立的检索、阅读与笔记空间。文档选区可直接交给 Kun 改写、扩写或引用,表格选区可查看统计并发起分析。
- 分区多画板设计:同一个 Design 画布可以按分区组织多个页面、状态与方案,继续对话即可追加或修改画板。Claude Code、Codex 及受支持的 ACP Agent 也能在 Code 对话中打开设计,确认方案后再进入代码实现。
- 数据报告与产物预览:对话中可直接展示包含指标、图表和说明的数据报告,并保存到产物库中重新打开和更新。产物卡片增加真实缩略图,查找已有成果更直观。
- 工作台与新版引导:更新圆角工作区、模式切换和可收起的右侧工具条,macOS 侧栏支持通透的玻璃效果。首次使用或从旧版本跨越 0.4.4 升级时提供可跳过的工作台介绍,并可从帮助入口重看各模式引导。
- 统一应用连接入口:在“设置 → 连接”集中查看和管理应用连接。GitHub 与 Gmail 可用;Notion、Figma 预设已列入目录,但尚未开放连接。
- 个人助理任务工作流(Lab):向已连接的个人助理派发任务,查看送达状态、进度与结果,支持历史恢复、追问和取消。功能默认关闭,需在“设置 → Lab”启用,并由服务端开放;助理回传不会替代你的敏感操作授权。
- 存储管理与清理:在设置中查看缓存、会话、工作树和附件等分类占用,预览清理范围并回收空间。自动清理旧内容需先授权规则,扩大清理范围或缩短保留期限时会重新请求同意。
- 其他:重新设计启动恢复窗口、编辑重发输入框和回合变更摘要;Work 侧栏与标签页、Code 文件标签页增加右键菜单;支持将未读会话标为已读。
🐛 修复与改进
- 计划交接与分派结果:修复计划交给其他 Agent 执行、卡片上切换 Agent 及导航后续接的问题。分派卡片支持展开 Markdown 结果,父会话接收工作 Agent 的实际结论,而不再只有任务标题。
- 任务恢复与并行执行:改善瞬时停顿、Manager 数据传输超时及委托会话续接失败后的恢复。保留可续接的会话,避免重启后重复执行已完成的工作。
- Work 历史与工作树提交:恢复较早 Work 会话的访问,并修复切换页面后工作树提交队列未继续处理的问题。
- 权限与隔离:将输入区权限选择正确保存在当前会话,并在待执行分派卡片切换 Agent 后重新应用隔离要求。
- Windows 启动与更新:加强启动恢复、进程归属检查与更新重启保护,减少旧实例和更新切换之间的冲突。
- 记忆提取:规范提取分数与诊断信息,候选比较关系异常时转入复核而不是直接丢弃,并保持群聊中的记忆工具可用。
- OAuth 与存储安全:改善 MCP 加密凭据与令牌刷新的生命周期,避免旧授权失败误清除新凭据。清理过程中设置发生变化时会重新检查授权边界。
- 界面、预览与 Linux 重启:避免无关操作误开浏览器或 Design 侧栏,设计预览校验保持在 Kun 内完成,并改善深色主题、窄面板和通知展示。AppImage 和 deb 版本在恢复或迁移后重新进入正确的启动入口,并保留启动参数。
Linux 安装提示
Ubuntu 24.04 及其他限制非特权用户命名空间的系统上,AppImage 可能需要管理员配置 AppArmor;建议优先使用 deb 包。Linux ARM64 暂不包含部分计算机控制后端。
更新后介绍
从 0.4.4 之前的版本升级,且尚未看过新版工作台介绍时,会先展示引导,而不是同时弹出更新说明。引导末屏可打开本说明;也可之后在“设置 → 更新”中重新查看。引导可以跳过,不影响继续使用。
English
Kun 0.4.4 brings sources, conversations, and artifacts closer together. Work connects sessions and files with tabs and split views, papers move into one independent library, Design gains sectioned multi-board canvases, and data reports render in conversations and remain available in the artifacts library. This release also adds a workbench tour, a unified app-connections entry, personal-assistant task workflows, and storage management, with improvements to plan handoffs, parallel-task recovery, and Windows startup.
Features
- Work tabs and paper space: Sessions and files share a tab strip, with side-by-side comparison and in-session previews. Papers have one independent space for discovery, reading, and notes. Send document selections to Kun for rewriting, expansion, or quoting, and inspect or analyze selected spreadsheet cells.
- Sectioned multi-board designs: Organize pages, states, and alternatives into sections on one Design canvas, then add or revise boards through the conversation. Claude Code, Codex, and supported ACP Agents can also open designs from Code conversations, with implementation following your approval.
- Data reports and artifact previews: Display reports combining metrics, charts, and explanations directly in conversations, then reopen and update them from the artifacts library. Artifact cards now show real thumbnails to make existing work easier to find.
- Workbench and guided tours: Updated the rounded workspace, mode switcher, and collapsible right tool rail, with a translucent glass sidebar on macOS. First-time users and upgrades crossing 0.4.4 receive a skippable workbench overview; mode tours can be replayed from Help.
- Unified app connections: View and manage app connections under Settings → Connections. GitHub and Gmail are available; Notion and Figma presets are listed but are not yet open for connection.
- Personal-assistant task workflows (Lab): Assign tasks to connected personal assistants and follow delivery, progress, and results, with history recovery, follow-ups, and cancellation. Off by default, requiring both Settings → Lab and server-side availability. Assistant
- v0.4.3Kun 0.4.32026-10-27 · 2026-10-27 03:48 UTC
查看更新说明
Kun 0.4.3
0.4.3 让计划执行与多 Agent 协作更顺手:在计划卡片中选择执行 Agent,为任务分派填写 Agent 与模型偏好,并在侧栏查看工作 Agent。账户与设置入口进一步整合,新增会员兑换与状态刷新,支持 MiniMax-M3.1-Flash,同时减少计划工作区的磁盘占用,改善工具调用、审批和历史会话的稳定性。
✨ 新功能
- 计划执行 Agent 选择:在计划卡片中选择负责执行的 Agent,让计划交给合适的引擎完成。
- 任务分派与协作:支持填写 Agent 与模型分派偏好,侧栏在父会话下展示工作 Agent,方便查看协作进展。改进中断子任务的续接;调整分派选择时暂停倒计时,切换的 Agent 会正确应用。
- 账户与会员入口:账户卡片与设置整合到侧栏底部的统一入口,支持会员兑换与会员状态刷新。回到应用时会重新获取会员权益信息。
- 更轻量的计划工作区:计划构建工作树通过写时复制复用已有依赖,减少重复安装与磁盘占用。增加已合并空闲工作树的自动清理,并在可用磁盘空间不足 5 GB 时阻止新建计划构建工作树。
- MiniMax-M3.1-Flash:MiniMax 官方 API 与 Token Plan 模型目录新增 MiniMax-M3.1-Flash。同步适配推理强度选项与用量计价。
🐛 修复与改进
- 工具调用稳定性:阻止反复执行相同失败工具调用的循环,避免任务持续重复无效操作。
- 大型会话历史:修复大型持久化事件的回放,改善重新打开历史会话时的数据恢复。
- 外部 Agent 分派:补齐 Codex 与 Pi 工作 Agent 的传输注册,并修正 Qoder ACP 权限协商与启动时的权限设置。
- 审批流程:提交工具审批选择时不再重复弹出确认对话框,并避免第三方 Agent 模型参与自动审批审查。
- 附件与实时引导:向 ACP Agent 传递文档附件中的文本,并在实时引导未被接受时保留引导内容。
- 计划执行边界:没有生成计划文件时,不再继续自动构建,避免普通问答触发计划执行。
- 协作与对话显示:默认保留协作历史的查看入口,侧栏工作 Agent 使用对应标志而非首字母。窄面板中的回复统计与操作支持换行。
English
Kun 0.4.3 makes plan execution and multi-agent collaboration easier: choose an Agent on the plan card, write Agent and model preferences for dispatch, and find workers under their parent conversation in the sidebar. Account and Settings now share one entry area, with membership redemption and refreshed entitlement status. This release also adds MiniMax-M3.1-Flash, reduces plan-worktree disk use, and improves tool calls, approvals, and conversation history.
Features
- Choose the plan execution Agent: Choose the Agent that executes a plan directly on its card.
- Task dispatch and collaboration: Write Agent and model preferences for dispatch and find workers under their parent conversation in the sidebar. Interrupted child tasks resume more reliably; adjusting a dispatch pauses its countdown, and Agent changes are applied correctly.
- Account and membership access: Account and Settings share a unified sidebar footer, with membership redemption and status refresh. Entitlements refresh when you return to the app.
- Lighter plan worktrees: Plan-build worktrees reuse existing dependencies through copy-on-write cloning to reduce repeated installs and disk use. Merged idle worktrees are cleaned up automatically, and new plan-build worktrees are blocked when less than 5 GB is available.
- MiniMax-M3.1-Flash: Added MiniMax-M3.1-Flash to the official MiniMax API and Token Plan catalogs, with matching reasoning-effort options and usage pricing.
Fixes and improvements
- Tool-call stability: Stop loops that repeatedly make the same failed tool call instead of progressing.
- Large conversation history: Fixed replay of large persisted events to improve recovery when reopening conversation history.
- External Agent dispatch: Registered Codex and Pi worker transports and corrected Qoder ACP permission negotiation and startup permissions.
- Approval flow: Submitting a tool approval choice no longer opens a second confirmation dialog, and third-party Agent models are excluded from automatic approval review.
- Attachments and live guidance: Pass document attachment text to ACP Agents and preserve guidance that is not accepted during a live turn.
- Plan execution boundaries: Automatic builds no longer proceed when no plan file was written, keeping ordinary answers from triggering plan execution.
- Collaboration and chat display: Keep collaboration history accessible by default and show worker Agent logos instead of initials in the sidebar. Response metrics and actions wrap in narrow panes.
Build information
- Release version:
0.4.3 - Release channel:
stable - Branch:
master - Commit:
194b95ec33de28f337e118e1630383d1bd492583 - macOS: Developer ID signed and notarized
- Platforms: macOS arm64/x64, Windows x64, Linux arm64/x64 AppImage/deb
- Terminal commands and Kun Runtime: bundled with the desktop
- v0.4.2Kun 0.4.22026-10-25 · 2026-10-25 20:44 UTC
查看更新说明
Kun 0.4.2
0.4.2 是 0.4.1 之后的增量更新。产物库、可编辑幻灯片和 Office 预览让成果更容易查看与继续修改;交互组件(Gen UI)与 MCP Apps 转为内置能力,Code 工作台、Design 和 Work 写作体验也有了新布局。Changes 面板新增提交与推送,回合撤销只还原 Kun 改过的文件;Agent 名册、协作面板、内置终端、文件树和 Kun TUI 同步升级,启动与空闲资源占用进一步降低。
上线状态:个人助手仅在“实验功能”中提供,默认关闭;App / 移动端相关能力仍在预览和内部验证阶段,尚未正式上线。本版本不将它们作为正式功能发布。
✨ 新功能与体验改进
- 产物库:侧栏新增“产物”入口,集中展示 Kun 在各个项目里做出的设计稿、文档、幻灯片、表格、白板和生成图片。支持网格与列表视图、按类型和项目筛选、搜索与排序;PDF 和白板可直接预览,详情页可查看版本,或回到原会话让 Kun 继续修改。回合结束和窗口重新聚焦时自动刷新。PPTX、DOCX、XLSX 产物打开后可直接在右侧与 Kun 对话修改:当前页、选中文字或单元格区域会作为上下文随消息发送;Kun 改动文件前自动保存版本快照,支持对比与撤销。
- 交互组件与 MCP Apps:交互组件(Gen UI)与 MCP Apps 从实验功能转为内置能力,默认开启。Agent 可以在回复中直接生成可交互的小页面——模拟器、参数探索、计算器或界面原型;页面运行在隔离沙箱中,不能联网、调用工具或访问文件。声明了交互页面的 MCP 工具会把页面显示在会话卡片或右侧 App 面板中,随版本内置的可编辑画布也走同一通道。
- 工作台与 Office 预览:Code 右侧面板改为按文件独立的标签页,侧栏收紧布局。PPTX 使用浏览器逐页渲染,缩略图与主视图保持同步;DOCX 按页显示、支持选中文字,XLSX 可在网格中浏览和选择单元格,文档与表格的缩放、滚动和工具栏也重新整理。打开产物后仍可带着当前页或选区让 Kun 修改。
- Work 写作审阅:选中文字后可从更简洁的菜单调用技能或让 Kun 改写;改写先展示审阅结果,由你确认后再应用到文档,不再直接覆盖选区。
- 设计画布:画布支持多页面与分区,并可放置便签:在便签里 @Kun 会把内容转为设计任务并跟踪进度。选中元素会出现浮动工具栏(字体、颜色、对齐、圆角),可直接在该元素上留言交给 Kun 处理;HTML 组件内还能圈选具体元素作为对话目标。Tweaks 标签页改为更直观的标签/控件行布局。
- 幻灯片生成:让 Kun 做 PPT 时由主 Agent 按内置幻灯片技能完成:先生成可编辑的 PPTD 再逐页渲染预览,离线导出 PPTX 并做几何校验,生成图片仅作为可选素材。对话卡片显示规划、方向、制作、预览、审阅、导出各步进度,白板可逐页审阅并查看图片槽位来源。
- 白板面板重做:Code 白板面板提供停靠、填满工作区和专注全屏三种视图,Esc 逐级退出;标题栏集中了引擎切换、PNG/SVG 导出、复制为图片和在文件夹中显示等操作;Excalidraw 画布改用共享的 Kun 工具条,窄面板下多余工具收进菜单。
- 输入框活动区:需要用户输入、审批或查看后台任务时,相关卡片集中显示在输入框旁的活动区,不再散落在独立浮层;等待处理的内容与进行中的工作可一起查看。
- 在 Changes 面板提交与推送:Changes 面板可切换查看本次会话、上一回合、未暂存、已暂存或整个分支的改动,支持逐个或批量暂存、取消暂存与丢弃(未跟踪文件移入废纸篓)。提交信息留空时由模型生成;“提交并推送”会在首次推送时自动设置上游分支,失败时显示可复制的 git 输出。
- 按文件撤销回合改动:撤销某一回合时,只还原 Kun 文件工具在该回合改过的文件,不再对整个工作区执行
git reset --hard,你自己的未提交修改会被保留。撤销前会检查冲突,任何文件不安全时都不写入;撤销后可一键重新应用。 - Agent 名册与角色:内置角色、自定义角色和仓库
.kun/agents/下的角色统一为一份名册:派活卡、任务建议卡、Graph 任务和delegate_task都可以按角色选人,绑定了引擎的角色会在对应引擎上运行。设置中可查看每个角色的运行位置与状态,Graph Lead 还能选用工作区里学习到的可信角色。 - 协作与建议任务:协作面板改为成员列表,按“需要你、进行中、已完成”分组,每个成员一个标签页,顶部进度条汇总完成/进行/等待/失败与用量。Kun 可以把后续工作提为建议任务卡,启动后在独立的嵌套会话(通常是隔离 worktree)中运行并回报结果。派活卡里每个 worker 可单独更换 Agent 和模型;卡片在设定时间内无操作会自动开始派发(默认 60 秒,可在设置 > 协作中调整或关闭)。成员改用形状座位头像,外部 harness 成员显示自家标志,头像上的状态环区分进行中、等待处理与已完成;协作标签页、顶栏与空态使用“汇流”标识。
- 内置终端:终端重做为可停靠面板:xterm 会话在切换标签和收起面板后保持存活,标签带运行状态点;支持分屏、最大化与右侧停靠;zsh / bash / fish 命令带标记和退出码,失败的命令可一键连同输出发送给 Kun;Kun 的后台 shell 以只读标签出现;支持查找、点击路径与预览链接、拖入文件、重启后恢复,以及主题、字体与行为设置。
- Code 中直接出设计:Design 不再是输入框里的单独模式。Code 对话中需要视觉稿时,Agent 可在同一回合打开 Design 画布并写入设计;画布工具栏与底部属性检查器也重新布局。
- 子代理展示:对话中的子代理卡片收紧为安静的一行——角色图标带状态标记,标题写明角色与模型,下方是一行摘要或实时动态,操作只在悬停或需要时出现;批量 swarm 会话有分段进度头和一键停止。右侧子代理面板分为“本会话”与“角色”两个标签,并附统计条。
- 文件树与预览重做:任何工作区文件都能打开,
.env.local、LICENSE、.patch等不再显示“不支持”;GBK、UTF-16 等编码自动识别并可手动切换。文件树新增 git 状态标记、全仓搜索、仅看改动和键盘导航;预览支持 CSV/TSV 表格、图片像素缩放、二进制十六进制视图,以及视频、音频和 HTML 渲染。 - GitHub 连接:可以在应用中连接 GitHub App 并选择授权的仓库,让 Kun 使用受限的只读工具查询仓库、提交、Issue 和 PR;连接与授权由用户在浏览器中完成,不会把本地 git 的写入能力交给 GitHub 工具。
- 引用回复与分支对话:在 Code 对话中选中一段文字,可直接“回复”或“开启分支对话”。引用会随消息一起发送,点击气泡中的引用即可跳回原文。分支会话的 Agent 与模型设置独立保存,不再跟随主会话,分支内的实时状态显示也相应简化。
- 提示词优化:输入框的提示词优化按钮默认显示,使用当前选择的模型改写;再次点击或按 Esc 可取消,改写后可撤销(Cmd/Ctrl+Z)。
- 更顺滑的流式回复:回复按实际到达速度平滑展开,末尾文字淡入,网络卡顿时不再一顿一顿;遵循“减少动态效果”设置。运行中的回合超过两分钟没有输出时会提示“N 分钟无输出”,重新打开的历史也会保留每轮的首字延迟和生成速度。
- 输入与编辑:中文输入法下输入
、或/即可打开命令菜单;编辑已发送的消息时也能 @ 文件和使用 / 技能;复制渲染后的公式会得到 LaTeX 源码。 - Kun TUI 全新界面:终端界面基于 opentui 重写,改为全屏布局,带会话标签页、可停靠侧栏(上下文、用量、审批、计划和子代理)、折叠的工作记录与主题自适应配色。GUI 已占用同一配置时,
kun tui会连接到正在运行的 Runtime,不再直接报冲突。 - 模型供应商:新增 Magpie 本地网关供应商预设;Cursor 订阅账号的可用模型按凭据动态列出,选择器同步显示各模型的推理档位。
- 其他:私聊按 Agent 回合分组展示,工具过程折叠为工作记录并以结果卡结尾;应用更新入口移到侧栏“设置”旁,点击后先显示版本和下载进度,再决定是否重启安装;账号卡菜单可显示会员状态与到期时间。
🐛 修复与改进
- 启动与空闲占用:启动时不再扫描全部会话日志、也不再重复拉起每个已启用的 Agent CLI;空闲时 Runtime 与 Manager 之间的请求和内存分配显著下降。附件清理推迟到启动 5 分钟后并改为每 6 小时一次,Agent 模型目录跨重启保留,重启后打开选择器无需重新探测。大型会话的历史读取改为线性时间,回合结束或中断时不再为检查转向而加载完整历史。
- 回合恢复与运行时稳定性:被中断的回合会在原来的 Agent 上恢复,不再回落到 Kun 循环;机器负载高导致 Agent 进程启动失败时会自动重试;启动时重新应用相同设置不再让首条消息报“供应商配置已变更”;未声明上下文窗口的模型按 1M 处理,不再每步强制压缩历史;撤销回合的 git 检查不再因管道关闭而崩溃;检测到上一次残留的孤
- v0.4.1Kun 0.4.12026-10-17 · 2026-10-17 18:15 UTC
查看更新说明
Kun 0.4.1
0.4.1 是 0.4.0 之后的增量更新,集中改善 Code 首页与 Focus 模式、Agent 与模型选择、审批交互,以及长会话和第三方 Agent 的稳定性。
上线状态:Gmail 连接与 App / 移动端相关能力仍在预览和内部验证阶段,尚未正式上线。本版本不将其作为正式功能发布,实际入口和可用范围以应用内提示为准。
✨ 新功能与体验改进
- Code 首页与 Focus 模式:Code 新任务首页加入点击涟漪与漂移字场;中文界面使用《庄子·逍遥游》中的汉字,其他语言使用拉丁字符。动画在空闲时停止,并遵循“减少动态效果”设置。Focus 模式改为带文字的开关,开启后隐藏账号卡、会话头像和 Kun 动画。设置 > 外观新增“首页点击涟漪”开关。
- 首条消息更顺滑:从 Code 首页发送第一条消息时,欢迎标题、输入框和消息气泡的切换更连贯,减少创建会话往返造成的布局跳动。
- Agent 与模型选择:模型选择器按 Agent 提供的分组展示模型,修复同名模型分组丢失的问题。第三方 Agent 版本页新增“让 Kun 更新”,只生成更新请求并填入默认对话,需用户确认后才执行。
- 上下文与用量:Cursor 上下文弹层展示 Cursor 自己的分类;Devin 与 Cursor 的用量按实际模型调用记录,展示方式与 Codex 一致。
- 审批交互:待处理审批以编号选项显示在输入框上方,支持数字键选择、展开查看完整内容、拒绝时附加说明,并可直接停止当前回合。
- 账号头像:侧栏账号卡会记住本机使用的头像,重启后不再回到默认 Kun;退出登录或切换账号后清除本机记录。
🐛 修复与改进
- 长会话与任务恢复:大历史不再写入线程元数据,归档、恢复、删除和结算不再因历史过大而受阻;修复私聊回复在收尾后再次校验失败的问题。
- Worker 与协作:未启动的 worker 会明确报告失败或取消,并保留在面板中;运行中的 worker 在执行工具或等待审批时仍显示“查看过程”;重启后 Worker 面板可从团队记录恢复;超出步数或时间预算时显示真实原因和用量。
- 模型路由与网关:本地网关开关热应用时同步路由与网关全局配置,不再停在“等待同步”;多供应商和路由池在流式请求、重试与切换时校验路由代次,失败信息区分请求是否已发出;运行时覆盖凭据随供应商切换重新迁移。
- 运行时与协议兼容:修复代理返回 204 或无 body 时 kun serve 崩溃的问题;Anthropic 格式网关可通过
/mcp/kun接受包含browser_use等工具的 schema;打包版补齐 kun-remote 协议依赖。 - 第三方 Agent 连接:DeepSeek Harness 改为最低版本校验,较新的版本不会再被误判为过旧;ACP Agent 输出非 JSON 诊断日志时不再断开连接,模型目录探测更稳定。
- 论文阅读:从侧栏打开论文时先只打开 PDF,由阅读布局决定是否加入 Notes,避免默认出现两个编辑器分组。
预览与未上线功能
Gmail 连接、App / 移动端配对以及依赖它们的远程访问能力仍在预览和内部验证阶段,尚未正式上线。本版本不将这些能力列为正式发布功能;相关入口、权限和可用范围可能随版本调整。
更新方式与兼容说明
通过应用内更新入口下载并重启安装。Kun Runtime 和终端命令随桌面应用一同更新。
本版本为 0.4.x 增量更新,未引入新的手动迁移步骤。预览能力可能随版本调整,请勿将其视为稳定接口或正式上线承诺。
English
Kun 0.4.1 is an incremental update following 0.4.0, focused on the Code home and Focus mode, Agent and model selection, approvals, and the reliability of long conversations and third-party Agents.
Availability: Gmail connections and App / mobile capabilities remain in preview and internal validation. They are not generally available in this release; this note does not announce them as shipped features.
Features and improvements
- Code home and Focus mode: The Code new-task home gains a click ripple and drifting glyph field. Chinese UIs use characters from the opening of Zhuangzi's Free and Easy Wandering; other languages use Latin characters. Animation stops while idle and respects reduced motion. Focus mode is now a labeled switch that hides the account card, conversation avatars, and Kun animations. Settings > Appearance adds a Home click ripples toggle.
- Smoother first message: Sending the first message from the Code home now transitions the welcome title, composer, and message bubble more smoothly, with less layout jumping while a conversation is created.
- Agent and model selection: Model pickers show models under the groups supplied by each Agent, fixing lost groups for models with duplicate names. A third-party Agent's Version tab gains Ask Kun to update it, which only drafts an update request into the default chat and waits for confirmation.
- Context and usage: The Cursor context popover shows Cursor's own categories, and Devin and Cursor usage follows actual model calls with the same presentation as Codex.
- Approvals: Pending approvals appear as numbered choices above the composer, with number-key selection, expandable details, an optional note when declining, and a direct way to stop the current turn.
- Account avatar: The sidebar account card remembers the locally used avatar across launches instead of falling back to the default Kun; signing out or switching accounts clears the local record.
Fixes and improvements
- Long conversations and task recovery: Large histories are no longer written into thread metadata, so archiving, recovery, deletion, and settlement are not blocked by history size. Private replies no longer fail a post-final re-check.
- Workers and collaboration: Workers that never start now report failure or cancellation and stay visible in the panel. Running workers keep the
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Kun 能做什么
Kun 是跑在你电脑上的桌面应用。Code、Work 和对话共用一个本地运行时:写代码、做设计、处理文档和论文,也能把任务交给不同的 Agent 协作完成。会话、记忆和设置留在本机,模型由你自己接入。
- Code / Design:项目、终端、Git 与 Diff 放在一处。先在 Design 画布中比较多屏、状态与方案,确认后再交给 Agent 实现;Claude Code、Codex 等外部 Agent 也能打开设计。
- Work / 论文:会话与文件用标签页组织,需要时分屏对照;选中文字即可改写、扩写或引用到会话,选中表格单元格可查看统计并交给 Kun 分析。独立论文库集中管理导入、阅读、笔记与相关会话。
- 对话 / Agent 协作:与个人 Agent、Codex、Claude Code、OpenCode 私聊或拉群,为计划选择执行 Agent,分派任务并查看各自的进展和结果。个人助理任务工作流可在“设置 → Lab”启用,需服务端开放并完成助理接入。
- 报告 / 产物:让 Kun 把实际数据整理成指标、图表和说明组成的报告,直接在对话里查看,并保存到产物库继续打开或更新;缩略图帮助你更快找到需要的产物。
- 连接 / 扩展:统一管理可用的 GitHub、Gmail 连接,通过 MCP / Skills、Loops 和 Extension 平台扩展工作流。本地模型网关复用同一份 Provider 配置。
还有:提醒与定时任务、存储管理、终端 TUI、手机远程、Kun 账号与衣橱。最新变化见 0.4.4 更新日志。
三步开始
- 下载安装。 从 Releases 选择对应平台的安装包。
- 连接一个模型。 首次启动的引导里填 API Key,或登录已有订阅。支持 OpenAI / Anthropic 兼容接口与本地模型,见 Provider 文档。
- 给一件具体的事。 打开一个项目文件夹交给 Code,或把资料拖进 Work。Agent 动手前会先请你确认。
| 平台 | 安装包 | 架构 |
|---|---|---|
| macOS | .dmg / .zip | Apple Silicon / Intel |
| Windows | .exe | x64 |
| Linux | .AppImage / .deb | x64 |
Linux 的 .deb 请用 sudo apt install ./Kun-*.deb 安装,apt 会一并装上 libnotify4 等依赖;dpkg -i 不处理依赖,在精简系统上会装不上。
看一眼
本地优先,权限在你
- 数据在本机。 会话、记忆、日志存在本地;用云端模型时,只有本次请求的上下文发给你选的 Provider。
- 动手先确认。 工具、目录和工作台权限默认需要批准;记忆和群聊不会扩大权限。
- 模型随你换。 DeepSeek、Kimi、GLM、Qwen、Ollama 等预设,也可自定义 Provider。
- GUI 与 TUI 共用。 同一个
kun serve运行时,线程、计划和审批两边都能接着用。
从源码运行
需要 Node.js 22.19+。
git clone --branch develop https://github.com/KunAgent/Kun.git
cd Kun && npm ci && npm run dev
| 命令 | 用途 |
|---|---|
npm run dev | 构建运行时并启动 Electron 开发环境 |
npm run dev:tui | 构建运行时并启动终端 TUI |
npm run typecheck | TypeScript 类型检查 |
npm run lint | ESLint 与文件大小检查 |
npm run test | 运行测试 |
npm run build | 生产构建 |
npm run dist:mac / dist:win / dist:linux | 构建对应平台安装包 |
中国大陆网络较慢时可加 --registry=https://registry.npmmirror.com。
保持桌面应用运行,在项目目录连接它的运行时,与 GUI 共用线程和审批:
kun --no-start
单独使用时先退出桌面应用,再运行 kun;TUI 会启动自己的运行时,退出时一并停止。更多见 Kun TUI 文档。
文档
| 上手 | 模型 Provider · 个人 Agent 与记忆 · 终端 TUI |
| 工作台 | Code 中的 Agent 对话 · Design 画布 · 论文与证据 |
| 扩展 | MCP 与 Skills · Loops · Extension 平台 · 本地网关 |
| 开发 | 本地开发 · 运行时架构 · 贡献指南 |
参与贡献
欢迎提交 bug 修复、UI、运行时、Provider 和文档改进。PR 请以 develop 为目标分支,开始前读一下 贡献指南;外部贡献需要签署 CLA。
许可证
PolyForm Noncommercial 1.0.0,仅限学习、研究和非商业用途。商业使用、托管服务或集成进商业产品,需要作者单独书面授权。
记忆架构参考了 Nowledge Mem 公开文档中的 Thread / Memory 分离与来源追踪理念,实现保持独立。