前言¶
浏览器、聊天工具和 IDE 都会往下载目录堆文件。时间一长，~/Downloads 里会混着 PDF、截图、安装包和半成品下载，找东西只能靠文件名搜索。手工拖拽分类费时，写一次性脚本又容易和自家路径、扩展名规则绑死。
下面介绍 SkillHub 社区 Skill「下载文件归档助手」（@user_7b04d250/tzl）。它用通用 SKILL.md 约定触发语与步骤，并附带 Python 脚本，把 Agent 的自然语言意图落到「扫描 → 分类 → 移动 → 汇总」上。
这是什么¶
「下载文件归档助手」是面向知识管理（SkillHub 分类 knowledge-management）的 Agent Skill，坐标 @user_7b04d250/tzl，版本 1.0.0，来源为 community，发布者 user_7b04d250。包内技能名为 download-archiver，不需要 API Key（requires_api_key=false）。
当用户表达「整理下载文件夹」「归档下载」「整理 Downloads」等意图时，Agent 按技能说明确认目录与规则，再调用 auto_archive.py 把文件移入下载目录下的 归档 子目录，并按修改日期的 YYYY-MM 与文件类型分子文件夹。
核心功能¶
以下能力来自安装包内 download-archiver/SKILL.md 与 scripts/auto_archive.py（2026-10-22 经 skillhub install 核对）。
触发与交互¶
- 典型触发语：整理下载文件夹、归档下载文件、整理 Downloads。
- Step 1 向用户确认源目录（默认
~/Downloads，可用--downloads覆盖）、归档目录名（默认归档）、以及四类分类。 - Step 3 根据脚本输出汇报移动数量、分类统计、跳过与错误项。
目录与分类规则¶
默认将文件移入：
归档/YYYY-MM/文档/归档/YYYY-MM/图片/归档/YYYY-MM/视频/归档/YYYY-MM/安装包/
YYYY-MM 取自文件修改时间。目标路径下同名文件会覆盖，不保留副本。
处理的扩展名¶
脚本按扩展名映射到四类（节选，完整列表以包内脚本为准）：
- 文档：
.pdf、.doc、.docx、.xls、.xlsx、.ppt、.pptx、.txt、.md、.csv等 - 图片：
.jpg、.png、.gif、.webp、.heic等 - 视频：
.mp4、.mkv、.mov、.webm等 - 安装包：
.exe、.msi、.dmg、.deb、.apk等
不在上述集合内的扩展名会跳过。名称匹配 thumbs.db、desktop.ini、.crdownload、~$ 等模式的系统或临时文件也会排除。只处理下载目录下的文件，子目录（含已存在的 归档 目录本身）不参与移动。
命令行参数¶
| 参数 | 说明 |
|---|---|
--downloads / -d |
下载文件夹路径，默认 ~/Downloads |
--archive-name / -a |
归档根目录名称，默认 归档 |
--dry-run / -n |
技能文档中声明为模拟运行 |
安装与启用¶
安装 SkillHub CLI¶
若尚未安装 CLI，可按官方安装说明执行：
command -v skillhub && skillhub --version
未安装时（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。官方页面给出的安装提示为：参照 https://skillhub.cn/install/skillhub.md，安装 @user_7b04d250/tzl。
在已配置 skillhub 的环境下，搜索索引给出的命令为：
skillhub install tzl --namespace user_7b04d250 --dir ~/.cursor/skills/
其他客户端的常见 skills 路径（摘自 SkillHub 安装文档）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
将 --dir 换成对应路径即可。安装成功后目录中通常包含 _meta.json 与 SKILL.md；本包的 SKILL.md 为 zip 归档，内含 download-archiver/SKILL.md 与 download-archiver/scripts/auto_archive.py。
启用方式¶
将 Skill 装入 Agent 的 skills 目录后，在对话中用自然语言触发即可；Agent 读取技能说明后执行脚本。无需额外 API Key。
典型用法¶
1、对话触发（推荐）¶
在 Cursor、Claude Code 等已加载该 Skill 的客户端中，直接说明意图，例如：
「帮我整理下载文件夹，按技能默认规则归档。」
Agent 应先确认是否使用默认 ~/Downloads 与 归档 目录，再运行 Python 脚本。
2、本地直接运行脚本¶
技能文档中的示例路径为 Windows 下的 QClaw 目录：
python "C:\Users\someo\.qclaw\skills\download-archiver\scripts\auto_archive.py"
在 Linux 或 macOS 上，应改为本机安装目录下的脚本。若尚未解包，可从 Skill 目录中的 zip 形态 SKILL.md 取出脚本后执行，例如：
SKILL_ZIP="$HOME/.cursor/skills/@user_7b04d250/tzl/SKILL.md"
unzip -p "$SKILL_ZIP" download-archiver/scripts/auto_archive.py > /tmp/auto_archive.py
python3 /tmp/auto_archive.py --downloads "$HOME/Downloads"
指定其他下载目录或归档文件夹名称：
python3 /tmp/auto_archive.py -d /path/to/Downloads -a 归档
执行结束后终端会打印处理总数、成功移动数、跳过与错误数，以及各分类计数。
适用场景与注意¶
适合谁
- 希望定期把
Downloads收成「按月 + 按类型」结构，又不想每次手写mv或维护私有脚本的用户。 - 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent，希望用一句话触发整理流程的团队或个人。
限制与注意
- 仅四类媒体与安装包；源码仓库、压缩包、无扩展名文件等会保持原位。
- 同名覆盖不可恢复，重要文件请先备份或改归档策略。
- 技能文档写有
--dry-run，但当前auto_archive.py的main()仅打印 DRY-RUN 提示，未把该标志传入移动逻辑；正式整理前请用小范围目录试跑，或自行改脚本后再用。 - 包内示例脚本路径为 Windows 绝对路径，跨平台使用时需指向实际解压后的
auto_archive.py。 - SkillHub 页面统计（抓取时）：评分 100000，下载 1002，安装 0；数据随平台更新变化。
结尾¶
「下载文件归档助手」把「整理 Downloads」收成可重复的 Agent 工作流：默认 ~/Downloads → 归档/YYYY-MM/分类/，由 Python 脚本完成扫描与移动，并在终端给出摘要。若你使用 SkillHub 管理 Skills，可从官方页面获取安装提示并安装 @user_7b04d250/tzl：
- SkillHub 页面：https://www.skillhub.cn/skills/user_7b04d250/tzl
- 技能 API 标识：https://api.skillhub.cn/user_7b04d250/tzl
