Sgc Obsidian Reset Cache

重置 Obsidian 缓存,解决卡在 "Loading cache..." 的问题。 当用户说 "obsidian 卡住"、"loading cache"、"obsidian 打不开"、"重置 obsidian 缓存" 时触发。 Trigger when the user mentions Obsidian startup hangs, cache reset, or "Loading cache".

lovstudio 4932acd 3 files · 3.0 KB Updated

File contents

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 的索引
  • 不会删除用户数据、笔记、插件配置

lovstudio/dev-skills/tree/main/skills/obsidian-reset-cache commit 4932acd55d

Frequently asked questions

npx skillmds@latest add lovstudio/sgc-obsidian-reset-cache