核心用法
obsidian-curator 是一款面向 Obsidian LiveSync 用户的命令行工具，通过直接读写 CouchDB 数据库实现笔记管理，无需本地文件系统访问。核心能力分为六大模块：
1. 快速捕获 (capture)：将碎片想法、会议记录直接写入 vault 的 inbox，支持自定义来源标签。
2. AI 处理 (process/file)：调用大模型为笔记生成摘要、推荐标签、建议存放路径，并按 PARA/Zettelkasten/Johnny Decimal 等预设结构自动归档。支持 OpenAI、Anthropic、Ollama 及自定义端点。
3. 结构审计 (audit)：扫描 vault 文件夹结构，检测与预设规范的偏离。
4. 智能整理 (tidy)：识别重复笔记、空占位文件、孤立内容，AI 辅助处理歧义情况。
5. 任务管理 (tasks)：创建、查询、完成待办，支持自然语言日期解析（"next Tuesday"）和按项目/优先级筛选。
6. 配置管理：交互式初始化向导，支持多种 AI provider 热切换。
---
显著优点
- 架构独特：直接操作 CouchDB 而非文件系统，适合 LiveSync 用户的远程/多端场景
- 安全可信：MIT 开源，npm 发布附带 Sigstore 加密 provenance，无生命周期脚本，仅依赖 nano 和 date-fns
- 隐私优先：本地网络通信，无遥测、无电话回家，凭证仅存本地
- 灵活 AI 策略：从完全离线（Ollama）到云端 API 自由切换，"none" 模式可纯规则运行
- 结构化工作流：内置 PARA、Zettelkasten 等成熟方法论，降低组织决策成本
---
潜在局限与风险
架构限制：
- 必须禁用 E2EE：LiveSync 端到端加密与 CouchDB 直接访问互斥，这是 LiveSync 设计约束，意味着 vault 内容在 CouchDB 中以明文存储
- CouchDB 依赖：无法用于纯本地文件模式的 Obsidian 用户
使用门槛：
- 需自行部署 CouchDB 并完成 LiveSync 配置，对非技术用户有 setup 成本
- AI 功能质量取决于 provider 选择和 prompt 工程，Ollama 本地模型在复杂分类场景可能表现参差
数据安全：
- 凭证以明文 JSON 存储于
~/.obsidian-curator/config.json，依赖操作系统级文件权限保护 - CouchDB 的网络暴露配置由用户负责，工具本身不加固数据库
---
适合人群
- 已使用 Obsidian LiveSync 并托管自有 CouchDB 的知识管理重度用户
- 希望在服务器/CI 环境自动化笔记整理的技术从业者
- 注重数据主权、愿以 E2EE 换取自动化能力的隐私权衡型用户
- 需要跨设备统一入口处理快速捕获和任务管理的效率工具爱好者