# Changelog

All notable changes to this skill are documented here.
Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning: [SemVer](https://semver.org/)

## [1.1.0] - 2026-08-24

### Added

- add the shared feedback-classification and approval-invalidation gate used by every LovStudio Skill

## [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

# Obsidian 缓存清理 · Obsidian Cache Reset

![Version](https://img.shields.io/badge/version-1.1.0-CC785C)

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

Part of [skill-publisher/skills](https://example.com/skills/skills) — by [example.com](https://example.com)

## Install

```bash
npx 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

---
name: lov-obsidian-reset-cache
category: Dev Tools
tagline: "重置 Obsidian 缓存，解决卡在 Loading cache 的问题。"
description: >
  重置 Obsidian 缓存，解决卡在 "Loading cache..." 的问题。
  当用户说 "obsidian 卡住"、"loading cache"、"obsidian 打不开"、"重置 obsidian 缓存" 时触发。
  Trigger when the user mentions Obsidian startup hangs, cache reset, or
  "Loading cache".
license: MIT
compatibility: >
  macOS only. Obsidian stores cache in ~/Library/Application Support/obsidian/.
metadata:
  author: contributors
  version: "1.1.0"
  tags: obsidian, cache, troubleshooting
---

# Obsidian 缓存清理 · Obsidian Cache Reset

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

## When to Use

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

## Workflow

### Step 1: 确认 Obsidian 已关闭

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

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

### Step 2: 清除 IndexedDB 缓存

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

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

## Runtime context (shared)

运行前读取本 Skill 包的 `skill.yaml`，由宿主提供 `skill-runtime/v1` 上下文。字段解析顺序为：当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值。

- 只使用 Manifest 声明的字段；Profile 保存公开品牌事实，Preferences 保存个人工作偏好。
- `required: true` 字段缺失时，按 Manifest 的问题配置向用户提出一个聚焦问题；用户明确同意后再保存回答。
- 报错提供可复制的 `context_id`、字段路径与来源，诊断内容避开秘密、完整私人路径和原始配置。

## 通用反馈闭环

用户在 Skill 驱动任务中提出修改意见时，继续当前产物前必须执行：

1. 先判断意见是 `task-specific`（仅本次）还是 `reusable`（可跨任务复用）。
2. `task-specific` 只修改当前任务，不改 Skill。
3. `reusable` 先确定作用域：领域规则先更新对应 canonical Skill；适用于所有 Skill 的规则先更新共享规范。
4. 完成规则更新、版本、lint 与分发核验后，再把修改应用到当前任务。
5. `reusable` 修改会使此前的“确认”“继续”“发吧”失效；完成当前产物修改和回读后必须停下，等待用户下一步指示，不自动进入发布、提交或其他外部写入。

schema: skill-manifest/v1
id: lov-obsidian-reset-cache
version: "1.1.0"
runtime: skill-runtime/v1
context:
  profile:
    fields:
    - path: identity.name
      required: false
      question: 如果本次输出需要品牌身份，请提供品牌名称。
    - path: identity.logo
      required: false
      question: 如果需要使用品牌 Logo，请提供 Logo 地址或文件路径。
    - path: brand.tone
      required: false
      question: 如果已有品牌语气或审美关键词，请提供它们。
  preferences:
    namespace: lov_obsidian_reset_cache
    fields:
    - path: user.language
      required: false
      question: 希望使用哪种语言输出？
    - path: user.timezone
      required: false
      question: 需要使用哪个时区处理日期和时间？
  interaction:
    ask_missing: true
    max_questions: 1