fix(docs): AI系统 （beta）配置介绍文档优化修改 (#1119)

在原有的 **AI系统 （beta）配置文档** 中进行了格式和文字上的优化
添加补充了集群中`adapterUrl`配置的说明

.changeset/mean-pianos-attend.md

@@ -0,0 +1,5 @@
+---
+"@scow/docs": patch
+---
+
+优化 AI 配置介绍的文档中部分格式与文字

docs/docs/deploy/config/ai/intro.md

@@ -13,7 +13,7 @@ SCOW AI当前处于Beta状态，其代码将会和SCOW主线共存，但是SCOW
 
 您可以在GitHub的Release中找到格式为`ai-beta.{数字}`的Release，这些Release以及对应的Tag均为SCOW AI的Beta发布版本。快速到所有`ai-beta.` Release的链接[点击此处](https://github.com/PKUHPC/SCOW/releases?q=ai-beta.&expanded=true)。
 
-要使用SCOW AI的具体的版本，您需要修改`install.yml`的`imageTag`为一个具体的`ai-beta.{数字}`的tag，例如：：
+要使用SCOW AI的具体的版本，您需要修改`install.yml`的`imageTag`为一个具体的`ai-beta.{数字}`的tag，例如：
 
 ```yaml title="install.yaml"
 # 指定使用Beta 1版本
@@ -24,66 +24,88 @@ imageTag: ai-beta.1
 
 ## 前期准备
 
-**AI 系统（beta）**需要您底层已部署**K8S集群**、已安装并行文件存储服务，并通过**SCOW调度器适配器**已实现对**K8S集群**的调度服务。
+### K8S 集群
 
-同时为了满足提交**AI**训练作业，使用和保存镜像等功能，需要使用第三方调度插件[Kueue](https://kueue.sigs.k8s.io/docs/)，
-第三方镜像管理仓库[Harbor](https://goharbor.io/)。
+**AI 系统（beta）** 需要用户在使用时提前部署 K8S 的集群环境。
 
-另外，在**AI 系统（beta）**中我们仍然延续**SCOW**系统的认证系统服务，采用[LDAP](../../config/auth/ldap.md)认证系统进行用户认证。
-在**K8S**集群中仍然需要像**SCOW**系统的**hpc集群**一样，在管理节点安装**LDAP服务端**，在所有节点安装**LDAP客户端**。
+当前 **AI 系统（beta）** 为试用版本，我们暂时只支持在 `docker` 容器运行时中执行镜像相关的服务，后续会陆续推出支持`ContainerD`等其他主流容器运行时的 AI 系统。
 
-### K8S集群
-
-**AI 系统（beta）**需运行在**K8S**集群服务。这需要用户在使用时提前部署**K8S**的集群环境。
-
-当前**AI 系统（beta）**为试用版本，我们暂时只支持在**docker**容器运行时中执行镜像相关的服务，后续会陆续推出支持**ContainerD**等主流容器运行时的**AI 系统**。
-当前版本**K8S**部署的主要版本信息如下：
+当前试用版本中 K8S 部署的主要版本信息如下：
 
 | **安装内容**  | **版本信息** |
 | ------------- | ------------ |
 | kubernetes    | v1.19.13     |
 | Docker Engine | 19.03.12     |
 
-### K8S调度服务
+### K8S 调度服务
+
+**AI 系统（beta）** 同样通过 **SCOW调度器适配器** 来实现对 K8S 集群的调度服务。
 
-#### 第三方调度插件Kueue
+同时为了满足提交 AI 作业、训练 AI 作业的功能，需要使用第三方调度插件 [Kueue](https://kueue.sigs.k8s.io/docs/)、 配置 **Cluster Queue** 的队列信息来协调和处理作业任务。
 
-**Kueue**是一个用于**Kubernetes**的作业排队系统。它旨在管理和优化批处理作业和其他非实时工作负载的执行。**Kueue**的安装下载参照[此链接](https://kueue.sigs.k8s.io/docs/installation/)。
+- **K8S 调度器适配器**
 
-#### 配置ClusterQueue
+  我们仍然使用 [SCOW调度器适配器](https://pkuhpc.github.io/SCOW/blog/scow-scheduler-adapter) 来实现 K8S 集群的调度服务。
 
-**ClusterQueue** 允许基于不同的策略和需求对作业进行分组管理。
+  当前版本中，我们提供了调度器适配器的适用版本的二进制文件 [scow-ai-adapter-amd64](https://mirrors.pku.edu.cn/scow/releases/)，欢迎下载进行试用。
 
-**ClusterQueue**的配置与实际部署的**K8S集群**情况紧密相关，推荐您按照[ClusterQueue](https://kueue.sigs.k8s.io/docs/concepts/cluster_queue/)和实际部署集群的详细情况进行配置。
+  K8S 调度器适配器的配置请参照[此链接](https://github.com/PKUHPC/scow-ai-adapter-config)。
 
+- **第三方调度插件 Kueue**
 
-#### K8S调度器适配器
+  **Kueue** 是一个用于 **Kubernetes** 的作业排队系统。它旨在管理和优化批处理作业和其他非实时工作负载的执行。 Kueue 的安装下载参照[此链接](https://kueue.sigs.k8s.io/docs/installation/)。
 
-在**AI 系统（beta）**中，我们仍然使用[SCOW调度器适配器](https://pkuhpc.github.io/SCOW/blog/scow-scheduler-adapter)来实现**K8S**的调度服务。
+- **配置 Cluster Queue**
 
-当前版本中，我们提供了调度器适配器的适用版本的二进制文件[scow-ai-adapter-amd64](https://mirrors.pku.edu.cn/scow/releases/)，欢迎下载进行试用。
+  Cluster Queue 允许基于不同的策略和需求对作业进行分组管理。
 
-**K8S调度器适配器**的配置请参照[此链接](https://github.com/PKUHPC/scow-ai-adapter-config)。
+  Cluster Queue 的配置与实际部署的 **K8S集群** 情况紧密相关，推荐您按照 [Cluster Queue 介绍](https://kueue.sigs.k8s.io/docs/concepts/cluster_queue/) 和实际部署集群的详细情况进行配置。
 
 ### Harbor
 
-当前 **AI 系统（beta）**版本中，我们支持通过 [Harbor](https://goharbor.io/) 仓库对镜像进行保存及管理。
+当前 **AI 系统（beta）** 版本中，为了实现镜像的保存、上传、分享、复制、删除等功能，需要您已部署可访问的 [Harbor](https://goharbor.io/) 镜像仓库。同时需要您已在 **Harbor** 上创建了用于镜像管理的项目，并在 [AI 服务配置文件](#编写-ai-服务配置)中配置该项目名称。
+
+我们在测试版本中支持通过 **http 协议** 实现的 **Harbor API V2.0** 版本接口的访问，为了您能流畅体验试用镜像功能，推荐您部署支持该版本接口的 Harbor 镜像仓库。
+
+我们在试用版的测试环境中试用的 Harbor 版本信息为 `版本v2.7.4-8693b25a`。
 
-为了实现镜像的保存、上传、分享、复制、删除等功能，需要您已部署可访问的**Harbor**镜像仓库。
+### 并行文件存储服务
 
-当前版本中，我们暂时只支持通过**Http**协议实现的**Harbor API V2.0**版本接口的访问，所以需要您部署支持该版本接口的**Harbor**镜像仓库。
+当前 **AI 系统（beta）** 版本中需要您已经提前安装部署了并行文件存储服务。
+
+### LDAP
+
+当前 **AI 系统（beta）** 版本中我们仍然延续 **SCOW** 系统的认证系统服务，采用基于 [LDAP](../../config/auth/ldap.md) 认证系统进行用户认证。
+
+在 K8S 集群中仍然需要像 **SCOW** 系统的 `hpc集群` 一样，在管理节点安装 `LDAP服务端` ，在所有节点安装 `LDAP客户端` 。
 
 
 ## 配置文件
 
+### 确认集群配置文件
+
+在当前 **AI 系统（beta）** 的试用版本中，我们暂时没有分离不同的集群系统下的 AI 服务，请您注意在部署了 **K8S** 集群的集群上进行功能体验。
+后续将会陆续实现其他服务，并实现不同集群上不同服务的分离。
+
+请在部署了 **K8S** 集群的集群配置文件中确认以下内容：
+
+在`config/clusters/{K8S集群的ID}.yml`中，修改配置(使用 **K8S适配器** 的ip地址和端口号)
+
+```yaml title="config/clusters/{K8S集群的ID}.yml"
+# 其他配置省略
+# ...
+adapterUrl: localhost:8972
+```
+
 ### 修改安装配置文件
 
-修改安装配置文件
+修改安装配置文件：
 
 ```yaml title="install.yaml"
+# 其他配置省略
+# ...
 # 确保 AI 系统会部署
 ai:
-
   # dbPassword 为 AI 系统数据库密码
   # 在系统第一次启动前可自由设置，使用此密码可以以 root 身份登录数据库
   # 一旦数据库启动后即不可修改
@@ -96,7 +118,6 @@ ai:
 在`config/ai/config.yaml`文件中，根据备注修改所需要的配置
 
 ```yaml title="config/ai/config.yaml"
-
 # AI 系统服务的 url，默认不修改
 url: ai:5000
 # AI 系统数据库的信息。可以不修改
@@ -107,19 +128,19 @@ db:
   password: must!chang3this
   dbName: scow_ai
   debug: true
-# AI 系统镜像保存 HARBOR 仓库
+# AI 系统镜像保存 Harbor 仓库配置
 harborConfig:
-  # HARBOR 仓库地址
+  # Harbor 仓库地址
   url: 10.0.0.xxx
-  # Harbor 仓库项目名称
+  # Harbor 仓库中用于当前系统镜像管理的已存在的项目名称
   project: projectName
-  # Harbor 仓库可登录用户的用户名(需具有 HARBOR API V2.0 接口调用权限)
+  # Harbor 仓库可登录用户的用户名
+  # (建议使用上述项目的项目管理员以上权限人员，需具有 API 2.0 接口访问权限)
   user: user
   # Harbor 仓库可登录用户的登录密码
   password: password
-
 ```
 
 ## 启动服务
 
-运行`./cli compose up -d`启动 **AI 系统（beta）**服务。
+运行 `./cli compose up -d` 启动 **AI 系统（beta）** 服务。