\[存档\]Mnemo插件
此存储库已存档。 此插件的功能已被完全吸收 mnemo mcp.使用 mnemo-mcp 直接作为您的MCP服务器——不需要插件层。______________________________________________________________________
OpenCode和Claude Code的通用内存插件——由mnemo-mcp提供支持
  ](https://www.npmjs.com/package/@n24q02m/mnemo-plugin) 
 ](#)   
迁移
使用 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)先决条件
- >= 24
- 紫外线 (用于通过运行mnemo-mcp
uvx)
安装
两个插件 和 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
许可证
麻省理工学院-参见 许可证
