> ## 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 Clipper：一键把网页转成排版干净的 Markdown，在侧边栏预览、复制、下载，或直接存进你的 Linkly AI 空间。

## 它能做什么

**Linkly AI Clipper** 是 Linkly AI 的浏览器扩展，做的事情只有一件：**把网页存为 Agent 友好的 Markdown**。

一键把当前页面转成排版干净的 Markdown，在侧边栏里预览、复制或下载到本地。不只是「保存网页」——正文、图片、译文、视频字幕，连同你和 AI 的对话，全都能变成一份干净的、可被 Agent 轻松使用的 Markdown 文件。

<CardGroup cols={2}>
  <Card title="存下来就是 Agent 能读的格式" icon="file-code" iconType="duotone">
    带 YAML 头部和清晰的章节结构，X、微博这类内容也单独优化过
  </Card>

  <Card title="直接进你的资料库" icon="folder-tree" iconType="duotone">
    装了桌面应用时，剪藏直接落进 Linkly AI 空间，和你电脑上的其他文件一起被索引
  </Card>

  <Card title="图片一起带走" icon="image" iconType="duotone">
    正文里的图片下载到同一个文件夹，断网也能正常阅读图文
  </Card>

  <Card title="全程在本地完成" icon="shield-check" iconType="duotone">
    提取、翻译、生成目录全部在你的浏览器里完成，不经过我们的服务器
  </Card>
</CardGroup>

***

## 安装

从 Chrome 应用商店安装：[**Linkly AI Clipper**](https://chromewebstore.google.com/detail/linkly-ai-clipper/akplbgdjkgkakgoemhpjpphfilipdbda)。

| 项目           | 要求                                           |
| ------------ | -------------------------------------------- |
| **浏览器**      | Chrome 116 及以上（侧边栏 API 需要）                   |
| **端侧 AI 功能** | 本地翻译、AI 修补目录需要更新的 Chrome（内置模型可用即可）           |
| **其他浏览器**    | Edge、Brave 等 Chromium 内核浏览器可直接从 Chrome 应用商店装 |
| **登录 / 付费**  | 都不需要，见[常见问题](#常见问题)                          |

<Warning>\*\*Firefox 暂不支持。\*\*扩展目前只上架了 Chrome 应用商店，Firefox 没有发布版本，别去 Firefox 附加组件里找。</Warning>

***

## 剪藏第一个页面

<Steps>
  <Step title="打开一个文章页面">
    随便打开一篇文章、一条推文、一个知乎回答，或者一个 YouTube 视频页面。
  </Step>

  <Step title="点击工具栏上的 L 图标">
    浏览器右上角的扩展图标点一下，右侧会打开侧边栏，自动开始提取当前页面的正文并转成 Markdown。

    <Note>
      \*\*没有右键菜单，也没有键盘快捷键。\*\*打开侧边栏的唯一方式就是点工具栏图标。建议把扩展固定到工具栏上（扩展菜单里点一下图钉）。
    </Note>
  </Step>

  <Step title="检查结果，然后复制或保存">
    默认是**预览**视图——排版好的阅读界面。工具栏上还有「编辑源码」（切到原始 Markdown 直接改）、「源信息」（来源 URL / 站点 / 作者 / 发布时间）、「目录」和四档字号调节。

    确认没问题后，点「**复制**」把整份 Markdown 送进剪贴板直接粘给 AI 助理，或者点「**下载**」保存成文件——具体落到哪见[下一节](#剪藏保存到哪)。
  </Step>
</Steps>

<Note>**切换标签页时会自动重新转换**。不想要这个行为的话，去 **设置 → 自动刷新** 关掉，之后需要手动点「重新转换」。</Note>

<Warning>\*\*不支持选区剪藏。\*\*扩展提取的永远是整个页面的正文，没有"只剪选中的这一段"这个功能。想只保留一部分，在侧边栏切到「编辑源码」自己删。</Warning>

***

## 剪藏保存到哪

这是最容易困惑的一点：**同一个「下载」按钮，会根据桌面应用在不在跑，走两条完全不同的路径。**

| 情况                | 保存位置                        | 后续                    |
| ----------------- | --------------------------- | --------------------- |
| **桌面应用正在运行**      | `~/LinklyAI/Clips/<剪藏标题>/`  | 会被自动索引，之后可以被搜索和 AI 检索 |
| **桌面应用没运行，或保存失败** | `~/Downloads/Linkly/`（下载目录） | 只是普通文件，**不会**被索引      |

每条剪藏是**一个目录**，里面放着 `.md` 文件和它的图片。

### 怎么知道走的是哪条路

保存后侧边栏底部会弹一条提示，四选一：

| 提示                   | 含义                         |
| -------------------- | -------------------------- |
| 已保存到 Linkly Space    | 成功进了资料库                    |
| 客户端未运行，已保存到浏览器下载目录   | 没检测到桌面应用，走了回退              |
| 保存到客户端失败，已保存到浏览器下载目录 | 检测到了但传输失败，走了回退             |
| 已保存到本地               | 你在设置里关掉了「保存到 Linkly Space」 |

也可以主动确认：打开 **设置 → 下载设置**，「保存到 Linkly Space」这一行会显示当前状态——显示「在线」并带上桌面应用版本号说明连上了，显示「未检测到客户端」说明没连上。旁边有「重新检测」和「启动客户端」两个按钮。

<Warning>\*\*回退是一次性的，不会补救。\*\*走了浏览器下载目录的剪藏不会排队等待，也不会在你之后启动桌面应用时被自动捞回资料库。想让它们被索引，只能自己把文件从下载目录挪进 Linkly AI 空间，或者把下载目录本身加进[索引文件夹](/docs/zh/indexing)。</Warning>

<Note>回退**不丢内容**——Markdown 和图片都在，只是位置不同。浏览器下载目录下的子目录名（默认 `Linkly`）可以在 **设置 → 下载设置 → 缺省目录** 里改。资料库那一侧的 `Clips/` 目录**不可单独配置**，它跟着你的 Linkly AI 空间位置走。</Note>

保存成功后工具栏会出现「**打开保存位置**」按钮，点一下就在系统文件管理器里打开这条剪藏的目录（较早的桌面应用版本上不会出现这个按钮）。

<Warning>桌面应用里**没有**浏览剪藏的界面。想看自己剪了些什么，去文件管理器打开 `~/LinklyAI/Clips` 目录。当然，剪藏内容本身是可以在[启动器](/docs/zh/use-launcher)和 [Chat](/docs/zh/use-chatbot) 里搜到的。</Warning>

***

## 剪藏文件长什么样

Markdown 顶部有一段 YAML front matter，声明兼容 Open Knowledge Format v0.1——这是给 AI Agent 看的元数据，让它一眼知道这份文件是什么、从哪来：

```yaml theme={null}
---
type: "Video Transcript"
title: "What is Linkly AI?"
resource: "https://www.youtube.com/watch?v=HnGMkWaWvVo"
timestamp: 2026-07-28T12:11:16Z
site: "YouTube"
author: "Linkly AI"
---
```

完整字段：`type`（内容类型）、`title`、`description`（摘要，和标题重复时省略）、`resource`（源 URL）、`tags`、`timestamp`（剪藏时间）、`site`、`author`、`published`（原文发布时间）、`lang`。有值才写入，没有的字段直接省略。

`type` 由站点决定，常见取值有 `Web Article`、`WeChat Article`、`X Thread`、`Zhihu Article`、`Video Transcript`、`AI Conversation`。

<Tip>不需要 front matter 的话，在 **设置 → 导出内容 → 包含 frontmatter** 里关掉，导出的就是纯正文。</Tip>

### 图片

正文里的图片会被**下载到本地**，Markdown 里的引用改写成本地相对路径——不保留远程链接，所以断网也能看图。

* 图片和 `.md` **平铺在同一个目录里**，没有 `image/` 子目录
* 命名规则是 `<标题>-visual-N.<扩展名>`
* 单条剪藏最多 200 个文件
* 只想要文字的话，关掉 **设置 → 导出内容 → 包含图片**：不下载任何图片，Markdown 里的图片引用也一并移除

***

## 针对特定网站的优化

通用的正文提取（去导航、去广告、去推荐位）对大部分网站够用，但有些站点结构特殊，我们做了专门适配：

| 站点                     | 适配内容                |
| ---------------------- | ------------------- |
| **ChatGPT / Claude**   | 整页会话导出，或单条回复导出      |
| **X（Twitter）**         | 推文串完整抓取，长文单独处理      |
| **YouTube / Bilibili** | 字幕转写成带时间戳的 Markdown |
| **微信公众号**              | 正文、作者、发布时间          |
| **知乎**                 | 回答 + 专栏文章           |
| **飞书文档**               | 从文档数据结构里读，不靠 DOM    |
| **小红书**                | 笔记正文 + 轮播图（排除头像）    |
| **微博**                 | 单条博文 + 配图           |
| **V2EX**               | 主题正文                |

代码块会自动识别语言并加上语言标注。其余站点走通用提取路径。

***

## 其他功能

### 本地翻译

侧边栏工具栏的「翻译」可以把当前 Markdown 翻成英文、简体中文、繁体中文、日文或韩文，随时切回原文。

用的是 **Chrome 内置的翻译模型**——不用配 API Key，内容不出这台电脑。首次使用某个语言对时会下载模型，侧边栏会显示进度。需要较新版本的 Chrome。

### 当阅读模式用

侧边栏的预览本身就是个干净的阅读器：自动排版、字号四档可调、跟随系统的暗色模式，还能对照读译文。不保存也没关系，就当一个去广告的阅读器用。

### AI 修补目录

有些页面没有标准的标题层级（比如整篇都是纯段落），侧边栏的目录就是空的。这时可以点「**生成 AI 目录**」，用 Chrome 内置的端侧模型提炼出小节标题，生成一个可跳转的目录。

复制和下载时默认会一并写入这些 AI 标题；想让导出和原文严格一致，在 **设置 → 导出内容 → 包含 AI 生成的文章标题** 里关掉。同样需要较新版本的 Chrome，且只在桌面版 Chrome / Edge 上可用。

### 导出单条 AI 回复

在 **ChatGPT** 和 **Claude** 的对话页面里，扩展会在每条 AI 回复旁边注入一个下载按钮——不用剪整页，单条回复一键存成 Markdown。

整页会话也能剪（点工具栏图标走常规流程），`type` 会是 `AI Conversation`。

***

## 和桌面应用配合

### 版本要求

剪藏直接存入 Linkly AI 空间需要**较新版本的桌面应用**——过旧的版本没有接收剪藏的接口，会被扩展当成"没有运行"，剪藏落到浏览器下载目录。桌面应用保持自动更新即可，不用手动比对版本号。

### 怎么通信的

扩展和桌面应用之间走的是**纯本机 loopback HTTP**（`127.0.0.1`），**完全不经过云端**。桌面应用侧有两道准入校验：只放行本机直连，且扩展来源必须在白名单里——其他程序和网页都连不上。

<Note>端口不保证是 60606：默认监听 60606，被占用时会顺延。扩展只探测 60606–60615 这 10 个端口，万一全被别的程序占了，桌面应用即使在跑也会被判定为"没运行"，剪藏落到浏览器下载目录。</Note>

### 剪藏之后多久能搜到

存进资料库的剪藏会被自动索引，但**不是立刻可搜**——文件监听有去抖，索引也要排队，通常是几秒到几十秒。刚剪完马上去搜可能搜不到，等一会儿再试。

索引的分层机制和排查方法见[索引设置](/docs/zh/indexing)。

***

## 常见问题

<AccordionGroup>
  <Accordion title="要不要登录？要不要付费？">
    \*\*无需登录，无需付费。\*\*提取、翻译、复制、下载、存进资料库——全部功能都不依赖登录。

    侧边栏里确实有一个「使用 Linkly AI 账号登录」的入口，但它目前只用来在账号按钮上展示你的信息，登不登录对功能没有任何影响。
  </Accordion>

  <Accordion title="必须装桌面应用吗？没开的时候剪藏会怎样？">
    不必须。提取正文、翻译、复制、下载都不依赖桌面应用，扩展可以完全独立使用。装了桌面应用的好处是剪藏能直接进资料库，和电脑上的其他文件一起被索引，之后任何 AI Agent 都能检索到——强烈推荐配合使用。

    桌面应用没运行时，剪藏自动回退到浏览器下载目录 `~/Downloads/Linkly/`，**内容不会丢**，侧边栏会明确提示「客户端未运行，已保存到浏览器下载目录」。但这些文件**不会**在你之后启动桌面应用时被自动捞回资料库，需要的话得自己挪进 Linkly AI 空间。
  </Accordion>

  <Accordion title="我剪的东西找不到了？">
    按这个顺序找：

    1. **资料库**：`~/LinklyAI/Clips/<剪藏标题>/`——桌面应用运行时的默认落点
    2. **浏览器下载目录**：`~/Downloads/Linkly/`——桌面应用没运行时的回退落点

    桌面应用里**没有**浏览剪藏的界面，只能在文件管理器里看。不确定当时走了哪条路？看看保存时那条提示写的是「已保存到 Linkly Space」还是「已保存到浏览器下载目录」。
  </Accordion>

  <Accordion title="剪藏完马上搜，搜不到？">
    正常。剪藏进入资料库后需要几秒到几十秒才会完成索引——文件监听有去抖，索引任务也要排队。等一会儿再搜。

    如果等很久还是搜不到，去 **设置 → 索引** 看看索引状态是不是卡住了，排查方法见[索引设置](/docs/zh/indexing)。
  </Accordion>

  <Accordion title="支持 Firefox 吗？">不支持。扩展目前只在 Chrome 应用商店上架。Edge、Brave 等 Chromium 内核的浏览器可以直接从 Chrome 应用商店安装，Firefox 则没有可用的版本。</Accordion>

  <Accordion title="有快捷键或者右键菜单吗？">
    都没有。扩展没有声明任何键盘快捷键，也不注册右键菜单项——打开侧边栏的唯一方式是点击工具栏上的扩展图标。

    唯一的例外是 ChatGPT 和 Claude 页面：那里会在每条 AI 回复旁注入一个下载按钮。
  </Accordion>

  <Accordion title="我剪藏的内容会被上传到你们的服务器吗？">
    不会。正文提取、翻译、生成目录**全部在你的浏览器里完成**。

    保存时也只有两个去处：本机的 Linkly AI 空间，或者浏览器下载目录。和桌面应用之间走的是本机 loopback（`127.0.0.1`），不经过任何网络服务。
  </Accordion>

  <Accordion title="为什么要「读取所有网站数据」的权限？">
    因为你可能在任意一个网站上剪藏，扩展需要能在当前页面运行提取脚本。它**只在你主动点击时**读取当前标签页的内容，不会在后台扫描你浏览的网页。
  </Accordion>
</AccordionGroup>

***

## 延伸阅读

* [索引设置](/docs/zh/indexing) —— 剪藏进资料库之后是怎么被索引的
* [使用启动器检索](/docs/zh/use-launcher) —— 搜到剪藏内容的最快方式
* [使用知识库](/docs/zh/use-libraries) —— 把剪藏划进特定知识库供 AI 按范围检索
* [快速开始](/docs/zh/quickstart) —— 桌面应用的安装与初始配置
* [Linkly AI 空间](/docs/zh/linkly-space) —— 剪藏落盘的那个目录，位置可以改
* [使用 AI 对话](/docs/zh/use-chatbot) —— 让 AI 直接读你剪藏的网页