← 发布

id 20260529-1 · 2026-05-29 · v0.8.12 / v0.11.0

v0.8.12 / v0.11.0

灵台 TUI/Portal v0.8.12 与内核 v0.11.0

一次横跨 Go 侧 TUI/Portal 与 Python/Rust 内核的联合发布窗口。TUI 发布 v0.8.12,重点是 first-run 恢复、Homebrew 升级安全、MCP 控制面、Rust sidecar 诊断与 dev runtime 保护;内核发布 v0.11.0,用 minor 版本标记 Rust-backed rewrite 这一条线,并在完整 release 验证后发布到 PyPI。

升级 / runtime

$ brew update && brew upgrade lingtai-ai/lingtai/lingtai-tui

内核/runtime 包 lingtai==0.11.0 已发布到 PyPI,但普通 LingTai 项目不通过裸 pip install 来升级它。TUI 负责创建和维护每个项目的 runtime venv,并在该 venv 中解析内核包。

新功能与改进

  1. 01

    TUI/Portal v0.8.12:恢复与升级路径更安全

    桌面侧这一版集中收掉 first-run setup、OAuth/no-key preset、以及 TUI 内 Homebrew 升级路径上的几个尖角。

    • first-run / recovery setup 现在会持久化 ~/.lingtai-tui/config.json,避免 OAuth 或 no-key preset 反复进入 setup loop。
    • TUI 内 Homebrew upgrade prompt 现在会检测其它正在运行的 TUI,要求显式确认,先 sleep 受影响 agent、停止旧 TUI,再提示用户重新启动,而不是从旧 Cellar binary 里自我 exec。
    • 升级入口仍然保留,但避开了多窗口升级时新旧 TUI 进程互相踩状态的危险路径。

    为什么重要:安装与升级路径是新用户最先碰到的地方。它们必须足够稳定,后面的 agent network 才有资格显得“活着”。

  2. 02

    MCP 成为面向人的控制面

    TUI 命令面现在回到系统真实边界:外部集成是 MCP resources 与 control panel,而不是另一套 addon 哲学。

    • /mcp 取代 /addon,成为面向人的命令与 palette 入口。
    • 控制面文案改为围绕 MCP resources、status、config,而不是把平台 onboarding 硬编码进 TUI。
    • 命令分发、i18n、文档与 packaged recipes 中陈旧的 /addon 引用已清理。

    为什么重要:这让 TUI 保持薄:MCP 包拥有自己的知识,TUI 只给人一个清楚的入口。

  3. 03

    核心能力与本地开发 runtime 得到保护

    setup 与 preset editor 现在区分不可缺的 runtime floor 和可选模型/提供商能力;dev-mode kernel install 也保持本地 editable。

    • core/default capabilities 总是包含;preset editor 的可编辑勾选项聚焦 web search、vision 等可选能力。
    • LINGTAI_DEV_ROOT 成为明确的 dev-mode contract,用来让 runtime venv 指向本地 lingtai-kernel checkout。
    • runtime repair 不再在开发者本来要测本地 kernel 时,悄悄把 editable install 改回 PyPI wheel。

    为什么重要:用户更不容易误删 agent 脚下的地基;开发者也有了可靠的 kernel 本地测试闭环。

  4. 04

    Rust sidecar 诊断进入 `/doctor`

    TUI 现在会展示 packaged Rust file-search sidecar 的状态和本地 Rust/Cargo 准备情况,而不是把 Python fallback 藏在症状后面。

    • /doctor 会报告 file-search 路径的 packaged Rust sidecar 状态。
    • 它也会报告本地 Cargo/Rust 是否可用,方便重建或诊断 sidecar fallback。
    • 当系统因为缺少 Cargo 而 fallback 到 Python 时,启动路径可以给出提示。

    为什么重要:Rust-backed 这一条线应该能从产品自己诊断出来,而不是只能靠翻源码与环境考古。

  5. 05

    内核 v0.11.0 标记 Rust-backed runtime 线

    PyPI 上的 kernel 包升级到 0.11.0,而不是继续 patch 版本,因为这个发布窗口跨过了 Rust-backed runtime pieces 的 rewrite 边界。

    • PyPI 包 lingtai==0.11.0lingtai-kernel main commit 3b0758f 构建发布,包含 wheel 与 sdist。
    • kernel release-blocking 测试已经完成归因:陈旧 path / wording / timer 期望被更新后,version bump 前 full suite 通过 1969 passed, 2 skipped
    • 从 PyPI clean virtualenv 安装后已验证 import lingtai, lingtai_kernel 与发行版版本 0.11.0

    为什么重要:版本号与这次架构变化的重量相匹配;公开包也经过验证,而不是只打了 tag。

  6. 06

    随包指导与发布纪律补强

    这个发布窗口也更新了 agent 随身携带的操作知识:GitHub 操作、Claude Code stale token 调试、以及 release log 约定。

    • 随包 guidance 现在教 agent 使用 GH_TOKEN 或已有 gh auth 做 GitHub 操作,而不是要求人类粘贴 shell 命令。
    • swiss-knife Claude Code 文档补充 stale CLAUDE_CODE_OAUTH_TOKEN 来源、安全 env -u wrapper、shell startup file 诊断、以及已运行 agent 继承旧环境的坑。
    • 发布流程记录了两层 release 约定:简短 GitHub Release notes,加一份更长的人类可读 HTML release log。

    为什么重要:操作知识应该随 LingTai 一起发布;每一次 release 都应该让下一次 release 更容易做对。

贡献者

感谢本发布窗口中提交 PR、报告问题或推动 issue closure 的贡献者。

验证

最终 release validation 来自干净 release worktree,commit a8259ea31bf1.