它能做什么
Linkly AI Clipper 是 Linkly AI 的浏览器扩展，做的事情只有一件：把网页存为 Agent 友好的 Markdown。 一键把当前页面转成排版干净的 Markdown，在侧边栏里预览、复制或下载到本地。不只是「保存网页」——正文、图片、译文、视频字幕，连同你和 AI 的对话，全都能变成一份干净的、可被 Agent 轻松使用的 Markdown 文件。存下来就是 Agent 能读的格式
带 YAML 头部和清晰的章节结构，X、微博这类内容也单独优化过
直接进你的资料库
装了桌面应用时，剪藏直接落进 Linkly AI 空间，和你电脑上的其他文件一起被索引
图片一起带走
正文里的图片下载到同一个文件夹，断网也能正常阅读图文
全程在本地完成
提取、翻译、生成目录全部在你的浏览器里完成，不经过我们的服务器
安装
从 Chrome 应用商店安装：Linkly AI Clipper。剪藏第一个页面
1
打开一个文章页面
随便打开一篇文章、一条推文、一个知乎回答，或者一个 YouTube 视频页面。
2
点击工具栏上的 L 图标
浏览器右上角的扩展图标点一下，右侧会打开侧边栏，自动开始提取当前页面的正文并转成 Markdown。
**没有右键菜单，也没有键盘快捷键。**打开侧边栏的唯一方式就是点工具栏图标。建议把扩展固定到工具栏上（扩展菜单里点一下图钉）。
3
检查结果，然后复制或保存
默认是预览视图——排版好的阅读界面。工具栏上还有「编辑源码」（切到原始 Markdown 直接改）、「源信息」（来源 URL / 站点 / 作者 / 发布时间）、「目录」和四档字号调节。确认没问题后，点「复制」把整份 Markdown 送进剪贴板直接粘给 AI 助理，或者点「下载」保存成文件——具体落到哪见下一节。
切换标签页时会自动重新转换。不想要这个行为的话，去 设置 → 自动刷新 关掉，之后需要手动点「重新转换」。
剪藏保存到哪
这是最容易困惑的一点：同一个「下载」按钮，会根据桌面应用在不在跑，走两条完全不同的路径。
每条剪藏是一个目录，里面放着
.md 文件和它的图片。
怎么知道走的是哪条路
保存后侧边栏底部会弹一条提示，四选一：
也可以主动确认：打开 设置 → 下载设置，「保存到 Linkly Space」这一行会显示当前状态——显示「在线」并带上桌面应用版本号说明连上了，显示「未检测到客户端」说明没连上。旁边有「重新检测」和「启动客户端」两个按钮。
回退不丢内容——Markdown 和图片都在，只是位置不同。浏览器下载目录下的子目录名（默认
Linkly）可以在 设置 → 下载设置 → 缺省目录 里改。资料库那一侧的 Clips/ 目录不可单独配置，它跟着你的 Linkly AI 空间位置走。剪藏文件长什么样
Markdown 顶部有一段 YAML front matter，声明兼容 Open Knowledge Format v0.1——这是给 AI Agent 看的元数据，让它一眼知道这份文件是什么、从哪来：type（内容类型）、title、description（摘要，和标题重复时省略）、resource（源 URL）、tags、timestamp（剪藏时间）、site、author、published（原文发布时间）、lang。有值才写入，没有的字段直接省略。
type 由站点决定，常见取值有 Web Article、WeChat Article、X Thread、Zhihu Article、Video Transcript、AI Conversation。
图片
正文里的图片会被下载到本地，Markdown 里的引用改写成本地相对路径——不保留远程链接，所以断网也能看图。- 图片和
.md平铺在同一个目录里，没有image/子目录 - 命名规则是
<标题>-visual-N.<扩展名> - 单条剪藏最多 200 个文件
- 只想要文字的话，关掉 设置 → 导出内容 → 包含图片：不下载任何图片，Markdown 里的图片引用也一并移除
针对特定网站的优化
通用的正文提取（去导航、去广告、去推荐位）对大部分网站够用，但有些站点结构特殊，我们做了专门适配：
代码块会自动识别语言并加上语言标注。其余站点走通用提取路径。
其他功能
本地翻译
侧边栏工具栏的「翻译」可以把当前 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），完全不经过云端。桌面应用侧有两道准入校验：只放行本机直连，且扩展来源必须在白名单里——其他程序和网页都连不上。
端口不保证是 60606：默认监听 60606，被占用时会顺延。扩展只探测 60606–60615 这 10 个端口，万一全被别的程序占了，桌面应用即使在跑也会被判定为”没运行”，剪藏落到浏览器下载目录。
剪藏之后多久能搜到
存进资料库的剪藏会被自动索引，但不是立刻可搜——文件监听有去抖，索引也要排队，通常是几秒到几十秒。刚剪完马上去搜可能搜不到，等一会儿再试。 索引的分层机制和排查方法见索引设置。常见问题
要不要登录？要不要付费？
要不要登录？要不要付费？
**无需登录，无需付费。**提取、翻译、复制、下载、存进资料库——全部功能都不依赖登录。侧边栏里确实有一个「使用 Linkly AI 账号登录」的入口，但它目前只用来在账号按钮上展示你的信息，登不登录对功能没有任何影响。
必须装桌面应用吗？没开的时候剪藏会怎样？
必须装桌面应用吗？没开的时候剪藏会怎样？
不必须。提取正文、翻译、复制、下载都不依赖桌面应用，扩展可以完全独立使用。装了桌面应用的好处是剪藏能直接进资料库，和电脑上的其他文件一起被索引，之后任何 AI Agent 都能检索到——强烈推荐配合使用。桌面应用没运行时，剪藏自动回退到浏览器下载目录
~/Downloads/Linkly/，内容不会丢，侧边栏会明确提示「客户端未运行，已保存到浏览器下载目录」。但这些文件不会在你之后启动桌面应用时被自动捞回资料库，需要的话得自己挪进 Linkly AI 空间。我剪的东西找不到了？
我剪的东西找不到了？
按这个顺序找：
- 资料库：
~/LinklyAI/Clips/<剪藏标题>/——桌面应用运行时的默认落点 - 浏览器下载目录：
~/Downloads/Linkly/——桌面应用没运行时的回退落点
剪藏完马上搜，搜不到？
剪藏完马上搜，搜不到？
正常。剪藏进入资料库后需要几秒到几十秒才会完成索引——文件监听有去抖，索引任务也要排队。等一会儿再搜。如果等很久还是搜不到，去 设置 → 索引 看看索引状态是不是卡住了，排查方法见索引设置。
支持 Firefox 吗？
支持 Firefox 吗？
不支持。扩展目前只在 Chrome 应用商店上架。Edge、Brave 等 Chromium 内核的浏览器可以直接从 Chrome 应用商店安装，Firefox 则没有可用的版本。
有快捷键或者右键菜单吗？
有快捷键或者右键菜单吗？
都没有。扩展没有声明任何键盘快捷键，也不注册右键菜单项——打开侧边栏的唯一方式是点击工具栏上的扩展图标。唯一的例外是 ChatGPT 和 Claude 页面：那里会在每条 AI 回复旁注入一个下载按钮。
我剪藏的内容会被上传到你们的服务器吗？
我剪藏的内容会被上传到你们的服务器吗？
不会。正文提取、翻译、生成目录全部在你的浏览器里完成。保存时也只有两个去处：本机的 Linkly AI 空间，或者浏览器下载目录。和桌面应用之间走的是本机 loopback（
127.0.0.1），不经过任何网络服务。为什么要「读取所有网站数据」的权限？
为什么要「读取所有网站数据」的权限？
因为你可能在任意一个网站上剪藏，扩展需要能在当前页面运行提取脚本。它只在你主动点击时读取当前标签页的内容，不会在后台扫描你浏览的网页。