核心用法
org-memory 将 Emacs 生态的 org-mode 文件格式封装为 CLI 工具 org，供 AI Agent 调用。它用纯文本大纲（headlines）承载 TODO 状态、标签、属性、时间戳与链接，结合 org-roam 形成基于 SQLite 的知识图谱。
快捷指令体系：用户通过 t:（创建任务）、d:（标记完成）、s:（重新排期）、r:（记录备忘）、k:（Agent 学习）等前缀即可触发结构化写入；另有 v:（语音回复）、?（联网研究）、@（图谱检索）等行为修饰符。
双空间隔离：ORG_MEMORY_HUMAN_DIR 存放用户任务与备忘，ORG_MEMORY_AGENT_DIR 作为 Agent 的持久知识库，两者均支持 roam 节点与 CUSTOM_ID 稳定引用。
数据安全机制：所有写入强制打印确认日志 org-memory: <action> <file-path>；用户输入强制单引号包裹以阻断 shell 注入；多行内容通过 stdin 管道而非参数传递。
显著优点
1. 文本优先、万古长存：org-mode 是纯文本格式，脱离本工具仍可被任何编辑器读取，避免 vendor lock-in。
2. 图谱化记忆：org-roam 提供双向链接与 SQLite 索引，支持 @ 快速检索相关节点，实现类 Roam Research 的网状笔记。
3. 自然语言交互：前缀指令将口语化输入（"t: 三周后报税"）自动解析为带 --scheduled 的 CLI 命令，降低使用门槛。
4. 稳定标识系统：CUSTOM_ID（如 k4t）与 UUID 双轨制，确保跨会话、跨编辑的持久引用，杜绝位置偏移风险。
潜在缺点与局限性
1. Emacs 生态门槛：虽然 CLI 封装降低了依赖，但深度用户仍需理解 org-mode 语法、org-roam 概念及 Emacs 文化，非技术用户上手曲线陡峭。
2. 环境变量配置繁琐：需正确设置 8 个以上环境变量（目录、数据库路径、开关标志），初始配置易出错。
3. 文件 IO 同步风险：虽强制确认日志，但仍存在并发编辑冲突、文件权限、磁盘满等底层风险；无云端同步机制，需用户自行解决（Git/Dropbox）。
4. 查询能力有限：依赖 SQLite 全文检索，复杂语义搜索（相似度、向量）需外部工具补充。
5. 迁移成本：若从其他记忆系统（如 MEMORY.md）迁入，需执行参考文档中的迁移脚本，存在数据格式转换风险。
适合人群
- Emacs / org-mode 现有用户：已建立 org 工作流，希望为 AI Agent 开放结构化接口。
- 极客型知识管理者：偏好纯文本、本地优先、可版本控制的笔记系统，愿意投入配置成本。
- 长期项目追踪者：需要跨会话持久记忆（
k:指令）与任务生命周期管理（TODO → DONE）。
常规风险
- 数据丢失：未配置 Git 备份或同步服务时，本地文件损坏即永久丢失；建议
org roam sync后定期提交。 - 隐私泄露：知识库文件存储于本地明文，多人共用机器或云同步未加密时敏感信息暴露。
- Agent 误操作：自然语言解析可能误判日期（"下周五"歧义）或任务匹配（同名 TODO），虽强制确认日志，仍需用户核对。
- 命令注入：若开发者未严格遵循单引号包裹规则，用户输入中的特殊字符可能导致意外 shell 执行。