Kernel v0.16.3 · TUI/Portal v0.10.6

新功能与改进

1. 01

   工具知识归宿：包目录、契约、术语表与校验器

   每个内置工具被重组到 src/tools/ 下自己的包目录中，配有记录公开 API 的 CONTRACT.md、将本地化术语从运行时 i18n JSON 中迁出的按语言术语表文件（en/zh/wen），以及在测试时强制执行结构和跨语言对等的集中式 glossary_validator。

   • Kernel #839 将 14 个工具包（bash、read、edit、glob、grep、daemon、email、mcp、notification、psyche、soul、system、skills、knowledge、vision、web_search、avatar、write）从分散位置（lingtai/core、lingtai/capabilities、lingtai/intrinsics）整合到统一的 src/tools/ 命名空间中，每个工具附带更新的 ANATOMY.md。
   • Kernel #844 为每个工具包添加 glossary-en.md、glossary-zh.md 和 glossary-wen.md，外加一个 tools/i18n/ 目录（含 en.json/zh.json/wen.json）和一个 glossary_validator.py（171 行），用于检查结构、必需键和跨语言键对等。中文术语表内容增长 +5,224 字符（+221.17%），文言 +5,106 字符（+212.66%）；英文术语表文件新增 0 字符，因为英文术语已在工具源码中存在；这是一次仅术语表文件的增量（#844）。
   • TUI #614 添加了 lingtai-preset-skill 路由文档，含 12 个子手册，涵盖 Codex、Claude Agent SDK、custom、DeepSeek、Gemini、Kimi、MiMo、MiniMax、NVIDIA、OpenRouter 和 Zhipu 提供商——让 preset 配置文档出现在操作者实际查看的地方。

   为什么重要：当工具描述、本地化术语和公开契约位于同一包目录中时，贡献者可以在不搜索三个独立代码库的情况下找到和修改它们。术语表校验器确保在一种语言中添加术语不会悄然破坏另一种语言。

2. 02

   单一来源化的工具指导与 OpenAI wire 选择器

   Kernel #842 通过引用术语表而非内联每个工具的完整描述，在系统提示中单一来源化重复的工具指导字符串，在所测量的测试提示上每次 API 调用节省约 2975 token。此测量范围（特定的测试提示和使用的模型）不同于通用 token 计算，-2975 的数字不能作为跨所有配置的通用净减量。

   • Kernel #842 将系统提示中的工具指导重构为引用术语表文件而非内联本地化字符串，在用于验证的测试提示上产生 -2,975 token 的实测节省。测量范围限于该测试提示和模型；不能外推为跨所有操作者配置和提示的通用净减量。这个 -2,975 token 是特定测试提示上的 wire 节省，与 #844 术语表文件字符增量属于不同的测量范围。
   • Kernel #843 添加自定义 OpenAI wire API 选择器，使操作者可以按 agent 或 preset 选择确切的 OpenAI 兼容 wire 格式（如 chat completions vs. responses API），而非依赖单一硬编码默认值。
   • TUI #613 在 TUI preset 编辑器中镜像了 kernel 端的自定义 wire 选择器，使 wire API 选择成为一等 TUI 设置，而非仅限 manifest 的覆盖。

   为什么重要：-2,975 token 的节省对所测量的提示是真实的，但它不是通用下限；不同的提示、语言和工具数量会产生不同的节省。诚实地说明测量范围可以防止操作者期待在他们的配置中不会成立的固定节省。

3. 03

   codex-pool 模型分类与认证元数据

   codex-pool 认证通道现在按精确模型标识符分类共享 OAuth 池，而非将一个凭证背后的所有模型视为可互换的；token 账本记录安全的认证元数据以便审计。

   • Kernel #841 按精确模型分类 codex-pool 认证池，使一个为多个模型服务的 OAuth 凭证不再被当作一个未分化的池。
   • Kernel codex/token-ledger-auth-metadata 在 token 账本中记录安全的认证元数据（池、模型、来源），不暴露凭证材料。
   • TUI #612 在 setup 和池管理 UI 中保留并如实渲染模型分类的 codex pool。

   为什么重要：当多个模型共享一个 OAuth 凭证时，成本归因和限流排查需要准确知道是哪个模型消耗了 token；分类使归因自动化，而不需要手动翻日志。

4. 04

   一键安装脚本、portal 安全与 TUI 座舱改进

   TUI 新增一个从单条 curl 命令启动 Go、Node、uv 和 venv runtime 的 GitHub-release 一键安装脚本，加固了 WSL 和损坏 venv 的回退，并将 portal 仅回环绑定设为安全默认值。

   • TUI #595 添加 install.sh——一个含 Go、Node、uv 和 venv 引导、portal 构建支持和源码构建回退的 GitHub-release 一键安装脚本（#596、#598、#599、#601–#604、#606）。
   • TUI portal 回环绑定成为默认值（TUI fix/portal-loopback）：portal 不再默认绑定 0.0.0.0，关闭了早期安全审计中报告的暴露。
   • TUI #610 添加邮箱搜索和归档扫描，让操作者可以按关键词查找消息而不离开座舱；TUI #611 在 Details 面板中显示会话工具调用统计。
   • Codex OAuth 凭证现在可以打标签（TUI BatalloLu: allow labeling Codex OAuth credentials），使多账户设置在登录 UI 中可区分。

   为什么重要：一个真正引导每个依赖（Go、Node、uv、venv runtime）的一键安装脚本消除了新操作者最大的采用摩擦。仅回环 portal 绑定是一个本地优先工具的安全默认值。

5. 05

   后端知识、凭证加固与 sidecar wheel 修复

   kernel 为 9 个 daemon 后端添加了 flag-discovery 子手册，扩展了凭证脱敏和 IMAP 附件消毒，识别了 AED manifest 字段，修复了伪 agent 邮件轮询，并以 #847 收尾——一次让原生 lingtai-search-sidecar 平台 wheel 安装进 platlib 的打包修复。

   • Kernel #830–#837 为 Codex、OpenCode、claude-p、MiMo Code、内置 LingTai、Kimi Code、Qwen Code、Cursor 和 Oh-My-Pi daemon 后端添加了 flag-discovery 子手册——每个都记录了该后端的确切标志、环境变量和发现流程。
   • Kernel #824 扩展了 trace 脱敏以覆盖额外的凭证键名；kernel #770 在写入磁盘前消毒 IMAP 附件文件名；kernel #825 识别 AED（agent entity descriptor）manifest 字段；kernel #806 修复了伪 agent 发件箱轮询优先级。
   • Kernel #828 澄清了重建上下文观察时机，#838 澄清了刷新期间的对等邮件。Kernel #846 修复了 prompt 相关文件的运行时路径解析，并添加了在 prompt 爬取检查中忽略外部路径的测试。
   • Kernel #847 让原生 lingtai-search-sidecar 平台 wheel 布局正确安装进 platlib 而非 purelib；Ubuntu、Intel macOS、ARM macOS 和 Windows wheel 作业外加一个独立 sdist 均在 wheels 工作流 run 29108219136 上通过。Intel/ARM macOS wheel 声明 10.12 / 11.0 部署目标下限，且一个无依赖的 sidecar 冒烟测试避开了无关的 PyAV/FFmpeg 依赖解析。这是对既有 Python wheel 运行器的 CI/打包修复，而非新的 Windows 产品或工具。

   为什么重要：每个 daemon 后端有自己的标志约定和环境怪癖；每个后端一个子手册意味着运行时可以呈现确切的设置指导而非通用建议。凭证脱敏和附件消毒是一个读取邮件且无人值守运行的工具的基本门槛。而把原生 sidecar 放进 platlib 的 wheel，决定了一次安装是能正常 import，还是把文件悄悄装到了错误的位置。

6. 06

   发布窗口审计与贡献者

   本条目记录每个 commit 作者，采用从上一发布标签到本次发布标签的严格范围：TUI/Portal v0.10.5..v0.10.6（41 个 commit；作者分布 30 个 @huangzesen、7 个 @TZZheng、3 个 @github-actions[bot]、1 个 @BatalloLu），Kernel v0.16.2..v0.16.3（54 个 commit；作者分布 48 个 @huangzesen、5 个 @TZZheng、1 个 @wchwawa）。GitHub merge commit 的提交者与 @github-actions[bot] 属于自动化而非人类作者；@9s5bz2jvd2-lang 是 kernel #843 的共同作者；部分 commit trailer 上有 AI 共同作者（Claude Fable 5、Claude Opus 4.8）。

   • TUI/Portal：41 个 commit（30 个 @huangzesen、7 个 @TZZheng、3 个 @github-actions[bot] 每日 star 更新、1 个 @BatalloLu；其中 13 个 merge commit 由 GitHub 提交）；149 个文件变更，+7,573 / -1,007 行。
   • Kernel：54 个 commit（48 个 @huangzesen、5 个 @TZZheng、1 个 @wchwawa；merge commit 由 GitHub/@huangzesen 提交）；至候选提交为 392 个文件变更，+12,506 / -2,718 行；纳入 #847 sidecar wheel 修复（5 个文件，+809 / -71）后，至 v0.16.3 标签为 396 个文件变更，+13,306 / -2,780 行。
   • 注：kernel #842 在所测量的测试提示上通过单一来源化移除了 -2,975 token 的系统提示工具指导；此测量范围（特定测试提示）不同于通用净计算，-2,975 的数字不是通用节省，且与 #844 的术语表文件字符增量（英文 0；中文 +5,224/+221.17%；文言 +5,106/+212.66%）属于不同范围。
   • 窗口内的人类贡献者/作者：@huangzesen、@TZZheng、@9s5bz2jvd2-lang（kernel #843 共同作者）、@BatalloLu、@wchwawa。自动化：@github-actions[bot]（每日 star 更新）与 GitHub merge 提交者。AI 共同作者：Claude Fable 5、Claude Opus 4.8。

   为什么重要：贡献者名单刻意列出每位人类 commit 作者，将自动化（bot 与 GitHub merge 提交者）与人类分开，并说明 #842 的测量注意事项，让操作者可以自行判断提示成本的变化。