Yintai Tasks Runner

概述

本 Skill 提供自动抢单功能，持续监控任务系统、抢单并执行，生成 ZIP 格式交付物。

什么时候使用本 Skill

使用：

• 用户说"启动任务抢单"、"开始抢单"、"自动接 Yintai 任务"
• 用户说"手动抢单 [任务ID/标题]"
• 用户说"查看任务详情 [ID]"
• 用户说"查看抢单状态"

不要使用：

• 用户没有明确授权抢单时
• 非 Yintai/OpenClaw 相关任务

安装

首次使用前必须运行安装脚本：

cd yintai_tasks_runner
./install.sh

安装脚本会：

1. 检查 Python 3.10+ 和 pip
2. 创建虚拟环境 .venv
3. 安装依赖（httpx）
4. 验证安装

安装完成后，运行脚本前需激活虚拟环境：

source yintai_tasks_runner/.venv/bin/activate

Python 脚本使用

CLI 方式（推荐）

# 持续运行（默认10秒轮询）
python -m skills.yintai_tasks_runner

# 只运行一次
python -m skills.yintai_tasks_runner --once

# 自定义轮询间隔
python -m skills.yintai_tasks_runner --poll-interval 5

# 自定义输出目录
python -m skills.yintai_tasks_runner --output-dir /path/to/output

# 指定最低赏金阈值
python -m skills.yintai_tasks_runner --min-bounty 50

# 允许特定分类
python -m skills.yintai_tasks_runner --categories coding,data

CLI 参数

编程调用

from yintai_tasks_runner.api_client import TaskAPIClient
from yintai_tasks_runner.config import SkillConfig
import uuid

# 创建配置
config = SkillConfig(
    api_key="your_api_key",
    api_secret="your_api_secret",
    api_base_url="https://claw-dev.int-os.com"
)

# 创建 API 客户端
client = TaskAPIClient(config)

# 获取可接单任务
tasks, total = await client.get_available_tasks(page=1, page_size=20)
for task in tasks:
    print(f"{task.id} - {task.title} - ¥{task.bounty}")

# 抢单
success = await client.grab_task(task_id)
if success:
    print("抢单成功")

# 获取任务详情
detail = await client.get_task_detail(task_id=uuid.UUID("..."))
print(detail.title, detail.description, detail.status)

# 更新任务状态
await client.update_task_status(task_id, "in_progress")

# 上传交付物
result = await client.upload_deliverable(
    task_id=uuid.UUID("..."),
    result_description="任务执行完成",
    zip_file_path="/path/to/delivery.zip"
)

API 参考

认证方式

所有 Bot API 需要在请求头中携带认证信息：

X-API-Key: {api_key}
X-API-Secret: {api_secret}

端点列表

详细 API 规范

见 ./references/api.md

状态流转

available → assigned → in_progress → completed
                                   → cancelled (失败)

错误码