# 磁盘清理技能 - 所有代理的完整功能指南 ## 🚨 重要提示：表情符号使用政策 ### 用于脚本输出（跨平台安全） * **切勿在脚本输出中使用表情符号** \- 所有脚本均使用 ASCII 安全字符 * 脚本使用：`[OK]`、`[X]`、`[!]`、`[*]`、`[i]`、`[DIR]`、`[FILE]`、`[PKG]`、`[x]` * 这确保了与 Windows GBK 和其他非 UTF-8 控制台的兼容性 * **请勿修改脚本输出以添加表情符号** \- 这将破坏跨平台兼容性 ### 用于代理与人的通信（推荐） * **向人类报告结果时应使用表情符号** \- 使输出更具可读性 * 在给用户的最终报告中使用这些表情符号： * `✅`（成功）- 已完成操作，成功扫描 * `❌`（错误）- 操作失败、严重错误 * `⚠️` (Warning) - 警告，需要注意的问题 * `🔍`（扫描）- 搜索/扫描操作 * `📊` (统计) - 分析结果、统计 * `📁` (目录) - 目录相关信息 * `📦` (Package) - 包/模块信息 * `🎉`（成功）- 成功完成的庆祝消息 * `🚨`（严重）- 严重警告 *`💡`（提示）-建议、推荐 * `📋`（列表）- 检查表、摘要 * `🔧`（工具）- 工具、实用程序 * `🌐`（全球）- 跨平台、通用功能 * `🛡️`（安全）- 安全相关信息 * `⚡`（性能）- 性能改进 * `📝`（文档）- 文档 * `🎓`（学习）- 教育内容 * `📞`（支持）- 帮助、支持信息 * `📈`（成长）- 改进、收获 * `🎯`（目标）- 目标、目标 * `🚀`（启动）- 快速启动，快速运营 * `🛠️`（工具）- 工具相关功能 **示例：** 脚本输出 (ASCII)：[OK] 扫描完成：30 秒内扫描 50,000 个文件您向人类报告： ✅ 扫描成功完成！ 30 秒内找到 50,000 个文件 ** ** ## 📦 完整功能列表（请先阅读此内容！） ### 🚨 关键：逐行扫描（对于大磁盘强制） * ✅ **快速采样模式**：1 秒估计磁盘大小和扫描时间 * ✅ **渐进扫描模式** ：在 30 秒内获得大磁盘的部分结果 * ✅ **智能时间限制**：防止用户等待数小时 * ✅ **实时反馈**：进度每2秒更新一次 * ✅ **可中断** : Ctrl+C 获取部分结果 ### 🔧 智能引导程序（自动检测和导入） * ✅ **自动位置检测**：搜索 20 多个常用技能包位置 * ✅ **环境变量支持**：DISK_CLEANER_SKILL_PATH 覆盖 * ✅ **自动模块导入** ：自动导入diskcleaner模块 * ✅ **后备机制**：即使某些功能不可用也可以工作 * ✅ **跨平台 Python 检测**：尝试“python”和“python3” ### 🌐 通用兼容性 * ✅ **所有 AI IDE** ：Cursor、Windsurf、Continue、Aider、Claude Code 等。 * ✅ **所有平台**：Windows、macOS、Linux（包括 Windows GBK 控制台） * ✅ **所有安装级别**：全局、项目、用户级别 * ✅ **无需配置**：开箱即用 * ✅ **跨平台编码**：所有脚本都使用 ASCII 安全输出 (v2.0+) ### 🛡️ 安全可靠 * ✅ **诊断工具**：check_skill.py - 验证所有功能 * ✅ **安全编码**：所有脚本都使用 ASCII 字符（输出中没有表情符号） * ✅ **安全默认值**：--用于清洁的空运行，用于扫描的智能限制 * ✅ **受保护的路径**：永远不会删除系统目录或可执行文件 * ✅ **错误处理**：错误时优雅降级 * ✅ **GBK/UTF-8 兼容**：适用于 Windows GBK、UTF-8 和所有其他编码 ### ⚡ 性能优化（全部包含） * ✅ **QuickProfiler**：快速采样以估计扫描特征 * ✅ **ConcurrentScanner** ：多线程 I/O 可实现 3-5 倍加速 * ✅ **os.scandir() 优化**：比 Path.glob 快 3-5 倍 * ✅ **IncrementalCache** ：缓存扫描结果以加快重复扫描速度 * ✅ **内存监控**：根据可用内存自动适应 * ✅ **提前停止**：可配置的文件/时间限制 ### 📊 可用脚本（共 8 个） 1. **analyze_disk.py** \- 使用智能采样进行磁盘分析 2. **analyze_progressive.py** \-对大磁盘进行渐进式扫描 3. **clean_disk.py** \-安全垃圾文件清理 4. **monitor_disk.py** \-磁盘使用情况监控 5. **check_skill.py** \- 诊断工具 6. **skill_bootstrap.py** \-智能引导模块 7. **package_skill.py** \- 包创建工具 8. **scheduler.py** \-自动调度 ### 📚 文档（9 个文件） * SKILL.md - 完整指南 * AGENT_QUICK_REF.txt - 一页参考 * UNIVERSAL_INSTALL.md - 通用安装指南 * NO_PYTHON_GUIDE.md - 为没有 Python 的用户提供帮助 * PROGRESSIVE_SCAN_SUMMARY.md - 逐行扫描详细信息 * INSTALL.md - 详细安装 * FIXES.md - v2.0 中修复的内容 * README.txt - 快速入门 *references/temp_locations.md - 特定于平台的信息 ** ** ## 🎯 代理清单（必须遵循） ### 对于任何磁盘分析请求： [ ] 第 1 步：检查 Python 可用性 [ ] 第 2 步：查找技能包（自动检测 20 多个位置） [ ] 第 3 步：运行诊断：python script/check_skill.py [ ] 第 4 步：运行快速示例：--sample（强制 - 首先执行此操作） [ ] 第 5 步：根据估算选择扫描模式 [ ] 第 6 步：告知用户预计时间 [ ] 第 7 步：以适当的限制执行扫描 [ ] 第 8 步：显示结果并提供后续步骤 ### 对于任何清洁请求： [ ] 步骤 1-3：同上 [ ] 第 4 步：始终首先使用 --dry-run（强制） [ ] 第 5 步：显示预览结果 [ ] 第 6 步：在 --force 之前要求用户确认 [ ] 第 7 步：如果确认，则执行实际清洁 ** ** ## ⚡ 渐进扫描（对于大磁盘至关重要） ## 🚨 关键信息（首先阅读） ### 通用兼容性 * ✅ **适用于所有 AI IDE**：Cursor、Windsurf、Continue、Aider、Claude Code 等。 * ✅ **平台独立**：Windows、macOS、Linux * ✅ **与安装无关**：在全局、项目或用户级别工作 * ✅ **自包含**：没有外部依赖项，只需 Python 3.7+ ### 唯一的要求导入子流程结果 = subprocess.run(['python', '--version'], capture_output=True, text=True) # 如果成功，你就可以使用这个技能 ** ** ## ⚡ 渐进扫描（对于大磁盘至关重要） ### 🚨 代理必须用于大磁盘 (>100GB) **问题**：大磁盘（500GB+）上的完整磁盘扫描可能需要几个小时。用户将会失去耐心。 **解决方案**：使用逐行扫描 - 在几秒钟内获得结果，而不是几小时！ ### 📋 三种扫描模式 #### 模式 1：快速采样（⚡ 最快 - 1 秒） **何时使用**：即时估计目录大小和扫描时间 python 脚本/analyze_disk.py --sample # 或 python 脚本/analyze_progressive.py --sample **输出**： { “样本文件计数”：7591， “样本大小_GB”：17.62， “每秒文件数”：7501.0， “估计时间秒”：2.0 } **代理决策逻辑**： # 对于未知的磁盘大小，始终首先运行快速示例结果 = 子进程.run( ['python', 'scripts/analyze_disk.py', '--sample', '--json'], capture_output=真，文本=真，超时=10， cwd=技能路径）导入 json 样本 = json.loads(结果.stdout) 估计时间 = Sample.get('估计时间秒', 0) # 根据估计选择下一步行动如果预计时间 < 30： mode = 'full' # 完全扫描就可以了 elif 估计时间 < 120： mode = 'time_limited' # 使用时间限制其他： mode = 'progressive' # 必须使用渐进模式 #### 模式 2：逐行扫描（🎯 建议用于大磁盘） **何时使用** ：大磁盘 30 秒内获取部分结果 python 脚本/analyze_progressive.py --最大秒 30 **特点**： * ✅ 实时进度每2秒更新一次 * ✅ 显示发现的部分结果 * ✅ 可以用 Ctrl+C 中断并保留结果 * ✅ 智能文件数量限制（默认50,000） **代理使用**： defanalyze_large_disk_safely（路径，max_seconds = 30）： """安全分析大磁盘，有时间限制""" 结果 = 子进程.run( ['python', 'scripts/analyze_progressive.py', '--最大秒'，str（最大秒）， '--路径', str(路径)], capture_output=真，文本=真，超时=最大秒数+10， cwd=技能路径）返回结果.stdout #### 模式 3：有限扫描（📊 快速结果） **何时使用** ：在文件/时间限制下快速获取结果 # 按文件数限制（快速） python 脚本/analyze_disk.py --文件限制 10000 # 受时间限制（安全） python 脚本/analyze_disk.py --时间限制 30 # 两个限制（非常快） python 脚本/analyze_disk.py --文件限制 10000 --时间限制 30 ### 🎯 代理决策树（重要 - 按照此操作）用户请求：“分析我的磁盘” ↓ ┌──────────────────────────────────────────┐ │ 第 1 步：快速样品（强制） │ │ python 脚本/analyze_disk.py --sample │ └──────────────────────────────────────────┘ ↓ 从样本中获取estimated_time ↓ ├─预计时间 < 30 秒 │ ↓ │ ✅ 使用全扫描 │ python 脚本/analyze_disk.py │ ├─预计时间30-120秒 │ ↓ │ ⚠️ 使用时间限制 │ python 脚本/analyze_disk.py --时间限制 60 │ 告诉用户：“这将需要〜X分钟” │ └─预计时间 > 120 秒 ↓ 🚨 必须使用渐进模式 python 脚本/analyze_progressive.py --最大秒 30 告诉用户：“检测到大磁盘 - 使用逐行扫描（30 秒）” ### 📝 所需的响应模板 #### 当快速示例显示 < 30 秒时 ✅ 磁盘分析大约需要 2 秒开始全面扫描... #### 当快速示例显示 30-120 秒时 ⚠️磁盘分析大约需要 3 分钟使用限时扫描以获得更快的结果... #### 当快速示例显示 > 120 秒时 🚨 检测到大磁盘！完整扫描大约需要 5 分钟使用逐行扫描模式可在 30 秒内获得结果... （这可以快速为您提供部分结果 - 您随时可以稍后进行完整扫描） ### 💡 复制粘贴代码（使用此）导入子流程导入 json 从 pathlib 导入路径 def smart_disk_analysis(disk_path, python_cmd='python'): ”“” SMART 磁盘分析 - 自动选择最佳方法这是向所有代理商推荐的方式 ”“” # 查找技能包 Skill_path = find_skill_package() # 使用你的查找函数如果不是技能路径： return False,“未找到技能包” # 第 1 步：快速示例（强制 - 首先执行此操作！） print("🔍快速采样盘...") 样本结果 = subprocess.run( [python_cmd, 'scripts/analyze_disk.py', '--sample', '--path', str(disk_path), '--json'], capture_output=真，文本=真，超时=10， cwd=str(技能路径) ）如果sample_result.returncode！= 0：返回 False，“样本失败” 尝试：样本 = json.loads(sample_result.stdout) 估计时间 = Sample.get('估计时间秒', 0) 除外：预计时间 = 0 print(f" 预计扫描时间：{estimated_time:.0f} 秒") # 第2步：根据估算选择扫描方法如果预计时间 < 30： # 小磁盘-全盘扫描 print("✅ 使用全扫描（小磁盘）") 结果 = 子进程.run( [python_cmd，'脚本/analyze_disk.py'， '--path', str(磁盘路径)], capture_output=真，文本=真，超时=60， cwd=str(技能路径) ） elif 估计时间 < 120： # 中盘 - 限时分钟 = 预计时间 / 60 print(f"⚠️使用限时扫描(~{分钟:.1f}分钟)") 结果 = 子进程.run( [python_cmd，'脚本/analyze_disk.py'， '--path', str(磁盘路径), '--time-limit', '60'], # 最多 1 分钟 capture_output=真，文本=真，超时=70， cwd=str(技能路径) ）其他： # 大磁盘 - 渐进模式（强制） print(f"🚨 检测到大磁盘！使用逐行扫描（30 秒）") 结果 = 子进程.run( [python_cmd，'脚本/analyze_progressive.py'， '--path', str(磁盘路径), '--最大秒', '30', '--json'], capture_output=真，文本=真，超时=40， cwd=str(技能路径) ）如果结果.returncode != 0: 返回 False，结果.stderr 打印（结果.stdout）返回 True，结果.stdout # 用法 - 只需调用此函数：成功，输出 = smart_disk_analysis("C:\\") 成功，输出 = smart_disk_analysis("/home/user") 成功，输出 = smart_disk_analysis("D:\\Projects") ### ⚠️ 要避免的常见错误 ❌ **不要** ：始终运行完整扫描而不先检查磁盘大小 ✅ **做** ：始终首先运行 `--sample` 进行估计 ❌ **不要**：让用户等待数小时进行大型磁盘扫描 ✅ **做**：对大型磁盘使用 `--max-seconds 30` ❌ **不要**：忽略样本的估计时间 ✅ **做**：使用估计来选择适当的扫描模式 ❌ **不要**：在 1TB 磁盘上无限制地运行analyze_disk.py ✅ **做**：使用带有 --max-seconds 的analyze_progressive.py ### 📊 命令参考卡情况|命令 |时间 |结果 ---|---|---|--- 尺寸未知 | `--样本` | 1秒|预估+推荐 < 30 秒 | `analyze_disk.py` | <30秒|完整结果 30-120 秒 | `--时间限制 60` | 60 年代 |大多数结果 > 120 秒 | `analyze_progressive.py --最大秒 30` | 30 多岁 |部分结果非常大的磁盘| `analyze_progressive.py --最大秒 60` | 60 年代 |更多结果 ### 🔍 逐行扫描的工作原理 1. **快速示例（1 秒）** * 1秒内扫描尽可能多的文件 * 计算扫描速率（文件/秒） * 估计总扫描时间 * 提供即时反馈 2. **逐行扫描（N秒）** * 连续扫描N秒 * 每2秒显示一次进度 * 实时收集结果 * 时间到时返回找到的任何内容 * 用户可以中断并保留部分结果 3. **智能停车** * 当达到时间/文件限制时自动停止 * 优雅地处理中断 * 部分结果仍然有用 ### 🎯 代理商最佳实践 1. **始终** 首先运行 `--sample` 2. **始终**在选择模式之前检查estimated_time 3. **始终** 告知用户预期的扫描时间 4. **始终**对大磁盘使用渐进模式（>2 分钟） 5. **永远不要**让用户等待超过 2 分钟而没有反馈 ** ** ** ** ## 🎯 通用代理工作流程此工作流程适用于任何平台、任何 AI IDE、任何位置。 ### 第 1 步：验证 Python 导入子流程导入系统 def verify_python(): """检查 Python 3.7+ 是否可用 - 与平台无关""" 尝试： # 首先尝试“python”（Windows，某些 Unix）结果 = 子进程.run( ['python', '--版本'], capture_output=真，文本=真，超时=5 ）如果结果.returncode == 0: 返回 True、result.stderr.strip() 或 result.stdout.strip() 除了文件未找到错误：通过尝试： # 尝试“python3”（macOS、Linux）结果 = 子进程.run( ['python3', '--版本'], capture_output=真，文本=真，超时=5 ）如果结果.returncode == 0: 返回 True、result.stderr.strip() 或 result.stdout.strip() 除了文件未找到错误：通过返回 False，“未找到 Python” # 执行 python_available, version_info = verify_python() 如果没有 python_available: print("❌ 需要 Python 3.7+ 但未找到") print("安装自：https://www.python.org/downloads/") print("请参阅：NO_PYTHON_GUIDE.md 了解特定于平台的说明") 系统退出(1) print(f"✅ Python 可用：{version_info}") ### 第 2 步：找到技能包从 pathlib 导入路径导入操作系统 def find_skill_package(): ”“” 查找磁盘清理技能包 - 位置独立按优先级顺序搜索： 1.当前工作目录 2. 项目级：./skills/、./.skills/、./agent-skills/ 3.用户级：~/.skills/、~/.agent-skills/、~/skill-packages/ 4. 常见的AI IDE位置 5. 父目录 ”“” # 获取 python 命令（python 或 python3） python_cmd = 'python' 如果 os.name == 'nt' else 'python3' # 搜索位置 - 与平台和 IDE 无关搜索位置 = [] # 1.当前目录 cwd = 路径.cwd() 搜索位置.extend([ cwd / '磁盘清理器', cwd / '技能' / '磁盘清理器', cwd / '.skills' / '磁盘清理器', cwd / '代理技能' / '磁盘清理器', cwd / '.agent-skills' / '磁盘清理器', ]） # 2. 父目录（项目根目录）对于 [cwd, *cwd.parents] 中的父级：搜索位置.extend([ 父/'技能'/'磁盘清理器'，父级 / '.skills' / '磁盘清理器', 父/'代理技能'/'磁盘清理器'， ]） # 限制搜索深度如果 len(parent.parts) <= 3: 打破 # 3.用户主目录 home = Path.home() 搜索位置.extend([ home / '技能' / '磁盘清理程序', home / '.skills' / '磁盘清理器', home / '代理技能' / '磁盘清理器', home / '.agent-skills' / '磁盘清理器', home / '技能包' / '磁盘清理器', ]） # 4. 特定于平台的用户目录 if os.name == 'nt': # Windows appdata = os.environ.get('APPDATA', '') 如果应用程序数据： search_locations.append(Path(appdata) / '技能' / '磁盘清理器') localappdata = os.environ.get('LOCALAPPDATA', '') 如果本地应用程序数据： search_locations.append(Path(localappdata) / '技能' / '磁盘清理器') else: # 类 Unix（macOS、Linux）搜索位置.extend([ home / '.local' / '分享' / '技能' / '磁盘清理器', home / '.config' / '技能' / '磁盘清理器', 路径('/usr/local/share/skills/disk-cleaner'), ]） # 5. AI IDE 特定目录（IDE-AGNOSTIC） # 注意：这些只是示例 - 实际位置有所不同 ide_特定 = [ # 光标 home / '.cursor' / '技能' / '磁盘清理器', home / '.cursor' / '用户' / '技能' / '磁盘清理器', # 风帆冲浪 home / '.windsurf' / '技能' / '磁盘清理器', # 继续 home / '.continue' / '技能' / '磁盘清理器', # 通用 home / '.ai-ide' / '技能' / '磁盘清理器', ] search_locations.extend(ide_specific) # 6. sys.path 条目（Python 模块样式）对于 sys.path 中的 path_entry：如果 path_entry 和 path_entry 不在 ['', '.'] 中： test_path = Path(path_entry) / '磁盘清理器' search_locations.append（测试路径） # 删除重复的和不存在的搜索位置 = 列表（设置（搜索位置）） # 搜索有效的技能包对于 search_locations 中的位置：如果不是位置：继续尝试： # 检查关键指标文件 if (location / 'scripts' / 'analyze_disk.py').exists(): 返回位置，f“发现于：{location}” if (location / 'SKILL.md').exists(): 返回位置，f“发现于：{location}” 除了权限错误：继续除了例外：继续 # 未找到 - 提供有用的消息 print("❌未找到技能包") print("\n搜索到的位置:") for loc in search_locations[:10]: # 显示前 10 个打印（f“ - {loc}”） print("\n解决方案:") print("1.将技能包解压到上述位置之一") print("2.或者设置环境变量：DISK_CLEANER_SKILL_PATH") print("3.或者在调用函数时提供显式路径") 返回无，“未找到” # 执行技能路径，消息 = find_skill_package() 如果不是技能路径：打印（消息）系统退出(1) print(f"✅ {消息}") ### 第 3 步：验证技能包 def verify_skill_package(skill_path, python_cmd='python'): """验证技能包完整性 - 位置独立""" check_script = Skill_path / '脚本' / 'check_skill.py' 如果没有 check_script.exists(): print(f"❌未找到检查脚本: {check_script}") 返回错误尝试：结果 = 子进程.run( [python_cmd，str（检查脚本）]， capture_output=真，文本=真，超时=30， cwd=str(技能路径) ） # 显示验证输出如果结果.stdout：打印（结果.stdout）如果结果.returncode == 0: print("✅技能包验证成功") 返回真其他： print("❌技能包验证失败") 如果结果.stderr：打印（结果.stderr）返回错误除了 subprocess.TimeoutExpired： print("❌验证超时") 返回错误除了异常 e： print(f"❌验证错误：{e}") 返回错误 # 确定python命令 python_cmd = 'python' 如果 os.name == 'nt' else 'python3' # 执行如果不是 verify_skill_package(skill_path, python_cmd): 系统退出(1) ### 第 4 步：执行操作 defexecute_operation(skill_path, 操作, python_cmd='python', **kwargs): ”“” 执行磁盘清理操作 - 与平台和 IDE 无关参数： Skill_path：技能包路径操作：“分析”、“清理”、“监控” python_cmd：“python”或“python3” **kwargs：特定于操作的参数 ”“” 操作图 = { '分析': 'analyze_disk.py', '干净': 'clean_disk.py', '监视器'：'monitor_disk.py'， } 如果操作不在操作映射中： print(f"❌未知操作：{操作}") print(f"有效操作：{list(operation_map.keys())}") 返回假，无 script = Skill_path / '脚本' / operation_map[操作] cmd = [python_cmd, str(脚本)] # 添加特定于操作的参数 if 操作 == '分析': 如果 kwargs.get('路径'): cmd.extend(['--path', str(kwargs['path'])]) 如果 kwargs.get('top'): cmd.extend(['--top', str(kwargs['top'])]) 如果 kwargs.get('json'): cmd.append('--json') elif 操作=='干净'： # 始终使用空运行以确保安全如果不是 kwargs.get('force'): cmd.append('--dry-run') 其他： cmd.append('--force') 如果 kwargs.get('temp'): cmd.append('--temp') if kwargs.get('缓存'): cmd.append('--缓存') 如果 kwargs.get('logs'): cmd.append('--日志') elif操作=='监视器'：如果 kwargs.get('手表'): cmd.append('--watch') 如果 kwargs.get('json'): cmd.append('--json') 尝试： print(f"🔧 执行: {' '.join(cmd)}") 结果 = 子进程.run( 命令， capture_output=真，文本=真，超时=kwargs.get('超时', 300), cwd=str(技能路径) ） # 显示输出如果结果.stdout：打印（结果.stdout）如果结果.returncode != 0: 如果结果.stderr： print(f"❌错误: {result.stderr}") 返回假，无返回 True，结果.stdout 除了 subprocess.TimeoutExpired： print("⚠️操作超时") 返回假，无除了异常 e： print(f"❌执行错误: {e}") 返回假，无 # 执行成功，输出=执行操作（技能路径，操作='分析', python_cmd=python_cmd, path='C:\\Users' if os.name == 'nt' else '/home', json=真）如果成功： print("✅ 操作成功完成") ** ** ## 📋 快速参考（所有 IDE） ### ⚠️ 重要：对大磁盘使用渐进式扫描！ **在进行任何磁盘分析之前**： 1. 首先运行 `--sample` 来估计扫描时间 2. 如果预计时间 > 2 分钟，则使用渐进模式 3.永远不要让用户等待超过2分钟而没有反馈 **快速参考**： # 第 1 步：始终首先执行此操作（1 秒） python 脚本/analyze_disk.py --sample # 第 2 步：根据估计进行选择 # < 30s: python script/analyze_disk.py # 30-120s: python script/analyze_disk.py --time-limit 60 # > 120s: python script/analyze_progressive.py --max-seconds 30 ### 用户意图→操作映射 ### 用户意图→操作映射用户说 |运营|命令模板 ---|---|--- “分析磁盘”|分析| `python 脚本/analyze_disk.py` “检查磁盘空间”|分析| `python 脚本/analyze_disk.py --top 50` “快速扫描”|分析| `python 脚本/analyze_disk.py --sample` 「大盘分析」|分析| `python 脚本/analyze_progressive.py --最大秒 30` “清理临时文件”|干净| `python 脚本/clean_disk.py --temp --dry-run` “预览清理”|干净| `python 脚本/clean_disk.py --dry-run` “监控磁盘”|监控| `python 脚本/monitor_disk.py` “磁盘使用情况” |监控| `python 脚本/monitor_disk.py --json` ### 逐行扫描（对于大磁盘） **问题**：在大磁盘 (1TB+) 上进行完整磁盘扫描可能需要数小时 **解决方案**：使用带有时间/文件限制的逐行扫描 # 快速示例（1 秒）- 获得即时估计 subprocess.run(['python', 'scripts/analyze_disk.py', '--sample']) # 逐行扫描（30 秒）- 快速获得部分结果 subprocess.run(['python', 'scripts/analyze_progressive.py', '--最大秒', '30']) # 有限的文件数量（快） subprocess.run(['python', 'scripts/analyze_disk.py', '--文件限制', '10000']) # 有时间限制的全扫描 subprocess.run(['python', 'scripts/analyze_disk.py', '--时间限制', '120']) **大磁盘的推荐工作流程**： 1. 首先，运行 `--sample` 来获得估计值（1秒） 2. 如果估计太长，请使用 `--max-seconds` 或 `--file-limit` 3.或者使用`analyze_progressive.py`进行实时反馈 ### 跨平台 Python 命令平台| Python 命令 |检查命令 ---|---|--- 窗户| `蟒蛇` | `python --版本` macOS | `python3` | `python3 --版本` Linux | `python3` | `python3 --版本` ### 通用命令模板 # 适用于所有平台导入操作系统导入子流程 python_cmd = 'python' 如果 os.name == 'nt' else 'python3' 结果 = subprocess.run([python_cmd, '--version'], capture_output=True, text=True) ** ** ## 🌐 多 IDE 兼容性该技能包适用于所有支持以下功能的 AI IDE： ### 支持的 AI IDE * ✅ **光标** \- 作为项目或用户级技能 * ✅ **风帆冲浪** \- 可在任何地点使用 * ✅ **继续** \- 作为全局或项目技能 * ✅ **Aider** \- 作为代理工具 * ✅ **Claude Code** \- 作为技能 * ✅ **任何 AI IDE** \- 通过子进程工作 ### 按 IDE 类型安装 #### 项目级安装你的项目/ ├── 技能/ │ └── 磁盘清理器/ ← 在此提取 ├── src/ └── 自述文件.md #### 用户级安装 ~/.skills/disk-cleaner/ ← 类 Unix ~/agent-skills/disk-cleaner/ ← 替代方案 C:\Users\You\skills\disk-cleaner\ ← Windows #### 全局安装 /usr/local/share/skills/disk-cleaner/ ← Linux（系统范围） C:\ProgramData\skills\disk-cleaner\ ← Windows（系统范围） ** ** ## 🔧 IDE 特定注释 ### 光标 # 光标自动搜索技能： # - .cursor/技能/ # - 项目/技能/ # - ~/.skills/ # 无需特殊配置 ### 风帆冲浪 # 风帆冲浪支持技能： # - .windsurf/技能/ # - 项目/技能/ # 技能通过子进程起作用，无需特殊设置 ### 继续 # 继续配置（如果需要）：＃{ # "技能": ["./skills/disk-cleaner"] # } # 但自动检测在大多数情况下都有效 ### 助手 # 通过子进程用作工具： # !python 技能/disk-cleaner/scripts/analyze_disk.py ### 通用/其他 IDE # 该技能包含智能自动检测 # 只需提取并使用 - 无需配置 ** ** ## 🎯 完整的复制粘贴模板 ”“” 万能磁盘清理器技能使用可在任何位置、所有平台上与所有 AI IDE 配合使用 ”“” 导入子流程导入系统导入操作系统从 pathlib 导入路径 def use_disk_cleaner(操作='分析', **kwargs): ”“” 使用磁盘清理技巧 - 通用功能适用于： - 所有平台（Windows、macOS、Linux） - 所有 AI IDE（Cursor、Windsurf、Continue 等） - 所有安装级别（全局、项目、用户）参数：操作：“分析”、“清理”、“监控” **kwargs：特定于操作的参数返回：（成功：bool，输出：str） ”“” # 1. 确定Python命令 python_cmd = 'python' 如果 os.name == 'nt' else 'python3' # 2. 验证Python 尝试：结果 = 子进程.run( [python_cmd, '--版本'], capture_output=真，文本=真，超时=5 ）如果结果.returncode != 0: print("❌ 未找到 Python") 返回 False，“需要 Python 3.7+” 除了异常 e： print(f"❌ Python 检查失败: {e}") 返回 False，str(e) # 3.查找技能包（智能搜索） def find_skill(): 搜索路径 = [ # 当前目录 Path.cwd() / '磁盘清理器', Path.cwd() / '技能' / '磁盘清理器', Path.cwd() / '.skills' / '磁盘清理器', # 项目根目录 *[(p / '技能' / '磁盘清理器') for p in [Path.cwd(), *Path.cwd().parents][:3]], # 用户主页 Path.home() / '技能' / '磁盘清理器', Path.home() / '.skills' / '磁盘清理器', ] 对于 search_paths 中的路径： if (path/'scripts'/'analyze_disk.py').exists(): 返回路径返回无技能路径 = find_skill() 如果不是技能路径： print("❌未找到技能包") print("提取到：skills/disk-cleaner/ 或 ~/.skills/disk-cleaner/") return False,“未找到技能包” # 4.执行操作脚本={ '分析': 'analyze_disk.py', '干净': 'clean_disk.py', '监视器'：'monitor_disk.py'， } 如果操作不在脚本中： return False, f"未知操作：{操作}" script = Skill_path / '脚本' / 脚本[操作] cmd = [python_cmd, str(脚本)] # 添加参数 if 操作 == '分析': 如果 kwargs.get('路径'): cmd.extend(['--path', str(kwargs['path'])]) elif 操作=='干净'： cmd.append('--dry-run') # 始终安全 elif操作=='监视器'：如果 kwargs.get('json'): cmd.append('--json') # 运行尝试：结果 = 子进程.run( 命令， capture_output=真，文本=真，超时=300， cwd=str(技能路径) ）返回结果.returncode == 0, 结果.stdout 除了异常 e：返回 False，str(e) # 使用示例： # 成功，输出 = use_disk_cleaner('analyze', path='.') # 成功，输出 = use_disk_cleaner('clean') # 成功，输出 = use_disk_cleaner('monitor', json=True) 如果 __name__ == "__main__": # 快速测试成功，输出 = use_disk_cleaner('analyze') 打印（输出） ** ** ## ⚡ 渐进式扫描清单（重要） ### 代理必须针对所有磁盘分析请求遵循此规则： [ ] 您是否先运行 --sample 来估计扫描时间？ [ ] 您是否告知用户预期的扫描时间？ [ ] 您是否根据估算选择了合适的模式？ [ ] 您是否使用渐进模式进行超过 2 分钟的估计？ [ ] 您在长时间扫描期间提供反馈吗？ ### 磁盘大小所需的行为： **小磁盘（估计 < 30 秒）**： * ✅ 运行全面扫描 * ✅ 无需特殊处理 **中盘（预计 30-120 秒）**： * ✅ 使用--time-limit * ✅ 告知用户预计时间 * ⚠️ 如果用户看起来不耐烦，请考虑渐进模式 **大磁盘（预计 > 120 秒）**： * 🚨 必须使用渐进模式 * 🚨 必须告知用户时间限制 * ✅ 解释部分结果 * ✅ 提供完整扫描选项 ### 所需的代码模式： # 这是所有磁盘分析所需的模式： def safe_disk_analysis(disk_path): # 第 1 步：始终先采样样本=子进程.运行( ['python', 'scripts/analyze_disk.py', '--sample', '--json'], capture_output=真，文本=真， cwd=技能路径）导入 json 数据 = json.loads(样本.stdout) 估计 = data.get('估计时间秒', 0) # 第 2 步：通知用户如果估计 > 120： print(f"检测到大磁盘！估计：{estimate/60:.1f} 分钟") print("使用逐行扫描（30 秒）快速获得结果...") # 第三步：选择模式如果估计 < 30： # 全扫描返回 subprocess.run(['python', 'scripts/analyze_disk.py']) elif 估计 < 120： # 时间有限 return subprocess.run(['python', 'scripts/analyze_disk.py', '--time-limit', '60']) 其他： # 渐进式（大磁盘强制）返回 subprocess.run(['python', 'scripts/analyze_progressive.py', '--max-seconds', '30']) ** ** ## 🚨 错误处理（通用） ### 错误：未找到 Python # 解决方案 - 独立于平台的指导进口平台系统=平台.系统() 如果系统==“Windows”： print("安装自：https://www.python.org/downloads/") print("安装时勾选'将Python添加到PATH'") elif 系统 == "Darwin": # macOS print("安装：brew install python@3.11") print("或者：https://www.python.org/downloads/macos/") 其他：#Linux print("安装：sudo apt install python3 # Debian/Ubuntu") print("或者: sudo dnf install python3 # Fedora") ### 错误：找不到技能 # 解决方案 - 显示所有搜索到的位置 print("未找到技能包。") print("提取到这些位置之一：") 打印（“ - ./技能/磁盘清理器/”）打印（“ - ./磁盘清理器/”）打印（“ - ~/.skills/disk-cleaner/”） print(" - 项目/技能/磁盘清理器/") print("\n或设置：DISK_CLEANER_SKILL_PATH=/path/to/skill") ### 错误：权限被拒绝 # 解决方案 - 特定于平台的建议如果 os.name == 'nt': print("如果需要，请以管理员身份运行") 其他： print("某些目录可能需要：sudo") print("或者调整：chmod +x script/*.py") ** ** ## 📝 环境变量（可选）您可以选择设置这些以帮助自动检测： # 设置技能包位置（覆盖自动检测）导出 DISK_CLEANER_SKILL_PATH=/path/to/skills/disk-cleaner # 设置 Python 命令（覆盖自动检测）导出 DISK_CLEANER_PYTHON_CMD=python3 # 启用调试输出导出 DISK_CLEANER_DEBUG=true ** ** ## 🎓 所有代理的最佳实践 1. **始终首先检查 Python** \- 不要假设它已安装 2. **在 Unix 上使用“python3”** \- 在 Windows 上使用“python” 3. **搜索多个位置** \- 不要假设单个安装路径 4. **使用带超时的子进程** \-防止挂起 5. **同时捕获stdout和stderr** \-完整的错误信息 6. **更喜欢 --dry-run for clean** \- 安全第一 7. **处理所有异常** \- 优雅降级 8. **显示有用的错误消息** \- 引导用户找到解决方案 ** ** ## 🔍 故障排除（通用） ### 问题：技能在一种 IDE 中有效，但在另一种 IDE 中无效 **解决方案**：该技能与 IDE 无关。检查： 1. 可从该 IDE 访问 Python 2.技能包在可搜索的位置 3.文件权限允许执行 ### 问题：不同平台上的行为不同 **解决方案**：该技能处理平台差异。检查： 1.Python命令（`python` vs `python3`） 2. 路径分隔符（由pathlib自动处理） 3.文件权限（Unix可能需要`chmod +x`） ### 问题：找不到技能包 **解决方案**：运行诊断： python 技能/磁盘清理器/scripts/check_skill.py # 或者 python3技能/磁盘清理器/scripts/check_skill.py ** ** ## 📦 包装内容（通用）磁盘清理器/ ├── SKILL.md # 这个文件 ├── AGENT_QUICK_REF.txt # 快速参考 ├── NO_PYTHON_GUIDE.md # 为没有Python的用户提供帮助 ├── INSTALL.md # 安装指南 ├── FIXES.md # v2.0 修复了什么 ├──scripts/ # 所有脚本（通用） ├── diskcleaner/ # 核心模块（独立） └──references/ # 平台信息 ** ** ## ✅ 通用清单在任何 AI IDE 中使用此技能之前： *已安装Python 3.7+ * 技能包提取到可访问的位置 * 可以运行：`python --version`（或`python3 --version`） * 已知技能包位置（或让它自动检测） ** ** **此技能包适用于任何地方 - 只需要 Python 3.7+！** 无需特定于 IDE 的配置。没有特定于平台的设置。无安装级别限制。只需提取并使用即可！

磁盘清理器

包含技能