用途:为 Basic Memory 中的结构化笔记类型建立与管理 schema。Picoschema 定义某类笔记应包含哪些字段,使笔记统一、可查询、可校验。适用于:某类笔记(会议、人物、决策)反复出现相同结构时;校验既有笔记是否符合 schema;检测 schema 漂移;随需求演进增删改字段;用户主动要求创建、检查或管理 schema 时。
主要能力:schema 用 YAML frontmatter 中的 Picoschema 描述,支持基础类型 string、integer、number、boolean;字段名后加 ? 表示可选;用 (enum) 加允许值列表表示枚举;用 (array) 表示列表字段;直接引用其他实体类型表示关系,会在知识图谱中建立边。校验设置 settings.validation 可取 warn(记录问题)或 error(严格)。schema_infer(noteType="Meeting") 可分析既有笔记生成建议 schema,threshold(0.0–1.0)控制字段需多常见才被纳入。schema_validate(noteType="Meeting") 或 schema_validate(identifier="...") 校验一致性,报告缺失必填字段、未知字段、类型不匹配、非法枚举值。schema_diff(noteType="Meeting") 检测漂移,报告笔记有而 schema 无的字段、schema 中罕用字段、类型不一致。schema 笔记存放于 schema/,note_type="schema",metadata 中 entity 指定适用类型,version 用于破坏性变更时递增。
使用方式:用 write_note 写入 schema/<EntityName>;用 edit_note 更新(如 find_replace 修改 version 或字段块);创建后用 schema_validate 复查,用 edit_note 修正不符合的笔记。
限制与注意:schema_validate 以笔记正文中的 observation 类别检查 schema 字段,例如 status 字段需存在 - [status] active,仅写在前言元数据中不算通过校验;建议字段同时写入前言与 observation。演进原则:新增可选字段无需升版本,破坏性变更(新增必填、删除字段、改类型)应升版本;优先可选而非必填,避免过度约束。warn 模式适合起步,error 模式适合自动管道等严格场景。其余事实资料未提供。