用途：这是针对 Obsidian 故障的系统化排查与恢复手册，适用于插件崩溃、数据损坏、同步冲突、性能下降和主题/CSS 异常等问题。每个章节相对独立，可按症状直接跳转使用。
主要能力：先做快速分诊，按症状归入插件崩溃、仓库损坏、同步冲突、性能、CSS/主题五类；插件崩溃可强制安全模式，通过清空 community-plugins.json 或移除指定插件，并在开发者控制台检查加载失败与未处理拒绝，还可用二分法逐步隔离问题插件；仓库损坏可检测空字节、零字节文件、未闭合 YAML frontmatter，并从 .trash、Git 或文件系统快照恢复；同步冲突可定位冲突文件、用 diff 对比并在 Obsidian 中手动合并，同时给出预防措施；性能问题可用性能 API 与元数据缓存计时定位瓶颈，逐个禁用插件排查；CSS/主题问题可重置全部自定义 CSS，并检查 !important 与主题版本兼容性。
使用方式：需要访问对应 vault 目录、开发者控制台（Ctrl+Shift+I 或 Cmd+Option+I）和终端，并在改动前确认备份位置。操作涉及修改 community-plugins.json、appearance.json 等文件，以及 git stash、git checkout 等命令，应谨慎执行。
限制：只依据资料整理，具体版本兼容、备份策略与命令执行环境要求以实际为准；部分命令具破坏性，务必先备份。