用途：use-loci 用于在回答依赖开发者技术文档事实的问题时，按需发现、获取、同步、搜索和阅读文档。适用问题包括库、框架、SDK、API、CLI、配置、迁移、版本差异、安装过程或技术专属错误。新闻、价格、人物、购物、法律、医疗和普通网页内容不属于其职责。
主要能力：提供 Loci MCP 工具，包含 loci_list_libraries、loci_list_cloud_libraries、loci_pull_cloud_library、loci_add_library、loci_get_library_tree、loci_search_files、loci_read_files、loci_sync_libraries、loci_get_sync_status、loci_list_sync_failures。支持本地库查询、只读云端目录查询、按用户确认拉取云端快照、按官方入口新增抓取、目录浏览、按语言搜索正文、按 section_id 阅读完整小节、同步已有网页文档库并查看同步失败详情。
使用方式：先从用户问题和当前项目中识别相关技术及版本；调用 loci_list_libraries 查本地库，usable 时查看浅层目录树并读取目标文件或搜索正文；无可用本地库时查云端目录，存在 pages>0 匹配项并经确认后拉取；云端不可用或用户不选择拉取时，确认官方入口并经同意后调用 loci_add_library 建库抓取。搜索关键词优先使用 API 名称、配置键、命令和错误原文，API、类名、函数名、命令和错误不翻译；概念性关键词按目录树 languages 对应语言书写，queries 一次传 1–10 组。获得足够证据后停止检索，回答附 source_url，并区分文档事实与推断。
适用场景：依赖外部技术当前行为的文档问答、版本差异核对、配置与迁移说明、CLI/API 用法查询。
限制：云端拉取、新增抓取和主动同步会修改本地状态并访问外部服务，需用户确认；已明确要求的操作无需重复确认。只添加无需登录的公开 HTTP/HTTPS 文档，不提供账号、Cookie、Token、验证码或 Cloudflare 绕过方案，不添加依赖 Fragment 的 Hash Router 文档站。不主动添加第三方镜像。有官方来源时不轻易切换其他文档来源；本地或云端未命中不构成切换条件。updated_at 只代表本地缓存新鲜度，不等同于版本适用。本地内容可用时即使云端不可访问也继续使用并说明可能不是最新。跨进程同步由文档源锁阻止重复写入，同步状态为 syncing 时跟随已有任务。不宣称官方文档能完全消除错误或幻觉。