brethof-brain 文档——设置、规则以及如何使用您的记忆

为什么工作原理项目与规则操作手册安装定价联盟伙伴文档账户免费开始使用更多来自Brethof AI的内容 Voice Pro brethof-brain 3D打印 Nova 评测精选列表指南

文档

十分钟后，您就能带着一个已了解您的项目、您的规则以及各项进展的代理重新投入工作——而且是在您所有的设备上。本页面帮您完成连接，然后用通俗的语言说明您的记忆能为您做什么、如何训练它，以及存满后会发生什么。一周后，您会注意到的是消失的东西：您不再需要反复向代理解释自己了。

快速入门钥匙与项目记忆如何运作日复一日账本操作手册规则空间与用量常见问题解答

快速入门

三步，其中一步为可选。

一个账户即可为你在所有机器上运行的每个代理提供支持。

拿一把钥匙。

在brethof.ai/account创建您的账户，选择记忆存储的位置——本地（您自己的机器）或托管（我们的加密云服务，位于德国）——设置密码短语，启用免费套餐，并生成API密钥。无需信用卡。本地或托管的选择只需做一次；套餐和包则可以随时更改。

连接您的代理

请从下方选择您的平台。大多数平台的安装只需一行命令——在任意平台上，您只需说 “install brethof-brain”，让代理完成安装即可。本地版：机器上需要 Docker 或 Podman，以及约 3 GB 的磁盘空间（包括记忆模型，只需下载一次）；无需管理员权限。

如果你想的话，去检查一下。

让你的代理在记忆中搜索任何信息，哪怕是微不足道的内容。一个完整的回答——哪怕是“未找到结果”——都意味着你已经建立了连接。这就是整个测试。

插件——只需一步即可安装，无需克隆，也无需使用pip。

已在 Linux 和 Windows 上验证

# 在 Claude Code 中：
/plugin marketplace add BrethofAI/brethof-brain-client
/plugin install brethof-brain@brethof
# 然后插件的连接窗口会出现在您的屏幕上：粘贴您的密钥
#（托管版：还包括您的密码短语）。您的代理两者都看不到。
# 建议：将插件 README 中的记忆块添加到
# ~/.claude/CLAUDE.md，这样“记住这个”就会存入 Brain。
# 完成——会话开始时已获知上下文，每次提示都能回忆，
# 每次交流都会存档并从中学习。

已安装，但似乎未被使用？在那些支持钩子的平台上，内存会被直接发送到代理端，无需额外设置。而在不支持钩子的平台上，系统会将相关内存信息写入平台的上下文文件中，这样代理端就会知道该去获取这些数据。如果内存看似已连接，但代理端却从未尝试获取它，那么首先应该检查的就是那个文件。

Claude Code上所写入的内容

在 Claude Code 中，通过 pip install (brethof-brain install-hooks) 可以在你的 CLAUDE.md 文件中保留一个受管理的块，该块会在每次会话开始时被重写。它只是一个指针，而非教学内容的副本——它告诉你的智能体记忆存储在 Brain 中以及如何访问它；当你说“记住这个”时，内容会被存放到 Brain，而非 Claude Code 本机上的记忆文件中。真正的教学内容会在会话开始时传递过来。该功能不会修改块之外的任何内容：你自己的约定依然保持不变。若要关闭此功能，请设置 BRETHOF_BRAIN_NO_CLAUDE_MD=1。该插件本身不会写入此内容：安装插件后，可将插件 README 中的对应块粘贴到 ~/.claude/CLAUDE.md 文件中，或让智能体帮你完成。

命令与版本

Claude Code插件提供了三个命令：/recall（立即搜索）、/onboard（项目启动的第一分钟）以及/curate（结束会话）。无需手动操作——系统会在新记录进入时自动整理和归类内存中的信息。

钥匙与项目

开始之前需要了解的两点

🔑

钥匙

托管密钥在账户面板中创建、编辑和撤销；创建密钥需要双因素认证，或使用 GitHub 或 Google 登录。一个密钥可供多台机器上的多个代理使用。托管密钥可以限定范围：仅限于选定的项目、只读或读写。这正适合承包商或单一用途的代理。本地版本则有一个由其安装程序创建的完全访问权限密钥。

项目

仅名称而已。在保存或搜索时传入一个项目名称，该项目即从那时起存在——无需设置，数量不限，无论何种套餐包括免费套餐均可使用。每个代码库、客户或项目可使用一个。您的代理可以在单个项目中搜索，也可以在所有项目中搜索，而位于其上方的共享层则存储着对所有地方都适用的少量通用信息。

工作原理

它会在无人要求的情况下自行学习。

这里没有人会总结会议内容，也不会有“保存我的上下文”这样的操作。当你周二纠正代理的错误时，所有代理都会在周二得知这一情况。

阅读对话而非单条消息的策展人

纠正你的智能体一次，之后你再也不用纠正它——该智能体的下一个会话会记住，其他所有会话也都会记住，在每一台机器上都是如此。记忆会以每五轮对话为一段读取你的对话，因此它保存的是对话中已确定的内容，而不是过程中的每一个半成品想法：决策被保存，过时的说法被淘汰。记录可能会比你晚几轮才落盘——会话的最后几轮对话会在你压缩上下文或该项目中的下一个会话开始时写入记忆。你无需手动归档任何内容。当你确实希望某条内容立即保存时，直接说明即可——你的智能体会直接将其保存，这在需要精确记录或某条信息属于另一个项目时非常有用。

两个存储：真相与记录

已保存的记忆 这就是当下的真相——经过精心筛选、内容丰富且实时更新。 对话历史记录 它是所有曾被说出的话语的完整原始记录。当你的代理需要团队当前所认为的信息时，它会搜索内存；而当它需要三周前出现的确切错误信息时，则会搜索历史记录。历史记录中的旧陈述只是当时情况的快照，而内存则代表着当下的真实情况。

该图表是决策的记忆

决策图为每一步操作都标注了具体日期——已决定、已尝试、已被拒绝、已放弃——并附上相应的理由，这些理由均来自对话内容。一旦有调整，就会新增一条记录；原有的方式则仍以旧方式的形式被保留下来。因此，当搜索涉及某个主题时，那些表明该想法在3月被否决的记录会连同日期和原因一起被调出，此时智能体就不会再次提出它。而这正是AGENTS.md和CLAUDE.md文件所无法做到的：它们并不知道某个想法已经被否决，所以该想法仍会被视为当前的有效信息，等待新的智能体来处理它。该决策图可追溯到你的记忆开始读取的那天，且它是两个版本中所有计划的一部分。

召回功能永不计量，也永不因达到上限而停止。搜索、会话启动时的上下文、每次提示的召回以及决策图的历史记录都不计入任何额度，您也永远不会按搜索次数付费——在任何套餐上都是如此，包括Free套餐。套餐只计量两件事，也仅此两件：您的记忆存储多少，以及它每月学习多少。任一项用尽后，暂停的只是新的记录或新的学习——您已存储的记忆会继续作答。

日复一日

诚实的回答：你不需要。

一旦插件安装完毕，就无需再学习任何操作步骤，也无需记住任何命令。它正常工作的最佳迹象就是你不再需要去考虑它了。

变化在于你与经纪人的沟通方式。现在你可以说这样的话： “关于付款重试，我们做了什么决定？” or 请记住，那个装有旧证书的箱子就是舞台布景箱。 — 用通俗的话来说，就是在交谈过程中。由你的代理人选择合适的工具，你无需指定具体是哪种工具。

您的代理可以访问什么

你不需要这份清单。它存在的意义在于，让你清楚在提出具体请求时有哪些选择。

查找内容 — 当需要从过往对话中获取确切的文字时，可查阅你整理过的记忆记录，或是原始的对话历史。
记住事情 — 将某个事实保存到某个项目中，或保存到覆盖所有项目的共享层中。
教导事情 — 保存一条规则，或以一句描述该项目要点的话来启动一个项目。
查看各项内容——列出您的项目、列出某个项目知道什么、列出其规则，或阅读某条记录。
移除内容——用于删除单条记录。要删除某个特定短语或整个项目，则需在账户面板中进行操作。
查看账本——查看项目中那些尚未确定的计划，一旦做出决定即可删除相应条目。
保留游戏手册 — 在整个账户中保存一次流程；可从任意项目调取并运行该流程；列出现有流程；删除已不再使用的流程。

代理人故意不能做的一件事： 删除整个项目。这一操作会影响到原始归档文件，因此该信息会保存在你的账户面板中，由人工输入名称。

Brain账本

你说的每一句话都不会被忽略。

当您的对话被存档时，Brain 会从中留意意图——即您说过要做却没做的事。每一项都会成为该项目记录中的一行：待定，等待您处理。没有状态标记，也没有归档。每一行要么等待，要么被舍弃，要么变成实际工作。

在任何会话中说“检查台账”。您的代理会逐行调出记录，您只需用单个词回答。已决定的行会当场移除。后续工作显示已完成、放弃或被取代的行早已自行离开。

🏃

从行到计划

仍然重要的一行会成为项目计划中的一条记录——Next 或 Parked——并从 Ledger 中移除；其余的则被舍弃。计划会在下一次会话开始时打开，因此当你的 agent 启动时，工作内容就在它面前。计划的工作方式。

两种习惯让它充满韵律。 经常回顾 — 每天有人光顾的堆垛，也只会有几排而已。 彻底删除 — 没有什么会失去的，因为那些仍然重要的想法会被再次提出，被重新整理，然后根据项目当前的状况来重新进行评估。

Brain 操作手册

所有代理人都需遵循的流程

操作手册是以Markdown文档形式编写、为整个账户只需存储一次的流程。您的任何智能体，在任何项目、任何机器上，都可以获取它并在自己的环境中运行——Brain负责存储和提供；您的智能体负责执行。

✍

撰写一篇

请让您的代理保存一份操作手册，将其整理成类似运行指南的形式：为各个阶段设置标题，用代码块标出具体的命令，再添加一行注释说明该命令的功能——当代理查看这份清单时，就会看到这一行内容。使用相同的名称进行保存会替换之前的版本，因此操作手册始终只有一份当前有效的文档。

▶

运行一个

“运行部署剧本” 整个界面就是如此：代理会获取该信息，并根据其指示行事。若要达到最佳效果，还需为它设定时间表——也就是让该代理在指定时间执行相应操作。 “取出每周报告的操作指南并执行它。” 在cron中，它就变成了一项任务——你只需用简单的英语将其描述一次，之后就无需再操心了。

规则

训练你的记忆力

你的记忆所持有的其他所有内容都是 在搜索时发现. 规则则有所不同：它是一种会自动加载到每个会话中的固定指令，无需任何人去查找。

规则是为了避免重复犯错而设定的——那些惯例、限制以及经过反复验证后必须牢记的准则。好的规则就像法律一样：“绝不在周五部署”，“这个项目要用制表符，不能用空格”，“客户的名字是Brethof，绝不是Brefoth”。简短、明确，且下个月依然适用。

请让你的代理保存一条规则，系统会询问你一个问题：这是适用于你所有的操作，还是仅限于这个项目？

🌎

每个项目

一项适用于你所有工作、无论在何处进行的法律。

📌

仅此项目

适用于某个代码库、客户端或项目的法律规范。

💡

都不是——那是知识。

很有用，但并不需要一直放在眼前。依然会被保存，一旦有人搜索就能立刻找到。

第三个选项才是最重要的，它被选择的频率也高于另外两个选项。规则的成本很高：它会永久占用每次会话中的存储空间，同时还会告诉管理员什么才是重要的内容。将普通知识当作规则来处理，只会让记忆逐渐变得混乱，最终没有任何内容能够突出显示出来。

规则教导的是策展者，而不仅仅是代理。

带有几条明确规则的项目，记忆效果明显好于没有规则的项目——因为规则会告诉它的整理者这里什么重要。保存一条规则，几分钟内，该项目的记忆就会重新掌握这个项目的本质。

保持它们敏锐

规则应当简短到你还愿意亲口说出来的程度——如果写不下，那它多半是披着规则外衣的知识。把重复的规则合并为一条，删掉已经过时的规则；没有任何东西会替你修剪它们，因为决定你法则的，本就不该交给别的东西。十几条你真正信奉的规则，胜过五十条你早已不再阅读的规则。

实践中的项目

唯一重要的决定就是如何对它们进行分类：为每个代码库、客户或项目单独设立分类方式，这是最有效的做法。分类过少的话，相关的工作内容就会混在一起；而分类过多则会导致信息分散。在项目开始时明确其目标——即项目的目的以及需要记住的内容——这是最值得投入时间的环节。这样可以从一开始就让负责管理项目的人明白意图，而不必让他们从零散的信息中推测出你的意图。

空间与用量

什么界限能将其阻挡——又有什么是它永远无法触及的

您存储的记忆会持续应答，无论其他什么被限制。检索是任何限额都夺不走的东西——同样夺不走的还有开启每次会话的简报、随每次提问送达的规则与记录、完整的聊天历史、图谱、笔记以及工作手册。

三种不同的物品其计量方式各不相同，了解它们各自的区别是很有必要的。录音受存储空间限制。学习会受到您每月限额的限制。召回不受任何限制——只要您的记忆存储在我们的实时系统中，搜索、会话摘要以及按提示召回功能就会持续正常工作。

当这个月的学习时间用完时

你的历史记录 持续被记录下来, 而所有内容依然可以被搜索。回忆功能仍在正常工作——在会话开始时进行过说明，每次提问时都会匹配相关记忆及图表。真正停止的是…… 学习: 从您的对话中不会生成新的记忆，因此图表也不会再继续增长。只有通过购买补充包或进行升级，才能让图表再次开始增长。

🗃

当存储空间已满时

没有新的内容会被保存——这就是“完整”一词的含义。回忆功能会持续作用于所有已存储的内容，因此智能体仍能掌握相关信息，也会记得它昨天所知道的一切。如果增加存储空间或提升计划等级，记录就会从上次停止的地方继续下去。

⏹

当两者同时咬下去时

没有录音，没有学习——而检索依然有效。如果您听说您的Brain已关闭，那只是对新记忆而言。其中已有的所有内容仍与之前完全一样地回答，您的智能体也会继续使用它。

如果订阅到期

Brain 会立即暂停——没有宽限期。您的记忆将在第 7 天后归档，约第 23 天时收到警告，并在第 30 天被删除。已付费的活跃账户绝不受影响。完整的日程安排及相关邮件载于隐私政策。

限制所留下的缺口，以及我们为何从不填补它

虽然存在限制，但无法形成新的记忆。这样一来，你的记忆中就会留下那段时期的空白。 我们不会回去再填填补补的。. 那是一条刻意设计的法则，你应该知道它。

记忆只能源于一次对话。 恰好如此. 后来根据数周前的资料所写的记录，会覆盖掉自那以后一直为真的事实；而你的记忆也会开始断言那些已经不再真实的事情。我们宁愿留下空白，也不愿编造出看似可靠的谎言。

简而言之：这一缺失作为记忆是永久性的。那段时期的原始对话历史仍然存在且可检索，因此记录并未丢失——只有提炼层存在空洞。限制持续得越久，您的记忆与您实际所做工作的偏差就越大。而且恢复后它不会自行修复：您的智能体在遇到过时记忆时会加以纠正，记忆也会在新记录落库时与旧记录比对，淘汰与较新记忆相矛盾的记录。这两者都只向前运行，绝不回溯。

没有人会被悄悄切断。接近限额时您会收到一封邮件，限额生效时再收到一封；限额开始时，代理的会话内会出现通知；限额生效期间，每次提示中都会有一行简短说明。

清理旧历史记录

您的原始历史在关键之处受到保护：近期历史任何人都无法删除，单条消息也无法被悄悄删除——但您可以遮蔽某个确切短语、通过代理删除单条记录，或在账户面板中移除整个项目（由人工输入名称）。任何删除操作都是免费的。

⇆

更改计划

升级会立即生效。而降级则需等到您的内存容量符合较低配置的要求之后才能进行——您可以删除一些不必要的内容，或者继续保留那些附加功能，直到内存条件满足为止。无论何时进行配置变更，我们都不会删除任何内容。

常见问题解答

在“Hosted”（托管）模式下，您的记忆会以只有您掌握的密码短语进行加密：在锁定状态下，对包括我们在内的所有人而言它都只是密文。数据在德国存储和检索；处理过程在瑞士的安全计算环境中运行；其中一次模型调用会短暂地发送给一家在合同上承诺不保留、不用于训练的供应商——我们如实说明这是他们的承诺。在“Local”（本地）模式下，您的记忆保存在您自己的机器上。我们的中心只在数据上传时处理其中的一部分，不存储任何内容——它仅保存您的固定规则和每个项目的一行信息。记忆和搜索始终留在您的机器上。

这正是关键所在。每个使用你密钥的智能体都读写同一份记忆，逐轮保持一致——五个智能体在同一项目上看到的是同一个真相。在托管记忆中，作用域密钥让你可以授予个人或智能体仅访问选定项目的权限，只读或读写均可。

Claude Code、Codex、Qwen Code、OpenClaw、DeepSeek Harness（dsh）、Cline、OpenCode、Kilo Code以及Hermes Agent。只有当整个流程在某个平台上能够正常运行时，它才会被列入列表——在会话开始时会进行简要说明，每次提问时都会加载相应的记忆内容，同时对话也会被存档。不存在部分支持的层级，因为功能不完善的平台很可能会成为某人唯一的依赖。还有更多平台正在连接中，等待供应商账户的确认；它们会在功能得到验证的当天才会出现在这里，绝不会提前出现。

不需要。任何代理都只需要一个 brethof-brain 密钥，而且您的代理可以自行完成整个安装——输入 “install brethof-brain” 即可。托管版由我们运行一切；本地版则在您机器上的一个容器中运行。

是的——询问您的代理，或使用您的账户面板。这是进入您记忆的两扇门，删除操作两者皆可：导出全部历史、删除某个项目、屏蔽某个确切短语，或删除账户——通过面板，以您本人的身份，甚至无需密码短语。其中有些是刻意受限的：防止代理抹除您过往记录的保护措施同样适用于您本人，安全页面明确说明了界限所在。

每个项目里堆积的未决意向——那些你在对话中说过要做却没做的事。请让您的智能体“查看台账”，用一个词决定每一行，并将保留项移入项目计划。上方章节有详细说明。

Brethof网络

文档