obsidian-curator

通过支撑 Obsidian LiveSync 的 CouchDB 数据库来管理 Obsidian 仓库（vault）。支持捕获、处理、归档、审计、整理及任务管理——全部可通过 CLI 或 Node.js API 完成。

前提条件：CouchDB 已配置 LiveSync，且端到端加密（E2EE）已禁用。

安全性与可信度

• 开源：github.com/philmossman/obsidian-curator（MIT 协议）
• npm 可信来源：通过 GitHub Actions OIDC 与 Sigstore 签名证明发布——构建来源具备密码学可验证性
• 无生命周期脚本：不包含 preinstall、install 或 postinstall 脚本——npm install 仅执行文件复制
• 依赖极简：仅依赖 nano（CouchDB 客户端）和 date-fns（日期解析）
• 仅限本地网络：连接至用户配置的 CouchDB 实例（主机/端口），无外部遥测、无“回传”行为、数据不会离开您的本地网络
• 凭据存储：凭据本地保存于 ~/.obsidian-curator/config.json，除发送至您自己的 CouchDB 外，绝不会外传
• 关于 E2EE 的说明：LiveSync 的端到端加密必须禁用，因为本工具需直接通过 CouchDB 读写 vault 文档。这是 LiveSync 架构层面的要求，并非本工具导致的安全妥协

安装与初始化

运行交互式向导——它将实时测试 CouchDB 连接：

obsidian-curator init

配置项包括：CouchDB 连接参数、vault 结构预设（PARA / Zettelkasten / Johnny Decimal / Flat / Custom）、AI 提供商（OpenAI / Anthropic / Ollama / None）、任务项目（task projects）。

配置文件位置：~/.obsidian-curator/config.json

命令

捕获（无需 AI）

obsidian-curator capture "关于项目 X 的一点快速想法"
obsidian-curator capture "站会会议记录" --source meeting

处理收件箱（需要 AI）

为收件箱笔记添加标签、摘要及建议存放路径：

obsidian-curator process
obsidian-curator process --limit 5 --dry-run
obsidian-curator process --force   # 重新处理已标记为“已处理”的笔记

归档笔记（需要 AI）

将已处理的笔记路由至标准 vault 文件夹：

obsidian-curator file
obsidian-curator file --dry-run --min-confidence 0.8

审计（无需 AI）

检查 vault 结构是否符合所配置的标准文件夹规则：

obsidian-curator audit

整理（AI 可选）

识别重复内容、结构违规项、孤立笔记（dead notes）。启用 AI 后，模糊情形将自动分类处理：

obsidian-curator tidy --dry-run
obsidian-curator tidy --checks dupes,stubs

任务管理（无需 AI）

obsidian-curator tasks                          # 列出所有未完成任务
obsidian-curator tasks --project Work --priority high
obsidian-curator task "下周二致电牙医"   # 创建任务（自动解析日期、优先级、所属项目）
obsidian-curator done "牙医"                     # 通过标题关键词匹配标记为完成

配置管理

obsidian-curator config show
obsidian-curator config set ai.provider ollama
obsidian-curator config set vault.host 192.168.1.100

程序化 API

const { VaultClient, Curator, createAIAdapter, loadConfig } = require('obsidian-curator');

const config = loadConfig();
const vault = new VaultClient(config.vault);
await vault.ping();
const ai = createAIAdapter(config);
const curator = new Curator({ vault, ai, config });

await curator.capture('Quick thought');
await curator.process({ limit: 5 });
await curator.file({ dryRun: true });
await curator.audit();
await curator.tidy({ checks: ['dupes', 'stubs'], dryRun: true });

const tasks = await curator.tasks({ status: 'open', project: 'Work' });
await curator.createTask('call Alice next Friday');
await curator.taskBrief();  // Markdown 格式摘要

AI 提供商

vault 结构预设

• PARA：inbox → Projects / Areas / Resources / Archives
• Zettelkasten：inbox → Slipbox / References / Projects / Archives
• Johnny Decimal：inbox → 编号分类文件夹（00–09、10–19 ……）
• Flat：仅 inbox，不强制任何结构
• Custom：自定义标准文件夹结构