docs-notes-retrieval

用途：为笔记库（Obsidian、Markdown 笔记本、NotebookLM 类导出）构建本地优先的检索与上下文打包流程，面向需要把笔记整理成 LLM 可用上下文的场景。主要能力：scan_vault.py 提供 inventory（路径、标题、frontmatter、wikilinks、标签、词数、mtime、入链数）、tags、orphans、broken-links 子命令，可输出 JSON 或 CSV；build_context_pack.py 支持按关键词或指定笔记选取，按状态过滤，按整篇/标题/段落分块，设定字符预算，保留冲突笔记并以冲突块并列呈现，脚注列出无法解析的 wikilink。用法示例：python scripts/scan_vault.py inventory /path/to/vault > vault-inventory.json；python scripts/build_context_pack.py /path/to/vault --query "weekly review" --max-chars 40000 > context-pack.md。笔记格式错误（非法 UTF-8 或 frontmatter 未闭合）时脚本以退出码 1 失败，可用 --allow-malformed 显式跳过。限制：v1 不涉及 NotebookLM API 自动化、默认不改写源笔记库、不处理 OCR 附件和无可导出路径的闭源应用；孤立笔记检测仅基于 wikilink 拓扑，按文件夹或标签组织的笔记库可能出现误报，应作为待查队列而非删除清单。冲突检测不识别正文层面的矛盾。