feat: reference and cli docs ok

Signed-off-by: seven <zilisheng1996@gmail.com>

Author: Blankll

docs/cli.md

@@ -0,0 +1,37 @@
+# ServerlessInsight 命令行
+
+一下将列举ServerlessInsight所支持的所有命令以及具体使用方法。ServerlessInsight可以通过`si -h` 查看对应命令的帮助文档。
+
+## validate 校验配置文件
+
+`validate`命令用于校验`serverlessinsight.yml`配置文件是否合法，校验通过将输出成功信息，否则返回错误信息。
+
+```bash
+si validate
+```
+
+![validate校验成功示例](/cli-validate-success.png)
+
+## deploy 部署Serverless应用
+
+`deploy`命令用于部署Serverless应用到指定的Serverless供应商中。
+
+```bash
+si deploy --stage dev <stackName>
+```
+
+其中\<stackName\>是必选项，用以指定资源栈的名称,deploy命令还支持如下参数：
+
+- **--stage/-s**: 指定部署的环境，默认值为`default`。
+- **--parameter/-p**: 传递变量值并覆盖默认值。
+- **--file/-f**: 指定部署的配置文件，默认值为`serverlessinsight.yml`。
+
+## destroy 销毁Serverless应用
+
+`destroy`命令用于销毁Serverless应用。
+
+```bash
+si destroy --stage dev <stackName>
+```
+
+- **--stage/-s**: 指定部署的环境，默认值为`default`。

docs/getting-started.md

@@ -177,5 +177,6 @@ Service hello-world-api deployed successfully
 si destory --stage dev <stackName>
 ```
 
-<span style="color: red;">**注意:**
-删除资源栈会删除所有申明的资源导致服务完全不可用且丢失有状态资源的数据，请确保相关数据、内容已备份或确认不再需要后执行该操作</span>
+<span style="color: red;">
+**注意:** 删除资源栈会删除所有申明的资源导致服务完全不可用且丢失有状态资源的数据，请确保相关数据、内容已备份或确认不再需要后执行该操作
+</span>

docs/public/cli-validate-success.png

@@ -0,0 +1,168 @@
+# 用户手册
+
+本文档概述了ServerlessInsight的规范，详细介绍了IaC（基础设施即代码）的YAML定义。
+
+## serverlessinsight Yaml配置规范
+
+ServerlessInsight的YAML配置文件是一个描述Serverless应用的资源的文件，它包含了Serverless应用的所有资源定义，如函数、API网关、事件等。以下是一个ServerlessInsight的YAML配置文件的示例：
+
+> stack.yml
+
+```yaml
+version: 0.1
+provider: aliyun
+
+vars:
+  region: cn-hangzhou
+  account_id: 1234567890
+
+stages:
+  dev:
+    region: ${vars:region}
+    account_id: ${vars:account_id}
+
+service: insight-poc
+
+tags:
+  owner: geek-fun
+
+functions:
+  insight_poc_fn:
+    name: insight-poc-fn
+    runtime: nodejs18
+    handler: ${vars.handler}
+    code: artifacts/artifact.zip
+    memory: 512
+    timeout: 10
+    environment:
+      NODE_ENV: production
+      TEST_VAR: ${vars.testv}
+      TEST_VAR_EXTRA: abcds-${vars.testv}-andyou
+
+events:
+  gateway_event:
+    type: API_GATEWAY
+    name: insight-poc-gateway
+    triggers:
+      - method: GET
+        path: /api/hello
+        backend: insight-poc-fn
+
+```
+
+如上，一个典型的ServerlessInsight定义包含了`version`、`provider`、`vars`、`stages`、`service`、`tags`、`functions`和`events`
+字段。我们来逐个解释一下这个YAML文件的各个部分：
+
+## version
+
+`version`字段指定了ServerlessInsight的YAML配置文件的版本，目前只支持`0.1`版本。
+注意主版本之间可能会有不兼容的变化，所以请确保您的配置文件与ServerlessInsight的版本兼容。
+
+```yaml
+version: 0.1
+```
+
+## provider
+
+`provider`字段指定了ServerlessInsight的提供商，包括`aliyun`、`huawei`、`tencent`等，目前只支持`aliyun`，其他提供商的支持正在开发中。
+
+```yaml
+provider: aliyun
+```
+
+## vars
+
+`vars`字段是一个对象，用于定义一些变量，这些变量可以在其他地方引用。在部署时，可以通过`--parameter key=var`或`-p key=var`
+传递变量值并覆盖默认值。
+变量可以通过`${vars.var_name}`的方式在模版中进行引用。
+
+```yaml
+vars:
+  bucket_name: my-bucket
+  domain_name: my-domain
+```
+
+## stages
+
+`stages`字段是一个对象，用于定义不同stage下的的配置项的值。最佳实践是将部署环境相关的配置项放在`stages`
+字段下，使得不同环境下相同的配置项可以被赋予不同的值，如:
+
+```yaml
+stages:
+  default:
+    domain_name: my-domain-dev.com
+    database_name: my-database-dev
+  local:
+    domain_name: localhost
+    database_name: localhost
+  dev:
+    domain_name: my-domain-dev.com
+    database_name: my-database-dev
+  prod:
+    domain_name: my-domain-prod.com
+    database_name: my-database-prod
+```
+
+在stages中的变量可以通过`${stages.domain_name}`的方式在模版中进行引用,无需指定stage, 在部署/启动服务时，通过`--stage`或
+`-s`参数指定部署的环境，如`si deploy --stage prod`，模版便会引用对于stage的变量值。如果不指定stage，默认使用`default`。
+
+## service
+
+`service`字段指定了Serverless应用的名称。`service`
+字段是一个全局唯一的标识符，用于区分不同的Serverless应用。不同于命令行中传递的 \<stackName\>
+参数，service的值将作为隐形创建资源的ID以及资源名称前缀，且service需要区分部署的stage，所以最佳实践是将service命名为
+`<service>-<stage>`。
+
+```yaml
+service: insight-poc-${stage}
+```
+
+> 注意，${stage}是ServerlessInsight提供的全局预定义变量，表示当前部署的stage，值为命令行中指定的stage或默认值`default`。
+
+## tags
+
+`tags`字段是一个对象，用于定义一些标签。在这个例子中，我们定义了`owner`标签。
+
+## functions
+
+`functions`字段是一个对象，用于定义serverless方法。functions下的每一个子项都是一个方法的定义。function支持的字段有：
+
+- **name**: serverless方法的名称
+  > 支持的字符集为`a-zA-Z0-9-_`,长度为1-64个字符
+  > required: true
+- **runtime**: serverless方法的运行时
+  > 支持的运行时:
+  nodejs20,nodejs18,nodejs16,nodejs14,nodejs12,nodejs10,nodejs8,python3.10,python3.9,python3,PHP7.2,Java11,.NETCore3.1,Go1.x
+- **handler**: serverless方法的处理程序
+  > required: true
+- **code**: serverless方法的代码包相对项根目录的路径
+  > 当前仅支持zip格式的代码包
+  > required: true
+- **timeout**: serverless方法的超时时间
+  > 默认值: 15分钟
+- **memory**: serverless方法的内存大小
+  > 默认值: 128MB
+- **environment**: serverless方法的环境变量
+  > 支持的字符集为`a-zA-Z0-9-_`,长度为1-64个字符
+  > required: false
+
+## events
+
+`events`字段是一个对象，用于定义事件。事件是发起函数调用的触发器。可以是一个来自用户的通过api gateway转发的http请求
+也可以是来自消息队列，数据库状态改变的事件等，events下的每一个子项都是一个事件的定义。event支持的字段有：
+
+- **type**: 事件的类型（目前仅支持 API_GATEWAY）
+  > 支持的事件类型有：API_GATEWAY,SQS,S3,HTTP,Timer等
+  > required: true
+- **name**: 事件的名称
+  > required: true
+- **triggers**: 事件的触发器
+  > required: true
+    - **method**: 事件的方法
+      > required: true
+      >   支持的方法有：GET,POST,PUT,DELETE,PATCH,HEAD,OPTIONS 以及ANY
+    - **path**: 事件的路径
+      > required: true
+    - **backend**: 事件的后端，通过方法的名称，指定后端的方法，请求最终有指定的方法进行处理
+      > required: true
+

docs/reference.md

@@ -1,6 +1,6 @@
 {
   "name": "hostsless-site",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "",
   "main": "index.js",
   "scripts": {