auto-move-file

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 17 Open GitHub ↗

Automatically move files based on frontmatter properties in Obsidian

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Made with ❤️ by 极拓工坊**

# Auto Move File

[English](README_en.md) | **中文**

**Website**: [https://gitapp.net](https://gitapp.net)

一个 Obsidian 插件，根据 frontmatter 属性或文件名自动移动或复制文件到指定目录。支持多规则、多属性监控和灵活的目标文件夹配置。

## 🚀 功能特性

- **自动移动/复制文件**：根据 frontmatter 属性或文件名自动移动或复制文件
- **多规则管理**：支持添加多条规则，按匹配顺序执行
- **规则排序**：支持通过按钮调整规则顺序，影响执行优先级
- **监控模式切换**：支持属性监控和文件名监控模式
- **执行优先级模式**：可选择按规则顺序或按属性值顺序决定优先级
- **实时监控开关**：可开启/关闭实时监控，关闭时只通过手动按钮触发
- **灵活时间设置**：支持毫秒/秒/分钟三种延迟时间单位
- **自定义监控属性**：可监控任意 frontmatter 属性如 `tags`、`status`、`category`
- **多种数据类型**：支持数组类型（如 `tags`）和字符串类型（如 `status`）
- **文件夹归档**：支持归档整个文件夹到目标目录
- **扫描范围设置**：手动触发时可限定扫描特定文件夹
- **文件夹选择器**：可视化选择目标文件夹
- **完美支持中文**：支持 Windows 路径和中文路径

## 📦 安装

### 方法一：手动安装

1. 下载仓库的文件
2. 解压到你的 Obsidian vault 的 `.obsidian/plugins/` 目录
3. 重启 Obsidian
4. 进入 **设置** → **社区插件**
5. 找到 **Auto Move File** 并启用插件

### 方法二：从 GitHub 安装

1. 下载 `main.js`、`manifest.json` 和 `styles.css`
2. 将文件放入 `.obsidian/plugins/auto-move-file/` 目录
3. 重启 Obsidian 并启用插件

## 🎯 使用说明

### 基本流程

1. 打开插件设置并添加规则
2. 配置监控属性、触发值、目标文件夹等
3. 保存设置
4. 修改文件 frontmatter 属性或文件名以匹配规则
5. 文件自动移动/复制到目标目录

### 全局配置

| 设置 | 说明 | 默认值 |
|------|------|--------|
| 监控文件夹 | 只监控指定文件夹中的文件（空=整个仓库） | 空 |
| 关键词 | 文件名必须包含的关键词（空=忽略，多个用逗号分隔） | 空 |
| 延迟时间 | 文件修改后多久开始检查 | `2000` |
| 延迟时间单位 | 毫秒(ms)/秒(s)/分钟(min) | `ms` |
| 扫描文件夹 | 手动触发时扫描的文件夹（空=整个仓库） | 空 |
| 执行优先级模式 | 按规则顺序 / 按属性值顺序 | `按规则顺序` |
| 实时监控 | 开启/关闭自动触发 | `开启` |

### 规则配置

| 设置 | 说明 |
|------|------|
| 监控模式 | 属性监控 / 文件名监控 |
| 监控属性 | 要监控的 frontmatter 属性名（如 `tags`、`status`） |
| 触发值 | 属性包含此值时触发归档 |
| 阻止值 | 属性同时包含此值时不移动 |
| 目标文件夹 | 文件移动的目标路径 |
| 文件夹归档模式 | 归档整个文件夹（而非单个文件） |
| 复制模式 | 复制文件而非移动（保留原文件） |
| 启用状态 | 启用/禁用此规则 |

### 配置示例

#### 示例 1：监控 tags

**Frontmatter：**
```yaml
---
tags: [待发, 文章]
---
```

**规则配置：**
- 监控属性：`tags`
- 触发值：`已发`
- 阻止值：`待发`

**触发：** 将 `tags` 改为 `[已发]` 并保存

---

#### 示例 2：监控 status

**Frontmatter：**
```yaml
---
status: 待发
---
```

**规则配置：**
- 监控属性：`status`
- 触发值：`已发`

**触发：** 将 `status` 改为 `已发` 并保存

---

#### 示例 3：监控文件名

**文件名：**
```
项目-已发.md
```

**规则配置：**
- 监控模式：`文件名`
- 文件名包含：`已发`

**触发：** 文件名包含 `已发` 时触发

---

#### 示例 4：多规则优先级

**规则 1（顺序 1）：**
- 监控属性：`tags`
- 触发值：`已发-微信`
- 目标文件夹：`归档/微信`

**规则 2（顺序 2）：**
- 监控属性：`tags`
- 触发值：`已发`
- 目标文件夹：`归档/通用`

**文件：**
```yaml
tags: [已发-微信, 已发]
```
→ 移动到 `归档/微信`（规则 1 优先）

## ⚙️ 执行优先级说明

### 按规则顺序（默认）

优先级由规则在列表中的顺序决定。排在前面的规则优先级更高。

**使用场景**：需要精确控制哪个规则优先匹配时

### 按属性值顺序

优先级由 frontmatter 中定义属性的顺序决定。文件中先定义的属性对应的规则先执行。

**使用场景**：文件属性本身有优先级含义时

**示例：**
```yaml
status: 已完成
tags: [已发]
```
- 规则 1：监控 `tags` = `已发`
- 规则 2：监控 `status` = `已完成`

→ 触发规则 2（因为 `status` 在 frontmatter 中排在前面）

## 🔧 快捷命令

- **检查并移动当前文件**：检查当前打开的文件是否满足移动条件
- **检查并移动所有文件**：检查所有匹配的文件并批量移动

## ❓ 常见问题

### Q：文件没有自动移动？

**A：** 请检查：
1. 实时监控是否开启？
2. 文件是否在监控文件夹内（如果设置了）？
3. 文件名是否包含关键词（如果设置了）？
4. 规则是否启用？
5. frontmatter 属性值是否正确？
6. 是否包含阻止值？

### Q：如何调整规则优先级？

**A：** 在规则列表中，点击规则右侧的 ⬆️ 或 ⬇️ 按钮调整顺序。排在前面的规则优先级更高（当优先级模式设为"按规则顺序"时）。

### Q：如何只手动触发而不自动归档？

**A：** 关闭"实时监控"开关。关闭后，文件修改不会自动触发；只能通过"检查所有文件"按钮触发。

### Q：如何调试插件？

**A：** 打开 Obsidian 开发者工具（Ctrl + Shift + I），查看 Console 标签页的详细插件日志。

## 📝 更新日志

### v3.1.0
- ✅ 新增实时监控开关
- ✅ 新增延迟时间单位选择（毫秒/秒/分钟）
- ✅ 新增扫描文件夹设置（用于手动触发）
- ✅ 新增执行优先级模式切换（规则顺序/属性值顺序）
- ✅ 新增规则上下移动功能
- ✅ 优化文件夹选择器，支持实时更新
- ✅ 作者信息更新为"极拓工坊"

### v3.0.0
- ✅ 支持多规则管理
- ✅ 支持属性监控和文件名监控
- ✅ 支持文件夹归档模式
- ✅ 支持批量规则操作

### v2.4
- ✅ 新增自定义监控属性功能
- ✅ 支持数组和字符串类型

## 👨‍💻 作者

**极拓工坊**

官网: [https://gitapp.net](https://gitapp.net)

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

如果你喜欢这个插件，请给个 Star ⭐

---

auto-move-file

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README