词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Siyuan"
Siyuan
Skill 元数据
| 来源 | 可选 — 使用 hermes skills install official/productivity/siyuan 安装 |
| 路径 | optional-skills/productivity/siyuan |
| 版本 | 1.0.0 |
| 作者 | FEUAZUR |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | SiYuan, Notes, Knowledge Base, PKM, API |
| 相关 skill | obsidian, notion |
参考：完整 SKILL.md
信息
SiYuan Note API
前提条件
1.
2.
3.
~/.hermes/.env 中：SIYUAN_TOKEN=your_token_here
SIYUAN_URL=http://127.0.0.1:6806SIYUAN_URL 默认为 http://127.0.0.1:6806。API 基础
{"code": 0, "msg": "", "data": { ... }}code: 0 表示成功。其他值均为错误 — 请检查 msg 获取详情。20210808180117-6v0mkxr（14 位时间戳 + 7 位字母数字字符）。快速参考
| 操作 | 端点 |
|---|---|
| 全文搜索 | /api/search/fullTextSearchBlock |
| SQL 查询 | /api/query/sql |
| 读取块 | /api/block/getBlockKramdown |
| 读取子块 | /api/block/getChildBlocks |
| 获取路径 | /api/filetree/getHPathByID |
| 获取属性 | /api/attr/getBlockAttrs |
| 列出笔记本 | /api/notebook/lsNotebooks |
| 列出文档 | /api/filetree/listDocsByPath |
| 创建笔记本 | /api/notebook/createNotebook |
| 创建文档 | /api/filetree/createDocWithMd |
| 追加块 | /api/block/appendBlock |
| 更新块 | /api/block/updateBlock |
| 重命名文档 | /api/filetree/renameDocByID |
| 设置属性 | /api/attr/setBlockAttrs |
| 删除块 | /api/block/deleteBlock |
| 删除文档 | /api/filetree/removeDocByID |
| 导出为 Markdown | /api/export/exportMdContent |
常用操作
搜索（全文）
搜索（SQL）
id、parent_id、root_id、box（笔记本 ID）、path、content、type、subtype、created、updated。读取块内容
读取子块
获取人类可读路径
获取块属性
列出笔记本
列出笔记本中的文档
创建文档
创建笔记本
向文档追加块
/api/block/prependBlock（参数相同，在开头插入）和 /api/block/insertBlock（使用 previousID 代替 parentID，在指定块之后插入）。更新块内容
重命名文档
设置块属性
custom- 为前缀：删除块
/api/filetree/removeDocByID，参数为 {"id": "DOC_ID"}。删除笔记本：使用
/api/notebook/removeNotebook，参数为 {"notebook": "NOTEBOOK_ID"}。将文档导出为 Markdown
块类型
type 值：| 类型 | 描述 |
|---|---|
d | 文档（根块） |
p | 段落 |
h | 标题 |
l | 列表 |
i | 列表项 |
c | 代码块 |
m | 数学块 |
t | 表格 |
b | 引用块 |
s | 超级块 |
html | HTML 块 |
注意事项
YYYYMMDDHHmmss-xxxxxxx。不符合此模式的应予以拒绝。data 之前，始终检查响应中的 code != 0。LIMIT，并通过 jq 管道仅提取所需内容。lsNotebooks 获取其 ID。替代方案：MCP Server