功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

视觉文件整理工具（免费版）

概述

视觉文件整理工具免费版作为本地数字管家，自动清理用户杂乱的下载文件夹或桌面。完全模拟人类「双击打开 → 查阅内容 → 总结命名 → 拖拽归档」的物理工作流，利用视觉模型识别文件内容并智能重命名归档。

核心能力

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：利用视觉模型识别、文件内容并智能重、命名归档、模拟人类整理流程、适合个人桌面清理、视觉文件整理工具、免费版、面向个人用户的轻、量级文件整理助手、自动遍历下载文件、夹或桌面、视觉模型识别文件、内容并智能重命名、按分类归档至指定等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：下载文件夹定期清理

用户希望整理杂乱的下载文件夹。

# 整理下载文件夹
file-sorter organize --target $HOME/Downloads

# 示例
# 📂 扫描: $HOME/Downloads
# 📊 发现 28 个待处理文件
# 🔍 视觉识别中...
#
# ✅ 已整理 25 个文件
#   - 财务账单: 8 个
#   - 工作文档: 12 个
#   - 图片素材: 5 个
#
# ⚠️ 未分类: 3 个（密码保护或无法识别）

场景二：桌面文件归档

用户希望将桌面文件按内容归档。

# 整理桌面
file-sorter organize --target $HOME/Desktop --destination $HOME/Documents/Sorted/

# 重命名规则示例：
# 发票.pdf → [2026-07]_发票_某某科技.pdf
# 合同.docx → [2026-07-15]_租房合同.docx
# IMG_001.jpg → [海边日落风景].jpg

场景三：发票与收据的归类

用户希望将发票与收据统一归类至财务目录。

# 仅整理财务类文件
file-sorter organize --target $HOME/Downloads --filter "financial" --destination $HOME/Documents/Sorted/财务账单/

# 输出
# 📊 财务文件整理报告
# 已识别: 12 张发票/收据
# 已重命名并归档: 12 个
# 按月份分组: 2026-05 (3张), 2026-06 (5张), 2026-07 (4张)

不适用场景

以下场景视觉文件整理免费版不适合处理：

• 加密文件破解
• 损坏文件修复
• 物理介质数据恢复

触发条件

需要文件处理、文档转换、格式互转、内容提取时使用。不适用于非本工具能力范围的需求。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

# 1. 整理下载文件夹（默认目标）
file-sorter organize

# 2. 指定目标与归档目录
file-sorter organize --target $HOME/Downloads --destination $HOME/Documents/Sorted/

# 3. 仅整理特定类型
file-sorter organize --target $HOME/Desktop --filter "financial"

# 4. 预览模式（不实际移动）
file-sorter organize --target $HOME/Downloads --dry-run

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

配置示例

# 重命名规则
# 财务报销类（发票/收据）: [YYYY-MM]_发票_[公司或摘要].[扩展名]
# 工作/正式文档: [YYYY-MM-DD]_[文档核心主题].[扩展名]
# 图片/多媒体素材: [画面内容描述].[扩展名]
# 错误处理

# 归档目录结构
$HOME/Documents/Sorted/
├── 财务账单/
├── 工作文档/
├── 图片素材/
└── 其他未分类/

安全红线

1. 禁止删除：仅拥有重命名和移动权限，绝对不允许执行 rm 或移入回收站。
2. 扩展名保护：严禁修改文件后缀名，即使认为是伪装文件。
3. 隐私隔离：视觉识别依赖本地或默认视觉模型，不将截图发送至未授权的第三方 API。

优选实践

• 整理前先用 --dry-run 预览，确认重命名与归档方案。
• 财务类文件按月份分组，便于报销与对账。
• 工作文档按日期命名，便于时间线追溯。
• 无法识别的文件保留原名并加「未分类_」前缀。
• 定期整理（建议每周一次），避免文件堆积。
• 视觉识别依赖本地模型，确保隐私不外泄。

错误处理

常见问题

Q：免费版支持批量处理多少文件？ A：免费版建议单次不超过 50 个文件。如需大批量处理与自定义规则，请考虑 PRO 版本。

Q：免费版支持自定义分类规则吗？ A：免费版使用固定四分类（财务/工作/图片/未分类）。如需自定义分类与规则，请使用 PRO 版本。

Q：视觉识别会泄露文件内容吗？ A：不会。免费版依赖本地或默认视觉模型，不将截图发送至未授权的第三方 API。

Q：可以恢复原始文件名吗？ A：免费版不提供操作历史与回滚。建议整理前用 --dry-run 预览。如需历史与回滚，请使用 PRO 版本。

Q：支持哪些文件类型？ A：支持图片、PDF、Office 文档等可通过视觉识别的文件。加密文件会标记为「未分类_」。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• 视觉能力: Agent 需具备屏幕截图与视觉识别能力

依赖详情

API Key 配置

• 本skill基于Markdown指令规范，无需额外API Key（除内容中明确标注的外部API）
• 视觉识别使用 Agent 内置视觉能力，无需额外配置

可用性分类

• 分类: MD+EXEC（Markdown指令 + 脚本执行 + 视觉能力）
• 说明: 基于Markdown的AI Skill，通过视觉识别与文件操作实现智能整理

已知限制

• 本地运行，不支持多设备同步
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

示例

基本用法

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

效率量化分析

差异化对比