> ## 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. # Linkly AI 空间 > 应用自动创建并索引的缺省目录：它在磁盘哪里、装了什么、怎么改位置，以及那些容易踩的坑。 ## 什么是「Linkly AI 空间」 **Linkly AI 空间**是应用在你电脑上自动创建的一个普通文件夹。应用内的描述是： > 自动创建并索引的缺省目录，用于存放文档、笔记、剪藏等。 它的定位很简单——**当应用需要往磁盘上写点什么的时候，默认写到这里**。你在应用里记的[笔记](/docs/zh/use-notes)、用浏览器扩展剪藏的网页、还有随安装包附带的样例文档，都落在这个目录下。 它就是一个普通目录，没有任何专有格式：可以用访达 / 资源管理器打开，可以用任意编辑器改里面的文件，可以直接 `grep`，也可以整个复制走。 你会在三个地方看到三种不同的写法，它们指的是同一样东西，**互相不矛盾**： * 界面上叫「**Linkly AI 空间**」（设置 → 通用 页最底部） * 磁盘上的目录名是 `LinklyAI`（没有空格） * 里面的样例文档目录叫 `Linkly_AI_Examples` *** ## 它在磁盘上的哪里 默认位置在**你的用户主目录**下： | 系统 | 默认路径 | | ----------- | ------------------------- | | **macOS** | `/Users/<用户名>/LinklyAI` | | **Windows** | `C:\Users\<用户名>\LinklyAI` | | **Linux** | `/home/<用户名>/LinklyAI` | \*\*是用户主目录，不是「文档 / Documents」文件夹。\*\*很多人习惯性地去 Documents 里找，会找不到。macOS 用户在访达里按 **⌘⇧H** 直接跳到主目录即可。 Windows 用户在 **设置 → 通用** 页里看到的路径是**正斜杠**形式，例如 `C:/Users/xxx/LinklyAI`——应用内部对路径做了统一规范化，这是正常的，和资源管理器里显示的 `C:\Users\xxx\LinklyAI` 是同一个目录。 想快速打开它：**设置 → 通用 → Linkly AI 空间 → 「打开」**，会直接在系统文件管理器里打开。桌面上通常还有一个[快捷方式](#桌面快捷方式)。 *** ## 里面装了什么 ``` ~/LinklyAI/ ├── Clips/ 浏览器扩展剪藏的网页 │ └── <剪藏标题>/ 每条剪藏一个目录，含 .md 正文和图片 ├── Notes/ 卡片笔记 │ └── YYYY-MM/ 按 UTC 月份分目录 │ └── <正文前 10 字>-<8 位 id>.md └── Linkly_AI_Examples/ 安装包自带的样例文档 ├── A-Life-in-10-Years/ ├── Detectives-Library/ ├── Federalist-Papers/ ├── Mission-Logs/ └── WPA-Slave-Narratives/ ``` ### `Notes/` —— 笔记 应用内写的每一条卡片笔记都是这里的一个 `.md` 文件，按 **UTC 月份**分子目录。文件名规则、YAML 头字段、以及用外部编辑器打开时的注意事项，见[使用笔记](/docs/zh/use-notes)。 ### `Clips/` —— 网页剪藏 用浏览器扩展保存的网页会落在这里，**每条剪藏一个独立目录**，里面是 Markdown 正文和页面里的图片。 ### `Linkly_AI_Examples/` —— 样例文档 随安装包附带的一批公共领域文本，共 **159 个文件、解压后约 11.9 MB**，全部是 Markdown。它们在首次启动引导的「准备中」那一屏被解压并索引，作用是让你装完就能立刻搜到东西、试一下检索和 Chatbot 的效果。 熟悉之后可以直接把整个 `Linkly_AI_Examples/` 删掉，不影响任何功能，索引里的对应条目会自动清掉。 `Clips/` 和 `Notes/` 这两个目录**每次启动时都会被确保存在**——手动删掉它们，下次启动会重新创建（但里面的内容不会回来）。`Linkly_AI_Examples/` **只在首次引导时解压一次**，删掉就不会再重建了。 *** ## 它是怎么被索引的 这个目录里的内容能被搜到，并不是因为它被"特殊对待"了，而是因为： **首次启动的引导流程会自动把它加入监听目录。** 也就是说，它在 **设置 → 文件夹** 页里就是一条**普通的监听目录**，和你自己后来添加的「文档」「项目」目录完全平级。索引的分层逻辑、哪些开关会影响它，都和其他目录一样，见[索引设置](/docs/zh/indexing)。 老用户升级到新版本后也会重新看一次引导流程，所以这条对升级用户同样成立——不用担心升级后这个目录掉出监听列表。 **在「设置 → 文件夹」页里，你可以把它移除——但请三思。** 移除之后它不再被索引，可是**应用照样会继续往里面写笔记和剪藏**。结果就是：你写的笔记、剪藏的网页明明存在磁盘上，却在搜索和 AI 检索里**一条都搜不到**，而且界面上不会有任何提示告诉你为什么。 如果你不小心移除了，回到 **设置 → 文件夹** 把这个目录重新添加回来即可，存量文件会被重新索引。 *** ## 更改位置 主目录空间不够、想放到另一块硬盘上——**设置 → 通用** 页最底部的「Linkly AI 空间」区域有三个按钮：「打开」「**更改…**」「恢复默认位置」。 \*\*这不是「迁移」。\*\*应用不会搬动你的任何文件。 确认框上写得很清楚： > 现有文件不会被移动，仍留在当前位置并继续被索引；此操作只改变今后新文件的存放位置。 操作成功后的提示同样是： > 文件夹位置已更新。旧位置的文件不会自动搬迁，仍保留在原处。 它在后台只做两件事：**在新位置建一个空目录** + **把配置指向那里**。不复制、不移动、不删除任何已有文件，不需要重启，秒级完成。 找到「Linkly AI 空间」区域，当前路径就显示在这里。 \*\*选择器里选的是「父目录」，不是空间目录本身。\*\*选中 `~/Documents`，你得到的是 `~/Documents/LinklyAI`；选中一块外置硬盘的根目录，得到的是 `/Volumes/XXX/LinklyAI`。 唯一的例外：如果你直接选中一个本身就叫 `LinklyAI` 的目录，应用会直接用它，不会再套一层变成 `LinklyAI/LinklyAI`。 读一遍确认框上那句话，点「继续」。新目录立刻创建，配置立刻生效。 应用不会帮你搬。想让旧的笔记和剪藏也待在新位置，需要你自己在文件管理器里把 `Notes/`、`Clips/` 等内容**复制**到新目录。 见下面这条提醒。 **旧路径仍然留在监听列表里，会继续被索引。** 大多数人的预期是"改完之后只索引新位置了"，实际情况是**两个位置都在索引**——旧位置的文档一篇都不会从搜索结果里消失。 这在你只是想换个存新东西的地方时是好事（老资料不丢）；但如果你的本意是"把这个目录彻底挪走"，就需要自己去 **设置 → 文件夹** 把旧路径移除。 连带效果：桌面上的[快捷方式](#桌面快捷方式)会改为指向新位置。「恢复默认位置」按钮的行为和「更改…」完全一致，只是目标固定为用户主目录下的 `LinklyAI`——同样不搬数据。 「更改位置」功能从 **v0.8.0** 开始提供。更早的版本请升级后再操作。 *** ## 桌面快捷方式 首次引导完成时，应用会在你的**系统桌面**上创建一个名叫 `LinklyAI` 的快捷方式，**指向 Linkly AI 空间目录**（不是指向应用程序本身——点开它进入的是文件夹，不是应用）。 | 系统 | 形式 | | ----------- | ------------- | | **macOS** | 符号链接（symlink） | | **Windows** | `.lnk` 快捷方式 | | **Linux** | `.desktop` 文件 | \*\*界面里没有开关可以关掉它。\*\*用户可见的唯一关闭方式是：**把桌面上那个快捷方式直接删掉**——删掉之后不会再自动创建。 唯一的例外是[更改空间位置](#更改位置)：那个操作会无条件重建一个指向新位置的快捷方式。 如果你的桌面上原本就有一个叫 `LinklyAI` 的文件或文件夹（不是应用创建的），应用**永远不会覆盖它**。 *** ## 和「数据目录」不是一回事 这是最容易混淆的一对概念。**Linkly AI 空间**装的是**你的内容**，**数据目录**装的是**应用的内部数据**： | | Linkly AI 空间 | 数据目录 | | -------- | ---------------------- | ----------------- | | **装什么** | 你的内容：笔记、剪藏、样例文档 | 索引、数据库、日志、下载的模型文件 | | **在哪看** | 设置 → 通用 → Linkly AI 空间 | 设置 → 关于 → 数据目录 | | **能改位置** | 能 | 界面上明确提示「非必要切勿修改」 | | **能放云盘** | 可以，但没有保证 | **绝对不要** | | **删掉会** | 丢内容（笔记、剪藏） | 丢索引和配置，需要重新索引 | ### 应用日志在哪 日志文件是 `logs/app.log`，位于**数据目录**下。 **设置 → 关于 页没有「打开日志」按钮**，只能先点「数据目录」旁边的「**打开**」，再进入 `logs/` 子目录。 另外 `app.log` 有 **2 MB 轮转**，超限时只保留后一半内容。所以遇到问题要报给我们时，正确顺序是「**先把当前日志抓出来存一份，再去复现问题**」——反过来做，早期的关键线索很可能已经被轮转掉了。 *** ## 手动删除或移动会发生什么 \*\*不要在文件管理器里直接删除或移动这个目录。\*\*下面是各种情况下的实际后果。 | 你做的事 | 结果 | | ---------------------------- | -------------------------------------------------------- | | **删掉目录，但不重启应用** | 索引不会立刻掉；**设置 → 文件夹** 页会显示「找不到此文件夹」 | | **删掉目录，然后重启应用** | 应用重建一个**空的** `~/LinklyAI`，扫描发现是空的，原有文档约 **60 秒后**从索引中被清除 | | **把目录手动移到别处** | 配置仍指向旧路径，重启后旧路径被重建成空目录；**新位置除非手动加入监听，否则完全不被索引** | | **只删掉 `Linkly_AI_Examples`** | 安全。样例只在首次引导时解压一次，不会重建，也不影响其他功能 | **正确的换位置姿势**： 在 **设置 → 通用 → Linkly AI 空间** 点「更改…」，选好新的父目录。 在文件管理器里把旧目录的内容**复制**到新目录。建议复制而不是剪切，确认没问题后再删旧的。 想让旧位置也继续可搜就什么都不用做；不想要了，去 **设置 → 文件夹** 把旧路径移除。 *** ## 常见问题 **可以，但没有官方保证。**应用对这个目录**没有任何云盘检测，也不会给你任何提示或警告**——放上去就是放上去了，出问题也不会有弹窗。 索引这一侧对云盘做了一些通用防护，多少能缓解一部分问题： * **跳过尚未下载到本地的云端占位文件**（搜索结果里会标「未索引 · 云端占位文件」，下载到本地后自动重新索引） * **对云同步抖动造成的瞬时删除，有 60 秒的稳定窗口**，不会一抖就把文档从索引里删掉 * **忽略 `#recycle`、`@eaDir` 等同步元数据目录** 即便如此，云盘的按需下载、冲突副本、频繁改写仍可能让索引反复变动。如果你只是想在多台设备间共享文档，把云盘目录**作为一条普通监听目录添加**（设置 → 文件夹）通常比把整个空间挪进云盘更稳妥。 \*\*不会。\*\*它只做两件事：在新位置建目录 + 把配置指向新位置。已有文件一个都不动，仍留在原处、仍继续被索引。 确认框上那句「现有文件不会被移动」不是免责声明，是对行为的准确描述。想让旧文件也过去，需要你自己在文件管理器里复制。 正因为它根本不搬数据，也就不存在"迁移中途失败 / 中断了怎么办"这种情况——这个操作是秒级完成的。 \*\*搜得到。\*\*旧路径仍然留在监听列表里，继续被索引，两个位置的内容都在搜索范围内。 这通常是好事（老资料不会突然消失），但如果你的本意是"彻底换个地方"，就要自己去 **设置 → 文件夹** 把旧路径移除。 它不再被索引，但**笔记和剪藏照样会往里写**——写进去的东西搜不到，界面上也不会提示。 这是最容易踩的坑。回到 **设置 → 文件夹** 重新添加这个目录即可恢复，存量文件会被重新索引。 可以。`Linkly_AI_Examples/` 是纯 Markdown 的公共领域文本，删掉不影响任何功能，索引里的对应条目会自动清理。 需要注意的是它**只在首次引导时解压一次**，删掉之后不会再重建——想留个念想就先备份一份。 **直接删掉它就行**，之后不会再自动创建。界面里没有对应的开关。 唯一会让它重新出现的操作是[更改空间位置](#更改位置)——那一步会无条件重建一个指向新位置的快捷方式。 分两种情况： * **还没重启应用**：文件已经丢了（笔记、剪藏都在里面），但索引还在。有时间机器 / 文件历史记录的话，赶紧从备份里恢复目录，再重启应用。 * **已经重启过**：应用重建了一个空目录，扫描发现是空的，原有文档约 60 秒后从索引里清除。此时只能靠系统备份恢复。 应用**没有回收站，也没有自己的备份机制**。这个目录里存的是你的真实文件，请像对待任何重要文件夹一样对待它。 在**数据目录**下的 `logs/app.log`——注意不是 Linkly AI 空间里。 路径：**设置 → 关于 → 数据目录 → 「打开」**，然后进入 `logs/` 子目录。关于页**没有**直接打开日志的按钮。 `app.log` 有 2 MB 轮转、超限只保留后一半，所以要报问题时请**先抓日志、再复现**。 *** ## 延伸阅读 * [快速开始](/docs/zh/quickstart) —— 安装、走完引导、添加你自己的文档 * [索引设置](/docs/zh/indexing) —— 这个目录里的内容具体是怎么被索引的 * [使用笔记](/docs/zh/use-notes) —— `Notes/` 的文件名规则与 YAML 格式 * [使用知识库](/docs/zh/use-libraries) —— 把这个目录（或其中的子目录）划进知识库 * [常见问题](/docs/zh/faq) —— 其他排查路径 * [使用 AI 对话](/docs/zh/use-chatbot) —— 在对话里 `@` 引用这个目录下的内容 * [浏览器扩展](/docs/zh/use-extension) —— `Clips/` 里的内容从哪来