用途:让 vibe Next.js + Tauri 应用用用户本机运行的模型提供聊天,而非托管后端。当传入的 localLLMProps 中 isAvailable 为 true,且 ollamaStatus.model_installed(或 foundryStatus.has_models)报告模型就绪时,SDK 自动启用本地推理。
主要能力:定义应用需实现的契约,包括 React 层调用的 Tauri #[command] 名称、监听的 Tauri 事件名、React hook 必须返回的结构,并指向安装流程、磁盘布局与失败模式的参考文档。技能不提供参考实现,本地 LLM 支持在现有应用中为闭源。
使用方式:需先通过 /iblai-vibe-ops-build 接好 Tauri 外壳(src-tauri/ 已存在),安装 Rust 工具链与各系统 Tauri 依赖,并通过 /iblai-vibe-auth 配好 ibl.ai providers。将 assets/nextjs/types/tauri.ts 放到 types/tauri.ts,其中导出 TAURI_COMMANDS、TAURI_EVENTS、OllamaStatus、DownloadProgress、InstallationLog、DiskSpaceError、FoundryStatus 及 isTauriApp()。Rust 侧需实现 install_ollama、stop_ollama、check_ollama_status、check_disk_space_for_model、get_system_memory、download_model(model_id)、cancel_model_download、check_network_status、get_os_type、ollama_chat、ollama_chat_stream 等命令并注册到 invoke_handler。SDK 已导出 useModelDownload(),建议将其输出重命名为 on* 回调接入 localLLMProps,而非自行实现。localLLMProps 由 UserProfileDropdown / UserProfileModal 读取,聊天路由自动完成,<Chat> 不接收该 prop。
适用场景:macOS、Linux、Windows x64 默认用 Ollama(默认模型 Phi-3 Mini);Windows ARM / Copilot+ NPU 用 Foundry Local(默认 qwen2.5-0.5b)。
限制:不要在 ibl.ai SDK 组件上加自定义样式或颜色。Linux 上 install_ollama 需 root,非 root 应用可能静默失败,建议无 root 安装或引导用户。含运行时动态路由且无 generateStaticParams 的应用无法静态导出,需保留 output: 'standalone' 并让 Tauri dev 指向本地 Next 服务。下载建议走守护进程 HTTP API(POST 127.0.0.1:11434/api/pull)而非 CLI。内存告警应取 max(ram_total, vram_total),因 vram_total 在集成显卡、Apple 统一内存及 AMD/Intel GPU 上为 0。