AI导哈

记忆增强插件

Mnemo插件是一款为OpenCode和Claude Code设计的通用记忆增强插件，支持持久化记忆、自动捕获用户偏好和自适应上下文注入。

  • by n24q02m
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 n24q02m/mnemo-plugin

使用说明

[存档]Mnemo插件

此存储库已存档。 此插件的功能已被完全吸收 mnemo mcp.使用 mnemo-mcp 直接作为您的MCP服务器——不需要插件层。

OpenCode和Claude Code的通用内存插件——由mnemo-mcp提供支持

迁移

使用 mnemo mcp 直接：

{
  "mcpServers": {
    "mnemo": {
      "command": "uvx",
      "args": ["mnemo-mcp@latest"]
    }
  }
}

特性

  • 持久内存 --事实在会话、重启和上下文压缩中得以保留
  • 自动捕获 --检测聊天中的用户偏好和约束（总是/从不/必须/首选模式）
  • 自适应上下文注入 --智能预算系统将内存注入扩展到模型上下文窗口
  • 项目范围 --记忆会自动标记项目名称，以便进行相关召回
  • 双平台 --同时适用于OpenCode和Claude Code

建筑

需要完全内存支持 两者 插件和MCP服务器协同工作：

组件 角色 行为
插件 （此包） 主动式 钩子：将内存注入系统提示，自动捕获约束，在压缩时保留上下文
MCP服务器 (mnemo mcp) 反应式 工具：AI在决定搜索/记忆/遗忘时调用 
AI Coding Assistant
  |
  +-- mnemo-plugin (TypeScript) ........... hooks (proactive)
  |     |
  |     +-- bridge -> mnemo-mcp subprocess
  |
  +-- mnemo-mcp (Python, standalone) ..... tools (reactive)
        |-- SQLite FTS5 (keyword search)
        |-- Qwen3 embeddings (semantic search)
        |-- rclone sync (backup)

先决条件

安装

两个插件 和 MCP服务器是完整功能所必需的。

开源代码

添加 两者 到你的 opencode.json:

{
  "plugin": ["@n24q02m/mnemo-plugin@latest"],
  "mcp": {
    "mnemo": {
      "type": "local",
      "command": ["uvx", "--python", "3.13", "mnemo-mcp@latest"],
      "environment": {
        "LOG_LEVEL": "WARNING"
      },
      "enabled": true
    }
  }
}
  • 插件 提供挂钩（系统提示注射、自动捕获、压缩）
  • MCP服务器 提供工具（mnemo_memoy_add、搜索、删除等）

配置后重新启动OpenCode。

克劳德代码

该插件将MCP服务器和挂钩捆绑在一个安装中：

/plugin marketplace add n24q02m/mnemo-plugin
/plugin install mnemo-plugin@n24q02m

重新启动克劳德代码。插件会自动注册：

  • MCP服务器(uvx mnemo-mcp)用于存储工具
  • SessionStart钩子用于健康检查

工具（通过MCP服务器）

MCP服务器提供三个大型工具。看 mnemo mcp 获取完整文档。

工具 操作 描述
memory 添加、搜索、列表、更新、删除、导出、导入、统计 持久内存CRUD和管理
config 状态、同步、设置 服务器配置和云同步
help -- 所有工具的完整文档

钩子（通过插件）

钩子 触发器 描述
system-prompt 会话开始 使用自适应预算将相关内存注入系统提示
auto-capture 会话空闲 缓冲聊天消息并自动提取约束
compaction 上下文压缩 在会话压缩期间保留内存上下文

发展

# Setup
mise run setup

# Development
bun run dev

# Quality checks
bun run check        # biome + tsc
bun run test          # vitest
bun run build         # tsc + cli bundle

# Shortcuts
mise run lint
mise run test
mise run fix

贡献

看 贡献.md

许可证

麻省理工学院-参见 许可证

相关 MCP