ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

ClaudeComputerCommander 的 macOS 系统健康检查:只读诊断命令集与解读指南

2026/10/2 2:01:32 拓冰建站 浏览量
ClaudeComputerCommander 的 macOS 系统健康检查:只读诊断命令集与解读指南 人工智能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的 macOS 命令集参考讲解如何借助 MCP 的start_process工具在 macOSApple Silicon上以一条批处理命令完成系统、硬件、磁盘、内存、电池、热力、启动项与存储热点等九类只读诊断并给出结果解读规则、评分方法与经用户批准后才执行的清理建议。读完本文你将掌握一套可直接复制运行的 macOS 健康检查脚本并能独立判断何时该提醒用户、何时该动手清理。背景computer-health-check 技能与安全契约computer-health-check是 ClaudeComputerCommander 仓库中随插件分发的一个 Agent 技能见 SKILL.md其定位是像一位专业技师那样——先看、再解释、经许可才动手。它完全通过 Desktop Commander 的本地 shellstart_process/interact_with_process运行收集一批只读诊断信息在聊天中输出带评分的精简摘要然后逐条提供用户可批准的清理建议。技能同时覆盖 macOS、Windows 和 Linux三份参考文件镜像了同一套检测维度因此报告格式跨平台一致参见 windows.md 与 linux.md。整个技能遵循三条硬性安全约定macOS 命令集也不例外默认只读采集阶段只观察大小、计数、状态不改动任何东西。绝不使用sudo或提权Desktop Commander 出于安全考虑在默认配置中屏蔽了sudo、su、shutdown、reboot、dd、mount、mkfs、diskpart等命令见 src/config-manager.ts 中的默认blockedCommands列表且命令校验会剥离路径前缀使/usr/bin/sudo这类写法同样被识别拦截见 src/command-manager.ts。下述所有检查均被设计为无需提权即可完成。清理操作 opt-in可以自由建议清理但只有在用户明确批准某个具体动作后才执行且执行前先展示完整命令。采集脚本一条命令完成全量诊断macOS 参考文档提供了一个可直接交给start_process运行的 zsh 批处理脚本超时约 30 秒。它按 SECTION 标签分段输出便于解析。原文命令如下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 该脚本覆盖九个维度逐段说明如下输出段采集内容所用命令SYSTEMmacOS 版本sw_vers与运行时长uptimesw_vers、uptimeHARDWARE机型、芯片、核心数、内存system_profiler SPHardwareDataTypeDISK根卷使用率与 SMART/剩余空间df -h /、diskutil info /MEMORY内存页统计与交换区占用vm_stat、sysctl -n vm.swapusageTOP CPU / TOP MEM按 CPU、内存排序的前 8 个进程ps -Ao pid,pcpu,pmem,comm -r/-mBATTERY电池状态、循环次数、条件、最大容量pmset -g batt、system_profiler SPPowerDataTypeTHERMAL热力状态CPU/GPU 节流等pmset -g thermSTARTUP用户 LaunchAgents 列表与 launchctl 服务总数ls $HOME/Library/LaunchAgents、launchctl listSTORAGE HOTSPOTSDownloads、Caches、Trash、Logs 四类目录体积du -sh循环PACKAGESHomebrew 过期包数量与缓存体积brew outdated、du -sh $(brew --cache)CRASH REPORTS崩溃报告数量ls $HOME/Library/Logs/DiagnosticReportsstart_process 的调用参数从 src/tools/schemas.ts 可以看到start_process的完整参数约束export const StartProcessArgsSchema z.object({ command: z.string(), // 必填要执行的命令字符串 timeout_ms: z.number(), // 必填超时上限毫秒macOS 参考文档建议约 30000 shell: z.string().optional(), // 可选显式指定 shellmacOS 默认 zsh verbose_timing: z.boolean().optional(), origin: z.enum([ui, llm]).optional(), });因此运行采集脚本时应以start_process启动并设置timeout_ms: 30000左右。技能工作流还强调一次批量采集远优于多次小调用既更快输出也更整洁见 SKILL.md。如何解读输出四个关键信号参考文档给出了四条核心判读规则内存压力Apple Silicon 上页大小为16 KB。健康状态 有意义的空闲free 非活跃inactive页、且vm.swapusage的 used 接近 0。如果 swap 已用达到数百 MB / GB 级即 /。电池Maximum Capacity最大容量百分比是磨损指标Condition: Normal为良好出现Service Recommended即为 。若pmset -g batt显示没有内置电池台式机则整段电池检查跳过。SMARTdiskutil info输出的 SMART 状态为Verified即健康其他任何值 → 。启动项~/Library/LaunchAgents下有名有姓的第三方 LaunchAgents才是可操作的如更新器、辅助守护进程、多余的数据库服务launchctl list的原始计数大多是 Apple 系统服务参考价值有限。评分与报告把数字翻译成建议采集完成后技能按 SKILL.md 的评分表对每个区域评级并汇总得分从 100 分起每个 减 8 分、每个 减 18 分下限为 090 Excellent、75–89 Good、60–74 Fair、60 Needs attention。各区域的判级阈值如下区域 Good Watch Act可用磁盘空间20%10–20%10%磁盘健康SMARTVerified / OK / PASSED—失败或不受支持且存在错误内存压力低 swap、空闲页健康明显 swap/压缩重度换页、空闲近乎为 0电池笔记本最大容量 ≥80%、Normal70–80%70% 或 Service/Replace维护状态运行 7 天、无待装更新运行 7–30 天或少量更新运行 30 天或有安全更新待装启动负载第三方登录项少中等大量重型第三方代理实时资源占用空闲时无进程 50%单个持续重负载进程多个/失控进程电池仅适用于笔记本台式机/虚拟机上跳过可回收空间作为信息项报告、不参与评分。随后按固定结构在聊天中输出报告见 SKILL.md️ 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 条最高收益建议按收益排序——目标是信号不是文字墙。可选深度检查仅在被询问时运行以下检查涉及网络或较慢默认第一轮不做仅在用户关心更新或网络时才运行来自 macOS 参考文档softwareupdate -l 21 | head -n 20 # 待装系统更新联网、慢 networkQuality 2/dev/null # 上下行速率 响应性慢 mdfind kMDItemFSSize 1073741824 2/dev/null | head -n 20 # 大于 1GB 的文件Spotlight 索引加速其中mdfind正是 Desktop Commander 总览技能所提示的 macOS 上借助 Spotlight 做精确文件名/条件检索的推荐工具参见 desktop-commander-overview/SKILL.md 的 macOS 约定一节。清理命令建议优先、执行需批准macOS 参考文档将清理命令按安全等级分类技能要求先展示确切命令、用户批准后才执行清空废纸篓安全rm -rf $HOME/.Trash/*或提示用户从 Finder 中清空。Homebrew安全brew cleanup移除旧版本 缓存升级用brew upgrade。用户缓存安全、可重建先du -sh ~/Library/Caches/* | sort -rh | head排查再清掉特定的大体积子目录严禁整目录一刀切删除。登录项用户操作系统设置 → 通用 → 登录项或仅在用户确认不需要时删除对应的~/Library/LaunchAgents/name.plist。系统更新用户操作、需重启系统设置 → 通用 → 软件更新。技能对清理的整体立场是可逆、非破坏性动作清空可再生的缓存、包管理器下载缓存、废纸篓可以主动提供删除用户文档、卸载应用、修改系统文件等一律只建议、交由用户自行执行见 SKILL.md。配套工具与跨平台一致性macOS 命令集并非孤立存在。在同一技能目录下linux.md 提供了针对 Debian/Ubuntu、Fedora、Arch 的无 sudo 只读诊断free -h、lsblk、systemctl --user、电池磨损比等windows.md 则通过powershell -NoProfile提供等价采集Get-CimInstance、Get-PhysicalDisk、win_get startup、winget upgrade计数等。三份文件的结构刻意对齐采集脚本 解读要点 可选深度检查 分级清理命令确保无论宿主是 Mac、PC 还是 Linux 机器最终报告形态一致、可读。需要特别说明的是 Windows 参考文档中的两个判读细节同样体现了该技能如实呈现、不过度解读的原则Win32_Battery只能给出充电百分比而非磨损率深度磨损报告需按需运行powercfg /batteryreport再读取生成的 HTMLwinget upgrade的计数值只是输出行数应理解为是否有待装更新而非精确数量。macOS 侧同理——SMART 状态不受支持时如实说明而不是猜测。小结macOS 健康检查的完整闭环是start_process超时 ~30s批量采集 → 按九段标签解读 → 按评分表逐区评级并汇总得分 → 输出 3–5 条按收益排序的建议 → 对安全清理项展示确切命令、待用户批准后执行。全程只读、无 sudo与 Desktop Commander 的默认blockedCommands安全策略src/config-manager.ts保持一致。这套命令集与评分框架已随插件以技能形式分发任何 Agent 客户端在本地 shell 可用时都能直接复用是 macOS 日常体检与磁盘/内存/电池问题快速定位的实用起点。赞分享人工智能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点击查看免费下载相关推荐MicroPython machine.Timer 定时器全面指南虚拟与硬件定时器、周期回调与中断上下文MicroPython machine.Timer 定时器全面指南虚拟与硬件定时器、周期回调与中断上下文 machine.Timer 是 MicroPytho人工智能MCP 服务AI Agent开发工具chezmoi doctor 命令完全指南系统健康检查与故障诊断chezmoi doctor 命令完全指南系统健康检查与故障诊断 chezmoi doctor 是 chezmoi 提供的一条一键体检命令用于扫描当前系开发工具CLI配置管理DLSS Swapper一键切换DLSS版本DLSS Swapper一键切换DLSS版本 游戏刚打完补丁你发现社区都在聊新版 DLSSNVIDIA 的深度学习的图像增强技术画质更好但你手里这份游戏桌面应用上一篇RE-USE实战教程处理7种不同采样率音频的完整指南下一篇5个高效技巧用数据处理工具实现JSON全流程管理创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考