{
  "openapi": "3.0.3",
  "info": {
    "title": "掌玩系统 API 接入",
    "version": "3.1.0",
    "description": "通用 API：普通 Bearer Key；可选 Ed25519 签名。写入统一 JSON，Bearer 无需模块专用 X-*-Request 头。Cookie 管理接口保留 CSRF 标识。账号与Key权限取交集。已有业务响应格式保留，api-client.mjs 提供统一客户端结果与错误。模块协议/任务快照为条件字段与业务要求的权威来源。"
  },
  "servers": [
    {
      "url": "https://ai.zhangwan.net"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "普通Key以zwk_开头，仅需Bearer；签名Key还必须提供deviceSignature及签名参数。"
      },
      "sessionCookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "ai_member"
      },
      "deviceSignature": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Signature",
        "description": "Ed25519签名，按x-device-proof构造"
      },
      "connectCookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "ai_api_connect"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          }
        }
      },
      "KeyScope": {
        "type": "object",
        "required": [
          "permissions"
        ],
        "additionalProperties": false,
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "officialMonitor.view",
                "officialMonitor.create",
                "officialMonitor.edit",
                "officialMonitor.delete",
                "baiduTongji.view",
                "baiduTongji.create",
                "baiduTongji.edit",
                "baiduTongji.delete",
                "toolSites.view",
                "toolSites.create",
                "toolSites.edit",
                "toolSites.delete",
                "tools.view",
                "tools.create",
                "tools.edit",
                "tools.delete",
                "toolTags.view",
                "toolTags.create",
                "toolTags.edit",
                "toolTags.delete",
                "toolTasks.view",
                "toolTasks.create",
                "toolTasks.edit",
                "toolTasks.delete",
                "tasks.view",
                "tasks.create",
                "tasks.edit",
                "tasks.delete",
                "sites.view",
                "sites.create",
                "sites.edit",
                "sites.delete",
                "styles.view",
                "styles.create",
                "styles.edit",
                "styles.delete",
                "core.view",
                "core.create",
                "core.edit",
                "core.delete",
                "adverbs.view",
                "adverbs.create",
                "adverbs.edit",
                "adverbs.delete",
                "topics.view",
                "topics.create",
                "topics.edit",
                "topics.delete",
                "titles.view",
                "titles.create",
                "titles.edit",
                "titles.delete",
                "titleKeywords.view",
                "titleKeywords.create",
                "titleKeywords.edit",
                "titleKeywords.delete",
                "tags.view",
                "tags.create",
                "tags.edit",
                "tags.delete",
                "sources.view",
                "sources.create",
                "sources.edit",
                "sources.delete",
                "taskTags.view",
                "taskTags.create",
                "taskTags.edit",
                "taskTags.delete",
                "taskGroups.create",
                "taskGroups.edit",
                "taskGroups.delete",
                "dataSources.view",
                "dataSources.create",
                "dataSources.edit",
                "dataSources.delete",
                "sourceTags.view",
                "sourceTags.create",
                "sourceTags.edit",
                "sourceTags.delete",
                "sourceCategories.view",
                "sourceCategories.create",
                "sourceCategories.edit",
                "sourceCategories.delete",
                "titleSources.view",
                "titleSources.create",
                "titleSources.edit",
                "titleSources.delete",
                "evidence.view",
                "evidence.create",
                "evidence.edit",
                "evidence.delete",
                "websites.view",
                "websites.create",
                "websites.edit",
                "websites.delete",
                "publishApis.view",
                "publishApis.create",
                "publishApis.edit",
                "publishApis.delete",
                "templates.view",
                "templates.delete",
                "templateTags.view",
                "templateTags.create",
                "templateTags.edit",
                "templateTags.delete",
                "templateInstructions.view",
                "templateInstructions.create",
                "templateInstructions.edit",
                "templateInstructions.delete",
                "browserAccounts.view",
                "browserAccounts.create",
                "browserAccounts.edit",
                "browserAccounts.delete",
                "larkBots.view",
                "larkBots.create",
                "larkBots.edit",
                "larkBots.delete",
                "websiteReports.view",
                "websiteReports.create",
                "websiteReports.edit",
                "websiteReports.delete",
                "topicTasks.view",
                "topicTasks.create",
                "topicTasks.edit",
                "topicTasks.delete",
                "videoSources.view",
                "videoSources.create",
                "videoSources.edit",
                "videoSources.delete",
                "videoUpdates.view",
                "videoUpdates.create",
                "videoUpdates.edit",
                "videoUpdates.delete",
                "videoArticles.view",
                "videoArticles.create",
                "videoArticles.edit",
                "videoArticles.delete",
                "officialMonitor.execute",
                "toolSites.preview",
                "toolSites.sync",
                "toolConnections.view",
                "toolConnections.edit",
                "toolData.view",
                "toolData.edit",
                "testDevelopment.generate",
                "testDevelopment.view",
                "twitterApis.view",
                "twitterApis.query",
                "baiduTongji.authorize",
                "baiduTongji.query",
                "larkReports.view",
                "larkReports.create",
                "larkReports.delete",
                "tools.test",
                "toolVersions.lock",
                "toolTasks.execute",
                "toolTasks.sync",
                "topicTasks.execute",
                "topicTasks.publish",
                "websiteReports.execute",
                "larkBots.notify",
                "videoSources.execute",
                "videoArticles.generate",
                "videoArticles.review",
                "videoArticles.publish",
                "tasks.execute",
                "sites.publish",
                "sites.unpublish",
                "sites.review",
                "sites.configure",
                "sites.upload",
                "siteSettings.view",
                "siteSettings.edit",
                "templateGrants.view",
                "templateGrants.create",
                "templateGrants.delete",
                "browserAccounts.login",
                "browserAccounts.verify",
                "browserAccounts.clear",
                "paid.view",
                "paid.billing",
                "paid.execute",
                "collection.view",
                "collection.execute",
                "events.view",
                "events.create",
                "events.publish",
                "events.delete",
                "records.view",
                "records.create",
                "subjects.view",
                "coreTasks.view",
                "coreTasks.create",
                "coreTasks.edit",
                "coreTasks.delete",
                "coreTasks.execute",
                "playbook.view",
                "cover.view",
                "tokens.create",
                "tokens.delete"
              ]
            }
          },
          "taskIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "siteIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "larkBotIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "baiduTongjiBindingIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Revision": {
        "type": "object",
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "revision"
        ]
      },
      "Run": {
        "type": "object",
        "required": [
          "revision",
          "runKey"
        ],
        "properties": {
          "revision": {
            "type": "integer"
          },
          "runKey": {
            "type": "string"
          }
        }
      },
      "ReportResult": {
        "type": "object",
        "required": [
          "runId",
          "runKey",
          "result"
        ],
        "properties": {
          "runId": {
            "type": "string",
            "format": "uuid"
          },
          "runKey": {
            "type": "string"
          },
          "result": {
            "type": "object",
            "required": [
              "status",
              "summary"
            ],
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "completed",
                  "partial",
                  "failed",
                  "unknown"
                ]
              },
              "summary": {
                "type": "string"
              },
              "artifacts": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "deliveries": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "previousResultHash": {
            "type": "string"
          },
          "resolution": {
            "type": "string"
          }
        }
      },
      "XSearch": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "type": "string"
          },
          "product": {
            "type": "string",
            "enum": [
              "Latest",
              "Top"
            ]
          },
          "cursor": {
            "type": "string"
          }
        }
      },
      "ScopeUpdate": {
        "type": "object",
        "required": [
          "id",
          "revision",
          "keyScope"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer"
          },
          "keyScope": {
            "$ref": "#/components/schemas/KeyScope"
          }
        }
      },
      "GenericResult": {
        "type": "object",
        "description": "与 GET requirements/protocol 返回的本次领取协议匹配；保留真实回执及原幂等标识，不自动重发外站。",
        "additionalProperties": true
      }
    }
  },
  "paths": {
    "/api/members/login": {
      "post": {
        "summary": "网页登录",
        "description": "独立API授权会话，仅能批准设备，不能访问后台。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "缺权限或不允许的凭证类型",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string",
                    "format": "password"
                  },
                  "loginMode": {
                    "type": "string",
                    "enum": [
                      "api_connect"
                    ]
                  }
                },
                "required": [
                  "username",
                  "password",
                  "loginMode"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "security": [],
        "x-usage-guide": {
          "purpose": "网页登录。",
          "when": "网页登录系统时使用；已有API Key调用业务接口无需每次登录。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_login"
      }
    },
    "/api/members/me": {
      "get": {
        "summary": "获取当前账号和权限",
        "description": "返回user与当前权限；令牌不改变账号权限。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          },
          {
            "connectCookie": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "获取当前账号和权限。",
          "when": "核实当前登录身份、权限和授权范围时使用。",
          "kind": "认证授权"
        },
        "operationId": "get_api_members_me"
      }
    },
    "/api/members/device/start": {
      "post": {
        "summary": "发起设备码登录",
        "description": "客户端将deviceCode保存在私有内存，给用户显示verificationUrl和userCode。10分钟内需浏览器确认。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "缺权限或不允许的凭证类型",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "publicKey": {
                    "type": "string",
                    "description": "本机Ed25519公钥，SPKI PEM，不得上传私钥"
                  }
                },
                "required": [
                  "name",
                  "publicKey"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "security": [],
        "x-usage-guide": {
          "purpose": "发起设备码登录。",
          "when": "新客户端首次申请设备授权时使用。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_device_start"
      }
    },
    "/api/members/device/poll": {
      "post": {
        "summary": "查询设备码授权状态",
        "description": "每5秒一次，不并发。approved后将原deviceCode作为Bearer令牌保存，pending继续等待；410过期需重新发起。不要输出deviceCode。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "设备登录请求已过期"
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "deviceCode": {
                    "type": "string"
                  }
                },
                "required": [
                  "deviceCode"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          },
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "x-usage-guide": {
          "purpose": "查询设备码授权状态。",
          "when": "已发起设备授权，等待用户在浏览器确认时使用。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_device_poll"
      }
    },
    "/api/members/device/approve": {
      "post": {
        "summary": "浏览器确认设备授权",
        "description": "会员需要tokens.create。必须由用户核对本人设备码。Bearer不允许使用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "缺权限或不允许的凭证类型",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  }
                },
                "required": [
                  "code"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "security": [
          {
            "connectCookie": []
          }
        ],
        "x-usage-guide": {
          "purpose": "浏览器确认设备授权。",
          "when": "用户在已登录浏览器确认本次设备接入时使用。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_device_approve"
      }
    },
    "/api/keyword-center/keywords": {
      "get": {
        "summary": "任务中心读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "tasks.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询任务中心清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_keyword_center_keywords"
      }
    },
    "/api/title-library": {
      "get": {
        "summary": "标题库读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "titles.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询标题库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_title_library"
      },
      "post": {
        "summary": "标题库新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增标题库记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_title_library"
      }
    },
    "/api/title-keywords": {
      "get": {
        "summary": "标题词库读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "titleKeywords.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询标题词库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_title_keywords"
      },
      "post": {
        "summary": "标题词新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titleKeywords.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增标题词记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_title_keywords"
      }
    },
    "/api/styles": {
      "get": {
        "summary": "风格库读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "styles.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询风格库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_styles"
      },
      "post": {
        "summary": "风格库新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "styles.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增风格库记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_styles"
      }
    },
    "/api/websites": {
      "get": {
        "summary": "网站管理读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "websites.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询网站管理清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_websites"
      },
      "post": {
        "summary": "网站新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websites.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增网站记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_websites"
      }
    },
    "/api/publish-apis": {
      "get": {
        "summary": "发布API配置读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "publishApis.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询发布API配置清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_publish_apis"
      },
      "post": {
        "summary": "发布接口新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "publishApis.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增发布接口记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_publish_apis"
      }
    },
    "/api/mining/keywords": {
      "get": {
        "summary": "核心关键词读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "core.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询核心关键词清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_keywords"
      },
      "post": {
        "summary": "核心词新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "core.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增核心词记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_mining_keywords"
      }
    },
    "/api/mining/adverbs": {
      "get": {
        "summary": "副词库读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "adverbs.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询副词库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_adverbs"
      },
      "post": {
        "summary": "副词新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "adverbs.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增副词记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_mining_adverbs"
      }
    },
    "/api/mining/browse": {
      "get": {
        "summary": "专题库读取入口",
        "description": "专题分页读取；view固定topics，避免使用旧的全量topics入口。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "topics.view",
        "parameters": [
          {
            "in": "query",
            "name": "view",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "topics"
              ]
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "x-usage-guide": {
          "purpose": "查询专题库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_browse"
      }
    },
    "/api/mining/data-sources": {
      "get": {
        "summary": "数据源读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "dataSources.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询数据源清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_data_sources"
      },
      "post": {
        "summary": "数据源新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "dataSources.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增数据源记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_mining_data_sources"
      }
    },
    "/api/topic-tasks": {
      "get": {
        "summary": "专题任务读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "topicTasks.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询专题任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_topic_tasks"
      },
      "post": {
        "summary": "专题任务新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增专题任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_topic_tasks"
      }
    },
    "/api/keyword-sites": {
      "get": {
        "summary": "独立站读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "sites.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询独立站清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_keyword_sites"
      }
    },
    "/api/tool-library/tools": {
      "get": {
        "summary": "工具库读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "tools.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询工具库清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tools"
      },
      "post": {
        "summary": "工具新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tools.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增工具记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_tool_library_tools"
      }
    },
    "/api/tool-library/tasks": {
      "get": {
        "summary": "工具任务读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "toolTasks.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询工具任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tasks"
      },
      "post": {
        "summary": "工具任务新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增工具任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_tool_library_tasks"
      }
    },
    "/api/tool-library/site-sync/profiles": {
      "get": {
        "summary": "工具网站同步读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "toolSites.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询工具网站同步清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_site_sync_profiles"
      }
    },
    "/api/video-articles/sources": {
      "get": {
        "summary": "视频来源读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "videoSources.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询视频来源清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_sources"
      },
      "post": {
        "summary": "视频来源新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频来源记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_sources"
      }
    },
    "/api/video-articles/updates": {
      "get": {
        "summary": "视频更新读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "videoUpdates.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询视频更新清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_updates"
      },
      "post": {
        "summary": "视频动态新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频动态记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_updates"
      }
    },
    "/api/video-articles/articles": {
      "get": {
        "summary": "视频文章读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "videoArticles.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询视频文章清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_articles"
      },
      "post": {
        "summary": "视频文章新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频文章记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_articles"
      }
    },
    "/api/lark-bots": {
      "get": {
        "summary": "Lark机器人读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "larkBots.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "查询Lark机器人清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_lark_bots"
      },
      "post": {
        "summary": "Lark机器人新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkBots.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增Lark机器人记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_lark_bots"
      }
    },
    "/api/lark-reports/protocol": {
      "get": {
        "summary": "Lark报告协议读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "larkReports.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "读取Lark报告的参数、流程及回传约定。",
          "when": "首次接入该模块或协议更新后读取；执行中不必反复下载同一份说明。",
          "kind": "接入说明"
        },
        "operationId": "get_api_lark_reports_protocol"
      }
    },
    "/api/baidu-tongji/protocol": {
      "get": {
        "summary": "百度统计协议读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "baiduTongji.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "读取百度统计的参数、流程及回传约定。",
          "when": "首次接入该模块或协议更新后读取；执行中不必反复下载同一份说明。",
          "kind": "接入说明"
        },
        "operationId": "get_api_baidu_tongji_protocol"
      }
    },
    "/api/twitterapis/protocol": {
      "get": {
        "summary": "X采集协议读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "twitterApis.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "读取X采集的参数、流程及回传约定。",
          "when": "首次接入该模块或协议更新后读取；执行中不必反复下载同一份说明。",
          "kind": "接入说明"
        },
        "operationId": "get_api_twitterapis_protocol"
      }
    },
    "/api/official-monitor/protocol": {
      "get": {
        "summary": "官网监控协议读取入口",
        "description": "仅返回当前账号可访问数据；分页/参数和写入流程以对应模块协议为准。此入口不授权外站发布或付费调用。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "officialMonitor.view",
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "x-usage-guide": {
          "purpose": "读取官网监控的参数、流程及回传约定。",
          "when": "首次接入该模块或协议更新后读取；执行中不必反复下载同一份说明。",
          "kind": "接入说明"
        },
        "operationId": "get_api_official_monitor_protocol"
      }
    },
    "/api/official-monitor/results": {
      "get": {
        "summary": "官网监控报告/日志",
        "description": "day为上海日期YYYY-MM-DD；view=bulletins读取有效内容，view=health读取正常/异常统计，省略view读取日志。",
        "responses": {
          "200": {
            "description": "成功；字段按实际接口返回。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "参数错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "未登录、凭证失效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "业务权限不足，或设备绑定/签名/重放/访问范围拒绝；响应code区分原因。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "不存在或未分配",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "版本冲突、重复或状态不允许",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常，写入结果需核实",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-required-permission": "officialMonitor.view",
        "parameters": [
          {
            "in": "query",
            "name": "day",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "in": "query",
            "name": "view",
            "schema": {
              "type": "string",
              "enum": [
                "bulletins",
                "health"
              ]
            }
          },
          {
            "in": "query",
            "name": "kind",
            "schema": {
              "type": "string",
              "enum": [
                "normal",
                "abnormal"
              ]
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "in": "header",
            "name": "X-API-Epoch",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Time",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          },
          {
            "in": "header",
            "name": "X-API-Nonce",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "仅加强签名模式需要；普通API Key不发送。"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          },
          {
            "bearerAuth": [],
            "deviceSignature": []
          }
        ],
        "x-usage-guide": {
          "purpose": "读取官网监控的播报内容及抓取日志。",
          "when": "查看今日更新、有效内容或受阻原因时使用。",
          "kind": "主要入口"
        },
        "operationId": "get_api_official_monitor_results"
      },
      "post": {
        "summary": "回传官网监控结果",
        "description": " 完整业务条件和结果字段读取 /api/official-monitor/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "officialMonitor.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/official-monitor/protocol",
        "x-usage-guide": {
          "purpose": "保存本次官网检查结果及逐入口证据。",
          "when": "外部扫描完成后回传；本接口本身不代替浏览官网。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_official_monitor_results"
      }
    },
    "/api/members/device/proof-info": {
      "get": {
        "summary": "获取当前设备签名参数",
        "security": [],
        "responses": {
          "200": {
            "description": "protocol,algorithm,serverEpoch,serverTime,maxSkewSeconds"
          }
        },
        "x-usage-guide": {
          "purpose": "获取当前设备签名参数。",
          "when": "签名设备凭据需要读取签名约定时使用；普通Bearer通常不需要。",
          "kind": "认证授权"
        },
        "operationId": "get_api_members_device_proof_info"
      }
    },
    "/api/members/portal-info": {
      "get": {
        "summary": "查询是否开放注册",
        "description": "",
        "security": [],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "x-usage-guide": {
          "purpose": "查询是否开放注册。",
          "when": "注册或接入页面判断当前是否允许注册时使用。",
          "kind": "认证授权"
        },
        "operationId": "get_api_members_portal_info"
      }
    },
    "/api/members/register": {
      "post": {
        "summary": "注册API用户",
        "description": "默认仅本人Key管理权限；管理员可配置新注册账号默认权限等级。输入中额外permissions/role不会被采纳。注册不会自动登录。",
        "security": [],
        "responses": {
          "201": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{2,63}$"
                  },
                  "name": {
                    "type": "string",
                    "maxLength": 100
                  },
                  "password": {
                    "type": "string",
                    "minLength": 12,
                    "maxLength": 128,
                    "format": "password"
                  }
                },
                "required": [
                  "username",
                  "name",
                  "password"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "注册API用户。",
          "when": "开放注册时创建新账号，不会自动获得全部业务权限。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_register"
      }
    },
    "/api/members/keys": {
      "get": {
        "summary": "列出本人Key元数据",
        "description": "仅用户中心Cookie。没有Key明文。管理员在此也只显示本人，原后台可管理其他会员。",
        "security": [
          {
            "connectCookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "x-usage-guide": {
          "purpose": "列出本人Key元数据。",
          "when": "查看和管理本人现有Key时使用，不返回完整历史密钥。",
          "kind": "认证授权"
        },
        "operationId": "get_api_members_keys"
      },
      "post": {
        "summary": "创建API Key",
        "description": "需tokens.create；最多10个有效Key。token只返回一次；长期有效，撤销/账号禁用/安全重置后失效。普通Key被复制也能用，选signed可防止只复制Key。",
        "security": [
          {
            "connectCookie": []
          }
        ],
        "responses": {
          "201": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "authMode": {
                    "type": "string",
                    "enum": [
                      "standard",
                      "signed"
                    ],
                    "default": "standard"
                  },
                  "publicKey": {
                    "type": "string",
                    "description": "仅signed模式必填，Ed25519 SPKI PEM"
                  },
                  "keyScope": {
                    "$ref": "#/components/schemas/KeyScope"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "创建API Key。",
          "when": "需要为客户端或网站签发新Key时使用；妥善保存新Key。",
          "kind": "认证授权"
        },
        "operationId": "post_api_members_keys"
      },
      "delete": {
        "summary": "撤销本人Key",
        "description": "需tokens.delete；不能撤销他人Key，Bearer不能管理密钥。",
        "security": [
          {
            "connectCookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "X-Member-Request",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "撤销本人Key。",
          "when": "设备丢失、Key泄漏或不再使用时立即撤销。",
          "kind": "认证授权"
        },
        "operationId": "delete_api_members_keys"
      },
      "put": {
        "summary": "修改自己的 Key 权限",
        "description": "仅浏览器登录会话；需 tokens.create；空scope可恢复沿用账号权限，permissions空数组表示无权限。",
        "security": [
          {
            "connectCookie": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScopeUpdate"
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改自己的 Key 权限。",
          "when": "调整已有Key的授权范围时使用，不能超出账号权限。",
          "kind": "认证授权"
        },
        "operationId": "put_api_members_keys"
      }
    },
    "/api/members/usage": {
      "get": {
        "summary": "本人Key调用统计和最近记录",
        "description": "UTC近31日期统计、每Key最近30条。含已识别Key的失败请求，非计费账单；后台异步持久化约1秒，异常宕机可能丢最后缓冲。",
        "security": [
          {
            "connectCookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "x-usage-guide": {
          "purpose": "本人Key调用统计和最近记录。",
          "when": "查看本人API调用量和最近记录时使用。",
          "kind": "认证授权"
        },
        "operationId": "get_api_members_usage"
      }
    },
    "/api/keyword-center/executions": {
      "post": {
        "summary": "创建任务中心执行并领取快照",
        "description": "需任务执行权限及任务分配。新执行使用storage_only，view=package返回任务原文及回传协议。保存runKey，未知结果先查原执行，不能新建重复运行。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "taskIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 1
                  },
                  "taskName": {
                    "type": "string"
                  },
                  "executor": {
                    "type": "string"
                  },
                  "runKey": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                "required": [
                  "taskIds",
                  "taskName",
                  "runKey"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "in": "query",
            "name": "view",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "package"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "创建任务执行记录并取得执行资料快照。",
          "when": "开始执行已有任务时使用；不是直接让服务器自动完成全部任务。",
          "kind": "主要入口"
        },
        "operationId": "post_api_keyword_center_executions"
      }
    },
    "/api/keyword-center/keywords/{taskId}": {
      "get": {
        "summary": "读取指定任务及执行要求",
        "description": "需要对应模块权限和已分配范围。后续回传字段以该任务返回的具体协议为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "view",
            "schema": {
              "type": "string",
              "enum": [
                "execution"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取指定任务的内容、规则和配置。",
          "when": "选择任务后了解需要做什么，或按协议领取资料时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_keyword_center_keywords_taskId"
      }
    },
    "/api/keyword-center/executions/{executionId}": {
      "get": {
        "summary": "读取执行回执或实时回传协议",
        "description": "需要对应模块权限和已分配范围。后续回传字段以该任务返回的具体协议为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "executionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "view",
            "schema": {
              "type": "string",
              "enum": [
                "receipt",
                "protocol"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取已有执行的进度、回执及回传协议。",
          "when": "恢复中断执行或核查结果时使用，避免重建执行。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_keyword_center_executions_executionId"
      },
      "put": {
        "summary": "更新执行终态",
        "description": " 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "executionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "更新已有执行的最终状态。",
          "when": "执行实际完成、失败或停止后，按协议收尾时使用。",
          "kind": "辅助接口"
        },
        "operationId": "put_api_keyword_center_executions_executionId"
      }
    },
    "/api/tool-library/tasks/{taskId}/requirements": {
      "get": {
        "summary": "读取工具任务的领取与回传要求",
        "description": "需要对应模块权限和已分配范围。后续回传字段以该任务返回的具体协议为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_tool_library_tasks_taskId_requirements"
      }
    },
    "/api/topic-tasks/{taskId}/requirements": {
      "get": {
        "summary": "读取专题任务的领取与回传要求",
        "description": "需要对应模块权限和已分配范围。后续回传字段以该任务返回的具体协议为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_topic_tasks_taskId_requirements"
      }
    },
    "/api/websites/{websiteId}/report-tasks/{taskId}/requirements": {
      "get": {
        "summary": "读取网站汇报任务的领取与回传要求",
        "description": "需要对应模块权限和已分配范围。后续回传字段以该任务返回的具体协议为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功"
          },
          "400": {
            "description": "参数格式错误"
          },
          "401": {
            "description": "登录或Key失效"
          },
          "403": {
            "description": "无权限"
          },
          "409": {
            "description": "账号重复、版本或状态冲突"
          },
          "429": {
            "description": "请求频率超过限额"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "websiteId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_websites_websiteId_report_tasks_taskId_requirements"
      }
    },
    "/api/styles/{id}": {
      "get": {
        "summary": "风格库详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "styles.view",
        "x-usage-guide": {
          "purpose": "读取指定风格库的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_styles_id"
      },
      "put": {
        "summary": "风格库修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "styles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定风格库记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_styles_id"
      },
      "delete": {
        "summary": "风格库删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "styles.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定风格库记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_styles_id"
      }
    },
    "/api/mining/keywords/{id}": {
      "get": {
        "summary": "核心词详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "core.view",
        "x-usage-guide": {
          "purpose": "读取指定核心词的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_keywords_id"
      },
      "put": {
        "summary": "核心词修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "core.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定核心词记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_mining_keywords_id"
      },
      "delete": {
        "summary": "核心词删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "core.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定核心词记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_mining_keywords_id"
      }
    },
    "/api/mining/adverbs/{id}": {
      "get": {
        "summary": "副词详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "adverbs.view",
        "x-usage-guide": {
          "purpose": "读取指定副词的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_adverbs_id"
      },
      "put": {
        "summary": "副词修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "adverbs.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定副词记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_mining_adverbs_id"
      },
      "delete": {
        "summary": "副词删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "adverbs.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定副词记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_mining_adverbs_id"
      }
    },
    "/api/alixixi-topic-library/apps": {
      "get": {
        "summary": "alixixi.com 相关软件和应用列表",
        "description": "按名称、别名、包名或说明搜索，可按分类筛选。返回 items 和 hasNext。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "default": 1
            },
            "description": "页码，每页最多20条"
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "名称、别名、包名或说明"
          },
          {
            "name": "category",
            "in": "query",
            "description": "精确匹配分类，省略返回全部分类",
            "schema": {
              "type": "string",
              "enum": [
                "软件 / 应用",
                "编程语言",
                "框架 / 库",
                "开发工具 / 运行时",
                "语言功能 / API"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.view",
        "x-usage-guide": {
          "purpose": "alixixi.com 相关软件和应用列表",
          "when": "按名称、别名、包名或说明搜索，可按分类筛选。返回 items 和 hasNext。",
          "kind": "资料管理"
        },
        "operationId": "get_api_alixixi_topic_library_apps"
      },
      "post": {
        "summary": "新增 alixixi.com 来源应用",
        "description": "登记 JavaScript 相关软件、语言、框架或工具。会员还须有 topics.view。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "201": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.create",
        "x-usage-guide": {
          "purpose": "新增 alixixi.com 来源应用",
          "when": "登记 JavaScript 相关软件、语言、框架或工具。会员还须有 topics.view。",
          "kind": "资料管理"
        },
        "operationId": "post_api_alixixi_topic_library_apps",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "category": {
                    "type": "string",
                    "enum": [
                      "软件 / 应用",
                      "编程语言",
                      "框架 / 库",
                      "开发工具 / 运行时",
                      "语言功能 / API"
                    ]
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 500
                  }
                },
                "required": [
                  "name",
                  "category"
                ]
              }
            }
          }
        }
      }
    },
    "/api/alixixi-topic-library/apps/{id}": {
      "put": {
        "summary": "编辑 alixixi.com 来源应用",
        "description": "提交当前 revision 和最新名称、分类及说明。会员还须有 topics.view。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.edit",
        "x-usage-guide": {
          "purpose": "编辑 alixixi.com 来源应用",
          "when": "提交当前 revision 和最新名称、分类及说明。会员还须有 topics.view。",
          "kind": "资料管理"
        },
        "operationId": "put_api_alixixi_topic_library_apps_id",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "category": {
                    "type": "string",
                    "enum": [
                      "软件 / 应用",
                      "编程语言",
                      "框架 / 库",
                      "开发工具 / 运行时",
                      "语言功能 / API"
                    ]
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "revision": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": [
                  "name",
                  "category",
                  "revision"
                ]
              }
            }
          }
        }
      },
      "delete": {
        "summary": "删除 alixixi.com 来源应用",
        "description": "仅可删除没有关联长尾词的应用。会员还须有 topics.view。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.delete",
        "x-usage-guide": {
          "purpose": "删除 alixixi.com 来源应用",
          "when": "仅可删除没有关联长尾词的应用。会员还须有 topics.view。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_alixixi_topic_library_apps_id",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "revision": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": [
                  "revision"
                ]
              }
            }
          }
        }
      }
    },
    "/api/alixixi-topic-library/keywords": {
      "get": {
        "summary": "alixixi.com 长尾词列表",
        "description": "按长尾词或来源名称搜索，可指定来源。返回 items、hasNext 和选中的 app。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "default": 1
            },
            "description": "页码，每页最多20条"
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "搜索名称、长尾词或来源名称"
          },
          {
            "name": "appId",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "按来源应用筛选"
          }
        ],
        "responses": {
          "200": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.view",
        "x-usage-guide": {
          "purpose": "alixixi.com 长尾词列表",
          "when": "按长尾词或来源名称搜索，可指定来源。返回 items、hasNext 和选中的 app。",
          "kind": "资料管理"
        },
        "operationId": "get_api_alixixi_topic_library_keywords"
      },
      "post": {
        "summary": "批量录入 alixixi.com 长尾词",
        "description": "单批最多 300 个词。同一来源重复词跳过，其他来源独立保留。返回 added、duplicates。会员还须有 topics.view。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "201": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.create",
        "x-usage-guide": {
          "purpose": "批量录入 alixixi.com 长尾词",
          "when": "单批最多 300 个词。同一来源重复词跳过，其他来源独立保留。返回 added、duplicates。会员还须有 topics.view。",
          "kind": "资料管理"
        },
        "operationId": "post_api_alixixi_topic_library_keywords",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "appId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "keywords": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 300,
                    "items": {
                      "type": "string",
                      "maxLength": 200
                    }
                  }
                },
                "required": [
                  "appId",
                  "keywords"
                ]
              }
            }
          }
        }
      }
    },
    "/api/alixixi-topic-library/keywords/{id}": {
      "delete": {
        "summary": "删除 alixixi.com 长尾词来源记录",
        "description": "按记录 ID 删除该词在单个来源下的记录。会员还须有 topics.view。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "操作成功"
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "请先认证"
          },
          "403": {
            "description": "账号或 Key 权限不足"
          },
          "404": {
            "description": "记录不存在"
          },
          "409": {
            "description": "名称重复、版本冲突或存在关联"
          }
        },
        "x-required-permission": "topics.delete",
        "x-usage-guide": {
          "purpose": "删除 alixixi.com 长尾词来源记录",
          "when": "按记录 ID 删除该词在单个来源下的记录。会员还须有 topics.view。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_alixixi_topic_library_keywords_id",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        }
      }
    },
    "/api/mining/topics": {
      "get": {
        "summary": "专题词列表",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topics.view",
        "x-usage-guide": {
          "purpose": "查询专题词清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_topics"
      },
      "post": {
        "summary": "专题词新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topics.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增专题词记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_mining_topics"
      }
    },
    "/api/mining/topics/{id}": {
      "get": {
        "summary": "专题词详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topics.view",
        "x-usage-guide": {
          "purpose": "读取指定专题词的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_topics_id"
      },
      "put": {
        "summary": "专题词修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topics.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定专题词记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_mining_topics_id"
      },
      "delete": {
        "summary": "专题词删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topics.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定专题词记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_mining_topics_id"
      }
    },
    "/api/title-library/{id}": {
      "get": {
        "summary": "标题库详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.view",
        "x-usage-guide": {
          "purpose": "读取指定标题库的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_title_library_id"
      },
      "put": {
        "summary": "标题库修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定标题库记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_title_library_id"
      },
      "delete": {
        "summary": "标题库删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定标题库记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_title_library_id"
      }
    },
    "/api/title-keywords/{id}": {
      "get": {
        "summary": "标题词详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titleKeywords.view",
        "x-usage-guide": {
          "purpose": "读取指定标题词的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_title_keywords_id"
      },
      "put": {
        "summary": "标题词修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titleKeywords.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定标题词记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_title_keywords_id"
      },
      "delete": {
        "summary": "标题词删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titleKeywords.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定标题词记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_title_keywords_id"
      }
    },
    "/api/mining/data-sources/{id}": {
      "get": {
        "summary": "数据源详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "dataSources.view",
        "x-usage-guide": {
          "purpose": "读取指定数据源的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_mining_data_sources_id"
      },
      "put": {
        "summary": "数据源修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "dataSources.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定数据源记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_mining_data_sources_id"
      },
      "delete": {
        "summary": "数据源删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "dataSources.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定数据源记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_mining_data_sources_id"
      }
    },
    "/api/websites/{id}": {
      "get": {
        "summary": "网站详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websites.view",
        "x-usage-guide": {
          "purpose": "读取指定网站的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_websites_id"
      },
      "put": {
        "summary": "网站修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websites.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定网站记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_websites_id"
      },
      "delete": {
        "summary": "网站删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websites.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定网站记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_websites_id"
      }
    },
    "/api/publish-apis/{id}": {
      "get": {
        "summary": "发布接口详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "publishApis.view",
        "x-usage-guide": {
          "purpose": "读取指定发布接口的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_publish_apis_id"
      },
      "put": {
        "summary": "发布接口修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "publishApis.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定发布接口记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_publish_apis_id"
      },
      "delete": {
        "summary": "发布接口删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "publishApis.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定发布接口记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_publish_apis_id"
      }
    },
    "/api/tool-library/tools/{id}": {
      "get": {
        "summary": "工具详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tools.view",
        "x-usage-guide": {
          "purpose": "读取指定工具的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tools_id"
      },
      "put": {
        "summary": "工具修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tools.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定工具记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_tool_library_tools_id"
      },
      "delete": {
        "summary": "工具删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tools.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定工具记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_tool_library_tools_id"
      }
    },
    "/api/tool-library/tags": {
      "get": {
        "summary": "工具标签列表",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTags.view",
        "x-usage-guide": {
          "purpose": "查询工具标签清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tags"
      },
      "post": {
        "summary": "工具标签新增",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTags.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增工具标签记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_tool_library_tags"
      }
    },
    "/api/tool-library/tags/{id}": {
      "get": {
        "summary": "工具标签详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTags.view",
        "x-usage-guide": {
          "purpose": "读取指定工具标签的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tags_id"
      },
      "put": {
        "summary": "工具标签修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTags.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定工具标签记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_tool_library_tags_id"
      },
      "delete": {
        "summary": "工具标签删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTags.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定工具标签记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_tool_library_tags_id"
      }
    },
    "/api/tool-library/tasks/{id}": {
      "get": {
        "summary": "工具任务详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.view",
        "x-usage-guide": {
          "purpose": "读取指定工具任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_tool_library_tasks_id"
      },
      "put": {
        "summary": "工具任务修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定工具任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_tool_library_tasks_id"
      },
      "delete": {
        "summary": "工具任务删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定工具任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_tool_library_tasks_id"
      }
    },
    "/api/topic-tasks/{id}": {
      "get": {
        "summary": "专题任务详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.view",
        "x-usage-guide": {
          "purpose": "读取指定专题任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_topic_tasks_id"
      },
      "put": {
        "summary": "专题任务修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定专题任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_topic_tasks_id"
      },
      "delete": {
        "summary": "专题任务删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定专题任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_topic_tasks_id"
      }
    },
    "/api/lark-bots/{id}": {
      "get": {
        "summary": "Lark机器人详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkBots.view",
        "x-usage-guide": {
          "purpose": "读取指定Lark机器人的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_lark_bots_id"
      },
      "put": {
        "summary": "Lark机器人修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkBots.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定Lark机器人记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_lark_bots_id"
      },
      "delete": {
        "summary": "Lark机器人删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkBots.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定Lark机器人记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_lark_bots_id"
      }
    },
    "/api/video-articles/sources/{id}": {
      "get": {
        "summary": "视频来源详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.view",
        "x-usage-guide": {
          "purpose": "读取指定视频来源的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_sources_id"
      },
      "put": {
        "summary": "视频来源修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频来源记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_sources_id"
      },
      "delete": {
        "summary": "视频来源删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频来源记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_sources_id"
      }
    },
    "/api/video-articles/updates/{id}": {
      "get": {
        "summary": "视频动态详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.view",
        "x-usage-guide": {
          "purpose": "读取指定视频动态的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_updates_id"
      },
      "put": {
        "summary": "视频动态修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频动态记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_updates_id"
      },
      "delete": {
        "summary": "视频动态删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频动态记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_updates_id"
      }
    },
    "/api/video-articles/articles/{id}": {
      "get": {
        "summary": "视频文章详情",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.view",
        "x-usage-guide": {
          "purpose": "读取指定视频文章的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_articles_id"
      },
      "put": {
        "summary": "视频文章修改",
        "description": "保存前读取详情的revision；只提交需要修改的字段，按接口校验。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频文章记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_articles_id"
      },
      "delete": {
        "summary": "视频文章删除",
        "description": "沿用模块实际数据结构；未授权的资源不会因API接入而开放。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频文章记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_articles_id"
      }
    },
    "/api/tool-library/tasks/{taskId}/claim": {
      "post": {
        "summary": "工具任务：claim",
        "description": " 完整业务条件和结果字段读取 /api/tool-library/tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "领取工具或模板任务并取得本次执行凭据。",
          "when": "准备执行指定任务时使用，先读requirements，勿重复领取。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_tasks_taskId_claim"
      }
    },
    "/api/tool-library/tasks/{taskId}/renew": {
      "post": {
        "summary": "工具任务：renew",
        "description": " 完整业务条件和结果字段读取 /api/tool-library/tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "按对应任务协议续期既有领取。",
          "when": "仅旧协议或明确需要续期的任务使用；新存储模式通常不需定时续期。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_tasks_taskId_renew"
      }
    },
    "/api/tool-library/tasks/{taskId}/result": {
      "post": {
        "summary": "工具任务：result",
        "description": " 完整业务条件和结果字段读取 /api/tool-library/tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "登记工具或模板任务的执行结果。",
          "when": "本地执行完成后回传；模板仍须按协议人工审核，不代表已发布。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_tasks_taskId_result"
      }
    },
    "/api/tool-library/tasks/{taskId}/source": {
      "post": {
        "summary": "工具任务：source",
        "description": " 完整业务条件和结果字段读取 /api/tool-library/tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "上传工具任务的源码内容。",
          "when": "工具开发完成、按领取协议保存源码版本时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_tasks_taskId_source"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/requirements": {
      "get": {
        "summary": "网站模板：requirements",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_tool_library_site_sync_template_tasks_taskId_requirements"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/claim": {
      "post": {
        "summary": "网站模板：claim",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "领取工具或模板任务并取得本次执行凭据。",
          "when": "准备执行指定任务时使用，先读requirements，勿重复领取。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_template_tasks_taskId_claim"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/renew": {
      "post": {
        "summary": "网站模板：renew",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "按对应任务协议续期既有领取。",
          "when": "仅旧协议或明确需要续期的任务使用；新存储模式通常不需定时续期。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_template_tasks_taskId_renew"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/result": {
      "post": {
        "summary": "网站模板：result",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "登记工具或模板任务的执行结果。",
          "when": "本地执行完成后回传；模板仍须按协议人工审核，不代表已发布。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_template_tasks_taskId_result"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/approve-local": {
      "post": {
        "summary": "网站模板：approve-local",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolSites.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "登记用户对本地模板的审核通过。",
          "when": "用户实际看过预览并明确同意后使用，执行器不能自行批准。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_template_tasks_taskId_approve_local"
      }
    },
    "/api/tool-library/site-sync/template-tasks/{taskId}/upload": {
      "post": {
        "summary": "网站模板：upload",
        "description": "approve-local必须由用户明确批准对应源码hash；API Key不能替用户自批。 完整业务条件和结果字段读取 /api/tool-library/site-sync/template-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/tool-library/site-sync/template-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "上传已审核的模板源码包。",
          "when": "模板已获人工通过且包哈希一致时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_template_tasks_taskId_upload"
      }
    },
    "/api/topic-tasks/{taskId}/results": {
      "post": {
        "summary": "专题任务：results",
        "description": " 完整业务条件和结果字段读取 /api/topic-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/topic-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "保存专题任务执行结果。",
          "when": "外部执行器完成专题任务后回传，保留结果与证据。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_topic_tasks_taskId_results"
      }
    },
    "/api/topic-tasks/{taskId}/count-batches": {
      "post": {
        "summary": "专题任务：count-batches",
        "description": " 完整业务条件和结果字段读取 /api/topic-tasks/{taskId}/requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "topicTasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/topic-tasks/{taskId}/requirements",
        "x-usage-guide": {
          "purpose": "分批记录专题与网站文章匹配数量。",
          "when": "已按任务条件查询完一批专题数量，需要保存统计结果时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_topic_tasks_taskId_count_batches"
      }
    },
    "/api/websites/{websiteId}/report-tasks": {
      "get": {
        "summary": "网站汇报任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.view",
        "x-usage-guide": {
          "purpose": "查询网站汇报任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_websites_websiteId_report_tasks"
      },
      "post": {
        "summary": "网站汇报任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增网站汇报任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_websites_websiteId_report_tasks"
      }
    },
    "/api/websites/{websiteId}/report-tasks/{taskId}": {
      "get": {
        "summary": "网站汇报任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.view",
        "x-usage-guide": {
          "purpose": "读取指定网站汇报任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_websites_websiteId_report_tasks_taskId"
      },
      "put": {
        "summary": "网站汇报任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定网站汇报任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_websites_websiteId_report_tasks_taskId"
      },
      "delete": {
        "summary": "网站汇报任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定网站汇报任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_websites_websiteId_report_tasks_taskId"
      }
    },
    "/api/websites/{websiteId}/report-tasks/{taskId}/runs": {
      "post": {
        "summary": "领取汇报资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Run"
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "领取汇报资料。",
          "when": "汇报执行开始时领取资料。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_websites_websiteId_report_tasks_taskId_runs"
      },
      "get": {
        "summary": "恢复汇报执行",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.execute",
        "x-usage-guide": {
          "purpose": "恢复汇报执行。",
          "when": "恢复已有汇报运行时查询，避免重复领取。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_websites_websiteId_report_tasks_taskId_runs"
      }
    },
    "/api/websites/{websiteId}/report-tasks/{taskId}/results": {
      "post": {
        "summary": "回传汇报结果（不发送消息）",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "websiteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "websiteReports.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportResult"
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "回传汇报结果（不发送消息）。",
          "when": "完成报告后保存回执；向Lark发送仍需调用发送接口。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_websites_websiteId_report_tasks_taskId_results"
      }
    },
    "/api/video-articles/tasks/sources": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.view",
        "x-usage-guide": {
          "purpose": "查询视频来源扫描任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_sources"
      },
      "post": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频来源扫描任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_tasks_sources"
      }
    },
    "/api/video-articles/tasks/sources/{taskId}": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.view",
        "x-usage-guide": {
          "purpose": "读取指定视频来源扫描任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_sources_taskId"
      },
      "put": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频来源扫描任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_tasks_sources_taskId"
      },
      "delete": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频来源扫描任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_tasks_sources_taskId"
      }
    },
    "/api/video-articles/tasks/sources/{taskId}/requirements": {
      "get": {
        "summary": "读取视频任务规范",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.view",
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_video_articles_tasks_sources_taskId_requirements"
      }
    },
    "/api/video-articles/tasks/updates": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.view",
        "x-usage-guide": {
          "purpose": "查询视频更新处理任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_updates"
      },
      "post": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频更新处理任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_tasks_updates"
      }
    },
    "/api/video-articles/tasks/updates/{taskId}": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.view",
        "x-usage-guide": {
          "purpose": "读取指定视频更新处理任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_updates_taskId"
      },
      "put": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频更新处理任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_tasks_updates_taskId"
      },
      "delete": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频更新处理任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_tasks_updates_taskId"
      }
    },
    "/api/video-articles/tasks/updates/{taskId}/requirements": {
      "get": {
        "summary": "读取视频任务规范",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoUpdates.view",
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_video_articles_tasks_updates_taskId_requirements"
      }
    },
    "/api/video-articles/tasks/articles": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.view",
        "x-usage-guide": {
          "purpose": "查询视频文章生成任务清单及可用记录。",
          "when": "需要查找、筛选或选择记录时使用；数据较多时按接口分页读取。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_articles"
      },
      "post": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增视频文章生成任务记录。",
          "when": "需要建立新的资料或任务时使用；保存记录不等于自动执行或发布。",
          "kind": "资料管理"
        },
        "operationId": "post_api_video_articles_tasks_articles"
      }
    },
    "/api/video-articles/tasks/articles/{taskId}": {
      "get": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.view",
        "x-usage-guide": {
          "purpose": "读取指定视频文章生成任务的详情。",
          "when": "需要核对、编辑或执行该条记录之前使用。",
          "kind": "资料管理"
        },
        "operationId": "get_api_video_articles_tasks_articles_taskId"
      },
      "put": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改指定视频文章生成任务记录。",
          "when": "已有资料或任务配置需要调整时使用；按接口提交当前版本。",
          "kind": "资料管理"
        },
        "operationId": "put_api_video_articles_tasks_articles_taskId"
      },
      "delete": {
        "summary": "视频任务管理",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "删除指定视频文章生成任务记录。",
          "when": "确认该条记录不再需要时使用，按模块规则处理历史引用。",
          "kind": "资料管理"
        },
        "operationId": "delete_api_video_articles_tasks_articles_taskId"
      }
    },
    "/api/video-articles/tasks/articles/{taskId}/requirements": {
      "get": {
        "summary": "读取视频任务规范",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.view",
        "x-usage-guide": {
          "purpose": "读取指定任务的完整要求、资料及领取回传方式。",
          "when": "执行该任务之前获取一次，后续按本次任务协议完成处理。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_video_articles_tasks_articles_taskId_requirements"
      }
    },
    "/api/video-articles/sources/{id}/check": {
      "post": {
        "summary": "视频检查领取/回传",
        "description": " 完整业务条件和结果字段读取 /api/video-articles/updates/{id}/task-requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoSources.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/video-articles/updates/{id}/task-requirements",
        "x-usage-guide": {
          "purpose": "领取或回传视频来源检查结果。",
          "when": "按视频检查任务协议，发现新视频或记录检查结果时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_video_articles_sources_id_check"
      }
    },
    "/api/video-articles/updates/{id}/generation": {
      "post": {
        "summary": "视频文章领取/回传",
        "description": " 完整业务条件和结果字段读取 /api/video-articles/updates/{id}/task-requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.generate",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/video-articles/updates/{id}/task-requirements",
        "x-usage-guide": {
          "purpose": "领取视频动态生成工作或回传生成结果。",
          "when": "将已发现的视频动态转为文章时，按协议使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_video_articles_updates_id_generation"
      }
    },
    "/api/video-articles/updates/{id}/frames": {
      "post": {
        "summary": "上传真实配图",
        "description": " 完整业务条件和结果字段读取 /api/video-articles/updates/{id}/task-requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.generate",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/video-articles/updates/{id}/task-requirements",
        "x-usage-guide": {
          "purpose": "上传视频文章所需的真实帧图。",
          "when": "已取得可用截图，需要保存到对应动态时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_video_articles_updates_id_frames"
      }
    },
    "/api/video-articles/articles/{id}/publication": {
      "post": {
        "summary": "登记发布结果",
        "description": " 完整业务条件和结果字段读取 /api/video-articles/updates/{id}/task-requirements。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "videoArticles.publish",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericResult"
              }
            }
          }
        },
        "x-runtime-contract": "/api/video-articles/updates/{id}/task-requirements",
        "x-usage-guide": {
          "purpose": "登记视频文章的实际发布结果。",
          "when": "目标站发布后获得回执时使用，不是自动发布按钮。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_video_articles_articles_id_publication"
      }
    },
    "/api/twitterapis/search": {
      "post": {
        "summary": "查询 X 内容（可能产生费用）",
        "description": " 完整业务条件和结果字段读取 /api/twitterapis/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "twitterApis.query",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/XSearch"
              }
            }
          }
        },
        "x-runtime-contract": "/api/twitterapis/protocol",
        "x-usage-guide": {
          "purpose": "按搜索条件查询X推文。",
          "when": "采集近期讨论、指定账号或关键词内容时使用，可能产生供应商费用。",
          "kind": "主要入口"
        },
        "operationId": "post_api_twitterapis_search"
      }
    },
    "/api/twitterapis/usage": {
      "get": {
        "summary": "查看 X 调用记录",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "twitterApis.view",
        "x-usage-guide": {
          "purpose": "查看X采集调用记录和系统计量。",
          "when": "核查查询频率、失败与缓存情况时使用，不等同供应商账单。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_twitterapis_usage"
      }
    },
    "/api/baidu-tongji/bindings/{id}/data": {
      "get": {
        "summary": "查询百度统计",
        "description": "查询参数method、start_date、end_date、metrics与分页按protocol；IP筛选统计须遍历hasMore直到false。 完整业务条件和结果字段读取 /api/baidu-tongji/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "baiduTongji.query",
        "x-runtime-contract": "/api/baidu-tongji/protocol",
        "x-usage-guide": {
          "purpose": "读取已授权网站的百度统计报表。",
          "when": "生成流量报告、获取访问页面等统计时使用；按报表类型和分页参数调用。",
          "kind": "主要入口"
        },
        "operationId": "get_api_baidu_tongji_bindings_id_data"
      }
    },
    "/api/lark-bots/{id}/send": {
      "post": {
        "summary": "发送 Lark 消息",
        "description": "必须明确授权发送；相同requestId重放不得重复发送，unknown先核实。可附reportIds。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkBots.notify",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "通过指定机器人向Lark群发送消息，可附报告链接。",
          "when": "报告整理好且已获发送授权后使用；这是实际对外发送。",
          "kind": "主要入口"
        },
        "operationId": "post_api_lark_bots_id_send"
      }
    },
    "/api/lark-reports/uploads": {
      "post": {
        "summary": "Lark报告存储",
        "description": " 完整业务条件和结果字段读取 /api/lark-reports/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkReports.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-runtime-contract": "/api/lark-reports/protocol",
        "x-usage-guide": {
          "purpose": "创建报告文件上传记录。",
          "when": "准备存储详细报告、生成可分享链接时先调用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_lark_reports_uploads"
      }
    },
    "/api/lark-reports/uploads/{id}/chunks": {
      "put": {
        "summary": "Lark报告存储",
        "description": " 完整业务条件和结果字段读取 /api/lark-reports/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkReports.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-runtime-contract": "/api/lark-reports/protocol",
        "x-usage-guide": {
          "purpose": "上传报告文件分块。",
          "when": "已拿到上传ID，按分块协议传输文件内容时使用。",
          "kind": "辅助接口"
        },
        "operationId": "put_api_lark_reports_uploads_id_chunks"
      }
    },
    "/api/lark-reports/uploads/{id}/complete": {
      "post": {
        "summary": "Lark报告存储",
        "description": " 完整业务条件和结果字段读取 /api/lark-reports/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkReports.create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-runtime-contract": "/api/lark-reports/protocol",
        "x-usage-guide": {
          "purpose": "完成报告上传并生成报告读取链接。",
          "when": "全部分块上传成功后使用；不会自动发Lark消息。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_lark_reports_uploads_id_complete"
      }
    },
    "/api/lark-reports": {
      "get": {
        "summary": "Lark报告存储",
        "description": " 完整业务条件和结果字段读取 /api/lark-reports/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkReports.view",
        "x-runtime-contract": "/api/lark-reports/protocol",
        "x-usage-guide": {
          "purpose": "列出本人可查看的已存报告。",
          "when": "选择历史报告或查找报告链接时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_lark_reports"
      }
    },
    "/api/lark-reports/{id}": {
      "delete": {
        "summary": "Lark报告存储",
        "description": " 完整业务条件和结果字段读取 /api/lark-reports/protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "larkReports.delete",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-runtime-contract": "/api/lark-reports/protocol",
        "x-usage-guide": {
          "purpose": "删除报告并撤销其公开读取链接。",
          "when": "报告不再需要或应停止分享时使用。",
          "kind": "辅助接口"
        },
        "operationId": "delete_api_lark_reports_id"
      }
    },
    "/api/keyword-sites/{id}/preview": {
      "get": {
        "summary": "独立站：preview",
        "description": "发布、下线、审核和域名配置需独立权限及明确授权。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "sites.view",
        "x-usage-guide": {
          "purpose": "独立站：查看待发布内容的预览。",
          "when": "正式发布前检查页面、样式和内容时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_keyword_sites_id_preview"
      }
    },
    "/api/keyword-sites/{id}/publish": {
      "post": {
        "summary": "独立站：publish",
        "description": "发布、下线、审核和域名配置需独立权限及明确授权。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "sites.publish",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "独立站：把已准备好的内容发布到目标网站。",
          "when": "确认目标、内容和版本后使用，会实际改变线上网站。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_keyword_sites_id_publish"
      }
    },
    "/api/keyword-sites/{id}/unpublish": {
      "post": {
        "summary": "独立站：unpublish",
        "description": "发布、下线、审核和域名配置需独立权限及明确授权。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "sites.unpublish",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "独立站：下线已发布的独立站。",
          "when": "明确需要停止该站对外访问时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_keyword_sites_id_unpublish"
      }
    },
    "/api/keyword-sites/{id}/complete-review": {
      "post": {
        "summary": "独立站：complete-review",
        "description": "发布、下线、审核和域名配置需独立权限及明确授权。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "sites.review",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "独立站：登记独立站审核结果。",
          "when": "按站点审核流程完成检查后使用，不冒充审核通过。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_keyword_sites_id_complete_review"
      }
    },
    "/api/keyword-sites/{id}/sync-domain": {
      "post": {
        "summary": "独立站：sync-domain",
        "description": "发布、下线、审核和域名配置需独立权限及明确授权。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "sites.configure",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "独立站：同步独立站的域名配置。",
          "when": "域名设置变更后按发布流程同步时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_keyword_sites_id_sync_domain"
      }
    },
    "/api/title-library/generation-status": {
      "put": {
        "summary": "批量手动生成状态",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "items",
                  "status"
                ],
                "properties": {
                  "items": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 100,
                    "items": {
                      "type": "object",
                      "required": [
                        "id",
                        "revision"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "revision": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "generated",
                      "never",
                      "auto"
                    ]
                  }
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "批量手动标记标题是否生成过文章。",
          "when": "通过其他方式写过文章，需要修正标题库状态时使用。",
          "kind": "配置管理"
        },
        "operationId": "put_api_title_library_generation_status"
      }
    },
    "/api/title-library/generation-spec": {
      "put": {
        "summary": "保存标题任务规范",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "titles.edit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "content",
                  "revision"
                ],
                "properties": {
                  "content": {
                    "type": "string"
                  },
                  "revision": {
                    "type": "integer"
                  }
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "保存供其他Codex使用的标题生成规范。",
          "when": "调整选题范围、标题要求或专题词要求时使用，不会生成标题。",
          "kind": "配置管理"
        },
        "operationId": "put_api_title_library_generation_spec"
      }
    },
    "/api/task-claims": {
      "post": {
        "summary": "领取任务数据",
        "description": " 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "taskId",
                  "runId",
                  "resourceType",
                  "resourceId"
                ],
                "properties": {
                  "taskId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "runId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "resourceType": {
                    "type": "string"
                  },
                  "resourceId": {
                    "type": "string",
                    "format": "uuid"
                  }
                }
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "领取本次任务需要处理的数据并防止重复占用。",
          "when": "正式处理标题或关键词前使用，沿用当前execution。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_task_claims"
      }
    },
    "/api/task-claims/{claimId}/release": {
      "post": {
        "summary": "恢复或结束数据领取",
        "description": " 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "claimId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "runId",
                  "claimToken"
                ],
                "properties": {
                  "runId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "claimToken": {
                    "type": "string"
                  },
                  "outcome": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "释放未完成的数据占用。",
          "when": "决定放弃本次领取、允许后续执行重新处理时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_task_claims_claimId_release"
      }
    },
    "/api/task-claims/{claimId}/complete": {
      "post": {
        "summary": "恢复或结束数据领取",
        "description": " 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "claimId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "runId",
                  "claimToken"
                ],
                "properties": {
                  "runId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "claimToken": {
                    "type": "string"
                  },
                  "outcome": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "登记本次数据领取处理完成。",
          "when": "结果按协议保存成功后使用；不要把尚未入库的草稿标记完成。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_task_claims_claimId_complete"
      }
    },
    "/api/task-claims/{claimId}/renew": {
      "post": {
        "summary": "恢复或结束数据领取",
        "description": " 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "claimId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "tasks.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "runId",
                  "claimToken"
                ],
                "properties": {
                  "runId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "claimToken": {
                    "type": "string"
                  },
                  "outcome": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "按领取协议续期数据占用。",
          "when": "仅对应执行协议要求续期时使用，新存储模式通常不需要。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_task_claims_claimId_renew"
      }
    },
    "/api/title-library/{titleId}/article-events": {
      "get": {
        "summary": "读取文章生成和发布事件",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "titleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "events.view",
        "x-usage-guide": {
          "purpose": "查看该标题已有的文章生成及发布事件。",
          "when": "生成前核查是否处理过，或发现两端状态不一致时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_title_library_titleId_article_events"
      },
      "post": {
        "summary": "回传文章结果（不发布外站）",
        "description": "generated须真实正文产物；published须真实外站成功回执；不得编造时间、ID或成功状态。 完整业务条件和结果字段读取 /api/keyword-center/executions/{executionId}?view=protocol。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "titleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "events.create/events.publish按eventType",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "eventKey",
                  "eventType",
                  "generationId",
                  "taskId",
                  "runId",
                  "claimId",
                  "claimToken"
                ],
                "properties": {
                  "eventKey": {
                    "type": "string"
                  },
                  "eventType": {
                    "type": "string",
                    "enum": [
                      "generated",
                      "published",
                      "discarded"
                    ]
                  },
                  "generationId": {
                    "type": "string"
                  },
                  "taskId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "runId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "runKey": {
                    "type": "string"
                  },
                  "claimId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "claimToken": {
                    "type": "string"
                  },
                  "occurredAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "executor": {
                    "type": "string"
                  },
                  "articleTitle": {
                    "type": "string"
                  },
                  "artifactRef": {
                    "type": "string"
                  },
                  "domain": {
                    "type": "string"
                  },
                  "articleUrl": {
                    "type": "string"
                  },
                  "externalArticleId": {
                    "type": "string"
                  },
                  "publishApiId": {
                    "type": "string"
                  },
                  "receipt": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "x-runtime-contract": "/api/keyword-center/executions/{executionId}?view=protocol",
        "x-usage-guide": {
          "purpose": "回传文章生成或外站发布的真实结果。",
          "when": "文章已生成或已获得目标站回执后登记；本接口不会替你发布外站。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_title_library_titleId_article_events"
      }
    },
    "/api/test-development/qwen/config": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "testDevelopment.view",
        "x-usage-guide": {
          "purpose": "查看千问图片服务配置状态。",
          "when": "检查生图服务是否就绪时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_test_development_qwen_config"
      }
    },
    "/api/paid-mining": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.view",
        "x-usage-guide": {
          "purpose": "查看可用的付费采集服务。",
          "when": "选择数据采集服务前使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_paid_mining"
      }
    },
    "/api/paid-mining/billing": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.billing",
        "x-usage-guide": {
          "purpose": "查看付费采集的系统计量记录。",
          "when": "检查采集调用与费用记录时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_paid_mining_billing"
      }
    },
    "/api/browser-accounts": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "browserAccounts.view",
        "x-usage-guide": {
          "purpose": "列出有权访问的浏览器账号资料。",
          "when": "执行需要指定浏览器账号的任务前使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_browser_accounts"
      }
    },
    "/api/keyword-jobs": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "collection.view",
        "x-usage-guide": {
          "purpose": "列出已有关键词采集任务及状态。",
          "when": "检查采集进展或恢复任务时使用。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_keyword_jobs"
      },
      "post": {
        "summary": "提交授权操作",
        "description": "生成/采集可能产生费用，须已有明确授权；未知结果不自动重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "collection.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "提交新的关键词采集工作。",
          "when": "确定采集条件并获授权后使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_keyword_jobs"
      }
    },
    "/api/subject-records/protocol": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "subjects.view",
        "x-usage-guide": {
          "purpose": "读取主体记录的参数、流程及回传约定。",
          "when": "首次接入该模块或协议更新后读取；执行中不必反复下载同一份说明。",
          "kind": "接入说明"
        },
        "operationId": "get_api_subject_records_protocol"
      }
    },
    "/api/article-cover-skill/manifest": {
      "get": {
        "summary": "读取服务资料",
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "cover.view",
        "x-usage-guide": {
          "purpose": "读取封面素材包版本、哈希和获取信息。",
          "when": "需要封面素材时先比对本地缓存，避免重复下载。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_cover_skill_manifest"
      }
    },
    "/api/test-development/qwen/generate": {
      "post": {
        "summary": "提交授权操作",
        "description": "生成/采集可能产生费用，须已有明确授权；未知结果不自动重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "testDevelopment.generate",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "调用千问图片模型执行生图或编辑。",
          "when": "素材和要求已准备好，需要实际处理图片时使用，可能收费。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_test_development_qwen_generate"
      }
    },
    "/api/test-development/qwen/uploads": {
      "post": {
        "summary": "提交授权操作",
        "description": "生成/采集可能产生费用，须已有明确授权；未知结果不自动重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "testDevelopment.generate",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "上传千问图片处理所需素材。",
          "when": "调用生图前保存人物、服饰或参考图时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_test_development_qwen_uploads"
      }
    },
    "/api/paid-mining/paid-01/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_01_preflight"
      }
    },
    "/api/paid-mining/paid-01/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_01_query"
      }
    },
    "/api/paid-mining/paid-02/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_02_preflight"
      }
    },
    "/api/paid-mining/paid-02/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_02_query"
      }
    },
    "/api/paid-mining/paid-03/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_03_preflight"
      }
    },
    "/api/paid-mining/paid-03/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_03_query"
      }
    },
    "/api/paid-mining/paid-04/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_04_preflight"
      }
    },
    "/api/paid-mining/paid-04/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_04_query"
      }
    },
    "/api/paid-mining/paid-05/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_05_preflight"
      }
    },
    "/api/paid-mining/paid-05/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_05_query"
      }
    },
    "/api/paid-mining/paid-06/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_06_preflight"
      }
    },
    "/api/paid-mining/paid-06/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_06_query"
      }
    },
    "/api/paid-mining/paid-07/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_07_preflight"
      }
    },
    "/api/paid-mining/paid-07/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_07_query"
      }
    },
    "/api/paid-mining/paid-08/preflight": {
      "post": {
        "summary": "付费采集：preflight",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "检查该采集服务的请求条件和执行前状态。",
          "when": "正式查询前按该服务协议检查。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_paid_mining_paid_08_preflight"
      }
    },
    "/api/paid-mining/paid-08/query": {
      "post": {
        "summary": "付费采集：query",
        "description": "按预检回执和相应数据源格式提交，付费请求不得盲目重试。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "paid.execute",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "执行指定付费数据查询并返回结果。",
          "when": "确认查询条件与费用授权后调用；不随意重试未知结果。",
          "kind": "主要入口"
        },
        "operationId": "post_api_paid_mining_paid_08_query"
      }
    },
    "/api/tool-library/site-sync/profiles/{id}/preview": {
      "post": {
        "summary": "工具网站：preview",
        "description": "同步前核对已锁定核心、网站草稿revision、连接revision和packageHash；unknown先核实，不自动重传。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolSites.preview",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "工具网站：查看待发布内容的预览。",
          "when": "正式发布前检查页面、样式和内容时使用。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_profiles_id_preview"
      }
    },
    "/api/tool-library/site-sync/profiles/{id}/publish": {
      "post": {
        "summary": "工具网站：publish",
        "description": "同步前核对已锁定核心、网站草稿revision、连接revision和packageHash；unknown先核实，不自动重传。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功。业务回执原格式；列表通常包含items及分页信息。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "参数或格式错误"
          },
          "401": {
            "description": "凭据失效"
          },
          "403": {
            "description": "账号/Key权限不足"
          },
          "404": {
            "description": "不存在或不可见"
          },
          "409": {
            "description": "版本/状态冲突；先读取核对，不能换ID重发"
          },
          "429": {
            "description": "Key或账号限流",
            "headers": {
              "Retry-After": {
                "description": "等待秒数",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "503": {
            "description": "暂时不可用；写入结果须核实"
          }
        },
        "x-required-permission": "toolSites.sync",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "工具网站：把已准备好的内容发布到目标网站。",
          "when": "确认目标、内容和版本后使用，会实际改变线上网站。",
          "kind": "辅助接口"
        },
        "operationId": "post_api_tool_library_site_sync_profiles_id_publish"
      }
    },
    "/api/article-images/capabilities": {
      "get": {
        "summary": "配图能力",
        "description": "需要权限 articleImages.render",
        "responses": {
          "200": {
            "description": "返回能力或 SVG、WebP Base64、尺寸与待目视验收状态"
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "缺少凭证"
          },
          "403": {
            "description": "权限不足"
          },
          "422": {
            "description": "SVG 不支持或参考不足"
          },
          "429": {
            "description": "限流"
          },
          "502": {
            "description": "模型失败"
          },
          "503": {
            "description": "模型未配置或渲染不可用"
          }
        },
        "x-usage-guide": {
          "purpose": "查看服务支持的能力、配置状态与调用约定。",
          "when": "首次接入或检查服务是否可用时使用，不会执行生成。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_images_capabilities"
      }
    },
    "/api/article-images/render": {
      "post": {
        "summary": "渲染 SVG 配图",
        "description": "需要权限 articleImages.render",
        "responses": {
          "200": {
            "description": "返回能力或 SVG、WebP Base64、尺寸与待目视验收状态"
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "缺少凭证"
          },
          "403": {
            "description": "权限不足"
          },
          "422": {
            "description": "SVG 不支持或参考不足"
          },
          "429": {
            "description": "限流"
          },
          "502": {
            "description": "模型失败"
          },
          "503": {
            "description": "模型未配置或渲染不可用"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "svg": {
                    "type": "string"
                  },
                  "caption": {
                    "type": "string"
                  }
                },
                "required": [
                  "svg"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "将符合要求的SVG素材渲染成WebP图片，不调用AI设计。",
          "when": "已经有SVG，需要转换成可下载配图时使用。",
          "kind": "主要入口"
        },
        "operationId": "post_api_article_images_render"
      }
    },
    "/api/article-images/generate": {
      "post": {
        "summary": "根据关键词生成配图或Logo",
        "description": "使用已启用的配图供应商，自动读取通用配图要求。传keyword、purpose=cover/logo、returnRequirements、稳定requestId；不接受调用方提示词。旧article/references转为参考资料，也须requestId。新生成全部交付WebP；服务器使用实际工作目录文件，外部Responses服务返回真实公开HTTPS WebP链接，不再要求SVG。异步查询jobs/{id}，unknown不换ID重试。直接SVG转换仅保留在独立render接口。",
        "responses": {
          "200": {
            "description": "幂等任务状态及实际WebP结果（完成后含webpBase64）"
          },
          "400": {
            "description": "参数错误"
          },
          "401": {
            "description": "缺少凭证"
          },
          "403": {
            "description": "权限不足"
          },
          "422": {
            "description": "WebP交付或尺寸校验不通过"
          },
          "429": {
            "description": "限流"
          },
          "502": {
            "description": "模型失败"
          },
          "503": {
            "description": "模型未配置或渲染不可用"
          },
          "202": {
            "description": "Async job id, status, requestId"
          },
          "409": {
            "description": "requestId input conflict"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string"
                  },
                  "purpose": {
                    "type": "string",
                    "enum": [
                      "cover",
                      "logo"
                    ]
                  },
                  "requestId": {
                    "type": "string"
                  },
                  "returnRequirements": {
                    "type": "object",
                    "properties": {
                      "format": {
                        "type": "string",
                        "enum": [
                          "webp"
                        ]
                      },
                      "maxWidth": {
                        "type": "integer"
                      },
                      "maxHeight": {
                        "type": "integer"
                      },
                      "maxBytes": {
                        "type": "integer"
                      }
                    }
                  },
                  "article": {
                    "type": "string"
                  },
                  "references": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "providerId": {
                    "type": "string"
                  }
                },
                "required": [
                  "requestId"
                ]
              },
              "example": {
                "keyword": "制作答辩PPT教程",
                "purpose": "logo",
                "requestId": "logo-demo-001",
                "returnRequirements": {
                  "format": "webp",
                  "maxWidth": 122,
                  "maxHeight": 122,
                  "maxBytes": 40000
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "kind": "主要入口",
          "purpose": "给出关键词，生成封面配图或Logo，返回实际WebP。",
          "when": "独立需要图片，或专题等功能需要图片时调用；设计规则只在本功能维护。"
        },
        "operationId": "post_api_article_images_generate"
      }
    },
    "/api/article-writing/standards": {
      "get": {
        "summary": "读取原始写作标准及可选清单",
        "description": "需要 styles.view。默认返回统一写作流程与通用标题、正文、配图标准原文。客户端按这套标准自行写作，或交给服务器生成。",
        "responses": {
          "200": {
            "description": "成功或同请求重放"
          },
          "400": {
            "description": "参数无效"
          },
          "401": {
            "description": "未认证"
          },
          "403": {
            "description": "权限不足"
          },
          "404": {
            "description": "记录不存在或非本人"
          },
          "409": {
            "description": "同一requestId输入变化或标准失效"
          },
          "429": {
            "description": "并发繁忙"
          },
          "503": {
            "description": "模型未配置或关闭"
          }
        },
        "parameters": [
          {
            "name": "titleStyleIds",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "逗号分隔ID；空字符串明确不选择"
          },
          {
            "name": "contentStyleIds",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "逗号分隔ID；空字符串明确不选择"
          },
          {
            "name": "imageStyleIds",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "逗号分隔ID；空字符串明确不选择"
          }
        ],
        "x-usage-guide": {
          "purpose": "领取写作流程、标题风格、正文风格和配图要求。",
          "when": "让外部Codex自行写文章，或检查系统当前写作标准时使用。",
          "kind": "主要入口"
        },
        "operationId": "get_api_article_writing_standards"
      }
    },
    "/api/article-writing/capabilities": {
      "get": {
        "summary": "查询写作模式、配置状态与调用协议",
        "description": "需要 styles.view。返回已启用且配置密钥的providers（id/name/model/isDefault）及defaultProviderId，不返回供应商密钥或地址。默认接口停用时，省略providerId的新生成请求返回503。",
        "responses": {
          "200": {
            "description": "成功或同请求重放"
          },
          "400": {
            "description": "参数无效"
          },
          "401": {
            "description": "未认证"
          },
          "403": {
            "description": "权限不足"
          },
          "404": {
            "description": "记录不存在或非本人"
          },
          "409": {
            "description": "同一requestId输入变化或标准失效"
          },
          "429": {
            "description": "并发繁忙"
          },
          "503": {
            "description": "模型未配置或关闭"
          }
        },
        "x-usage-guide": {
          "purpose": "查看服务支持的能力、配置状态与调用约定。",
          "when": "首次接入或检查服务是否可用时使用，不会执行生成。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_writing_capabilities"
      }
    },
    "/api/article-writing/generate": {
      "post": {
        "summary": "提交标题生成文章及WebP图片",
        "description": "文字模型只生成正文、SEO及imageRequests（图片主题、用途和位置）。启用配图时，服务器调用独立配图API，与文章规划共用本次通用配图要求快照，生成真实WebP。结果images含本人认证下载URL，正文图片ID替换为此URL；imageDependencies记录图片子任务和规则版本。相同requestId幂等，已保存文字结果恢复时不重复写作；partial不等于完成，unknown不自动重发。历史任务保留旧流程。",
        "responses": {
          "200": {
            "description": "成功或同请求重放"
          },
          "202": {
            "description": "已接收；轮询jobs/{id}，状态queued/running/succeeded/partial/failed/unknown。"
          },
          "400": {
            "description": "参数无效"
          },
          "401": {
            "description": "未认证"
          },
          "403": {
            "description": "权限不足"
          },
          "404": {
            "description": "记录不存在或非本人"
          },
          "409": {
            "description": "同一requestId输入变化或标准失效"
          },
          "429": {
            "description": "并发繁忙"
          },
          "503": {
            "description": "模型未配置或关闭"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "requestId",
                  "title"
                ],
                "properties": {
                  "requestId": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 120,
                    "description": "客户端持久保存，同内容重放不会重复调用模型"
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "materials": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "requirements": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "titleStyleIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 30,
                    "description": "省略使用管理员默认值；空数组明确不选择"
                  },
                  "contentStyleIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 30,
                    "description": "省略使用管理员默认值；空数组明确不选择"
                  },
                  "imageStyleIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 30,
                    "description": "保留标准选择兼容；空数组明确不启用配图。新自动写作仅用此选择控制是否请求图片，图片设计规则在独立配图API维护，不把所选配图正文再次注入文字模型。"
                  },
                  "providerId": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "可选写作接口ID，从capabilities.providers获取；省略使用默认接口。所选接口停用则503，不自动切换；重放须保持原输入。"
                  }
                }
              },
              "example": {
                "requestId": "article-example-001",
                "title": "JavaScript 数组去重怎么保留原有顺序？"
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "提交标题，由服务器调用已配置AI生成正文、SEO与配图结果。",
          "when": "开始一次新的文章生成时使用；先保存请求标识，收到任务ID后查询结果。生成不代表已经发布网站。",
          "kind": "主要入口"
        },
        "operationId": "post_api_article_writing_generate"
      }
    },
    "/api/article-writing/jobs/{id}": {
      "get": {
        "summary": "读取本人文章、SEO、图片下载地址及用量",
        "description": "同一次写作AI返回正文、SEO及WebP文件引用；服务器Codex使用工作目录内filePath，外部服务使用公开HTTPS fileUrl。后台校验静态WebP（≤700×395、≤40000字节），保存为本人私有图片；images[].url须用同一账号认证下载，正文已替换相应URL。旧SVG兼容离线转换，不另调配图API。partial不代表全部完成，unknown不自动重试。",
        "responses": {
          "200": {
            "description": "成功或同请求重放"
          },
          "400": {
            "description": "参数无效"
          },
          "401": {
            "description": "未认证"
          },
          "403": {
            "description": "权限不足"
          },
          "404": {
            "description": "记录不存在或非本人"
          },
          "409": {
            "description": "同一requestId输入变化或标准失效"
          },
          "429": {
            "description": "并发繁忙"
          },
          "503": {
            "description": "模型未配置或关闭"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}$"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取这次文章生成的状态、结果或失败原因。",
          "when": "生成返回任务ID后使用；尚未结束时按协议查询，恢复已有任务也用它，不要重复提交生成。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_writing_jobs_id"
      }
    },
    "/api/article-writing/workflow": {
      "get": {
        "summary": "读取统一写作流程",
        "description": "需要 styles.view；standards 同时返回此流程。",
        "responses": {
          "200": {
            "description": "content、revision"
          }
        },
        "x-usage-guide": {
          "purpose": "查看当前通用写作流程及版本。",
          "when": "配置或排查生成行为时使用；普通生成无需每次手工读取。",
          "kind": "配置管理"
        },
        "operationId": "get_api_article_writing_workflow"
      },
      "put": {
        "summary": "编辑统一写作流程",
        "description": "需要 styles.edit，revision 乐观锁；不修改历史生成快照。",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision",
                  "content"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "content": {
                    "type": "string",
                    "maxLength": 80000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "保存成功"
          },
          "403": {
            "description": "无编辑权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "x-usage-guide": {
          "purpose": "修改实际生效的通用写作流程，按版本检查保存。",
          "when": "管理员或获授权人员调整后续执行要求时使用；不是提交一次生成任务。",
          "kind": "配置管理"
        },
        "operationId": "put_api_article_writing_workflow"
      }
    },
    "/api/article-images/jobs/{id}": {
      "get": {
        "summary": "Query server Codex image job",
        "description": "articleImages.generate; owner only. succeeded still requires visual review.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "queued/running/succeeded/partial/failed/unknown; result and actual usage"
          },
          "404": {
            "description": "Not found or other owner"
          },
          "403": {
            "description": "Permission denied"
          }
        },
        "x-usage-guide": {
          "purpose": "读取这次配图生成的状态、结果或失败原因。",
          "when": "生成返回任务ID后使用；尚未结束时按协议查询，恢复已有任务也用它，不要重复提交生成。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_images_jobs_id"
      }
    },
    "/api/article-writing/prompts": {
      "get": {
        "summary": "查看文章写作自身提示词",
        "description": "仅writing/chatFormat/executor/inputLabel四项。配图规则使用 /api/styles 中的通用配图要求；旧任务快照保持。styles.view；返回全部可编辑文字、版本、组装顺序及只读返回格式约束。",
        "responses": {
          "200": {
            "description": "revision/items/contracts/assembly"
          },
          "403": {
            "description": "缺少查看权限"
          }
        },
        "x-usage-guide": {
          "purpose": "查看当前文章写作自身提示词及版本。",
          "when": "配置或排查生成行为时使用；普通生成无需每次手工读取。",
          "kind": "配置管理"
        },
        "operationId": "get_api_article_writing_prompts"
      },
      "put": {
        "summary": "保存文章写作自身提示词",
        "description": "仅writing/chatFormat/executor/inputLabel四项。配图规则使用 /api/styles 中的通用配图要求；旧任务快照保持。styles.edit；事务版本检查，仅新请求使用更新；旧任务保留快照。",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision",
                  "items"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "id",
                        "content"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 30000
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "新版本"
          },
          "409": {
            "description": "版本冲突"
          },
          "403": {
            "description": "缺少编辑权限"
          }
        },
        "x-usage-guide": {
          "purpose": "修改实际生效的文章写作自身提示词，按版本检查保存。",
          "when": "管理员或获授权人员调整后续执行要求时使用；不是提交一次生成任务。",
          "kind": "配置管理"
        },
        "operationId": "put_api_article_writing_prompts"
      }
    },
    "/api/article-writing/jobs/{id}/images/{imageId}.webp": {
      "get": {
        "summary": "读取本人文章生成任务的WebP图片",
        "tags": [
          "文章写作"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "imageId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已验证的静态WebP，最大700×395，40000字节；须使用原账号认证",
            "content": {
              "image/webp": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "403": {
            "description": "缺少articleWriting.view"
          },
          "404": {
            "description": "图片不存在或不属于当前账号"
          }
        },
        "x-usage-guide": {
          "purpose": "下载生成结果中的实际WebP图片文件。",
          "when": "任务结果已有图片地址，需要保存、上传到网站或展示图片时使用；请求需本人授权。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_article_writing_jobs_id_images_imageId_webp"
      },
      "head": {
        "summary": "读取本人文章生成任务的WebP图片",
        "tags": [
          "文章写作"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "imageId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "已验证的静态WebP，最大700×395，40000字节；须使用原账号认证",
            "content": {
              "image/webp": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "403": {
            "description": "缺少articleWriting.view"
          },
          "404": {
            "description": "图片不存在或不属于当前账号"
          }
        },
        "x-usage-guide": {
          "purpose": "只查询图片响应头，不下载图片内容。",
          "when": "程序需要检查图片是否可访问、文件类型等时使用；普通调用通常不需要单独调用。",
          "kind": "辅助接口"
        },
        "operationId": "head_api_article_writing_jobs_id_images_imageId_webp"
      }
    },
    "/api/codex-management/status": {
      "get": {
        "summary": "查看服务器Codex账号与队列状态",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "x-usage-guide": {
          "purpose": "查看服务器Codex账号与队列状态。",
          "when": "检查服务器Codex登录和运行状态时使用。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_status"
      }
    },
    "/api/codex-management/settings": {
      "get": {
        "summary": "读取Codex队列及会话提示词",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "x-usage-guide": {
          "purpose": "查看当前服务器Codex设置及版本。",
          "when": "配置或排查生成行为时使用；普通生成无需每次手工读取。",
          "kind": "配置管理"
        },
        "operationId": "get_api_codex_management_settings"
      },
      "put": {
        "summary": "修改队列暂停和新会话提示词",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "paused": {
                    "type": "boolean"
                  },
                  "prompt": {
                    "type": "string",
                    "maxLength": 20000
                  }
                },
                "required": [
                  "revision",
                  "paused",
                  "prompt"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改实际生效的服务器Codex设置，按版本检查保存。",
          "when": "管理员或获授权人员调整后续执行要求时使用；不是提交一次生成任务。",
          "kind": "配置管理"
        },
        "operationId": "put_api_codex_management_settings"
      }
    },
    "/api/codex-management/chats": {
      "get": {
        "summary": "分页查看服务器对话",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "分页查看服务器对话。",
          "when": "查找历史对话或阅读已有消息时使用。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_chats"
      },
      "post": {
        "summary": "创建服务器对话",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "requestId": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 150
                  },
                  "projectId": {
                    "enum": [
                      "ai-office-site",
                      null
                    ],
                    "description": "固定项目；省略为普通会话"
                  }
                },
                "required": [
                  "requestId",
                  "title"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "创建服务器对话。",
          "when": "开始一个独立的服务器Codex对话时使用。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_chats"
      }
    },
    "/api/codex-management/chats/{id}": {
      "get": {
        "summary": "读取对话及分页消息",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取对话及分页消息。",
          "when": "查找历史对话或阅读已有消息时使用。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_chats_id"
      }
    },
    "/api/codex-management/chats/{id}/messages": {
      "post": {
        "summary": "发送消息或任务，续接原会话",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "requestId": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string",
                    "maxLength": 30000
                  }
                },
                "required": [
                  "requestId",
                  "message"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "发送消息或任务，续接原会话。",
          "when": "在已有对话继续交流或下达新任务时使用。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_chats_id_messages"
      }
    },
    "/api/codex-management/jobs": {
      "get": {
        "summary": "分页查看服务器工作记录",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "分页查看服务器工作记录。",
          "when": "查看工作进展、结果或排查失败时使用，不重新执行任务。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_jobs"
      }
    },
    "/api/codex-management/jobs/{id}": {
      "get": {
        "summary": "读取执行结果与进展",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取执行结果与进展。",
          "when": "查看工作进展、结果或排查失败时使用，不重新执行任务。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_jobs_id"
      }
    },
    "/api/codex-management/jobs/{id}/cancel": {
      "post": {
        "summary": "停止排队或正在执行的任务",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "停止排队或正在执行的任务。",
          "when": "明确需要停止该次执行时使用，不能撤销此前已发生的外部操作。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_jobs_id_cancel"
      }
    },
    "/api/codex-management/schedules": {
      "get": {
        "summary": "查看定时计划及最近调度记录",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。 北京时间；15秒检查；错过超过2分钟不补跑；不重叠启动，失败/未知暂停后续周期。仅本站调度，非系统cron导入。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "x-usage-guide": {
          "purpose": "查看定时计划及最近调度记录。",
          "when": "查看服务器定时计划、启停及最近执行情况时使用。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_schedules"
      },
      "post": {
        "summary": "新增服务器定时任务",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。 北京时间；15秒检查；错过超过2分钟不补跑；不重叠启动，失败/未知暂停后续周期。仅本站调度，非系统cron导入。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "requestId": {
                    "type": "string"
                  },
                  "revision": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 150
                  },
                  "message": {
                    "type": "string",
                    "maxLength": 30000
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "kind": {
                    "enum": [
                      "daily",
                      "weekly",
                      "interval"
                    ]
                  },
                  "time": {
                    "type": "string",
                    "description": "北京时间HH:mm"
                  },
                  "weekday": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 6
                  },
                  "minutes": {
                    "type": "integer",
                    "minimum": 15,
                    "maximum": 43200
                  },
                  "acknowledge": {
                    "type": "boolean",
                    "description": "核对失败/未知结果后恢复后续周期"
                  }
                },
                "required": [
                  "title",
                  "message",
                  "enabled",
                  "kind",
                  "requestId"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "新增服务器定时任务。",
          "when": "需要按时间自动下达任务时创建计划。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_schedules"
      }
    },
    "/api/codex-management/schedules/{id}": {
      "put": {
        "summary": "修改或启停服务器定时任务",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。 北京时间；15秒检查；错过超过2分钟不补跑；不重叠启动，失败/未知暂停后续周期。仅本站调度，非系统cron导入。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "requestId": {
                    "type": "string"
                  },
                  "revision": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 150
                  },
                  "message": {
                    "type": "string",
                    "maxLength": 30000
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "kind": {
                    "enum": [
                      "daily",
                      "weekly",
                      "interval"
                    ]
                  },
                  "time": {
                    "type": "string",
                    "description": "北京时间HH:mm"
                  },
                  "weekday": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 6
                  },
                  "minutes": {
                    "type": "integer",
                    "minimum": 15,
                    "maximum": 43200
                  },
                  "acknowledge": {
                    "type": "boolean",
                    "description": "核对失败/未知结果后恢复后续周期"
                  }
                },
                "required": [
                  "title",
                  "message",
                  "enabled",
                  "kind",
                  "revision"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "修改或启停服务器定时任务。",
          "when": "调整执行时间、任务内容或启停计划时使用。",
          "kind": "管理维护"
        },
        "operationId": "put_api_codex_management_schedules_id"
      }
    },
    "/api/codex-management/schedules/{id}/delete": {
      "post": {
        "summary": "软删除定时计划并保留执行记录",
        "tags": [
          "Codex管理"
        ],
        "description": "仅系统管理员登录会话或管理员Basic认证可用；普通会员及会员API Key不可调用。写请求须X-Member-Request: 1，校验同源。聊天执行使用服务器ChatGPT账号额度，不自动接入其他业务任务。 北京时间；15秒检查；错过超过2分钟不补跑；不重叠启动，失败/未知暂停后续周期。仅本站调度，非系统cron导入。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "requestId": {
                    "type": "string"
                  },
                  "revision": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 150
                  },
                  "message": {
                    "type": "string",
                    "maxLength": 30000
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "kind": {
                    "enum": [
                      "daily",
                      "weekly",
                      "interval"
                    ]
                  },
                  "time": {
                    "type": "string",
                    "description": "北京时间HH:mm"
                  },
                  "weekday": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 6
                  },
                  "minutes": {
                    "type": "integer",
                    "minimum": 15,
                    "maximum": 43200
                  },
                  "acknowledge": {
                    "type": "boolean",
                    "description": "核对失败/未知结果后恢复后续周期"
                  }
                },
                "required": [
                  "revision"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "软删除定时计划并保留执行记录。",
          "when": "删除既有计划时使用，历史记录保留。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_schedules_id_delete"
      }
    },
    "/api/codex-management/projects": {
      "get": {
        "summary": "查看固定项目与部署记录",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "x-usage-guide": {
          "purpose": "查看固定项目与部署记录。",
          "when": "检查项目或已有发布记录时使用，不创建新发布。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_projects"
      }
    },
    "/api/codex-management/projects/logs": {
      "get": {
        "summary": "读取脱敏慢请求摘要",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "x-usage-guide": {
          "purpose": "读取脱敏慢请求摘要。",
          "when": "排查站点慢请求时使用，不执行项目修改。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_projects_logs"
      }
    },
    "/api/codex-management/projects/prepare": {
      "post": {
        "summary": "准备项目发布包，校验线上基线及语法",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chatId": {
                    "type": "string"
                  }
                },
                "required": [
                  "chatId"
                ]
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "准备项目发布包，校验线上基线及语法。",
          "when": "修改完成后准备发布包，核对变更与线上基线；尚未上线。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_projects_prepare"
      }
    },
    "/api/codex-management/projects/releases/{id}": {
      "get": {
        "summary": "查看发布状态和文件清单",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "查看发布状态和文件清单。",
          "when": "检查项目或已有发布记录时使用，不创建新发布。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_projects_releases_id"
      }
    },
    "/api/codex-management/projects/releases/{id}/files": {
      "get": {
        "summary": "查看选中文件修改前后内容",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "查看选中文件修改前后内容。",
          "when": "发布前逐文件检查差异时使用。",
          "kind": "管理维护"
        },
        "operationId": "get_api_codex_management_projects_releases_id_files"
      }
    },
    "/api/codex-management/projects/releases/{id}/publish": {
      "post": {
        "summary": "核对后确认上线",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "confirm": {
                    "type": "boolean"
                  },
                  "testReviewed": {
                    "type": "boolean"
                  },
                  "riskAcknowledged": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "confirm",
                  "testReviewed"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "核对后确认上线。",
          "when": "审核发布包并确认上线时使用，会改变生产代码。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_projects_releases_id_publish"
      }
    },
    "/api/codex-management/projects/releases/{id}/rollback": {
      "post": {
        "summary": "核对后回滚代码版本",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员；普通API Key不可调用。写入须X-Member-Request:1及同源校验。项目独立源码/Git工作区不复制runtime；发布需确认测试及敏感变更，固定辅助程序部署并检查健康。并发版本冲突拒绝覆盖。未知结果先核实，不重试。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "202": {
            "description": "消息已排队"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "confirm": {
                    "type": "boolean"
                  },
                  "testReviewed": {
                    "type": "boolean"
                  },
                  "riskAcknowledged": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "confirm",
                  "testReviewed"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "核对后回滚代码版本。",
          "when": "确认需要恢复已备份版本时使用，会改变生产代码。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_projects_releases_id_rollback"
      }
    },
    "/api/topic-generation/generate": {
      "post": {
        "summary": "生成专题完整资料",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。 返回keywordIntroduction（专题关键词介绍），与seoDescription独立；imageOptions覆盖后台默认图片尺寸。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "keyword"
                ],
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "requestId": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 120
                  },
                  "imageOptions": {
                    "type": "object",
                    "description": "最大宽高；省略沿用后台默认值；按比例输出，仍限WebP每张40000字节。",
                    "additionalProperties": false,
                    "properties": {
                      "logo": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "maxWidth": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          },
                          "maxHeight": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          }
                        }
                      },
                      "cover": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "maxWidth": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          },
                          "maxHeight": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "keyword": "制作答辩PPT教程"
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "提交专题关键词，生成URL短词、Logo、封面、搜索联想词和SEO资料。",
          "when": "开始一次新的专题生成时使用；先保存请求标识，收到任务ID后查询结果。生成不代表已经发布网站。",
          "kind": "主要入口"
        },
        "operationId": "post_api_topic_generation_generate"
      }
    },
    "/api/topic-generation/jobs/{id}": {
      "get": {
        "summary": "读取本人专题生成结果",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}$"
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "读取这次专题生成的状态、结果或失败原因。",
          "when": "生成返回任务ID后使用；尚未结束时按协议查询，恢复已有任务也用它，不要重复提交生成。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_topic_generation_jobs_id"
      }
    },
    "/api/topic-generation/jobs/{id}/images/{image}.webp": {
      "get": {
        "summary": "下载专题Logo或封面",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}$"
            }
          },
          {
            "name": "image",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "logo",
                "cover"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "下载生成结果中的实际WebP图片文件。",
          "when": "任务结果已有图片地址，需要保存、上传到网站或展示图片时使用；请求需本人授权。",
          "kind": "辅助接口"
        },
        "operationId": "get_api_topic_generation_jobs_id_images_image_webp"
      },
      "head": {
        "summary": "查看专题图片响应头",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}$"
            }
          },
          {
            "name": "image",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "logo",
                "cover"
              ]
            }
          }
        ],
        "x-usage-guide": {
          "purpose": "只查询图片响应头，不下载图片内容。",
          "when": "程序需要检查图片是否可访问、文件类型等时使用；普通调用通常不需要单独调用。",
          "kind": "辅助接口"
        },
        "operationId": "head_api_topic_generation_jobs_id_images_image_webp"
      }
    },
    "/api/topic-generation/rules": {
      "get": {
        "summary": "读取专题生成规则和输出协议",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "x-usage-guide": {
          "purpose": "查看当前专题生成规则及版本。",
          "when": "配置或排查生成行为时使用；普通生成无需每次手工读取。",
          "kind": "配置管理"
        },
        "operationId": "get_api_topic_generation_rules"
      },
      "put": {
        "summary": "修改专题生成提示词",
        "tags": [
          "专题生成"
        ],
        "description": "复用线上默认服务器Codex API与既有联想工具、WebP验证。生成不入库不发布。独立会员/API Key授权，结果和图片仅本人可读。图片需相同Bearer授权。未提供requestId按同账号/关键词/规则版本/北京时间当日复用；新requestId才新生成。partial含受阻引擎或未满足项；unknown不要盲目换编号重试。",
        "responses": {
          "200": {
            "description": "规则/任务/结果；任务result包含keyword,urlPath,logo,cover,suggestions,seoTitle,selectedTerms,seoKeywords,seoDescription,subtitle,subtitleLength,issues。各引擎含source,url,status,terms和checkedAt；图片含url,access,format,width,height,bytes,origin,sourceUrl,evidence。"
          },
          "202": {
            "description": "已接收；按pollUrl读取，直到succeeded/partial/failed/unknown"
          },
          "403": {
            "description": "未授权"
          },
          "404": {
            "description": "记录不存在或不属于本人"
          },
          "409": {
            "description": "版本/幂等冲突或线上API未配置"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision",
                  "content",
                  "executor"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "content": {
                    "type": "string"
                  },
                  "executor": {
                    "type": "string"
                  },
                  "imageOptions": {
                    "type": "object",
                    "description": "最大宽高；省略沿用后台默认值；按比例输出，仍限WebP每张40000字节。",
                    "additionalProperties": false,
                    "properties": {
                      "logo": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "maxWidth": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          },
                          "maxHeight": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          }
                        }
                      },
                      "cover": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "maxWidth": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          },
                          "maxHeight": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2048
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "修改实际生效的专题生成规则，按版本检查保存。",
          "when": "管理员或获授权人员调整后续执行要求时使用；不是提交一次生成任务。",
          "kind": "配置管理"
        },
        "operationId": "put_api_topic_generation_rules"
      }
    },
    "/api/article-images/rules": {
      "get": {
        "summary": "读取通用配图要求及来源",
        "x-required-permission": "styles.view",
        "x-usage-guide": {
          "kind": "配置管理",
          "purpose": "维护配图和Logo自己的提示词。",
          "when": "修改图片生成行为时使用，不在专题提示词里追加。"
        },
        "responses": {
          "200": {
            "description": "当前通用配图要求和标准版本"
          }
        },
        "operationId": "get_api_article_images_rules",
        "description": "返回当前通用配图要求及其 standardPath。cover、logo 为同一标准的兼容字段。"
      },
      "put": {
        "summary": "原配图规则写入入口（已停用）",
        "x-required-permission": "styles.edit",
        "x-usage-guide": {
          "kind": "配置管理",
          "purpose": "维护配图和Logo自己的提示词。",
          "when": "修改图片生成行为时使用，不在专题提示词里追加。"
        },
        "responses": {
          "409": {
            "description": "请转到通用配图要求保存"
          }
        },
        "operationId": "put_api_article_images_rules",
        "deprecated": true,
        "description": "返回 409 和 standardPath。请改用对应 /api/styles/{id} 写入统一标准。"
      }
    },
    "/api/function-rules/qwen": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取qwen业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_qwen"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存qwen业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_qwen"
      }
    },
    "/api/function-rules/official-monitor": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取official-monitor业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_official_monitor"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存official-monitor业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_official_monitor"
      }
    },
    "/api/function-rules/topic-tasks": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取topic-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_topic_tasks"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存topic-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_topic_tasks"
      }
    },
    "/api/function-rules/report-tasks": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取report-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_report_tasks"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存report-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_report_tasks"
      }
    },
    "/api/function-rules/tool-tasks": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取tool-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_tool_tasks"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存tool-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_tool_tasks"
      }
    },
    "/api/function-rules/video-tasks": {
      "get": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "读取video-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "operationId": "get_api_function_rules_video_tasks"
      },
      "put": {
        "tags": [
          "功能规则管理"
        ],
        "summary": "保存video-tasks业务规则",
        "description": "仅管理员在 API 详情弹窗管理本功能规则；不执行任务，不修改授权。PUT 需原 revision。",
        "x-usage-guide": {
          "purpose": "管理本功能的业务要求",
          "when": "修改此功能提示词时",
          "kind": "配置管理"
        },
        "responses": {
          "200": {
            "description": "规则及版本"
          },
          "403": {
            "description": "无管理员权限"
          },
          "409": {
            "description": "版本冲突"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "revision": 1
              }
            }
          }
        },
        "operationId": "put_api_function_rules_video_tasks"
      }
    },
    "/api/member-admin/users/{id}": {
      "delete": {
        "tags": [
          "会员与授权"
        ],
        "summary": "删除会员账号",
        "description": "仅管理员；提交当前revision和完整confirmUsername。撤销会话及令牌，保留作者身份与历史内容；账号名保留，不能恢复启用。原请求重放幂等。",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision",
                  "confirmUsername"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "confirmUsername": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "账号已删除"
          },
          "400": {
            "description": "确认信息不匹配"
          },
          "403": {
            "description": "非管理员或请求来源无效"
          },
          "404": {
            "description": "账号不存在"
          },
          "409": {
            "description": "版本已变化"
          },
          "410": {
            "description": "账号已删除且请求不匹配"
          }
        },
        "x-usage-guide": {
          "kind": "配置管理",
          "purpose": "删除会员并撤销访问，保留历史归属",
          "when": "管理员清理不再使用的会员账号时"
        },
        "operationId": "delete_api_member_admin_users_id"
      }
    },
    "/api/codex-management/task-api": {
      "post": {
        "summary": "服务器任务通道：领取资料、回传结果或按requestId查询回执；仅管理员访问",
        "description": "服务器任务通道：领取资料、回传结果或按requestId查询回执；仅管理员访问",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "method": {
                    "type": "string",
                    "enum": [
                      "GET",
                      "POST",
                      "PUT"
                    ]
                  },
                  "path": {
                    "type": "string"
                  },
                  "body": {
                    "type": "object"
                  },
                  "requestId": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "receipt"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功回执"
          },
          "403": {
            "description": "未授权"
          },
          "409": {
            "description": "状态或请求内容冲突"
          }
        },
        "operationId": "post_api_codex_management_task_api"
      }
    },
    "/api/codex-management/task-access": {
      "get": {
        "summary": "读取服务器任务通道授权与能力范围",
        "responses": {
          "200": {
            "description": "当前授权状态及能力"
          }
        },
        "operationId": "get_api_codex_management_task_access"
      },
      "put": {
        "summary": "启用或关闭服务器任务通道；仅管理员访问",
        "description": "启用或关闭服务器任务通道；仅管理员访问",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "revision",
                  "enabled"
                ],
                "properties": {
                  "revision": {
                    "type": "integer"
                  },
                  "enabled": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功回执"
          },
          "403": {
            "description": "未授权"
          },
          "409": {
            "description": "状态或请求内容冲突"
          }
        },
        "operationId": "put_api_codex_management_task_access"
      }
    },
    "/api/members/device/leave-connect": {
      "post": {
        "summary": "退出API授权会话，恢复同账号有效后台登录或返回登录页；不提升权限",
        "description": "退出API授权会话，恢复同账号有效后台登录或返回登录页；不提升权限",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功回执"
          },
          "403": {
            "description": "未授权"
          },
          "409": {
            "description": "状态或请求内容冲突"
          }
        },
        "operationId": "post_api_members_device_leave_connect"
      }
    },
    "/api/codex-management/jobs/{id}/business-result": {
      "post": {
        "summary": "登记服务器任务的业务执行结果",
        "tags": [
          "Codex管理"
        ],
        "description": "仅管理员可调用。对当前运行中的聊天任务登记业务完成状态；进程退出成功不能替代业务成功。相同结果可幂等重放，结果已确定后不同内容返回409。定时任务未回传结果时标记unknown并等待核查。不得把外部提交未知状态登记为完成。",
        "responses": {
          "200": {
            "description": "成功"
          },
          "403": {
            "description": "非管理员或来源校验失败"
          },
          "409": {
            "description": "版本/请求编号冲突或会话忙"
          },
          "503": {
            "description": "服务不可用，保持原请求编号核查"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "status",
                  "summary"
                ],
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "completed",
                      "partial",
                      "blocked",
                      "failed"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  }
                }
              }
            }
          }
        },
        "x-usage-guide": {
          "purpose": "区分程序正常结束和实际业务完成。",
          "when": "服务器任务完成、部分完成或受阻时，在结束本轮前登记实际结果。",
          "kind": "管理维护"
        },
        "operationId": "post_api_codex_management_jobs_id_business_result"
      }
    }
  },
  "x-device-proof": {
    "protocol": "ZW-DEVICE-1",
    "algorithm": "Ed25519",
    "publicKey": "SPKI PEM",
    "canonicalLines": [
      "ZW-DEVICE-1",
      "serverEpoch",
      "X-API-Time milliseconds",
      "X-API-Nonce",
      "UPPERCASE HTTP METHOD",
      "raw path + query",
      "SHA256(raw token) lowercase hex"
    ],
    "join": "LF, no trailing LF",
    "encoding": "UTF-8",
    "signature": "64-byte Ed25519 signature, base64url without padding",
    "nonce": "new cryptographic random >=128 bits each request; base64url 22-80 chars",
    "clockSkewSeconds": 120,
    "bootstrap": "GET /api/members/device/proof-info, use serverTime to correct clock",
    "restart": "serverEpoch changes at process restart; old proof rejected",
    "transport": "HTTPS; body not covered by proof",
    "boundaries": "No backend HTML or member/token management via API tokens; connectCookie cannot read business APIs",
    "client": "/api-browser-login.mjs",
    "applicability": "仅已有或新创建的签名模式Key；不能通过省略签名把绑定Key降级。普通Key无需签名。"
  }
}