CNWei
917674880b
- 任务类型改为「执行脚本 / 发起 HTTP 请求 / 运行二进制程序」，脚本类型下新增语言选择（Python / Shell / Node / Lua） - 语言联动表单：Python 才显示虚拟环境、解释器和 uv 状态；Shell/Node/Lua 隐藏这些字段并切换脚本标签、占位符和调用预览 - 切换语言时自动设置解释器与默认脚本，Shell 通过 cmd.exe /C 执行批处理，Node/Lua 使用对应解释器 - TaskAction 新增可选 language，旧任务按解释器推断；补 Shell 执行测试、语言切换单测与 Playwright 用例
2122 lines
51 KiB
JSON
2122 lines
51 KiB
JSON
{
|
||
"openapi": "3.1.0",
|
||
"info": {
|
||
"title": "TaskPilot API",
|
||
"description": "Local task scheduling and process management API.",
|
||
"license": {
|
||
"name": ""
|
||
},
|
||
"version": "0.1.0"
|
||
},
|
||
"paths": {
|
||
"/api/v1/cron/preview": {
|
||
"post": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "preview_cron",
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CronPreviewRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "Upcoming cron occurrences",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CronPreviewResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Invalid cron preview request",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/events": {
|
||
"get": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "execution_events",
|
||
"responses": {
|
||
"200": {
|
||
"description": "Run status and log events",
|
||
"content": {
|
||
"text/event-stream": {
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/health": {
|
||
"get": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "health",
|
||
"responses": {
|
||
"200": {
|
||
"description": "TaskPilot API is healthy",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/HealthResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/python/mirrors": {
|
||
"get": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "list_python_mirrors",
|
||
"responses": {
|
||
"200": {
|
||
"description": "Python package mirrors",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/PythonMirrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "create_python_mirror",
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CreatePythonMirrorRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"201": {
|
||
"description": "Mirror created",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/PythonMirrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Validation failed",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"409": {
|
||
"description": "Mirror URL already exists",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/python/mirrors/{id}": {
|
||
"get": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "get_python_mirror",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Mirror identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Mirror detail",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/PythonMirrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Mirror not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"put": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "update_python_mirror",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Mirror identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/UpdatePythonMirrorRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "Mirror updated",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/PythonMirrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Validation failed",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Mirror not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"409": {
|
||
"description": "Mirror URL already exists",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"delete": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "delete_python_mirror",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Mirror identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"204": {
|
||
"description": "Mirror deleted"
|
||
},
|
||
"404": {
|
||
"description": "Mirror not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/python/mirrors/{id}/default": {
|
||
"post": {
|
||
"tags": [
|
||
"python-mirrors"
|
||
],
|
||
"operationId": "set_default_python_mirror",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Mirror identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Default mirror updated",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/PythonMirrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Mirror not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/python/venv": {
|
||
"post": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "probe_python_venv",
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/VenvProbeRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "Detected Python virtual environment",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/VenvProbeResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Invalid venv probe request",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/python/venv/create": {
|
||
"post": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "create_python_venv",
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CreatePythonVenvRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "Created or reused project virtual environment",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/VenvProbeResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Project cannot create a virtual environment",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/runs/{run_id}": {
|
||
"get": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "get_run",
|
||
"parameters": [
|
||
{
|
||
"name": "run_id",
|
||
"in": "path",
|
||
"description": "Run identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task run detail",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskRunResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Run not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/runs/{run_id}/cancel": {
|
||
"post": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "cancel_run",
|
||
"parameters": [
|
||
{
|
||
"name": "run_id",
|
||
"in": "path",
|
||
"description": "Run identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"202": {
|
||
"description": "Cancellation requested",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskRunResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Run not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"409": {
|
||
"description": "Run is not cancellable",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/runs/{run_id}/logs": {
|
||
"get": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "get_run_logs",
|
||
"parameters": [
|
||
{
|
||
"name": "run_id",
|
||
"in": "path",
|
||
"description": "Run identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
},
|
||
{
|
||
"name": "offset",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Incremental task run log",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/LogChunkResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Run not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/runs/{run_id}/logs/download": {
|
||
"get": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "download_run_logs",
|
||
"parameters": [
|
||
{
|
||
"name": "run_id",
|
||
"in": "path",
|
||
"description": "Run identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Plain text task log",
|
||
"content": {
|
||
"text/plain": {
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Run or log not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/schedule": {
|
||
"get": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "list_schedule",
|
||
"responses": {
|
||
"200": {
|
||
"description": "Next trigger time per enabled task",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/ScheduledTaskResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/session": {
|
||
"get": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "session",
|
||
"responses": {
|
||
"200": {
|
||
"description": "Local API session token",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/SessionResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/stats": {
|
||
"get": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "task_stats",
|
||
"responses": {
|
||
"200": {
|
||
"description": "Dashboard counters",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskStatsResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/system/directories": {
|
||
"get": {
|
||
"tags": [
|
||
"system"
|
||
],
|
||
"operationId": "list_directories",
|
||
"parameters": [
|
||
{
|
||
"name": "path",
|
||
"in": "query",
|
||
"description": "绝对目录路径；留空表示列出盘符",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Subdirectories of the requested path, or the drive list",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DirectoryListingResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "The path is not an existing absolute directory",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks": {
|
||
"get": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "list_tasks",
|
||
"parameters": [
|
||
{
|
||
"name": "q",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "enabled",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "boolean"
|
||
}
|
||
},
|
||
{
|
||
"name": "action_type",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskActionType"
|
||
}
|
||
},
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Paginated task list",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskListResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "create_task",
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CreateTaskRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"201": {
|
||
"description": "Task created",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Validation failed",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"409": {
|
||
"description": "Task ID already exists",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks/{id}": {
|
||
"get": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "get_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task detail",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"put": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "update_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/UpdateTaskRequest"
|
||
}
|
||
}
|
||
},
|
||
"required": true
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task updated",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Validation failed",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"delete": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "delete_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"204": {
|
||
"description": "Task deleted"
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks/{id}/disable": {
|
||
"post": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "disable_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task disabled",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks/{id}/enable": {
|
||
"post": {
|
||
"tags": [
|
||
"tasks"
|
||
],
|
||
"operationId": "enable_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task enabled",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks/{id}/run": {
|
||
"post": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "run_task",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"202": {
|
||
"description": "Manual run accepted",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskRunResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "Task not found",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"422": {
|
||
"description": "Action executor not implemented",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/v1/tasks/{id}/runs": {
|
||
"get": {
|
||
"tags": [
|
||
"runs"
|
||
],
|
||
"operationId": "list_task_runs",
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "Stable task identifier",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
},
|
||
{
|
||
"name": "status",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"$ref": "#/components/schemas/RunStatus"
|
||
}
|
||
},
|
||
{
|
||
"name": "trigger",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"$ref": "#/components/schemas/RunTrigger"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "Task run history",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TaskRunListResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"components": {
|
||
"schemas": {
|
||
"ConcurrencyPolicy": {
|
||
"type": "string",
|
||
"enum": [
|
||
"skip"
|
||
]
|
||
},
|
||
"CreatePythonMirrorRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"index_url"
|
||
],
|
||
"properties": {
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"index_url": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"trusted_host": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CreatePythonVenvRequest": {
|
||
"type": "object",
|
||
"description": "用 uv 为项目创建 `.venv`（pyproject 用 uv sync，requirements 用 uv venv + uv pip install）。",
|
||
"required": [
|
||
"working_dir"
|
||
],
|
||
"properties": {
|
||
"working_dir": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CreateTaskRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"cron",
|
||
"action"
|
||
],
|
||
"properties": {
|
||
"action": {
|
||
"$ref": "#/components/schemas/TaskAction"
|
||
},
|
||
"concurrency_policy": {
|
||
"$ref": "#/components/schemas/ConcurrencyPolicy"
|
||
},
|
||
"cron": {
|
||
"type": "string"
|
||
},
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"id": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"retry_policy": {
|
||
"$ref": "#/components/schemas/RetryPolicy"
|
||
},
|
||
"timeout_secs": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
},
|
||
"timezone": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CronPreviewRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"expression",
|
||
"timezone",
|
||
"count"
|
||
],
|
||
"properties": {
|
||
"count": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"expression": {
|
||
"type": "string"
|
||
},
|
||
"timezone": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CronPreviewResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"timezone",
|
||
"runs"
|
||
],
|
||
"properties": {
|
||
"runs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"timezone": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"DirectoryEntry": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"path"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"description": "用于展示的名称"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"description": "绝对路径，选中后回填到表单"
|
||
}
|
||
}
|
||
},
|
||
"DirectoryListingResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"entries",
|
||
"truncated"
|
||
],
|
||
"properties": {
|
||
"entries": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DirectoryEntry"
|
||
}
|
||
},
|
||
"parent": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "上一级目录；盘符根目录和盘符列表为 null"
|
||
},
|
||
"path": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "当前目录；为 null 表示正在列出盘符"
|
||
},
|
||
"truncated": {
|
||
"type": "boolean",
|
||
"description": "条目超过上限被截断时为 true"
|
||
}
|
||
}
|
||
},
|
||
"ErrorResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"code",
|
||
"message",
|
||
"details"
|
||
],
|
||
"properties": {
|
||
"code": {
|
||
"type": "string"
|
||
},
|
||
"details": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
},
|
||
"propertyNames": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"field": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"message": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"HealthResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"status",
|
||
"service",
|
||
"version"
|
||
],
|
||
"properties": {
|
||
"service": {
|
||
"type": "string",
|
||
"description": "Stable service identifier."
|
||
},
|
||
"status": {
|
||
"type": "string",
|
||
"description": "Current service status."
|
||
},
|
||
"version": {
|
||
"type": "string",
|
||
"description": "Backend package version."
|
||
}
|
||
}
|
||
},
|
||
"HttpMethod": {
|
||
"type": "string",
|
||
"enum": [
|
||
"GET",
|
||
"POST"
|
||
]
|
||
},
|
||
"InterpreterKind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"python",
|
||
"node",
|
||
"other"
|
||
]
|
||
},
|
||
"LogChunkResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"content",
|
||
"next_offset",
|
||
"complete"
|
||
],
|
||
"properties": {
|
||
"complete": {
|
||
"type": "boolean"
|
||
},
|
||
"content": {
|
||
"type": "string"
|
||
},
|
||
"next_offset": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
},
|
||
"PythonMirrorResponse": {
|
||
"type": "object",
|
||
"description": "一个 Python 包索引镜像（pip / uv）。",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"index_url",
|
||
"enabled",
|
||
"is_default",
|
||
"created_at",
|
||
"updated_at"
|
||
],
|
||
"properties": {
|
||
"created_at": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"id": {
|
||
"type": "string"
|
||
},
|
||
"index_url": {
|
||
"type": "string",
|
||
"description": "pip 的 `--index-url`，运行时注入 `PIP_INDEX_URL`"
|
||
},
|
||
"is_default": {
|
||
"type": "boolean",
|
||
"description": "当前默认镜像；同一时间最多一个"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"trusted_host": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "pip 的 `--trusted-host`；https 源通常为空"
|
||
},
|
||
"updated_at": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"RetryPolicy": {
|
||
"type": "object",
|
||
"properties": {
|
||
"delay_secs": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
},
|
||
"max_attempts": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"RunStatus": {
|
||
"type": "string",
|
||
"enum": [
|
||
"queued",
|
||
"running",
|
||
"succeeded",
|
||
"failed",
|
||
"timed_out",
|
||
"cancelled",
|
||
"skipped"
|
||
]
|
||
},
|
||
"RunTrigger": {
|
||
"type": "string",
|
||
"enum": [
|
||
"schedule",
|
||
"manual",
|
||
"retry"
|
||
]
|
||
},
|
||
"ScheduledTaskResponse": {
|
||
"type": "object",
|
||
"description": "已注册调度的任务及其下次触发时间。",
|
||
"required": [
|
||
"task_id"
|
||
],
|
||
"properties": {
|
||
"next_run_at": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"format": "date-time",
|
||
"description": "下次触发时间；调度正在重建时可能为空"
|
||
},
|
||
"task_id": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"ScriptLanguage": {
|
||
"type": "string",
|
||
"enum": [
|
||
"python",
|
||
"shell",
|
||
"node",
|
||
"lua"
|
||
]
|
||
},
|
||
"SessionResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"token"
|
||
],
|
||
"properties": {
|
||
"token": {
|
||
"type": "string",
|
||
"description": "Random per-process token required for mutating browser requests."
|
||
}
|
||
}
|
||
},
|
||
"TaskAction": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"working_dir",
|
||
"interpreter",
|
||
"script",
|
||
"type"
|
||
],
|
||
"properties": {
|
||
"args": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"env": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
},
|
||
"propertyNames": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"interpreter": {
|
||
"type": "string"
|
||
},
|
||
"language": {
|
||
"oneOf": [
|
||
{
|
||
"$ref": "#/components/schemas/ScriptLanguage"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"script": {
|
||
"type": "string"
|
||
},
|
||
"type": {
|
||
"type": "string",
|
||
"enum": [
|
||
"script"
|
||
]
|
||
},
|
||
"venv": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"working_dir": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"url",
|
||
"method",
|
||
"type"
|
||
],
|
||
"properties": {
|
||
"body": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"expected_status": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
}
|
||
},
|
||
"headers": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
},
|
||
"propertyNames": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"method": {
|
||
"$ref": "#/components/schemas/HttpMethod"
|
||
},
|
||
"type": {
|
||
"type": "string",
|
||
"enum": [
|
||
"http"
|
||
]
|
||
},
|
||
"url": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"executable",
|
||
"type"
|
||
],
|
||
"properties": {
|
||
"args": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"env": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
},
|
||
"propertyNames": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"executable": {
|
||
"type": "string"
|
||
},
|
||
"type": {
|
||
"type": "string",
|
||
"enum": [
|
||
"process"
|
||
]
|
||
},
|
||
"working_dir": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"TaskActionType": {
|
||
"type": "string",
|
||
"enum": [
|
||
"script",
|
||
"http",
|
||
"process"
|
||
]
|
||
},
|
||
"TaskListResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"items",
|
||
"page",
|
||
"page_size",
|
||
"total"
|
||
],
|
||
"properties": {
|
||
"items": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/TaskResponse"
|
||
}
|
||
},
|
||
"page": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
},
|
||
"page_size": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
},
|
||
"total": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
},
|
||
"TaskResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"cron",
|
||
"timezone",
|
||
"enabled",
|
||
"timeout_secs",
|
||
"concurrency_policy",
|
||
"retry_policy",
|
||
"action",
|
||
"created_at",
|
||
"updated_at"
|
||
],
|
||
"properties": {
|
||
"action": {
|
||
"$ref": "#/components/schemas/TaskAction"
|
||
},
|
||
"concurrency_policy": {
|
||
"$ref": "#/components/schemas/ConcurrencyPolicy"
|
||
},
|
||
"created_at": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"cron": {
|
||
"type": "string"
|
||
},
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"id": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"retry_policy": {
|
||
"$ref": "#/components/schemas/RetryPolicy"
|
||
},
|
||
"timeout_secs": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
},
|
||
"timezone": {
|
||
"type": "string"
|
||
},
|
||
"updated_at": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"TaskRunListResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"items",
|
||
"page",
|
||
"page_size",
|
||
"total"
|
||
],
|
||
"properties": {
|
||
"items": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/TaskRunResponse"
|
||
}
|
||
},
|
||
"page": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
},
|
||
"page_size": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"minimum": 0
|
||
},
|
||
"total": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
},
|
||
"TaskRunResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"task_id",
|
||
"trigger",
|
||
"status",
|
||
"created_at"
|
||
],
|
||
"properties": {
|
||
"created_at": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"duration_ms": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"format": "int64",
|
||
"minimum": 0
|
||
},
|
||
"error_message": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"exit_code": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"format": "int32"
|
||
},
|
||
"finished_at": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"format": "date-time"
|
||
},
|
||
"id": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
"started_at": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"format": "date-time"
|
||
},
|
||
"status": {
|
||
"$ref": "#/components/schemas/RunStatus"
|
||
},
|
||
"task_id": {
|
||
"type": "string"
|
||
},
|
||
"trigger": {
|
||
"$ref": "#/components/schemas/RunTrigger"
|
||
}
|
||
}
|
||
},
|
||
"TaskStatsResponse": {
|
||
"type": "object",
|
||
"description": "仪表盘指标：一次请求拿到全部计数，避免为每个指标各发一次列表查询。",
|
||
"required": [
|
||
"total",
|
||
"enabled",
|
||
"running",
|
||
"script",
|
||
"http",
|
||
"process"
|
||
],
|
||
"properties": {
|
||
"enabled": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "已启用任务数",
|
||
"minimum": 0
|
||
},
|
||
"http": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "HTTP 类任务数",
|
||
"minimum": 0
|
||
},
|
||
"process": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "进程类任务数",
|
||
"minimum": 0
|
||
},
|
||
"running": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "当前正在执行的任务数",
|
||
"minimum": 0
|
||
},
|
||
"script": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "脚本类任务数",
|
||
"minimum": 0
|
||
},
|
||
"total": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "任务总数",
|
||
"minimum": 0
|
||
}
|
||
}
|
||
},
|
||
"UpdatePythonMirrorRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"index_url",
|
||
"enabled"
|
||
],
|
||
"properties": {
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"index_url": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"trusted_host": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"UpdateTaskRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"cron",
|
||
"action"
|
||
],
|
||
"properties": {
|
||
"action": {
|
||
"$ref": "#/components/schemas/TaskAction"
|
||
},
|
||
"concurrency_policy": {
|
||
"$ref": "#/components/schemas/ConcurrencyPolicy"
|
||
},
|
||
"cron": {
|
||
"type": "string"
|
||
},
|
||
"enabled": {
|
||
"type": "boolean"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"retry_policy": {
|
||
"$ref": "#/components/schemas/RetryPolicy"
|
||
},
|
||
"timeout_secs": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"minimum": 0
|
||
},
|
||
"timezone": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"VenvProbeRequest": {
|
||
"type": "object",
|
||
"description": "编辑器在用户填写工作目录时发起的探测请求。",
|
||
"required": [
|
||
"working_dir",
|
||
"interpreter"
|
||
],
|
||
"properties": {
|
||
"interpreter": {
|
||
"type": "string",
|
||
"description": "解释器或可执行程序，对应 `action.interpreter`"
|
||
},
|
||
"venv": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "手动填写的虚拟环境目录，对应 `action.venv`"
|
||
},
|
||
"working_dir": {
|
||
"type": "string",
|
||
"description": "任务工作目录，对应 `action.working_dir`"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"VenvProbeResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"status",
|
||
"interpreter_kind",
|
||
"message",
|
||
"uv_available",
|
||
"has_pyproject",
|
||
"has_requirements",
|
||
"requirements_files",
|
||
"can_create"
|
||
],
|
||
"properties": {
|
||
"can_create": {
|
||
"type": "boolean",
|
||
"description": "没有虚拟环境时，是否具备用 uv 创建的条件"
|
||
},
|
||
"display_path": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "供界面展示的解释器路径；位于工作目录内时使用相对路径"
|
||
},
|
||
"has_pyproject": {
|
||
"type": "boolean",
|
||
"description": "工作目录根部是否存在 pyproject.toml"
|
||
},
|
||
"has_requirements": {
|
||
"type": "boolean",
|
||
"description": "工作目录根部是否存在 requirements*.txt"
|
||
},
|
||
"interpreter_kind": {
|
||
"$ref": "#/components/schemas/InterpreterKind"
|
||
},
|
||
"message": {
|
||
"type": "string"
|
||
},
|
||
"requirements_files": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"description": "探测到的 requirements 文件名（仅根目录）"
|
||
},
|
||
"source": {
|
||
"oneOf": [
|
||
{
|
||
"$ref": "#/components/schemas/VenvSource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"status": {
|
||
"$ref": "#/components/schemas/VenvProbeStatus"
|
||
},
|
||
"uv_available": {
|
||
"type": "boolean",
|
||
"description": "本机 PATH 中是否能找到 uv"
|
||
},
|
||
"venv_path": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "虚拟环境根目录的绝对路径"
|
||
}
|
||
}
|
||
},
|
||
"VenvProbeStatus": {
|
||
"type": "string",
|
||
"enum": [
|
||
"linked",
|
||
"invalid",
|
||
"missing",
|
||
"not_applicable",
|
||
"incomplete"
|
||
]
|
||
},
|
||
"VenvSource": {
|
||
"type": "string",
|
||
"description": "虚拟环境的来源，用于在界面上说明\"为什么\"关联到了这个环境。",
|
||
"enum": [
|
||
"configured",
|
||
"interpreter",
|
||
"working_directory"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|