用途:把一条工作线程的当前状态——已做出的决策、浮现的洞察、积累的上下文——保存为一篇连贯的 Basic Memory 笔记。笔记反映线程最终落点,而不是演变历史。适合在线程中段或结尾、有值得保留的内容后使用,例如关键决策已定、设计或调试讨论产生了具体结论、用户明确要求记录、或会话结束时总结成果。同一线程可多次调用。
主要能力:同一线程内重复捕获时原地重写同一篇笔记,而不是新建。通过 frontmatter 中的稳定 thread_id 识别同一线程;若无稳定 id,则按标题/主题匹配已有笔记。有 thread_id 时用 search_notes(metadata_filters={"thread_id": "<thread-id>"}, project="<project>") 查找,否则用 search_notes(query="<thread topic>", project="<project>")。找到后先 read_note 读取完整 permalink,再以 write_note(..., overwrite=True) 覆盖,保持相同标题、thread_id 与目录。
使用方式与结构:综合而非追加。仍有效的决策保留并可细化;被取代的决策就地替换;值得说明的重大修改以一句话融入相关段落;过时上下文删除。笔记结构含 title、type、thread_id、tags 的 frontmatter,正文包括 Context、若干主题小节、Observations 与 Relations。观察类别常用 [decision]、[insight]、[pattern]、[learning]、[tradeoff]、[problem]、[solution]。用户明确要求单独成篇时,跳过同线程查找,新笔记且不设 thread_id。
限制:不追加变更日志,不设 ## Changes 章节;标题不应漂移到全新主题,若需新主题应走独立新建路径;thread_id 是否可用取决于宿主是否暴露稳定的会话/线程 id,否则回退为按标题/主题匹配。