50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
---
|
||
title: "Obsidian CLI 作为本地 Wiki 维护工具"
|
||
source: "https://obsidian.md/zh/help/cli"
|
||
raw_sources:
|
||
- path: raw/Obsidian CLI - Obsidian 中文帮助 (2026_8_2 16：19：05).html
|
||
hash: "sha256:f6d1043a74f2cf59aa8e9efe6257896e9678677c24a1d66541adcbfc2f1ea3e8"
|
||
tags:
|
||
- "Obsidian"
|
||
- "CLI"
|
||
- "知识库维护"
|
||
- "可观测性"
|
||
last_updated: 2026-08-02
|
||
---
|
||
|
||
# Obsidian CLI 作为本地 Wiki 维护工具
|
||
|
||
Obsidian CLI 需要 Obsidian 应用运行，并允许从终端访问当前 Vault 的文件和结构信息。对于 WikiLLM，它适合承担本地结构检查和少量明确的文件操作，不替代 LLM 的知识编译职责。
|
||
|
||
## 适合自动化的只读检查
|
||
|
||
- `vaults verbose`：列出 Vault 名称和路径。
|
||
- `vault info=path`、`vault info=files`：确认工作区和文件规模。
|
||
- `search query=... path=wiki`：在 Wiki 范围内搜索术语或待办。
|
||
- `unresolved verbose`：列出未解析的内部链接及来源文件。
|
||
- `orphans total`：统计没有入链的文件。
|
||
- `backlinks path=... counts`：检查关键页面是否有反向链接。
|
||
- `outline path=... format=tree`：检查页面章节结构。
|
||
- `properties format=json`、`tags counts`、`tasks verbose`：辅助元数据和任务维护。
|
||
|
||
这些命令可以作为 Lint 的外部传感器，帮助发现 Wiki 页面已写入但导航没有更新、链接目标不存在或新页面没有挂载到知识网络等问题。
|
||
|
||
## 有副作用的操作
|
||
|
||
`create`、`append`、`prepend`、`move`、`rename` 和 `delete` 会修改 Vault。批量执行前必须明确目标路径和操作范围，尤其是 `delete` 的永久删除选项。自动化流程应优先使用 WikiLLM 自己的编译状态和来源追踪，CLI 只做经过确认的局部修复。
|
||
|
||
## 在 WikiLLM 中的建议流程
|
||
|
||
1. LLM 完成摄取并更新 `INDEX.md`、来源和页面链接。
|
||
2. 使用 `unresolved verbose` 检查未解析 Wikilink。
|
||
3. 使用 `orphans total` 和关键页面的 `backlinks` 检查导航连接。
|
||
4. 读取异常页面的 `outline`，确认结构是否完整。
|
||
5. 由 LLM 或人工决定修复方式，再执行有限的文件写入。
|
||
|
||
## 相关研究
|
||
|
||
- [[LLM-Wiki-Desktop-Implementation|LLM Wiki 桌面实现与外部接入]]
|
||
- [[LLM-Wiki-Implementation-Patterns|LLM Wiki 的实现模式]]
|
||
- [[Harness-Engineering|Harness 工程]]
|
||
- [[Externalization-in-LLM-Agents|LLM Agent 中的外部化]]
|