Kernel V3 引擎
Kernel V3 是 Zagens 的生产级事件溯源 turn 引擎 — 桌面、zagens-tui 与无头 zagens CLI 共用同一套核心。
自 v0.8.0 起，Kernel V3 为唯一生产 turn 路径；旧版 shadow 诊断 API（kernel-shadow）已移除。
对你意味着什么
| 收益 | 说明 |
|---|---|
| 行为一致 | 桌面 sidecar、终端 TUI、CLI 共用 turn 语义 — 减少「GUI 正常、CLI 异常」 |
| 可靠会话恢复 | turn 以 append-only kernel 事件日志写入 sessions.db；恢复时优先 log-first transcript 修复，而非仅依赖易损的 session JSON |
| 可审计 turn | 模型调用、工具批次、审批、steer 注入、LHT 续跑均有结构化事件，可在 CI 中 replay |
无需在设置里开关「Kernel V3」 — 当前版本始终启用。
三种入口，一套引擎
| 入口 | Runtime 方式 | 适用场景 |
|---|---|---|
| 桌面（Tauri） | 本机 sidecar zagens-runtime |
diff、replay、内嵌 PTY、办公模式 |
终端 TUI（zagens-tui） |
进程内 runtime | Windows / macOS / Linux 全屏终端 UI |
CLI（zagens） |
进程内 runtime | exec、review、serve --http、CI |
三者均调用 zagens-core 内同一 LiveTurnMachine + EffectInterpreter 流水线。
Log-first 会话恢复
重启后重新打开线程时：
- 加载该 turn 历史的持久化 kernel events。
- 必要时从日志修复 transcript（默认
log_transcript_repair = true）。 - 桌面、TUI、CLI 共用
~/.zagens/下同一 SQLite 线程存储。
对跨多步工具的 LHT、CRAFT 长任务尤为重要。
相关概念
- Steer — turn 中途注入后续指令（TUI：工具等待间隙 Enter 排队/steer，Ctrl+Enter 强制）。Kernel 记录
SteerInjected事件。 - Sidecar — 仅桌面使用的本地 HTTP 进程；TUI/CLI 直接内嵌 runtime。
- Golden replay — 内部 CI 夹具验证 turn 日志一致性；非用户功能。
延伸阅读
- 终端 TUI — ratatui 全屏界面
- Headless CLI — 自动化与服务器
- 对话与会话 — 线程与恢复
- 流式输出与停止 — SSE 与 sidecar 连接
产品技术规格（维护者）：AGENT_KERNEL_V3.md