Lovstudio Obsidian Reset Cache

obsidian-reset-cache — 重置 Obsidian 缓存

解决 Obsidian 卡在 "Loading cache..." 无法启动的问题。

When to Use

• Obsidian 启动时卡在 "Loading cache..." 不动
• Vault 文件数量多、有大量非 markdown 文件（如 node_modules）
• 怀疑缓存损坏

Workflow

Step 1: 确认 Obsidian 已关闭

pgrep -x Obsidian && echo "Obsidian 正在运行，请先关闭" || echo "OK: Obsidian 未运行"

如果 Obsidian 正在运行，提示用户先关闭。 如果用户没有明确确认已关闭 Obsidian，使用 AskUserQuestion 确认后再继续。

Step 2: 清除 IndexedDB 缓存

执行前再次确认目标是 Obsidian IndexedDB 缓存，而不是 vault、插件配置或笔记。

rm -rf ~/Library/Application\ Support/obsidian/IndexedDB/

Step 3: 提示用户重新打开 Obsidian

告知用户： 1. 缓存已清除 2. 重新打开 Obsidian，首次加载会稍慢（重建索引） 3. 如果 vault 里有 node_modules 等大量非 markdown 文件，建议创建 .obsidianignore 文件排除

Optional: 创建 .obsidianignore

如果用户的 vault 包含 node_modules 或其他应忽略的目录，帮用户在 vault 根目录创建：

node_modules
.git
.output
dist
build

Notes

• 此操作仅影响 macOS
• 清除的是全局缓存，会影响所有 vault 的索引
• 不会删除用户数据、笔记、插件配置

Changelog

All notable changes to this skill are documented here. Format: Keep a Changelog · Versioning: SemVer

[1.0.2] - 2026-05-07

Fixed

• confirm Obsidian cache reset before deletion

[1.0.1] - 2026-05-07

Fixed

• standardize install metadata
• add README version badge and canonical install command
• expand trigger wording

lovstudio:obsidian-reset-cache

Reset Obsidian cache to fix "Loading cache..." hang issue.

Part of lovstudio/skills — by lovstudio.ai

Install

npx lovstudio skills add obsidian-reset-cache -g -y

No dependencies required (shell commands only).

Usage

Say any of these to trigger:

• "obsidian 卡住了"
• "obsidian loading cache"
• "重置 obsidian 缓存"

What It Does

1. Checks if Obsidian is running (prompts to close if so) 2. Deletes ~/Library/Application Support/obsidian/IndexedDB/ 3. Optionally creates .obsidianignore to prevent future issues

Platform

macOS only.

Safe Operations

• Does NOT delete notes, plugins, or settings
• Only removes the index cache (will be rebuilt on next launch)

License

MIT