用途:以 Markdown 文件加元数据的方式管理笔记本,并用 SQL 查询笔记集合。
主要能力:初始化笔记本(opennotes init)、创建笔记本(opennotes notebook create --name <name>)、添加笔记并写入 frontmatter(opennotes notes add "标题" --data k=v)、列表与文本/模糊搜索、布尔查询(opennotes notes search query --and data.status=active)、SQL 查询(opennotes notes search --sql "SELECT * FROM read_markdown('**/*.md')")、执行内置或自定义视图(opennotes notes view today、recent、untagged、orphans、broken-links)。还支持链接关系查询(links-to、linked-by)、按 glob 匹配路径。
使用方式:笔记本通过 .opennotes.json 定义,可自动向上查找父目录发现,或用 --notebook 指定;全局配置位于 ~/.config/opennotes/config.json,可注册多个笔记本并定义自定义视图。元数据字段用 data.* 访问,数组字段需用 SQL 的 array_contains(),布尔查询对数组字段不可靠。
限制:SQL 仅允许 SELECT 和 WITH,禁止 INSERT、UPDATE、DELETE、DROP;搜索区分大小写行为为不区分;笔记默认存放在笔记本根目录而非 .notes/。布尔查询更适合标量元数据。某些特性依赖版本(如 --data、模糊搜索、布尔查询、视图为 v0.0.3+,文本搜索为 v0.0.2+),使用前应检查 --help。不适于简单文件记录、二进制附件、实时协作编辑和版本控制(应另行使用 git)。