> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> 产品更新和公告

<Update label="2026-07-23" description="v0.9.0">
  🚀 **扫描版 PDF、图片里的文字，现在也能搜、也能被 AI 读了**

  💡 Tips：Linkly AI 升级了文字识别（OCR）引擎，扫描版 PDF 和图片会被逐页识别，并还原成Markdown 格式。历史以及存在的扫描版 PDF 会自动重新解析。

  🚀 新功能：

  * 新增 **扫描版 PDF / 图片文字识别（OCR）**：升级到全新 PP-OCRv6 引擎，中文 / 日文 / 英文识别精度大幅提升；扫描件会被还原成带标题、表格的结构化内容，可导出为 Markdown。
  * Linkly AI 自带 Chatbot 已支持 **引用云端知识库**：可直接 @ 已链接的云端知识库，与本地库一样检索。
  * 新增 **知识库标题**：知识库可设置真实的标题与简介，并在设置、启动器、Chatbot 各处统一显示。
  * 启动器新增 **按时间排序**：搜索结果可在原有筛选之外，按时间排序查看。
  * 首次引导完成后 **自动创建桌面快捷方式**（Windows 卸载时会一并移除）。
  * 增加数据体积压缩功能，升级后会自动压缩索引体积，减少磁盘占用，最高减少索引体积 80%。

  ⚡ 改进：

  * 优化 OCR、语音转写、向量嵌入等重计算任务对资源的使用，避免并行导致的卡顿与内存溢出。
  * 优化图片与 PDF 的提取，解析更加稳定。
  * 「重建索引」仅在后台长任务空闲时允许，避免相互干扰。

  🐛 Bug 修复：

  * 修复个别模型（如 Kimi）在 Chatbot 中可能出现的 **重复回答、丢失上一轮内容、工具被重复调用** 的问题；对话被中断时会明确提示中断原因。
  * 修复扫描版 PDF、图片在部分场景下未被识别、或识别结果不完整的若干问题。
  * 提升了索引升级与数据库迁移过程的稳定性，修复特定升级路径下新功能所需字段可能缺失的问题。
</Update>

<Update label="2026-07-13" description="v0.8.0">
  🚀 **你硬盘里吃灰的录音和视频，AI全能用了**

  💡 Tips：Linkly AI 新增本地语音转写能力，可将音频、视频中的说话内容转成文字并建立索引，让它们和文档一样可被搜索、可被 Chatbot 引用。全程在本机完成不会上传。在「设置 → 索引」中开启音频解析 / 视频解析即可使用。

  🚀 新功能：

  * 新增 **本地语音转写**：内建轻量转写模型，把音视频中的对话转为文本并索引，支持中文 / 粤语 / 英文 / 日文 / 韩文。
    * 音频支持 mp3、wav、m4a、flac、aac、ogg；视频支持 mp4、mov、mkv、webm
    * 音频解析与视频解析可分别开关，按需开启（转写较消耗资源）
  * 新增独立 **外观设置**：可调整主题，字体大小、macOS Dock 图标显示。
  * 新增 **云端知识库自动同步**：开启后可每 5 分钟检查并自动推送新内容到云端。
  * **Linkly AI 空间位置可更改**：可将默认空间目录，改到自定义位置（原「Linkly AI 文件夹」更名为「Linkly AI 空间」）。
  * 新增 **拖拽添加文件夹**：把文件夹直接拖到监听列表或知识库详情页即可添加。
  * Chatbot 新增 **下载回复**：可将 AI 回复整体或回复中的表格保存到下载目录。
  * Chatbot 侧边栏底部新增 **索引状态指示**：随时了解索引进度。

  ⚡ 改进：

  * Chatbot 会话标题改为收到消息后立即生成。
  * 启动器筛选新增「音频」「视频」文档类型。
  * 入门引导更换全新样例知识库。
  * 删除类确认对话框统一使用醒目的警示样式，降低误操作风险。
  * 官网：中文区新增支付宝 / 微信支付。
  * 知识库探索页支持一键收藏知识库，优化热度排序。
  * 优化了官网访问速度。

  🐛 Bug 修复：

  * 修复文件被高频改动时（如云盘同步目录）索引反复中断，导致长时间索引不完的问题。
  * 修复 Embedding 模型休眠卸载后，语义搜索失效的问题。
  * 修复 macOS 上安装更新时可能崩溃的问题：更新改为下次重启时安装；安装失败也会保留已下载的更新包，无需重新下载。
  * 修复 Free 用户查询云端知识库时被误判为 Pro 功能而遭拦截的问题。
  * 修复部分用户数据库字段缺失导致索引与云端推送静默失效的问题。
  * 修复知识库分享链接可能产生 404 / 308 跳转风暴的问题。
</Update>

<Update label="2026-07-06" description="v0.7.0">
  🚀 **Linkly AI Pro 计划发布！**

  💡 Tips：经过 4 个月的迭代，Linkly AI 现已发布 Pro 付费计划，提供更多的云端能力、更多的精选模型。

  🚀 新功能：

  * 新增 **官方模型配额**：可在Chatbot 和 Web Dashboard 中查看更详细的模型配额、剩余额度等。
  * 新增 **Free / Pro 模型权限**：Free 用户可继续使用基础模型，Pro 用户可陆续解锁 DeepSeek V4 Pro、Qwen3.7 Plus 等精选的前沿模型。
  * 云端知识库接入套餐配额：Pro 支持更多云端知识库、更高文件上限和更多调用额度。
  * 浏览器剪藏能力完成桌面端接收链路，浏览器扩展现可将网页内容直接保存到 Linkly AI 空间被索引。
  * Chatbot 侧边栏新增设置、官网和配额入口，常用操作更容易找到。
  * 云端知识库新增一键生成知识库简介

  ⚡ 改进：

  * 定价页和 Dashboard 更新 Pro 权益说明，补充模型、云端知识库、MCP 隧道等能力解释。
  * Web Dashboard 优化 API Key 创建入口、知识库筛选、收藏和连接状态展示。
  * 接受云端知识库邀请后，可直连到自己的 MCP 服务。
  * 改进索引与设置保存稳定性，减少重复重试、状态覆盖和配置不同步的问题。

  🐛 Bug 修复：

  * 修复托盘菜单在部分情况下可能崩溃或状态不同步的问题。
  * 修复 MCP 配置变更、端口刷新和本地服务状态相关的稳定性问题。
  * 修复索引器在删除、重试和扫描并发场景下可能异常中断或反复重试的问题。
  * 修复浏览器剪藏保存、删除和扫描过程中的若干边界问题，提升文件安全性与可靠性。
</Update>

<Update label="2026-07-01" description="v0.6.1">
  🚀 **云端知识库支持公开发布、筛选与收藏**

  🚀 新功能：

  * 云端知识库支持发布为「公开」与「Showcase」两种可见性，方便对外分享与展示
  * **「我的知识库」筛选**：可按来源筛选（全部 / 已连接 / 我的 / 共享 / 收藏），快速定位需要的知识库
  * 知识库支持**收藏**：一键将常用知识库标记为收藏，便于快速访问

  ⚡ 改进：

  * 接受云端知识库邀请后，页面就地引导**一键绑定**，无需再跳转到知识库页面
  * 改进账户登录流程的稳定性，修复偶发的登录无法完成的问题
</Update>

<Update label="2026-06-30" description="v0.6.0">
  🚀 **新增文档预览、EPUB 电子书与模型休眠，全新上手引导与账户登录**

  💡 Tips：

  * Linkly AI CLI 建议升级到 v0.5.1（新增 EPUB 支持）
  * linkly-ai-skills 建议更新到最新
  * MCP 工具描述有更新（新增 EPUB、云端库归属标记），接入的 AI 工具可重载 MCP 服务

  🚀 新功能：

  * 新增**账户登录**：通过浏览器一键登录 Linkly 云账户（OAuth 授权），无需再手动填写 API Key
  * 新增 **EPUB 电子书支持**：`.epub` 纳入全文检索与语义检索，AI 可通过 MCP/CLI 检索阅读；升级后已索引目录中的电子书会自动入库，无需手动操作
  * 新增**文档预览**：在 Launcher 与 Chatbot 工作区可直接预览文档内容，Markdown / HTML 支持「源码 / 渲染」一键切换
  * 全新**上手引导**：首次启动引导界面进行了重构，简化了流程，并自动准备多语言示例知识库
  * 新增**模型空闲休眠**：嵌入模型在空闲一段时间后自动卸载以释放内存，需要时自动唤醒，可在设置中开关

  ⚡ 改进：

  * 云端知识库在 MCP `list_libraries` / `explore` 中标注归属（`[yours]` 我的 / `[shared]` 共享），AI 区分库来源更清晰
  * Launcher 显示时预取嵌入模型，加快首次检索响应
  * Chatbot 错误提示按类型区分（登录 / 权限 / 模型），并修正回退模型的选择；登录后自动刷新可用模型列表

  🐛 Bug 修复：

  * 修复云同步目录（如 Synology、Dropbox 的临时文件）导致文件监听反复触发删除事件、刷出大量无用日志的问题
  * 修复部分情况下通过命令行集成 MCP 时，因环境变量（PATH）被截断而无法连接的问题
  * 修复设置页中索引数据占用大小显示不准确的问题
  * 修复在设置中手动重试索引后未重新开始的问题
</Update>

<Update label="2026-06-12" description="v0.5.1">
  📊 **新增 PowerPoint 文档支持；Chatbot 新增 @ 上下文与工作区**

  💡 Tips：

  * Linkly AI CLI 需升级到 v0.5.0（旧版 `--type pptx` 会被拒绝）
  * linkly-ai-skills 建议更新到最新
  * MCP 工具描述有更新，接入的 AI 工具可重载 MCP 服务

  🚀 新功能：

  * 新增 **PowerPoint 文档支持**：`.pptx` 进入全文检索与语义检索，并生成特制大纲索引，AI 可通过 MCP/CLI 检索阅读；升级后已索引目录中的 PPT 会自动入库，无需手动操作
  * Chatbot 新增\*\*@ 上下文\*\* 功能：输入 `@` 指定知识库/文件夹/文件，把 AI 的回答范围圈定到所选内容
  * Chatbot 新增**工作区**：自动聚合会话中引用过的文件，并支持文件预览、浏览知识库索引中的文件等
  * 新增统一的「云服务」设置页：统一管理客户端使用 LinklyAI 云服务的凭证
  * 修改 Chatbot 成为默认启动窗口

  ⚡ 改进：

  * MCP `search` 工具的 `path_glob` 改为**子串匹配**：@文件夹、完整路径可直接命中，Agent 检索文件夹更准确
  * MCP `find_paths` 直接返回可复用的 `path_glob`，Agent 搜索文件夹更方便
  * 长会话标题截断显示，并在 Chatbot 中展示 Launcher 快捷键
  * 快捷键设置页补充新增快捷键
  * Chatbot 界面多处细节打磨（会话列表滚动、来源列表样式、@ 选择器外观等）
  * 应用更新下载失败时自动重试，失败提示更友好
  * 新增**文件夹授权失效检测**（macOS）：应用更新后系统可能收回文件夹访问权限，导致新文件无法被索引；现在启动时会自动检测并弹窗引导，在系统窗口中确认一次即可恢复，无需删除重加文件夹；设置-文件夹中失权目录会显示 ⚠️ 标记

  🐛 Bug 修复：

  * 修复重建索引后 PDF 书签大纲可能丢失的问题
  * 修复偶发的云端知识库 MCP 隧道每两分钟断连重连的问题
  * 修复 macOS 上文件夹权限导致云端库推送失败的问题
  * 修复云端知识库索引大文档时内存溢出的问题
  * 修复 Chatbot 消息发送失败时输入内容丢失、错误不提示的问题
  * 修复部分文件预览无法打开、空文件预览无占位提示的问题
  * 修复旧版本聊天数据导致模型选择异常的问题（启动时自动修复）
  * 修复通知弹层挤压侧栏、分栏拖拽线偶发卡住等布局问题
  * 修复更新失败后「检查更新」按钮无响应、需重启应用才能恢复的问题
  * 修复个别文档含特殊字符时语义索引反复重试、空耗资源的问题
</Update>

<Update label="2026-06-05" description="v0.5.0">
  ☁️ **云端知识库来了 —— 本地库一键同步云端，24 小时在线，可分享**

  💡 Tips：

  * 首次使用云端知识库前，需先登录 Linkly 网页端设置用户名
  * Linkly AI CLI 需要升级到最新版
  * linkly-ai-skills 需要升级最新版
  * MCP 服务较大改动，您接入的 AI 工具可能需要重载 MCP

  🚀 新功能：

  * 新增 **云端知识库**：在设置中为任意本地库绑定一个云端库并推送，之后即使桌面客户端关机或离线，也能在网页端和外部 AI 工具中检索这些内容；公测期免费
  * 新增 **macOS 原生应用菜单**：包含 App / 编辑 / 窗口 / 帮助菜单等
  * 聊天工具会话列表新增状态标记：生成中、有未读消息一目了然
  * 聊天工具表格导出：AI 回复中的表格可一键导出 CSV / Markdown 到系统目录
  * 设置-文件夹，新增「打开所在目录」

  ⚡ 改进：

  * **聊天窗口焕新外观（macOS）**：系统原生毛玻璃，改进的题栏；窗口尺寸自动记忆；侧栏随窗口宽度自适应折叠
  * 全局右键菜单优化，聊天区可正常选中复制
  * 内置 Chatbot 回复优化：回复更流畅、简洁，格式更易阅读
  * Chatbot Stop 按钮优化，点击后即时停止
  * Chatbot 代码块 UI 渲染优化，更轻量美观
  * （MCP / 外部 AI 工具）`search` 结果直接返回值优化，兼容本地和云端知识库的文件路径

  🐛 Bug 修复：

  * 修复部分大模型参数生成不标准，导致 MCP 调用失败的问题
  * 修复表格全屏时窗口残留和无法拖拽的问题
  * 修复 Chatbot 消息因时间问题导致的保存失败问题
  * 修复点击 Stop 后台收尾的偶发竞态
  * 修复本地知识库名称校验不严格的问题
  * 修复文件夹文档计数在扫描 / 监听批处理后未刷新、显示过时的问题
  * 修复索引时瞬时删除事件可能导致误删的问题
</Update>

<Update label="2026-05-14" description="v0.4.1">
  🛠️ **MCP和 CLI 工具能力升级，检索能力进一步加强**

  💡 Tips：

  * Linkly AI CLI 需要升级
  * linkly-ai-skills 需要升级
  * 升级以后，你接入的 AI 工具可能需要重载 MCP 服务

  🚀 新功能：

  * 新增 MCP/CLI 工具 `find_paths`：按关键词模糊寻找真实文件夹，配合 `search` 工具的 `path_glob` 参数可以更精准的在意向目录里进行检索
  * MCP/CLI `search` 工具新增时间过滤和排序功能，支持"上个月的笔记"、"最新的文档"等模糊的时间范围查询
  * 开机自启新增「静默启动」模式：自启时窗口不再弹出，直接在后台运行

  ⚡ 改进：

  * 所有 MCP/CLI 工具响应附带当前时间戳（`_meta.now` / `[meta] now=`），LLM 可据此推算日期
  * MCP 工具入参校验加强，防止 LLM 拼错参数导致的工具调用异常
  * 内置 Chatbot 已学会使用 `find_paths` 定位路径再搜索文档
  * 优化了图片 OCR 过滤算法，改用像素形状分类器替代原有的文件大小判断，解决小图片无法索引的问题
  * 无法识别的图片不会再被 Chatbot 反复尝试读取，节省对话时间
  * 首次启动遇到环境问题时更宽容，更少出现初始化失败导致的崩溃

  🐛 Bug 修复：

  * 修复 `outline` 在无效分页或不存在 doc\_id 时静默吞错的问题
  * 修复 `search` 的 DB 错误被误报为 "Library not found" 的问题
  * 修复桌面端 UI 中文件"修改时间"在重建索引窗口期显示过期值的问题
  * 修复偶发情况下，新建或修改的文件未被自动检测到的问题
  * 修复扫描进行中点击「暂停索引」无效的问题
  * 修复重命名文件后搜索结果未及时更新的问题
  * 修复频繁切换库或重建索引时，搜索结果偶发异常的问题
  * 修复 Windows 开机自启偶尔不生效的问题
  * 修复数据库优化失败的问题
  * 修复 `find_paths` 工具在跨库查询时可能返回错误结果的问题
  * 修复 `search` 按日期过滤时，结束日期当天的文件未被包含的问题
  * 修复按时间排序时部分较新文件未排在前面的问题
  * 修复旧版本 MCP 客户端连接新版桌面端时偶发报错的问题
</Update>

<Update label="2026-05-06" description="v0.4.0">
  🤖 **Chatbot 上线，直接与你的本地文件对话！**

  🚀 新功能：

  * 发布 **Linkly AI Chat** ，在 Linkly AI 内直接与你的本地文件对话，无需集成或者安装第三方 Agent 也能使用 LinklyAI
  * Linkly AI Chat 多 Provider 支持：内置 Linkly Official，并可自由配置 OpenAI、Anthropic、DeepSeek、Ollama 等多个 Provider
  * 设置界面新增 **数据隐私面板**，集中透明的管理用户本地据流向
  * 新增显示完整文件路径开关：默认在 MCP 工具结果与 CLI 输出中隐藏完整路径以保护隐私，现可自行选择显示
  * 发布 Linkly Official 模型精选服务，并提供 Qwen 3.5 Flash 和 DeepSeek V4 Flash 两个试用模型
  * 新增应用内 Changelog ：从启动器查看更新日志，无需再跳转网页
  * AI 设置中显示本地模型下载进度和状态
  * 启动器新增「固定」按钮：开启后失焦或点击外部不再自动关闭
  * 桌面客户端新增日语、法语、西班牙语支持
  * 新增 MDX 文件支持：博客与技术文档常用的 .mdx 文件现已可被索引和搜索

  🐛 Bug 修复：

  * 修复部分网络环境下模型下载失败、导致无法完成索引的问题
  * 修复设置页面滚动条与内容重叠的显示问题
  * 修复 Launcher 中条目选中状态偶发漂移、不稳定的问题
  * 修复多个导致 Windows 客户端崩溃和假死的问题
  * 修复一键集成 Claude Desktop 失败的问题；首次集成时若未安装 Linkly CLI，会自动引导一键安装
</Update>

<Update label="2026-04-20" description="v0.3.5">
  * \[优化] 实现 Windows User Path 环境变量的备份功能，防止破坏用户注册表后无法恢复
  * \[Bug] 修复 Windows 下一键配置 Linkly CLI 时可能清空用户 User PATH 环境变量的问题，仅 0.3.4 版本可能受影响
</Update>

<Update label="2026-04-17" description="v0.3.4">
  * \[新功能] 新增 Integrations 设置页面，一键把 Linkly AI 配置到 Claude Code、Cursor、Codex、Cherry Studio 等 MCP 客户端
  * \[新功能] 新增 Linkly CLI 一键安装器：自动下载并配置 PATH，无需手动命令行操作
  * \[新功能] 新增 Linkly Skills 一键下载，快速将 Linkly 搜索能力集成到支持 Agent Skills 的客户端
  * \[新功能] 侧边栏导航增加 NEW 徽章，帮助发现新功能
  * \[新功能] 重写首次启动的 MCP 集成引导步骤，并完成界面国际化
  * \[改进] 统一 Integrations 与 MCP 相关设置的图标风格
  * \[Bug] 修复 macOS 关闭应用时资源清理的时机问题
  * \[Bug] 修复窗口内跳转页面时窗口被意外重新定位的问题
  * \[Bug] 修复设置窗口内无法打开外部链接/对话框的问题
  * \[Bug] 修复 Codex 图标显示以及侧边栏布局的细节问题
</Update>

<Update label="2026-04-09" description="v0.3.3">
  * \[新功能] 支持添加 NAS 和外置硬盘中的目录到知识库，暂时只支持 Windows 和 macOS
  * \[新功能] 支持升级 Linkly AI Pro 计划，提前锁定早鸟价格，抢先体验更多云端服务
  * \[Bug] 修复隐藏窗口触发 UI 冻结检测的问题
</Update>

<Update label="2026-04-02" description="v0.3.2">
  * \[新功能] 新增文件名快速索引：添加目录后，秒级完成索引，可立即搜索文件名，无需等待全文索引完成
  * \[新功能] 新增索引性能模式控制：支持自动、性能模式和均衡模式三种
  * \[新功能] 新增省电模式：打开后，在使用电池供电的时候，会停止高耗电任务
  * \[新功能] 新增语义搜索和 OCR 的独立开关
  * \[新功能] 添加文件夹时支持一次选择多个文件夹
  * \[新功能] 新增开发版体验计划，可在设置 > 关于中开启，提前体验新功能
  * \[改进] 优化索引状态页四种索引的进度和状态显示
  * \[改进] 智能索引顺序：优先索引纯文本、Markdown 等轻量格式
  * \[改进] 增大设置窗口默认尺寸，以方便查看更多设置
  * \[Bug] 修复移除监听文件夹时未检查知识库引用导致的误删问题
  * \[Bug] 修复索引文件时偶发的界面卡死问题
  * \[Bug] 修复索引统计图排序不稳定问题
</Update>

<Update label="2026-03-31" description="v0.3.1">
  * \[改进] 图片 OCR 优化：优化 OCR 对资源的占用，减少无意义的 OCR，优化过大图片的 OCR 流程
  * \[Bug] 修复 Windows 上首次索引大量高分辨率图片时应用假死的问题
  * \[Bug] 修复 Windows 上快捷键设置面板无法录入 Alt+Space 等组合键的问题
  * \[Bug] 修复 Windows 上快捷键被其他程序占用时显示不友好错误信息的问题
</Update>

<Update label="2026-03-30" description="v0.3.0">
  📚 **知识库功能上线！用知识库管理文档，在特定领域更精准的检索。**

  <Note>
    本次升级会更新已有索引结构，更新过程中搜索结果可能不准确，请等待更新完成后继续使用。
  </Note>

  🚀 新功能：

  * \[Desktop] 知识库管理 — 在设置中创建、编辑、删除知识库，将文件夹组织为命名知识库进行管理，[查看指南](./use-libraries)
  * \[Desktop] 知识库搜索 — 启动器中输入 `@` 进入知识库范围搜索，精确定位特定知识库中的文档；Backspace 退出知识库范围
  * \[Desktop] 文档类型过滤 — 搜索结果包含多种类型时自动显示过滤面板，`Cmd/Ctrl+↑/↓` 快速切换
  * \[Desktop] 搜索结果高亮与路径优化 — 标题和路径关键词高亮，路径智能缩略显示，打开文件改为在文件管理器中定位
  * \[MCP] 新增 `list_libraries`，用于列出所有知识库，可在搜索等工具中使用
  * \[MCP] 新增 `explore` 概览工具 — AI Agent 可快速了解文档或指定知识库的主题分布、目录结构和高频关键词等信息
  * \[MCP] `search` 工具支持 `library` 和 `path_glob` 过滤参数
  * \[CLI] 新增 `list-libraries` 和 `explore` 命令
  * \[CLI] `search` 支持 `--library` 和 `--path-glob` 参数
  * \[CLI] 新增 `linkly doctor` 诊断命令，帮助 AI Agent 自主排查问题
  * \[Skills] 新增知识库支持和问题排查指南，方便 Agent 自行搜索知识库并排查常见问题
  * \[Skills] 新增对 `list-libraries` 和 `explore` 的使用说明
  * \[Web] Dashboard 新增用户名设置，用于云端知识库命名空间

  ✨ 改进：

  * \[Desktop] 搜索工具展示的结果从 20 提升至 100 条
  * \[Desktop] 增加搜索结果缓存，相同关键词短时间内再次搜索时即时返回，体验更流畅
  * \[Desktop] 改进了报错提示，更加明确
  * \[Desktop] 优化托盘菜单状态刷新，减少频繁刷新导致菜单意外关闭
  * \[Desktop] 启动器底部快捷键提示支持折叠，减少视觉干扰
  * \[Desktop] 改善关键词提取质量，自动过滤 URL、文件路径等噪声文本
  * \[CLI] 增加 30 秒连接超时和 60 秒工具调用超时，防止 Agent 调用时进程挂起
  * \[CLI] 错误信息改进，连接失败时给出排查建议和 `linkly doctor` 引导

  🐛 Bug 修复：

  * \[Desktop] 修复设置面板偶尔显示为英文的问题
  * \[Desktop] 修复搜索时短暂闪现"未找到结果"的问题
  * \[Desktop] 修复 DOCX 文档中标题无法正确提取为 Markdown 格式的问题
  * \[Desktop] 修复部分文档（CSV、OCR 进行中的图片）无法预览的问题
  * \[Desktop] 修复 Windows/Linux 上搜索框和引导页缺少边框的问题
  * \[Desktop] 修复搜索结果中标题和路径文字溢出问题
  * \[MCP] 修复隧道偶尔出现的请求超时或无响应问题
  * \[CLI] 修复在某些自定义端口配置下无法连接的问题
</Update>

<Update label="2026-03-21" description="v0.2.4">
  * \[Bug] 修复 Windows 冷启动时 launcher 无法弹出或启动后卡死的问题
  * \[Bug] 修复 Windows 托盘图标启动时短暂显示为旧图标的问题
  * \[改进] MCP 设置页面文案优化，新增集成相关链接
  * \[改进] Onboarding 流程中"使用方式"步骤现在要求明确选择后才能继续
</Update>

<Update label="2026-03-19" description="v0.2.3">
  * \[改进] OCR 图片识别性能大幅提升：自动跳过小图标和缩略图，高分辨率图片处理速度提升约 3 倍，降低了 CPU 占用过高问题
  * \[改进] 搜索结果质量改善：无文字内容的图片不再占据搜索结果位，语义搜索更精准
  * \[Bug] 修复 OCR 模型加载完成后，待索引图片可能不被处理的问题
  * \[Bug] 修复 CLI 在部分 OpenClaw 宿主 Linux 系统上因 GLIBC 版本不兼容导致无法运行的问题
</Update>

<Update label="2026-03-19" description="v0.2.2">
  🎉 **Linkly AI 现在可以识别图片中的文字了！**

  🚀 新功能：

  * 新增本地 OCR 支持 — 自动识别 PNG、JPG、BMP、WEBP 图片中的文字并建立索引，支持中英日及拉丁语系
  * 全新 Onboarding 引导流程，打字机风格的对话式体验
  * 新增快捷键设置页面，展示所有键盘快捷键
  * 更新后首次启动自动弹出系统通知，Launcher 中显示更新横幅，可快速查看变更日志
  * 关于页面新增 Changelog 入口链接

  ✨ 改进：

  * 远程隧道连接稳定性提升，断线后自动重连
  * Windows/Linux 托盘图标改用彩色品牌图标
  * CLI 搜索过滤器新增 image 文档类型支持

  🐛 Bug 修复：

  * 修复退出应用时 Metal GPU 断言失败导致的崩溃（macOS）
  * 修复部分文档标题显示异常的问题
</Update>

<Update label="2026-03-14" description="v0.2.1">
  * \[Bug] 修复 Windows 系统上窗口边缘出现灰色边框的视觉问题
  * \[Bug] 修复远程隧道后端自动重连后，界面开关状态未同步的问题
  * \[Bug] 修复 CLI 在 `--remote` 模式下健康检测使用了错误端点的问题
</Update>

<Update label="2026-03-12" description="v0.2.0">
  🚀 **重要的更新，LinklyAI 现在可以在公网上被安全的使用了！**

  🚀 新功能：

  * 客户端 MCP 支持[远程连接](./use-in-remote)：可在 ChatGPT、Claude、OpenClaw 等云端 AI 助手和 Agent 中直接访问本地知识库
  * 客户端 MCP 支持[局域网连接](./use-in-remote)：在局域网内分享 MCP 知识库服务，方便多设备和 Agent 调用
  * CLI 新增[远程模式](./use-cli)：通过 `linkly auth` 和 `--remote` 参数，从任意电脑连接到您的知识库，方便 Agent 调用
  * 文档站新增常用 AI 工具集成指南，包括 [ChatGPT](./integration/use-in-chatgpt)、[Claude](./integration/use-in-claude)、[Cursor](./integration/use-in-cursor)、[Windsurf](./integration/use-in-windsurf)、[GitHub Copilot](./integration/use-in-github-copilot)、[OpenClaw](./integration/use-in-openclaw)、[n8n](./integration/use-in-n8n)、[Raycast](./integration/use-in-raycast) 等
  * Web Dashboard 新增隧道创建、远程调用统计面板

  ✨ 改进：

  * 索引进度条增加 shimmer 动画效果
  * 索引进度按搜索类型（关键词/自然语言）分别显示
  * 关闭向量搜索时跳过嵌入模型预热，加快启动速度
  * 设置页面 MCP 配置区域重新设计为可折叠卡片布局

  🐛 Bug 修复：

  * 修复文档删除后缓存一致性和空间不释放问题
  * 修复搜索结果中出现已删除文档的幽灵记录
  * 修复缓存缺失时文档读取长时间加载（改为后台静默修复，下次搜索自动恢复）
  * 修复切换监控目录后，旧索引任务未中断的问题
  * 修复设置页面内容区域布局抖动
  * 修复 Windows 平台快捷键错误，应使用 Ctrl 键而非 Win 键
  * 修复 Windows 安装后启动报 "找不到 VCOMP140.DLL，无法继续执行代码" 错误，安装程序现已自动安装 VC++ 运行时依赖
</Update>

<Update label="2026-03-10" description="v0.1.11">
  * \[新功能] 搜索结果自动去重：相同文件名和大小的重复结果将被合并，搜索结果更清晰
  * \[改进] 优化索引处理速度，减少索引期间的资源占用
  * \[改进] 简化托盘菜单索引状态显示，新增「查看索引」快捷入口
</Update>

<Update label="2026-03-09" description="v0.1.10">
  * \[新功能] MCP 和 CLI 新增 [grep 工具](./tools-intro#正则匹配grep)，支持在文档内通过正则表达式精确定位文本行 — AI Agent 无需逐页阅读即可快速找到目标内容，大幅减少工具调用次数和上下文消耗
  * \[新功能] CLI 新增 [Homebrew 和 crates.io](./use-cli#安装) 安装方式
</Update>

<Update label="2026-03-06" description="v0.1.9">
  * \[新功能] 新增索引管理页面，支持查看索引统计信息和一键重建索引
  * \[新功能] MCP 设置页面新增 CLI 和 Skills 快捷链接
  * \[新功能] 新增匿名使用数据收集功能，支持在设置中自由开关（隐私优先，默认需用户同意）
  * \[改进] 统一托盘和设置页面的索引进度显示
  * \[Bug] 修复删除文档后索引和提取缓存未清理的问题
  * \[Bug] 修复 Windows/Linux 上 PDF 索引失败的问题
  * \[Bug] 修复 Windows 上启动时 Launcher 窗口不显示的问题
  * \[Bug] 修复跨平台快捷键不一致的问题
  * \[Bug] 修复官网 x86\_64 架构的下载链接错误
  * \[Bug] 修复官网页头和页脚的错误链接
</Update>

<Update label="2026-03-05" description="v0.1.8">
  * \[新功能] 新增 macOS Intel (x64) 构建 — Intel Mac 用户现在可以下载和使用 Linkly AI
  * \[Bug] 修复文件监听器检测到变更后未触发索引流水线的问题，改进目录删除处理
</Update>

<Update label="2026-03-03" description="v0.1.7">
  * \[新功能] 发布 [Linkly AI Skills](./use-skills)，AI 助理可以更好的利用 Linkly AI 的工具流
  * \[新功能] 发布 [Linkly AI CLI](./use-cli) 工具，AI 助理可以直接调用 CLI 完成文档检索和阅读
  * \[新功能] CLI 支持自动发现和连接应用
  * \[改进] MCP 工具新增结构化输出格式
  * \[Bug] 修复 Windows 上拖拽窗口时意外关闭的问题
</Update>

<Update label="2026-03-03" description="v0.1.6">
  * \[Bug] 修复 Windows 上透明窗口和窗口拖拽的兼容性问题
</Update>

<Update label="2026-02-13" description="v0.1.5">
  * \[新功能] 全新 4 步引导向导，包含权限检查，首次使用体验更流畅
  * \[新功能] 新增复制文件路径快捷键
  * \[新功能] 支持控制 macOS Dock 图标显示
  * \[改进] MCP 大纲工具支持树形格式输出，AI 可以更好地理解文档结构
  * \[改进] 改进 PDF 大纲提取准确率
  * \[改进] 托盘菜单支持多语言
  * \[改进] 优化索引性能，降低资源占用
</Update>

<Update label="2026-02-11" description="v0.1.4">
  * \[改进] MCP 工具描述优化，AI 调用更准确
  * \[改进] 搜索结果分数以百分比展示，更直观
  * \[Bug] 修复中日韩文本的标题误检测问题
  * \[Bug] 改善多显示器环境下的窗口定位
</Update>

<Update label="2026-02-10" description="v0.1.3">
  * \[新功能] 新增 MCP 服务器，AI 助理可以直接检索和阅读你的本地文档
  * \[新功能] 支持关键词搜索和语义搜索的混合模式，搜索结果更全面
  * \[新功能] 新增文档大纲提取
  * \[新功能] 新增多语言支持
  * \[新功能] 支持自定义全局快捷键
  * \[改进] 升级语义搜索引擎，搜索质量提升
  * \[改进] 优化中文分词和关键词提取质量
</Update>

<Update label="2026-02-07" description="v0.1.2">
  * \[新功能] 新增全文搜索引擎，支持搜索 PDF、Word 等文档的正文内容
  * \[新功能] 启动器接入搜索，支持结果预览
  * \[改进] 重新设计搜索结果布局
  * \[改进] 窗口主题自动跟随应用设置
</Update>

<Update label="2026-02-07" description="v0.1.1">
  Linkly AI Desktop 的第一个可用版本，支持 macOS、Windows 和 Linux。

  * \[新功能] 自动扫描指定目录，建立文件索引，支持增量同步
  * \[新功能] 全新的启动器界面，全局快捷键快速唤起
  * \[新功能] 内置自动更新，通过托盘菜单提示新版本
  * \[新功能] 支持常规设置和文件夹管理
</Update>
