update docs

Author: wu-clan

docs/.vuepress/_bulletin.md

@@ -3,7 +3,7 @@
 fba 已新增多租户模式适配：
 
 - 开启方式：`TENANT_ENABLED = True`
-- 完整能力：安装 [tenant 插件](https://fastapi-practices.github.io/fastapi_best_architecture_docs/marketplace.html)
+- 完整能力：安装 [tenant](https://fastapi-practices.github.io/fastapi_best_architecture_docs/marketplace.html) 插件
 
 ::: caution
 当前为实验性实施，相关适配可参考 [PR #1101](https://github.com/fastapi-practices/fastapi-best-architecture/pull/1101)

docs/.vuepress/navbar.ts

@@ -4,6 +4,16 @@ export const myNavbar: ThemeNavItem[] = defineNavbarConfig([
     {
         text: 'Guide',
         items: [
+            {
+                text: '工程化',
+                items: [
+                    {
+                        text: 'CLI',
+                        icon: 'glyphs:cli-bold',
+                        link: '/cli'
+                    }
+                ]
+            },
             {
                 text: '后端',
                 items: [

docs/cli.md

@@ -0,0 +1,24 @@
+---
+title: CLI
+---
+
+此 CLI 工具的实现与后端内置存在些许不同，目标用于完整的前后端工程
+
+功能点包含：
+
+- 一键创建、配置、管理 fba 工程（交互式引导流程）
+- 一键运行 fba / fba_ui 项目
+- 前后端插件一键管理
+- ...
+
+如果你正在通过 fba 前后端构建项目，此工具将大幅简化项目初始化和日常开发操作
+
+## 使用方式
+
+1. 安装 fba-cli
+
+   ```bash
+   npm install -g @fba/cli
+   ```
+
+2. 通过在终端输入 `fba-cli -h` 获取相关信息

docs/plugin/dev.md

@@ -275,6 +275,7 @@ IDE 获取全局配置键入提示，这是必需的，相反，你们将无法
         - index.vue
         - …
     - … 更多内容
+    - plugin.toml 插件配置文件 <Badge type="danger" text="必须" />
 
 :::
 

docs/plugin/install.md

@@ -7,18 +7,11 @@ title: 插件安装
 :::: tabs
 @tab CLI
 
-1. 通过在命令行输入 `fba add -h` 获取相关信息
+1. 通过在终端输入 `fba add -h` 获取相关信息
 2. 通过 `fba add` 命令进行安装
 3. 根据插件说明（README.md）进行相关配置
 4. 重启服务
 
-@tab GIT
-
-1. 获取插件 git 仓库地址，理论上支持任何平台（GitHub、Gitlab、Gitee、Gitea...）
-2. 通过 fba git 插件安装接口进行安装
-3. 根据插件说明（README.md）进行相关配置
-4. 重启服务
-
 @tab ZIP
 
 1. 获取打包好的插件 zip 压缩包 <Badge type="warning" text="二选一" />
@@ -38,7 +31,7 @@ title: 插件安装
 @tab 手动
 
 1. 获取插件仓库源码并下载
-2. 将下载的源码文件夹直接拷贝到 `backend/plugin` 目录下
+2. 将下载的源码文件夹拷贝到 `backend/plugin` 目录下（插件文件夹需要与仓库名保持一致）
 3. 根据插件说明（README.md）进行相关配置
 4. 重启服务
 
@@ -50,6 +43,24 @@ title: 插件安装
 
 ## 前端
 
+::: tabs
+@tab CLI
+
+1. 安装 fba-cli
+
+   ```bash
+   npm install -g @fba/cli
+   ```
+
+2. 通过在终端输入 `fba-cli add -h` 获取相关信息
+3. 通过 `fba-cli add` 命令进行安装
+4. 根据插件说明（README.md）进行相关配置
+5. 重启服务
+
+@tab 手动
+
 1. 获取插件仓库源码并下载
-2. 将下载的源码文件夹直接拷贝到 `apps/web-antd/src/plugins` 目录下
+2. 将下载的源码文件夹拷贝到 `apps/web-antd/src/plugins` 目录下（插件文件夹需要删除 `_ui` 后缀）
 3. 重启服务
+
+:::

docs/plugin/share.md

@@ -7,15 +7,11 @@ title: 插件分享
 ## 后端
 
 ::: warning 插件仓库命名规则
-`仓库名 == 插件名`
+`插件名 == 仓库名` -> `ai == ai`
 
 插件总是独一无二的，不允许安装同名插件，所以在对插件进行命名时，应尽量保持其独特性
 :::
 
-假如仓库名为 `sms`，安装此插件后，`backend/plugin` 目录下就会新增一个 `sms` 文件夹
-
-后端插件文件夹命名==不可=={.warning}随意修改，这将对整个插件内的代码造成影响
-
 :::: steps
 
 1. 创建插件 Github 仓库
@@ -38,17 +34,13 @@ title: 插件分享
 ## 前端
 
 ::: warning 插件仓库命名规则
-`仓库名_ui == 插件名_ui`
+`插件名 == 仓库名_ui` -> `ai == ai_ui`
 
-为了更好的与后端插件进行区分，需要为前端插件仓库名添加 `_ui` 后缀
+为了更好的与后端插件进行区分，必须为前端插件仓库名添加 `_ui` 后缀
 
 插件总是独一无二的，不允许安装同名插件，所以在对插件进行命名时，应尽量保持其独特性
 :::
 
-假如仓库名为 `sms_ui`，安装此插件后，`apps/web-antd/src/plugins` 目录下就会新增一个 `sms_ui` 文件夹
-
-前端插件文件夹命名==可=={.warning}随意修改，这不会对插件内的代码造成影响
-
 :::: steps
 
 1. 创建个人插件仓库