Logseq交互

技能简介

Logseq交互（logseq）提供与本地 Logseq 实例交互的命令。通过 JavaScript Plugin API 创建页面、插入块、查询图谱数据库、管理任务、检索内容和自动化工作流。

业务背景

面向习惯用Logseq做知识管理的团队和个人，无需切换界面即可通过自动化指令操作本地笔记库。核心价值在于把分散的笔记数据接入企业工作流——自动创建会议纪要页面、批量更新任务状态、按条件检索知识片段，减少手工维护成本，让个人知识库成为可编排的业务资产。

落地案例：某产品团队每日站会后需同步TODO到周报。配置该能力后，系统自动执行Datalog查询抓取所有DOING状态任务，按项目归类插入周会页面，并标记已完成项为DONE。原本15分钟的手工整理变为触发即完成，确保信息实时同步且格式统一。

能做什么

• 创建页面和插入块
• 使用 Datalog 查询图谱数据库
• 管理任务（TODO/DOING/DONE）
• 检索页面和块内容
• 自动化笔记工作流
• 注册自定义命令
• 执行 Git 操作

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install logseq

前置要求：Logseq 必须在本地运行，并安装暴露 API 的插件。安装桥接插件通过 HTTP 暴露 logseq API，或使用 Node.js 与 @logseq/libs 包脚本。

核心命名空间：logseq.App（应用操作）、logseq.Editor（块和页面编辑）、logseq.DB（Datalog查询）、logseq.UI（UI操作）、logseq.Git（Git操作）、logseq.Assets（资源管理）。

读取内容示例：获取当前页面：const page = await logseq.Editor.getCurrentPage()，获取页面块：const blocks = await logseq.Editor.getPageBlocksTree('Daily Notes')，Datalog查询：const results = await logseq.DB.q('[:find (pull ?b [*]) :where [?b :block/marker "TODO"]]')。

写入内容示例：创建页面：await logseq.Editor.createPage('Project Notes', {tags: 'project'})，插入块：await logseq.Editor.insertBlock('target-uuid', '- New task')，更新块：await logseq.Editor.updateBlock('uuid', 'Updated content')。

任务管理：查找所有 TODO：使用 Datalog 查询 :block/marker 为 TODO 或 DOING 的块。

输入与输出

见下方输入与输出表格。

风险提示

• 需要本地运行 Logseq 并启用 API
• 需要桥接插件或代理访问 API
• API 主要设计用于浏览器插件
• 外部脚本访问需要桥接/代理
• 注意数据备份，操作可能影响笔记内容

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/juanirm/logseq/SKILL.md

来源类型：GitHub

常见问题

Q1：Logseq交互 适合哪些场景？
A：适合需要「技能简介 Logseq交互（logseq）提供与本地 Logseq 实例」的场景，尤其是希望快速验证并落地的团队与个人。

Q2：第一次使用应该先做什么？
A：先明确目标任务，再按照页面中的“能做什么”和“使用说明”完成最小可行流程。

Q3：如何判断是否值得长期使用？
A：建议连续使用 1-2 周，对比效率、稳定性和协作成本，再决定是否纳入长期工具栈。

替代方案

可结合同分类工具进行横向对比，优先选择与你任务最贴合的方案。

相关推荐

可从本页下方“相关技能”继续扩展。