用途:这是一份思源笔记(SiYuan)的知识库,帮助 AI 正确使用思源特色功能,不包含个人归档规则。
主要能力:
- 内容块概念:思源中所有内容都是块(文件、标题、段落、列表、引述、代码、表格、超级块、嵌入块、公式、分隔线),块可互转、带属性、有块级粒度。
- 引用与双向链接:语法 ((<block_id> '动态锚文字')) 单引号锚文字随原文变化,双引号为静态;建立引用自动产生正向与反向链接,并在关系图可视化。超链接 文字 不建立关联。建议首次出现时引用、预设用单引号。
- 标签系统:语法 #标签名#,层级标签用 / 分隔如 #工具/LibreNMS#;注意 #Docker# 被写作行内代码、缺结尾 #、# 后有空格都会失效。
- 块属性:内建 id、updated、type、name、alias、memo、bookmark;自定义属性以 custom- 开头。
- 嵌入块:用 {{ SQL }} 动态查询并嵌入内容。
- SQL 查询:思源内置 SQLite,主要表有 blocks、attributes、refs、spans;常用字段 id、root_id、box、type、content、markdown、tag、hpath、path、created、updated。
- REST API:均为 POST + JSON,需 Authorization: Token <your_token>,例如 POST /api/query/sql、/api/filetree/createDocWithMd、/api/block/appendBlock、/api/block/insertBlock、/api/attr/setBlockAttrs、/api/search/getTags、/api/export/exportMdContent。
使用方式与限制:注意 createDocWithMd 的 path 末段自动成为标题,markdown 不要再写 # 标题;删除文件用 removeDoc 且会递归删除子文件;SQL 有索引延迟,即时性需求用 listDocsByPath;insertBlock 需通过查询 heading 下最后一个 list block 确定 previousID,不能用 appendBlock 追加到 heading 下方。缺失事实暂未提供。