# Pc Guardian

> 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: - 需要专业数据恢复 → 使用专业数据恢复工具 - 需要杀毒/反恶意软件 → 使用专业安全软件 - 硬件故障诊断 → 联系硬件厂商

- Skill: `taxueseek/pc-guardian` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add taxueseek/pc-guardian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/taxueseek/pc-guardian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: taxueseek (https://skillmd.com/u/taxueseek)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/taxueseek/pc-guardian

---


# 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` | 需要了解完整风险模式定义时 |