delete-file

name	delete-file
description	安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。

Skill: delete-file（安全删除 + 反向链接清理）

触发时机

用户要求删除某个笔记文件，或清理不再需要的内容时。

输入

• 目标文件路径（用户指定，或询问后确认）
• 搜索范围（默认全 vault，用户可限定目录）

执行步骤

Step 1: 确认目标文件

• 用户已指定路径 → 直接使用
• 未指定 → 询问："要删除哪个文件？"
• 确认文件存在且是 .md 文件（Read 验证）
• 记录文件基本信息：路径、大小、最后修改时间

Step 2: 搜索反向链接

使用 Grep 在 vault 中搜索所有指向目标文件的 [[wikilink]]：

搜索模式（目标文件名为 {name}，不含 .md）：

1. 精确链接：\[\[{name}\]\]
2. 别名链接：\[\[{name}\|.*?\]\]
3. 路径链接：\[\[.*?/{name}\]\]
4. 标题锚点：\[\[{name}#.*?\]\]

执行方式：

Grep pattern="\[\[{name}(\]\]|\||#)" path="{VAULT_PATH}" output_mode="content" -n

搜索范围确认：

• 默认搜索整个 vault
• 若用户限定了范围，只在该目录下搜索（例如 Notes/前端/）

Step 3: 呈现影响分析

汇总并向用户展示：

## 删除影响分析

**目标文件：** `path/to/file.md`
- 大小：X KB
- 最后修改：YYYY-MM-DD

**反向链接：** 在 N 个文件中发现 M 处引用

| # | 引用文件 | 行号 | 引用内容 |
|---|---------|------|---------|
| 1 | Notes/Other.md | L15 | - [[TargetFile]] |
| 2 | Notes/Guide.md | L42 | 详见 [[TargetFile\|说明文档]] |
| ... | ... | ... | ... |

• 若未发现任何反向链接 → 告知用户"未发现指向该文件的链接"，仍要求确认后删除
• 若发现大量反向链接（>20 处）→ 摘要显示前 20 条，提供完整列表

Step 4: 用户确认

• 再次呈现影响分析摘要
• 明确询问："确认删除 {file} 并清理以上所有反向链接？此操作不可撤销。"
• 要求用户回复 "yes" 或 "确认" 才继续
• 用户可选择：
  • 确认全部 → 继续 Step 5-6
  • 取消 → 停止执行
  • 限定范围 → 仅清理指定文件的反向链接

Step 5: 清理反向链接

对每个引用文件，使用 Edit 工具移除指向目标文件的链接：

清理规则：

• 若链接独占一行（如 - [[TargetFile]]）→ 删除整行
• 若链接在列表项中且该项只有链接（如 - [[TargetFile]] 说明）→ 删除整行
• 若链接嵌入句子中（如 详见 [[TargetFile]] 了解更多）→ 仅移除 [[TargetFile]]，保留周围文字
• 若链接带别名（如 [[TargetFile|文档]]）→ 移除整个链接语法，若别名有意义则保留为纯文本
• 移除链接后若产生连续空行 → 合并为单个空行

执行顺序： 按文件逐个处理，每处理完一个文件报告进度。

Step 6: 删除文件

• 默认：直接删除目标文件
• 若用户要求保留备份 → 移动到 {VAULT_PATH}/.trash/{filename}（先创建 .trash/ 目录）
• 确认文件已删除（ls 验证）

Step 7: 报告结果

## 删除完成

- 已删除：`path/to/file.md`
- 反向链接清理：N 个文件中的 M 处链接已移除
- 无遗留孤立链接

产出

• 目标文件已删除
• 所有反向链接已清理

禁止行为

• 不要未经用户确认直接删除文件
• 不要只搜索 [[filename]] 而遗漏别名链接 [[filename|alias]] 和路径链接
• 不要删除文件后遗留孤立的反向链接
• 不要删除非 .md 文件（仅处理 Obsidian 笔记）
• 不要在搜索反向链接前删除文件（先搜索再删除）
• 不要跳过确认步骤，即使反向链接数为 0