File Commander
fengshuzi86 downloadsBatch file operations - select, delete, move, tag, rename images, find broken links and orphan notes.
- Overview
- Scorecard
- Updates2
一个强大的 Obsidian 批量文件管理插件，支持批量选择、删除、移动文件，以及迁移未完成任务。
功能特性
- ✅ 批量选择文件（全选/取消全选）
- ✅ 批量删除文件
- ✅ 批量移动文件到指定文件夹
- ✅ 批量打标签（支持添加到文件开头、末尾或 frontmatter）
- ✅ 批量替换标签（支持关键词重命名）
- ✅ 批量重命名 frontmatter 元数据属性
- ✅ 图片重命名（文件名-001）：将选中笔记内嵌入的图片按出现顺序重命名为
笔记名-001、笔记名-002等 - ✅ 图片转相对路径：将图片链接转换为相对路径，兼容 Typora 等编辑器
- ✅ 图片转最简路径：将图片链接转换为仅文件名的最简路径
- ✅ 按文件夹筛选文件
- ✅ 按标签筛选文件
- ✅ 查找失效图片链接（支持 URL 编码路径，如
%20不会误判） - ✅ 查找未引用图片：找出 assets 等配置文件夹下未被任何笔记引用的图片
- ✅ 查找无标签笔记
- ✅ 查找孤立笔记（无入链和出链）
- ✅ 查找空文件
- ✅ 显示选中文件数量统计
- ✅ 右键菜单快速操作
- ✅ 点击文件名快速打开
- ✅ 文件列表按路径排序
安装方法
方式一：从 GitHub Release 安装（推荐）
- 前往 Releases 页面下载最新版本
- 下载以下文件：
main.jsmanifest.jsonstyles.css
- 在你的 Obsidian 库中创建插件目录：
.obsidian/plugins/file-commander/ - 将下载的文件复制到该目录
- 重启 Obsidian 或刷新插件列表
- 在设置中启用"File Commander"插件
方式二：手动安装
cd /path/to/your/vault/.obsidian/plugins
git clone https://github.com/你的用户名/file-commander.git
cd file-commander
npm install
npm run build
使用方法
批量文件管理
- 点击左侧边栏的文件图标，或使用命令面板搜索 "打开批量文件管理器"
- 在右侧面板中会显示所有 Markdown 文件
- 勾选要操作的文件
- 使用工具栏按钮进行批量操作：
- 全选: 选中所有文件
- 取消全选: 取消所有选中
- 批量打标签: 为选中的文件添加标签
- 批量替换标签: 将选中文件中的旧标签替换为新标签
- 重命名元数据属性: 批量修改 frontmatter 中的属性名（例如将
category改为type） - 删除选中: 批量删除选中的文件（不可撤销）
- 移动选中: 批量移动文件到指定文件夹
- 图片重命名(文件名-001): 将选中笔记内的嵌入图片按顺序重命名为
笔记名-001、笔记名-002等，并更新库内所有引用 - 图片转相对路径: 将
转换为相对路径格式，兼容 Typora - 图片转最简路径: 将
转换为最简路径格式 - 查找失效图片: 查找包含失效图片链接的笔记（支持 URL 编码的图片路径，如
60.Java%20中能创建%20volatile数组吗-001.png） - 查找未引用图片: 找出「图片文件夹」配置（如 assets）下未被任何笔记引用的图片，便于清理
- 查找无标签笔记: 查找没有任何标签的笔记
- 查找孤立笔记: 查找既没有入链也没有出链的笔记
- 查找空文件: 查找空白或只有 frontmatter 的文件
- 按标签筛选: 按一个或多个标签筛选文件
- 按文件夹筛选: 只显示指定文件夹中的文件
- 刷新: 重新加载文件列表
批量重命名元数据属性
这是一个强大的功能，可以批量修改 markdown 文件 frontmatter 中的属性名：
- 选择要修改的文件
- 点击"重命名元数据属性"按钮
- 输入旧属性名（例如：
category） - 输入新属性名（例如：
type） - 点击确定
插件会自动：
- 检查每个文件是否有 frontmatter
- 查找指定的旧属性名
- 保留原有的格式和缩进
- 将属性名替换为新名称
- 保持属性值不变
示例：
修改前：
---
category: 餐饮
status: active
---
修改后：
---
type: 餐饮
status: active
---
图片重命名（文件名-001）
将选中笔记内嵌入的图片按出现顺序重命名为「笔记名-001」「笔记名-002」等格式，并自动更新库内所有引用。
- 在批量文件管理视图中勾选要处理的笔记（.md），可多选
- 点击「图片重命名(文件名-001)」按钮
- 插件会按笔记内图片出现顺序依次重命名为
笔记名-001.扩展名、笔记名-002.扩展名等 - 若同文件夹下已有该命名，会自动使用下一个可用编号
- 重命名后会更新整个库中所有指向该图片的链接（wiki 链接与 Markdown 图片链接）
说明： 仅处理笔记中通过 ![[...]] 或  引用的图片，扩展名以插件设置中的「图片扩展名」为准。
图片路径风格切换
Obsidian 支持最简路径（仅文件名），但 Typora 等编辑器需要相对路径才能正确显示图片。
图片转相对路径：
- 将
转换为格式 - 将
![[image.png]]转换为格式 - 自动计算笔记到图片的相对路径
- 兼容 Typora、VSCode 等 Markdown 编辑器
图片转最简路径：
- 将
转换为格式 - Obsidian 会自动在配置的图片文件夹中查找
- 链接更简洁，便于阅读
查找未引用图片
在「图片文件夹」设置（如 assets）下，找出没有被任何笔记引用的图片文件，方便清理无用附件。
- 在设置中配置好「图片文件夹」（多个用逗号分隔，如
assets,attachments） - 点击「查找未引用图片」按钮
- 列表会显示这些文件夹下所有未被
![[...]]或[[...]]引用的图片 - 可对结果进行删除、移动等批量操作
说明： 只扫描配置的图片文件夹及其子文件夹，扩展名以「图片扩展名」为准。
标签管理
批量打标签：
- 支持添加到文件开头、末尾或 frontmatter（可在设置中配置）
- 多个标签用空格分隔，例如：
#todo #important
批量替换标签：
- 支持关键词重命名，例如将
#cy替换为#餐饮 - 标签可以带或不带
#符号
筛选功能
按标签筛选：
- 支持多标签筛选（OR 关系）
- 显示包含任意选中标签的文件
- 可搜索标签
按文件夹筛选：
- 选择特定文件夹查看其中的笔记
- 支持搜索文件夹
- 可与标签筛选组合使用
快捷操作
- 点击文件名：打开文件
- 右键文件：显示快捷菜单（打开、删除）
- 勾选复选框：选择/取消选择文件
设置选项
在插件设置中可以配置：
标签设置：
- 默认标签：批量打标签时的默认值
- 标签位置：选择标签添加到文件开头、末尾或 frontmatter
图片扫描设置：
- 扫描外部图片：是否检查外部链接（http/https）的图片
- 图片扩展名：要扫描的图片文件扩展名（也用于「图片重命名」和「查找失效图片」）
- 图片文件夹：图片存储的文件夹路径
注意事项
- 删除操作不可撤销，请谨慎使用
- 移动文件时会自动创建目标文件夹
- 如果目标位置已存在同名文件，移动操作会失败
- 重命名元数据属性时，只会修改 frontmatter 中的属性名，不会修改属性值
- 批量操作前建议先备份重要文件
- 查找失效图片时，支持 URL 编码的图片路径（如
%20表示空格），不会将有效图片误判为失效
开发
# 开发模式
npm run dev
# 构建
npm run build
# 部署到本地vault
npm run deploy
# 发布到GitHub
npm run release
技术栈
- TypeScript
- Obsidian API
- esbuild
许可证
MIT
☕ 请作者喝杯咖啡
如果这个插件帮助了你，欢迎扫码打赏，感谢支持！
微信扫码打赏
53%
HealthExcellent
ReviewRisks
About
Manage large sets of notes with batch selection, deletion, moving, tagging, tag replacement, and frontmatter property renaming. Rename embedded images sequentially, convert image links to relative or minimal paths, and find broken or unreferenced images, empty, untagged, or isolated notes. Filter and sort files, view selection counts, and run quick right-click actions.Details
Current version
1.0.0
Last updated
Last month
Created
4 months ago
Updates
2 releases
Downloads
86
Compatible with
Obsidian 1.2.8+
Platforms
Desktop, Mobile
License
MIT