45 lines
2.2 KiB
Markdown
45 lines
2.2 KiB
Markdown
---
|
||
title: "Obsidian-CLI"
|
||
type: concept
|
||
tags: [obsidian, skills, cli]
|
||
last_updated: 2026-04-16
|
||
sources:
|
||
- obsidian-cli
|
||
- obsidian-必装-skills
|
||
---
|
||
|
||
## Definition
|
||
Obsidian-CLI 是 Obsidian v1.12+ 内置的官方命令行工具，让用户能够从终端完全控制 Obsidian 的所有功能。CLI 提供两种使用模式：单命令模式（`obsidian <command>`）和 TUI 交互模式（`obsidian` 进入交互终端，支持自动补全和命令历史）。通过标准化的命令接口，AI Agent 可以实现笔记增删改查、日记管理、任务操作、搜索、书签、热键管理、文件版本对比等全部 GUI 功能，无需图形界面即可完成复杂的知识管理工作。
|
||
|
||
## 核心能力
|
||
- **日常操作**：daily（日记）、search（搜索）、read（读取）、create（创建）、tags（标签）、tasks（任务）、bookmarks（书签）
|
||
- **文件管理**：append/prepend（追加/前置内容）、move/rename（移动/重命名）、delete（删除）
|
||
- **插件管理**：plugin:enable/disable/reload（启用/禁用/热重载插件）
|
||
- **属性操作**：property:set/remove/read（设置/删除/读取属性）
|
||
- **开发者命令**：devtools、dev:screenshot、dev:console、eval（执行 JS）、plugin:reload（热重载社区插件）
|
||
- **版本管理**：diff（版本对比）、history:restore（历史恢复）、sync:restore（Sync 恢复）
|
||
- **工作区管理**：workspace:save/load（保存/加载布局）、tabs（标签页管理）
|
||
|
||
## Configuration Steps
|
||
1. 确认 Obsidian 客户端版本 ≥ 1.12
|
||
2. 打开"设置 → 常规 (General)"
|
||
3. 找到"命令行界面 (Command line interface)"开关并打开
|
||
4. 在弹窗中确认注册到系统 Path
|
||
5. 确保 Obsidian 客户端处于运行状态（未运行时系统会自动启动）
|
||
|
||
## Verification
|
||
```bash
|
||
obsidian daily
|
||
```
|
||
配置正确则 Obsidian 会自动应用日记模版并生成今日日记文件。
|
||
|
||
## Requirements
|
||
- Obsidian ≥ 1.12
|
||
- CLI 开关已开启
|
||
- Obsidian 客户端运行中
|
||
|
||
## Connections
|
||
- [[kepano]] — obsidian-cli 的发布者
|
||
- [[obsidian-必装-skills]] — 来源文档
|
||
- [[Obsidian]] — CLI 所操作的笔记软件
|