From 76b2a0504959972b38d75fb97101a0ebe2426cc9 Mon Sep 17 00:00:00 2001
From: liujuping <liujup@foxmail.com>
Date: Thu, 1 Feb 2024 16:01:36 +0800
Subject: [PATCH] docs(command): add command api docs

---
 docs/docs/api/canvas.md             |   2 +-
 docs/docs/api/command.md            | 101 ++++++++++++++++++++++++++++
 docs/docs/api/common.md             |   2 +-
 docs/docs/api/commonUI.md           |   2 +-
 docs/docs/api/config.md             |   2 +-
 docs/docs/api/configOptions.md      |   2 +-
 docs/docs/api/event.md              |   2 +-
 docs/docs/api/hotkey.md             |   2 +-
 docs/docs/api/init.md               |   2 +-
 docs/docs/api/logger.md             |   2 +-
 docs/docs/api/material.md           |   2 +-
 docs/docs/api/model/_category_.json |   2 +-
 docs/docs/api/plugins.md            |   2 +-
 docs/docs/api/project.md            |   2 +-
 docs/docs/api/setters.md            |   2 +-
 docs/docs/api/simulatorHost.md      |   2 +-
 docs/docs/api/skeleton.md           |   2 +-
 docs/docs/api/workspace.md          |   2 +-
 18 files changed, 118 insertions(+), 17 deletions(-)
 create mode 100644 docs/docs/api/command.md

diff --git a/docs/docs/api/canvas.md b/docs/docs/api/canvas.md
index 582f2354b..865b9ac31 100644
--- a/docs/docs/api/canvas.md
+++ b/docs/docs/api/canvas.md
@@ -1,6 +1,6 @@
 ---
 title: canvas - 画布 API
-sidebar_position: 12
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiCanvas](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/canvas.ts)<br/>
diff --git a/docs/docs/api/command.md b/docs/docs/api/command.md
new file mode 100644
index 000000000..fc36c8ad8
--- /dev/null
+++ b/docs/docs/api/command.md
@@ -0,0 +1,101 @@
+---
+title: command - 指令 API
+sidebar_position: 10
+---
+
+
+
+## 模块概览
+
+该模块使得与命令系统的交互成为可能，提供了一种全面的方式来处理、执行和管理应用程序中的命令。
+
+
+
+## 接口
+
+### IPublicApiCommand
+
+与命令交互的接口。它提供了注册、注销、执行和管理命令的方法。
+
+
+
+## 方法
+
+### registerCommand
+
+注册一个新命令及其处理函数。
+
+```
+typescriptCopy code
+/**
+ * 注册一个新的命令及其处理程序。
+ * @param command {IPublicTypeCommand} - 要注册的命令。
+ */
+registerCommand(command: IPublicTypeCommand): void;
+```
+
+### unregisterCommand
+
+注销一个已存在的命令。
+
+```
+typescriptCopy code
+/**
+ * 注销一个已存在的命令。
+ * @param name {string} - 要注销的命令的名称。
+ */
+unregisterCommand(name: string): void;
+```
+
+### executeCommand
+
+根据名称和提供的参数执行命令，确保参数符合命令的定义。
+
+```
+typescriptCopy code
+/**
+ * 根据名称和提供的参数执行命令。
+ * @param name {string} - 要执行的命令的名称。
+ * @param args {IPublicTypeCommandHandlerArgs} - 命令的参数。
+ */
+executeCommand(name: string, args?: IPublicTypeCommandHandlerArgs): void;
+```
+
+### batchExecuteCommand
+
+批量执行命令，在所有命令执行后进行重绘，历史记录中只记录一次。
+
+```
+typescriptCopy code
+/**
+ * 批量执行命令，随后进行重绘，历史记录中只记录一次。
+ * @param commands {Array} - 命令对象的数组，包含名称和可选参数。
+ */
+batchExecuteCommand(commands: { name: string; args?: IPublicTypeCommandHandlerArgs }[]): void;
+```
+
+### listCommands
+
+列出所有已注册的命令。
+
+```
+typescriptCopy code
+/**
+ * 列出所有已注册的命令。
+ * @returns {IPublicTypeListCommand[]} - 已注册命令的数组。
+ */
+listCommands(): IPublicTypeListCommand[];
+```
+
+### onCommandError
+
+为命令执行过程中的错误注册错误处理回调函数。
+
+```
+typescriptCopy code
+/**
+ * 为命令执行过程中的错误注册一个回调函数。
+ * @param callback {(name: string, error: Error) => void} - 错误处理的回调函数。
+ */
+onCommandError(callback: (name: string, error: Error) => void): void;
+```
diff --git a/docs/docs/api/common.md b/docs/docs/api/common.md
index 1a70436ad..c278bf2ad 100644
--- a/docs/docs/api/common.md
+++ b/docs/docs/api/common.md
@@ -1,6 +1,6 @@
 ---
 title: common - 通用 API
-sidebar_position: 11
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiCommon](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/common.ts)<br/>
diff --git a/docs/docs/api/commonUI.md b/docs/docs/api/commonUI.md
index c0bbda588..45640051f 100644
--- a/docs/docs/api/commonUI.md
+++ b/docs/docs/api/commonUI.md
@@ -1,6 +1,6 @@
 ---
 title: commonUI - UI 组件库
-sidebar_position: 11
+sidebar_position: 10
 ---
 
 ## 简介
diff --git a/docs/docs/api/config.md b/docs/docs/api/config.md
index fb631a945..414cfc979 100644
--- a/docs/docs/api/config.md
+++ b/docs/docs/api/config.md
@@ -1,6 +1,6 @@
 ---
 title: config - 配置 API
-sidebar_position: 8
+sidebar_position: 5
 ---
 
 > **@types** [IPublicModelEngineConfig](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/model/engine-config.ts)<br/>
diff --git a/docs/docs/api/configOptions.md b/docs/docs/api/configOptions.md
index 67d2fae2c..5d6e8d7ab 100644
--- a/docs/docs/api/configOptions.md
+++ b/docs/docs/api/configOptions.md
@@ -1,6 +1,6 @@
 ---
 title: config options - 配置列表
-sidebar_position: 13
+sidebar_position: 5
 ---
 
 > **@types** [IPublicTypeEngineOptions](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/engine-options.ts)<br/>
diff --git a/docs/docs/api/event.md b/docs/docs/api/event.md
index 0919b41fd..c2e86f710 100644
--- a/docs/docs/api/event.md
+++ b/docs/docs/api/event.md
@@ -1,6 +1,6 @@
 ---
 title: event - 事件 API
-sidebar_position: 7
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiEvent](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/event.ts)<br/>
diff --git a/docs/docs/api/hotkey.md b/docs/docs/api/hotkey.md
index a244b94c2..be6a3033d 100644
--- a/docs/docs/api/hotkey.md
+++ b/docs/docs/api/hotkey.md
@@ -1,6 +1,6 @@
 ---
 title:  hotkey - 快捷键 API
-sidebar_position: 5
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiHotkey](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/hotkey.ts)<br/>
diff --git a/docs/docs/api/init.md b/docs/docs/api/init.md
index 55b116a57..dd84d9c00 100644
--- a/docs/docs/api/init.md
+++ b/docs/docs/api/init.md
@@ -1,6 +1,6 @@
 ---
 title: init - 初始化 API
-sidebar_position: 10
+sidebar_position: 0
 ---
 
 > **@since** v1.0.0
diff --git a/docs/docs/api/logger.md b/docs/docs/api/logger.md
index 7493f34dc..38d986258 100644
--- a/docs/docs/api/logger.md
+++ b/docs/docs/api/logger.md
@@ -1,6 +1,6 @@
 ---
 title: logger - 日志 API
-sidebar_position: 9
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiLogger](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/logger.ts)<br/>
diff --git a/docs/docs/api/material.md b/docs/docs/api/material.md
index b6ef070b2..0e0944127 100644
--- a/docs/docs/api/material.md
+++ b/docs/docs/api/material.md
@@ -1,6 +1,6 @@
 ---
 title: material - 物料 API
-sidebar_position: 2
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiMaterial](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/material.ts)<br/>
diff --git a/docs/docs/api/model/_category_.json b/docs/docs/api/model/_category_.json
index 5b1f74b36..3afc4f79b 100644
--- a/docs/docs/api/model/_category_.json
+++ b/docs/docs/api/model/_category_.json
@@ -1,6 +1,6 @@
 {
   "label": "模型定义 Models",
-  "position": 14,
+  "position": 100,
   "collapsed": false,
   "collapsible": true
 }
diff --git a/docs/docs/api/plugins.md b/docs/docs/api/plugins.md
index e35411d3a..df025f49e 100644
--- a/docs/docs/api/plugins.md
+++ b/docs/docs/api/plugins.md
@@ -1,6 +1,6 @@
 ---
 title: plugins - 插件 API
-sidebar_position: 4
+sidebar_position: 2
 ---
 > **@types** [IPublicApiPlugins](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/plugins.ts)<br/>
 > **@since** v1.0.0
diff --git a/docs/docs/api/project.md b/docs/docs/api/project.md
index 49d319385..54bd1474c 100644
--- a/docs/docs/api/project.md
+++ b/docs/docs/api/project.md
@@ -1,6 +1,6 @@
 ---
 title: project - 模型 API
-sidebar_position: 3
+sidebar_position: 10
 ---
 ## 模块简介
 
diff --git a/docs/docs/api/setters.md b/docs/docs/api/setters.md
index cc7b6d429..0d3435b3d 100644
--- a/docs/docs/api/setters.md
+++ b/docs/docs/api/setters.md
@@ -1,6 +1,6 @@
 ---
 title: setters - 设置器 API
-sidebar_position: 6
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSetters](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/setters.ts)<br/>
 > **@since** v1.0.0
diff --git a/docs/docs/api/simulatorHost.md b/docs/docs/api/simulatorHost.md
index c7f739f6b..70eaca022 100644
--- a/docs/docs/api/simulatorHost.md
+++ b/docs/docs/api/simulatorHost.md
@@ -1,6 +1,6 @@
 ---
 title: simulatorHost - 模拟器 API
-sidebar_position: 3
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSimulatorHost](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/simulator-host.ts)<br/>
 > **@since** v1.0.0
diff --git a/docs/docs/api/skeleton.md b/docs/docs/api/skeleton.md
index 0713546e1..396fad9e9 100644
--- a/docs/docs/api/skeleton.md
+++ b/docs/docs/api/skeleton.md
@@ -1,6 +1,6 @@
 ---
 title: skeleton - 面板 API
-sidebar_position: 1
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSkeleton](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/skeleton.ts)<br/>
 > **@since** v1.0.0
diff --git a/docs/docs/api/workspace.md b/docs/docs/api/workspace.md
index 6d0714ae0..74f7d6950 100644
--- a/docs/docs/api/workspace.md
+++ b/docs/docs/api/workspace.md
@@ -1,6 +1,6 @@
 ---
 title: workspace - 应用级 API
-sidebar_position: 12
+sidebar_position: 10
 ---
 
 > **[@experimental](./#experimental)**<br/>