memory-start

Memory Start

新用户刚刚连接了 Basic Memory。在首次会话中，带他们走完整个流程：保存一条内容、查看它、在新聊天中找回它，再为它补充内容。保持简短。使用他们实际的工作内容，不要用演示内容。

直白地说。不要解释架构、观察内容或知识图谱。 说“笔记”，不要说“实体”。

项目范围

如果项目未知，使用 bm_project_list() 查找。列表会标记默认项目。除非用户指定其他项目，否则使用默认项目。每次调用笔记、搜索和文件夹时，都传入相同的 project。

保存

默认保存。连接记忆服务就表示用户希望保存笔记，所以首次保存前不要询问。用一行告诉用户你保存了什么，以及如何撤销。

如果用户说“先问我”，说明你打算保存什么以及保存到哪里；在本次对话剩余时间内，只有用户同意后才保存。若要让这项设置在每次聊天中都生效，建议他们在助手的自定义指令中添加类似下面的一行：

保存任何内容到 Basic Memory 前都先问我。

1. 保存一条内容

在只包含入门笔记的项目中，或首次会话初期执行此操作。等用户说明他们正在做什么后再操作。跳过琐碎聊天（“2+2 等于几”），也跳过明显属于个人或敏感的内容，例如健康、金钱或他人的隐私信息，除非用户要求保存。

先搜索（bm_search），避免重复已有笔记。 然后写一条简短笔记：

• 一个清晰的标题，例如 Q3 pricing plan；
• 用两三句话说明这项工作是什么、目前进展如何；
• 在 ## Observations 下列出两三条 [category] 事实。

不要写聊天记录。也不要写聊天摘要。

bm_write(
    project="<project>",
    title="Q3 pricing plan",
    directory="notes",
    overwrite=False,
    content="""Planning new pricing for the Q3 launch. Two tiers are on the table.
The team wants a decision before the July board meeting.

## Observations
- [goal] Pick between flat and usage-based pricing for Q3
- [deadline] Decision needed before the July board meeting
- [open_question] Whether the free tier stays""",
)

然后用一行说明你保存了什么，其中包含工具结果中的链接、如何撤销，以及如何选择退出：

已将“Q3 pricing plan”保存到 Basic Memory。说“撤销”即可删除；如果你想先审核保存内容，请说“先问我”。

只使用工具返回的链接。绝不要自行构造 URL。

2. 查看笔记

主动提出展示笔记。提供保存时返回的链接。如果宿主有 Basic Memory 应用（可使用 bm_open），主动提出打开它：

bm_open(view="note", identifier="Q3 pricing plan", project="<project>")

3. 找回笔记

告诉用户如何在新聊天中使用这条笔记：

在任何新聊天中，问我“我们保存了哪些关于 Q3 pricing 的内容？”

除非用户的指令或消息提示你检查，否则你无法在新聊天开始时检查记忆。因此，提供一行内容，让用户可以将它粘贴到助手的自定义指令或项目指令中：

使用 Basic Memory 查找和保存与我工作相关的笔记。

如果你知道这行内容在此宿主中应放在哪里，就告诉用户：聊天应用中的项目指令或自定义指令，或编码工具中的 Agent 上下文文件。如果不知道，就提供这行内容并说明“把它粘贴到助手的自定义指令中”。如果用户暂时不想设置，不要要求他们现在就设置。

4. 补充笔记

之后再次提到同一主题时，更新那条笔记，而不是新建一条。搜索并阅读它，然后使用 bm_edit 添加新事实或更正过时的内容。用一行说明你做了哪些更改。

撤销

如果用户在保存后说“撤销”，删除你刚写的笔记，并用一行确认：

bm_delete(project="<project>", identifier="<path from the save result>")

如果保存时更新了现有笔记，则不要删除它。将它编辑回原来的状态，并说明这一点。

接下来

首次会话中不要提供完整设置方案。等用户有了几条笔记并重新查阅过后，再提供 memory-onboarding，帮助他们设计包含笔记类型和文件夹的完整系统。