# Macos Finder

> Advanced Finder operations on macOS including file tags, Quick Look preview, Get Info, and smart folder creation.

- Skill: `malue-ai/macos-finder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add malue-ai/macos-finder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/malue-ai/macos-finder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: malue-ai (https://skillmd.com/u/malue-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/malue-ai/macos-finder

---


# macOS Finder 操作

Finder 高级操作：标签管理、Quick Look、文件信息、智能文件夹。

## 使用场景

- 用户说「给这些文件打个标签」「预览一下这个文件」
- 用户需要查看文件的详细信息（大小、创建时间等）
- 用户需要按条件筛选文件

## 命令参考

### 文件标签（macOS Tags）

```bash
# 给文件打标签
tag -a "重要" /path/to/file.pdf
# 或者用 xattr
xattr -w com.apple.metadata:_kMDItemUserTags '("重要")' /path/to/file.pdf

# 查看文件标签
mdls -name kMDItemUserTags /path/to/file.pdf

# 按标签搜索文件
mdfind "kMDItemUserTags == '重要'"

# 移除标签
tag -r "重要" /path/to/file.pdf
```

### Quick Look 预览

```bash
# 预览文件（按空格关闭）
qlmanage -p /path/to/file.pdf

# 生成缩略图
qlmanage -t /path/to/file.pdf -s 512 -o /tmp/
```

### 文件详细信息

```bash
# 完整元数据
mdls /path/to/file.pdf

# 常用字段
mdls -name kMDItemDisplayName -name kMDItemFSSize -name kMDItemContentCreationDate -name kMDItemContentModificationDate -name kMDItemKind /path/to/file.pdf

# 人类可读的文件大小
stat -f "大小: %z bytes" /path/to/file.txt
du -sh /path/to/file.txt

# 文件类型
file /path/to/file
```

### 磁盘空间

```bash
# 磁盘总体使用
df -h /

# 当前目录大小
du -sh .

# 子目录大小排序（前 10）
du -sh */ 2>/dev/null | sort -rh | head -10
```

### 最近使用的文件

```bash
# 最近修改的 20 个文件
mdfind "kMDItemFSContentChangeDate >= $time.today(-1)" -onlyin ~ | head -20

# 最近打开的文件（通过 Finder recents）
mdfind "kMDItemLastUsedDate >= $time.today(-7)" -onlyin ~/Documents | head -20
```

### 文件夹统计

```bash
# 统计文件数量和类型
find /path/to/dir -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn

# 统计总文件数
find /path/to/dir -type f | wc -l
```

## 输出规范

- 文件大小用人类可读格式（KB/MB/GB）
- 时间用「X 天前」「刚刚」等自然语言
- 标签操作后确认结果
- 磁盘空间展示用简洁表格