Obsidian Ontology Sync

核心功能

obsidian-ontology-sync 是一个自动化知识管理工具，实现人类友好的 Obsidian Markdown 笔记与机器可查询的本体图谱之间的双向同步。

核心用法

该工具采用以 Obsidian 为主、本体为衍生的设计理念：

1. 提取阶段：每 3 小时自动扫描 Obsidian 笔记，从联系人、客户、团队、项目、日常状态等目录提取实体（Person、Organization、Project、Event、Task）及关系（works_at、assigned_to、met_at 等）

2. 分析阶段：每日 9 AM 运行分析，生成缺失信息报告、关系洞察、异常检测

3. 反馈阶段：每周一 10 AM 生成优化建议，包括模板改进、断链修复、关系补全建议

显著优点

• 零额外工作量：保持自然笔记习惯，自动结构化
• 智能查询能力：支持复杂跨数据查询（如"高价值项目上的团队成员"、"7天未跟进的会议联系人"）
• 闭环优化：自动发现缺失字段、建议模板改进、识别数据质量问题
• 多场景覆盖：团队管理、销售跟进、项目监控、财务预测
• Append-only 安全设计：本体采用追加写入，保留完整历史

潜在局限

• 初始配置成本：需配置 YAML 规则定义提取逻辑
• 模板依赖：高度依赖一致的笔记模板结构，格式混乱会降低提取质量
• 单向为主：当前以 Obsidian→本体为主，反向写入（apply-feedback）标记为未来功能
• 技术门槛：需要 Python 环境、cron 配置、命令行操作
• 规模化瓶颈：JSONL 格式在超大规模数据下可能需迁移至 SQLite

适合人群

• 技术型知识工作者、顾问、小型团队管理者
• 已深度使用 Obsidian 且笔记量较大的用户
• 需要跨项目、跨联系人进行关系分析的销售/BD 人员
• 希望将非结构化笔记转化为可查询数据的自动化爱好者

常规风险

• 数据一致性：自动提取可能出现误识别，建议 dry-run 验证
• 隐私暴露：笔记内容中的敏感信息会被提取至结构化存储
• 备份依赖：反馈阶段的自动修改功能（未来）需确保备份机制启用
• 依赖维护：Obsidian 格式变更或 Python 依赖更新可能破坏同步

核心功能

Obsidian-Ontology Sync 是一款 bridges human-friendly note-taking 与 machine-queryable knowledge graphs 的自动化工具。它采用"Obsidian 为主、本体派生"的哲学，让用户保持自然书写习惯的同时，自动提取结构化数据。

显著优点

1. 零摩擦工作流
用户只需正常撰写 Markdown 笔记，系统自动每 3 小时扫描一次，提取 Person、Organization、Project、Event 等实体及其关系（works_at、assigned_to、met_at 等），无需手动维护两份数据。

2. 智能反馈闭环
不仅提取数据，还生成三类洞察报告：

• 缺失信息提醒（如联系人缺少邮箱）
• 断链修复建议（如引用了不存在的项目）
• 关系发现（如识别出 3 位同公司联系人建议归类）

3. 多场景价值

• 团队管理：自动跟踪人员项目分配、响应模式、阻塞问题
• 销售/BD：会议跟进提醒、关系网络映射、Pipeline 分析
• 财务规划：项目估值聚合、成本分摊计算

4. 企业级安全架构
纯本地运行，零网络通信，数据仅存用户指定目录。通过 CLS-Certify S 级认证（95/100 分），无 eval/exec/system 等危险调用。

潜在局限

| 局限 | 说明 |

|------|------|

| 初始配置成本 | 需编写 config.yaml 定义提取规则，对非技术用户有门槛 |

| 英文为主生态 | 实体类型、关系命名默认英文，中文笔记需自定义规则 |

| 单向同步为主 | v1.0 仅支持 Obsidian→Ontology，反向应用反馈需手动确认 |

| 依赖 PyYAML | 虽使用 safe_load()，仍需关注依赖版本安全 |

| 规模限制 | JSONL 格式适合万级实体，十万级以上建议切 SQLite |

适合人群

• 知识工作者：已用 Obsidian 管理联系人、项目、会议笔记，希望获得跨笔记查询能力
• 小型团队负责人：10-50 人团队，需轻量级 CRM/项目管理，不愿购买 SaaS
• 隐私敏感用户：拒绝 Notion/Airtable 云端存储，坚持数据本地主权
• 自动化爱好者：接受 CLI 工具 + Cron 调度，追求可编程的工作流

常规风险提示

1. 配置误操作风险：vault_path 配置错误可能导致误删文件，建议先用 --dry-run 验证
2. 数据备份建议：graph.jsonl 为 append-only，但建议配合 Obsidian Git 插件版本控制
3. cron 任务堆积：大量笔记首次同步可能耗时较长，避免设置过短间隔