修复 / 硬化
跨端契约对齐（Win 侧翻回 Mac 语义）
- warmup 超时保活 handle：warmup timeout 不再 terminate 子进程，保留活 handle +
warming_up=True，让 self-heal 后续探测/health 200消化 warming 状态（原先 120s+ warmup 慢机会被误杀） - install → start chaining flag pattern：Win tray 复刻 Mac Swift
startAfterInstallRequested语义，install 成功后走 reconcile tick dispatch，避免 tray header-only install 后立即 CASPOST /start导致抢跑 - Stop max_retries=3：hard failure 不再永远重试，达到上限抛 CRITICAL 保 pid/port 供人工介入
- cmdline adopt 归属判定：
--model-id支持 resolved 绝对路径（含空格 quoted / equals / space 三态匹配），修"自家进程被判为外人" _verify_kb_api_exewmic → Get-CimInstance fallback：兼容 Windows 11 22H2+ wmic deprecated 默认关闭/v1/system/restartPS 5.1 ParseFile 预检：无 BOM UTF-8 脚本被 PS 5.1 按 ANSI 读会 parse fail 但 fire-and-forget Popen 拿不到 exit code → 现在启动前 ParseFile 预检，失败返 500 不假绿local-restart-direct.ps1加 UTF-8 BOM：PS 5.1 硬要求
Bug fixes
rebuild-vector-index撞 "Qdrant 客户端不可用"：resume()补 eager_ensure_client_and_collection- LLM output token 截断
- 配置保存 + embedding 服务重启多轮修复
其他
VERSION文件加入 git 追踪，dev / build / installer三处版本一致 CI 兜底（test_release_contract.py）- 补齐 26 条 tray client 契约测试 + 契约类回归 pin
支持平台
macOS 13.0+ (Apple Silicon / Intel) · Windows 10+ · Linux (CLI)
安装
- macOS: 下载
KnowledgeBase-mac-direct-1.3.13.dmg，双击挂载，再双击里面的Install.command—— 脚本自动装到/Applications/KnowledgeBase并打开菜单栏 App - Windows: 下载
KnowledgeBase-Setup-1.3.13.exe双击安装