思源笔记API技能：全文搜索、块内容获取、SQL查询与资源管理指南

🇺🇸English

快速使用指南

核心方法

searchNotes - 全文搜索笔记

# 全文搜索（推荐，支持中文分词，返回格式化字符串）
node -e "const s = require('./index.js'); (async () => { console.log(await s.searchNotes('关键词', 20)); })();"

# 按类型搜索（只搜索标题）
node -e "const s = require('./index.js'); (async () => { console.log(await s.searchNotes('关键词', 10, 'h')); })();"

# 翻页（第2页）
node -e "const s = require('./index.js'); (async () => { console.log(await s.searchNotes('关键词', 20, null, 2)); })();"

返回格式：

• 单条结果 ：📄 [文档ID] /路径 > [类型 块ID] 内容

• 多条结果 ：

  📄 [文档ID] /路径
    1. [类型 块ID] 内容
    2. [类型 块ID] 内容
  

• 内容预览 ：最多显示 150 字符，超出会显示 ...

getBlockByID - 获取块的详细内容

# 获取指定块的内容（返回 kramdown 源码，文档块包含反向链接）
node -e "const s = require('./index.js'); (async () => { console.log(await s.getBlockByID('块ID')); })();"

getLocalAssetPath - 获取资源文件的本地路径

# 获取资源文件（图片、附件等）的本地完整路径
node -e "const s = require('./index.js'); (async () => { 
  const path = await s.getLocalAssetPath('块ID', 'assets/image-xxx.webp'); 
  console.log(path); 
})();"

返回示例：

/home/gs/.claude/skills/siyuan-notes/.tmp/assets/image-20251223152400-195ojeh.webp

使用场景：

• 笔记中有图片需要分析时，获取本地路径后可直接使用 image-processing 技能
• 支持本地部署的思源笔记（localhost）
• 自动处理认证和临时文件管理

extractAssetsFromBlock - 提取块中的所有资源

# 提取指定块中所有的资源文件路径
node -e "const s = require('./index.js'); (async () => { 
  const assets = await s.extractAssetsFromBlock('块ID'); 
  console.log(assets); 
})();"

返回格式：

[
  {
    "path": "assets/image-20251223151651-8wilav6.webp",
    "type": "image"
  }
]

SQL查询（高级用法）

# SQL查询（返回精简后的原始数据数组）
node -e "const s = require('./index.js'); (async () => { console.log(await s.executeSiyuanQuery('SELECT * FROM blocks WHERE content LIKE \\\"%关键词%\\\" LIMIT 10')); })();"

块类型参数

h-标题 p-段落 d-文档 l-列表 c-代码 t-表格 b-引用

⚠️ 限制

不要使用 cwd 参数、不要创建临时文件、不要使用 cd 命令

搜索策略指南

核心原则

持续尝试，直到解决用户问题：

1. 尝试同义词/相关词
2. 尝试模糊关键词 （拆分复合词）
3. 尝试不同块类型 （标题、段落、文档）
4. 尝试翻页获取更多结果
5. 尝试SQL组合查询

关键词扩展技巧

SQL 查询参考

blocks 表结构

• id: 块ID | type: 块类型(d/h/p/l/c/t/b) | subtype: 子类型
• content: 纯文本 | markdown: Markdown文本 | hpath: 人类可读路径
• created/updated: 创建/更新时间 (YYYYMMDDHHmmss)
• root_id: 所属文档ID | parent_id: 父块ID | box: 笔记本ID

SQL 示例

-- 查询段落块
SELECT * FROM blocks WHERE type='p' AND content LIKE '%关键词%'

-- 组合查询（多个关键词）
SELECT * FROM blocks WHERE content LIKE '%关键词1%' OR content LIKE '%关键词2%'

-- 查询最近7天
SELECT * FROM blocks WHERE updated > strftime('%Y%m%d%H%M%S', datetime('now', '-7 day'))

-- 查询反向链接
SELECT * FROM blocks WHERE id IN (SELECT block_id FROM refs WHERE def_block_id='块ID')

Weekly Installs

1

Repository

2234839/siyuan-…es-skill

GitHub Stars

47

First Seen

1 day ago

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

amp1

cline1

openclaw1

opencode1

cursor1

kimi-cli1