影刀 RPA Skill

能力

• 🔐 鉴权：自动获取/刷新 accessToken
• 📋 任务：列表查询/详情获取/执行记录
• 🚀 执行：启动任务 + 动态传参 + 幂等控制
• 📊 结果：轮询状态 + 提取输出参数

安装方式

通过 ClawHub 安装：

clawhub install yingdao

依赖

本技能包依赖 Python 库 requests，安装技能后请确保已安装：

pip install -r requirements.txt
# 或
pip install "requests>=2.28.0"

安装完成并配置环境变量后即可使用（见下方「环境变量配置」）。

🐍 Python 模块使用

从包入口导入：from active_skills.yingdao import YingdaoAPI, get_client, list_tasks, get_task_logs, YingdaoError, TokenExpiredError。更多用法与参数说明见 yingdao_api 模块及各类、方法的 docstring。

最小示例

from active_skills.yingdao import get_client, list_tasks, get_task_logs
client = get_client()
tasks = list_tasks(keyword="挂车")
logs = get_task_logs("挂车")

API 速查

| 方法 / 函数 | 说明 | |-------------|------| | YingdaoAPI | 客户端类，支持 list_schedules、get_schedule_detail、get_task_records、get_today_records、start_task、query_task_result、find_task_by_name | | get_client() | 从环境变量创建客户端 | | list_tasks(keyword, enabled) | 查询任务列表 | | get_task_logs(task_name) | 按任务名获取近期执行记录 |

接口速查（原始 API）

| 接口 | 方法 | 路径 | 关键参数 | 返回 | |------|------|------|----------|------| | 鉴权 | GET | /oapi/token/v2/token/create | accessKeyId, accessKeySecret | accessToken, expiresIn | | 任务列表 | POST | /oapi/dispatch/v2/schedule/list | key, enabled, page, size | scheduleUuid, scheduleName | | 任务详情 | POST | /oapi/dispatch/v2/schedule/detail | scheduleUuid | robotUuid, params, cron | | 执行记录 | POST | /oapi/dispatch/v2/task/list | sourceUuid, cursorDirection, size | dataList, hasData, nextId | | 启动任务 | POST | /oapi/dispatch/v2/task/start | scheduleUuid, params | taskUuid | | 查询结果 | POST | /oapi/dispatch/v2/task/query | taskUuid | status, outputs |

参数规范

传参格式（task/start）

{
  "scheduleUuid": "sched_xxx",
  "scheduleRelaParams": [{
    "robotUuid": "app_xxx",
    "params": [{"name": "order_id", "value": "ORD123", "type": "str"}]
  }]
}

环境变量配置

在使用前，需要设置以下环境变量：

export YINGDAO_ACCESS_KEY_ID="your_access_key_id"
export YINGDAO_ACCESS_KEY_SECRET="your_access_key_secret"

错误处理

异常类型：YingdaoError（通用）、TokenExpiredError（令牌过期）。调用时用 try-except 捕获即可，详见 yingdao_api 模块。

Installation

安装与依赖见上文「安装方式」「依赖」「环境变量配置」。