用途：在 Paperless-ngx 文档归档中检索文档，基于其 REST API 完成全文搜索与元数据筛选，并生成文档链接。
主要能力：全文搜索（query）；按通信人（correspondent__id）、标签（tags__id__all）、文档类型（document_type__id）、创建日期区间（created__date__gte/lte）筛选；排序（ordering）、分页（page_size）。可获取单篇文档的完整 OCR 内容，并列出标签、通信人、文档类型等元数据。
用法：配置文件位于 ~/.config/paperless-search/config.json，包含 url 与 token。Token 在 Paperless Web UI 右上角用户菜单的 My Profile 中点击循环箭头按钮生成或重新生成。请求需带 Authorization: Token 头。文档链接使用配置中的 base URL 拼接 /documents/{id}/details，不要硬编码或猜测 URL。
常见问题：401 Unauthorized 表示 Token 无效或过期，需重新生成；Connection refused 表示 URL 错误或服务未运行；返回 null 或解析错误表示配置文件缺失或格式损坏。配置损坏时，需让用户提供 Paperless-ngx URL 与有效 API Token，再创建或更新配置文件。
限制：依赖可访问的 Paperless-ngx 服务与有效 API Token；资料未提供速率限制、权限范围等其它约束。