用途与定位：sense 是 sensemaking 提供的 CLI，用于在 Markdown 笔记树中定位证据。官方建议先查后读：用查询缩小范围，再读取返回的路径或行范围，而不是通篇读文件。
主要能力：按需求选择命令——精确计数、过滤、分组或已知字段报告用 sense sql 或保存的 SQL 查询；按主题找笔记用 sense search；查看单篇笔记的 frontmatter、大纲、链接与反向链接用 sense peek；查找两篇笔记间最短链接链用 sense path；查找某笔记未链接到的相似笔记用 sense related；了解树的形状与可用字段用 sense map。另有 sense status 查看配置、存储、缓存、文档数与预设覆盖，sense --list 列出已保存查询。
用法：配置默认 "build": true 时，查询会增量扫描所配置的树；"build": false 或加 --no-build 只读取上次完成的索引代，不扫描实时文件。搜索的 match、link、vector 三种信号由预设决定，score 仅在同次结果内排序。
范围与输出：--preset 选择预设，--include、--exclude、--no-exclude 调整单次查询范围；作用域只选结果，不构成安全边界。--format json 供代码或代理解析，--format csv 适合重定向大结果集。回显给自动化工具时应使用结构化格式。
限制与注意：缺失配置需谨慎运行 sense init，一次性查询不应擅改树；跨搜索不可比较 score，跨树不可套用固定 similarity 阈值；vector-only 行只是线索而非证据；scope 外的文件查询不到。表结构、存储方言与高级运算符需先读对应存储指南和共享 Sense 术语，预设之外的细节以实际配置为准。