Hapa yameorodheshwa matoleo 21 ya K-brain, kuanzia 4 Novemba 2026 hadi toleo la sasa 0.107.34. Kila moja lina kiungo cha faili za kisakinishi za mchapishaji mwenyewe.
| Toleo | Tarehe | Ukubwa | Faili |
|---|---|---|---|
| 0.107.34Toleo jipya zaidi | 15 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.34
本版从 main 的 66a0e3f 构建,在 v0.107.33 的基础上新增跨会话用量统计接口。
用量统计接口(#209)
- 新增 GET /v1/usage/stats?days=N&tz=IANA,/v1/health 增加 capabilities.usage_stats。
- 汇总所有工作区会话最近 N 天(默认 371 天)的 token 用量,按指定时区分日。返回:
- 总量与费用估算(只计能计价的模型,订阅计费的 provider 不计价);
- 按天明细(含各模型)、按模型明细;
- 活跃天数、当前与最长连续活跃天数、最常用模型、最长会话。
- 统计口径与 kn 的 /usage 卡片一致:输入已包含缓存读写,总量 = 输入 + 输出。
- 子代理用量只计一次;分支和历史复制的消息按 id 去重;旧会话没有逐条用量时按会话合计计入最后活动那天。
- 按会话文件缓存解析结果,重复调用开销小;统计不占用会话锁,不影响正在运行的回合。
- kn /usage 卡片的计价逻辑与该接口共用。
修复
- Windows:会话保存改名时,如果文件正被其他程序(杀毒软件、索引服务、用量统计)短暂打开,会重试约 4 秒,不再直接报 “Access is denied”。
已知限制
- 没有落成消息的模型调用(压缩、审阅、失败请求)不在逐条统计里,统计值可能略低于会话合计。
- 运行中的子代理在结束、转录保存后才计入。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更:https://github.com/Stack-Cairn/K-brain/compare/v0.107.33...v0.107.34 |
| 0.107.33 | 14 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.33
本版从 main 的 2fe4405 构建,在 v0.107.32 的基础上新增第三方联网搜索回退,并修复子任务取消收尾。
联网搜索回退(#206)
OpenAI Chat Completions 兼容接口(DeepSeek、各类中转等)没有原生联网搜索,过去开启联网会直接报错。现在可以配置一个第三方搜索服务,由新的 web_search 工具代为搜索:
- 支持的服务:Tavily、Brave Search、SearXNG(自建,无需 key)、博查、Jina。
- 何时启用:开启联网、当前接口不支持原生搜索、且已配置搜索服务时,自动提供 web_search 工具。原生搜索可用时行为不变。
- 配置:在 config.json 中添加 webSearch: {provider, apiKey, baseUrl, maxResults}。
- apiKey 支持 $VAR、${VAR} 和 !command 写法。
- 也可以用环境变量设置:K_BRAIN_WEB_SEARCH_PROVIDER、K_BRAIN_WEB_SEARCH_API_KEY、K_BRAIN_WEB_SEARCH_BASE_URL,或各服务自己的变量,例如 TAVILY_API_KEY、BRAVE_SEARCH_API_KEY。
- 结果与错误:结果按编号列出标题、链接、摘要和日期。key 无效、额度不足、限流、超时都会给出明确提示;错误信息里不会出现密钥。
- 审批:和 web_fetch 一样,按会话的权限模式决定是否需要审批。
- LiveAgent 对接:
- /v1/health 增加 capabilities.web_search_fallback。
- /v1/settings 返回各提供方的 nativeWebSearchSupported 和 webSearch 状态(永不返回密钥),并支持写入搜索设置。
修复(#204)
- 取消运行时,先等已取消的子任务完成记录,再发布运行终态,客户端不会再漏掉子任务结果。
- 旧的子代理通知恢复正确来源,分支会话中也会保留,不再被当成用户发言。
兼容性
旧版本不认识 config.json 里的 webSearch 字段,会拒绝加载这个配置。降级前请先删掉该字段。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更:https://github.com/Stack-Cairn/K-brain/compare/v0.107.32...v0.107.33 |
| 0.107.32 | 12 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.32
本版从 main 的 72552d7 构建,在 v0.107.31 的基础上为 kn 终端界面新增 /skills 命令。
kn 界面(#202)
- 新增 /skills [筛选词](别名 /skill):直接打开技能列表,不用再到 /extensions 里切标签页。
- 先列顶层技能,再按技能包分组;只能按名字调用的技能标 manual,有问题的标 warning;
- 可以直接输入筛选,/skills review 打开时就带着筛选词,匹配名字、说明和路径;
- 预览显示说明、所属技能包和 SKILL.md 路径,路径相对 ~ 或当前目录显示。
- 按 Enter 插入技能:把 $名字 插到输入框光标处,已有草稿保留,接着写要求就能调用。/extensions skills 页同样支持。
- /skills 可以在 / 补全菜单和 Ctrl+P 命令面板中找到,回合进行中也能使用。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更:https://github.com/Stack-Cairn/K-brain/compare/v0.107.31...v0.107.32 |
| 0.107.31 | 11 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.31
本版从 main 的 b78a95f 构建,在 v0.107.30 的基础上改进 kn 终端界面的目标、plan 和子代理显示,并让 kn 里运行的子代理同步到 LiveAgent。
kn 界面(#198)
- 可折叠的顶部面板:目标、plan 和子代理集中显示在对话上方。
- 折叠时一行摘要,例如 ▸ Goal Executing · <目标> · round 1/100 ── ☰ Plan 0/4 ── ◆ 2 running · 1 error;
- 展开后目标、当前 plan 步骤各一行,每个子代理一行,显示状态、正在做什么、工具次数和用时;
- 按 Alt+T 或点击标题切换,点击子代理行直接打开它的详情;有任务在跑时自动展开,手动折叠后不再强制打开;
- 高度最多占屏幕 30%(不超过 12 行),子代理多时在面板内滚动;终端太小时自动隐藏。
- 原来输入框下方的子代理栏、状态栏里的目标和子代理计数、对话里重复的 plan 列表都已移除。
- plan 不再长时间占着屏幕:全部完成后收成一行 ☰ Plan 3/3 ✓;回合取消或 plan 被拒绝后不再停留;/new 之后旧 plan 不会再出现。展开面板或 /plan 仍可查看。
- 子代理显示:
- 子代理详情视图:实时显示正文、思考和工具调用,以及状态、模型、工具次数和用时;可以直接输入插话,Esc 返回,期间主回合的更新不会丢;
- 对话里的子代理结果默认折叠成一行,ctrl+e 展开;400 Bad Request: {json} 这类错误归纳成一行;
- 已结束的子代理在切换会话前一直可以在面板里打开查看;
- 详情视图里的工具结果第一行标明所属工具(⎿ Grep · …),工具调用行滚出屏幕后也能看出是哪个工具的输出(#200)。
- 目标续跑时不再把整段续跑提示词显示在对话里,改为一行 ◎ goal check · round N/max · <目标>。
- 界面消息链路:后台任务变化、插话回显、唤醒等通知改为经由界面信箱合并投递。1000 次连续变化从占住 1000 个 goroutine 降到 1 个;前台子代理快照不再泄漏订阅。
子代理同步到 LiveAgent(#196)
- 修复新开的 kn 会话中后台子代理记录全部丢失的问题(记录回调在会话存储打开前就已挂接)。
- kn 的前台和后台子代理都会写入会话:开始时立即保存,运行中每秒最多保存一次(状态、工具次数、用量、记录),结束时保存最终结果。
- backend 通过每个进程的子代理租约判断子代理是否还在别的进程中运行,这类子代理显示为 running 并带 external: true,停止请求返回 409;不再被误判为已取消或中断。
问题修复
- host bridge(#194):桌面端重启后,AI 第一次调用终端或隧道工具时,不再报 "connection reset",而是正确报告桌面端未连接。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更:https://github.com/Stack-Cairn/K-brain/compare/v0.107.30...v0.107.31 |
| 0.107.30 | 10 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.30
本版从 main 的 8fc87aa 构建,在 v0.107.29 的基础上,让 kn 终端里运行的会话能及时同步到 LiveAgent,并防止两个进程同时写同一个会话导致丢消息。
会话同步(#192)
- kn 中运行的会话在回合进行中就能看到:以前 kn 只在回合结束时保存记录,backend 要靠每 30 秒一次的全量扫描才发现,LiveAgent 往往在回合结束十几秒后才显示这个会话。现在 kn 在回合开始时和每轮模型请求之间都会保存进度(至少间隔 2 秒),backend 每 500ms 检查一次变化标记,几秒内就能在列表里看到会话和工具调用。
- 同一会话同时只能在一个地方运行:kn、kn run、backend 的运行和 /compact 开始前都要先取得会话的运行锁(sessions/.runs/<id>.lock 上的系统文件锁,进程退出或崩溃时自动释放)。会话正在 kn 里运行时,backend 返回 409 session is running in kn;反过来,kn 会提示会话正在 LiveAgent 中运行,并保留输入框里的内容。
- 不再覆盖别处写入的消息:以前 backend 缓存的会话可能按旧记录保存,把 kn 刚追加的消息覆盖掉。现在记录被其他进程改过时,backend 和 kn 都会先从磁盘重新加载,基于旧记录的保存会被拒绝。
- 会话摘要新增 external_run:说明会话正由哪个进程运行(client、pid、started_at),能力标记为 session_external_runs。
已知限制
- 一轮模型请求内部的流式文字不会实时同步,要等下一轮开始或回合结束。
- kn run 仍只在结束时保存一次;会话标题在回合结束后生成。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更:https://github.com/Stack-Cairn/K-brain/compare/v0.107.29...v0.107.30 |
| 0.107.29 | 9 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoWhat's Changed
- fix(backend): 置顶/归档在回合运行中不再被拒 by @coder-hhx in https://github.com/Stack-Cairn/K-brain/pull/190
New Contributors
- @coder-hhx made their first contribution in https://github.com/Stack-Cairn/K-brain/pull/190
Full Changelog: https://github.com/Stack-Cairn/K-brain/compare/v0.107.28...v0.107.29 |
| 0.107.28 | 8 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.28
本版从 main 的 a30254e 构建,在 v0.107.27 的基础上修复 kn 界面卡死与 backend 阻塞,并新增 host bridge、SSHManager、嵌套 skill pack、Ctrl+B 后台运行命令等能力。
卡死修复(#189)
- 修复 kn 界面永久卡死:AI 运行中发出的插入消息(steer)在工具调用结束后写入会话时,会在持有消息锁的情况下通知界面;如果此时界面正在重绘底栏的上下文占用,两边互相等待,界面和键盘都不再响应。现在先写入消息、释放锁后再通知界面,界面绘制也不再等待 agent 的锁。
- 界面消息改为经由信箱投递:工具输出、权限确认、提问等不会再因为界面忙碌而卡住 agent;新增的锁检查工具在 CI 中把关这一规则。
- backend 不再被单个请求拖住:
- /v1/sessions/exists 与开始运行、切换模型同时发生时的锁顺序问题已修复;
- 大响应改为释放锁之后再发送,客户端读得慢不会阻塞同一会话的其他请求;
- 远程 MCP 服务器无响应时,关闭旧连接不再占着锁;
- 沙箱自检只做一次,/v1/health 最多等 2 秒。
- kn TUI 其他卡住场景:
- 在 nano、emacs -nw 里编辑时能正常退出,终端无法恢复时会给出提示并退出;
- 交互式命令不响应 Ctrl+C 时,再按一次 Ctrl+C 结束它;
- 提交时的工作区快照跳过 git 签名,最多等 1 秒;
- 终端主题未知时直接按深色背景处理,不再向终端发出可能永远得不到回应的查询;
- 修复单独按 Esc 后再按 [ 被吞掉,以及坐标为 0 的鼠标报告越界。
- 卡死诊断:
- kn debug stacks <pid> 或 kill -USR1 <pid> 导出卡住的 kn 或 backend 的栈;
- kn debug stacks --backend 或 GET /v1/debug/stacks(需要 token,仅限本机连接);
- 文件写到 ~/.liveagent/stacks-<时间>-<pid>.txt,保留最新 20 个;
- backend 和 TUI 各有看门狗,停顿超过 20 秒会自动导出一次(每个进程最多 3 次,在外部编辑器里的时间不计入)。
- 排查方法见 docs/user-guide/12-troubleshooting.md。
- 测试不再写入真实数据目录:测试只在临时目录里创建数据目录,CI 在三个平台上检查。
新功能
- host bridge(#179):桌面端可以通过 PUT /v1/host-bridge 注册本机回环地址上的服务,把终端读取(ReadTerminal)、隧道管理(TunnelManager)等工具提供给 agent;同名工具由桌面端实现替换。注册只保存在内存中,能力标记为 host_bridge。
- SSHManager(#181):GET/PUT /v1/settings/ssh 管理 SSH 主机、凭据和项目关联,凭据只写不读;agent 可以通过 SSHManager 在已配置的主机上执行命令、传输文件。首次连接会弹出主机指纹确认,缺少凭据时通过表单征询。能力标记为 ssh_manager。
- 嵌套 skill pack(#183):skills 目录下的子目录(例如 reverse-skill/skills/...)会被识别为一个 pack,最多 4 层、200 个 skill。同名 skill 以层级最浅的为准,被覆盖的副本列在 shadowed 中。/v1/skills/settings 新增 packs 整包开关,每个 pack 的提示词预算为 12 KiB。能力标记为 skill_packs。
- Ctrl+B 把运行中的命令移到后台(#185):kn 中 shell 命令运行时按 Ctrl+B,命令转为后台进程,AI 继续下一步;可以用 ProcessWait/ProcessStop 查看或结束它。backend 提供 POST /v1/sessions/{id}/runs/{run_id}/tools/{tool_call_id}/background,能力标记为 background_tool。
- 会话列表的归档过滤(#187):会话列表可以按是否归档筛选,已归档的会话不会再从列表里消失。
- 记忆整理计划可以热更新(#187):/v1/settings 的 memoryOrganizer 设置开关和频率,保存后立即生效,能力标记为 memory_organizer_settings。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.27 | 7 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.27
本版从 main 的 c8202c0 构建,在 v0.107.26 的基础上改进 kn TUI 输入框的鼠标操作和排队消息,并修复滚轮乱码。
kn TUI
- 输入框支持鼠标编辑(#176):
- 单击把光标移到点击位置,中文等宽字符和自动换行的行都能对准;
- 拖选文字(松开时照旧复制),双击选中一个词,三击或 Alt+A 选中全部(Ctrl+A 仍是跳到行首);
- 有选中内容时:Backspace/Delete 删除,直接输入或粘贴替换,Ctrl+X 剪切(Ctrl+Y 粘回),Ctrl+C 复制,←/→ 收起到开头或结尾,Esc 取消选中,都可以撤销。
- 待发出的消息可以点选编辑和取消(#176):AI 运行中,单击排队的消息选中它,再点一次拿回输入框编辑,点选中行上的 ✗ 删除;Alt+E 直接编辑最后一条(输入框里有草稿时先暂存)。原来的键盘操作(↑ 选中、Ctrl+E 编辑、Del 删除、Alt+↑↓ 调整顺序)保持不变,提示行会列出可用的按键。
- 修复滚动滚轮时输入框出现乱码(#176):滚轮滚得快时,终端发来的鼠标报告会被截成两段,残片被当成按键打进输入框,其中的 Esc 还会打断正在运行的这一轮。现在会把截断的报告拼回去,按正常的滚动处理;单独按 Esc、手动输入相似的文字都不受影响。
- 修复从外部编辑器回来后滚轮变成翻历史(#176):Ctrl+G、/brain、/system 打开外部编辑器后,鼠标模式会被关掉,滚轮变成方向键在提示词历史里来回翻。现在回来后会重新打开。
- 修复会话第一轮时 Esc 不能打断(#176):第一轮运行中如果有排队消息,第一条会被误显示为选中,Esc 只取消选中而不打断。
- 表单征询卡片、权限确认、提问等对话框打开时,鼠标不会移动输入框光标或选中排队消息;遮挡的字段不会被复制到剪贴板。
已知限制:没有启用键盘增强协议的终端里,单独按 Esc 最多会延迟 30 毫秒;macOS 上 Alt+A、Alt+E 需要把 Option 设为 Meta 键(三击在所有终端都可用)。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.25 | 7 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.25
本版从 main 的 52a7370 构建,在 v0.107.24 的基础上扩大沙箱对 git 文件的保护范围。
沙箱
- 保护会改变 git 读取位置的文件(#173,#171 的一部分):以前沙箱里的命令可以写 .git/commondir,让之后在沙箱外运行的 git commit 去读取别处的 config 和 hooks。现在以下文件也加入了保护路径:
- .git/commondir、.git/info/attributes(后者能让全局 ~/.gitconfig 里定义的 filter、diff 驱动在 git add 等操作时运行);
- 子模块的 .git/modules/*/config、hooks/、commondir、info/attributes,以及子模块目录里的 .git 文件;
- 链接工作树的 .git/worktrees/*/commondir、config.worktree;
- 子模块配置里相对的 core.hooksPath 现在按子模块自己的目录解析。
- 各机制的覆盖范围:
- 已存在的条目在所有机制下都只读;
- 还不存在的条目在 macOS(seatbelt)和 Linux Landlock 模式下不能创建;
- 在 bubblewrap 和 Windows 两种模式下仍能创建,包括普通仓库里本来没有的 .git/commondir。这部分在 #172 跟进。
- 已知限制:
- 子模块和链接工作树按运行开始时的状态列出,运行中新加的不在保护范围内;
- 工作区里的 .gitattributes 和全局 core.attributesFile 同样能启用全局驱动,但属于项目的普通文件,不做保护;
- 在沙箱里对运行开始前就有的工作树执行 git worktree remove/prune,以及 git submodule deinit,会失败;
- Landlock 模式下,.git/info 不存在时也不能创建它。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.24 | 6 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.24
本版从 main 的 66408b3 构建,在 v0.107.23 的基础上让 Linux 的 Landlock 沙箱也能保护工作区里的受保护路径。
沙箱
- Landlock 模式下受保护路径不能再被改写(#170,关闭 #166):Linux 上没有可用的 bubblewrap 时(没安装,或 Ubuntu 24.04 默认限制了非特权用户命名空间),K-brain 会改用 Landlock + seccomp。以前这种方式不能让工作区里的 .git/hooks、.git/config、core.hooksPath 指向的目录、.k-brain/、.liveagent/ 保持只读,run_sandbox.path_protection 报告为 false。现在:
- 通往受保护路径的目录(工作区根目录、.git)里的文件操作由一个监督进程代为执行,指向受保护路径的写入、删除、改名、硬链接、截断、chmod/chown、符号链接替换等都会被拒绝;其他文件仍由 Landlock 直接放行,速度不受影响;
- 还不存在的受保护路径(例如 .liveagent/)不能被创建;
- 第一次检测时会在临时目录里做一次真实的自检,通过后才报告 path_protection: true;
- 需要 Linux 6.2 以上(Landlock ABI 3+),且 Yama ptrace_scope 不高于 1。条件不满足时沿用以前的方式,继续报告 false 并在 reason 里说明原因。
- Ubuntu 上给出启用 bubblewrap 的提示(#170):系统用 AppArmor 限制了非特权用户命名空间时,reason 会说明如何为 bwrap 添加 AppArmor 配置或用 sysctl 放开限制。
- 已知限制(仅 Landlock 模式):
- 不能在工作区根目录运行 git init(.git 属于还不存在的受保护路径);
- 不能在工作区根目录、.git 以及本次运行中新建的顶层目录里创建 unix socket;
- 文件时间戳不受保护;
- 任何位置都不能设置扩展属性;
- 用 setsid 脱离、在命令结束后仍在运行的进程,监督进程退出后相关文件操作会失败。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.23 | 6 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.23
本版从 main 的 f6ce490 构建,在 v0.107.22 的基础上让多选提问的回答以结构化的方式提交和保存。
新功能
- 多选提问的回答按选项提交(#168):
- 回答 question 工具的多选问题时,客户端可以在 selected_labels 里直接列出选中的选项,不再需要把选项拼成一段文字。K-brain 会逐个核对:必须与问题的选项完全一致、不能重复;单选问题最多一个。不合规的回答返回 400,问题保持待回答,可以重新提交。
- 选中的选项加上用户在“其他”里输入的文字可以一起提交(selected_labels 加 custom: true,文字放在 selected_label)。
- 模型看到的是“选了哪些选项”,而不是把它们当成用户输入的文字;用户自己输入的部分仍会标明。question 工具里用户自己输入的回答,现在也会这样标明。
- 会话历史里,每次 question、AskUserQuestion 调用都带上 question_answers(和 question.resolved 的回答相同,重启后也在),客户端不必再从结果文本里拆分选项。
- /v1/health 新增 capabilities.question_selected_labels: 1。旧版后端会拒绝 selected_labels,客户端应先检查这个标志。
- 不使用 selected_labels 的旧客户端不受影响。
- kn 终端界面:多选问题的回答改为按选项提交,界面不变。
修复
- 修复沙箱 CI:新的 Linux runner 上 /bin/bwrap 和 /usr/bin/bwrap 是同一个文件,隐藏 bubblewrap 的步骤会失败;没装 bubblewrap 的机器上这一步也会中断(#169)。只影响 CI。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.22 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.22
本版从 main 的 7db2a37 构建,在 v0.107.21 的基础上加入 Windows 离线沙箱(提升模式),并修复后台任务关闭时的竞争。
新功能
- Windows 离线沙箱与工作区隔离(#165):运行一次 kn sandbox setup(会弹出 Windows 管理员确认),之后 Windows 上的沙箱改为以专用的沙箱账户运行命令:
- 断网运行可用:离线账户的所有网络流量(包括本机回环)都被防火墙规则拦截,/v1/health 的 run_sandbox 报告 mechanism: "sandbox-user"、network_control: true;
- 工作区隔离:权限只授予沙箱账户,不再把用过的工作区标为低完整性。其他低完整性程序不能再写这些目录,断网运行也写不了别的工作区;
- 命令在独立的桌面上运行,不能访问你的桌面和进程;
- 保护路径、凭据目录屏蔽、凭据环境变量过滤照常生效;
- setup 会创建两个隐藏的本地账户(不能远程登录、不在登录界面显示)、两个本地组和一组防火墙规则,密码用 DPAPI 加密保存。kn sandbox status 查看状态,kn sandbox uninstall 全部移除;
- 没有运行 setup 时,沿用 v0.107.21 的低完整性沙箱(仅联网),断网运行会拒绝执行并提示运行 kn sandbox setup;
- 客户端可以调用 POST /v1/sandbox/setup 发起设置(需要后端 token,会弹出 UAC),run_sandbox 新增 setup_available、setup_hint,capabilities.sandbox_setup 为 1。
- 已知限制:
- 联网运行仍可写之前沙箱运行用过的任何工作区(Windows 自带的 TLS 不支持受限令牌);
- 沙箱里的命令不能在会话中创建命名对象,Windows PowerShell 5.1 的 Invoke-WebRequest 会报 “Error creating the Web Proxy”,改用 curl.exe、PowerShell 7 即可;
- 离线时仍能解析域名(DNS 由系统服务代为查询),但不能建立连接;
- C:\ProgramData、C:\Users\Public 这类所有用户都可写的目录,沙箱账户也可写。
修复
- 关闭后端时等待后台工作结束(#167):后端关闭时会先取消并等待后台子代理、唤醒派发和检查点写入完成,再关闭事件日志,不再在关闭后继续写文件。因关闭而中断的子代理在下次启动时显示为“已中断”。
- 后台 Bash 命令的退出只报告一次(#167):以前同一次退出可能既出现在 Bash 的结果里,又作为单独的退出通知再发一次。
- 修复了多个偶发失败的测试(#167,关闭 #132)。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.21 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.21
本版从 main 的 9efe547 构建,在 v0.107.20 的基础上加入 Windows 原生沙箱、更多沙箱加固,并对 kn 终端界面做了一轮完整改版。
沙箱
- Windows 原生按次沙箱(#145):Windows 上不必再装 WSL2,就能用“沙箱”命令安全模式(联网运行)。
- 写入只限于工作区和沙箱专用的临时目录;工作区外的文件不能写、删或改名;
- 工作区里的 .git/hooks、.git/config、.k-brain/、.liveagent/ 只读;
- ~/.ssh、~/.aws、~/.gnupg、~/.config/gh 和 K-brain 自己的数据目录(API key、会话、记忆)在沙箱里读不到也列不出;
- K-brain 本身和你自己运行的程序不受影响;
- 断网运行在 Windows 原生上仍会拒绝执行,下一版通过一次性的管理员设置提供。
- Linux 没有可用的 bubblewrap 时改用 Landlock + seccomp(#146):不再直接报告“不支持”。这种方式能限制写入和网络,但不能隐藏凭据目录,/v1/health 的 run_sandbox 会如实报告(新增 path_protection 字段)。
- 保护路径加固(#149):
- .git/hooks、.git/config 以及 core.hooksPath 指向的目录不能被改写,也不能通过改名、硬链接绕过;
- bubblewrap 下连不上 docker、podman、D-Bus 等运行时套接字;
- WSL 下不能通过互操作启动 Windows 程序。
- 不继承凭据类环境变量(#157):沙箱里的命令拿不到名字里带 KEY、SECRET、TOKEN、PASSWORD、CREDENTIAL 的变量,以及 LD_PRELOAD 一类的注入变量。需要保留的变量用配置 sandbox.envKeep 放行。未开沙箱时不变。
- 被沙箱拦下时给出提示(#153):命令因沙箱失败时,结果末尾多一行 [sandbox] …,说明拦截原因(写到工作区外、受保护路径、被隐藏的目录、断网),能确定时还会建议把哪个目录加为可写。/v1 的 tool.result 新增可选的 sandbox_denial。
kn 终端界面
- 对话记录(#139、#159):
- 长对话只渲染可见部分,滚动和恢复会话更快;
- 流式回复只重绘最后一段,2000 行的回复从 27 秒降到 0.4 秒;
- 思考过程实时显示最后 3 行,结束后折叠为“Thought for Xs”,可展开;
- Alt+↑ 聚焦对话记录,逐块选择、折叠、展开,E 全部折叠或展开;v 全屏查看一个块;
- /find 搜索整个对话记录,n/N 跳转。
- 工具调用(#155):
- 按工具类型显示,带退出码、超时和实时计时;
- diff 带语法高亮和行号,超过 30 行自动折叠;
- 连续的只读调用合并为一行;
- 计划(todo)显示为单独的面板。
- 输入框(#147):
- Ctrl+Z 撤销、Alt+Z 重做,Alt+K 剪切到行尾;
- 大段粘贴折叠为一块;
- Ctrl+R 搜索历史,Ctrl+S 暂存草稿,Alt+M 多行模式;
- @ 文件补全在后台建立索引;
- 排队的消息可以立即发送、编辑和调整顺序。
- 审批与提问卡片(#162、#163):
- 审批卡片显示完整命令,过长时卡片内滚动,并说明为什么需要审批;
- 编辑审批直接显示变更预览;
- “始终允许”可以用 Tab 调整范围:命令从精确命令到命令前缀再到整个程序,编辑从文件到目录再到整个项目;
- 一次可以问最多 4 个问题,每题一个标签页;
- 计划模式下可以逐行评论计划、要求修改或批准。
- 模式标签旁多一个徽标,显示只读、允许编辑、AI 审核等状态。
- 状态与用量(#141):
- 状态行显示当前阶段(思考、输出、调用工具、重试倒计时、压缩)和计时;
- 错误按类型显示成横幅,带原因和建议;
- 新命令 /usage 显示 token、缓存、费用,可按模型、按子代理查看;
- 终端不在前台时发桌面通知,窗口标题跟随状态;
- 状态行可用自定义命令生成。
- 会话与设置(#151):
- /help 打开快捷键速查表;
- /settings(或 F2)、/extensions、/memory 打开对应面板;
- 会话选择器支持筛选、搜索和删除;
- 回退对话时可以选择只回退对话、只回退代码或两者都回退;
- 首次运行和信任工作区的引导在界面内完成;
- 复制后会显示复制了什么。
协议与后端
- tool.result 新增可选的 exit_code、timed_out、duration_ms(#135)。
- permission.requested 的编辑审批新增可选的 preview(统一 diff、是否新文件、是否截断)(#135)。
- question 工具支持一次提多个问题(questions),旧的单问题输入不变(#162)。
- 以上都是新增的可选字段,旧客户端无需改动。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.20 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.20
本版从 main 的 3fa12a4 构建,在 v0.107.19 的基础上加入 kn 终端界面的新视觉。
新功能
- kn 终端界面换上统一的视觉主题(#133):
- 配色:界面所有颜色都来自同一套语义配色,深色、浅色主题都有真彩色、256 色和 16 色版本。Markdown 和代码块高亮也用这套配色,代码块不再压在写死的灰色背景上;
- 无颜色与 ASCII 终端:设置了 NO_COLOR 或 K_BRAIN_THEME=mono 时,完全不输出颜色,改用粗体、暗淡、反显和符号区分。K_BRAIN_ASCII=1 强制只用 ASCII 符号;TERM=linux、vt100、dumb 等终端或非 UTF-8 环境会自动切换;
- 工具行:排队、运行、完成、失败用同一种格式,即“符号 工具名 对象 …… 状态 · 耗时”。失败显示 ✗ … failed,命令非零退出也算失败。排队中的调用不再显示原始 JSON;
- 审批与提问:改成带彩色边框的卡片,选项带编号,按数字键直接选。窄终端下长命令会换行显示;
- 模式标签更醒目:默认的 “Always allow” 用醒目的底色显示,默认模式不变;
- Esc 防误触:Esc 仍会取消当前回复;取消后短时间内再按 Esc,不会误开“回退对话”;
- 其他:差异里的长行改为换行显示,不再截断;--json 这样的行内代码不再在连字符处断行;欢迎框在窄终端下自动精简。
修复与改进
v0.107.19 的全部内容:#120(后台子代理活过本轮且不再占住会话)、#122(子代理实时转录与单独停止)、#124、#125(流式与事件日志性能)、#127(kn 子代理面板)、#128、#130(目标续跑轮显示成通知)。详见 v0.107.19 发布说明。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.19 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.19
本版从 main 的 12db595 构建。
新功能
- 子代理实时转录与单独停止(#122):
- 列表与转录:新增 GET /v1/sessions/{id}/subagents(前台与后台子代理列表),GET …/subagents/{task}(截至此刻的转录),GET …/subagents/{task}/events?after_seq=N(只含该子代理事件的 SSE)。另有单独停止某个子代理的接口;
- 实时事件:子代理运行时,它的文字、思考、补充指令和工具调用作为 trajectory.child.* 事件写入会话事件日志,文本按 100ms 或 8 KiB 合并发出。旧客户端会忽略这些事件,会话历史不变;
- 载荷:Subagent 新增 parent_tool_call_id、background、usage、tool_count、duration_ms。
- kn 终端界面的子代理面板(#127):
- 转录中的子代理:显示一行实时状态(工具次数、最新工具、耗时、token),完成后变成一行摘要;
- 前台子代理:也会出现在面板里,可以打开查看;
- 面板:运行中的排在前面,可用 Ctrl+X 直接停止选中项;
- 完成通知:后台子代理完成后显示为一行弱化通知,不再显示成用户输入。
修复
- 后台子代理不会再随一轮对话结束而被取消,也不再占住会话(#120):
- 问题:模型用 background=true 启动的子代理,会在本轮结束时被一起取消,报告送不回来;
- 现在:本轮正常结束后,子代理会继续运行,完成后把报告送回会话。用户停止本轮、/close 或删除会话时,子代理会一起停掉;
- 不再占住会话:子代理运行期间,用户可以照常发起新的对话,也可以编辑、分支、压缩;目标续跑、排队消息和唤醒照常进行。只有切换模型或工作区、回退代码这两件事要等子代理结束,此时返回 409 session has a running background subagent;
- 遗留任务:K-brain 退出时还没结束的子代理,下次加载会话时会标记为中断,不再一直挡住删除和编辑。
- 目标续跑轮与运行时提醒不再显示成用户消息(#130):/goal 的每个续跑轮 [goal n/m] …、新上下文提示和输出上限续写提醒,现在带 origin: "background",客户端会显示成通知。续跑轮也不再进入提示词回溯。/goal <目标> 本身仍是用户消息。
性能
- 事件日志写入更快(#124):run 进行中复用同一个日志文件句柄,不再每个事件都打开、关闭一次(Windows 除外)。每 256 个事件记录一个偏移标记,断线重连后的重放直接从标记处开始,不用从文件开头读起。
- 长回复和大工具参数的流式拼接不再越来越慢(#125):Chat Completions、Responses、Anthropic 三种流式回复以前每收到一段增量就把已收到的内容整体复制一遍,现在改为直接追加,开销从平方级降到线性。
测试
- 修正 TestSubscriptionRefreshWithoutDesktop 写死日期导致过期失败的问题(#128)。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.18 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.18
本版从 main 的 fb84dd3 构建。
修复
- wait 和后台进程不会再随一轮对话结束而中断(#118):
- 问题:一轮对话正常结束时,模型交给后台的 wait 和非 isolated 的 ManagedProcess 会被一起取消,被取消的进程也不发结束通知。模型照 wait 的提示结束这一轮后,就再也不会被唤醒,任务停在半路;
- 现在:一轮正常结束后,它们会继续运行,完成后照常唤醒会话。用户手动停止或关闭会话时,它们仍会一起停掉;
- 后台通知:wait 结果、进程退出、后台子任务和工作流的报告,在 user.message.appended 和会话历史里带 origin: "background",客户端可以和用户输入区分开。唤醒运行不再算作用户输入。发给模型的请求不含这个字段,旧客户端会忽略它。
- AskUserQuestion 不再经过 AI 审查(#114):它只是向用户提问,不会改动任何东西,所以提问会更快出现,不用等审查。deny 规则仍然生效。
- 停止生成后保留已输出的回复(#116):用户停止运行时,已经流式输出的文字会存进历史,末尾标注被中断,下一轮模型也能看到。只有思考内容、没有正文的回复不保存。
- Windows 上测试全部通过,并修掉其中暴露的两个问题(#108):
- 权限规则:Windows 上不带盘符的规则(如 Grep(/p/secret/**))以前什么都匹配不到,deny 不生效;现在按工作区所在的盘匹配,和 Linux 的语义一致。之前在 Windows 上失效的 allow 规则也会开始生效;
- worktree:并发创建 worktree 时不再报 failed to read .../commondir。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.17 | 5 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.17
本版从 main 的 da27591 构建。
新功能
- TUI 里可以复制对话了(#110)。在 kn 里用鼠标拖选文字,松开即复制,页脚会短暂提示「已复制 N 个字符」。选区保留时按 Ctrl+C 或 Cmd+C(终端支持 kitty 键盘协议时)也会复制,不会触发退出。
- 本机:用系统剪贴板工具(macOS pbcopy,Linux wl-copy / xclip / xsel,Windows PowerShell);
- SSH、容器或本机工具不可用时:改用 OSC 52 把文字交给终端,复制到你自己电脑的剪贴板。tmux 里会自动包装,需要 set -g set-clipboard on;
- 限制:OSC 52 最多发送 100 KB,超出时明确提示失败,不会假装复制成功。设置 K_BRAIN_CLIPBOARD_NO_OSC52=1 可关闭 OSC 52;
- /copy 也走同一套路由。想用终端自带的选择功能时,用 /mouse 关闭鼠标捕获。
修复
- 生图失败不再一律显示「图像模块不可用」(#106):
- 保留错误码:IMAGE_RESULT_UNKNOWN、IMAGE_NO_IMAGE_OUTPUT 和新增的 IMAGE_OUTPUT_SAVE_FAILED 原样返回(502),不再改写成 IMAGE_UNAVAILABLE/503;
- 失败原因:新增可选的 reason 字段,只含固定短语,不转发上游原文;
- 代理:生图请求和图片下载都按连接的「使用应用代理」开关走代理;
- 下载:总超时从 60 秒改为 5 分钟。直连下载过慢时,reason 会建议打开代理开关;
- 重试判定:没建立连接的请求才算未发送,可安全重试;已发出的请求标为结果未知,避免重复计费。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.16 | 4 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.16
本版从 main 的 812f4cf 构建。
新功能
- 按运行启用的工作区沙箱(#104)。运行请求可以带 options.sandbox: {mode: "workspace", network: true|false},命令(Bash、ManagedProcess、TerminalSession 及 hooks)会在系统沙箱里执行:
- 可写范围:只限运行的 write 工作区、系统临时目录,以及 shell 需要的 /dev 节点;
- 屏蔽目录:~/.ssh、~/.aws、~/.gnupg、~/.config/gh 以及 K-brain 自己的数据(配置与 API Key、会话、记忆、权限规则),读写都被屏蔽;
- 只读路径:.liveagent/、.k-brain/、.git/hooks/ 即使在可写工作区内也只读;
- 断网:network: false 时禁止联网;
- 拒绝而非裸跑:平台无法隔离时(原生 Windows、没有 bwrap 等),请求返回 400 options.sandbox: …,不会在沙箱外运行;
- 能力上报:/v1/health 新增 capabilities.run_sandbox(supported、mechanism、network_control、read_masking 等),客户端据此启用沙箱选项。
macOS 用 seatbelt(/usr/bin/sandbox-exec),Linux 用 bubblewrap。
- 沙箱内的审批:在 normal / auto_edit 模式下,沙箱里的命令不再逐条确认。plan 模式、deny/ask 规则、auto_review 以及已配置的 AI 审查仍然优先,审查器照样会看到每条命令。文件编辑等进程内工具不受系统沙箱约束,仍按权限模式处理。
修复
- seatbelt 配置(也影响 config.sandbox):旧配置会让写 /dev/null、TMPDIR 失败,工作区路径经过符号链接(/var → /private/var)时也写不进去。新配置修正了这些问题。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.15 | 4 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.15
本版从 main 的 c3aec1b 构建。v0.107.14 的构建没有完成发布,它的修复一并包含在本版中。
修复
- 压缩摘要被输出上限截断(#102):压缩时报 compaction summary failed: response truncated by output limit (incomplete.max_output_tokens) 的问题已修复。推理模型的思考 token 也算进输出上限,原先固定的 4096 很容易被用完。现在的处理是:
- 摘要被截断时自动加大输出上限重试,最多到 32768,不超过模型自身的上限;
- 走缓存的同模型摘要仍被截断时,改用分块转录摘要;
- 都失败时保留原有历史,不会用残缺摘要替换。
- 设置里标了"文本与图片"的模型仍按纯文本处理(#103)。供应商 /models 目录把模型报成只有 text 时(中转站常见),设置里的覆盖不起作用:
- Read / Image 报 image attachment unavailable for this model;
- 对话里贴的图片被丢弃。
现在设置里保存的输入能力优先于供应商目录;没有保存时仍按目录判断。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.13 | 4 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoK-brain v0.107.13
本版从 main 的 a215358 构建。
修复
- 压缩本身超窗时自动恢复(#93):中转端点的实际窗口比目录登记的小时(如 input_too_large … 664630 tokens > 500000 tokens),压缩不再直接失败,而是:
- 采纳端点报告的窗口;
- 改用分块转录摘要。
- 这类报错措辞现在也能识别为超窗。
- 截断时不会再把中文切成乱码。
- 流式请求空闲超时(#92):流中途连接半开时,空闲 120 秒后按可重试错误处理,不再无限挂起。Ctrl+C 取消不受影响。
新功能
- 桌面端(LiveAgent)
- 编辑后返回 LSP 代码诊断,并新增只读的 lsp 查询工具(#89)。
- 后台子代理、wait 和后台进程结束后自动开一轮新回复;agent 运行的 shell 不再继承后端访问令牌(#90)。
- 上下文
- 除 AGENTS.md 外,也读取 CLAUDE.md 和 .cursor/rules(#88)。
- 压缩掉的历史存成 markdown 片段,模型可以回查(#91)。
- 回复被输出上限截断时自动续写(#94,TUI 接入见 #98)。
- Hooks:新增 PostToolUseFailure、压缩前后和 SessionEnd 事件(#96)。
- CLI 工具
- 只读的 grep、glob、list(#97)。
- web_fetch:抓取网页并转成文本(#101)。每次都需要确认,可以按域名设为"总是允许";跨域重定向需要重新确认;走应用代理。
- edit 匹配更宽容,参数解码更稳(#99)。
- TUI
- 布局更紧凑,底部信息栏只占一行(#95)。
- grep/glob/list 显示自己的标题行,并折叠成计数(#100)。
下载与校验
提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper,共 12 个二进制;SHA256SUMS 用于校验下载文件。
完整变更 |
| 0.107.12 | 4 Novemba 2026 | — | 64-bit PortableARM64 Portable Maelezo ya toleoWhat's Changed
- fix(imaging): accept provider URLs and honor the selected canvas by @AlphaCatMeow in https://github.com/Stack-Cairn/K-brain/pull/86
Full Changelog: https://github.com/Stack-Cairn/K-brain/compare/v0.107.11...v0.107.12 |