gaoding-cli 1.0.0-alpha.10

package/contracts/operations/auth.status/output.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.gaoding.com/operations/auth.status/output.schema.json",
+  "title": "AuthStatusResult",
+  "description": "本机稿定 CLI 登录、账号、组织和凭证状态。",
+  "oneOf": [
+    {
+      "type": "object",
+      "required": [
+        "logged_in",
+        "next_steps"
+      ],
+      "properties": {
+        "logged_in": {
+          "const": false,
+          "description": "本机没有登录凭证。"
+        },
+        "next_steps": {
+          "type": "array",
+          "description": "恢复可用状态的下一步命令。",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "required": [
+        "logged_in",
+        "account",
+        "organization",
+        "credential",
+        "next_steps"
+      ],
+      "properties": {
+        "logged_in": {
+          "const": true,
+          "description": "本机存在格式有效的登录凭证。"
+        },
+        "account": {
+          "type": "object",
+          "required": [
+            "user_id",
+            "name"
+          ],
+          "properties": {
+            "user_id": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "当前用户 ID；本地未保存时为 null。"
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "当前用户名称；本地未保存时为 null。"
+            }
+          },
+          "additionalProperties": false
+        },
+        "organization": {
+          "description": "本机当前选择的组织；尚未选择时为 null。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "name"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "当前组织 ID。"
+                },
+                "name": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "当前组织名称。"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "credential": {
+          "type": "object",
+          "required": [
+            "expires_at",
+            "valid",
+            "scope"
+          ],
+          "properties": {
+            "expires_at": {
+              "type": "string",
+              "format": "date-time",
+              "description": "凭证过期时间，ISO 8601。"
+            },
+            "valid": {
+              "type": "boolean",
+              "description": "凭证当前是否未过期。"
+            },
+            "scope": {
+              "type": "array",
+              "description": "服务端授予的权限范围。",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "next_steps": {
+          "type": "array",
+          "description": "恢复可用状态或选择组织的下一步命令。",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  ]
+}

package/contracts/operations/dam.delete/input.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamDeleteInput",
+  "description": "DAM 素材删除参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["asset_id"],
+  "properties": {
+    "asset_id": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![Hh][Tt][Tt][Pp][Ss]?://).*\\S.*$",
+      "description": "DAM 素材 ID；不接受 URL。"
+    },
+    "repositoryId": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "所属资源库 ID。"
+    },
+    "permanent": { "type": "boolean", "description": "是否继续永久删除。" }
+  }
+}

package/contracts/operations/dam.delete/output.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamDeleteOutput",
+  "description": "DAM 素材删除成功后没有业务结果。",
+  "type": "null"
+}

package/contracts/operations/dam.get/input.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamGetInput",
+  "description": "DAM 素材详情参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["asset_id"],
+  "properties": {
+    "asset_id": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![Hh][Tt][Tt][Pp][Ss]?://).*\\S.*$",
+      "description": "DAM 素材 ID；不接受 URL。"
+    }
+  }
+}

package/contracts/operations/dam.get/output.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamAssetDetail",
+  "description": "DAM 素材完整信息。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["asset_id"],
+  "properties": {
+    "asset_id": { "$ref": "#/$defs/nonblank", "description": "素材 ID。" },
+    "title": { "$ref": "#/$defs/nonblank", "description": "素材标题。" },
+    "description": { "$ref": "#/$defs/nonblank", "description": "素材描述。" },
+    "format": { "$ref": "#/$defs/nonblank", "description": "文件格式。" },
+    "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+    "size": { "type": "integer", "minimum": 0, "description": "文件字节数。" },
+    "url": { "type": "string", "format": "uri", "description": "素材访问 URL。" },
+    "cover_url": { "type": "string", "format": "uri", "description": "封面 URL。" },
+    "width": { "type": "integer", "minimum": 0, "description": "像素宽度。" },
+    "height": { "type": "integer", "minimum": 0, "description": "像素高度。" },
+    "duration": { "type": "number", "minimum": 0, "description": "媒体时长，单位为秒。" },
+    "repository_id": { "$ref": "#/$defs/nonblank", "description": "资源库 ID。" },
+    "repository_name": { "$ref": "#/$defs/nonblank", "description": "资源库名称。" },
+    "folder_id": { "$ref": "#/$defs/nonblank", "description": "文件夹 ID。" },
+    "folder_name": { "$ref": "#/$defs/nonblank", "description": "文件夹名称。" },
+    "tag_ids": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/stringOrNumber" },
+      "description": "标签 ID。"
+    },
+    "analysis_status": { "$ref": "#/$defs/stringOrNumber", "description": "分析状态。" },
+    "created_at": { "type": "string", "format": "date-time", "description": "创建时间。" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "更新时间。" }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    },
+    "stringOrNumber": {
+      "oneOf": [
+        { "$ref": "#/$defs/nonblank" },
+        { "type": "number" }
+      ]
+    }
+  }
+}

package/contracts/operations/dam.list/input.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamListInput",
+  "description": "DAM 素材列表参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "not": {
+    "properties": { "repositoryId": true, "allRepositories": true },
+    "required": ["repositoryId", "allRepositories"]
+  },
+  "properties": {
+    "repositoryId": { "$ref": "#/$defs/nonblank", "description": "指定资源库 ID。" },
+    "allRepositories": { "type": "boolean", "description": "是否查询全部可访问资源库。" },
+    "folderId": { "$ref": "#/$defs/nonblank", "description": "指定文件夹 ID。" },
+    "includeChildFolder": { "type": "boolean", "description": "是否包含子文件夹。" },
+    "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+    "assetFormats": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "文件格式筛选。"
+    },
+    "tagIds": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "标签 ID 筛选。"
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "DAM 请求的分页大小。"
+    },
+    "cursor": { "$ref": "#/$defs/nonblank", "description": "分页游标。" }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    }
+  }
+}

package/contracts/operations/dam.list/output.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamListResult",
+  "description": "一页 DAM 素材概要。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repository_ids", "page_size", "total", "finish", "assets"],
+  "properties": {
+    "repository_ids": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "本次查询的资源库 ID。"
+    },
+    "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "description": "本次 DAM 请求的分页大小。" },
+    "total": { "type": "integer", "minimum": 0, "description": "匹配素材总数。" },
+    "finish": { "type": "boolean", "description": "是否已到最后一页。" },
+    "next_cursor": { "$ref": "#/$defs/nonblank", "description": "下一页游标。" },
+    "assets": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/assetSummary" },
+      "description": "素材概要。"
+    }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    },
+    "stringOrNumber": {
+      "oneOf": [
+        { "$ref": "#/$defs/nonblank" },
+        { "type": "number" }
+      ]
+    },
+    "assetSummary": {
+      "title": "DamAssetSummary",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["asset_id"],
+      "properties": {
+        "asset_id": { "$ref": "#/$defs/nonblank", "description": "素材 ID。" },
+        "title": { "$ref": "#/$defs/nonblank", "description": "素材标题。" },
+        "format": { "$ref": "#/$defs/nonblank", "description": "文件格式。" },
+        "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+        "size": { "type": "integer", "minimum": 0, "description": "文件字节数。" },
+        "url": { "type": "string", "format": "uri", "description": "素材访问 URL。" },
+        "cover_url": { "type": "string", "format": "uri", "description": "封面 URL。" },
+        "width": { "type": "integer", "minimum": 0, "description": "像素宽度。" },
+        "height": { "type": "integer", "minimum": 0, "description": "像素高度。" },
+        "repository_id": { "$ref": "#/$defs/nonblank", "description": "资源库 ID。" },
+        "folder_id": { "$ref": "#/$defs/nonblank", "description": "文件夹 ID。" },
+        "folder_name": { "$ref": "#/$defs/nonblank", "description": "文件夹名称。" },
+        "tags": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nonblank" },
+          "description": "标签名称。"
+        },
+        "tag_ids": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/stringOrNumber" },
+          "description": "标签 ID。"
+        },
+        "analysis_status": { "$ref": "#/$defs/stringOrNumber", "description": "分析状态。" },
+        "created_at": { "type": "string", "format": "date-time", "description": "创建时间。" },
+        "updated_at": { "type": "string", "format": "date-time", "description": "更新时间。" }
+      }
+    }
+  }
+}

package/contracts/operations/dam.search/input.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamSearchInput",
+  "description": "DAM 素材搜索参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["query"],
+  "not": {
+    "properties": { "repositoryId": true, "allRepositories": true },
+    "required": ["repositoryId", "allRepositories"]
+  },
+  "properties": {
+    "query": { "$ref": "#/$defs/nonblank", "description": "搜索关键词。" },
+    "repositoryId": { "$ref": "#/$defs/nonblank", "description": "指定资源库 ID。" },
+    "allRepositories": { "type": "boolean", "description": "是否查询全部可访问资源库。" },
+    "folderId": { "$ref": "#/$defs/nonblank", "description": "指定文件夹 ID。" },
+    "includeChildFolder": { "type": "boolean", "description": "是否包含子文件夹。" },
+    "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+    "assetFormats": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "文件格式筛选。"
+    },
+    "tagIds": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "标签 ID 筛选。"
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "DAM 请求的分页大小。"
+    },
+    "cursor": { "$ref": "#/$defs/nonblank", "description": "分页游标。" }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    }
+  }
+}

package/contracts/operations/dam.search/output.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamSearchResult",
+  "description": "一页 DAM 素材搜索结果。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repository_ids", "page_size", "total", "finish", "assets"],
+  "properties": {
+    "repository_ids": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "本次查询的资源库 ID。"
+    },
+    "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "description": "本次 DAM 请求的分页大小。" },
+    "total": { "type": "integer", "minimum": 0, "description": "匹配素材总数。" },
+    "finish": { "type": "boolean", "description": "是否已到最后一页。" },
+    "next_cursor": { "$ref": "#/$defs/nonblank", "description": "下一页游标。" },
+    "assets": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/assetSummary" },
+      "description": "素材概要。"
+    }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    },
+    "stringOrNumber": {
+      "oneOf": [
+        { "$ref": "#/$defs/nonblank" },
+        { "type": "number" }
+      ]
+    },
+    "assetSummary": {
+      "title": "DamAssetSummary",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["asset_id"],
+      "properties": {
+        "asset_id": { "$ref": "#/$defs/nonblank", "description": "素材 ID。" },
+        "title": { "$ref": "#/$defs/nonblank", "description": "素材标题。" },
+        "format": { "$ref": "#/$defs/nonblank", "description": "文件格式。" },
+        "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+        "size": { "type": "integer", "minimum": 0, "description": "文件字节数。" },
+        "url": { "type": "string", "format": "uri", "description": "素材访问 URL。" },
+        "cover_url": { "type": "string", "format": "uri", "description": "封面 URL。" },
+        "width": { "type": "integer", "minimum": 0, "description": "像素宽度。" },
+        "height": { "type": "integer", "minimum": 0, "description": "像素高度。" },
+        "repository_id": { "$ref": "#/$defs/nonblank", "description": "资源库 ID。" },
+        "folder_id": { "$ref": "#/$defs/nonblank", "description": "文件夹 ID。" },
+        "folder_name": { "$ref": "#/$defs/nonblank", "description": "文件夹名称。" },
+        "tags": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nonblank" },
+          "description": "标签名称。"
+        },
+        "tag_ids": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/stringOrNumber" },
+          "description": "标签 ID。"
+        },
+        "analysis_status": { "$ref": "#/$defs/stringOrNumber", "description": "分析状态。" },
+        "created_at": { "type": "string", "format": "date-time", "description": "创建时间。" },
+        "updated_at": { "type": "string", "format": "date-time", "description": "更新时间。" }
+      }
+    }
+  }
+}

package/contracts/operations/dam.upload/input.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamUploadInput",
+  "description": "DAM 素材上传参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["file"],
+  "properties": {
+    "file": { "$ref": "#/$defs/nonblank", "description": "本地文件路径。" },
+    "repositoryId": { "$ref": "#/$defs/nonblank", "description": "目标资源库 ID。" },
+    "title": { "$ref": "#/$defs/nonblank", "description": "素材标题。" },
+    "folderId": { "$ref": "#/$defs/nonblank", "description": "目标文件夹 ID。" },
+    "tagIds": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonblank" },
+      "description": "素材标签 ID。"
+    },
+    "allowSensitivePath": {
+      "type": "boolean",
+      "description": "是否明确允许受保护路径。"
+    },
+    "waitAnalysis": {
+      "type": "boolean",
+      "description": "是否等待素材分析结束。"
+    }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" }
+  }
+}

package/contracts/operations/dam.upload/output.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamUploadOutput",
+  "description": "已上传并入库的 DAM 素材。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["asset_id"],
+  "properties": {
+    "asset_id": { "$ref": "#/$defs/nonblank", "description": "素材 ID。" },
+    "title": { "$ref": "#/$defs/nonblank", "description": "素材标题。" },
+    "description": { "$ref": "#/$defs/nonblank", "description": "素材描述。" },
+    "format": { "$ref": "#/$defs/nonblank", "description": "文件格式。" },
+    "type": { "$ref": "#/$defs/assetType", "description": "素材类型。" },
+    "size": { "type": "integer", "minimum": 0, "description": "文件字节数。" },
+    "url": { "type": "string", "format": "uri", "description": "素材访问 URL。" },
+    "cover_url": { "type": "string", "format": "uri", "description": "封面 URL。" },
+    "width": { "type": "integer", "minimum": 0, "description": "像素宽度。" },
+    "height": { "type": "integer", "minimum": 0, "description": "像素高度。" },
+    "duration": { "type": "number", "minimum": 0, "description": "媒体时长，单位为秒。" },
+    "repository_id": { "$ref": "#/$defs/nonblank", "description": "资源库 ID。" },
+    "repository_name": { "$ref": "#/$defs/nonblank", "description": "资源库名称。" },
+    "folder_id": { "$ref": "#/$defs/nonblank", "description": "文件夹 ID。" },
+    "folder_name": { "$ref": "#/$defs/nonblank", "description": "文件夹名称。" },
+    "tag_ids": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/stringOrNumber" },
+      "description": "标签 ID。"
+    },
+    "analysis_status": { "$ref": "#/$defs/stringOrNumber", "description": "分析状态。" },
+    "created_at": { "type": "string", "format": "date-time", "description": "创建时间。" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "更新时间。" }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "assetType": {
+      "type": "string",
+      "enum": ["image", "video", "audio", "font", "template", "file"]
+    },
+    "stringOrNumber": {
+      "oneOf": [
+        { "$ref": "#/$defs/nonblank" },
+        { "type": "number" }
+      ]
+    }
+  }
+}