影刀 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

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