前言¶
桌面堆满截图、安装包和临时文档时，手工拖进文件夹既慢又容易漏。纯脚本可以按扩展名批量移动，但缺少预览和撤销，误操作成本高。下面介绍 SkillHub 社区 Skill「小巧好用 一键整理桌面」（坐标 @user_8cda13c6/desktop-file-sorter-ultra-77，版本 1.0.0）：在 Agent 侧用自然语言触发，本地用 Python + tkinter 图形界面完成扫描、预览、一键整理与撤销，无需第三方依赖，也不要 API Key（requires_api_key=false）。
这是什么¶
「小巧好用 一键整理桌面」是发布者 user_8cda13c6 在 SkillHub 上架的 life-service 类社区 Skill（来源：community）。它把桌面整理工具的说明与触发词写进标准 SKILL.md，并附带可执行的 desktop_organizer.py 主程序。
定位是 Windows 环境下的桌面文件自动分类：按扩展名归入图片、文档、视频等文件夹，整理前在界面里预览，确认后再移动文件；快捷方式（.lnk）和已有子文件夹默认不移动。
SkillHub 页面：https://www.skillhub.cn/skills/user_8cda13c6/desktop-file-sorter-ultra-77
API 资料页：https://api.skillhub.cn/user_8cda13c6/desktop-file-sorter-ultra-77
（截至资料抓取：SkillHub 评分 100000，下载 963 次。）
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 desktop_organizer.py 的实现说明。
- 自动扫描：启动后扫描目标目录（默认用户
Desktop），列出待整理文件。 - 八大类 + 其他：图片、文档、视频、音乐、压缩包、程序、代码、字体；未匹配扩展名归入「其他」。
- 整理预览：树形列表展示每个文件的大小、修改时间及拟归入的分类。
- 一键整理：在桌面（或你选定的目录）下创建与分类同名的子文件夹并移动文件；同名冲突时自动加时间戳后缀。
- 安全跳过：目录项与
.lnk快捷方式不参与移动。 - 撤销：将最近整理操作写回历史；本地最多保留最近 10 次记录，支持从界面执行撤销。
- 更改路径：GUI 支持选择非桌面的文件夹作为整理目标。
Agent 侧触发词（任选其一即可让已安装该 Skill 的助手进入对应流程）：整理桌面、桌面文件整理、桌面很乱、整理我的桌面、整理文件夹、桌面太乱了、文件太多了。
安装与启用¶
Skill 需先进入当前 Agent 的 skills 目录，否则不会被加载。官方页面给出的安装提示如下。
通过 SkillHub CLI 安装（推荐）¶
先确认本机已安装 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（示例为官方文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 装到 当前使用的 Agent 的 skills 目录（--dir 必填）。例如 Cursor：
skillhub install desktop-file-sorter-ultra-77 --namespace user_8cda13c6 --dir ~/.cursor/skills/
其他常见路径（来自 SkillHub 安装文档，按你实际使用的客户端选择其一）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Gemini CLI：
~/.gemini/skills/
也可把下面提示词发给 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8cda13c6/desktop-file-sorter-ultra-77`。
安装完成后，Skill 目录中通常包含 SKILL.md 与 desktop_organizer.py。若 Agent 需要重启或重新加载 skills 才能识别新包，请按你所用客户端的说明操作。
依赖与环境¶
- Python 3.x，标准库：
tkinter、shutil、pathlib、json、threading。 - 无需额外 pip 包；Windows 上需具备可用的 tkinter（多数官方 Python 安装已包含）。
典型用法¶
方式一：在 Agent 对话中触发¶
在已安装该 Skill 的 Cursor、Claude Code 等环境中，直接说「整理桌面」或上述任一触发词。Agent 会按 SKILL.md 引导你运行本地 GUI 或说明操作步骤。
方式二：命令行启动 GUI¶
进入 Skill 安装目录后执行主程序（路径请替换为你本机 --dir 下的实际位置）：
python ~/.cursor/skills/@user_8cda13c6/desktop-file-sorter-ultra-77/desktop_organizer.py
方式三：WorkBuddy¶
SKILL.md 写明可在 WorkBuddy 中说「整理桌面」，由 AI 协助启动并引导操作（WorkBuddy skills 目录一般为 ~/.workbuddy/skills/，安装时同样使用 --dir 指向该路径）。
界面内工作流¶
经过上面的步骤打开程序后，可按固定流程操作：
- 启动 → 自动扫描桌面（或你更改后的路径）。
- 预览 → 左侧树形列表查看分类结果与统计。
- 确认 → 点击「一键整理」，在对话框中确认。
- 执行 → 文件移入对应分类文件夹。
- 如需回滚 → 使用「撤销整理」；历史记录在用户主目录下的
.desktop_organizer_history.json（程序内最多保留 10 条）。
扩展名与分类的对应关系以 SKILL.md 中的表格为准；程序实现中还包含少量额外扩展名（如文档类的 .odt、代码类的 .yaml 等），未列出的文件进入「其他」。
适用场景与注意¶
适合谁
- 主要在 Windows 上工作、桌面文件类型杂、希望「先看一眼再动」的用户。
- 已在使用 Cursor / Claude Code / WorkBuddy 等支持 Skill 的客户端，希望用一句话唤起整理流程的人。
限制与注意
- 工具面向 Windows 桌面场景设计；GUI 字体与 DPI 处理按 Windows 习惯编写，在其他系统上是否可用取决于 Python 与 tkinter 环境，官方说明以 Windows 为主。
- 整理规则完全按扩展名匹配，不会读取文件内容；同名分类文件夹若已存在会复用，同名文件会重命名后移动。
- 撤销依赖本地历史文件；删除或损坏
.desktop_organizer_history.json后无法凭 Skill 恢复更早的操作。 SKILL.md提到可通过「启动.bat」双击运行；当前 SkillHub 下载包内以desktop_organizer.py为主，若本地没有 bat，可直接用上面的python命令启动。
结尾¶
「小巧好用 一键整理桌面」把 对话触发 与 本地可视化整理 合在一起：Agent 负责识别意图，Python 程序负责扫描、预览、移动和撤销，不依赖 API Key。若要在本机启用，从 SkillHub 安装到对应 Agent 的 skills 目录即可。
官方地址：https://api.skillhub.cn/user_8cda13c6/desktop-file-sorter-ultra-77
SkillHub 展示页：https://www.skillhub.cn/skills/user_8cda13c6/desktop-file-sorter-ultra-77
