# TOOLS.md - Local Notes

Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup: camera names and locations, SSH hosts and aliases, preferred TTS voices, speaker/room names, device nicknames, anything environment-specific.

## Examples

```markdown
### Cameras

- living-room → Main area, 180° wide angle
- front-door → Entrance, motion-triggered

### SSH

- home-server → 192.168.1.100, user: admin

### TTS

- Preferred voice: "Nova" (warm, slightly British)
- Default speaker: Kitchen HomePod
```

## Why Separate?

Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.

---

Add whatever helps you do your job. This is your cheat sheet.

## Related

- [Agent workspace](/concepts/agent-workspace)

---

## 📚 PBS 官方文档（操作前必须查阅）

**文档地址：** https://100.115.195.195:8007/docs/ （HTTPS，自签名证书）

**核心章节：**
- **Introduction** — `/docs/introduction.html` — PBS 架构、特性概述
- **Installation** — `/docs/installation.html` — 系统要求、安装方式
- **Backup Storage** — `/docs/storage.html` — Datastore 配置、Keep 策略、GC
- **User Management** — `/docs/user-management.html` — 用户/权限/双因素
- **Client** — `/docs/client.html` — proxmox-backup-client 使用
- **Server Administration** — `/docs/server-administration.html` — 服务管理、网络、证书
- **Pruning & GC** — `/docs/prune-and-gc.html` — 保留策略、垃圾回收
- **Verification** — `/docs/verification.html` — 数据校验任务
- **Troubleshooting** — `/docs/troubleshooting.html` — 故障排查

**工具页面：**
- **API Viewer** — `/docs/api-viewer/index.html`
- **Prune Simulator** — `/docs/prune-simulator/index.html` — 模拟保留策略效果
- **LTO Barcode Generator** — `/docs/lto-barcode/index.html`

---

## ⚠️ 操作规范（强制）

**任何写/删/改操作前必须：**
1. **查阅相关文档章节**，确认命令语法、参数含义、副作用
2. **说明文档依据**（引用具体章节或链接）
3. **获得杨轩明确确认**后方可执行

**示例流程：**
```
用户请求：删除某个备份快照
→ 先查 `/docs/storage.html` 了解快照删除的影响
→ 回复："根据文档 X 章节，删除此快照会... 是否确认？"
→ 用户确认后执行
```

**只读操作可直接执行：**
- `proxmox-backup-manager datastore list`
- `proxmox-backup-manager task list`
- `df -h`, `ls`, `cat` 等查询类命令