如何将网页或选中的文字保存到 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)

选择要保存的内容

• Article：简化的文章正文，会去掉大部分导航。请确认预览中没有遗漏重要章节。
• Full page：范围更广的页面内容，可能包含菜单和次要文字。
• Selection：先在原网页选中文字，再检查保存的确实是所选片段。
• URL-only：暂时不需要全文时，只保存链接。

1. 打开 Kliplet，选择模式和 Logseq。
2. 核对标题、内容和目标页面。
3. 只保存一次；在 Logseq 中检查文字的开头与结尾、块结构和来源链接。

连接或保存失败时怎么办

• 无法连接：检查图谱、服务器、地址和令牌。
• 已连接但没有块：检查当前图谱中配置的目标页面。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