Skillppx logo

Downloads Folder Organizer

自动将下载文件按规则分类整理至指定目录。

已扫描
适合谁
经常下载文件需要手动整理的用户、希望提升本地文件管理效率的办公人士
不适合谁
无需本地文件管理的用户、不使用 Claude 平台的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @xuxinyuan2019/downloaded-file-organizer
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

将下载文件夹中的文件整理到相应的本地目录中。

步骤

1. 检查配置

运行以下命令：

python3 ~/.claude/skills/organize/organizer.py --scan 2>&1

如果输出包含 "error": "config_missing"，请先交互式运行设置：

python3 ~/.claude/skills/organize/organizer.py --setup

默认目标根目录为 ~/Documents，默认下载目录为 ~/Downloads。

然后重新运行 --scan 命令。

2. 显示预演计划

解析 --scan 返回的 JSON 数组，并以表格形式展示：

文件名目标路径原因备注
.........若存在冲突则重命名
  • target_subdir 是相对于目标根目录的子目录路径
  • renamed: true 表示文件将重命名以避免冲突
  • 如果计划为空，请告知用户当前无待整理的文件

3. 请求确认

提示用户：“上述计划共涵盖 N 个文件。回复 confirm 以继续执行，或告诉我需要调整的内容。”

  • 若用户 确认：进入步骤 4
  • 若用户请求 修改：调整计划（修改 target_subdir 和 final_target 字段），显示更新后的表格，并再次询问
  • 若用户 取消：停止操作

4. 执行整理

将（可能已修改的）计划 JSON 传回脚本执行：

python3 ~/.claude/skills/organize/organizer.py --execute '<JSON>'

显示执行结果：

  • 成功移动的文件数量
  • 出现的错误信息
  • 提及日志保存在 ~/.claude/skills/organize/logs/，索引文件已更新至 ~/.claude/skills/organize/index.md

5. 提供监控模式选项

询问：“是否要启用 监控模式？新加入下载文件夹的文件将自动整理（终端关闭时停止）。”

若选择是：

python3 ~/.claude/skills/organize/organizer.py --watch

注意事项

  • 脚本位置：~/.claude/skills/organize/organizer.py
  • 配置文件：~/.claude/skills/organize/config.json
  • 日志文件：~/.claude/skills/organize/logs/YYYY-MM-DD.log
  • 索引文件：~/.claude/skills/organize/index.md
  • 监控模式需安装 watchdog：pip install watchdog

config.json 中可配置字段

字段说明
target_root文件移动的目标根目录
downloads_dir用于扫描新文件的目录
rules基于关键词的分类规则（数组，每项格式为 {keywords, target, reason}）
extension_fallbacks基于文件扩展名的备用规则（数组，每项格式为 {extensions, target, reason}）
ignored_filenames忽略的文件名（不区分大小写），例如 desktop.ini
ignored_prefixes忽略的文件名前缀，例如 . 和 $
skip_dirs生成索引时排除的目录
X
@xuxinyuan2019

已收录 1 个 Skill

相关推荐