gaoding-cli 1.0.0-alpha.10

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": {}
+}

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

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorSnapshotResult",
+  "description": "当前编辑器中的受支持元素与选区。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["elements", "selectedIds"],
+  "properties": {
+    "elements": {
+      "type": "array",
+      "description": "当前编辑器中的受支持元素。",
+      "items": {
+        "oneOf": [
+          { "$ref": "#/$defs/EditorShape" },
+          { "$ref": "#/$defs/EditorConnector" }
+        ]
+      }
+    },
+    "selectedIds": {
+      "type": "array",
+      "description": "当前选中元素的 ID。",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": ".*\\S.*"
+      }
+    }
+  },
+  "$defs": {
+    "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/model.get/input.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelGetInput",
+  "description": "读取一个创作模型完整信息的输入。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "model"
+  ],
+  "properties": {
+    "model": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "要读取的创作模型机器标识。"
+    }
+  }
+}

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

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelDetail",
+  "description": "一个创作模型的完整产品信息。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "tool",
+    "model",
+    "title",
+    "parameters"
+  ],
+  "properties": {
+    "tool": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型所属的产品创作工具。"
+    },
+    "model": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "调用模型时使用的机器标识。"
+    },
+    "title": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的展示名称。"
+    },
+    "description": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的用途说明。"
+    },
+    "usageDescription": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的使用说明。"
+    },
+    "outputMediaTypes": {
+      "type": "array",
+      "description": "模型支持的输出 MIME type。",
+      "items": {
+        "$ref": "#/$defs/NonBlankString"
+      }
+    },
+    "parameters": {
+      "type": "array",
+      "description": "当前模型允许调用者提供的公开参数。",
+      "items": {
+        "$ref": "#/$defs/ModelParameter"
+      }
+    },
+    "cost": {
+      "$ref": "#/$defs/CostRange",
+      "description": "模型当前可用配置的稿豆消耗区间。"
+    },
+    "estimatedTime": {
+      "$ref": "#/$defs/EstimatedTimeRange",
+      "description": "模型当前可用配置的预估耗时区间。"
+    }
+  },
+  "$defs": {
+    "NonBlankString": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*"
+    },
+    "CostRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "minimum",
+        "maximum"
+      ],
+      "properties": {
+        "unit": {
+          "const": "gaodou",
+          "description": "稿豆计价单位。"
+        },
+        "minimum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最低稿豆消耗。"
+        },
+        "maximum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最高稿豆消耗。"
+        }
+      }
+    },
+    "EstimatedTimeRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "minimum",
+        "maximum"
+      ],
+      "properties": {
+        "unit": {
+          "const": "second",
+          "description": "秒级耗时单位。"
+        },
+        "minimum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最短预估耗时。"
+        },
+        "maximum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最长预估耗时。"
+        }
+      }
+    },
+    "ModelParameter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "type",
+        "required"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "调用模型时使用的参数名。"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "uri",
+            "uri[]"
+          ],
+          "description": "规范化后的参数类型。"
+        },
+        "required": {
+          "type": "boolean",
+          "description": "调用当前模型时是否必须提供该参数。"
+        },
+        "description": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "参数的用途说明。"
+        },
+        "default": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object"
+            },
+            {
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "服务端声明的默认值。"
+        },
+        "options": {
+          "type": "array",
+          "description": "选择型参数当前允许的值。",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "value"
+            ],
+            "properties": {
+              "value": {
+                "$ref": "#/$defs/NonBlankString",
+                "description": "调用时提供的选项值。"
+              },
+              "label": {
+                "$ref": "#/$defs/NonBlankString",
+                "description": "选项的展示名称。"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelListInput",
+  "description": "列出当前可用创作模型的输入。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "tool": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "可选的创作工具机器标识。"
+    }
+  }
+}