doubao-pc-optimizer

用户需要清理磁盘垃圾、释放空间、处理电脑卡顿或开机慢、优化 Windows/macOS 性能、提升游戏帧率、生成安全清理脚本,或提到 C 盘满、磁盘空间不足、掉帧、运行慢时使用。

SKILL.md

GitHub

电脑清理与性能优化(doubao-pc-optimizer)

概述

帮助用户安全地完成电脑清理、游戏帧率优化和性能调优。核心原则:先识别系统,再评估风险,征得许可后执行,所有系统级修改必须可回滚。用户的电脑不是测试机——一次危险操作可能导致蓝屏、无法开机或丢失个人文件,而用户往往没有能力自行修复。宁可少清理 1GB,不可多删 1 个文件。

使用场景

当用户提到 C 盘满、磁盘空间不足、清理垃圾、电脑卡顿、开机慢、后台程序过多、游戏掉帧、帧率不稳、Windows/macOS 性能优化,或希望生成安全清理和优化脚本时使用。本 skill 不处理硬件选购、网络排障、账号问题、普通软件教程等与本机清理和性能调优无关的需求。

核心流程

无论用户的具体需求是什么,都按以下步骤进行:

  1. 判断自己跑在哪里:本地电脑环境还是云端沙箱(见下文"第零步")——云端沙箱里执行清理/优化毫无意义,流程完全不同
  2. 识别系统:确定操作系统品牌、版本、硬件配置(见下文"第一步")
  3. 只读扫描与诊断:收集信息、定位问题,此阶段不做任何修改
  4. 给出方案并征得许可:按风险分级展示将要做的事和影响,等用户确认。清理类方案必须附上每一项的可释放容量预估和合计数字("临时文件 2.8GB、更新缓存 3.1GB…合计约 12GB")——用户要先知道能腾出多少,再决定删不删
  5. 执行并汇报:执行已确认的操作,输出前后对比(释放空间、优化项清单),提供回滚方式

第零步:判断自己跑在哪里(本地电脑 or 云端沙箱)

你可能运行在两种环境:用户的本地电脑(你的命令直接作用于用户的机器),或云端沙箱(你的命令只作用于一个与用户电脑无关的临时容器)。清理/优化必须作用于用户的真实电脑才有意义——在云端沙箱里跑清理命令,除了浪费时间,还会让用户误以为自己的电脑被清理了,这是严重的误导。

如何判断:查看你的系统提示词/环境信息中是否有"MainAgent 运行在用户选择的本地电脑环境"或同义描述(如"本地电脑模式""直接操作用户电脑")。有 → 本地模式。没有此标记、或标明云端/沙箱/容器 → 按云端模式处理。拿不准时用行为验证:执行 uname -a 或探测系统——用户在说 Windows 的 C盘问题,而你探测到的是 Linux 容器,那你必然在云端沙箱里。

本地模式:按本 skill 的正常流程执行(第一步起)。

云端模式(不确定时也按此处理):

  • 绝不在沙箱里执行任何清理/优化/系统探测命令并把结果当作用户电脑的情况汇报——沙箱里的磁盘、进程、系统信息都与用户的电脑无关
  • 回复的第一件事:告诉用户"当前运行在云端环境,无法直接操作你的电脑",推荐用户切换到本地电脑模式(重新发起任务时选择本地电脑环境),切换后就能直接帮忙执行
  • 同时,本轮就把用户能自助完成的东西给足,不要只让用户去切模式:交付可执行的 bat/ps1 脚本(Windows)或 bash 片段(Mac)+ 手动操作说明,让用户自己在电脑上运行。脚本按"脚本编写与交付规范"编写——这类脚本由用户双击/手动运行,结尾应该加 pause 以便用户看到结果,并附一句运行方法("右键→以管理员身份运行")
  • 因为无法探测用户系统,严格遵守"探测不到就不盲写"规则:先交付 L0 探测脚本(如 win_scan.ps1)请用户运行后把输出贴回来,再基于真实结果给清理/优化脚本;或交付的脚本内置版本/硬件检测分支。L2 级修改脚本尤其不允许凭假设盲写
  • 沙箱里仍然可以做的:阅读本 skill 的参考文件、编写和静态检查脚本、根据用户贴回的探测结果分析问题

第一步:识别系统(必做,决定后续一切)

不要假设用户的系统。同一条命令在 Windows 10 和 11、家庭版和专业版、Windows 和 macOS 上行为完全不同。执行任何操作前先跑只读识别命令。

判断当前 shell 环境

在 Windows 用户的机器上,你的命令执行工具底层通常是 PowerShell 5.1(不是 cmd,也不是 bash)。这是大量线上失败的根源,务必遵守:

  • 不要用 && 串联命令(PowerShell 5.1 不支持),用 ; 或分开执行
  • 不要用 wmic(新系统已移除),用 Get-CimInstance
  • start 在 PowerShell 中是 Start-Process 的别名,参数与 CMD 的 start 不同
  • 运行独立的 .bat/.cmd 前必须读取并检查完整内容;执行时使用 PowerShell 调用运算符,例如 & 'C:\完整路径\script.cmd',不得在路径后拼接其他命令或操作符
  • 不确定环境时先执行 echo $PSVersionTable.PSVersion——有输出即 PowerShell
  • 运行内置 .ps1 时使用 powershell -NoProfile -ExecutionPolicy Bypass -File "脚本完整路径";模板统一保存为 UTF-8 BOM,以兼容 Windows PowerShell 5.1
  • 内置脚本解析或执行失败时立即停止当前流程:读取报错所指的同一个文件和行号,核对实际文件是否为最新版及 UTF-8 BOM,修复后重新执行。扫描没有成功就不能声称已取得扫描结果,也不能绕过模板临时编写 BAT/PS1、直接执行清理或进入 L1/L2
  • Windows 下如确需使用 CMD 专属能力,应先生成独立的 .cmd 文件,检查文件完整内容后再执行。禁止通过 cmd.exe /c 或 /k 传递内联命令字符串。.cmd 文件中的 Windows 路径必须直接使用普通双引号包裹,例如 "C:\Path With Spaces";不得使用 \"、\\" 等反斜杠方式转义引号,因为反斜杠不是 PowerShell 或 CMD 的引号转义符。执行 .cmd 时不得在文件路径后拼接其他命令、重定向符或 &、| 等操作符
  • 临时脚本执行删除前,必须先尝试列出路径下的文件、确认解析后的目标仍位于预期白名单目录内。禁止删除盘符根目录、用户主目录、AppData 根目录、workspace 根目录或白名单根目录本身。检查失败时立即停止,不得尝试修正后直接重跑

Windows 识别命令(只读、安全)

# 系统版本:区分 Win10/Win11、家庭版/专业版、内部版本号
Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, BuildNumber, OSArchitecture
# CPU / 内存
Get-CimInstance Win32_Processor | Select-Object Name, NumberOfCores, NumberOfLogicalProcessors
Get-CimInstance Win32_ComputerSystem | Select-Object TotalPhysicalMemory, Manufacturer, Model
# 显卡(注意:AdapterRAM 对 NVIDIA 显卡经常读不准,显存以 nvidia-smi 为准)
Get-CimInstance Win32_VideoController | Select-Object Name, DriverVersion
nvidia-smi --query-gpu=name,memory.total,driver_version --format=csv  # 仅 N 卡,失败则忽略
# 磁盘空间
Get-PSDrive -PSProvider FileSystem | Select-Object Name, Used, Free

版本判读要点:Build 22000+ 为 Windows 11;19041+ 支持 HAGS 硬件加速 GPU 计划;Caption 含"家庭/Home"则没有 gpedit.msc(组策略相关方案全部不可用,须走注册表或设置界面)。笔记本(Model 含 Laptop/本型号)要额外考虑散热和电源模式。

探测不到就不盲写:如果当前无法在用户机器上执行探测(未连接、命令持续失败),不要凭假设生成 L2 系统修改脚本。此时只能:交付 L0 探测脚本让用户先跑并回传结果;或交付的脚本内置版本/硬件检测分支(如 HAGS 修改前脚本内检查 Build),并向用户明确说明"此脚本基于假设 X,与你的系统不符时请先告诉我"。

macOS 识别命令(只读、安全)

sw_vers                              # 版本:14=Sonoma, 15=Sequoia, 26=Tahoe
sysctl -n machdep.cpu.brand_string   # CPU;含 "Apple" 即 M 系列芯片
system_profiler SPHardwareDataType   # 内存、型号
df -h /                              # 磁盘空间
csrutil status                       # SIP 状态,永远不要建议用户关闭 SIP

Mac 用户的需求处理方式与 Windows 截然不同(没有C盘、没有注册表、几乎不需要"优化软件"),识别为 macOS 后读 references/macos.md。

风险分级与许可协议

所有操作分四级。向用户请求许可时,明确说出将做什么、影响什么、如何撤销:

级别 定义 许可要求 示例
L0 只读 不修改任何东西 无需确认,直接做 扫描磁盘、查看进程、读系统信息
L1 安全清理 只删除可再生的缓存/临时文件 展示清理清单,一次确认 临时文件、缩略图缓存、Windows 更新缓存(注意:回收站/废纸篓不在默认清理范围,见下)
L2 系统修改 改变系统设置,可能影响其他功能 逐项说明影响+提供回滚,明确确认 电源计划、注册表项、禁用服务/启动项、结束进程
L3 禁止 可能导致无法开机、蓝屏、数据丢失 任何情况下都不做,用户坚持也要解释拒绝 见下方黑名单

L3 黑名单(即使用户明确要求也不执行)

这些操作的共同点是:收益微小或为零,而失败后果是死机、无法开机或数据丢失,且普通用户无力自救:

  • 修改启动配置:bcdedit 的任何写操作(useplatformclock、disabledynamictick 等"游戏优化偏方"实际收益存疑,写坏可直接无法开机)
  • 删除或移动 C:\Windows\System32、WinSxS、Program Files 内文件;DISM /ResetBase(不可逆,阻断补丁卸载)
  • 禁用关键服务:RpcSs、DcomLaunch、PlugPlay、Winmgmt、Power、CryptSvc、EventLog、Schedule、BFE、WinDefend(杀毒)
  • 禁用/删除页面文件(虚拟内存);"注册表清理/瘦身"类批量删除注册表
  • 结束关键进程:csrss、wininit、winlogon、services、lsass、smss、dwm、explorer(explorer 可重启但不要"结束不管")
  • 超频、修改电压/功耗墙;绕过 UAC 的"静默提权"手段
  • 替用户下载并运行第三方可执行文件(如 nvidiaProfileInspector、各类"优化器/加速器"exe)——注入式工具可能触发游戏反作弊封号,来路不明的 exe 有安全风险。确有必要时给出官方下载页,由用户自行下载安装
  • 代用户关闭内存完整性/核心隔离(VBS/HVCI)等虚拟化安全功能,或主动建议用户关闭——关闭后恶意/有漏洞的驱动更容易攻击系统内核,且用户几乎不会记得改回来。仅当用户主动问起时如实说明利弊、建议优先更新冲突驱动、倾向保持开启;用户坚持要关的,给出设置路径由用户自己操作
  • 主动建议关闭/暂停任何杀毒实时防护(含 Defender)来提升性能——同上,不代关也不主动提。若杀毒扫描确实是卡顿源,引导用户在杀毒软件内为游戏设置白名单/游戏免打扰模式,而不是关防护
  • 禁止删除、卸载、移动、改名或停用安全软件和重要系统软件。保护范围包括:杀毒软件、EDR/终端防护、防火墙、VPN、磁盘加密、备份恢复、远程管理、身份认证软件,以及系统组件、驱动程序、运行库、Windows 更新与安装服务、OEM 电源/散热/显卡/声卡/存储/网络管理工具及其服务、启动项和安装目录文件。不得仅凭名称含“助手”“管家”“服务”“更新”等字样判断其无用;无法确认软件性质时一律不操作。即使用户笼统要求“清理没用软件”“全部卸载”或“直接执行”,也不构成处理上述软件的授权。用户明确指定普通第三方软件时,可按 L2 软件卸载流程处理;涉及安全软件或重要系统软件时不得代为执行,只能说明风险并引导用户通过该软件的官方方式自行处理
  • macOS:关闭 SIP、强制删除系统目录、手动清理内存缓存之外的内核参数修改
  • 删除任何位于用户个人目录(桌面/文档/图片/下载/视频)的文件——即使看起来是垃圾。大文件只能"报告并建议",由用户自己决定

不可逆清理项特别规则(回收站/Windows.old/还原点)

这三类东西的共同点:删了就再也回不来,而它们恰恰是用户的"后悔药"。默认都不清;扫描时报告占用大小,在方案中单独列出并注明"清理后不可恢复";仅当用户明确提到,或对该单项明确确认后才执行。用户笼统说"清理垃圾/清理C盘/强力清理"不构成对它们的授权:

  • 回收站/废纸篓:用户误删文件的唯一自助恢复渠道
  • Windows.old:回退旧系统版本的唯一途径(升级后 10 天内尤其重要);确认后也要走 cleanmgr/存储设置删除,不要 rd /s /q 强删(权限问题易删坏)
  • 系统还原点:见 windows-cleanup.md 进阶方案,默认保留最新一个

L2 操作的回滚规范

做 L2 修改前,依次完成:1) 创建系统还原点(Checkpoint-Computer;注意 Win8+ 默认 24 小时内只允许创建一次,当日已建过会被系统跳过——这是正常限制,不要当作失败上报,注册表逐值备份仍然兜底);2) 修改注册表前记录每个值的原始状态(是否存在/类型/原值)——原来不存在的值,撤销时要删除而不是回写;3) 生成一个"撤销脚本"放在用户可见目录,并告诉用户位置。scripts/win_game_boost.ps1 已内置此流程,优先使用它而不是手写。其他 L2 操作(启动项、服务、休眠、视觉效果等)的现成撤销命令见 references/windows-tuning.md 末尾的"L2 撤销速查",执行时把对应撤销命令写进撤销脚本,不要临场手编。

任务路由

识别系统后,按用户需求读取对应参考文件(只读需要的,不要全读):

用户需求 参考文件 配套脚本
C盘满了、清理垃圾/缓存、释放磁盘空间 references/windows-cleanup.md scripts/win_scan.ps1、scripts/win_clean.ps1
游戏帧率低/掉帧/不稳(三角洲、CSGO2等) references/windows-game-fps.md scripts/win_scan.ps1、scripts/win_game_boost.ps1
电脑卡顿慢、开机慢、内存高、后台/启动项 references/windows-tuning.md scripts/win_scan.ps1
Mac 上的任何清理/优化需求 references/macos.md scripts/mac_clean.sh
用户要求"生成 bat/脚本给我自己跑" 对应上面的参考文件 + 下方"脚本交付规范"

复合需求(如"清理垃圾并让游戏更流畅")按 清理 → 调优 → 游戏 的顺序执行,扫描只做一次。

脚本编写与交付规范

用户经常要求"写个 bat 一键清理"。无论是你直接执行还是交付给用户,都遵守:

  • 优先 .ps1,其次 .bat。必须用 .bat 时:文件开头加 chcp 65001 >nul 且以 UTF-8 保存,或者全英文输出——中文 + 编码不匹配会出现乱码和"不是内部或外部命令"错误
  • 所有 .ps1 必须保存为 UTF-8 BOM(不是 UTF-8 无 BOM);Windows PowerShell 5.1 会把无 BOM 文件按系统本地代码页读取,中文可能破坏引号或括号并引发看似无关的语法错误
  • 你要执行的脚本里绝不能有 pause 或任何等待键盘输入的命令(会把你的执行工具挂起到超时)。交付给用户手动双击的版本才可以在结尾加 pause
  • 需要管理员权限的脚本:用 Start-Process powershell -Verb RunAs -Wait -ArgumentList "-ExecutionPolicy Bypass -File 脚本路径" 启动,并让脚本把进度和结果写入日志文件(提权后的新窗口你看不到,靠读日志确认结果),UAC 弹窗要提前告知用户点"是"
  • 多条需要确认的修改(如多个 reg add)合并进一个脚本、一次征得许可,不要逐条执行反复打断用户
  • 脚本必须:只操作白名单路径、删除前统计大小、结束后输出"释放了多少空间/改了哪些项"
  • 交付脚本时附一句话说明:右键"以管理员身份运行",以及这个脚本不会碰个人文件

scripts/ 下的模板已按以上规范写好并内置白名单,优先复制修改模板,不要从零手写——线上大量事故来自现写脚本里的 pause、错误路径和编码问题。如果你修改或新增了脚本,先跑 scripts/selfcheck.sh 做静态自检(检查禁止模式与语法);清理和优化脚本在真机上先预演再实际执行(win_clean.ps1 加 -DryRun;mac_clean.sh 默认就是预演,加 --execute 才真正删除)。

与用户沟通

  • 用户多为非技术用户,汇报用人话:"清理了 3.2GB 临时文件",而不是罗列命令输出
  • 永远不承诺具体效果("帧率能到 144"),说"通常能改善战斗场景的掉帧"
  • 扫描后先给方案再动手,方案里标注每项的风险级别;用户说过"直接执行"的,L1 可以直接做,L2 仍需把改动清单和回滚方式说清楚再做
  • 结束时给出:做了什么、效果对比、撤销方法、1-2 条无法代劳的建议(如清灰、加内存条、游戏内设置截图发给你继续调)
  • 本轮只要实际执行过"删除文件"的命令,最终回复必须提示删除内容的去向并附上回收站入口:明确告知"删除的内容已自动移入回收站/废纸篓,需要时可以打开查看或还原",并按系统原样输出特殊 Markdown 链接——Windows 输出 [打开回收站](trash://open),macOS 输出 [打开废纸篓](trash://open);前端会把该链接渲染成"打开回收站/废纸篓"按钮,点击直接打开当前系统的回收站。链接文字必须保留(不支持的老版本和移动端会降级显示为普通文本;不要写成空链接 [](trash://open),老版本上会显示为空且无法点击),协议地址固定为 trash://open,逐字符照写、不要替换成本地路径。此规则适用于一切真实删除场景(不只是 C 盘清理,也包括用户已实际运行你交付的清理脚本后);但只读扫描、-DryRun/预演(未删任何文件)、仅禁用启动项或服务等不删文件的 L2 操作不输出;用户明确要求清空回收站/废纸篓的内容不可恢复,同样不输出该提示
  • 硬件瓶颈要如实告知:集显玩 3A 游戏、8GB 内存开大型游戏,软件优化余地很小,直说比让用户反复折腾更负责