笔记CLI工具箱

基于 notesmd-cli 的 Obsidian 笔记批处理工具箱。聚焦无头（headless）批量操作、 frontmatter 元数据治理、daily note 模板化、与 $EDITOR 集成，把笔记从"逐篇手改"升级为 "脚本化批处理"。 核心能力: - 无头批处理：Obsidian 不运行也能 create/move/delete/search，适合服务器与 CI - frontmatter 治理：打印/编辑/删除 YAML 元数据，批量打标签与改状态 - daily note 模板化：自动读 .obsidian/daily-notes.json，按模板生成每日笔记 - 编辑器集成：--editor 切到 $EDITOR，脱离 Obsidian GUI 也能流畅编辑 - 批处理模板：批量改名、批量打标签、批量归档、批量转状态 适用场景: - 服务器/CI 环境无 GUI 批量管理笔记 - 把笔记当数据库：按 frontmatter 查询、过滤、批量更新 - 自动化 daily note 生成与归档 - 与 Git/编辑器工作流深度集成 差异化: - 无头模式说明 + CI 集成示例，原版只提"支持 headless" - frontmatter 批处理模板，原版只给单条命令 - daily note 模板化流程，原版只给 daily 命令 - 编辑器集成决策表，原版只提 --editor flag 触发关键词: notesmd, cli, headless, frontmatter, daily, 批处理, 模板, editor, 自动化

把 Obsidian vault 当作可被脚本批处理的笔记数据库。基于 notesmd-cli 完成无头创建、frontmatter 治理、daily note 模板化与编辑器集成。

Vault 模型

Obsidian vault = 普通磁盘文件夹。

路径	内容	notesmd-cli 是否可操作
*.md	Markdown 笔记	是（直接读写磁盘）
.obsidian/app.json	默认新文件位置配置	读取（用于 create）
.obsidian/daily-notes.json	daily note 配置	读取（用于 daily）
*.canvas	画板 JSON	不支持（需手动处理）
附件目录	图片/PDF	不直接管理

notesmd-cli 直接操作磁盘，Obsidian 不需要运行，适合无头服务器与 CI。

多库发现

Obsidian 桌面端记录 vault 列表于：

• macOS: ~/Library/Application Support/obsidian/obsidian.json
• Windows: %APPDATA%/obsidian/obsidian.json
• Linux: ~/.config/obsidian/obsidian.json

notesmd-cli 从该文件解析；vault 名通常是文件夹名。

bash

# 已设默认
notesmd-cli print-default --path-only

# 未设默认 → 读 obsidian.json，取 "open": true 条目

多库常见（iCloud vs ~/Documents、工作 vs 个人），不要猜，读配置。

快速开始

bash

# 1. 设默认库 + 打开方式
notesmd-cli set-default "<vault-folder-name>"
notesmd-cli set-default --open-type editor   # 用 $EDITOR 而非 Obsidian

# 2. 搜索
notesmd-cli search                           # 交互式模糊搜索
notesmd-cli search-content "query"           # 全文搜索

# 3. 创建
notesmd-cli create "Folder/New note" --content "..."

# 4. Daily note
notesmd-cli daily                             # 创建/打开今日 daily

# 5. frontmatter
notesmd-cli frontmatter "NoteName" --print
notesmd-cli frontmatter "NoteName" --edit --key "status" --value "done"

# 6. 移动/删除
notesmd-cli move "old/path/note" "new/path/note"
notesmd-cli delete "path/note"

无头模式与 CI 集成

notesmd-cli 直接操作磁盘，Obsidian 不需要运行。适合服务器与 CI/CD。

CI 集成示例：自动生成 daily note

yaml

# .github/workflows/daily-note.yml
name: Daily Note
on:
  schedule:
    - cron: "0 6 * * *"   # 每日 6 点
jobs:
  daily:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g notesmd-cli
      - run: |
          notesmd-cli set-default "vault" --open-type editor
          notesmd-cli daily
      - run: |
          git add .
          git commit -m "chore: daily note $(date +%F)" || echo "no changes"
          git push

服务器批量归档

bash

# 在 NAS/服务器上跑，无 GUI
notesmd-cli set-default "my-vault" --open-type editor
# 把 30 天前的 daily 归档
scripts/archive-daily --days 30 --to "Archive/Daily/"

frontmatter 治理

把 frontmatter 当数据库字段操作。

单条操作

bash

# 打印
notesmd-cli frontmatter "NoteName" --print

# 编辑（添加/修改）
notesmd-cli frontmatter "NoteName" --edit --key "status" --value "done"
notesmd-cli frontmatter "NoteName" --edit --key "tags" --value "project,urgent"

# 删除
notesmd-cli frontmatter "NoteName" --delete --key "draft"

批量模板

bash

# 批量打标签（从 CSV：note_path,tag）
tail -n +2 tags.csv | while IFS=, read -r note tag; do
  notesmd-cli frontmatter "$note" --edit --key "tags" --value "$tag"
done

# 批量改状态：draft → published
for note in $(notesmd-cli search-content "status: draft" --paths-only); do
  notesmd-cli frontmatter "$note" --edit --key "status" --value "published"
done

# 按状态过滤并导出清单
scripts/frontmatter-query --filter "status=published" --output published.md

daily note 模板化

notesmd-cli daily 自动读 .obsidian/daily-notes.json，按配置的文件夹、格式、模板生成。

配置示例（.obsidian/daily-notes.json）

json

{
  "folder": "Daily",
  "format": "YYYY-MM-DD",
  "template": "Templates/Daily Template"
}

模板文件示例（Templates/Daily Template.md）

markdown

---
date: {{date}}
status: active
tags: [daily]
---

# {{date}}

## 今日任务
- [ ] 

## 笔记
- 

## 回顾
- 

批量补建缺失的 daily

bash

# 补建过去 7 天缺失的 daily
scripts/backfill-daily --days 7
# 检查 Daily/ 目录，缺失的按模板生成

编辑器集成决策表

场景	推荐方式	命令
桌面有 Obsidian	用 Obsidian 打开	notesmd-cli create "note" --open
服务器/终端环境	用 $EDITOR	notesmd-cli create "note" --open --editor
CI/无交互	不打开，只创建	notesmd-cli create "note" --content "..."
已有笔记编辑	用 $EDITOR 打开	notesmd-cli open "note" --editor

设默认打开方式：notesmd-cli set-default --open-type editor。

真实场景示例

场景1：CI 自动生成 daily 并推送

text

触发：GitHub Actions 每日 6 点
执行：
1. notesmd-cli set-default "vault" --open-type editor
2. notesmd-cli daily（按模板生成）
3. git add . && git commit && git push
4. 其他设备 pull 即可看到今日 daily

场景2：批量把草稿改发布

text

用户：把所有 status: draft 的笔记改成 status: published
执行：
1. search-content "status: draft" --paths-only → 列出 12 篇
2. 逐个 frontmatter --edit --key status --value published
3. 报告：更新 12 篇

场景3：服务器批量归档旧 daily

text

用户：把 30 天前的 daily 移到 Archive/
执行：
1. scripts/archive-daily --days 30 --to "Archive/Daily/"
2. move 每个旧 daily（自动更新链接）
3. 报告：归档 30 篇

场景4：按 frontmatter 查询

text

用户：列出所有 tags 含 "project" 且 status=active 的笔记
执行：
1. scripts/frontmatter-query --filter "tags~project,status=active"
2. 输出：8 篇匹配，含路径与摘要

场景5：无 GUI 服务器编辑

text

用户：SSH 到服务器改笔记
执行：
1. notesmd-cli set-default "vault" --open-type editor
2. notesmd-cli open "Projects/X" --editor
3. $EDITOR（vim/nano）打开，改完保存
4. Obsidian 桌面端 pull 即可同步

FAQ

Q1: 无头模式真的不需要 Obsidian 运行吗？ A: 是的。notesmd-cli 直接读写 .md 文件，读取 .obsidian/*.json 配置。Obsidian 桌面端运行时检测到文件变化会自动刷新。

Q2: frontmatter 编辑会破坏 YAML 格式吗？ A: 不会。notesmd-cli 解析 YAML 后修改再写回，保留缩进与注释。但建议编辑前备份，避免极端格式问题。

Q3: daily note 模板支持变量吗？ A: 支持。{{date}}、{{time}}、{{title}} 等标准变量。自定义变量需在模板中用 frontmatter 或脚本预处理。

Q4: --editor 用哪个编辑器？ A: 读 $EDITOR 环境变量。设为 vim、nano、code（VS Code）等均可。Windows 可设为 code --wait。

Q5: 批量操作前怎么预览？ A: 所有批量脚本支持 --dry-run，先打印将执行的命令列表，确认后再去掉 flag 实跑。

故障排查

现象	排查路径
print-default 返回空	未设默认 → 读 obsidian.json 找 "open": true
create 报路径错	检查 .obsidian/app.json 默认位置 → 避免隐藏 dot-folder
daily 不按模板生成	检查 .obsidian/daily-notes.json 的 template 字段 → 模板文件存在
frontmatter 编辑失败	检查 YAML 是否合法 → 用 --print 看当前内容 → 修复格式
--editor 无反应	检查 $EDITOR 是否设置 → echo $EDITOR → 设为 vim 等
CI 中 search 卡住	search 是交互式模糊搜索，CI 用 search-content 替代
move 后链接断	确认 CLI 版本支持链接更新 → 升级 notesmd-cli → 手动修复残留

依赖说明

运行环境

• Agent 平台: 任意支持 SKILL.md 的 AI Agent
• 操作系统: Windows / macOS / Linux（无头模式适合服务器）
• Obsidian: 桌面版（可选，无头模式不需要运行）
• 编辑器: $EDITOR 环境变量指向的编辑器（vim/nano/code 等）

第三方依赖

依赖项	类型	是否必需	获取方式
notesmd-cli	命令行工具	必需	npm / 官方仓库
Obsidian 桌面版	软件	可选（仅配置文件需要）	obsidian.md 下载
Node.js ≥ 16	运行时	必需（notesmd-cli 依赖）	nodejs.org
$EDITOR	编辑器	可选（编辑器模式）	系统自带或安装
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

• 无需 API Key
• CI 集成需要 Git 仓库的 Personal Access Token（用于 push）

可用性分类

• 分类: MD+EXEC（Markdown 指令 + 必须通过 exec 执行 notesmd-cli 与批量脚本）
• 说明: 基于自然语言指令驱动 Agent 批处理笔记，含无头模式、frontmatter 治理、daily 模板化