Linkly AI 是一款面向文档的搜索与阅读工具，帮助用户在本地文件与已关联的云端文档库之间进行检索、浏览、阅读和记录笔记。
【用途】 Linkly AI 索引用户本地机器上的文档，涵盖 PDF、Markdown、Excel、CSV、DOCX、TXT、PPTX、DOC、RTF、EPUB、HTML、图片、音频、视频等格式，同时可访问用户通过 Linkly Web 关联的云端文档库。它通过“搜索 → grep 或大纲 → 阅读”的渐进式披露工作流暴露这些内容，并可捕获和列出用户的本地 Markdown 笔记。
【主要能力】
- 文档搜索：使用 BM25 + 向量混合检索，支持关键词与自然语言查询，可按类型、库、路径、时间范围过滤。
- 容器枚举：通过 list 完整分页枚举已知文件夹、库或笔记，不依赖相关性排序。
- 路径查找：find_paths 将模糊的容器名称（如“微信”“Notion 笔记”）转换为真实磁盘路径或云端库引用。
- 结构导航：outline 获取文档结构概览，grep 在已知文档内做正则匹配，read 按行号分页读取内容。
- 笔记：note_save 保存笔记，list 与 search 可通过 scope="notes" 访问用户笔记。
- 云端库管理：云端网关额外提供 library_search 与 library_link 工具，用于发现、关联和解除关联云端库。
【使用方式】 Linkly AI 提供 CLI 与 MCP 两条独立接入路径。
- CLI：若 Bash 可用，运行 linkly --version 检查安装，再运行 linkly doctor 检查本机 Desktop、远程网关和局域网 Desktop 的连通性。CLI 有三种连接模式：本地（默认，通过 ~/.linkly/port 自动发现桌面应用）、局域网（--lan，需先用 linkly auth set-key <token> --lan --endpoint <url> 保存地址与令牌）、远程（--remote，通过 https://mcp.linkly.ai 网关，需先 linkly auth login 或 linkly auth set-key <api-key>）。每次 CLI 调用应传入 --client <应用名> 以便在本地访问日志中标识来源。
- MCP：检查当前环境是否可访问 search、find_paths、list、outline、grep、read、list_libraries、explore、note_save 这九个工具。linkly-ai 服务器（本地 Desktop MCP）暴露这九个；linkly-ai-cloud 服务器（mcp.linkly.ai 云网关）额外暴露 library_search 和 library_link 两个云端专用工具。
- 模式选择：CLI 可达且 MCP 可用时优先 CLI；仅 CLI 可达时用 CLI；CLI 不可达但有 MCP 时用 MCP；两者都未安装时，若 Bash 可用且 linkly --version 失败，建议安装 CLI，否则告知用户需要 CLI 或 MCP 集成。
【连接范围】 连接模式决定可见内容，任何工具调用都无法跨越该边界。本地（linkly 默认）或局域网（--lan）连接只能访问用户本地索引内容，云端库不可达，cloud:// 引用会被拒绝。云网关（linkly --remote 或 linkly-ai-cloud MCP）可同时访问本地内容（通过桌面隧道）和已关联的云端库。云端库目录及关联/解除关联操作仅在云网关提供。笔记是本地文件，无云端对应，note_save、scope="notes" 的 list 和 search 始终指向 Desktop，需要 Desktop 在线（通过隧道时还需 Pro），且不可与 library 参数同时使用。
【适用场景】
- 用户询问“关于某主题有什么内容”时进行内容搜索。
- 用户询问“某文件夹/库/笔记里有什么”时进行容器枚举。
- 用户用模糊词指代容器时先定位真实路径。
- 在已知文档内查找特定文本、名称、日期或标识符。
- 阅读长文档前先获取结构大纲，再按行范围精读。
- 保存和检索用户的本地 Markdown 笔记。
【限制】
- 本地/局域网连接无法访问云端库，需切换连接。
- 笔记功能需要 Desktop 在线，无云端回退。
- 云端库搜索若带路径、类型或时间过滤，会降级为仅关键词排序。
- 单次 outline 调用不能混合本地 ID 与云端 ID。
- 若使用时间过滤但响应缺少 [meta] now= 或 _meta.now 字段，说明桌面应用低于 v0.4.1 且静默丢弃了过滤条件。
- 具体收费、价格、平台支持等细节暂未提供。