Obsidian Daily

核心用法

obsidian-daily 是一款基于 obsidian-cli 的命令行工具封装，允许用户在不打开 Obsidian 图形界面的情况下，直接在终端中管理每日笔记。核心功能包括：

• 创建与打开：obsidian-cli daily 快速打开或创建当日笔记
• 智能追加：自动检测文件是否存在，新文件添加 H1 日期标题，已有文件直接追加内容
• 日期解析：支持自然语言日期（yesterday、last Friday、3 days ago 等），GNU/BSD 双兼容
• 内容检索：支持按日期读取笔记全文，以及 vault 级别的内容搜索和交互式模糊查找

显著优点

1. 终端原生体验：适合开发者和工作流自动化场景，无需切换至图形界面
2. 跨平台兼容：通过 2>/dev/null || 模式优雅处理 GNU date 与 BSD date 差异
3. 模板感知：尊重 Obsidian Daily Notes 插件的模板配置，自动应用
4. 多 vault 支持：可通过 --vault 参数切换工作区

潜在局限

• 依赖外部工具：必须预先安装并配置 obsidian-cli，且需手动设置默认 vault
• 无内置日期库：依赖系统 date 命令，Windows 原生环境（非 WSL）支持有限
• 权限边界：直接操作本地文件系统，误操作可能导致笔记覆盖或数据丢失
• 功能边界：仅覆盖 Daily Notes 场景，不涉及图谱、插件生态等高级功能

适合人群

• 重度终端用户、开发者、追求效率的 Obsidian 用户
• 需要快速记录日志、任务，或集成到 shell/Alfred/Automator 工作流的用户

常规风险

• 数据覆盖风险：--overwrite 参数使用不当可能清空已有内容
• 路径注入风险：用户输入的 vault 名称、文件路径若未校验，可能导致命令注入
• 隐私泄露：搜索内容时可能意外暴露敏感笔记片段
• 同步冲突：CLI 与 Obsidian 同时编辑同一文件时可能产生冲突

核心用法

obsidian-daily 是一个纯 Markdown 文档型 Skill，通过调用 obsidian-cli 命令行工具实现与 Obsidian 笔记库的交互。主要功能包括：

• 创建/打开每日笔记：obsidian-cli daily 自动打开或创建当天笔记
• 追加条目：通过复杂的 bash 条件判断，智能处理新文件创建（带 H1 日期头）或现有文件追加
• 日期读取：支持具体日期和相对日期（yesterday, last Friday, 3 days ago 等）
• 内容搜索：obsidian-cli search-content 全文检索，obsidian-cli search 交互式模糊查找
• 多 Vault 支持：通过 --vault 参数切换不同笔记库

跨平台日期处理采用 GNU/BSD 双兼容方案，确保在 Linux、macOS、WSL 等环境稳定运行。

显著优点

• 终端原生体验：无需离开命令行即可完成笔记管理，与 tmux、zsh 等工具链无缝衔接
• 自动化友好：所有操作均可脚本化，适合构建个人工作流自动化（如配合 cron 定时记录）
• 日期语义丰富：自然语言日期解析降低认知负担
• 模板继承：自动利用 Obsidian Daily Notes 插件的模板配置
• 零网络依赖：纯本地文件操作，离线可用

潜在缺点与局限性

• 外部依赖强制：必须预先安装 obsidian-cli，且该工具需单独维护更新
• 配置门槛：首次使用需配置默认 vault，对非技术用户不够友好
• 追加逻辑复杂：核心的 append 命令使用冗长的 bash 条件判断，可读性差，出错时难以调试
• 功能受限：依赖 obsidian-cli 的能力边界，无法利用 Obsidian 插件生态的高级功能（如 Dataview 查询）
• 跨平台差异：日期命令虽做了兼容处理，但不同系统行为仍可能有细微差别

适合人群

• 重度终端用户、开发者、DevOps 工程师
• 已建立 Obsidian 笔记体系，希望扩展命令行工作流的用户
• 需要自动化记录（日志、时间追踪）的技术从业者
• 追求"键盘优先"操作效率的效率工具爱好者

常规风险

• 文件系统访问：可读取和写入整个 vault 内容，虽无外传行为，但误操作可能覆盖重要笔记
• 供应链风险：obsidian-cli 的更新需通过包管理器跟进，长期未更新可能引入兼容性问题
• 命令注入：虽当前实现安全，但若未来扩展用户输入拼接需警惕注入风险
• vault 配置依赖：配置错误或变更后可能导致命令失败，建议定期验证 print-default 输出