让 WorkBuddy 拥有跨会话记忆

聊过的偏好、项目背景、团队约定 —— 下次开会话它还记得。

⏱ 约 5 分钟 ✓ 内测期免费 3 步完成

拿一把 Key

打开 注册页，填个邮箱就能申请（内测期免费）。拿到形如 n1mem- 开头的密钥，复制保存（只显示一次）。

装上并连到 WorkBuddy

在运行 WorkBuddy 的那台电脑的终端里执行：

python3 -m pip install --upgrade n1mem-mcp

打开配置文件 ~/.workbuddy/mcp.json（Windows： C:\Users\你的用户名\.workbuddy\mcp.json），把下面这段合并进去（已有很多配置的话，只加 "n1mem" 这一项）：

{
  "mcpServers": {
    "n1mem": {
      "command": "n1mem-mcp",
      "env": {
        "N1MEM_API_KEY": "n1mem-把这里换成你的密钥",
        "N1MEM_SUBJECT": "这台电脑的名字"
      }
    }
  }
}

🔒 Key 只在本机使用：上面的密钥只写进这台机器的 Agent 配置文件（本机），不进网页、不发邮件、不进任何分享链接。

保存后重启 WorkBuddy，在自定义连接器（MCP）里点一下信任即可。

⚠️ 激活三步（不做＝白装）—— 与安装器完成页同源（10-09 实证：漏第①步最常见）：

重启 WorkBuddy（不重启，自定义连接器里根本没有 n1mem 可信任）；
连接器管理 → 右上角【自定义连接器】→ n1mem → 点【信任】；
新开一个会话（旧会话工具集启动时锁定，信任后也不会补发）。

说句话，验证它记住了

在 WorkBuddy 里对它说：「记住：我喜欢深色主题。」

然后开一个全新会话，问它：「我喜欢什么主题？」

它答「深色主题」——接入成功，从此它就一直记得。

✅ 就这么简单

之后的一切是自动的：WorkBuddy 每次对话都会把值得记住的存进 N1Mem，下次开会话自动带上。想看它记了什么、什么时间记的，去记忆时间线看一眼。

连不上 / 没反应？先看这里

工具列表里没有 n1mem

确认 mcp.json 里 "command": "n1mem-mcp"，且终端里 n1mem-mcp --version 能出版本号；
WorkBuddy 的 MCP 配置在用户级 ~/.workbuddy/mcp.json（不是项目目录里）；改完要重启并在连接器里点信任。

调用报 401 / not_registered

401：Key 不对或被吊销 —— 回注册页重新生成；
not_registered：主体的加入申请还在等管理员审批，去后台「成员审批」点一下。

还是不行？

联系 support@n1mem.com，附上 n1mem-mcp --version 的输出（不要发 Key）。

环境变量与「使用人」说明（进阶）

变量	必填	说明
`N1MEM_API_KEY`	✅	第 1 步拿到的密钥，绑定你的专属租户。
`N1MEM_SUBJECT`	建议	「这台电脑是谁在用」的声明。多台设备共用一把组织 Key 时，靠它区分是谁的记忆/谁的账。
`N1MEM_INSTANCE`	可选	设备实例标识（重装后会变），用于归属展示。

使用 0.3.5+ 安装器（install_n1mem.exe）的话，「使用人」会按 Key 登记自动预填， 不需要手动配置——装完即用。

安全与数据隔离（给你技术负责人看的）

密钥即凭证：绑定你的专属租户，只能读写你自己的记忆。请勿提交到代码仓库；怀疑泄露立即联系团队吊销重置。
租户隔离在数据库层强制执行（PostgreSQL RLS）：不是应用层的"约定"，是结构上的"越界查询返回空"。
可见性分级：记忆默认组织内共享，可按 Agent 岗位隔离（如财务 Agent 的记忆普通 Agent 不可见），支持收回为完全私有。
组织管理员可查看与审计本组织记忆（每次查看留审计记录）。

n1mem-mcp 提供 9 个工具（一览）

工具	作用
`memory_write`	写入一条记忆
`memory_retrieve`	按语义召回相关记忆
`memory_search`	关键词搜索
`memory_edit`	修改已有记忆
`memory_timeline`	按时间线浏览
`memory_stats`	用量统计
`memory_forget`	删除指定记忆
`memory_import`	批量导入（文件/对话）
`memory_export`	导出备份

日常对话中 WorkBuddy 会自动调用，无需手动操作。