介绍
# People memories skill
## 目的
维护一个关于你交谈对象的短期可搜索记忆库，以便你的助手能够即时回顾后续事项。该技能负责：
- `remember`（记住）提示（语音或文本），用于持久化评论、偏好和上下文。 - 摘要 + 导出，以便你打包生成某人的“信息卡片”。 - 搜索、回忆和列表命令，用于快速查阅。 - 可选的自动触发功能，源自语音转录（当你说“remember …”时）。
## 结构与存储
`~/.clawdbot/people-memory.json` 现在存储：
``` { "people": { "alex": { "displayName": "Alex", "notes": [ { "timestamp": "2026-01-29T12:05:00Z", "note": "Likes cats and doing late-night music practice", "source": "voice", "tags": ["pets", "music"] } ] } }, "index": { "music": ["alex"], "cats": ["alex"] } } ```
- 名称已规范化（小写键），但存储显示名称。 - 每条笔记捕获 `timestamp`（时间戳）、`note`（内容）、`source`（来源）和 `tags`（标签）。 - `index` 映射保持关键词 → 人物，以实现超快查找。
## CLI 命令
使用捆绑的脚本来管理数据库：
``` skills/people-memories/scripts/people_memory.py <command> [options] ```
- `remember --person Alex --note "loves chai" --tags drinks,preferences` – 添加一条笔记。 - `recall --person Alex --limit 3` – 读取最新的笔记。 - `summarize --person Alex` – 打印包含计数、标签、最后更新的信息卡片。 - `search --query coffee` – 查找笔记中提到“coffee”的人员。 - `export --person Alex --format md --out ~/Desktop/alex.md` – 将笔记转储为 Markdown（或 JSON）。 - `list` – 列出所有存储的人员及其笔记计数。
## 自动捕获（语音/聊天）
`extensions/people-memories` 扩展会监听 `/voice-chat` 转录内容。当你说诸如“remember Alex likes cats”之类的话时，它会自动运行 `remember` 命令并记录该笔记。索引会在后台更新，除非你明确要求，否则我们会保持确认信息的静默。
## 提醒与自动化
每当笔记提及生日或周年纪念日时，都会附加事件元数据（类型 + 日期）。一个辅助 cron 任务每天早上运行 `python3 skills/people-memories/scripts/people_memory.py reminders --days 0 --window 7 --format message`，并通过 Telegram 传送生成的摘要，以便你在无需手动操作的情况下收到关于未来一周生日/纪念日的提醒。如果你希望不同的频率或渠道，请自行重新运行命令或更新计划。
## 此版本的增强功能
1. **智能索引** – 标签 + 关键词提取保持查找索引更新，因此即使你重复使用形容词，搜索也能找到匹配的人员。 2. **摘要与导出** – 快速生成信息卡片或任何人笔记的可共享 Markdown/JSON。 3. **语音集成 + 记录** – 转录内容直接进入数据库，无需手动输入命令。 4. **结构化数据** – 规范化的键 + 时间戳以及标签元数据，使其他工具（cron、仪表板）能够轻松使用记忆存储。
## 下一步 / 锦上添花的功能
- 通过运行时 `api.message` 辅助函数添加可选的确认响应，例如“已记下，已为 Alex 保存。”。 - 与提醒/cron 集成，以便诸如 `birthday` 之类的标签笔记触发警报。 - 构建一个简单的监视 UI（Web 或终端），用于预览最新的人员卡片。
请告诉我接下来想要自动化的方向（优先级过滤器、通知、跨代理同步等）。