用途:memory-okf 用于让 Basic Memory 项目准备好进行 OKF v0.2 导出,查找并修复阻碍导出的问题。OKF v0.2 是一种知识目录格式,由带 YAML frontmatter 的 Markdown 概念文件、每个文件夹的 index.md 和根目录 log.md 组成。Basic Memory 项目的 wiki 投影会写入 index.md 与 log.md,导出时把 wikilinks 转为标准 Markdown 链接。该技能使用 note 工具,可在 Basic Memory Cloud 和本地使用:Cloud 中导出作为 Cloud 任务运行,本地为 bm okf export。保留项目的 wikilinks,导出会自行转换。
主要能力与流程:先定位阻碍项,例如文件名以 .markdown 或 .MD 结尾、自己的笔记命名为 index.md 或 log.md、笔记使用了 bm.okf_export 或 bm 不是映射;分页遍历直到 has_more 为 false。再逐项修复:用 move_note 将 .markdown 或 .MD 改为 .md,将自己的 index.md 或 log.md 改为说明性名称如 notes/overview.md,或按 JSON 读取后仅重写该修订的 frontmatter(write_note 配合 expected_checksum)。不要手动编辑 wiki 的 index.md 或 log.md,投影器会重写它们。最后报告重命名或重写的内容及留给用户决定的事项,并说明项目已可导出。
本地导出与检查:可用 bm wiki status --project research、bm wiki rebuild --project research、bm okf export ~/exports/research --project research --json、bm okf check ~/exports/research --json。bm wiki status 会把手工编写的 index.md 或 log.md 报告为 conflicted。导出会先暂存并验证,拒绝时保留目标原样;除非给出 --replace,否则拒绝已存在的目标。bm okf check 对有效 bundle 退出码 0,违规为 1,且是结构性的,接受断开的交叉链接。应在 bundle 上运行 check,而非项目。
限制与说明:无 frontmatter 的笔记可以接受,Basic Memory 索引时会补 title 和 type;允许断开的链接,导出保留它们。修复应在项目中完成,对 bundle 的编辑会在下次导出丢失。缺少 frontmatter 的笔记、费用、平台细节等未在资料中提供。