Skip to content

Scout v0.9.59

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Aug 03:13

Scout v0.9.59(Windows / macOS)。

本次修复:Scoutd Windows Service 启动失败

v0.9.58 真机反馈:Scoutd 服务已正确注册,但自启动与手动启动均失败,Windows 事件查看器中查不到具体错误原因。

根因:个人模式首次启动需要下载约 300MB 的 embedding 模型;LocalSystem 服务账户的网络路径(代理 / DNS / 防火墙出站策略)常与你平时登录的交互用户会话不同,下载更容易失败。v0.9.58 里这个失败会直接终止整个服务进程;而 service 模式的日志此前只写向 stdout —— Windows Service 没有控制台,日志实际上写进了空气,导致事件查看器完全看不到线索。

本次修复

  • embedding 模型加载失败不再终止服务,自动降级为纯关键词(FTS-only)检索,不影响服务正常启动。
  • embedding 模型下载新增 hf-mirror.com 镜像兜底,缓解部分网络环境下服务账户连不上 HuggingFace 主源的情况。
  • service 模式改为写文件日志:%ProgramData%\Scout\scoutd\scoutd.log(按日滚动),并加了 panic 兜底记录 —— 如果这次装完仍然启动失败,请查看这个文件里的具体报错,会比事件查看器有用得多。

升级建议:直接安装本版本覆盖即可(原地升级,索引/模型/设置保留);安装完成后请到 services.msc 确认 Scout 后台索引与检索服务Scoutd)状态为 Running。

  • 未做代码签名 / 公证,首次运行系统会有安全提示(Windows SmartScreen /「更多信息 → 仍要运行」;macOS Gatekeeper /「右键 → 打开」)。
  • 放行步骤 / SHA256 校验 / 升级卸载说明:见 安装指南

模型文件(均可选,首选应用内「快速入门」一键下载;也可手动放置):

  • embeddinggemma-300m-q8_0.gguf —— 语义召回 embedding 模型(启用「按意思找到」/ 跨语言)。缺失则语义召回降级纯关键词(FTS)。
  • qwen3-0.6b-q4_k_m.gguf —— 生成模型 fallback(复杂查询 AI 解析)。缺失则降级 parser-only。

两者均不放置也可正常使用(纯关键词搜索)。「选项 → 常规 / 语义召回」可查看各模型状态。