Qclaw Computer Cleanup

The Core Problem It Solves

Modern operating systems and frequently used software, particularly development tools and social applications, accumulate substantial amounts of cache, temporary files, and unused images locally, gradually consuming disk space. Manually cleaning these scattered directories is tedious and error-prone, risking the deletion of critical files that cause software malfunctions. For developers and IT ops personnel using the qclaw platform, there is a need for an automated cleaning solution that offers precise identification, safe classification, and adaptation to text-based interaction.

Working Mechanism and Core Capabilities

Built on Python's standard library, this skill implements an intelligent, cross-platform (Windows/macOS/Linux) cleaning process. Its core logic is safety-tiered and confirmation-driven:

• Safe Cleanup Items: Executed directly without user intervention. Covers routine system temporary files, the recycle bin/trash, caches from mainstream social apps (e.g., WeChat, QQ) and browsers (Chrome, Edge, etc.), as well as installation caches for development tools like pip and conda.
• Sensitive Cleanup Items: Require forced secondary text confirmation. This applies to operations that might delete user-downloaded content or environment configurations, such as cleaning up unused Docker images and volumes, macOS-specific Xcode simulator and build caches, Homebrew old version packages, and temporary large files on the desktop (installers, compressed packages, etc.).
• Key Execution Steps:
  1. Receives a command like "Clean up computer junk", "Deep clean computer", or a specific directive (e.g., "Clean Docker").
  2. Automatically adapts file paths based on the current operating system and executes the corresponding cleanup tasks.
  3. For sensitive items, prompts the user via text to input "confirm" or "cancel".
  4. Calculates and reports the total space freed in real-time.

Applicable Scope and Important Notes

• Tool Dependencies: Before cleaning Docker, Xcode, or Homebrew caches, ensure these tools are installed and functional (Docker must be running).
• Permission Handling: When cleaning system-level directories, the skill automatically skips any file or directory it lacks permission to access, preventing process interruption or error logs.
• Non-Destructive Design: The skill only deletes known, safe cache files and is designed not to touch user documents, images, videos, or project source code. If an application's cache is cleared, restarting that application typically rebuilds it automatically without affecting normal use.
• Interaction Context: Explicitly designed for qclaw's text-based interaction model. All prompts and confirmations are handled via text, requiring no graphical interface or voice support.