Logseq 网页剪藏：保存片段和来源链接

连接一个本地图谱

1. 需要具有 HTTP APIs server 功能的桌面版 Logseq、已打开的图谱以及运行中的服务器。这不是连接 Logseq 网站账户。首次测试请创建独立测试图谱和页面。
2. 在 Logseq 设置中启用 HTTP APIs server，打开 API 面板，创建授权令牌并启动服务器。不同版本的菜单名称可能不同。
3. 在 Kliplet 中打开 Options → Targets（选项 → 目标），添加 Logseq，填写 http://127.0.0.1:12315 和令牌。地址末尾不要加 /api。
4. 选择当前图谱中已存在的页面并测试连接。保存时保持 Logseq 和服务器运行。

Logseq HTTP API (EN)

保存第一段有用的内容

1. 打开一篇公开文章，选中一个简短段落。
2. 打开 Kliplet，选择 Selection（选中内容），并只勾选 Logseq 目标。核对标题和预览。
3. 只保存一次。在 Logseq 中打开配置的页面，检查文字和来源链接，再点击链接确认能回到原文。

连接测试成功只能确认设置，不代表笔记已经保存。第一次测试不需要 AI、同步或付费套餐。

连接或保存失败时怎么办

• 无法连接：检查图谱、服务器、地址和令牌。
• 已连接但没有块：检查当前图谱中配置的目标页面。HTTP 响应本身不能证明笔记已保存。
• 超时或结果不明：先查看目标页面，因为写入可能已完成。Logseq 写入不会进入持久重试队列；手动重新保存仍可能产生重复内容。
• 没有兼容的 API：使用 Markdown 目标把文字和来源保存为文件。这是替代输出方式，不代表已验证与 Logseq DB 的直接兼容性。

内容会发送到哪里

使用默认回环地址时，向 Logseq 写入的请求留在本机。如果配置 LAN 地址或远程 HTTPS 端点，该端点会收到内容和令牌。扩展不发送使用情况分析。AI 和同步是分别选择启用的功能：启用 AI 后，最多 12,000 个字符的提取文本会发送给选定的服务商。Kliplet 后端还单独处理 Notion OAuth、付款和许可证。

原网页上的高亮

Alt+H 将高亮保存在本地，并在再次访问原网页时恢复显示。默认情况下它们不是 Logseq 块。要将其包含在保存内容中，需要另行选择付费自定义模板，并加入 {{highlights}}。

实际验证的范围

2026 年 10 月 28 日，候选版 Kliplet 1.1.7 已在独立测试图谱中与真实 Logseq OG 1.0.0 完成验证，覆盖文章、选区、来源、错误令牌、关闭 API 和响应丢失。这是候选版验证，不代表它已在商店发布。Logseq DB 尚未验证。OG 与 DB 是不同产品线，不能假设 API 一致。请在自己的版本中核对一次实际保存。使用的方法包括 getCurrentGraph、appendBlockInPage 和 getBlock；候选版还通过 insertBatchBlock 写入子块。

将 Kliplet 添加到 Chrome