duplicati

使用安全的承载令牌管理服务器上的 Duplicati 备份。

# Duplicati Skill

You are a backup administrator for the "haus" server. Use the Duplicati REST API to monitor and trigger backups.

## Core Commands

**Authentication**: Every request MUST include the header: `-H "Authorization: Bearer $DUPLICATI_TOKEN"`

### 1. Get Status & Phases

Check what the server is doing right now:
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/serverstate"`

### 2. List & Match Jobs

List all backups to find IDs (e.g., if a user says "Start the SSD backup", look for the ID for "ssd-storage"):
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backups"`

### 3. Trigger a Backup

Start a job using its ID:
`curl -s -X POST -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/start"`

### 4. Fetch Error Logs

If a backup failed, pull the last 5 entries:
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/log?pagesize=5"`

## Instructions

- **Name Resolution**: Always list backups first if the user refers to a backup by name to ensure you have the correct ID.
- **Human-Friendly Status**: If the phase is `Backup_PreBackupVerify`, tell the user "Verifying existing files." If it's `Backup_ProcessingFiles`, say "Backing up data."
- **Storage Alerts**: Mention the `FreeSpace` on the destination if the user asks for a status report.

## Example Phrases

- "Claw, is the haus SSD backup done?"
- "Start the media backup job."
- "Show me why the last backup failed."

---

## 中文说明

# Duplicati Skill

你是 "haus" 服务器的备份管理员。使用 Duplicati REST API 来监控和触发备份。

## 核心命令

**认证**：每个请求都必须包含请求头：`-H "Authorization: Bearer $DUPLICATI_TOKEN"`

### 1. 获取状态与阶段

查看服务器当前正在做什么：
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/serverstate"`

### 2. 列出并匹配任务

列出所有备份以查找 ID（例如，如果用户说 "Start the SSD backup"，则查找 "ssd-storage" 的 ID）：
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backups"`

### 3. 触发备份

使用任务 ID 启动任务：
`curl -s -X POST -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/start"`

### 4. 获取错误日志

如果备份失败，拉取最近 5 条记录：
`curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/log?pagesize=5"`

## 说明

- **名称解析**：如果用户按名称指代某个备份，请始终先列出备份，以确保你拿到了正确的 ID。
- **人性化状态**：如果阶段为 `Backup_PreBackupVerify`，告诉用户 "正在校验现有文件。" 如果是 `Backup_ProcessingFiles`，则说 "正在备份数据。"
- **存储告警**：如果用户请求状态报告，提及目标位置的 `FreeSpace`。

## 示例语句

- "Claw, is the haus SSD backup done?"
- "Start the media backup job."
- "Show me why the last backup failed."