v0.106.0：可配置系统提示词与用户文档

更新日志

v0.106.0

新增

• 新增 ~/.k-brain/system.md 系统级提示词文件，首次运行自动写入 K-brain 默认系统提示词。
• 新增 TUI /system 命令，可直接编辑系统级提示词。
• 新增项目级提示词加载，支持工作区及父目录中的 AGENTS.md 和 .k-brain/brain.md。
• 新增 docs/user-guide/ 用户指南，覆盖安装、TUI、配置、模型协议、会话、压缩、rewind、subagent、plugin、sandbox、computer-use、ACP、hooks 和 MCP。

调整

• ~/.k-brain/brain.md 改为空的用户级指令占位文件，不再保存默认系统提示词。
• 系统提示词默认内容从 internal/config/brain.go 移至独立的系统提示词实现，并统一使用 K-brain（氪脑）名称。
• TUI、kn run 和 ACP 按当前工作目录重新组合系统、用户和项目提示词，编辑后下一轮对话即可生效。
• README 增加提示词层级和用户指南入口，配置文档同步第三方 API、/v1/models 和可自定义上下文长度说明。

验证

• 通过 go vet ./...。
• 通过全仓库编译测试：go test ./... -run '^$'。
• 通过系统提示词、brain.md、项目提示词和 TUI 命令覆盖测试。

What's Changed

• feat: 支持自定义系统提示词并补齐用户文档 by @xiaozhou26 in #5

Full Changelog: v0.105.0...v0.106.0

氪脑 K-brain v0.105.0

氪脑 K-brain v0.105.0

TUI 视觉重构

• 统一终端界面的颜色体系，新增语义化主题调色板。
• 针对 256 色终端和 16 色终端增加兼容性 fallback。
• 重构顶部 banner 与底部状态栏布局，减少信息拥挤并提升层次感。
• 根据界面语言显示 K-brain、氪脑 或 氪腦 品牌名称。
• 统一模型与提供商显示格式为 model@provider。
• /model 使用独立强调色，provider 信息降级为次要样式。

Git 状态显示

• TUI 状态栏新增当前仓库、分支和工作区变更信息。
• 显示新增、删除和未跟踪文件数量。
• Git 状态读取在后台执行，并设置超时，不阻塞交互界面。
• 支持 detached HEAD 状态显示短提交号。

布局与交互

• 优化输入区、古人模式、命令面板、模型选择器、权限模式和子代理 dock 的布局适配。
• 改进不同终端尺寸下的锚点、底部状态栏和选择行渲染。
• 完善中英文和繁体中文界面翻译及命令帮助文本。

构建与验证

• GitHub Actions 已完成 Windows、Linux、macOS 的 x64 与 ARM64 构建。
• 同时构建 k-brain-computer 六个平台版本。
• 发布 SHA256SUMS 校验文件。
• 所有 GitHub Actions 构建任务通过。
• go test ./... -p 2（本地 TUI 仓库名称测试受工作区目录 whip 影响；CI 在 K-brain checkout 路径中已通过）。
• go vet ./... 已通过。

下载

• GitHub Release v0.105.0

氪脑 K-brain v0.104.0

氪脑 K-brain v0.104.0

新功能

• 新增 Codex 风格的无摘要上下文窗口机制。
• 新增 new_context 工具，模型可以在上下文接近上限时主动创建新的上下文窗口。
• 新增 /new-context 命令，也可以使用 /compact fresh。
• 新上下文窗口不调用摘要模型，不携带旧对话消息，仅保留系统提示词和当前任务提示。
• 原始 session 历史继续保存，可恢复查看，并可通过 /compact log 查看上下文事件。

压缩机制

• 保留原有摘要式 /compact，继续支持自动压缩、手动压缩、重试和日志查看。
• 新窗口模式与摘要模式并存，按使用场景选择。
• 新增 fresh context 会话记录格式和恢复逻辑。

TUI 与交互

• 优化整体 TUI chrome、输入提示、命令菜单和子代理任务 dock。
• 完善子代理状态、耗时、用量、详情页和快捷键展示。
• 增加 /new-context 补全、帮助文本以及简体中文和繁体中文翻译。

构建与验证

• GitHub Actions 已完成 Windows、Linux、macOS 的 x64 与 ARM64 构建。
• 同时构建 k-brain-computer 六个平台版本。
• 发布 SHA256SUMS 校验文件。
• go test ./... -p 2
• go vet ./...
• git diff --check

完整变更：#3

氪脑 K-brain v0.103.0

氪脑 K-brain v0.103.0 · 重新发布

本次合并 PR #2 后重新构建并替换 v0.103.0 的发布资源，重点完善模型协议、会话恢复、子代理、流式交互、隐私网关与 Windows 安装体验。

• 合并提交：f7b9281ca8f42e9d499912b88928d34e04458f41
• 原 103 发布提交：dc6a606f398994325e521a0e49d0544f3fefc0f9
• 本次构建
• 相对于原 103 的代码变更

一、模型协议与请求可靠性

• 统一 Chat Completions、Responses、Anthropic Messages 的公共消息序列化、内容转换、HTTP 请求与重试处理。
• 完善 SSE 分帧：支持多行 data、CRLF、注释和事件大小限制；服务商错误、无效事件及缺少结束信号明确报错。
• 修复 Responses 工具参数增量与最终结果的关联，按 item_id / call_id 校验调用身份。
• 修复 Anthropic 交错内容块和工具参数拼接，保留初始工具输入及增量用量。
• 收到有效终态后结束处理，不再等待服务端关闭连接。
• 三协议支持成功 HTTP 响应前的临时网络故障及 408 / 409 / 429 / 5xx 重试；遵循 x-should-retry、retry-after-ms 与 Retry-After，等待期间可取消。
• Chat 已收到正文、思考、工具增量或用量后，不再自动重放请求，避免重复输出和重复计费。

二、输出上限与部分回复

• 流式回复达到输出上限时保留已经生成的正文和实际用量，并显示截断提示。
• Responses 的 incomplete.max_output_tokens 与 Chat / Anthropic 的长度限制统一处理；过滤、服务商失败及其他不完整原因仍返回错误。
• 截断响应中的工具调用全部丢弃，即使参数已经形成完整 JSON，也不会执行。
• 会话保存统一的 stop_reason 和服务商原始 raw_stop_reason，后续模型请求不会发送这些本地状态字段。
• kn run --format json 的 done 事件增加 stopReason；ACP 在输出上限时返回 max_tokens。
• 非流式截断返回部分文本和 OutputLimitError，不自动重试；截断的压缩摘要不会覆盖原会话历史。
• 截断回复中的目标完成标记不能误结束 TUI 持续目标。

三、图文输入与工具截图

• 修复混合图文消息序列化、读取及对象复用时的内容丢失和图片残留。
• Responses 使用 input_image，Anthropic 使用 base64 / URL 图片来源；保留系统指令和相应缓存边界。
• 工具图片按协议转换为对应工具结果内容，Chat 的工具图片放在整组工具结果之后。
• 无效图片引用在本地返回错误，避免静默丢弃。
• 浏览器和 Computer-use 截图归属于单次工具调用，替换共享截图收集入口，避免并行工具、并发会话与子代理之间串图。
• 工具结束或取消后拒绝迟到附件；是否向模型发送图片由对应主模型或子模型的图片能力决定。
• ACP 接收和回放内嵌图文时保留内容块顺序。

四、会话、压缩与工作区回退

• 提取公共会话记录模块，统一 CLI、ACP 和 TUI 的消息映射、压缩记录与恢复逻辑。
• 摘要、原始记录和用量随会话一并保存；修复连续压缩后消息位置错乱及保存失败后重复记录的问题。
• /rewind、/fork 和压缩撤销按存储消息序号定位，压缩后仍能找到正确的历史位置。
• 分叉保留关联摘要及工作区快照引用，回退不会清理其他分支仍在使用的快照。
• 首轮请求前设置会话缓存标识，恢复时继续使用同一标识。
• 会话记忆按项目和会话 ID 隔离，CLI / TUI / ACP 每轮刷新；子代理不继承全局或父会话记忆文件。
• 完善初始化失败、恢复失败、重复激活及关闭时的资源释放和持久化处理。

五、子代理与并发执行

• 子代理继承父代理的实际执行工具集，包括自定义工具替换、MCP 和插件工具，不再恢复父代理已移除的工具。
• 排除绑定父会话的提问、任务编排、待办和记忆工具；自定义工具可通过 NoInherit 排除继承。
• 保留工作目录、模型路由和执行策略，支持隔离 worktree 场景。
• 完善追问、指导消息、取消、订阅和后台任务生命周期的回归覆盖。
• 切换主模型保留后台任务、取消句柄、待办、会话缓存及累计用量；已有子任务沿用原模型，新任务按新配置创建。
• 后台输出采用有界缓冲，完善慢速消费、任务视图切换和迟到事件处理。

六、缓存用量与费用估算

• 统一主模型、子代理及独立压缩请求的模型 / 服务商归属与用量持久化。
• 保存并恢复输入、输出、缓存读取和缓存写入用量，避免恢复或重复保存后重复累计。
• 模型目录增加缓存写入单价；统一四项费用计算，先从输入总量扣除缓存分量，避免重复计价。
• 支持显式零价；缓存价格未提供时按普通输入价估算。
• 缺价、无效价格、异常计数或费用溢出时不显示无依据的总价；不借用其他服务商同名模型的价格。
• TUI 状态、回合、压缩与回退列表复用相同计价逻辑。

七、ACP 后端接入

• 完善会话创建、发送、取消、关闭、加载、恢复和断连处理。
• 增加先按项目过滤、每页最多 100 条的游标分页，正确处理同时间排序和游标对应记录被删除的情况。
• session/set_mode 支持 Auto / Ask / Plan，计划模式复用只读工具限制。
• 完善权限请求隔离、运行中切换模式、待确认请求失效及关闭等待。
• 统一 CLI / TUI / ACP 的会话启动、插件生命周期、项目目录及工具附件传递。
• 当前后端仍由 CLI、ACP 和 MCP 入口提供，不将其声明为完整 Pi RPC / Codex app-server 替代品。

八、TUI 与命令体验

• 修复正文与思考分开缓存造成的流式倒序；相邻同类增量合并，保持整体事件顺序。
• 工具预览、工具执行、指导消息和回合结束前先交付已有内容；定时刷新不能越过完成事件。
• 回合关闭后拒绝迟到回调；清理未执行的工具排队提示，同时维护历史位置映射。
• 限制主会话待交付缓冲，慢速消费者形成背压而非丢弃正文，减少工具输出更新产生的 goroutine。
• 新增 Markdown 提示词模板发现、参数替换、补全和刷新；项目模板仅从可信项目加载，展开后回到编辑框确认发送。
• 完善 /copy、/diff、!! 本地 shell，以及 Ctrl+G / /editor 外部提示词编辑。
• 补齐模型切换、历史导航、会话恢复和后台任务视图相关回归测试。
• 繁体中文标识统一为 zh_Hant，界面语言入口保留 en、zh_cn 和 zh_Hant。

九、本地隐私网关

• 新增 Go 实现的本地隐私处理链路，通过 /privacy 控制启用状态。
• 对结构化 JSON 中可处理的字符串进行规则匹配与占位替换，并在响应读取过程中进行还原。
• 覆盖常见 API 密钥、私钥、访问令牌、连接凭据、邮箱、电话号码、IP、身份证号、银行卡及其他敏感字段模式。
• 对部分字段进行格式或校验码检查，减少简单正则误匹配。
• 增加隐私状态信息，展示开关、规则数量、映射数量、请求体限制和映射有效期。
• 本地处理不依赖外部脱敏服务，不新增遥测。规则识别存在范围限制，不代表任意敏感内容均能自动识别；仍需按实际业务验证。

十、Windows 安装与项目维护

• 安装脚本校验下载文件的 SHA-256，并执行新程序核对发布版本；拒绝将 dev 或与指定版本不符的二进制当作成功安装。
• 安装目录优先加入当前进程及用户 PATH；检测同名别名、函数或旧程序遮挡，并给出定位提示。
• 保留旧主程序替换失败时的恢复处理，完善 Windows 安装相关测试。
• 删除 MCP 自动导入入口及旧 mcpImport 配置，配置未知字段明确报错。
• 持续拆分模型消息、请求重试、计价、会话记录、工具执行、任务流和提示词模板等公共逻辑。
• 更新中英文 README，补充实际能力边界、配置与使用说明。

升级提示

1. 这是同版本重新发布。 已安装旧 v0.103.0 的用户请重新运行安装脚本；只比较版本号的更新流程可能把旧产物判断为已是最新版。
2. kn --version 应显示 k-brain v0.103.0。同版本新旧构建请结合 SHA256SUMS 核对；版本字符串本身不能区分两次构建。
3. Windows 若仍显示 dev，执行 Get-Command kn -All 检查别名或旧路径。当前终端会更新 PATH，其他已经打开的终端需重启。
4. 旧配置若含 mcpImport，请删除；繁体中文请使用 zh_Hant。
5. 费用单价单位为美元 / token；旧模型目录平面价格不再参与计价，可用 /model refresh 更新目录。
6. maxRetries 表示包含首次请求的最大尝试数：1 禁止重试，0 或省略默认最多 8 次。服务端要求等待超过 60 秒时返回错误。

Windows 重新安装

& ([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/Stack-Cairn/K-brain/main/install.ps1).Content))
kn --version

Linux / macOS 重新安装

curl -fsSL https://raw.githubusercontent.com/Stack-Cairn/K-brain/main/install.sh | sh
kn --version

构建与验证

• 合并提交的源码树与此前完成回归的 PR 提交一致。
• Windows 全量 go test ./... -p 2 -count=1 -timeout=5m、go vet ./...、go build ./cmd/... 通过。
• 主会话流式相关竞态测试连续三轮通过；此前模型、会话、ACP、CLI 等相关改动已完成定向回归。
• 本地已完成 Windows / Linux / macOS × x64 / ARM64 的主程序和 Computer-use helper 构建，并检查 Windows 版本注入。
• 发布资源由本次 tag 的 GitHub Actions 重新生成，包含六平台主程序、六平台 helper 和 SHA256SUMS，共 13 个文件。
• 本次 GitHub Actions 全部成功：六个平台构建、Windows / Linux / macOS Computer 协议测试、Linux 桌面集成及发布任务均通过。
• 发布后已下载全部 13 个文件，12 个二进制的 SHA-256 均与 SHA256SUMS 一致。
• 已运行下载的 Windows x64 主程序，输出 k-brain v0.103.0；Go 构建信息确认源码提交为本次合并提交，且 vcs.modified=false。

已知边界

• 真实断流或服务商失败后的部分会话恢复尚未完整实现；输出上限截断已支持。
• 尚未实现完整思考签名协议、上下文分档价格、一小时缓存写入细分和标题生成费用归属。
• Windows 严格 OS 沙箱当前仍依赖 WSL2 / Bubblewrap，不代表 Windows 原生隔离已经完成。
• Computer-use 的部分平台驱动仍使用 Python / PowerShell；macOS 真机及 Wayland 通用桌面输入仍需后续完善。
• 交叉编译及模拟协议测试不等同于六平台真实终端、桌面和服务商的完整联调。
• 项目不包含 Desktop 前端；LiveAgent 完整后端替换及扩展协议对齐仍属于后续工作。

v0.102.0

Full Changelog: v0.101.0...v0.102.0

v0.101.0

Full Changelog: https://github.com/Stack-Cairn/K-brain/commits/v0.101.0