get_task_status
Check execution status of scheduled tasks in Qinglong Panel by providing a task ID to monitor progress and results.
Instructions
获取青龙面板中指定任务的执行状态
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | 任务 ID |
Implementation Reference
- server.py:295-336 (handler)Handler for the get_task_status tool: fetches task details from Qinglong API /open/crons/{task_id}, maps status codes to human-readable text, and formats output with task name, status, disabled/pinned flags, last run duration, and execution time.elif tool_name == "get_task_status": task_id = arguments.get("task_id") try: url = f"{QINGLONG_URL}/open/crons/{task_id}" headers = {"Authorization": f"Bearer {token}"} resp = requests.get(url, headers=headers, timeout=10) result = resp.json() except Exception as e: response = { "jsonrpc": "2.0", "id": request["id"], "error": {"code": -32603, "message": f"请求失败: {str(e)}"} } print(json.dumps(response), flush=True) continue if result.get("code") == 200: cron = result["data"] status_map = {0: "运行中", 1: "空闲", 2: "禁用"} status = status_map.get(cron.get("status"), "未知") output = f"任务 {task_id} 状态信息:\n\n" output += f"名称: {cron.get('name')}\n" output += f"状态: {status}\n" output += f"是否禁用: {'是' if cron.get('isDisabled') == 1 else '否'}\n" output += f"是否置顶: {'是' if cron.get('isPinned') == 1 else '否'}\n" last_running = cron.get('last_running_time') output += f"上次运行时长: {last_running}秒\n" if last_running else "上次运行时长: 未运行\n" output += f"最后执行时间: {cron.get('last_execution_time', '未执行')}\n" response = { "jsonrpc": "2.0", "id": request["id"], "result": {"content": [{"type": "text", "text": output}]} } else: response = { "jsonrpc": "2.0", "id": request["id"], "error": {"code": -32603, "message": f"获取任务状态失败: {result}"} }
- server.py:123-133 (registration)Tool registration in tools/list method, defining name, description, and input schema requiring integer task_id.{ "name": "get_task_status", "description": "获取青龙面板中指定任务的执行状态", "inputSchema": { "type": "object", "properties": { "task_id": {"type": "integer", "description": "任务 ID"} }, "required": ["task_id"] } },
- server.py:126-131 (schema)Input schema for get_task_status tool: object with required integer task_id property."inputSchema": { "type": "object", "properties": { "task_id": {"type": "integer", "description": "任务 ID"} }, "required": ["task_id"]