内容
# 个人备忘录，适用于 Hermes
[简体中文](README.zh-CN.md) |
本地优先的个人备忘录、任务、链接和提醒管理系统，适用于 [Hermes Agent](https://hermes-agent.nousresearch.com/)。
个人备忘录将持久数据存储在 SQLite 中，并通过本地 Hermes 插件、斜杠命令、CLI 适配器和可选的 stdio MCP 服务器公开共享业务核心。它支持纯文本笔记和任务，以及链接、文章、视频、截止日期、提醒、历史、备份和模式迁移。
## 亮点
- 代理辅助捕获：从自然语言中提取简洁的摘要、项目类型、日期、提醒和优先级。
- 链接摄入，带有 URL 规范化、重复检测、有限元数据解析、源摘要和重试支持。
- 原生 Hermes 工具以及便捷命令，例如 `/memos`、`/memos_add`、`/memos_detail`、`/memos_done`、`/memos_delete`、`/memos_edit`、`/memos_search`、`/memos_today` 和 `/memos_fresh_all`。
- 用于 Telegram 和其他聊天接口的稳定编号视图。
- 采用 WAL 模式、事务、幂等写入、作用域快照、审计历史、轮换数据库备份和完整性检查的本地 SQLite 存储。
- 其他兼容客户端的可选 MCP 访问，使用相同的数据库和核心逻辑。
## 架构
```text
Hermes 插件 ─────┐
斜杠命令 ────┼──> personal_memo_core ──> SQLite
CLI / MCP 适配器 ─┘ └──────────> 备份和迁移
```
`personal_memo_core`拥有模式、迁移、解析、源摄入、状态转换、备份和业务规则。插件、CLI 和 MCP 服务器是围绕它的薄适配器。
## 要求
- Python 3.10+
- 用于原生插件的 Hermes 安装
- 插件或 CLI 没有第三方依赖
- MCP 的可选依赖项列在 `mcp/requirements-mcp.txt` 中
## 安装
从存储库根目录：
```bash
python3 install.py
hermes plugins enable personal-memo
```
重启 Hermes 网关或启动新会话。安装程序替换已安装的代码、技能、插件和 MCP 适配器，而不创建组件目录备份。数据库备份和迁移防护由核心库管理。
默认数据库是：
```text
~/.hermes/data/personal-memo/memos.sqlite3
```
## 常用命令
```text
/memos
/memos_add 明天下午记得查看实验数据
/memos_detail 2
/memos_done 2
/memos_delete 2
/memos_edit 2 移至下周一
/memos_search Python
/memos_today
/memos_fresh 2
/memos_fresh_all
```
刷新命令使用配置的 Hermes 人物和用户配置文件上下文重新运行结构化 LLM 提取，同时保留原始备忘录内容。
## 可选 MCP 服务器
安装可选依赖项：
```bash
python3 -m pip install -r mcp/requirements-mcp.txt
```
在兼容 MCP 的客户端上通过 stdio 运行 `mcp/server.py`。将其指向相同的 `HERMES_HOME`，以便所有客户端共享一个数据库。
## 开发
```bash
python3 -m unittest discover -s skill/tests -v
python3 -m py_compile install.py core/personal_memo_core/service.py plugin/*.py
```
## 存储库布局
```text
core/personal_memo_core/ 共享数据库和业务逻辑
plugin/ Hermes 插件注册和处理程序
mcp/ 可选的 stdio MCP 适配器
skill/ Hermes 技能、引用和测试
install.py 安装程序和升级入口
```
欢迎提出问题和拉取请求。请将业务行为保留在 `personal_memo_core` 中；框架适配器应保持薄。
