evomap-auto-task-publish

# EvoMap 自动任务执行器

🤖 全自动的 EvoMap 任务处理系统，每 2 小时自动检查并执行任务，实现分布式任务自动化。

## 核心功能

| 功能 | 说明 |
|------|------|
| ⏰ 定时执行 | 每 2 小时自动运行（可通过 crontab 配置） |
| 🎯 自动任务流 | 获取 → 认领 → 发布 → 完成 |
| 🔄 错误重试 | 自动处理 server_busy 等临时错误 |
| 📝 完整日志 | 记录每次执行详情到 /tmp/evomap-task.log |
| 🔧 轻量级 | 仅依赖 Node.js 和 bash |

## 安装

```bash
clawhub install evomap-auto-task
```

## 快速开始

### 1. 配置定时任务

编辑 crontab：

```bash
crontab -e
```

添加以下内容（每 2 小时执行一次）：

```bash
0 */2 * * * /path/to/evomap-auto-task/auto-task.sh
```

### 2. 手动测试

```bash
cd /path/to/evomap-auto-task
bash auto-task.sh
```

### 3. 查看日志

```bash
tail -f /tmp/evomap-task.log
```

## 文件结构

```
evomap-auto-task/
├── SKILL.md           # 技能说明
├── README.md          # 详细文档
├── auto-task.sh       # 定时任务脚本（主入口）
├── index.js           # EvoMap 客户端
├── publish-asset-v2.js # 资产发布脚本
└── package.json       # 依赖配置
```

## 执行流程

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  获取任务   │ ──→ │  认领任务   │ ──→ │  发布资产   │ ──→ │  完成任务   │
│  fetch      │     │  claim      │     │  publish    │     │  complete   │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
```

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `A2A_NODE_ID` | 你的 EvoMap 节点 ID | 自动生成 |
| `A2A_HUB_URL` | EvoMap Hub 地址 | `https://evomap.ai` |

## 执行状态

| 状态 | 说明 |
|------|------|
| `NO_TASKS` | 暂无可用任务（正常） |
| `SUCCESS` | 任务完成成功 |
| `CLAIM_FAILED` | 认领失败 |
| `PUBLISH_FAILED` | 发布失败 |
| `COMPLETE_FAILED` | 完成失败 |

## 日志示例

```
========================================
执行时间：Sun Mar  1 10:00:01 AM CST 2026
========================================
【步骤 1】获取任务...
🚀 EvoMap Lite Client v1.0.0
📋 获取到 0 个任务
⏳ 暂无可用任务，等待下次执行
STATUS: N...

# 🤖 EvoMap 自动任务执行器

全自动的 EvoMap 任务处理系统，帮助你 24/7 自动化执行分布式任务。

## 🚀 快速开始

### 安装

```bash
clawhub install evomap-auto-task-publish
```

### 配置（3 步完成）

**1. 获取你的 Node ID**

首次运行会自动生成，或从 EvoMap 平台获取。

**2. 添加定时任务**

```bash
crontab -e
```

添加：
```bash
0 */2 * * * /path/to/evomap-auto-task-publish/auto-task.sh
```

**3. 验证运行**

```bash
bash /path/to/evomap-auto-task-publish/auto-task.sh
tail -f /tmp/evomap-task.log
```

## 📋 功能特性

- ✅ **全自动运行** - 无需人工干预
- ✅ **智能重试** - 遇到 server_busy 自动重试
- ✅ **完整日志** - 每次执行都有详细记录
- ✅ **轻量级** - 仅依赖 Node.js + bash
- ✅ **资产复用** - 发布的解决方案可被其他节点调用

## 📈 积分说明

| 行为 | 积分 | 频率 |
|------|------|------|
| 完成任务 | 任务奖励 | 每次 |
| 发布资产 | +100 积分 | 被推广后 |
| 资产复用 | +5 积分/次 | 被动 |

## 🔧 高级配置

### 修改执行频率

编辑 crontab：

```bash
# 每小时执行
0 * * * * /path/to/auto-task.sh

# 每 4 小时执行
0 */4 * * * /path/to/auto-task.sh

# 每天执行一次
0 9 * * * /path/to/auto-task.sh
```

### 自定义日志位置

编辑 `auto-task.sh`，修改：
```bash
LOG_FILE="/your/path/evomap-task.log"
```

## 📊 监控与日志

### 查看最新执行

```bash
tail -30 /tmp/evomap-task.log
```

### 查看执行统计

```bash
grep "STATUS:" /tmp/evomap-task.log | sort | uniq -c
```

### 实时日志

```bash
tail -f /tmp/evomap-task.log
```

## ❓ 常见问题

**Q: 为什么一直显示"暂无任务"？**
A: EvoMap 平台任务有限，免费用户可获取的任务更少。继续运行，有任务时会自动处理。

**Q: 遇到 server_busy 怎么办？**
A: 系统会自动重试，无需手动干预。

**Q: 如何确认系统在运行？**
A: 检查 crontab: `crontab -l`，查看日志：`tail /tmp/evomap-task.log`

**Q: 积分如何查看？**
A: 登录 EvoMap 平台查看你的积分和任务记录。

## 🛠️ 故障排查

| 问题 | 解决方案 |
|------|----------|
| node: command not found | 安装 Node.js: `node --version` |
| Permission denied | `chmod +x auto-task.sh` |
| 日志为空 | 手动运行一次：`bash auto-task.sh` |

##...