TidyMyDesktop - 智能桌面整理工具

概述

当用户请求整理桌面或目录时，此 skill 会自动：

• 分析目录中的文件和应用程序

• 智能分类并创建文件夹

• 识别和删除软件的旧版本

• 搜索未知软件的用途

• 生成详细的整理报告（Markdown格式）

支持的触发指令

用户可以通过以下方式触发此 skill：

• "帮我整理桌面" - 整理 ~/Desktop

• "帮我整理当前目录" - 整理当前工作目录（需要用户确认）

• 任何关键词 - 首先搜索相关内容

工作流程

步骤 1: 理解用户意图

首先判断用户输入的类型：

// 检查是否是整理指令 if (用户输入包含 "整理桌面") { 目标路径 = ~/Desktop } else if (用户输入包含 "整理当前目录") { // 需要用户确认目录路径 await askUserToConfirmPath() } else { // 如果是关键词，先搜索相关内容 await searchKeyword(用户输入) return }

步骤 2: 扫描和分析目录

使用提供的 Node.js 工具脚本扫描目标目录：

扫描目录并生成文件清单

node ~/.claude/skills/tidymydesktop/scripts/scan.js <目标路径>

该脚本会：

• 列出所有文件和应用程序

• 识别文件类型和扩展名

• 检测应用程序版本号

• 生成初始清单

步骤 3: 智能分类和整理

执行整理操作时，遵循以下原则：

3.1 文件分类规则

根据文件类型创建分类文件夹：

应用程序 (Applications/ )

• 开发工具 (Development/ )

• 办公软件 (Office/ )

• 设计工具 (Design/ )

• 通讯工具 (Communication/ )

• 娱乐软件 (Entertainment/ )

• 系统工具 (Utilities/ )

文档 (Documents/ )

• PDF文档 (PDFs/ )

• Word文档 (Word/ )

• Excel表格 (Excel/ )

• 文本文件 (TextFiles/ )

图片 (Images/ )

• 照片 (Photos/ )

• 截图 (Screenshots/ )

• 设计稿 (Designs/ )

视频 (Videos/ )

音频 (Audio/ )

压缩包 (Archives/ )

代码项目 (CodeProjects/ )

未分类 (Uncategorized/ )

3.2 版本去重规则

对于同一软件的多个版本：

// 识别版本号模式 // 例如: "AppName v1.2.3.dmg" 和 "AppName v2.0.0.dmg" // 保留: 最新版本 // 删除: 旧版本

function identifyVersions(files) { // 1. 提取版本号 // 2. 比较版本 // 3. 标记要删除的旧版本 }

CRITICAL: 在删除任何文件前，必须：

• 向用户展示将被删除的文件列表

• 等待用户确认

• 获得明确同意后才执行删除操作

3.3 未知软件处理

当遇到不确定用途的软件时：

使用 WebSearch 搜索软件信息

搜索查询格式: "<软件名称> 是什么软件 用途"

如果搜索后仍不确定：

• 将其放入 未分类/ 文件夹

• 在报告中标注为"需要人工审核"

步骤 4: 执行整理操作

使用提供的整理脚本：

执行整理操作

node ~/.claude/skills/tidymydesktop/scripts/organize.js
--source <目标路径>
--plan <整理计划JSON文件>
--dry-run # 首次运行使用 dry-run 模式

重要安全措施：

• 首次运行使用 --dry-run 模式（仅模拟，不实际移动文件）

• 向用户展示整理计划

• 获得用户确认后，再执行实际操作

• 所有删除操作都需要用户明确确认

步骤 5: 生成整理报告

创建详细的 Markdown 报告，包含：

桌面整理报告

整理时间: YYYY-MM-DD HH:MM:SS 整理路径: /Users/xxx/Desktop

整理概要

• 总文件数: XXX
• 已分类文件: XXX
• 创建的文件夹: XXX
• 删除的重复文件: XXX
• 未分类文件: XXX

分类详情

应用程序 (XX 个)

• 开发工具 (XX 个)
  • Visual Studio Code
  • IntelliJ IDEA
  • ...

文档 (XX 个)

• PDF文档 (XX 个)
• ...

版本去重记录

未知软件

建议

• [可选] 进一步整理建议
• [可选] 可能需要手动审核的项目

报告保存位置：

• 桌面整理: ~/Desktop/整理报告_YYYYMMDD_HHMMSS.md

• 目录整理: <目标路径>/整理报告_YYYYMMDD_HHMMSS.md

工具脚本使用说明

scan.js - 目录扫描工具

扫描目录并生成文件清单：

node ~/.claude/skills/tidymydesktop/scripts/scan.js <目标路径>

输出 JSON 格式的文件清单。

organize.js - 整理执行工具

根据整理计划执行文件移动和删除操作：

Dry-run 模式（推荐首次使用）

node ~/.claude/skills/tidymydesktop/scripts/organize.js
--source <目标路径>
--plan <整理计划.json>
--dry-run

实际执行

node ~/.claude/skills/tidymydesktop/scripts/organize.js
--source <目标路径>
--plan <整理计划.json>

classify.js - 智能分类工具

使用 AI 辅助分类未知文件：

node ~/.claude/skills/tidymydesktop/scripts/classify.js
--file <文件路径>
--search # 启用网络搜索

使用示例

示例 1: 整理桌面

用户: "帮我整理桌面"

Claude 执行流程:

• 识别触发词 "整理桌面"

• 设置目标路径为 ~/Desktop

• 运行扫描工具

• 生成分类计划

• 以 dry-run 模式预览整理结果

• 向用户展示整理计划

• 等待用户确认

• 执行实际整理操作

• 生成并保存整理报告

• 向用户展示报告摘要

示例 2: 整理当前目录

用户: "帮我整理当前目录"

Claude:

"我将整理当前目录。请确认目标路径：/Users/xxx/Downloads

是否继续？(yes/no)"

用户: "yes"

Claude 执行流程: （与示例 1 相同的流程）

示例 3: 关键词搜索

用户: "VS Code"

Claude 执行流程:

• 识别为关键词（非整理指令）

• 使用 WebSearch 搜索 "VS Code"

• 返回搜索结果

• 不执行整理操作

安全注意事项

• 永远不要自动删除文件 - 所有删除操作必须经过用户明确确认

• 使用 dry-run 模式 - 首次整理时始终使用模拟模式

• 备份提醒 - 在执行重要操作前提醒用户备份

• 路径确认 - 整理目录时必须让用户确认路径

• 版本识别准确性 - 版本号识别可能不准确，标记为"待确认"

依赖项

Node.js 包（通过 nvm 管理）：

• fs-extra

• 文件系统操作

• glob

• 文件匹配

• semver

• 版本号比较

• commander

• 命令行参数解析

安装依赖：

使用 nvm 切换到合适的 Node 版本

nvm use 18

安装依赖

cd ~/.claude/skills/tidymydesktop npm install

限制和注意事项

macOS 特定功能：

• .app 应用程序包识别

• Finder 标签和颜色（暂不支持）

不支持的操作：

• 移动系统文件

• 整理受保护的目录

• 修改文件内容

性能考虑：

• 大型目录（>1000个文件）可能需要较长时间

• 网络搜索会增加处理时间

故障排除

脚本执行失败

检查 Node.js 版本

node --version # 应该 >= 14.0.0

检查依赖安装

cd ~/.claude/skills/tidymydesktop npm list

权限错误

某些目录可能需要额外权限。如果遇到权限问题：

• 检查目标目录的读写权限

• 避免整理系统目录

• 使用用户目录（如 ~/Desktop, ~/Downloads）

开发和扩展

要添加新的文件分类规则，编辑 scripts/classify.js ：

const CATEGORY_RULES = { // 添加新的分类规则 'NewCategory': { extensions: ['.ext1', '.ext2'], keywords: ['keyword1', 'keyword2'], subfolder: 'NewCategory' } }

版本: 1.0.0 作者: Claude AI 许可: MIT