@galvinsan/pi-mentis-memory

Pi >= 0.84.0 的独立个人长期记忆 Extension，使用 Pi 原生 Session/Branch provenance、Zvec 本地存储、SiliconFlow Embedding 和混合检索。

如果同时需要知识库，请安装推荐集成包 @galvinsan/pi-mentis，不要同时安装两个产品。

安装

pi install npm:@galvinsan/pi-mentis-memory

要求：Node.js >=22.19.0、Pi >= 0.84.0、有效的 SiliconFlow API Key。

export SILICONFLOW_API_KEY="your-api-key"
pi

使用

本包注册 commit_memory 和 search_memory。

请使用 commit_memory 记住：我在 TypeScript 项目中优先使用严格模式。
请调用 search_memory，搜索我关于 TypeScript 编译配置的偏好。

Memory 以不分类的自然语言断言保存，不写入 Predicate、Memory Type、Domain、Cardinality、Fact Key 或 Semantic Key。需要纠正、强化或撤回时，Agent 会优先在同一轮用 search_memory 找到具体旧记录，再用不变的 commit_memory({content}) 写入新陈述。主写路径先完成保存；后台优先对本轮召回的具体记录做 pairwise reasoning；没有显式召回时可复核 Core 找到的最强向量候选。相似度只选候选，不能改变状态；只有高置信成对证据才能建立 reinforce / supersede / retract / conflict 关系，不确定时安全 coexist。

这不是关键词或 correction/retraction 分类器。相似度只负责找候选，不能改变状态；后台整合保留原始来源、关系边和 decision trace。Branch hypothesis 在验证前不污染主事实；检索前仍执行身份、项目、环境、时间、证据和指令安全 Gate。

查看状态：/mentis status

配置

默认从 ~/.pi/.pi-mentis/config.json 读取全局 profile 配置，不随启动目录或 Workspace 变化。显式 Pi profile 使用 <PI_CODING_AGENT_DIR>/.pi-mentis； PI_MENTIS_HOME 可指定隔离的绝对路径。所有字段可省略：

运行 /mentis help 可查看当前实际配置路径、记忆工具、自动召回和性能影响的详细说明。

{
  "inference": {
    "siliconflow": {
      "apiKeyEnv": "SILICONFLOW_API_KEY",
      "embedding": { "model": "BAAI/bge-m3", "dimensions": 1024 },
      "rerank": { "model": "BAAI/bge-reranker-v2-m3", "maxInputTokens": 8192 }
    }
  },
  "memory": {
    "offload": {
      "inlineMaxBytes": 8192,
      "truncateMaxBytes": 65536,
      "previewBytes": 4096
    }
  },
  "storage": { "rootDir": "/Users/your-name/.pi/.pi-mentis/zvec" }
}

API Key 只放环境变量。storage.rootDir 默认 ~/.pi/.pi-mentis/zvec；同一目录同时 只能有一个写入进程。仅存在 ~/.pi/agent/.pi-mentis 时会兼容使用；两套目录并存时 固定选择稳定的 home root，另一套只报告为 inactive，不会自动合并、覆盖或删除。

检索与安全

• Dense + 全文通过 RRF 融合，Rerank 失败时降级本地排序，MMR 减少重复。
• 自动召回有软/硬超时，不会无限阻塞回复；召回内容标记为不受信任证据。
• 大型工具结果保存为本地 Artifact，模型上下文只接收预览或引用；Artifact 按字节范围分段读取，并二次校验身份。
• 备份前停止 Pi，整体复制 storage.rootDir。
• API Key 不写入 Zvec、manifest、诊断或日志。

升级：pi update npm:@galvinsan/pi-mentis-memory · 卸载：pi remove npm:@galvinsan/pi-mentis-memory

更多信息：架构 · 配置 · 数据模型 · 问题反馈

MIT License.