Obsidian 插件：Documents Activity Tracker

概述

Documents Activity Tracker 旨在解决 Obsidian 用户难以量化阅读投入的问题，通过自动记录每个文档的阅读时长，并区分窗口内与脱离窗口的状态，提供精准的时间统计。除了文档追踪，它还内置了独立的手动秒表与倒计时功能，所有数据均存储于 SQLite 数据库中，确保记录的持久性与查询效率，帮助用户清晰掌握知识管理过程中的时间分布。

典型场景包括深度阅读长文时，插件能自动累计有效阅读时间，排除后台或锁屏期间的无效时长；若需进行专注工作，可启动独立的番茄钟或自定义倒计时，结束后自动记录专注时长。例如，你在阅读一篇技术文章时切换去回复消息，插件会准确标记这段离开时间，而不会将其计入阅读时长，从而保证统计数据的真实性。

相比同类插件，其特色在于“四轨总热力图”与精细的状态管理。它能将文档阅读、插件视图、手动计时与倒计时在同一时间轴上独立展示，且支持毫秒级精度。特别值得注意的是，它引入了“空闲通道”，将超时未操作的时间单独记账而非直接丢弃，避免了传统插件中因空闲导致的数据断层，让时间统计更加完整和透明。

使用前需注意，该插件重构后不再迁移旧版 JSON 数据，新库从空开始记录，适合愿意从零开始追踪的用户。它不适合需要复杂报表导出或跨设备同步历史数据的场景，因为数据主要服务于本地回顾。此外，若你主要使用移动端，需留意其后台结算机制，确保在锁屏或后台时能正确停止计时，以获得最准确的阅读时长统计。