OneMore插件Hashtag索引功能故障排查指南

OneMore插件Hashtag索引功能故障排查指南

OneMore A OneNote add-in with simple, yet powerful and useful features 项目地址: https://gitcode.com/gh_mirrors/on/OneMore

OneNote插件OneMore的Hashtag索引功能是一项强大的标签管理工具，但在使用过程中可能会遇到索引不更新的情况。本文将详细介绍如何诊断和解决这类问题。

常见症状表现

当Hashtag索引功能出现异常时，用户通常会观察到以下现象：

1. 搜索标签时无法显示任何结果
2. 日志中持续显示"hashtag service waiting, Scanning"状态
3. 界面显示的"Last Scan"时间与实际不符
4. 即使等待较长时间(如8小时以上)，索引仍无进展

根本原因分析

这种情况通常是由于索引服务进入了异常状态导致的，可能的原因包括：

1. 系统休眠中断了索引过程
2. 索引数据库文件损坏
3. 索引状态文件出现异常

解决方案

初级解决方案

1. 关闭OneNote应用程序
2. 删除位于%appdata%\OneMore\目录下的HashtagScanner.json文件
3. 重新启动OneNote
4. 在OneMore设置中重新安排扫描或直接搜索标签

高级解决方案（适用于复杂情况）

如果上述方法无效，可以尝试更彻底的修复：

1. 完全关闭OneNote
2. 删除%appdata%\OneMore\OneMore.db文件
3. 重新启动OneNote，让系统重建完整的标签目录

性能说明

正常情况下，OneMore处理3000页5个笔记本的标签索引应该只需要几分钟时间。如果耗时明显超过这个范围，就表明索引过程出现了问题。

注意事项

1. 界面显示的"Last scan"状态目前不反映计划扫描的进度，仅显示常规扫描状态
2. 系统休眠可能会中断索引过程，建议在重要索引期间保持系统唤醒状态
3. 对于大型笔记本集合，建议定期维护索引数据库

通过以上方法，大多数Hashtag索引问题都能得到有效解决。如果问题仍然存在，可以考虑检查日志文件获取更详细的错误信息。

OneMore A OneNote add-in with simple, yet powerful and useful features 项目地址: https://gitcode.com/gh_mirrors/on/OneMore