mfs-find 用于在已注册到 MFS 的多类数据源中查找和读取内容。MFS 把本地目录、Postgres、GitHub 仓库、Slack 工作区、S3、BigQuery 等统一暴露为 <scheme>:// 路径树，并共用一个混合索引（稠密向量语义 + BM25 关键词，按查询融合）。
典型流程为 search → locate → browse：先用 mfs search "<query>" <path-or-uri> 检索候选，命中的 locator 指向具体单元（文本为 {"lines":[s,e]}，结构化记录为 PK 字典），再用 mfs cat --range 或 --locator 精确重开。搜索默认 hybrid，可用 --mode semantic（概念性查询）或 --mode keyword（精确词），并支持 --top-k、--all、--kind、--collapse。
浏览与读取命令包括 mfs ls、mfs tree、mfs cat（--peek 大纲、--skim 摘要、--meta 元信息）、mfs head/tail、mfs export。mfs grep 采用三级分派：结构化连接器下推、已索引对象走 BM25、未索引文件才线性扫描，因此它并非字面 grep；需要精确字节匹配时建议 export 后本地 rg。mfs search 需要索引，grep/ls/cat 等浏览命令无需索引。
使用前可先执行 mfs status、mfs connector inspect <uri>、mfs ls <uri> --json 确认服务与索引状态；若未注册数据源或需重新同步，应转用 mfs-ingest。搜索无结果时可按连接器状态、任务列表、逐对象 search_status 依次排查。
限制：不适合已知精确文件位置、已有明确文件清单或实时日志尾随等场景；索引状态可能为 building、partial 或 unavailable。具体连接器细节与错误码需查阅项目参考文档，本文未展开。