> ## 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.

# 更新日志

> 产品更新和公告

**2026-11-11**

v1.5.0

🎉 重磅功能：

1. 新增 AI 作品自动收集和备份功能，让你的 AI 产物从此一处管理。
2. 新增隐私数据防护和桌面宠物，Agent 访问你本地敏感数据从此无处遁形。

🚀 新功能：

* 新增「作品」功能，自动收集 Claude Desktop、ChatGPT（Codex）在本地生成的文档、HTML 等文件，并备份到资料库，让 AI 作品一处管理。
* 新增隐私数据防护功能，监控 AI Agent 对敏感数据的访问；隐藏本地超 200 种敏感信息的读取，降低敏感泄露的风险。
* 新增桌面宠物，提供 Watchdog 和 Folder 两种外观，可在 AI 访问敏感数据时进行提醒，快速打开应用等。
* \[Web] 新增远程 MCP 异常访问邮件提醒。

⚡ 改进：

* 提升长文档的语义索引准确度，并为受影响文档安排重新索引；文档较多时，可选择立即优化或在空闲时处理。
* 优化云端模型和服务的月度配额及重置时间，所有用户将在 11 月 11 日免费获得一次配额重置。
* \[Web] 加强云端 API Key 的安全保护。

🐛 Bug 修复：

* 修复增强排序返回未经模型判断的结果的问题。
* 改善增强排序连接稳定性，修复 HTTP/2 连接保活问题。
* 修复部分恢复码及包含 emoji 的敏感内容识别不完整的问题，并收紧脱敏时的关键词和文本范围查询处理。
* 修正法语界面中设置页面的名称。

**2026-11-04**

v1.4.0

🚀 新功能：

* 新增 [增强排序（Jev）](https://linkly.ai/docs/zh/tools-intro.md#增强排序)（Pro）：由云端决策模型，逐条判断搜索结果是否相关并重新排序，可以自动过滤无关结果；AI 助理通过 MCP、CLI 搜索时也能自动启用。
* 支持云端 OCR（Pro）：在「设置 → AI 模型 → OCR 模型」中切换为云端识别。
* 配置自定义 AI 提供商时，可以点「测试」检查可用性。
* 资料库侧栏中，右键文件夹可以「固定为常用目录」。
* \[CLI] `linkly search --scope annotations` 可以只搜索剪藏批注，`linkly read --annotations-offset` 可以翻页读取批注。
* \[CLI] `linkly mcp` 模式下，`read` 工具的 `include_image` 可以把图片交给 AI 助理读取。

⚡ 改进：

* 「设置 → 搜索」新增「最大返回结果数」设置，对找资料和启动器都生效。
* 剪藏批注面板中，点击批注前的颜色圆点即可更换颜色。
* 加强 MCP 服务的安全保护：没开局域网访问时只在本机监听；远程 MCP 调用的来源校验也更严格。
* \[Web] 远程 MCP 隐藏敏感信息时识别得更全面。
* \[Web] Dashboard 的云服务配额新增「增强排序（Jev）」用量；价格页中，增强排序（Jev）已从「即将推出」改为 Pro 可用。
* \[Web] 官网首页新增「我的资料库要索引多久？」板块。

🐛 Bug 修复：

* Intel 芯片的 Mac 上，索引长文档时应用闪退，之后每次启动都闪退。
* GBK 等旧编码或带 BOM 的 md/txt 文件导致云端资料库推送失败，语义检索也找不到正文；升级后会在后台自动修复。
* 修复只有图片、没有文字的文档导致云端资料库推送一直失败的问题。
* 资料库设置面板中，过长的文件夹路径把文档数和按钮挤出了边界。

**2026-10-29**

v1.3.0

🚀 新功能：

* \[Web] 云端新增「安全」管理页面，在一处管理云端 MCP 的密钥、已连接 MCP 客户端，以及安全相关的开关。
* \[Web] 新增远程 MCP 数据脱敏开关，自动对密码、证件号码等 200 多种敏感信息隐藏。可在「安全」页面关闭。
* 剪藏支持高亮和批注，批注会被索引和搜索，AI 助理读取剪藏时也能看到你的批注。
* 内置 Chatbot 自带 Linkly AI 使用指南，问「怎么添加文件夹」这类问题时会按实际界面回答。
* \[MCP] `read` 工具新增 `include_image` 参数，读取图片类文档时可以把图片本身一并交给 AI 助理。

⚡ 改进：

* 云同步遇到大批量删除时会先暂停，等你确认后再删除云端文件，避免误删；并对通知进行了优化。
* 资料库中双击文件用默认应用打开的功能，默认关闭，可以在设置中按需打开。
* 笔记中的 `#` 只有从候选列表中选取时才会成为标签，`#114` 这类编号不再被误识别为标签。
* 优化内置 Chatbot 的回复语言，尽量使用你提问时的语言回复。

🐛 Bug 修复：

* 不支持 AVX2 的老 CPU 上，加载本地向量模型导致应用每次启动都崩溃；现在这类设备改用关键词搜索，并在界面中说明原因。
* 通过远程 MCP 编辑笔记时，笔记中的原始内容被 `[REDACTED]` 标记覆盖的问题。
* 未登录时无法删除本地资料库，提示「Cloud API Key not configured」。
* 监控文件夹位于应用数据目录内时，应用会把自己的缓存文件也编入索引。
* 法语界面中「策略」与「规则」两个标签页名称相同。
* 在搜索框中粘贴网址或带冒号的内容时搜不到结果；长网址在笔记筛选栏和聊天中显示溢出。

**2026-10-20**

v1.2.0

🎉 Linkly AI 1.2：自己决定哪些文件进索引

现在 Linkly AI 可以按类型过滤掉不需要的文件，也可以用排除规则跳过某些文件和子目录。

🚀 新功能：

* 支持文件类型开关，可以关闭或打开指定的文件类型
* 支持排除规则，可以用通配符排除某些文件或子目录
* 文档预览可以在「解析视图」和「原文」之间切换，直接在应用里查看 PDF 原页、图片和音视频。
* 资料库的文件列表中双击文件，可用系统默认应用打开。
* 扫描版 PDF 中图片，现在也会被识别、裁剪并保存。
* 官方模型新增 DeepSeek V4.1 Flash、Qwen3.8 27B、GPT-6 Luna、GPT-6.1 Sol、Gemini 4 Argon、Claude Sonnet 5.5 和 Claude Haiku 5.5。
* \[Web] 「集成」页面可以查看已授权的应用，并随时撤销授权。
* \[Web] 价格页新增 Free 与 Pro 的完整功能对比表。
* \[MCP] 远程 MCP 返回内容前，会自动隐藏 API Key、密码、密钥和证件号码等 200 多种敏感信息，防止敏感信息泄露。

⚡ 改进：

* 除 DeepSeek 外，Linkly AI 官方模型现在只精选零数据保留的服务商，每个入选模型都经过了大量用例测试。
* 应用数据可以迁移到 Program Files 下的目录；优化了选到系统目录时的提示说明。
* 网络慢或经代理连接时，额度查询、云端资料库列表等请求不再超时失败。
* \[Web] 首次登录时需要设置显示名称和用户名。
* \[Web] 系统邮件支持六种语言，并可以按类别退订。

🐛 Bug 修复：

* 从应用安装的技能包，会同时链接到 `~/.claude/skills`，解决 Claude Code 无法读取 Skills 的问题。
* 部分 PDF 的文字层解析后出现乱码或多余的控制字符。
* Windows 上更改应用数据位置等操作导致应用重启后，MCP 客户端连接 60606 端口会一直卡住。
* 应用意外退出一次后，向量模型一直退回 CPU 运行，而硬件加速开关仍显示为开启。
* 部分用户的 OCR 一直显示处理中，设置里还提示下载 OCR 模型。
* 迁移缓存或应用数据时，应用偶尔卡死。
* Linux 上对话、搜索、笔记页面显示空白，或在部分显卡上崩溃。
* 修复了内置Chatbot中 `[cite_key: 3]` 这类写法的引用无法识别的问题
* AI 提供商对话框中，过长的模型 ID 超出边界。

**2026-10-12**

v1.1.0

🎉 Linkly AI 1.1：应用数据可以更改位置了

索引、本地模型这些应用数据会占用较多磁盘空间，现在可以在「设置 → 通用 → 应用数据」进行更改，把它们迁到空间更大的磁盘。

🚀 新功能：

* 应用数据支持更改存储位置，并能在更改后自动迁移、校验数据，并清理原始位置。
* Linkly AI 已上架 Claude 连接器目录，在 Claude 的连接器目录里搜索 Linkly AI 即可添加。
* 文档预览新增文档目录导航：按标题列出文档的目录结构，点击即可跳转到具体章节。
* 笔记编辑中的草稿会自动保存，应用意外退出或重启后也可以自动恢复，不再丢失没保存的内容。
* 全局快捷键可以清除，并新增一个打开主窗口的快捷键。
* 内置对话新增 Gemini、OpenCode Go 和小米 MiMo 三个模型提供商预设。
* 升级 OCR 的版面识别模型，能更准确地还原标题、段落和脚注，并自动过滤低置信度的噪点信息。
* \[CLI] 新增 `linkly auth login`，在浏览器里确认即可登录，不用再手动复制 API Key。
* \[CLI] 可以保存局域网连接，之后用 `--lan` 直接连接；`linkly doctor` 一次检查本机、远程和局域网所有连接。
* \[CLI] 支持用 `LINKLY_CONFIG_DIR` 指定凭据存放位置。
* \[Skills] 同步支持 CLI 的浏览器登录、局域网连接和新的 `linkly doctor` 诊断方式。
* \[Web] 每个账号最多可以创建 10 个 API Key，并能看到每个 Key 的使用情况。

⚡ 改进：

* 「Agent 使用」页面发现 CLI 或技能包有新版本时立即自动更新，不再最长等一天（需开启自动更新）。
* 英文搜索的摘要和高亮只匹配完整单词，搜「AI」不会再命中 email、Mountain 这类词。
* grep 能正确匹配 RTF、DOC、HTML 文档中带特殊符号的文字。
* 网络较慢或经代理连接时，对话请求不再因连接超时直接失败，出错时能看到具体原因。
* 应用主窗口的大小会被记住，强制退出、更新后或在不同分辨率的屏幕之间切换都不会变；窗口超出屏幕时自动缩小。
* 云端 OCR 和语音转写在网络重试时不会重复扣额度。
* 诊断报告对文件路径的脱敏更彻底，手动提交的报告包含更多日志，便于定位问题。
* \[MCP] 远程 MCP 遇到 Pro 付费墙、Desktop 离线、超时等情况时，会以易懂的说明返回给 AI 助理，不再笼统地显示成「工具调用失败」。
* \[CLI] 帮助和输出重新编写，人和 Agent 读起来都更清楚。
* \[Skills] 补充远程 MCP 新的错误说明，Agent 遇到问题时能给出正确的处理办法。

🐛 Bug 修复：

* Ollama、LM Studio 等本地模型不填 API Key 时无法对话。
* 使用 OpenCode Go 时提示 MissingSessionID。
* Gemini 调用工具时报错或返回空回答。
* 添加模型提供商时，切换预设不会同步填入名称，云端服务也错误地提示「本地服务可留空」。
* 对话达到步数上限后，过程区域一直显示「运行中」。
* 存放在其他磁盘或外接卷上的文件，在右键菜单里无法用默认应用打开。
* 索引暂停时重建索引，被误报为「正在扫描或索引」。
* 编码无法识别的 CSV 文件一直显示「处理中」，并每小时重试一次。
* OCR 运行期间，语义索引偶尔停滞不前。
* \[CLI] 用 `curl | sh` 在 macOS / Linux 上安装失败；安装脚本现在会校验下载文件。
* \[Web] 没有设置用户名的作者，在云端库页面显示不正常。

**2026-09-28**

v1.0.0

🎉 Linkly AI 1.0 正式版：以上下文为中心的全新主界面

1.0 重新设计了整个应用架构。打开应用让你快速看清你的知识库的资料和状态，看得见 Agent 读了什么，更加容易的与 Agent 集成。

💡 Tips：原来设置里的文件夹、知识库、索引和 MCP，分别移到了新的「资料库」「索引管理」「Agent 使用」页面；设置改为主窗口内的对话框（⌘/Ctrl + ,）。

💡 Tips：中文界面里的「知识库」改称「库」，云端的叫「云端库」。

💡 Tips：升级后默认跟随系统代理联网；如果联网异常，可以到「设置 → 网络」改为「不使用代理」。

💡 Tips：「一键写入 AI 应用配置」已移除，已经写入的配置不受影响。

💡 Tips：无需重新下载模型或重建索引，CLI 与技能包也无需升级。

🚀 新功能：

* 全新主界面：打开应用默认进入首页，笔记、剪藏、资料库和找资料都在侧边栏一键直达。详见[快速开始](https://linkly.ai/docs/zh/quickstart.md)。
* 新增首页：快速看清你的知识资产、索引状态和 AI 使用趋势；新增入门引导卡，五步完成新手入门。
* 新增资料库：新的一级菜单，整合了原来的文件夹和知识库设置。用目录树浏览 Linkly AI 空间、资料夹、库和云端库，点文件即可预览。详见[知识库](https://linkly.ai/docs/zh/use-libraries.md)。
* 右键任意文件或目录，可以直接与它对话，或复制成提示词交给任何 Agent。
* 新增索引管理：随时看清文件的解析进度，找出无法解析的文件和原因，一键重试。详见[索引设置](https://linkly.ai/docs/zh/indexing.md)。
* 新增 Agent 使用：看得见每个 AI 应用读了你哪些文件（记录只保存在本机），MCP、CLI 和技能包的设置也都集中在这里。详见[使用 MCP 集成到 AI 助理](https://linkly.ai/docs/zh/use-mcp.md)。
* 接入 Agent 更简单：把一段提示词发给 Agent，它就能自己完成配置。详见[给 Agent 的安装指南](https://linkly.ai/docs/zh/agent-setup.md)。
* CLI 与技能包可以在应用内一键安装并自动更新（老用户需在「Agent 使用 → 高级」开启自动更新）。
* 新增剪藏：浏览器扩展保存的网页，现在可以直接在应用里阅读，也能与它对话。详见[使用浏览器扩展](https://linkly.ai/docs/zh/use-extension.md)。
* 全新的找资料：新的搜索页面，筛选和排序一目了然，适合频繁地深度搜索。
* 笔记可以按作者筛选，分清自己写的和 Agent 写的笔记。
* 新增网络代理：支持跟随系统、不使用或自定义代理（HTTP / SOCKS）。
* 新手引导重新设计，几步就能完成资料目录和 Agent 的设置。
* 云端库：Web 新增「使用统计」，所有者能看到云端库被浏览和被 Agent 使用的情况。
* 云端库：Web「仅预览」的云端库支持申请连接功能，任意用户可以申请，并经过拥有者审批后可获得知识库使用权限。

⚡ 改进：

* 折叠对话中的思考和工具调用，正文读起来更清爽。
* 对话正文重新排版，读起来更舒服；长回答生成时也更流畅。
* 对话出错时给出易懂的说明和解决办法，不再只显示原始报错。
* 每条回答都可以复制和下载，不再只限最后一条。
* 内置对话默认就能使用已连接的云端库，无需再单独开启。
* 中文整句搜索的摘要和高亮更准确。
* 内置模型下载时显示进度，下载失败时提供[离线安装指南](https://linkly.ai/docs/zh/offline-models.md)。
* 界面字体优化，各平台显示更一致。
* 索引时占用的资源更少。

🐛 Bug 修复：

* 资料夹里有被 `.gitignore` 排除的文件时，扫描会反复循环。
* 电脑睡眠唤醒后，主窗口偶尔显示空白。
* 主窗口最小化后，从托盘或启动器唤起时不会还原。
* 对话中链接点不开、中文输入法选词时按回车误发送。
* 地区限制或模型不可用时，被误报为 API Key 无效。
* 部分由 SAP 等系统导出的 xlsx 文件无法索引。
* 新添加目录里的图片和 HTML 预览需要重启才能显示。

**2026-09-18**

v0.14.1

🔍 中文整句直接搜，Linux 新增 arm64 版

💡 Tips：CLI 与技能包已同步更新到 v0.8.2，建议一并升级。

🚀 新功能：

* 新增 Linux arm64（aarch64）安装包，DGX 等设备现在也可以安装 Linkly AI
* MCP 工具 `search` / `outline` / `list` / `read` 新增 `char_count`（字符数）数据，Agent 能看到准确字数
* 聊天窗口：自己发出的消息也可以一键复制了
* CLI：新增全局参数 `--client <应用名>`，Agent 调用时可以报上自己的应用名字。详见[命令行工具](https://linkly.ai/docs/zh/use-cli.md)。

⚡ 改进：

* 改善中文搜索：改进了中文搜索的分词和排序算法
* 改进重复运行的提醒，重复运行客户端，不再出现误报崩溃的情况
* 云端知识库支持流式上传，几十 MB 的大文档不再上传失败。
* 外接硬盘、网络盘断开或监视文件夹改名后，其中的文档会自动暂停索引，不再每 15 分钟反复重试；恢复后自动继续。
* 改进了 OCR 流程，界面截图等带图标的噪声的图片，不会再拖慢 OCR 速度。
* 崩溃报告：macOS 上原生崩溃会附带系统崩溃日志的精简版（不含文件路径）；报告携带的最近日志从 256 KiB 扩大到 2 MiB。
* 数据目录不可写、或文件系统不支持文件锁时，启动会给出明确的错误提示，而不是崩溃。
* CLI：安装包体积缩小到原来的约三分之一，并提供 SHA256 校验。
* 云端知识库：优化了包含数千篇文档的大型知识库的删除速度。

🐛 Bug 修复：

* 纯标点查询（如 `，， 。。`）不再匹配整个索引；`，， -小米` 之类查询也不再变成「除小米以外全部」。
* Excel/WPS 中整列设置过格式的小表格被误判为超大表格而拒绝解析。
* 表格提取正文中的 `\[`、`\_`、`&amp;` 等转义泄漏到搜索结果和 Agent 读到的内容。
* 表格预览：单元格里的 `![x](url)` 被渲染成图片并发起网络请求、`**x**` 变成粗体、升级后未刷新的旧缓存出现转义残留。现在单元格文本按字面显示。
* 每页带可见文字水印的扫描 PDF 被误判为已有文字层，整本只索引了水印；现在能正确进行 OCR。
* OCR 图片结构识别把整张图判为图片/图表区域时，识别出的文字没有进入索引。
* MCP 搜索的 Markdown 输出中，摘要含 `## ` 标题时会出现没有 Doc ID 的幽灵条目。
* MCP `read` 读取表格时，把单元格里的 `![alt](path)` 误当成图片引用。
* 本地嵌入模型空闲卸载期间会阻塞配置读写；一轮索引进行中模型被卸载时，剩余文档被逐个记成失败。
* 监视文件夹不可用时，设置页的 OCR 进度计数永远差 N 个无法完成。
* Linux：NVIDIA 闭源驱动或 ARM64 + NVIDIA 环境下窗口内容显示空白，现已修复。
* 云端知识库：索引过程中被删除的文档不再被误标回「已完成」。

**2026-09-10**

v0.14.0

📊 新增 Excel 与 CSV 支持，OCR 提速 3 倍

💡 Tips：OCR 升级后需要下载更新模型文件。

💡 Tips：需要把 CLI 和技能包一并升级到最新版。

🚀 新功能：

* 支持 Excel（`.xlsx`）与 CSV 表格的解析、索引和搜索。完整格式清单见[工具介绍](https://linkly.ai/docs/zh/tools-intro.md)。
* 本地 OCR 识别提速，OCR 平均提速可达 3 倍以上。
* 崩溃报告窗口新增「下载最新版」按钮，防止崩溃后无法升级应用。
* 主界面新增升级通知卡片，更轻松地了解每个版本的新功能。
* 官网上线全新的更新日志页面，阅读更加友好。
* CLI：`search` 和 `list` 支持 xlsx 和 csv 文件格式。详见[命令行工具](https://linkly.ai/docs/zh/use-cli.md)。
* CLI：`--remote` 模式新增两个云端工具，Agent 现在可以直接搜索云端知识库并使用。详见[远程使用](https://linkly.ai/docs/zh/use-in-remote.md)。

⚡ 改进：

* 优化了文字识别、语音转写、语义索引的顺序，减少排队异常导致的卡死情况。
* 改进了 macOS 后台索引时被系统降速的问题。
* 优化了安装包体积。
* 优化了 macOS 安装窗口的引导界面。
* 官方技能补上了 xlsx 和 csv，对 AI 说「搜一下我的表格」就能正确触发。
* CLI：改进了云端工具的报错信息，Agent 更易使用。
* CLI：主动检查 Skills 是否有版本更新并提醒升级。

🐛 Bug 修复：

* 重建时不再删除整个索引目录，避免出现索引元数据指向已被删除分片的情况。
* 应用启动时发现索引分片缺失，会自动修复。
* 修复扫描版 PDF 等待 OCR 时，不能按文件名搜索的问题。
* [索引设置](https://linkly.ai/docs/zh/indexing.md)里的语义搜索状态，不再卡在满格进度条状态。
* 无法解析的文件不再被无限重试：超大、加密或损坏的文件会被标记为「未索引 · 提取失败」。
* 打开大表格不再卡死预览窗口，超出渲染预算的表格会直接以源码视图打开。
* 云同步不再被体积过大的单个文件卡住。

**2026-09-04**

v0.13.0

⚡ **GPU 加速索引，新增 RTF 与旧版 .doc 支持**

💡 Tips：本版起 macOS 最低要求回到 **13.4**。

💡 Tips：Linux 安装包的 glibc 基线下调到 **2.35**，此前装不上的较老发行版可以正常安装了。

🚀 新功能：

* **支持 RTF 和旧版 `.doc` 文档**的解析与索引，两者都能生成大纲。完整格式清单见[工具介绍](https://linkly.ai/docs/zh/tools-intro.md)。
* **Windows / Linux 启用 GPU 硬件加速**，语义索引速度大幅提升。
* [索引设置](https://linkly.ai/docs/zh/indexing.md)中新增**硬件加速开关**，如遇问题可随时切回 CPU 运行。
* 新增**崩溃检测与诊断上报**：内容脱敏，并且经你确认后才会发送。
* 没有书签的文字版 PDF 现在也能**自动生成大纲**。
* 官网：Dashboard 新增**云服务额度板块**，可以查看 OCR / ASR / Embedding 的用量与趋势。
* 官网：上线**每日 Agent Skills 排行榜**。
* 官网：新增**俄语**。

⚡ 改进：

* 索引算力按 CPU 核数动态分配，大型资料库的语义索引速度回到正常水平。
* 本地语义索引优化了索引结构与窗口大小，长文档索引更快，检索精度也略有提升。
* 优化索引任务的调度，主任务不再被子任务挤占。
* 监控文件夹丢失时会给出明确警告。
* 自带 Chatbot 支持渲染 LaTeX 公式，公式显示更稳定。
* 云端 OCR 服务支持更大的并发和处理速度，转 Markdown 的精度也略有提升。

🐛 Bug 修复：

* 索引面板的进度数字统一由后端计算，不再出现「已完成超过总数」。
* 修复 Windows 上云端登录卡住的问题。
* 修复长文档向量化时被系统强制结束的问题。
* 修复 GBK 等旧编码文本文件正文被丢弃的问题。
* 修复索引遇到临时故障后整体停住的问题。
* 修复无法扫描的文件引发反复重扫的问题。
* 修复部分非 PDF 文档被漏索引的问题。
* OCR 失败的文档会重新获得处理机会。
* 修复偶发的窗口操作导致的崩溃。
* 修复部分文档向量化时因编码问题导致的报错。

**2026-08-24**

v0.12.1

🎙️ **云端转写正式发布，新增六个笔记洞察技能**

💡 Tips：本版起 macOS 需要 **15.0 或更高版本**。更低的系统后续酌情支持。

💡 Tips：云端转写包含在 Pro 计划中，需要先登录 Linkly 账号并订阅 Pro。

🚀 新功能：

* **云端语音转写（ASR）正式发布**：Pro 用户可在「设置 → AI」把音视频转写切到云端，速度更快、准确率更高、不占用本机资源。
* **知识库可以按标签纳入笔记和剪藏**：在[知识库](https://linkly.ai/docs/zh/use-libraries.md)详情页添加标签筛选，命中的笔记 / 剪藏会自动加入这个知识库并持续更新。
* **剪藏支持标签**：保存剪藏时可以直接加标签——这也是把剪藏按标签纳入知识库的前提。
* 新增六个[笔记洞察技能](https://linkly.ai/docs/zh/use-skills.md)：**默认洞察、逆向思考、CBT 疗法、价值澄清、二阶思考、MBTI 分析**。对自己的笔记做一次分析吧。技能也会同步添加到 Codex 等主流 Agent 中。
* 新增内置技能 **「保存笔记」**：说一句「记下来」「存到笔记」，就能把对话内容忠实保存进本地[笔记](https://linkly.ai/docs/zh/use-notes.md)。

⚡ 改进：

* 技能支持本地化名称，斜杠面板、上下文徽章与技能页都显示本地语言。
* MCP 九个工具补齐能力声明（只读 / 非破坏性）：ChatGPT 这类按读写分级授权的客户端不再对只读检索反复弹确认框。
* 通过 MCP 保存的笔记，来源徽章自动显示真实应用名（ChatGPT / Claude / Cherry Studio 等）。
* 音视频转写新增 **「语言不支持」** 状态：当前转写引擎覆盖不到的语种会明确标注，不再笼统显示为转写失败。
* 官网：Dashboard 各页接入帮助 Chatbot，使用问题可以直接问它。
* 官网：[浏览器扩展](https://linkly.ai/docs/zh/use-extension.md)页新增安装包下载与手动安装说明，打不开 Chrome 应用商店也能装上。
* [Linkly AI CLI](https://linkly.ai/docs/zh/use-cli.md) 发布 v0.6.3：桌面端未运行时的提示更明确。

🐛 Bug 修复：

* macOS 14 及更低版本不再静默闪退，改为明确提示需要 macOS 15.0。
* 修复 MCP 保存的笔记在桌面端二次编辑后，来源徽章被打回 `external-mcp` 的问题。
* 修复 Windows 上转写音视频、配置 MCP 客户端时会闪出黑色命令行窗口的问题。
* 修复设置页索引状态里，已完成的搜索行会随索引进度闪烁的问题。
* 修复云端知识库搜索：查询中含标点或保留字时不再出错。

**2026-08-14**

v0.12.0

☁️ **云端嵌入服务正式发布：Pro 用户可切换到云端**

💡 Tips：云端嵌入是 Pro 功能，需要先登录 Linkly 账号，并确保有 Pro 版订阅。

🚀 新功能：

* **云端嵌入正式发布**：Pro 用户可切换到云端嵌入服务，更快、语义搜索质量更高、更省资源。
* 笔记：新增 **时间轴导航**。
* 笔记：新增 **标签筛选栏**。

⚡ 改进：

* 改进扫描件被重复 OCR 的几率：带隐藏文本层的扫描 PDF 在检测合格后会直接采纳，不用再排队重跑一遍识别。
* 杂志类「整页大图 + 可见文字」的排版页也不再被误判成扫描件。
* 修复偶发的低配置机器索引长期停滞问题。
* 提高了高性能索引模式对机器资源的使用率。
* 云端知识库：百万字级超长文档不再索引失败，并且不会再连累同批次其他文档。
* 云端知识库：索引速度大幅提升。

🐛 Bug 修复：

* 修复自定义模型（OpenAI 兼容、未上报上下文窗口）无法手动压缩对话的问题。
* 修复某条笔记日期异常（如误填年份）时界面卡死数秒，以及跨夏令时时区（智利等）时间轴丢失最新一天的问题。
* 统一了正文 `#标签` 的解析口径，前后端与不同编辑路径下的标签识别结果不再有差异。

**2026-08-10**

v0.11.0

🧠 **Agent Skills 正式上线：给 Chatbot 装上专业工作流**

💡 Tips：技能就是一个装着 `SKILL.md` 的文件夹，描述“什么时候该怎么做”。Linkly AI 内置三个默认技能（读书笔记 / 深度调研 / 知识库体检），也可以把第三方技能文件夹放进 `~/.agents/skills`，在技能页刷新后启用。在输入框打 `/` 可直接唤起命令与技能列表。

💡 Tips：CLI 和 linkly-ai-skills 需要同步升级到最新版本 v0.6.1。

🚀 新功能：

* 新增 **Agent Skills（技能）**：Chatbot 侧栏新增技能入口，内置「读书笔记」「深度调研」「知识库体检」三个技能，可逐个启用；`/` 面板直接调用；也可以在 `~/.agents/skills` 安装新技能。
* `list` 工具从「只能列笔记」扩展为三种范围（文件夹 / 知识库 / 笔记），支持按类型、修改时间、标签过滤与分页，并会指出目录里的 README，引导 AI 先读说明再动手。云端知识库同步支持。
* 新增 **更新就绪徽标**：新版本下载完成后 Chatbot 侧栏会出现提示，点击确认即可重启完成更新（若有对话正在生成回复会先提醒）。
* 笔记卡片菜单新增 **「在文件夹中显示」**，可直接定位到笔记的 Markdown 原文件。
* 关于页、macOS 帮助菜单与托盘新增 **官网 / 社区 / 文档** 入口。
* [Linkly AI CLI](https://linkly.ai/docs/zh/use-cli.md) 发布 v0.6.1：新增 `list` 命令（文件夹 / 知识库 / 笔记三种范围，可按类型、修改时间、标签过滤）与首个写入命令 `note-save`；`read` / `outline` / `grep` 支持一次传多个文档 ID，或用 `-` 从管道读取（`linkly search --json | jq -r '.results[].doc_id' | linkly outline -`）；新增 `linkly completions <shell>` 生成 Shell 补全脚本；`mcp --remote` 可经云端网关访问云端知识库；新增 `auth status` / `auth logout`；`search` 支持 `--scope` / `--tags`，`read` 支持 `--image-text`。

⚡ 改进：

* 「重建索引」升级为 **彻底重新提取并重建**
* 笔记时间线 **滚到边缘自动加载**，不必再点「加载更多」；标题栏显示笔记总数；发布按钮带文案与快捷键提示；展开编辑区有动效并自动聚焦。
* AI 通过 MCP 写入笔记后，笔记视图 **实时刷新**，不用再刷新。
* 外部 AI 客户端写笔记时可自报应用名，笔记卡片上的来源徽章不再一律显示 `external-mcp`。
* **GPT-5.6 Terra / Luna 积分倍率下调**（Terra 7x → 6x，Luna 3x → 1x），Pro 每月可用次数相应提升（Terra 38 → 45，Luna 90 → 270）。
* 官网：知识库页新增「在 AI 中使用」弹窗，给出针对该库的接入提示词，复制发给自己的 AI 助理即可完成连接
* 官网：探索页分类改为独立地址并支持深度翻页；
* 官网：条款与隐私政策按实际产品重写；欧盟 / 英国 / 瑞士访客会先被询问是否接受统计与广告 Cookie。

🐛 Bug 修复：

* 修复 **按知识库 / 文件夹过滤时搜索结果为空** 的问题（同一目录在系统里以不同大小写记录时，整库搜索会静默返回 0 条）。
* 修复 AI 通过 MCP 编辑笔记时 **标签被清掉** 的问题：正文里的 `#标签` 现在是标签的唯一来源，AI 传入的标签只做追加，删标签靠删正文里的 `#标签`。
* 修复 SKILL.md 使用 YAML 多行写法（`description: >` / `|`）时 **技能无法加载** 的问题。
* 修复笔记复制偶发失败（macOS 剪贴板权限），以及复制草稿失败时毫无提示的问题。
* 修复编辑区展开后 **标签补全弹层跑出窗口** 的问题，现在锚定到光标位置。
* 修复切到笔记 / 技能视图后，侧栏会话行仍保持高亮的问题。
* 修复笔记搜索框出现两个清除按钮、滚动条出现时内容横向抖动的问题。
* 修复个别模型（DeepSeek V4）回复中出现 **重复工具调用标记** 的问题。
* 官网：修复 Dashboard 模型列表溢出悬浮卡片、定价页仍在引用已下架模型的问题。
* CLI：修复 `list`、`grep --mode count`、云端知识库搜索在无结果时仍报成功的问题；退出码语义改为 `--exit-code` 显式开启，不再影响既有脚本。

**2026-07-31**

v0.10.0

📝 **可以在 Linkly AI 里记笔记了，极简的卡片笔记，天生方便 Agent 使用**

💡 Tips：笔记是存在你本地资料库目录下的普通 Markdown 文件，不上传任何云端，随时可以用别的编辑器打开。写好的笔记会自动进入索引，之后能被搜索、被 AI 引用。

🚀 新功能：

* 新增 **本地笔记（Note）**：Chatbot 侧栏新增笔记入口（`⌘/Ctrl + Shift + N` 直达），卡片式时间线浏览，支持标签过滤、按时间排序、`⌘F` 全文搜索、一键复制与展开全文。
* AI 可以 **读写你的笔记**：新增 `note_save` 与 `list` 两个 MCP 工具，Claude、Cursor 等 AI 助手可以帮你把对话整理成笔记、给已有笔记续写，也能按标签列出笔记再挑着读。
* Chatbot 新增 **上下文自动压缩**：长对话接近模型上下文上限时自动压缩历史，不必再新开一轮重述背景；也可以随时输入 `/compact` 手动压缩。

⚡ 改进：

* 浏览器扩展剪藏的文章，**正文里的图片引用现在能被正确识别**：此前标题含空格的剪藏文档，整篇的图片映射都会失效，现在本地与云端知识库都已修复。
* Markdown 预览支持渲染内嵌的 HTML，扫描件识别出来的表格也可以正常显示了。
* 设置页的 **搜索索引就绪状态更准确**，不再在还没建好时就显示可用。
* 云端知识库推送遇到网络抖动时会 **自动重试**，不再整批失败、需要从头重传。
* 官网上线全新首页，并新增 [浏览器扩展](https://linkly.ai/extension) 与 [CLI](https://linkly.ai/cli) 独立介绍页。

🐛 Bug 修复：

* 修复个别文件临时不可读（云盘未同步、外置磁盘未挂载）时被 **高频重试** 拖慢索引的问题。
* 修复媒体文件刷新时误清正文指纹，可能导致 **云端副本被误删** 的问题。
* 修复未添加文件夹的知识库参与自动同步、反复失败的问题。
* 修复嵌入进度条在索引过程中新增文档时 **进度倒退** 的问题。
* 修复文件监听在某些情况下不会唤醒索引流程，导致改动迟迟不生效的问题。
* 修复短时间内 **重复检查更新** 的问题。
* 修复关闭使用数据统计后仍会发送数据、以及发送失败的数据被丢弃的问题。

**2026-07-23**

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、图片在部分场景下未被识别、或识别结果不完整的若干问题。
* 提升了索引升级与数据库迁移过程的稳定性，修复特定升级路径下新功能所需字段可能缺失的问题。

**2026-07-13**

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 跳转风暴的问题。

**2026-07-06**

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 配置变更、端口刷新和本地服务状态相关的稳定性问题。
* 修复索引器在删除、重试和扫描并发场景下可能异常中断或反复重试的问题。
* 修复浏览器剪藏保存、删除和扫描过程中的若干边界问题，提升文件安全性与可靠性。

**2026-07-01**

v0.6.1

🚀 **云端知识库支持公开发布、筛选与收藏**

🚀 新功能：

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

⚡ 改进：

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

**2026-06-30**

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）被截断而无法连接的问题
* 修复设置页中索引数据占用大小显示不准确的问题
* 修复在设置中手动重试索引后未重新开始的问题

**2026-06-12**

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 消息发送失败时输入内容丢失、错误不提示的问题
* 修复部分文件预览无法打开、空文件预览无占位提示的问题
* 修复旧版本聊天数据导致模型选择异常的问题（启动时自动修复）
* 修复通知弹层挤压侧栏、分栏拖拽线偶发卡住等布局问题
* 修复更新失败后「检查更新」按钮无响应、需重启应用才能恢复的问题
* 修复个别文档含特殊字符时语义索引反复重试、空耗资源的问题

**2026-06-05**

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 后台收尾的偶发竞态
* 修复本地知识库名称校验不严格的问题
* 修复文件夹文档计数在扫描 / 监听批处理后未刷新、显示过时的问题
* 修复索引时瞬时删除事件可能导致误删的问题

**2026-05-14**

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 客户端连接新版桌面端时偶发报错的问题

**2026-05-06**

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，会自动引导一键安装

**2026-04-20**

v0.3.5

* \[优化] 实现 Windows User Path 环境变量的备份功能，防止破坏用户注册表后无法恢复
* \[Bug] 修复 Windows 下一键配置 Linkly CLI 时可能清空用户 User PATH 环境变量的问题，仅 0.3.4 版本可能受影响

**2026-04-17**

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 图标显示以及侧边栏布局的细节问题

**2026-04-09**

v0.3.3

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

**2026-04-02**

v0.3.2

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

**2026-03-31**

v0.3.1

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

**2026-03-30**

v0.3.0

📚 **知识库功能上线！用知识库管理文档，在特定领域更精准的检索。**

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

🚀 新功能：

* \[Desktop] 知识库管理 — 在设置中创建、编辑、删除知识库，将文件夹组织为命名知识库进行管理，[查看指南](https://linkly.ai/docs/zh/use-libraries.md)
* \[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] 修复在某些自定义端口配置下无法连接的问题

**2026-03-21**

v0.2.4

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

**2026-03-19**

v0.2.3

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

**2026-03-19**

v0.2.2

🎉 **Linkly AI 现在可以识别图片中的文字了！**

🚀 新功能：

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

✨ 改进：

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

🐛 Bug 修复：

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

**2026-03-14**

v0.2.1

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

**2026-03-12**

v0.2.0

🚀 **重要的更新，LinklyAI 现在可以在公网上被安全的使用了！**

🚀 新功能：

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

✨ 改进：

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

🐛 Bug 修复：

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

**2026-03-10**

v0.1.11

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

**2026-03-09**

v0.1.10

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

**2026-03-06**

v0.1.9

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

**2026-03-05**

v0.1.8

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

**2026-03-03**

v0.1.7

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

**2026-03-03**

v0.1.6

* \[Bug] 修复 Windows 上透明窗口和窗口拖拽的兼容性问题

**2026-02-13**

v0.1.5

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

**2026-02-11**

v0.1.4

* \[改进] MCP 工具描述优化，AI 调用更准确
* \[改进] 搜索结果分数以百分比展示，更直观
* \[Bug] 修复中日韩文本的标题误检测问题
* \[Bug] 改善多显示器环境下的窗口定位

**2026-02-10**

v0.1.3

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

**2026-02-07**

v0.1.2

* \[新功能] 新增全文搜索引擎，支持搜索 PDF、Word 等文档的正文内容
* \[新功能] 启动器接入搜索，支持结果预览
* \[改进] 重新设计搜索结果布局
* \[改进] 窗口主题自动跟随应用设置

**2026-02-07**

v0.1.1

Linkly AI Desktop 的第一个可用版本，支持 macOS、Windows 和 Linux。

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.