Back to Details

file-master

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

File Master - Mac 文件管理大师

File Master - Mac File Management Expert

将 disk-cleaner、file-organizer、doc-mindmap 三个技能串成「清 → 理 → 知」三阶段工作流，一次搞定 Mac 文件管理。
Integrate the three skills of disk-cleaner, file-organizer, and doc-mindmap into a three-stage workflow of "Clean → Organize → Analyze" to handle Mac file management in one go.

When to Use

When to Use

仅当用户明确需要多阶段组合流程时使用此技能。 如果用户只想做单一任务（只清理磁盘、只整理文件、只分析文档），请直接使用对应的子技能（disk-cleaner / file-organizer / doc-mindmap），不要使用 file-master。
Use this skill when users:
  • 明确要求组合操作："先清理再整理"、"清理完帮我归类文件"
  • 说"帮我全面整理一下电脑"、"来个文件大扫除"（强调全面/完整）
  • 想一次性完成清理 + 整理 + 归档中的至少两个阶段
  • 说"磁盘快满了还有一堆文件没整理"（多个诉求并存）
不要使用此技能 当用户只说：
  • "清理磁盘" / "释放空间" → 使用 disk-cleaner
  • "整理文件" / "整理下载文件夹" → 使用 file-organizer
  • "分析文档" / "文档转换" → 使用 doc-mindmap
触发关键词: 全面整理电脑, 一站式整理, 文件大扫除, 先清理再整理, 完整文件管理流程
Use this skill only when users explicitly need a multi-stage combined process. If users only want to perform a single task (only disk cleaning, only file organization, only document analysis), please directly use the corresponding sub-skill (disk-cleaner / file-organizer / doc-mindmap) instead of file-master.
Use this skill when users:
  • Explicitly request combined operations: "Clean first then organize", "After cleaning, help me categorize files"
  • Say "Help me fully organize my computer", "Do a file deep clean" (emphasize comprehensiveness/completeness)
  • Want to complete at least two stages of cleaning + organizing + archiving in one go
  • Say "My disk is almost full and I have a bunch of unorganized files" (multiple demands exist)
Do NOT use this skill when users only say:
  • "Clean disk" / "Free up space" → Use disk-cleaner
  • "Organize files" / "Organize Downloads folder" → Use file-organizer
  • "Analyze documents" / "Document conversion" → Use doc-mindmap
Trigger keywords: full computer organization, one-stop organization, file deep clean, clean first then organize, complete file management workflow

Features

Features

  • 三阶段工作流 - 清(释放空间) → 理(归类文件) → 知(文档智能分析)
  • 灵活选择 - 可执行全部三阶段，也可选择任意阶段组合
  • 预览优先 - 每个阶段先预览再执行，用户完全掌控
  • 阶段联动 - Phase 2 整理的路径自动传递给 Phase 3 分析
  • 容错设计 - 某阶段失败或跳过不影响后续阶段
  • 最终报告 - 汇总三阶段成果，一目了然
  • Three-stage workflow - Clean (free up space) → Organize (categorize files) → Analyze (intelligent document analysis)
  • Flexible selection - Execute all three stages, or any combination of stages
  • Preview first - Preview before executing each stage, giving users full control
  • Stage linkage - The organization path from Phase 2 is automatically passed to Phase 3 for analysis
  • Fault-tolerant design - Failure or skipping of a stage does not affect subsequent stages
  • Final report - Summarize results of all three stages at a glance

Usage

Usage

自然语言触发即可，Claude 会引导完成整个流程：
帮我全面整理一下电脑          → 执行全部三阶段
帮我清理磁盘再整理文件        → Phase 1 + Phase 2
整理一下文件然后做个文档分析  → Phase 2 + Phase 3
只帮我做文档分析              → Phase 3
Trigger with natural language, Claude will guide you through the entire process:
Help me fully organize my computer          → Execute all three stages
Help me clean the disk then organize files  → Phase 1 + Phase 2
Organize files then do document analysis    → Phase 2 + Phase 3
Only help me do document analysis           → Phase 3

Dependencies

Dependencies

三个子技能各自的依赖：
Dependencies of the three sub-skills:

Phase 1 - disk-cleaner

Phase 1 - disk-cleaner

  • macOS, Homebrew
  • Mole (
    brew install tw93/tap/mole
    )
  • Python: 
    pip install jinja2
  • macOS, Homebrew
  • Mole (
    brew install tw93/tap/mole
    )
  • Python: 
    pip install jinja2

Phase 2 - file-organizer

Phase 2 - file-organizer

  • macOS
  • Python 3.8+
  • macOS
  • Python 3.8+

Phase 3 - doc-mindmap

Phase 3 - doc-mindmap

  • Python 3.10+
  • markitdown: 
    pip install 'markitdown[all]'
  • Ollama: 
    brew install ollama
    + 
    ollama pull qwen2.5:3b
  • requests: 
    pip install requests
  • Python 3.10+
  • markitdown: 
    pip install 'markitdown[all]'
  • Ollama: 
    brew install ollama
    + 
    ollama pull qwen2.5:3b
  • requests: 
    pip install requests

Claude Workflow

Claude Workflow

Claude 使用此技能时，严格按以下步骤执行。
When Claude uses this skill, strictly follow the steps below.

第 0 步：欢迎 + 阶段选择

Step 0: Welcome + Stage Selection

向用户展示三阶段概览，询问要执行哪些阶段：
Mac 文件管理大师 - 三阶段工作流

Phase 1 「清」 - 磁盘清理，释放硬盘空间 (disk-cleaner)
Phase 2 「理」 - 文件整理，归类下载文件夹 (file-organizer)
Phase 3 「知」 - 文档分析，批量转换 + 摘要 + 分类 (doc-mindmap)

请选择：
1. 全部执行（推荐）
2. 选择部分阶段
3. 只执行某个阶段
如果用户选择部分阶段，记录要执行的阶段列表，跳过未选中的阶段。
Show users an overview of the three stages and ask which stages to execute:
Mac File Master - Three-stage Workflow

Phase 1 "Clean" - Disk cleaning to free up hard drive space (disk-cleaner)
Phase 2 "Organize" - File organization to categorize Downloads folder (file-organizer)
Phase 3 "Analyze" - Document analysis with batch conversion + summarization + classification (doc-mindmap)

Please select:
1. Execute all (recommended)
2. Select partial stages
3. Execute only one stage
If users select partial stages, record the list of stages to execute and skip the unselected ones.

Phase 1「清」- 磁盘清理

Phase 1 "Clean" - Disk Cleaning

使用 disk-cleaner 技能释放硬盘空间。
Use the disk-cleaner skill to free up hard drive space.

1.1 预览扫描

1.1 Preview Scan

bash
python disk-cleaner/scripts/mole_cleaner.py --check
python disk-cleaner/scripts/mole_cleaner.py --preview
向用户展示扫描结果，包括可清理空间大小和分类。
bash
python disk-cleaner/scripts/mole_cleaner.py --check
python disk-cleaner/scripts/mole_cleaner.py --preview
Show users the scan results, including the amount of cleanable space and categories.

1.2 选择清理档位

1.2 Select Cleaning Tier

请选择清理档位：
1. Air - 最安全，只清浏览器缓存和日志
2. Pro - 推荐，平衡安全与空间
3. Max - 最大化释放空间
4. 跳过此阶段
Please select a cleaning tier:
1. Air - Safest, only clean browser cache and logs
2. Pro - Recommended, balance safety and space
3. Max - Maximize space release
4. Skip this stage

1.3 执行清理

1.3 Execute Cleaning

用户选择档位后执行：
bash
python disk-cleaner/scripts/mole_cleaner.py --clean --tier <air|pro|max> --confirm
Execute after user selects a tier:
bash
python disk-cleaner/scripts/mole_cleaner.py --clean --tier <air|pro|max> --confirm

1.4 Phase 1 小结

1.4 Phase 1 Summary

报告释放了多少空间，然后进入 Phase 2。
Report how much space was freed, then proceed to Phase 2.

Phase 2「理」- 文件整理

Phase 2 "Organize" - File Organization

使用 file-organizer 技能归类文件。
Use the file-organizer skill to categorize files.

2.1 预览扫描

2.1 Preview Scan

bash
python file-organizer/scripts/file_organizer.py --status
向用户展示下载文件夹中的文件状况。
bash
python file-organizer/scripts/file_organizer.py --status
Show users the status of files in the Downloads folder.

2.2 选择整理模式

2.2 Select Organization Mode

请选择整理模式：
1. 手动模式 - 创建智能文件夹，自己拖拽整理
2. 自动模式 - 自动按类型分类到桌面文件夹
3. 跳过此阶段
Please select an organization mode:
1. Manual mode - Create smart folders, drag and drop to organize yourself
2. Auto mode - Automatically categorize by type into Desktop folders
3. Skip this stage

2.3 执行整理

2.3 Execute Organization

手动模式：
bash
python file-organizer/scripts/file_organizer.py --manual
自动模式：
bash
undefined
Manual mode:
bash
python file-organizer/scripts/file_organizer.py --manual
Auto mode:
bash
undefined

先预览

Preview first

python file-organizer/scripts/file_organizer.py --auto --dry-run
python file-organizer/scripts/file_organizer.py --auto --dry-run

用户确认后执行

Execute after user confirmation

python file-organizer/scripts/file_organizer.py --auto

自动模式执行后，整理路径会自动写入 disk-cleaner 白名单，保护已整理的文件。
python file-organizer/scripts/file_organizer.py --auto

After executing auto mode, the organization path is automatically written to the disk-cleaner whitelist to protect organized files.

2.4 Phase 2 小结

2.4 Phase 2 Summary

报告整理了多少文件、分了哪些类别。记录输出路径（如 
~/Desktop/已整理文件-YYYYMMDD/
），供 Phase 3 使用。
Report how many files were organized and how many categories were created. Record the output path (e.g., 
~/Desktop/Organized Files-YYYYMMDD/
) for use in Phase 3.

Phase 3「知」- 文档分析

Phase 3 "Analyze" - Document Analysis

使用 doc-mindmap 技能进行文档智能分析。
Use the doc-mindmap skill for intelligent document analysis.

3.0 确定目标目录

3.0 Determine Target Directory

  • 如果 Phase 2 已执行：自动使用 Phase 2 的输出路径
  • 如果 Phase 2 跳过：询问用户要分析哪个目录
  • If Phase 2 was executed: Automatically use the output path from Phase 2
  • If Phase 2 was skipped: Ask user which directory to analyze

3.1 预览文档

3.1 Preview Documents

bash
python doc-mindmap/scripts/doc_converter.py <目标路径> --preview
展示文档列表、类型分布、重复文件检测结果。
bash
python doc-mindmap/scripts/doc_converter.py <target path> --preview
Show document list, type distribution, and duplicate file detection results.

3.2 执行转换

3.2 Execute Conversion

bash
python doc-mindmap/scripts/doc_converter.py <目标路径> --convert --confirm
bash
python doc-mindmap/scripts/doc_converter.py <target path> --convert --confirm

3.3 生成摘要

3.3 Generate Summaries

bash
python doc-mindmap/scripts/doc_converter.py <目标路径> --summarize
bash
python doc-mindmap/scripts/doc_converter.py <target path> --summarize

3.4 三维度分类

3.4 Three-Dimensional Classification

bash
undefined
bash
undefined

先展示分类结果

Show classification results first

python doc-mindmap/scripts/doc_converter.py <目标路径> --organize

询问用户是否使用 AI 建议的文件名。如果同意：

```bash
python doc-mindmap/scripts/doc_converter.py <目标路径> --organize --rename
python doc-mindmap/scripts/doc_converter.py <target path> --organize

Ask users whether to use AI-suggested filenames. If yes:

```bash
python doc-mindmap/scripts/doc_converter.py <target path> --organize --rename

3.5 Finder 预览

3.5 Finder Preview

询问用户是否在 Finder 中预览分类目录：
bash
cp -a <.summaries/schemes> ~/Desktop/文档分类-$(date +%Y%m%d)
open ~/Desktop/文档分类-$(date +%Y%m%d)
Ask users whether to preview the categorized directory in Finder:
bash
cp -a <.summaries/schemes> ~/Desktop/Document Classification-$(date +%Y%m%d)
open ~/Desktop/Document Classification-$(date +%Y%m%d)

3.6 Phase 3 小结

3.6 Phase 3 Summary

报告转换了多少文档、生成了多少摘要、分类结果概览。
Report how many documents were converted, how many summaries were generated, and an overview of classification results.

最终总结

Final Summary

汇总三阶段成果，向用户展示：
=== Mac 文件管理大师 - 完成报告 ===

Phase 1「清」: 释放了 X.XX GB 磁盘空间
Phase 2「理」: 整理了 N 个文件到 M 个分类
Phase 3「知」: 转换了 K 个文档，生成 K 份摘要，三维度分类完成

所有阶段执行完毕！
跳过的阶段标注"已跳过"，失败的阶段标注错误原因。
Summarize results of all three stages and show users:
=== Mac File Master - Completion Report ===

Phase 1 "Clean": Freed X.XX GB of disk space
Phase 2 "Organize": Organized N files into M categories
Phase 3 "Analyze": Converted K documents, generated K summaries, three-dimensional classification completed

All stages executed!
Mark skipped stages as "Skipped", and failed stages with error reasons.

Error Handling

Error Handling

  • 某阶段依赖未安装时，提示用户安装命令，询问是否跳过该阶段继续
  • 某阶段执行出错时，记录错误信息，询问用户是否继续下一阶段
  • Phase 3 依赖 Ollama 本地模型，如果未安装则跳过摘要和分类步骤，只做转换
  • When dependencies for a stage are not installed, prompt users with installation commands and ask whether to skip the stage and continue
  • When a stage execution fails, record error information and ask users whether to proceed to the next stage
  • Phase 3 depends on the Ollama local model; if not installed, skip the summarization and classification steps and only perform conversion

Credits

Credits

  • disk-cleaner - 磁盘清理
  • file-organizer - 文件整理
  • doc-mindmap - 文档智能分析
  • disk-cleaner - Disk Cleaning
  • file-organizer - File Organization
  • doc-mindmap - Intelligent Document Analysis