Overview
dsh-lost-and-found
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
**已知限制** - 索引只覆盖你配置的目录;目录之外的文件只能靠实时兜底扫描按名字/时间找到,搜不到内容。 - **正文与摘要抽取尚未启用**:`summary` / `excerpt` 字段目前不会被写入,所以「按文档内容找」还不成立(图片描述是走通的)。设置页的档位名与本节描述以此为准。 - 一个目录一天最多真扫一次(`intervalDays`);刚下载的文件可能还没进索引——此时用兜底扫描或 `file_index_scan`。 - 文件「出现时间」取 `birthtime` 与 `mtime` 的较大值;被网盘/同步工具改写过的 `mtime` 会让时间维度失真。 - 暂不支持:视频/音频内容理解、压缩包内文件、全文检索服务。 **路线图** 1. **内容索引 P0(零模型成本)**:本地抽取文本/Office/PDF 正文,图片元数据与描述入库,检索同时搜文件名与内容,并标注「命中文件名 / 命中内容」。 2. **图片内容 P1**:按价值排序的看图队列,批量看图写回描述;名字与内容明显不符的单独出报告(**只给建议名,绝不改名**)。 3. **语义检索 P2**:本地 BM25 / 字符 n-gram,解决「记不清词只记得大概意思」。 设计细节见 [`docs/内容索引与文件名脱钩-方案.md`](https://github.com/wangzhanchao883/dsh-lost-and-found/blob/main/docs/%E5%86%85%E5%AE%B9%E7%B4%A2%E5%BC%95%E4%B8%8E%E6%96%87%E4%BB%B6%E5%90%8D%E8%84%B1%E9%92%A9-%E6%96%B9%E6%A1%88.md)。
