用 ClaudeComputerCommander 的 computer-health-check Skill 给电脑做一次只读体检:评分、报告与安全清理全流程

发布时间:2026/10/2 13:31:49
用 ClaudeComputerCommander 的 computer-health-check Skill 给电脑做一次只读体检:评分、报告与安全清理全流程 人工智能MCP 服务AI Agent开发工具【免费下载链接】ClaudeComputerCommanderThis is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities项目地址https://gitcode.com/GitHub_Trending/cl/ClaudeComputerCommander点击查看免费下载本指南讲解 ClaudeComputerCommanderDesktop Commander下称 DC内置的computer-health-checkSkill它如何通过本地真实 shellstart_process/interact_with_process采集只读诊断数据按统一的评分表为磁盘、内存、电池、维护状态、启动项与实时资源占用打分在聊天中输出一段结构化体检报告并提出用户可逐条批准的高价值清理建议。读完本文你将掌握这套 Skill 的完整执行协议OS 检测 → 批量采集 → 评分 → 报告 → 批准式清理、三平台macOS / Windows / Linux的落地方案与安全边界并理解其在 DC 源码层的实现依据。这个 Skill 是什么computer-health-check的目标是给用户一个快速、可信的电脑健康状况快照以及一张值得执行的短清单——像一个资深工程师那样先观察再解释清楚获得许可后才动手修复。它的全部执行都发生在 DC 的本地 shell 中不会把任何数据送出本机它批量采集只读诊断信息给每个维度打分在聊天里输出精炼摘要然后提供用户可以逐项批准的清理建议。Skill 的元数据声明name/version: 0.1.0/audience: agent/description与完整执行协议定义在 skills/computer-health-check/SKILL.mdCursor 插件侧有一份等价副本位于 plugins/cursor/skills/computer-health-check/SKILL.md。适用触发场景包括用户想看电脑健康状况、想提速、释放/回收磁盘空间、排查 CPU/内存/存储占用大户、查看电池健康与损耗、审计登录与启动项、查看待更新项或直接说给我做个 tune-up / checkup / system report / health check / 我电脑健康吗。即使是笔记本感觉变慢了风扇为什么这么响电脑卡顿快没空间了帮我清理一下这类口语也能触发。安全契约先读这个这是让用户信任该 Skill 的核心必须严格遵守默认只读采集阶段只做观察大小、数量、状态不改变任何东西。永不使用sudo或提权DC 出于安全原因会拦截sudo、shutdown、reboot、dd、mount、mkfs、diskpart等命令。下文所有检查都设计为无需提权即可完成如果某步似乎需要提权直接跳过并说明原因而不是尝试绕过拦截。清理必须逐项确认可以自由建议清理但只有在用户明确批准该具体操作后才执行且执行前必须先把确切命令展示给用户。优先选择可逆、非破坏性操作清空可再生缓存、清理包管理器下载缓存、清空回收站/废纸篓都是可以主动提供的删除用户文档、卸载应用、修改系统文件则不属于自动执行范围——只建议让用户自己做。五步工作流Step 1 — 检测操作系统平台不同命令完全不同因此第一步就是确定操作系统最快的方式读取 DC 配置get_config使用其中systemInfo.isMacOS/isWindows/isLinux布尔值或platformName字符串来选择平台。备选方式执行unamemacOS/Linux——如果失败默认按 Windows 处理。这一步在源码层有明确依据getSystemInfo()src/utils/system-info.ts通过os.platform()判定平台win32→ Windowsdarwin→ macOSlinux→ Linux并将isWindows/isMacOS/isLinux/platformName写入SystemInfosrc/tools/schemas.ts 中get_config注册了对应的GetConfigArgsSchemaSkill 正是经由get_config读取这些布尔值。另外platformName在容器环境下还会追加容器标识如 Kubernetes / Docker所以即使运行在容器里报告也能如实标注环境见 src/utils/system-info.ts。确定平台后打开对应的参考文件并使用其中的命令集只读匹配的那一个macOS → skills/computer-health-check/references/macos.mdWindows → skills/computer-health-check/references/windows.mdLinux → skills/computer-health-check/references/linux.md每个参考文件都包含单个批量化采集脚本、解读说明与清理命令。Step 2 — 采集只读用start_process运行参考文件中的批量化采集脚本。把所有检查合并进一次调用比拆成许多小调用快得多输出也更整洁。采集过程注意控制输出体积用head、Select-Object -First等限制输出避免超长进程列表或文件列表淹没回复。首轮跳过慢/网络检查完整的 OS 更新列表、网速测试等首次默认跳过除非用户明确问了更新或网络只需说明这些检查可用。单条命令失败继续执行例如某个工具未安装没关系——部分数据完全够用。以 macOS 为例参考文件给出的批量化脚本通过start_process运行超时约 30 秒输出分节标签便于解析zsh -c echo SYSTEM ; sw_vers; echo uptime:; uptime echo HARDWARE ; system_profiler SPHardwareDataType 2/dev/null | grep -Ei Model Name|Chip|Total Number of Cores|Memory: echo DISK ; df -h / diskutil info / 2/dev/null | grep -Ei SMART|Free Space echo MEMORY ; vm_stat | head -n 8 echo swap:; sysctl -n vm.swapusage echo TOP CPU ; ps -Ao pid,pcpu,pmem,comm -r | head -n 8 echo TOP MEM ; ps -Ao pid,pcpu,pmem,comm -m | head -n 8 echo BATTERY ; pmset -g batt | head -n 2 system_profiler SPPowerDataType 2/dev/null | grep -Ei Cycle Count|Condition|Maximum Capacity echo THERMAL ; pmset -g therm 2/dev/null | head -n 3 echo STARTUP ; echo user agents:; ls -1 $HOME/Library/LaunchAgents 2/dev/null echo service count: $(launchctl list 2/dev/null | wc -l | tr -d ) echo STORAGE HOTSPOTS for d in $HOME/Downloads $HOME/Library/Caches $HOME/.Trash $HOME/Library/Logs; do [ -d $d ] printf %s\t%s\n $(du -sh $d 2/dev/null | cut -f1) ${d/#$HOME/~} done echo PACKAGES command -v brew /dev/null 21 echo brew outdated: $(brew outdated 2/dev/null | wc -l | tr -d ), cache: $(du -sh $(brew --cache) 2/dev/null | cut -f1) || echo brew: not installed echo CRASH REPORTS ; ls -1 $HOME/Library/Logs/DiagnosticReports 2/dev/null | wc -l echo DONE Windows 侧通过start_process运行 PowerShellpowershell -NoProfile -Command ...或pwsh同样用Select-Object限制输出覆盖 SYSTEM / HARDWARE / DISK / DISK HEALTH / MEMORY / TOP CPU / TOP MEM / BATTERY / STARTUP / STORAGE HOTSPOTS / PACKAGES 各节Linux 侧则是 bash 批处理覆盖相同类别并兼容 Debian/Ubuntuapt、Fedoradnf、Archpacman三系包管理器。三份脚本的完整内容见对应参考文件macos.md、windows.md、linux.md。在执行层start_process/interact_with_process的实现在 src/tools/improved-process-tools.tsstartProcess先对参数做StartProcessArgsSchema.safeParse校验再交给commandManager提取与记录命令后启动真实进程interact_with_process每次调用都是全新的脚本执行fresh script二者的 schema 注册见 src/tools/schemas.ts。这也解释了为什么 Skill 约定一次批量调用——进程模型本身就是起一个进程跑完一段脚本把采集并成一次调用最贴合其设计。Step 3 — 给每个维度打分用下表把每个类别评为 Good / Watch / Act然后计算总分从 100 开始每个 减 8 分每个 减 18 分最低到 0。报告分数与一个字评语90 Excellent75–89 Good60–74 Fair60 Needs attention。维度 Good Watch Act空闲磁盘空间20% 空闲10–20%10%磁盘健康SMARTVerified / OK / PASSED—failing / 不支持且存在错误内存压力交换少、空闲页健康明显交换/压缩重度换页、空闲趋零电池笔记本最大容量 ≥80%Normal70–80%70% 或 Service/Replace维护状态运行时长 7 天、无待更新7–30 天或有少量更新30 天或有安全更新待装启动负载少量第三方登录项中等大量重型第三方代理实时资源大户空闲时无 50% 进程一个持续高负载进程多个/失控进程电池仅适用于笔记本——台式机/虚拟机上跳过该项。可回收空间Reclaimable space只作为参考数字报告不参与评分。Step 4 — 在聊天中输出报告使用如下精确结构保持紧凑、可扫读——这就是交付物️ Health Check — Model, OS version Score: N/100 (verdict) // Storage — free free of total (%). Reclaimable: ~X GB // Memory — one-line state // Battery — cycles cycles, max capacity%, condition // Maintenance — up daysd, updates state // Startup — count login items (notable ones) // Right now — top: proc cpu%, proc cpu% Top recommendations 1. highest-impact action (expected benefit, e.g. frees ~13 GB) 2. next 3. next最多列 3–5 条收益最高的建议按收益排序。不要把所有发现都倒出来——目标是信号不是一堵文字墙。Step 5 — 建议清理批准后才执行对每一条能映射到具体命令的建议见参考文件的 Cleanup 小节先展示确切命令再询问。分级处理安全、可逆用户说是即可代为执行清空废纸篓/回收站、包管理器缓存清理brew cleanup、npm cache clean、清空可再生的用户缓存目录。Linux 上apt-get clean/dnf clean需要 root——只建议不自动执行。需要用户自己决定/操作只建议不自动执行禁用登录项、安装系统更新需要重启、卸载应用、删除 Downloads 中的文件。绝不执行任何需要 sudo/管理员权限的操作、删除系统文件、磁盘/分区操作。用户批准安全操作后执行然后报告变化例如释放了多少空间。之后再跑一次 Step 2 的存储检查做确认是很棒的收尾。推荐规则发现 → 建议以下是高价值映射措辞按平台调整运行时长 30 天→ 重启你的电脑——它已连续运行 天。重启会释放内存并应用待装更新。投入产出比最高、成本最低。有待装 OS/安全更新→ 走平台更新步骤安全更新标记为更高优先级。空闲空间 15%→ 优先列出你实测到的最大的可回收项。Downloads / 缓存 / 废纸篓很大→ 清空废纸篓按名称审查最大的 Downloads 项清理可再生的缓存。包管理器有过期项或大缓存→upgrade 缓存清理。电池最大容量 80%→ 说明损耗正常若影响续航再考虑电池服务。第三方启动代理很多→ 点名列出建议用户禁用不认识的/不需要的引导到系统设置 / 任务管理器不要直接改。空闲时有进程持续高占用→ 点名并建议退出/排查。三平台命令解读要点每个参考文件都附有如何解读说明摘其关键macOSreferences/macos.mdApple Silicon 页大小为 16 KB健康 有意义的 freeinactive 页且 swap used 趋零Maximum Capacity是损耗指标Condition: Normal为佳Service Recommended 为 无内置电池台式机时跳过电池项SMARTVerified 健康其他为 启动项里有名字的第三方 LaunchAgents才是可操作的如 updater、helper daemon、冗余 DB 服务原始launchctl计数大多是 Apple 系统服务。可选深度检查softwareupdate -l待装更新走网络较慢、networkQuality网速慢、mdfind kMDItemFSSize 1073741824Spotlight 快速找 1GB 文件。Windowsreferences/windows.mdHealthStatus Healthy为 Warning/Unhealthy为 内存对比 free vs total负载下持续 10% 空闲为 /pagefile 抖动表现为高磁盘 低空闲内存Win32_StartupCommand加 Run 注册表键才是可操作的第三方启动项winget 那行只是输出行数有没有待更新的信号真实列表用winget upgrade获取。电池深度损耗报告需要powercfg /batteryreport会写 HTML 文件到磁盘仅在用户要求时运行并读取生成文件。清理侧Clear-RecycleBin -Force回收站、清$env:TEMP先量尺寸、winget upgrade --all、cleanmgr系统级回收用户操作。Linuxreferences/linux.md看free -h的available列真实余量与 swapused是否攀升高 swap 低 available 为 /lsblk确认设备完整 SMART 需要sudo smartctl -H /dev/sdX跳过无 root 就如实报告未提权不可用不猜电池损耗 charge_full / charge_full_design比值无BAT*则跳过启动项看~/.config/autostart与启用的--userunits。深度检查journalctl -p 3 -b最近启动错误可能需要组权限、du -xh $HOME家目录最大目录、ping -c 4 8.8.8.8。清理侧rm -rf $HOME/.local/share/Trash/*安全、先du -sh ~/.cache/* | sort -rh | head再清特定大项避免一刀切、apt-get clean/dnf clean all/pacman -Sc与更新命令通常要 root——建议而非代跑。注意事项与常见坑不要假设——去测量永远实际运行命令并报告真实数字。绝不编造大小、循环次数或状态。控制输出进程与文件列表可能巨大始终限制数量。可选深度检查提一嘴按需运行网速测试、完整更新列表、整个家目录的分文件夹磁盘扫描、崩溃报告趋势分析。隐私本 Skill 只读取本地系统元数据不把任何东西送出机器公网 IP 检查是可选项且应明确标注。跨平台一致性三份参考文件镜像同一套类别因此无论哪个操作系统报告看起来都一样。这套协议的设计核心在于把信任编码进流程——只读采集、无提权依赖、逐项批准的清理、可验证的收益回报如释放 ~13 GB让 AI 扮演的技师始终在用户可控的边界内工作。若要在 Cursor 等编辑器中使用同一套 Skill 与参考文件也位于 plugins/cursor/skills/computer-health-check/SKILL.md 及其references/目录可作为对照或迁移模板。赞分享人工智能MCP 服务AI Agent开发工具【免费下载链接】ClaudeComputerCommanderThis is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities项目地址https://gitcode.com/GitHub_Trending/cl/ClaudeComputerCommander点击查看免费下载相关推荐ClaudeComputerCommander 跨平台系统健康检查computer-health-check Skill 只读诊断与安全清理实战指南ClaudeComputerCommander 跨平台系统健康检查computer health check Skill 只读诊断与安全清理实战指南 导读 本人工智能MCP 服务AI Agent开发工具ClaudeComputerCommander macOS 系统健康检查命令集只读诊断、评分与安全清理实战指南ClaudeComputerCommander macOS 系统健康检查命令集只读诊断、评分与安全清理实战指南 导读 本文基于 ClaudeComputer人工智能MCP 服务AI Agent开发工具Magma安全最佳实践TLS加密、认证授权完整方案Magma安全最佳实践TLS加密、认证授权完整方案 Magma作为构建接入网络和模块化网络服务的开源平台其安全架构设计直接关系到通信网络的可靠性与用户数据的网络与通信后端物联网上一篇VS Code Recipes团队协作指南如何统一团队调试配置标准下一篇当Elasticsearch聚合查询崩溃时Resilience4j熔断保护实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考