@gaoding/cli 0.0.0 → 1.0.0-alpha.25

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

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamRepositoryListInput",
+  "description": "DAM 资源库目录参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

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

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamRepositoryListResult",
+  "description": "当前组织可用的规范化 DAM 资源库目录。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repositories"],
+  "properties": {
+    "repositories": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/repository" },
+      "description": "可被 DAM 命令直接使用的资源库。"
+    }
+  },
+  "$defs": {
+    "nonblank": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*"
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repository_id", "name", "type", "is_default"],
+      "properties": {
+        "repository_id": {
+          "$ref": "#/$defs/nonblank",
+          "description": "可直接传给 DAM 命令的资源库 ID。"
+        },
+        "name": {
+          "$ref": "#/$defs/nonblank",
+          "description": "资源库名称。"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["personal", "team", "enterprise", "draft"],
+          "description": "规范化资源库类型。"
+        },
+        "permission_code": {
+          "type": "string",
+          "enum": ["OWNER", "MANAGE", "EDIT", "USE", "READ"],
+          "description": "服务端明确返回的资源库权限。"
+        },
+        "is_default": {
+          "type": "boolean",
+          "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 素材搜索结果；服务端实际返回数量可能大于请求的 page_size。",
+  "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 请求的分页大小；实际 assets 数量可能大于该值。" },
+    "total": { "type": "integer", "minimum": 0, "description": "匹配素材总数。" },
+    "finish": { "type": "boolean", "description": "是否已到最后一页。" },
+    "next_cursor": { "$ref": "#/$defs/nonblank", "description": "下一页游标。" },
+    "assets": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/assetSummary" },
+      "description": "服务端本批返回的全部素材概要，不按 page_size 在本地截断。"
+    }
+  },
+  "$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.tag.list/input.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamTagListInput",
+  "description": "列出一个 DAM 资源库中的标签。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "repositoryId": { "$ref": "#/$defs/nonblank", "description": "资源库 ID。" },
+    "query": { "$ref": "#/$defs/nonblank", "description": "标签名称关键词。" }
+  },
+  "$defs": { "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" } }
+}

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

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "DamTagListResult",
+  "description": "DAM 标签列表结果。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repository_id", "tags"],
+  "properties": {
+    "repository_id": { "$ref": "#/$defs/nonblank" },
+    "tags": { "type": "array", "items": { "$ref": "#/$defs/tag" } }
+  },
+  "$defs": {
+    "nonblank": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+    "tag": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tag_id", "name", "asset_count"],
+      "properties": {
+        "tag_id": { "$ref": "#/$defs/nonblank" },
+        "name": { "$ref": "#/$defs/nonblank" },
+        "group_id": { "$ref": "#/$defs/nonblank" },
+        "asset_count": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

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" }
+      ]
+    }
+  }
+}

package/contracts/operations/editor.apply/input.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorApplyInput",
+  "description": "要依次应用到当前编辑器的操作。",
+  "type": "array",
+  "items": {
+    "oneOf": [
+      { "$ref": "#/$defs/EditorUpsertAction" },
+      { "$ref": "#/$defs/EditorDeleteAction" }
+    ]
+  },
+  "$defs": {
+    "EditorUpsertAction": {
+      "title": "EditorUpsertAction",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "element"],
+      "properties": {
+        "_type": {
+          "type": "string",
+          "enum": ["create", "update"],
+          "description": "创建或完整更新元素。"
+        },
+        "element": {
+          "description": "要创建或完整更新的元素。",
+          "oneOf": [
+            { "$ref": "#/$defs/EditorShape" },
+            { "$ref": "#/$defs/EditorConnector" }
+          ]
+        }
+      }
+    },
+    "EditorDeleteAction": {
+      "title": "EditorDeleteAction",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "id"],
+      "properties": {
+        "_type": {
+          "const": "delete",
+          "description": "删除元素。"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "要删除的元素 ID。"
+        }
+      }
+    },
+    "EditorShape": {
+      "title": "EditorShape",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "id", "shapeType", "x", "y", "w", "h", "fill", "stroke"],
+      "properties": {
+        "_type": {
+          "const": "shape",
+          "description": "元素类型。"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "元素 ID。"
+        },
+        "shapeType": {
+          "type": "string",
+          "enum": ["rectangle", "rounded-rectangle", "triangle-up", "ellipse", "diamond"],
+          "description": "图形类型。"
+        },
+        "x": { "type": "number", "description": "左上角横坐标。" },
+        "y": { "type": "number", "description": "左上角纵坐标。" },
+        "w": { "type": "number", "description": "宽度。" },
+        "h": { "type": "number", "description": "高度。" },
+        "text": { "type": "string", "description": "图形中的文本。" },
+        "fill": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "填充颜色。"
+        },
+        "stroke": {
+          "description": "描边颜色；null 表示无描边。",
+          "anyOf": [
+            { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "EditorConnector": {
+      "title": "EditorConnector",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "id", "fromId", "toId", "lineType", "color"],
+      "properties": {
+        "_type": {
+          "const": "connector",
+          "description": "元素类型。"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "连线 ID。"
+        },
+        "fromId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "起点元素 ID。"
+        },
+        "toId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "终点元素 ID。"
+        },
+        "lineType": {
+          "type": "string",
+          "enum": ["straight", "elbowed"],
+          "description": "连线类型。"
+        },
+        "color": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "连线颜色。"
+        }
+      }
+    }
+  }
+}

package/contracts/operations/editor.apply/output.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorApplyResult",
+  "description": "编辑器操作应用结果。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["appliedCount"],
+  "properties": {
+    "appliedCount": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "已成功应用的操作数量。"
+    }
+  }
+}

package/contracts/operations/editor.connect/input.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorConnectInput",
+  "description": "编辑器连接参数。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "target": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "作品 ID 或 AI+ Editor URL；省略时创建新作品。"
+    }
+  }
+}

package/contracts/operations/editor.connect/output.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorConnectResult",
+  "description": "已连接的编辑器页面。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["target"],
+  "properties": {
+    "target": {
+      "type": "string",
+      "format": "uri",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "已连接的 AI+ Editor URL。"
+    }
+  }
+}

package/contracts/operations/editor.disconnect/input.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorDisconnectInput",
+  "description": "断开当前编辑器连接。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/contracts/operations/editor.disconnect/output.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorDisconnectResult",
+  "description": "编辑器断开结果。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["disconnected"],
+  "properties": {
+    "disconnected": {
+      "type": "boolean",
+      "description": "是否断开了一个当前连接。"
+    }
+  }
+}

package/contracts/operations/editor.save/input.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorSaveInput",
+  "description": "保存当前编辑器作品。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/contracts/operations/editor.save/output.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorSaveResult",
+  "description": "已保存的编辑器作品。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["workId", "url"],
+  "properties": {
+    "workId": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "作品 ID。"
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "作品的 AI+ Editor URL。"
+    }
+  }
+}

package/contracts/operations/editor.screenshot/input.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorScreenshotInput",
+  "description": "导出当前编辑器截图。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/contracts/operations/editor.screenshot/output.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorScreenshotResult",
+  "description": "已导出的编辑器截图。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["path"],
+  "properties": {
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "截图在本机的绝对路径。"
+    }
+  }
+}

package/contracts/operations/editor.snapshot/input.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorSnapshotInput",
+  "description": "读取当前编辑器快照。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}