| name | pc-guardian |
| description | PC 电脑管家 — 清理垃圾、优化网速、文件整理、系统设置管理、skill 更新检查、skill 安全审计。
支持 macOS 和 Windows，兼容 Claude Code / Codex / Grok 等 Agent 环境。
所有高风险操作先备份后执行，支持随时回档。
Trigger on: "清理垃圾"、"系统清理"、"电脑卡了"、"清理缓存"、"磁盘清理"、"空间不够"
"网速慢"、"网络诊断"、"优化网络"、"flush dns"、"ping 测试"
"整理文件"、"文件归类"、"重复文件"、"大文件"、"下载文件夹太乱"
"系统设置"、"修改 DNS"、"电源设置"、"Dock 设置"、"显示隐藏文件"
"检查更新"、"skill 更新"、"安全扫描"、"skill 安全"、"电脑管家"、"电脑体检"
"全面检查"、"系统优化"、"备份"、"回档"、"恢复设置"、"操作日志"
Also trigger when: "帮我看看电脑"、"系统维护"、"电脑变慢了"、"磁盘快满了"
"网络不好"、"文件太乱"、"哪些文件可以删"、"skill 有没有问题"
DO NOT use when:
- 需要专业数据恢复 → 使用专业数据恢复工具
- 需要杀毒/反恶意软件 → 使用专业安全软件
- 硬件故障诊断 → 联系硬件厂商
|
PC Guardian — 电脑管家 v2.2
跨平台系统维护 skill。先分析→建议→确认→备份→执行→可回档。
操作分级
| 等级 | 类型 | 默认行为 | 示例 |
|---|
| L0 只读 | 扫描/诊断/查看 | 直接执行 | scan, diagnose, list, audit |
| L1 低风险 | 安全清理/刷新 | 直接执行 | 清理回收站、npm 缓存、flush DNS |
| L2 中风险 | 文件整理/需确认清理 | 需用户确认后执行 | 按类型整理文件、清理浏览器缓存 |
| L3 高风险 | 系统设置/全量清理 | 需确认 + 自动备份 | 修改系统设置、清理所有缓存 |
备份原则
- L2/L3 操作前自动备份到
~/.pc-guardian/backups/{timestamp}/
- 系统设置修改前自动记录当前值到
~/.pc-guardian/state/
- 所有操作记录日志到
~/.pc-guardian/operations.jsonl
- 随时可回档：
pc_guardian.py backup rollback <path> 或 settings restore <key>
意图路由
用户说了什么？
├── 清理/垃圾/缓存/空间不够 → cleanup scan → 交互选择 → cleanup clean
├── 网速慢/网络问题/ping → network diagnose → network optimize
├── 文件乱/整理/归类/重复 → file scan → file suggest → file organize
├── 系统设置/DNS/电源/Dock → settings list → settings set
├── skill 更新/版本检查 → skill scan → skill check
├── 安全扫描/skill 是否安全 → security audit
├── 全面检查/电脑体检 → all
├── 回档/恢复/撤销 → backup list → backup rollback
└── 查看操作记录 → log
命令参考
| 意图 | 命令 | 风险等级 |
|---|
| 全面检查 | pc_guardian.py all | L0 |
| 扫描可清理项 | pc_guardian.py cleanup scan | L0 |
| 清理安全项 | pc_guardian.py cleanup clean | L1 |
| 清理需确认项 | pc_guardian.py cleanup clean --risk confirm --execute | L2 |
| 网络诊断 | pc_guardian.py network diagnose | L0 |
| 网络优化 | pc_guardian.py network optimize | L1 |
| 扫描目录 | pc_guardian.py file scan <dir> | L0 |
| 整理建议 | pc_guardian.py file suggest <dir> | L0 |
| 按类型整理 | pc_guardian.py file organize <dir> --execute | L2 |
| 查找重复 | pc_guardian.py file duplicates <dir> | L0 |
| 列出系统设置 | pc_guardian.py settings list | L0 |
| 修改系统设置 | pc_guardian.py settings set <key> <value> | L3 |
| 恢复系统设置 | pc_guardian.py settings restore <key> | L2 |
| 扫描所有 skill | pc_guardian.py skill scan | L0 |
| 检查 skill 更新 | pc_guardian.py skill check | L0 |
| 安全审计 | pc_guardian.py security audit | L0 |
| 列出备份 | pc_guardian.py backup list | L0 |
| 回档 | pc_guardian.py backup rollback <path> | L2 |
| 操作日志 | pc_guardian.py log | L0 |
详细命令参数见 references/cli-reference.md
安全边界
绝不操作
- 系统关键目录（/System, /usr, C:\Windows\System32）
- 应用本体（只清缓存不清程序）
- 用户文档（除非明确指定）
- 超过 500MB 的单个文件不备份（只记录元数据）
必须确认
- L2 操作：展示预览，等用户确认后执行
- L3 操作：展示预览 + 自动备份 + 等用户确认
- 所有删除操作：先展示明细，再执行
自动回档支持
- 文件删除 → 备份到
~/.pc-guardian/backups/
- 系统设置 → 备份到
~/.pc-guardian/state/
- 文件移动 → 记录源路径和目标路径
参考文档（按需读取）
| 文档 | 何时读取 |
|---|
references/cli-reference.md | 需要完整命令参数说明时 |
references/cleanup-guide.md | 需要详细清理列表、安全边界、自定义规则时 |
references/network-guide.md | 需要深入网络排障、MTU 调优时 |
references/security-checklist.md | 需要了解完整风险模式定义时 |
