Cogmemai Mcp

CogmemAi：安全、持久的记忆，让 AI 始终守规矩

它会记住重要的事，在任何行动发生前阻止违反你所设规则的行为，并检查 AI 的实际操作是否符合你的要求。适用于助手、Agent、机器人、车辆和代码。

每个 AI 失控的故事都如出一辙：AI 采取了行动，而决策与损害之间毫无阻隔。CogmemAi 正是那道防线。它是一层可移植的记忆层，可让任何 AI 系统跨会话、设备、用户和团队持久回忆信息；即使 AI 忘记保存，也能自主捕获知识；在行动发生前执行你保存的规则；并根据你的意图审查已完成的工作。在 LongMemEval 上准确率达 95.10%，是该领域最具挑战性的长期记忆基准中已发布的最高分。 LoCoMo 得分为 91%，高于人类表现（87.9%）。采用量子安全加密。兼容 Claude Code、Cursor、Windsurf、Cline、Continue 及任何兼容 MCP 的工具。切换编辑器、模型或设备，你的知识和规则都会保留。不只是某项测试中的高分：这是目前最全面、最安全的 AI 记忆系统。

v3 新功能

文档：本地模式密钥说明统一（v3.32.4）

README 有一处说本地模式不需要密钥，另外三处却说需要。实际情况是需要：免费密钥用于注册安装；而在本地模式下，你存储的任何内容都不会离开你的设备。现在环境变量表已明确说明这一点，整个 README 也不再使用 em dash。代码未更改。

安全记忆，让 AI 始终守规矩（v3.32.3）

代码未更改。现在，软件包明确说明 Guard 和 Review 的用途：你运行的 AI 绝不应登上 AI 失控的新闻头条。无论是 shell 命令、消息、购买还是更改，在行动发生前都会执行你保存的规则；完成的工作也会根据你的要求进行审查。请参阅 Guard、Rule Packs 和 Intent。

为回忆内容设置字符数上限（v3.32.0）

长期记忆值得保留，但一次加载十条的成本很高：每个工具结果都会保留在对话中，并在之后的每一轮再次读取。recall_memories 现在支持可选参数 max_chars。设置上限后，排名最高的记忆会完整返回，其余记忆则以 400 字符的片段返回，并保留其 id、type、subject 和 score，每条都会标记为 truncated，同时显示实际长度。不会隐藏任何内容：使用相同的查询再次调用 recall_memories，并传入 expand_ids: [..]，即可完整读取任意条目；也可以传入 max_chars: 0 获取所有内容。若要为自己的配置设置默认上限，请在服务的 env 中设置 COGMEMAI_RECALL_MAX_CHARS（例如 8000）；调用时传入的 max_chars 始终优先。将该功能应用于一个真实工作日的十二次搜索后，设置 8000 的上限可减少 42% 的回忆输出。不设置上限时，结果与之前完全相同。保存响应也更精简：save_memory 返回的相关记忆指针现在是包含其 id 的 300 字符预览；当相似度足以建议合并时，仍会返回完整文本。

登录，而不是粘贴密钥；以及工具注释（v3.31.2）

托管端点 https://hifriendbot.com/mcp/ 现在支持 OAuth 2.1：支持 OAuth 2.1 的 MCP 客户端（claude.ai、Claude Desktop、Cursor 等）会从端点的 401 响应中发现授权服务器，注册自身，将你引导至 CogmemAi 同意页面登录，并通过 PKCE 获取令牌；API 密钥仍像以前一样正常工作。现在，每个工具都带有 MCP 注释（title、readOnlyHint、destructiveHint、idempotentHint），因此客户端可以为工具添加标签，并决定是否需要确认。

迁移：云迁移手册（v3.31.0）

npx cogmemai-mcp migrate assess --target aws（或 azure、gcp）会读取代码库，并在一次运行中生成迁移方案：清单（语言、框架、数据存储、云 SDK、基础设施即代码、容器、CI、定时作业、环境变量名称、外部主机、疑似包含机密的文件；仅包含名称和数量，不包含文件内容，也绝不会有机密值离开设备）、以项目意图形式编写的迁移范围文档（迁移哪些内容、保留哪些内容、绝不可违反和必须遵守的不变量、各阶段及其完成定义、不在范围内的内容），以及包含组件表、阶段、风险排序清单、成本驱动因素和待解决问题的 MIGRATION.md。计划和风险会作为记忆保存，并安装 migrate pack（16 条流程规则：先做清单、一次迁移一个工作负载、先照搬再现代化、演练回滚、通过计数和校验和验证数据、批量同步绝不未经试运行就删除数据、重新签发机密且绝不导出、切换时仅保留一个写入方、停用前将源设为只读 30 天）以及目标云的 pack。之后，每完成一个阶段，cogmemai-mcp migrate gate "<phase>" 都会根据范围审查工作（提交、变更文件、你的备注、计划步骤），在覆盖率达到 80 或以上且无违规时通过；每个门禁结果都会被保存，为迁移留存记录。此外还会一同提供三个新的云端 pack：aws（20 条规则）、azure（18 条）和 gcp（17 条），每个 pack 都采用对应云平台自身的 CLI 格式：不得使用 root 或过于宽泛的角色，不得使用长期有效的密钥，不得将管理端口或数据库开放到互联网，不得使用公共存储桶；必须启用加密、备份和删除保护；不得禁用检测控制和审计日志；组织策略和 SCP 必须作为基线；遵循获批区域和数据驻留要求；在首个工作负载上线前设置预算；为所有资源添加标签。cogmemai-mcp migrate inventory 仅打印清单，--dry-run 显示将发送的内容，--no-rules 跳过 pack，--force 替换现有意图。评估通过你账户的每日额度，经由 MSGR 网关运行。

规则包：用一条命令设置安全策略（v3.30.0）

npx cogmemai-mcp rules install devsecops 会安装 40 条开箱即用的规则，涵盖机密、基础设施即代码、最小权限、网络暴露、CI/CD 门禁、变更控制、容器和 Kubernetes、数据处理、日志记录和事件响应，以及基础设施上的 AI Agent 必须遵守的规则。每条规则都是普通的规则记忆：其 Shell 模式会在命令运行前将其拦截（terraform destroy、--acl public-read、curl | bash、kubectl delete namespace、粘贴到 export 中的密钥），其自然语言内容则用于判定 guard_check 和回合结束审查，因此即使没有 Shell 模式匹配，也会拒绝“把生产环境转储文件复制到我的笔记本电脑上”这样的操作。若项目尚无意图文档，可添加 --intent 为项目创建一份平台与安全意图文档；添加 --global 可将 pack 应用于所有项目；添加 --dry-run 可查看将安装的内容。重新安装时会跳过已有规则，而 rules show devsecops 会在你决定采用前打印整个 pack。之后可以像任何记忆一样编辑规则。全部 40 条规则、意图文档，以及一段展示 Agent 被拦截的 90 秒视频，均可在 hifriendbot.com/devsecops 查看。

审查适用于 Git 之外的场景（v3.29.0）

以前，回合结束时的审查需要 Git 仓库，因为它会读取 git diff。人们从主目录开始工作的文件夹大多不是仓库，非程序员的项目也大多不是。v3.29.0 改为读取此会话的编辑事件（PostToolUse 钩子已经会记录每次 Edit 和 Write），据此构建相同结构的差异，检查新增文本中是否包含机密信息，回忆被修改文件相关的已记录风险，并运行意图检查。在一个文件夹中处理多个项目时，会逐个项目进行评审：在 ~/NullJury 下的编辑会根据 NullJury 的意图进行审查（如果有意图文档），并在备注前加上该项目的 ID。仓库内部的一切都不会改变。

全面防护与审查，而不仅限于代码（v3.28.0）

此前，防护机制会检查 Shell 命令，意图审查会检查代码差异，因为这是编码工具提供给我们的钩子。v3.28.0 通过两个工具和两个 REST 端点，让两者都适用于任何 AI：

• guard_check：“我可以这样做吗？”任何操作（即将发送的消息、购买、变更、命令）都会根据此人要求其 AI 遵守的规则，以及项目意图中的 NEVER 和 MUST 条目进行判断。所有套餐层级都会进行字面规则检查；付费套餐层级还会进行判定检查。返回 allow、ask 或 deny，以及适用的规则，并采用故障时放行策略。
• review_work：“我做了要求的事吗？”传入对已完成工作的描述、输出、消息或转录内容，系统会根据意图文档进行审查，也可以根据内联传入的意图进行审查。结果与代码审查一样，采用通俗易懂的语言：摘要、已覆盖内容、未覆盖内容、违规项、覆盖率。

现在，支持助手、陪伴型助手、机器人任务规划器和编码 Agent 共享一份记忆，它会影响任何模型的行为：它会记忆、执行约束并进行审查。同样的调用也可通过 SDK（guardCheck / reviewWork、guard_check / review_work）以及 REST 使用，端点为 POST /cogmemai/guard-check 和 POST /cogmemai/intent-check，并带有 work 字段。

CogmemAi 意图：读意图，而不是读代码（v3.26.0）

存放在仓库中的规格文件因仓库和工具而异，而且会逐渐过时。v3.26.0 为每个项目新增一份通俗易懂的意图文档，与你同在，而不是存放在仓库中：项目的用途、必须始终满足的条件、已作出的决定及其原因，以及不在范围内的内容。使用 set_intent 编写，使用 get_intent 读取。每个会话都会在加载规则后立即加载意图文档，每次替换都会进行版本管理，而且它会随你进入每个与 CogmemAi 通信的工具。

接下来，它会完成规格文件做不到的两件事。Invariants 下的句子会编译成与规则记忆相同的可执行模式，因此，如果意图中包含 NEVER run \pkill -u www lsphp`，该命令就会在运行前被拦截，而且不会发起网络调用。每个回合结束时，系统还会根据 CogmemAi 服务上的文档评判所做的更改，并用通俗易懂的语言向不读代码的人报告：发生了哪些变化、意图是否涵盖这些变化、哪些内容与意图冲突，以及意图尚未提及什么。意图已涵盖的更改不会产生提示。COGMEMAI_INTENT_VERBOSE=1会在每个进行判定的回合显示摘要。每次检查都会记录到~/.cogmemai/intent-log.jsonl`，因此精确度是经过衡量的，而非想当然的。

判定检查仅在付费套餐层级运行；免费套餐仍可使用已强制执行的不变项和每项确定性审查。请参阅下文的 意图。

CogmemAi Guard：让你的 Ai 不再重复犯错（v3.24.0）

只会提供建议的记忆，在压力之下可能会被你的 Ai 忽略。v3.24.0 新增了一个防护机制，将项目记住的内容转化为强制规则。

PreToolUse 钩子会在每条 shell 命令运行前进行判断。六条内置规则涵盖了那些不适合无人监管执行的操作：通过管道重写整个 crontab、对生产数据库执行破坏性 SQL、在临时目录和构建目录之外递归删除文件、向共享分支强制推送、将下载内容通过管道传给 shell，以及按名称终止共享服务器工作进程。同样的规则也适用于命令中包含的 ssh host "..."、bash -c "..." 和传给 shell 的 heredoc，因为这些内容会在另一端按原样执行。

接下来是只有记忆层才能实现的部分。你通过 save_rule 保存的规则记忆会变成可强制执行的模式。在规则中写入 NEVER run \pkill -u www lsphp`，下一次会话就会拒绝执行该命令，通过 ssh 执行也不例外，并将规则原文作为拒绝理由。无需修改代码。添加一行 GUARD: ，即可为规则指定精确模式；添加 GUARD: off`，则可让规则继续仅提供建议。

每轮结束时，Stop 钩子会检查实际发生的更改：凭据被粘贴到受 Git 跟踪的源代码中、发布文件中的版本字符串不一致、文件被删除、大量行被删除、某个函数现在在两个位置定义，以及关于已修改文件的已记住注意事项。它只报告，不会编辑。

每个判断都会在本地记录，并对机密信息进行脱敏，因此可以衡量规则的准确性，而不只是凭空假设。拒绝执行时会说明可行的后续操作，通常是“自行运行”。防护机制遇到任何错误都会默认放行，而 Git 仍是实际的撤销手段。请参阅下文的 Guard。

v3.25.0 将其扩展到 Claude Code 之外：guard shell-install 通过 BASH_ENV 为这台机器上的每个 bash -c 和 zsh -c 添加钩子，让 Cursor、Codex、Gemini CLI 和普通脚本也能使用相同的防护机制、已记住的规则和日志。

防火墙拦截时明确报错（v3.20.0）

当上游防火墙、CDN 或代理拦截发往 CogmemAi 后端的请求时，返回的是 HTML，而不是 JSON。早期版本会尝试将其解析为 JSON，然后抛出令人困惑的 Unexpected token '<' 错误，接着又悄悄重试相同的受阻负载。v3.20.0 会检测 HTML 响应，并在可能时指出拦截层（NinjaFirewall、Cloudflare、ModSecurity），同时提供清晰且可采取行动的错误信息。响应正文为 HTML、可重试的 4xx 响应不再触发重试循环。可能导致记忆写入悄无声息地丢失的这类问题，现在会明确报错。

自主记忆：你的 Ai 不再决定是否保存记忆（v3.15）

每个记忆系统都有同一种隐蔽的失效模式：**必须由 Ai 决定保存记忆，而它在压力之下不会这么做。**你可以把指令写进系统提示词，也可以进行提醒。但当你的 Ai 全神贯注于编码任务时，它会忘记保存；上下文压缩后，两小时前做出的决定便会消失。

CogmemAi v3.15 完全将这项决定从 Ai 手中移走。在基础设施层面捕获你的编码会话，决策、文件更改、错误修复和部署都会进入记忆，无需任何提示词。会话结束时，智能处理流程会将其提炼为结构化记忆：合适的类型、合适的重要性评分、合适的作用范围。你的 Ai 完全不会察觉这一过程。

结果是：高强度编码一天会产生 15 到 20 条高质量记忆，而不是 3 条。未来的会话可以无缝衔接。你的 Ai 不再反复讨论你已经做出的架构决定。别再提醒你的 Ai 要记住事情。它会自动做到。

主动记忆检索（v3.12）

CogmemAi 现在会先思考，再开口。在 Ai 助手提出任何行动、方案或建议之前，CogmemAi 都会先自动检索记忆，无论讨论什么主题。

• preflight 工具：一种快速、轻量的记忆检索方式，旨在每次提出建议前调用。助手会先查看自己对某个主题已有的了解，再开口。“我们试试方案 X” → 先检查是否已经尝试过、否决过或完成过 X。耗时不到 200ms，成本近乎为零。
• 呈现先前上下文：每次保存记忆时，CogmemAi 都会自动搜索所有主题、人物、公司、技术方案、功能等相关的既有记忆，并在回复中呈现。助手绝不会提出重复的建议。
• 智能记忆检索钩子：在 Claude Code 中，CogmemAi 会读取每条用户消息，并在助手回复前自动注入相关记忆。无需手动检索，助手开始思考前就能获得上下文。
• 升级后的记忆检索引擎：更高维度的语义理解、平衡的重排序、扩展关键词的搜索、更可靠检索所需的双路径记忆存储，以及在初始结果置信度较低时自动扩展搜索的自适应机制。

结果是：你的 Ai 助手不再建议你尝试过的事情、已经联系过的人，以及已经否决过的方案。你的大脑不再需要为工具本该知道的事情充当安全网。

智慧引擎：自动提取原则（v3.10）

CogmemAi 现在会自动检测记忆中的模式，并提取事实性原则。技能告诉 Ai 应该如何行动（“始终使用 Zustand”），而原则则告诉它关于项目的真实情况（“这个代码库从不在服务边界验证输入”）。原则会从由 5 条或更多相关记忆组成的簇中提取，按置信度评分，并注入每个会话中。使用 extract_principles 手动触发，也可以让它自动运行。

远程 MCP：零安装（v3.9）

CogmemAi 现在支持Streamable HTTP 传输，无需安装任何东西即可从任何 MCP 客户端连接。无需 npm、配置文件或 Node.js。只需使用 API 密钥将客户端指向 https://hifriendbot.com/mcp/，即可立即开始使用持久记忆。相同的 35 个工具、相同的 Intelligence Engine、同样领先基准测试的准确度，而且无需繁琐设置。

抗量子加密（v3.7）

CogmemAi 是首个抗量子的 Ai 记忆系统。所有记忆在静态存储时均采用抗量子加密，无论是云端模式还是本地模式。你的数据既能抵御当下的威胁，也能抵御未来的量子计算机。加密会自动启用，无需配置，并且默认开启。无需进行任何设置。

选择存储模式（v3.6）

CogmemAi 现在支持三种运行方式，选择最适合你工作流的模式：

	云端（默认）	本地	混合
最适合	完整智能能力、团队协作、跨设备便携使用	零配置启动、仅限离线的环境	本地速度 + 云端智能，适合出行或网络不稳定的情况
设置	npx cogmemai-mcp setup（选择 Cloud）	npx cogmemai-mcp setup（选择 Local）	npx cogmemai-mcp setup（选择 Hybrid）
是否需要 API 密钥	是（免费）	是（免费），如同许可证密钥，数据保留在本地	是（免费）
搜索	语义搜索（按含义）	全文搜索（FTS5）	语义搜索，支持本地回退
智能引擎	完整功能：自动关联、矛盾检测、记忆衰减、自动技能、查询综合	FTS5 搜索 + CRUD，数据保留在你的设备上	完整功能，支持离线韧性
团队协作	是	否	是
跨设备同步	自动	否，数据保留在你的设备上	自动同步，并带有本地缓存
离线支持	需要互联网	完全离线	离线时回退到本地
加密	量子安全（服务端）	量子安全（本地）	量子安全（两者）

云端模式是推荐的使用体验。 它为你提供完整的智能引擎、可按含义查找记忆的语义搜索、自动关联知识图谱、矛盾检测、自我改进的回忆能力、自动技能、查询综合和团队协作。这些功能让 CogmemAi 不止是一个数据库。

本地模式会将数据保留在你的设备上。 注册时需要免费的 API 密钥（如同软件许可证密钥），但所有数据都会保留在本地。全文搜索（FTS5）可提供优质的回忆能力。完成初始设置后即可离线使用。准备好使用语义搜索和完整的智能引擎时，只需一条命令即可升级到云端。

混合模式适合经常出行或使用不稳定网络的开发者。 它会同时保存到本地和云端。有云端时从云端读取，离线时回退到本地。网络恢复后，未同步的记忆会自动推送到云端。

智能引擎 + 自动技能（v3.5）

CogmemAi 现在会随着每次使用变得更智能。智能引擎是一个自我改进的记忆系统，它能学习哪些内容重要、自动关联相关知识，并综合整个记忆库中的信息生成答案。自动技能更进一步：CogmemAi 不只是记忆，还会学习如何行动。

自动技能（闭环学习）

• 行为技能：CogmemAi 会自动将你的纠正、偏好和模式综合为行为指令，告诉你的 AI 助手如何工作，而不只是让它知道什么
• 闭环学习：只需纠正助手一次，CogmemAi 就会检测到这一模式。证据积累到足够程度后，它会生成一项技能，避免同样的错误再次发生
• 置信度跟踪：每项技能都有一个置信度评分，技能奏效时评分会上升，未奏效时则会下降。低置信度技能会自动停用
• 自我评估：技能会定期依据新证据进行自我审查，并随着你的做法演变而调整、强化或停用

智能引擎：LongMemEval 得分 95.10%，LoCoMo 得分 91%

CogmemAi 在 LongMemEval 上的准确率达到 95.10%，在业内最难的长期记忆基准测试中创下已公布的最高分；在 LoCoMo 上的准确率达到 91%，检索命中率为 100%，超过人类表现（87.9%）。两项基准测试，均取得顶尖成绩。CogmemAi 会在你需要时找到恰当的记忆。

• 精准重排序：每次召回都会进行第二轮重排序，对候选项重新评分以提高精准度，并结合初始排名信号，让最相关的记忆优先呈现
• 自我改进的召回：持续帮到你的记忆会随时间排名上升；从未用到的记忆则会自然淡出。每次会话都会自动提升召回质量
• 基于可信度加权的召回：标记为已验证的事实会排在未验证事实之前；保存更正后，被替换的记忆会退役，因此更正后的认知不会再与原始记忆相冲突
• 自动关联知识图谱：保存记忆时，相关记忆会自动关联。你的知识将构建成关系网络，而不是一张平面列表
• 矛盾检测：召回的记忆彼此冲突时，CogmemAi 会标记矛盾，让你在过时或陈旧的信息引发问题之前及时发现
• 上下文感知排名：告诉 CogmemAi 你正在做什么（调试、规划、审查），它就会提升相应类型记忆的排名。调试时，错误报告和模式会优先呈现；规划时，架构决策会排在前面
• 查询综合：提出问题后，你会获得一份综合所有相关记忆而成的连贯答案，而不只是一串匹配结果。就像询问一位读过所有资料的队友
• 跨项目智能：在 3 个或更多项目中出现的模式会自动提升为全局范围。无需手动操作，你的最佳实践就能随时伴你左右
• 主动洞察：会话开始时，CogmemAi 会在你提问前告知你需要了解的信息，包括过时的重要记忆、需要合并的重复主题，以及适合提升为全局模式的规律

v3 还新增了

• 记忆健康评分：0-100 分，并提供可执行的影响因素
• 会话回放：通过自动生成的会话摘要，准确接续上次的工作
• 自我调优记忆：根据实际使用情况调整重要性；自动归档过时记忆
• 自动摄取 README：在新项目中立即从 README 学习
• 智能召回：切换主题时自动呈现相关记忆
• 自动学习：CogmemAi 会自动从你的会话中学习
• 任务跟踪：持久化任务，支持状态和优先级
• 更正学习：教你的助手避免重复犯错
• 会话提醒：在下一次会话开始时呈现提示
• 强制规则：定义绝对要求（“绝不执行 X”“始终执行 Y”），这些要求会在每次会话中呈现，不受评分和衰减机制影响
• 自主记忆：即使你的 Ai 忘记保存，也会捕获工作内容
• 41 个工具：适用于任何 Ai 系统的最完整记忆工具包，其中包含任何 Ai 都能调用的防护和审查调用

快速开始

选项 1：远程（无需安装）

直接连接，无需 npm、设置或配置文件。只需将远程端点和 API 密钥添加到 MCP 客户端：

端点： https://hifriendbot.com/mcp/ 身份验证： Bearer 令牌（你的 cm_ API 密钥）

前往 hifriendbot.com/developer 免费获取 API 密钥。

适用于支持 Streamable HTTP 传输的任何 MCP 客户端（Claude Desktop、Cursor 等）。

选项 2：本地安装

npx cogmemai-mcp setup

设置向导会引导你完成三项选择：Cloud（推荐，提供完整的 Ai 智能）、Local（数据保留在你的设备上）或 Hybrid（两者兼具）。选择模式，按需输入 API 密钥，即可在 60 秒内准备就绪。

还没有 API 密钥？可在 hifriendbot.com/developer 免费获取。所有模式都需要免费密钥，包括 Local 模式；在该模式下，密钥相当于许可证密钥，且你的数据永远不会离开设备。

问题所在

每次开始新会话，你都会丢失上下文。你需要重新解释自己的技术栈、架构决策和编码偏好。Claude Code 等工具内置的记忆只是一份没有搜索、没有结构、也没有智能的平面文件。

CogmemAi 为你的 Ai 助手提供真正的记忆系统：

• 语义搜索：根据含义而非关键词查找相关记忆
• Ai 驱动的信息提取：自动从对话中识别值得记住的信息
• 智能去重：自动检测重复和冲突的记忆
• 隐私控制：存储前自动检测 API 密钥、令牌和机密信息
• 文档导入：导入 README 和文档，立即构建项目上下文
• 项目范围限定：记忆与特定代码仓库关联，同时保留随你走遍各处的全局偏好
• 智能上下文：根据相关性智能排序，让内容与你当前的工作高度相关
• 自主记忆捕获：即使你的 Ai 忘了调用保存功能，也能保存知识。决策、文件变更和修复都会自动进入记忆，无需提示
• 上下文压缩恢复：自动适应 Claude Code 的上下文压缩
• 节省令牌：精简加载上下文，不会让对话变得臃肿
• 零配置：无需数据库、Docker、Python 或向量存储

为什么推荐 Cloud 模式

CogmemAi 提供三种存储模式，但 Cloud 模式才能发挥其真正优势。智能引擎、语义搜索、自动关联知识图谱、矛盾检测、自我改进式召回、自动技能和查询合成均在服务端运行。在 Cloud 模式下，你的 MCP 服务只是一个轻量级 HTTP 客户端，**没有本地数据库、没有 RAM 问题、无需维护。**所有记忆都经过静态加密，因此你的数据与本地存储同样安全，同时还具备跨设备访问和团队功能。

**你的记忆随时随地相伴。**在 Claude Code 中创建的记忆会立即在 Cursor、Windsurf、Cline 和任何兼容 MCP 的工具中可用。无论切换到 Opus、Sonnet、Haiku，还是编辑器支持的任何模型，你的记忆都会一直保留。换新笔记本电脑？换新操作系统？登录后，完整的项目知识即刻呈现。本地 SQLite 文件会随设备消失。云端记忆则会永久保存。

**隐私方面的说法只是个误区。**一些记忆工具把“本地优先”宣传为隐私优势。但想想接下来会发生什么：Ai 读取的每条记忆都会作为提示词的一部分发送给模型提供商（Anthropic、OpenAI、Google）。无论数据存储在哪里，在推理时都会离开你的设备。本地 SQLite 文件无法保护你的记忆，只会让记忆更难搜索、访问更慢，也无法共享。CogmemAi 会对静态数据加密，通过 HTTPS 传输，并提供本地存储无法比拟的智能功能。

**团队与协作。**云端记忆是跨团队成员共享项目知识的唯一方式。一位开发者保存架构决策或记录错误修复后，所有团队成员的 Ai 助手都会立即了解相关信息。无需同步、不会产生合并冲突，也没有过时的本地数据库。无论团队有两位还是二十位开发者，每个人的助手都能获取相同的最新上下文。仅本地存储的记忆解决方案无法做到这一点。

压缩恢复

当 AI 助手压缩上下文时，对话历史会被压缩，上下文也会丢失。CogmemAi 会自动处理这一过程：在压缩前保留上下文，并在压缩后无缝恢复。无需重新解释，也无需手动输入提示词。

npx cogmemai-mcp setup 命令会自动完成所有配置。

技能

CogmemAi 包含一项 Claude 技能，用于教 Claude 掌握记忆管理的最佳实践，包括何时保存、重要性评分、记忆类型和会话工作流。

Claude Code：

/skill install https://github.com/hifriendbot/cogmemai-mcp/tree/main/skill/cogmemai-memory

Claude.ai： 在 Settings > Skills 中上传 skill/cogmemai-memory 文件夹。

CLI 命令

npx cogmemai-mcp setup          # Interactive setup wizard
npx cogmemai-mcp setup <key>    # Setup with API key
npx cogmemai-mcp verify         # Test connection and show usage
npx cogmemai-mcp --version      # Show installed version
npx cogmemai-mcp help           # Show all commands
npx cogmemai-mcp guard status   # Cached rules for this project and verdict counts
npx cogmemai-mcp guard sync     # Refresh remembered rules from CogmemAi
npx cogmemai-mcp guard test "<command>"   # Judge a command without running it
npx cogmemai-mcp guard log [n]  # Show the last n verdicts
npx cogmemai-mcp guard install  # Add the guard hooks to an existing setup
npx cogmemai-mcp guard shell-install   # Guard bash -c / zsh -c from any tool, not just Claude Code
npx cogmemai-mcp guard shell-remove    # Undo shell-install
npx cogmemai-mcp rules list            # Rule packs you can install (v3.30+)
npx cogmemai-mcp rules show devsecops  # Read a pack before installing it
npx cogmemai-mcp rules install devsecops [--global] [--intent] [--dry-run]

防护

CogmemAi Guard 是两个 Claude Code 钩子，由 setup 安装（也可以在现有配置中通过 guard install 安装）。两者都采用故障开放策略：遇到任何错误或无法解析的输入时，命令都会原样运行。两者都不会调用大模型。

命令运行前（Bash 上的 PreToolUse），防护机制会根据六条内置规则以及本项目记住的规则判断命令。拒绝并不是不让某件事发生，而是不允许在无人监督的情况下执行；每次拒绝都会说明如何有意地继续操作。

内置规则	存在原因
通过管道重写整个 crontab	会悄无声息地破坏已安排的任务
将 DELETE、DROP、TRUNCATE、UPDATE 发送给正在使用的数据库客户端	限定范围的 DELETE 并不能证明操作安全
在临时、构建和依赖路径之外递归删除	按定义无法恢复
强制推送到 main、master 或 prod	会覆盖仅存在于远程服务上的提交
将下载的脚本通过管道传给 shell	会运行无人审查过的代码
按名称对共享服务器工作进程使用 pkill 或 killall	会中止共享主机上的所有进行中请求

规则运行前会移除引号字符串和 heredoc 正文，因此，将危险命令写入笔记文件不等于运行该命令。ssh host "..."、bash -c "..." 的有效负载，以及传给 shell 的 heredoc，都会像直接输入的命令一样接受判断。

记忆中的规则。 规则记忆（save_rule，或任何类型为 rule 的记忆）会编译为模式，并在会话开始时缓存在本地，因此预检查无需联网。规则有两个来源：

• 内容为 GUARD: <regex> 的行会按原样使用，不区分大小写。GUARD: off 会让规则仅提供建议。
• 同一句中跟在 NEVER、DO NOT 或 MUST NOT 后面的反引号命令，若格式符合命令（命令名后至少有一个参数，且不含占位符），也会被采用。NEVER run \pkill -u www lsphp`` 就足够了。

触发记忆规则时，原因说明会引用该规则并指出其名称，后续操作则是由你亲自运行命令，或使用 delete_rule 删除该规则。

一轮结束后（Stop），防护机制会检查工作树：是否有可能的机密信息被添加到受版本控制的源文件中、发布文件中的版本字符串是否一致、是否有文件被删除、是否有大量净删除、是否有函数在多个位置新定义，以及是否有提及该项目或被改动文件的已记住注意事项。若本轮没有问题，正确的输出就是不作声。

日志。 每项判定（包括静默放行）都会追加到 ~/.cogmemai/guard-verdicts.jsonl（可通过 COGMEMAI_GUARD_LOG 更改路径），其中包含判定结果、规则、已脱敏的命令副本、会话和工作目录。guard status 会汇总这些信息。 所有工具，而不只是 Claude Code（v3.25.0）。 Cursor、Codex、Gemini CLI、Cline 和普通脚本最终都会运行 bash -c "<command>"；非交互式 bash 会在运行任何内容之前，加载 BASH_ENV 指定的文件，并将完整命令放在 BASH_EXECUTION_STRING 中。cogmemai-mcp guard shell-install 会写入该文件并将 BASH_ENV 指向它，因此每个这样的 shell 都会将命令交给同一个引擎、同一份规则缓存和同一份日志；遭拒时会以状态码 2 退出，并在 stderr 中说明原因。zsh 则通过 ZSH_EXECUTION_STRING 覆盖。设置 COGMEMAI_GUARD_OFF=1 可跳过单个进程；guard shell-remove 可撤销安装。不覆盖的情况：在 sh 是 dash 的系统上运行 sh -c，以及脚本文件的内容（只会检查 -c 字符串）。

它不是什么。 它不是沙箱，也不能替代 git、备份或审查。在 permissions.allow 中添加笼统的 Bash 条目会让“询问”判定失效，因此防护机制会拒绝，而不是询问。

适用于所有其他 AI（v3.28.0）。 钩子是编码工具发起询问的方式。其他任何工具都只需调用一次：guard_check 工具（或 POST /cogmemai/guard-check，或 SDK 中的 guardCheck）接受用普通文字描述的拟议操作，或其确切命令或消息，以及可选的 kind（command、action、message、other）和 context，并根据适用的规则返回 allow、ask 或 deny。分两轮检查：所有层级都会进行字面匹配（规则引用的片段在操作中逐字出现），付费层级还会针对每条规则记忆以及项目意图中的 NEVER 和 MUST 行进行判定。采用更严格的判定，并且默认放行：发生错误时会放行，并标记为 judged: false。即将发送消息的支持助手、即将消费资源的 Agent、即将移动的机器人，都由你一次保存的同一套文字规则来判定。

规则包

规则包是一组可一起安装的规则。第一个规则包 devsecops 包含 40 条规则，适用于在云基础设施上运行 AI Agent 的团队：机密信息（绝不提交、打印或放入命令行；泄露后立即轮换）、基础设施即代码（从 CI 规划、审查并应用；禁止控制台更改、销毁或直接修改状态）、最小权限（禁止管理员权限或通配符策略、禁止长期密钥；为 Agent 分配各自受限的身份）、杜绝意外公开（存储桶、快照、安全组）、阻止合并的 CI/CD 门禁、变更控制（经审查的拉取请求、有日期的备份和回滚、冻结窗口）、供应链（禁止通过管道运行安装程序、固定版本）、容器和 Kubernetes（禁止特权模式、禁止 cluster-admin、禁止对生产环境运行具有破坏性的 kubectl 命令）、数据（加密，绝不复制到笔记本电脑或 Agent；仅通过迁移执行破坏性 SQL）、日志记录（集中、不可篡改、绝不禁用、不得包含机密信息）、事件响应（尽早宣布、先遏制再保留证据、无责复盘、遵守法规时限），以及一条适用于 Agent 本身的规则：操作前运行 guard_check，完成后运行 review_work，绝不批准或合并自己的工作。

每条规则都会在存在对应 shell 命令形式时明确标注 GUARD: 模式，因此运行前防护机制无需调用模型即可执行；仅适用于文字描述的规则则标注 GUARD: off，避免猜测。使用 npx cogmemai-mcp rules install devsecops 安装，先用 rules show devsecops 查看；添加 --global 可将规则应用于所有项目；如果项目尚无意图文档，添加 --intent 可同时安装匹配的意图文档（用途、九项不变量、不在范围内的事项、完成定义）。规则包只是起点：之后可像处理任何记忆一样编辑、删除或添加规则。

目前提供五个规则包：devsecops（40 条规则）、aws（20 条）、azure（18 条）、gcp（17 条）和 migrate（16 条）。运行 cogmemai-mcp rules list 可查看。云平台规则包会针对各提供商的 CLI 命令形式执行规则（aws iam create-access-key、az role assignment create --role Owner、gcloud projects add-iam-policy-binding --role roles/owner、对所有人开放的安全组、NSG 和防火墙规则、公开的存储桶、公开的数据库、禁用审计日志、已删除的预算和备份）；migrate 规则包则会规范工作负载迁移流程。可以手动安装目标云平台的规则包和 migrate，也可以让 migrate assess 自动安装。

迁移

cogmemai-mcp migrate assess --target aws|azure|gcp [--path DIR] [--out FILE] [--model ID] [--force] [--no-rules] [--dry-run] 会盘点代码库，将迁移范围写为项目意图，将计划、风险和成本驱动因素存储为记忆，写入 MIGRATION.md，并安装 migrate 和目标云平台的规则包。cogmemai-mcp migrate gate "<phase>" [--notes "..."] [--since REF] 会根据范围审查某个阶段；覆盖率达到 80 及以上且没有违规时即通过；migrate status 会列出记录中的评估、门禁和风险。盘点过程只会发送名称和数量（依赖项名称、环境变量名称、主机名、疑似机密文件的文件名），绝不会发送文件内容或值。评估和门禁会调用模型进行判断，且仅在付费套餐中运行；盘点和规则包则适用于所有套餐。

意图

CogmemAi Intent（v3.26.0）是每个项目对应的一份纯英文文档，由 CogmemAi 保存，而非存放在代码仓库中。它是项目所有者的事实来源，写给可能永远不会打开代码的读者。

编写文档时，使用 set_intent 工具（也可以让助手起草，再由你确认内容）。以下四个部分通常很适用：

# my-shop

## Purpose
A checkout for a small shop. Customers pay by card and get an email receipt.

## Invariants
- NEVER charge a card before the address is validated.
- NEVER run `pkill -u www lsphp` on the shared host.
- Every email goes through the queue, never sent inline.

## Decisions
- Tax is computed after discounts because the accountant said so.

## Out of scope
- Subscriptions.

每个会话都会加载此文档，紧接在强制规则之后、截断位置之前，因此助手始终能看到它。get_intent 会返回完整文本；cogmemai-mcp guard intent 会打印缓存副本；每次替换都会将之前的文本保留为一个版本。

不变条件会被强制执行。 标题类似 Invariants、Rules、Must、Never 或 Always 的部分下方的句子，会像规则记忆一样编译：NEVER 或 MUST NOT 后面的反引号命令会成为一种模式，由 PreToolUse guard 拒绝执行；GUARD: <regex> 行也同样有效。此路径不会访问网络；缓存会在会话开始时以及执行 guard sync 时刷新。

每轮都会进行检查。 在 Stop 阶段，本轮的 diff（包括未暂存内容、已暂存内容和新文件的开头部分，最多 16,000 个字符，确保在钩子的预算内完成判断）会发送到 CogmemAi 服务，并在那里根据意图进行评估，因此钩子本身仍然不会调用模型。结果会以几行文字返回，供人查看：

CogmemAi Guard reviewed this turn:
  - Intent check: Charges the card as soon as the form is submitted.
  - Conflicts with your intent ("NEVER charge a card before the address is validated."): The charge now happens before validation.
  - Not in your intent yet: Stores the card number for later. Say "add that to the intent" to record it, or ask for it to be reverted.

意图已涵盖的更改不会产生提示。设置 COGMEMAI_INTENT_VERBOSE=1，即可在每轮评估后查看单行摘要。评审绝不会阻止或编辑任何内容；它只会报告结果，由你决定如何处理。

记分板（v3.27.0）。 每次检查都会追加到 ~/.cogmemai/intent-log.jsonl，记录项目、diff 大小、耗时、发现的冲突和缺口数量，以及显示的具体行。以下三个命令可据此评估功能本身：

cogmemai-mcp guard intent-status            availability, latency, how often it spoke, precision, closed loops
cogmemai-mcp guard intent-log [n]           the last n notes, numbered, with their grades
cogmemai-mcp guard intent-grade [#] right|wrong [why]   grade a note (default: the latest)

精确率，即正确数除以已评估数，是决定该评审是否值得保留的指标；目标是达到十次中九次。“闭环”指缺口提示后的一小时内，同一项目更新了意图文档，这表示所有者提出“把这点加入意图”，而功能也发挥了作用。

评审所有工作，而不只是 diff（v3.28.0）。 review_work 工具（或带有 work 字段的 POST /cogmemai/intent-check，或 SDK 中的 reviewWork）会根据意图评审描述、输出、消息或完整对话记录，并返回相同格式的结果：摘要、已涵盖内容、未涵盖内容、违规项、覆盖率。如果项目没有已保存的文档，可以直接传入 intent，用于让助手评估一次对话，或让机器人检查一项任务。

适用于 Git 之外的场景（v3.29.0）。 当前文件夹不是代码仓库时，评审会读取会话的编辑事件日志，而不是运行 git diff，因此无论当前工作目录为何都能使用；若在子文件夹中编辑，而该子文件夹本身是一个独立项目，则会根据该项目的意图进行评审。

套餐级别。 此项评估会在付费套餐中运行，因为每次都需要发起模型请求。免费套餐仍可使用强制执行的不变条件、上下文注入和所有确定性评审。仅本地存储模式没有意图文档，因为评估需要服务端支持。

手动设置

如果你更愿意手动配置，而不是使用 npx cogmemai-mcp setup：

选项 A，按项目配置（在项目根目录中添加 .mcp.json）：

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

本地模式（注册需要免费的 API 密钥，数据保留在本地）：

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_MODE": "local",
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

选项 B，全局配置（适用于每个项目）：

# Cloud (default)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here --scope user

# Local (free API key required, data stays local)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=local --scope user

# Hybrid (both)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=hybrid --scope user

支持的平台

Claude Code（推荐）

自动设置：

npx cogmemai-mcp setup

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Cline（VS Code）

打开 VS Code 设置 > Cline > MCP Servers，然后添加：

{
  "cogmemai": {
    "command": "npx",
    "args": ["-y", "cogmemai-mcp"],
    "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
  }
}

Continue

添加到 ~/.continue/config.yaml：

mcpServers:
  - name: cogmemai
    command: npx
    args: ["-y", "cogmemai-mcp"]
    env:
      COGMEMAI_API_KEY: cm_your_api_key_here

CogmemUI

CogmemUI 是一款免费的多模型 AI 工作区，内置 CogmemAi 记忆功能。在 Settings > API Keys 中添加 CogmemAi API 密钥后，即可立即使用记忆功能。CogmemUI 还支持通过 Settings > MCP Servers 连接任何兼容 MCP 的工具服务：添加端点、自动发现工具，并在聊天中使用它们。

前往 hifriendbot.com/developer 获取免费 API 密钥。

工具

CogmemAi 提供 41 个工具，AI 助手会自动使用这些工具：

工具	描述
preflight	主动回忆。 提出建议前快速回忆，检查此前的上下文
save_memory	显式存储事实（架构决策、偏好等）
recall_memories	使用自然语言搜索记忆（语义搜索）
extract_memories	AI 自动从对话交流中提取事实
get_project_context	在会话开始时加载重要记忆（包含智能排序、健康评分和会话回放）
list_memories	使用筛选条件浏览记忆（分页，支持筛选未分类记忆）
update_memory	更新内容、重要性、范围、类型、类别、主题和标签
delete_memory	永久删除一条记忆
bulk_delete	一次最多删除 100 条记忆
bulk_update	一次最多更新 50 条记忆（内容、类型、类别、标签等）
get_usage	查看用量统计和套餐信息
export_memories	将所有记忆导出为 JSON，以便备份或迁移
import_memories	从 JSON 数组批量导入记忆
ingest_document	输入文档（README、API 文档），自动提取记忆
save_session_summary	保存本次会话的成果摘要
list_tags	查看所有记忆中使用的标签
link_memories	使用命名关系连接相关记忆
get_memory_links	探索某条记忆周围的知识图谱
get_memory_versions	查看一条记忆的编辑历史
get_analytics	记忆健康状况仪表板，提供自我调优洞察（可按项目筛选）
promote_memory	将项目记忆提升为全局范围
consolidate_memories	使用 AI 将相关记忆合并为综合摘要
save_task	创建持久任务，并跟踪状态和优先级
get_tasks	获取当前项目的任务，从上次进度继续
update_task	随着工作推进，更改任务状态、优先级或描述
save_correction	存储“错误做法 → 正确做法”模式，避免重复犯错
set_reminder	设置提醒，在下次会话开始时显示
get_stale_memories	查找可能已过时、需要审核或清理的记忆
get_file_changes	查看自上次会话以来发生变化的文件
feedback_memory	标记回忆的记忆是否有用或无关，以改进未来的回忆
generate_skills	根据你的纠正和偏好触发技能生成，或通过试运行预览候选项
save_rule	保存一条强制规则，使其在每次会话中显示，并绕过所有评分和衰减
list_rules	列出当前项目和／或全局范围的所有强制规则
delete_rule	按 ID 删除强制规则
get_intent	读取项目的 Intent 文档，即所有者以通俗英语撰写的事实依据
set_intent	创建或替换项目的 Intent 文档（带版本管理；守护机制会强制执行不变量）
guard_check	行动前先询问：针对记忆中的规则和 Intent，允许、询问或拒绝任何拟议操作
review_work	根据 Intent 审查已完成的工作（描述、输出、消息或对话记录）
extract_principles	触发 Wisdom Engine，从记忆簇中检测事实模式

SDK

使用 CogmemAi API 构建自己的集成：

• JavaScript/TypeScript： npm install cogmemai-sdk，npm · GitHub
• Python： pip install cogmemai，PyPI · GitHub

记忆类型

记忆按类别整理，以便更好地组织和检索：

• identity：你是谁、你的角色和团队
• preference：编码风格、工具选择和约定
• architecture：系统设计、技术栈和文件结构
• decision：选择 X 而非 Y 的原因
• bug：已知问题、修复方法和变通方案
• dependency：版本约束和软件包说明
• pattern：可复用模式和约定
• context：项目的一般背景
• task：带有状态和优先级跟踪的持久任务
• correction：错误做法 → 正确做法模式
• reminder：下个会话的提醒，到期后自动失效
• rule：强制指令，会在每个会话中显示，不受任何评分和衰减机制影响

范围

• 项目记忆：特定于某个仓库的架构、决策和错误。系统会根据你的仓库自动检测。
• 全局记忆：你的编码偏好、身份和工具选择。可在每个项目中使用。

定价

	免费版	个人版	专业版	团队版（每个席位）	企业版
价格	$0	$3.99/mo	$9.99/mo	$49.99/mo	$99.99/mo
记忆	500	1,000	2,000	10,000	50,000
每月提取次数	500	500	2,000	5,000	20,000
每月保存次数	1,000	2,000	5,000	20,000	100,000
项目	5	10	20	50	200
已评估的 guard_check 和 review_work		是	是	是	是

当前方案和限额：hifriendbot.com/pricing。Shell 防护、规则包和迁移清单功能适用于所有层级，包括免费版。立即免费开始，需要更多资源时再升级。也可以使用 USDC 链上按操作付费，无需信用卡。

隐私与安全

• 🛡️ 静态数据采用抗量子加密。 所有记忆均采用抗量子密码技术加密，无论云端模式还是本地模式皆如此，可防范当前威胁和未来量子计算机的攻击。
• 源代码不会离开你的设备。 我们只存储提取出的事实（简短句子），绝不存储原始代码。
• API 密钥在服务器端进行密码学哈希处理（不可逆）。
• 所有流量均通过 HTTPS 传输。
• 绝不使用你的数据训练模型。
• 可通过控制面板或 MCP 工具立即删除所有内容。
• 不在用户之间共享数据。

请阅读我们的完整隐私政策。

环境变量

变量	必填	描述
COGMEMAI_API_KEY	是	你的 API 密钥（以 cm_ 开头）。所有模式下均必填；在本地模式中，它用作许可证密钥，数据会保留在你的设备上。
COGMEMAI_MODE	否	存储模式：cloud（默认）、local（数据保留在你的设备上）或 hybrid
COGMEMAI_LOCAL_DB	否	本地数据库路径（默认：~/.cogmemai/local.db）。用于本地和混合模式。
COGMEMAI_API_URL	否	自定义 API URL（默认：hifriendbot.com）
COGMEMAI_ENCRYPTION_KEY	否	本地模式使用的自定义加密密码短语。未设置时会自动生成密钥。
COGMEMAI_LOCAL_ENCRYPTION	否	设为 off 可禁用本地加密（不建议）。

支持

• 问题反馈：GitHub Issues
• 文档：hifriendbot.com/developer

许可证

MIT，详见 LICENSE

---

由 HiFriendbot 构建：更好的朋友，更好的记忆，更好的 Ai。🛡️ 抗量子。