C盘清理员

intent

this skill safely cleans your c-drive by scanning only whitelisted directories (temp folders, caches, crash dumps, prefetch, wps artifacts if installed). it explains in chinese what each directory does, why junk accumulates there, and what happens if you delete it. you confirm each directory one-by-one before anything gets deleted. once you approve, the skill nukes the contents (keeps the directories themselves) and spits out a detailed markdown log showing what got freed. use this when you need c-drive space back and want zero chance of breaking windows or losing real files.

inputs

environment / system context

• operating system: windows 10 or later (powershell 5.0+)
• target drive: c: (fixed)
• user permissions: must run as administrator to read/delete system temp directories
• network: not required (fully offline operation)

external connections

• none required. this is a local-only operation.

user interaction

• terminal/powershell access with admin elevation
• ability to respond to yes/no/skip prompts for each directory
• optional: custom log output path (defaults to tasks/evaluation-<YYYY-MM-DD>-c-disk-cleanup.md)

script execution

• powershell script located at script/c-drive-safe-cleanup.ps1
• execution policies: set to Bypass for this script only (does not persist)
• dry-run mode available (scan and confirm only, no deletion)

procedure

1. validate admin privileges and powershell version

   • input: current powershell version, user elevation status
   • output: success/fail with error message if not admin or ps5.0+
   • edge case: if not admin, exit with clear "run as administrator" instruction

2. resolve windows environment variables and build whitelist

   • input: windows environment variables (%TEMP%, %LOCALAPPDATA%, %WINDIR%, %APPDATA%, %PROGRAMDATA%)
   • output: list of 12+ whitelisted paths with variables expanded to actual paths
   • edge case: if a path does not exist on disk, mark it "not detected" and skip scanning

3. detect wps installation

   • input: scan for WPS.exe in Program Files, Program Files (x86), or registry heuristics; also check for %APPDATA%\kingsoft and %LOCALAPPDATA%\Kingsoft
   • output: boolean flag $wpsInstalled (true/false)
   • edge case: if wps detection is ambiguous (e.g., leftover registry after uninstall), default to false and skip wps directories

4. scan each whitelisted directory and compute size

   • input: list of valid paths from step 2; wps flag from step 3
   • process: for each path that exists, recursively scan all files and folders; sum total size in bytes
   • output: array of objects: [{path, exists, sizeBytes, sizeHuman, description}]
   • edge case: if a directory is empty, record size as 0 B; if directory is inaccessible due to permissions, record as "access denied" and note in log

5. generate chinese explanation for each directory

   • input: directory path, purpose, junk source, deletion impact (from whitelist schema)
   • output: three-part text block in chinese: "作用", "垃圾来源", "删除影响"
   • examples provided in original skill for %TEMP%, wps directories, etc.

6. prompt user for each directory (no auto-select)

   • input: directory info from steps 4-5
   • output: user response (yes/no/skip) for each directory
   • format: 目录：<路径>\n预计可释放：<大小>\n说明：<三段中文>\n是否清理该目录？（是/否/跳过）
   • edge case: if user does not explicitly reply "是" (yes in chinese), do not delete; treat as skip

7. validate confirmed directories against whitelist before deletion

   • input: user confirmations from step 6; whitelist from step 2
   • process: for each "yes" directory, re-verify it is in whitelist and path expansion is correct
   • output: validated list of paths to delete
   • edge case: if any path fails validation, abort and report error; do not proceed

8. delete contents of confirmed directories (preserve root directories)

   • input: validated deletion list from step 7
   • process: for each directory, delete all files and subdirectories inside, but keep the root directory itself
   • output: per-directory result: success, partial success (X files skipped), or failure with reason
   • edge case: if a file is in-use or locked, log the filename, skip it, and continue with other files in that directory; do not abort entire directory

9. recompute freed space for each deleted directory

   • input: before/after size from steps 4 and 8
   • output: actual freed space per directory (may be less than predicted if some files were in-use)

10. generate markdown cleanup log

    • input: all results from steps 1-9: timestamp, os version, whitelist strategy, per-directory results (cleaned/skipped/partial/failed), total freed space, failure reasons
    • output: markdown file at tasks/evaluation-<YYYY-MM-DD>-c-disk-cleanup.md (or custom path if provided)
    • format: markdown with header, summary table (columns: 目录, 说明, 用户选择, 结果, 释放空间), final total
    • example template provided in original skill

11. display log path and summary to user

    • input: log file path, total freed space, failure count
    • output: terminal message: "cleanup complete. freed X GB. log saved to ."
    • edge case: if log write fails, print summary to terminal and warn user that log file could not be saved

decision points

if not admin or powershell < 5.0

• exit immediately with error message "must run powershell as administrator with version 5.0 or later"
• do not attempt to scan or delete anything

if a whitelisted path does not exist on disk

• mark it as "not detected" in the directory list
• do not scan it; do not report freed space
• continue to next directory

if wps installation is detected

• include wps directories (8 paths per original whitelist) in the scan and confirmation loop
• if wps is not detected, skip all wps paths silently (no error, no mention)

if a directory is detected but inaccessible (permission denied)

• record "access denied" in scan result
• during confirmation, still ask user; if they choose "yes", attempt delete and log failure
• continue to next directory

if user does not reply "是" to a directory prompt

• treat any other input (no, skip, blank, timeout) as "do not delete"
• do not delete that directory
• continue to next directory

if a file inside a confirmed directory is locked/in-use during deletion

• skip that file only
• continue deleting other files in the same directory
• record "partial success: X files skipped" and list filenames in log
• do not abort or retry; move to next directory

if user runs with -DryRun flag

• complete steps 1-6 (scan, explain, confirm)
• skip step 8 (deletion); instead log "DRY RUN: would delete X directories"
• generate log with "DRY RUN" header; show what would have been deleted
• do not actually delete anything

if user provides custom -LogOutputPath

• write log to that path instead of default
• if path is invalid or write fails, exit with error and suggest default path

if total freed space is 0 bytes

• log completed successfully but note "no space freed (all directories skipped or empty)"
• still generate log file

output contract

log file

• filename: tasks/evaluation-<YYYY-MM-DD>-c-disk-cleanup.md (or custom via -LogOutputPath)
• format: valid markdown
• must include these sections:
  • header: "C盘清理日志"
  • metadata: time (YYYY-MM-DD HH:MM:SS), drive letter (C:), strategy (whitelist only, per-item confirm, no full scan, no downloads/desktop auto-delete, no registry changes)
  • detail table: columns = 目录, 说明, 用户选择, 结果, 释放空间; one row per whitelisted directory
  • summary: total freed space, count of failed items, count of skipped items
  • failure details: if any files failed to delete, list filename and reason
  • user confirmations: optional section showing yes/no/skip for each directory (for audit trail)

terminal output

• success message: "cleanup complete. freed . log saved to ."
• failure message: "cleanup failed: . see for details." (if partial failure or full failure)
• dry-run message: "DRY RUN: would have freed across N directories. log saved to . no changes made."

constraints on the output

• no invented "could release X GB" claims; use only actual scanned sizes
• if a directory was not detected, explicitly state "未检测到该路径，估计可释放 0 B"
• freedspace must be reconciled per-directory after deletion (not estimated)
• all paths in log must be absolute (expanded environment variables)
• all timestamps in UTC or system timezone (specify which)

outcome signal

the user knows the skill worked when:

1. log file exists at the stated path and contains valid markdown with the correct structure
2. the summary table shows at least one "已清理" row if the user confirmed any directories
3. freed space is non-zero in at least one row (if directories had content and user approved deletion)
4. c-drive free space has visibly increased in windows file explorer (visible after closing the script and refreshing)
5. no system files or installed apps are broken after cleanup (windows still boots, programs still run)
6. locked/in-use files are clearly listed in the log if any deletions were skipped; user can manually delete them later
7. the log includes the user's yes/no/skip choices so they can audit what was approved and what happened
8. dry-run mode produces no actual deletion but shows what would have been removed (user can then decide whether to run without -DryRun)

failure signals:

• log file is missing or unreadable
• script exits before completing step 11 (summary display)
• windows refuses to boot or apps fail to launch after cleanup
• freed space is zero but user confirmed deletion of non-empty directories (indicates silent failure)
• script deleted a system critical directory (should never happen if whitelist is enforced)