org-memory 综合评估
org-memory 是一个开源命令行工具（v0.5.0），将 Emacs 生态中经典的 org-mode 格式引入通用工作流，实现纯文本驱动的知识管理与任务系统。核心架构区分「人类工作空间」与「代理知识库」双轨并行，通过 SQLite -backed 的 org-roam 图谱实现语义链接与快速检索。
核心用法
系统围绕 org CLI 构建六大操作范式：
1. 任务管理（Todo/Note/Done/Schedule）
t:/Todo:创建带时间解析的任务（支持自然语言日期如 "in 3 weeks"）r:/Note:记录待办事项到人类收件箱d:/Done:标记任务完成s:重新调度任务日期
2. 知识捕获（Know/Remember）
k:/Know:将信息持久化到代理知识库，支持跨会话记忆
3. 快捷修饰符
v:语音回复、?联网研究、@Roam 查询、!紧急处理等
4. 结构化操作
所有命令支持 -f json 返回标准化信封，错误按 type 分类（file_not_found/headline_not_found/parse_error 等）。
显著优点
纯文本优先
-org 文件为人可读、Git 友好、编辑器无关，规避了 Notion/Roam Research 等专有格式的锁定风险。
双轨隔离设计
-明确区分 $ORG_MEMORY_HUMAN_DIR 与 $ORG_MEMORY_AGENT_DIR，避免人机数据混杂，支持代理长期记忆独立于用户隐私数据。
稳定标识系统
-CUSTOM_ID（如 k4t）机制替代脆弱的文件位置引用，支持跨编辑会话的稳定引用。
Shell 安全设计
-强制单引号包裹用户输入，内置转义规则（' → '\''），从协议层防御命令注入。
渐进式复杂度
-基础用法（创建任务）极简，高级功能（batch 操作、自定义 ID、索引管理）按需深入。
潜在局限
Emacs 生态依赖
-虽为 CLI 工具，但设计理念、文件格式、org-roam 术语对非 Emacs 用户存在认知门槛。
环境配置负担
-需正确设置 6 个必需环境变量（目录与数据库路径），路径含空格时引号处理易出错。
同步与冲突
-多设备场景下需自行解决 org 文件 Git 同步或 Dropbox 冲突，无内置云同步机制。
功能边界
-作为轻量 CLI，缺乏可视化图谱浏览、移动端支持、实时协作等企业级功能。
错误恢复
-parse_error 类错误建议「不再重试」，对损坏文件的修复需人工介入。
适合人群
- 已使用或愿意采用 org-mode 的技术用户
- 追求「本地优先、文本优先」知识管理的隐私敏感者
- 需要将 AI 代理记忆与人际任务分离的高级工作流设计者
- 熟悉命令行、愿为可脚本化牺牲图形界面的效率工具爱好者
常规风险
数据丢失风险
-SQLite 数据库为索引缓存，主数据存于 org 文件。若误删 .org.db 可重建，但若误删 .org 文件则不可逆。建议纳入版本控制。
标识符漂移
-未建立索引前使用 pos 引用会导致错位；CUSTOM_ID 依赖显式 org index 调用，遗漏时行为不稳定。
环境变量泄露
-路径配置可能暴露敏感目录结构（如 ~/org/human/medical/），在多用户环境需审慎设置。
CLI 版本锁定
-v0.5.0 为早期版本，schema 与命令语法未来可能破坏性变更，生产环境建议锁定版本。