合橱瑰・寻迹 本地 AI 桌面工具

案例与作品
, ,
1

禾锄归*寻迹 本地文件的轻量化智能管理工具MVP 正式完工

距离发布MVP版本已经过去了三个月了 。

本次带来了全新的版本

0.5.12

发布日期：2026-08-22
说明：本次为 v0.5.3 之后的汇总大版本更新，一路迭代优化大量功能、界面、稳定性与检索性能，推荐所有用户升级。

:inbox_tray: 下载地址


🚀 下载 合橱魂·寻迹

:sparkles: 本次重点亮点

  1. 短词关键词搜索大幅提速
    在后台大批量构建语义索引、电脑高负载时，4 个字及以内简短关键词检索不再卡顿，毫秒级返回结果，日常查找文件更顺滑；长文本搜索依旧保留智能语义检索能力，互不干扰。
  2. 界面提示全面精简优化
    解决之前首页常驻提示、悬浮弹窗冗余的问题：索引进度统一放到底部状态栏展示，首页不再重复弹出提示；详情弹窗改为可手动关闭，界面更加清爽干净。索引页面重做，关键词索引、语义索引进度分开直观展示。
  3. 插件安装兼容性升级
    修复 Windows 环境下常见的权限阻止、文件占用导致插件安装失败问题。安装受阻时会自动切换备用方案，提升插件安装成功率。
  4. 向量索引进度展示修复
    解决跨批次建索引时进度百分比异常超过 100% 的 bug，进度条显示真实准确，同时增加前端兜底防护，避免怪异进度展示。
  5. 新增软件自检更新 + 内置帮助文档
    软件自带版本检测功能，可以在线查看新版本日志、安装包；内置 FAQ 常见问题文档，遇到使用疑问可以直接在软件内查阅。

:rocket: 新增功能（v0.5.4 ~ v0.5.12）

  • :framed_picture: 图片检索：支持以图搜图、文字描述搜索相似图片，适合图库、截图文档管理。
  • :brain: 智能资源调度：软件会自动感知电脑使用状态，空闲时全速构建索引；办公、玩电脑时自动降低资源占用，避免电脑变卡，夜间自动全速处理。
  • :counterclockwise_arrows_button: 插件云端升级：插件商城支持在线一键升级插件，升级自动备份你的配置、模型文件，数据不会丢失。

:high_voltage: 性能与检索优化

  1. 检索链路优化：未启用的插件不再参与搜索流程，减少多余等待；完善接口超时保护，防止后台任务卡死搜索功能。
  2. 底层数据一致性保障：重构文件索引存储机制，增加数据自检、自动修复能力，减少出现索引错乱、文件 “消失” 的情况。
  3. 向量存储目录独立分离：向量知识库数据单独存放，不再容易被误当作缓存删除，避免辛苦构建的知识库清空重建。
  4. 中文语义检索修复：早期版本存在中文语义搜索失效问题，现已修复，中文文档语义匹配精准度恢复正常。

:artist_palette: 界面与交互优化

  1. 内置主题调整命名，修复多款主题页面黑屏、返回按钮失效等前端交互 bug。
  2. 状态提示优化：插件报错提示点击可直接跳转对应插件管理页面，快速定位处理问题。
  3. 广告 / 公告加载逻辑修复，重启软件后公告内容可以正常展示。
  4. 索引状态页面全新改版，双索引卡片直观查看关键词索引、语义索引构建进度。

:hammer_and_wrench: 重点稳定性修复

  1. 向量知识库防丢失：修复运行依赖缺失时，软件误切换存储模式，导致用户误以为知识库清空重建的严重问题。
  2. 插件升级文件占用报错：解决升级插件时日志文件占用目录，出现权限拒绝、升级失败的高频问题。
  3. 索引构建收尾异常：修复批量建索引时末尾文件被静默跳过、任务卡死长时间等待的问题。
  4. OpenClaw 启动时序问题：修复内置组件解压时序错误，导致功能无法正常拉起的 bug。
  5. 混合搜索自动启用：向量索引就绪后自动开启语义混合搜索，无需用户手动设置。

:pushpin: 升级注意事项

  1. 如果你是旧版本升级，向量索引部分底层存储有调整，升级完成后建议根据需求重建向量索引，获得完整语义检索效果。
  2. 大批量文件首次构建语义索引依旧会占用 CPU 资源，软件智能调度会尽量避开你的工作时间。
  3. 升级前建议关闭寻迹软件，避免文件占用影响更新替换。

:speech_balloon: 写在最后

从 v0.5.3 到 v0.5.12，持续打磨本地知识库检索的使用体验，修复大量真实使用场景下暴露的边界 bug，兼顾检索速度、电脑资源占用、界面简洁度与数据安全。后续也会持续收集大家的使用反馈继续优化。

3 个赞
2

寻迹 v0.5.20 迭代实录：修复隐性 Bug，让本地 AI 问答与搜索回归稳定

做本地 AI 工具最难的地方在于，底层架构虽然跑通了，但面对真实的复杂环境，总会有数不清的隐性 Bug。近期我在“寻迹”的 v0.5.20 版本中，集中精力做了一次大扫除，没有堆砌新功能，而是重点修复了用户反馈的真实痛点，让 AI 问答和搜索体验回归应有的水准。

下载地址：
:inbox_tray:寻迹 v0.5.20 Windows 便携版 文件：hechugui‑xunji‑v0.5.20‑portable.zip｜大小：18.8MB 蓝奏云下载：https://mbb180.lanzouu.com/iWdSV4a4g5bg

:robot: AI 对话：从“莫名报错”到“8 轮长对话”

之前有用户反馈，AI 对话偶尔会弹出“AI助手暂不可用”，不仅没有原因，还会莫名中断。排查后发现，根源在于底层的报错解析异常——后端抛出的对象被前端直接解析成了 [object Object]。

这次的修复主要集中在三个细节：

  1. 精准报错：全面重写了超时、密钥错误、余额不足、轮数超限等场景的解析逻辑，现在所有异常都会展示易懂的中文提示。非网络通信类问题，也不会再错误提示“AI通信失败”，避免误导排查方向。
  2. 加长对话上下文：默认交互轮数从 3 轮提升至 8 轮。面对复杂文档或多步骤提问，AI 有足够的空间去完成资料调取。即便轮数耗尽，也不会直接报错，而是基于已检索到的资料强制生成总结回答，保证问题有结果、不白提问。
  3. 精准引导：轮数超限时会专属提示“重试、拆分简化问题”，引导用户正确使用，而不是一刀切地中止对话。

:magnifying_glass_tilted_left: 搜索体验：打破“一刀切”，回归语义检索本质

这是本次修复的重灾区。很多用户反馈：“明明相关的文档存在，语义检索却完全搜不到”。

我排查后发现，罪魁祸首是原有的判定标准过于严苛。为了过滤噪声，旧的逻辑把大量相关的低分优质文档直接过滤掉了。这不仅导致搜不到，还引发了“混合搜索永久只生效关键词、语义检索完全失效”的严重问题。

修复方式很简单，也很有效：

  • 全链路统一优化检索阈值，放宽无效限制，只过滤完全不相关的噪声内容。
  • 延长语义搜索的响应等待时间，适配本地模型检索的真实运行速度。
  • 修复带横杠、特殊符号（如项目编号、专属命名）的文件搜索报错问题，支持各类常规特殊字符检索。

现在，图文+语义混合搜索能力终于满血回归，日常项目文件和特殊命名资料都能精准匹配。

:card_index_dividers: 插件生态：卸载数据留存，解决“重建索引之痛”

这是很多老用户期待已久的实用功能。之前卸载插件会直接清空所有向量索引和本地模型数据，而向量索引构建动辄需要数小时，重装后重新建索引非常耗时。

在 v0.5.20 中，我引入了全新的插件数据留存与恢复机制：

  • 自定义卸载规则：卸载确认弹窗中，默认是彻底清除（干净卸载），但可以手动勾选「保留向量数据与模型」。
  • 本地安全暂存：选择留存后，数据会安全保存在本机的 _retired 暂存区，不上传云端、无隐私风险。
  • 一键恢复：后续重新安装对应插件，软件会自动检测留存数据并支持一键恢复，秒级回到之前的使用状态。
  • 防污染、防误扫：留存数据会被系统隔离，不会被误识别为异常插件，也不会造成旧配置冲突。

:artist_palette: 细节优化与底层加固

  • 格式修复：彻底解决 AI 回复显示原始代码、Markdown 格式错乱的问题，问答内容排版整洁，引用来源正常展示，Nova 主题全面适配。
  • 界面细节：修复 Nova 主题侧边栏异常、状态栏隐藏问题；索引进度、版本状态常驻展示；优化首页背景和公告展示效果。
  • 插件操作统一：所有插件的「重启/重载/卸载」按钮位置统一，逻辑更规整。
  • 移动盘检索：优化 U 盘、移动硬盘文件检索逻辑，盘符变更后不会丢失搜索结果，并新增「移动盘/离线文件」标签。
  • 底层加固：优化向量存储服务异常提示与故障防护，完善全局错误码体系，修复插件重启、加载异常问题，避免静默失效。

:inbox_tray: 更新说明

  • 当前版本：v0.5.20
  • 更新方式：软件内直接检查更新，一键自动下载、安装、重启。
  • 数据安全：本次更新不覆盖、不删除用户本地知识库、自定义配置、个人文件，升级零风险。

这次更新全部围绕解决真实使用痛点，轻量化升级，老用户可直接无缝更新。如果你也在使用“寻迹”，欢迎随时反馈任何问题或建议，我会持续迭代优化！

3 个赞