核心用法
org-memory是org-cli的扩展技能，为AI Agent创建独立的org工作区，实现用户工作区与Agent记忆区的双轨并行。核心机制是通过@a前缀快捷键操作Agent专属空间：
| 快捷键 | 功能 |
|--------|------|
| `@at:` | Agent收件箱创建TODO |
| `@an:` | Agent空间普通笔记 |
| `@ak:` | Agent roam图谱知识节点 |
| `@ad:` | 完成Agent的TODO |
| `@as:` | 重排Agent任务日程 |
| `@af:` | 搜索Agent org文件 |
关键特性：激活后覆盖memory-wiki，所有图谱化知识优先写入Agent的org-roam而非系统记忆库，实现"一个知识图谱"理念。
显著优点
1. 架构清晰：物理隔离用户与Agent数据，避免命名冲突和权限混淆
2. 工具统一：用户可在同一套Emacs/org-mode工具中浏览双方知识图谱
3. 双向链接：Agent记忆可引用用户图谱中的共享实体（项目、人员）
4. 连续性保障：session启动自动加载memory.org和近期daily notes
5. 写操作可追溯：org-memory:前缀日志明确区分操作来源
潜在局限
- 依赖链条：强制要求
org-cli先行安装配置，环境变量翻倍（6个ORG_MEMORY_*变量） - 学习成本：用户需理解
barevs@a*两种快捷键语义差异 - 同步复杂度：双数据库（用户+Agent）增加备份/迁移心智负担
- org-roam门槛：深度功能依赖Emacs生态，非用户群体难以受益
适合人群
- 已使用org-mode/Emacs构建第二大脑的高级用户
- 需要将AI记忆可视化为图谱、人工审阅/编辑的谨慎型用户
- 多项目并行、需严格区分AI辅助内容与个人笔记的专业工作者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据持久化 | Agent记忆写入本地SQLite/org文件，需关注`$ORG_MEMORY_DIR`的备份策略 |
| 权限边界 | `scope.writes`包含用户工作区路径，实际应为只读（文档描述与metadata存在张力） |
| 版本耦合 | 与`org-cli`版本强绑定，升级需同步验证 |
| 图谱膨胀 | roam节点无自动归档机制，长期运行可能产生碎片化图谱 |