用途:使用 Basic Memory 的 Picoschema 系统管理结构化笔记类型。模式定义某类笔记应含哪些字段,使笔记统一、可查询、可校验。适用情形包括:出现新笔记类型(多篇笔记结构相似)、执行校验检查、检测模式漂移、随需求演进模式,或用户主动要求创建、检查、管理模式。
Picoschema 语法:模式写在 YAML frontmatter 中。基本类型有 string、integer、number、boolean;字段名后加 ? 表示可选;用 (enum, 说明): [值列表] 定义枚举;用 (array) 定义数组;直接引用其他实体类型(如 Person、Task)定义关系,会在知识图谱中建立边。settings.validation 可设为 warn(记录问题)或 strict(报错,为推荐的强制模式,error 仅为兼容别名)。
主要能力与用法:
- 发现无模式笔记:用 search_notes(note_types=[...]) 找共享类型但无模式文件的笔记簇;用 schema_infer(note_type="Meeting") 推断模式,threshold(0.0–1.0)控制字段需在多少比例笔记中出现才纳入。
- 创建模式:用 write_note 写入 schema/<EntityName>,note_type="schema",metadata 中 entity 命名适用类型,version 为版本号。
- 校验笔记:schema_validate(note_type=...) 或 schema_validate(identifier=...)。注意校验检查的是笔记正文中的观察分类(如 - [status] active),仅存于 frontmatter 的字段不满足校验,因此字段宜同时作为 frontmatter 值和观察出现。报告会列出缺失的必填字段、无效枚举值;未声明的观察分类和关系作为信息性未匹配项列出;标量值不做类型检查。
- 检测漂移:schema_diff(note_type=...) 报告笔记有但模式无的字段、模式中少用的字段、单值与数组之间的基数变化。
- 模式演进:用 edit_note 更新模式(顶层键整体替换,需传入完整模式与新版号),随后重新校验并修正不合规笔记。新增可选字段为安全变更,新增必填字段、删除字段或改类型属破坏性变更应提升版本号。
限制与说明:模式应描述共同结构而非僵化模板,优先可选字段,勿过度约束;warn 模式下模式仍可作为笔记内容的活文档。其余如具体平台、收费、价格等信息暂未提供。