update docs

Author: wu-clan

docs/.vuepress/components/PluginMarket.vue

@@ -110,6 +110,15 @@
                   />
                   <span>可用</span>
                 </label>
+                <label class="filter-badge" :class="{ active: selectedStatus === 'wip' }">
+                  <input
+                      type="radio"
+                      value="wip"
+                      v-model="selectedStatus"
+                      name="status"
+                  />
+                  <span>开发中</span>
+                </label>
                 <label class="filter-badge" :class="{ active: selectedStatus === 'expired' }">
                   <input
                       type="radio"
@@ -166,7 +175,7 @@
           <div
               v-for="(item, index) in filteredItems"
               :key="index"
-              :class="{ 'clickable': item.link, 'expired': item.expired }"
+              :class="{ 'clickable': item.link, 'expired': item.expired || item.wip }"
               class="plugin-card"
               @click="handleCardClick(item)"
           >
@@ -183,6 +192,9 @@
               <div v-if="item.expired" class="expired-overlay">
                 <span class="expired-text">已过期，不适用</span>
               </div>
+              <div v-if="item.wip" class="expired-overlay">
+                <span class="expired-text">正在开发中</span>
+              </div>
             </div>
             <div class="card-content">
               <div class="card-title-row">
@@ -208,7 +220,7 @@
                 />
               </div>
             </div>
-            <div v-if="item.expired" class="expired-overlay-card"></div>
+            <div v-if="item.expired || item.wip" class="expired-overlay-card"></div>
           </div>
         </div>
       </div>
@@ -230,6 +242,7 @@ export interface PluginItem {
   logo: string
   free?: boolean
   expired?: boolean
+  wip?: boolean
 }
 
 const props = withDefaults(
@@ -317,9 +330,11 @@ const baseFilteredItems = computed(() => {
   }
 
   if (selectedStatus.value === 'active') {
-    result = result.filter(item => !item.expired)
+    result = result.filter(item => !item.expired && !item.wip)
   } else if (selectedStatus.value === 'expired') {
     result = result.filter(item => item.expired)
+  } else if (selectedStatus.value === 'wip') {
+    result = result.filter(item => item.wip)
   }
 
   return result
@@ -481,18 +496,6 @@ const handleCardClick = (item: PluginItem) => {
   overflow: hidden;
 }
 
-.filter-content-enter-active,
-.filter-content-leave-active {
-  transition: all 0.3s ease;
-  max-height: 1000px;
-}
-
-.filter-content-enter-from,
-.filter-content-leave-to {
-  max-height: 0;
-  opacity: 0;
-}
-
 @media (max-width: 767px) {
   .filter-card.collapsed {
     margin-bottom: 0;

docs/.vuepress/data/plugin.ts

@@ -56,7 +56,7 @@ export const pluginItems: PluginItem[] = [
     {
         icon: "codicon:mcp",
         title: "MCP 服务器管理",
-        description: "提供了 MCP 服务器管理功能，并添加了可调用 MCP 的 AI 聊天接口",
+        description: "提供了 MCP 服务器管理功能，可配合 AI 插件食用",
         label: '官方',
         tags: ["MCP", "pgsql", "mysql", "后端"],
         link: "https://github.com/fastapi-practices/mcp",
@@ -65,7 +65,7 @@ export const pluginItems: PluginItem[] = [
     {
         icon: "ant-design:aliyun-outlined",
         title: "阿里云 oss",
-        description: "阿里云 oss 文件上传",
+        description: "阿里云 oss 对象存储",
         label: '官方',
         tags: ["pgsql", "mysql", "后端"],
         link: "https://github.com/fastapi-practices/aliyun_oss",
@@ -122,4 +122,24 @@ export const pluginItems: PluginItem[] = [
         image: "https://registry.npmmirror.com/@lobehub/icons-static-png/latest/files/dark/tencentcloud-color.png",
         logo: 'https://avatars.githubusercontent.com/u/67427627?v=4',
     },
+    {
+        icon: "carbon:ai-label",
+        title: "AI",
+        description: "为系统带来了 AI 赋能，是系统 AI 能力的基石",
+        label: '官方',
+        tags: ["AI", "pgsql", "mysql", "后端"],
+        link: "https://github.com/fastapi-practices/ai",
+        logo: 'https://wu-clan.github.io/picx-images-hosting/logo/fba.png',
+        wip: true,
+    },
+    {
+        icon: "logos:aws-s3",
+        title: "S3",
+        description: "提供兼容 S3 协议的对象存储能力",
+        label: '官方',
+        tags: ["S3", "pgsql", "mysql", "后端"],
+        link: "https://github.com/fastapi-practices/s3",
+        logo: 'https://wu-clan.github.io/picx-images-hosting/logo/fba.png',
+        wip: true,
+    },
 ]

docs/.vuepress/data/sponsors.ts

@@ -19,15 +19,21 @@ export const homeSponsor: Sponsor = { ...defaultSponsor };
 
 export const goldSponsors: Sponsor[] = [
     {
-        link: 'https://www.serpshot.com/logo.png',
-        href: 'https://www.serpshot.com',
-        alt: 'Serpshot',
+        link: 'https://ss-id.com/images/logo.png',
+        href: 'https://ss-id.com/#/register?code=K64cODZr',
+        alt: 'SS-ID',
         expiryTime: '2099-12-31T23:59:59',
     },
     { ...defaultSponsor }
 ]
 
 export const generalSponsors: Sponsor[] = [
+    {
+        link: 'https://www.serpshot.com/logo.png',
+        href: 'https://www.serpshot.com',
+        alt: 'Serpshot',
+        expiryTime: '2099-12-31T23:59:59',
+    },
     {
         link: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQImbvY5S8IbJ1iL6yHfExtHiAhUtLIoi7AQ&s',
         href: 'https://user.by.ltd/aff.php?aff=12215',

docs/.vuepress/public/images/cli.png

@@ -73,7 +73,7 @@ DATABASE_PASSWORD='123456'
 
 ## 解耦
 
-如果你只想保留一种数据库，请参考以下内容进行解耦：
+如果你只想保留一种数据库，参考如下：
 
 - 删除 `with_variant` 相关代码（如果存在），仅保留数据库对应的类型
 - 删除 `backend/core/conf.py` 文件中的 `DATABASE_TYPE` 及其相关的调用代码

docs/backend/reference/db.md

@@ -71,8 +71,7 @@ title: 主键
 
 1. 务必仔细查看本章节警告内容，确保数据库环境整洁
 2. 更新 `backend/core/conf.py` 中的 `DATABASE_PK_MODE` 配置为 `snowflake`
-3. 执行 `backend/sql/xxx/init_snowflake_test_data.sql` 脚本初始化测试数据
-4. 阅读 [注意事项](#注意事项)
+3. 阅读 [注意事项](#注意事项)
 
 ::: caution Windows 平台警告
 如果您正在 Windows 平台中使用 mysql >= 8.0，还需要更新 `backend/database/db.py` 文件内的 `mysql+asyncmy` 为

docs/backend/reference/pk.md

@@ -42,7 +42,16 @@ fba 仅适用于资深 Python 后端开发人员，如果您是非资深用户
    ![use_this_template](/images/use_this_template.png)
    :::
 
-5. 安装依赖
+5. env
+
+   在 `backend` 目录打开终端，执行以下命令创建环境变量文件
+
+   ```shell:no-line-numbers
+   cp .env.example .env
+   ```
+
+6. 按需修改配置文件：`backend/core/conf.py` 和 `.env`
+7. 安装依赖
 
    此项目使用 uv 作为项目管理器，建议您 [安装 uv](https://docs.astral.sh/uv/getting-started/installation/)
 
@@ -61,24 +70,18 @@ fba 仅适用于资深 Python 后端开发人员，如果您是非资深用户
    uv pip install -r requirements.txt
    ```
    :::
+8. 创建数据库表和测试数据 <Badge type="warning" text="二选一" />
 
-6. env
-
-   在 `backend` 目录打开终端，执行以下命令创建环境变量文件
+   ::: tabs
+   @tab CLI
+   在 `根目录` 打开终端，执行以下命令
 
    ```shell:no-line-numbers
-   cp .env.example .env
+   fba init
    ```
 
-7. 按需修改配置文件：`backend/core/conf.py` 和 `.env`
-8. 创建数据库表 <Badge type="warning" text="二选一" />
-
-   ::: tabs
-   @tab 自动创建
-   跳过此步骤，启动 fba 后将自动创建
-
-   @tab Alembic 迁移
-   在 `backend` 目录 打开终端
+   @tab Alembic + 手动
+   在 `根目录` 打开终端，执行以下命令
 
    生成迁移文件
 
@@ -91,11 +94,21 @@ fba 仅适用于资深 Python 后端开发人员，如果您是非资深用户
    ```shell:no-line-numbers
    alembic upgrade head
    ```
+
+   初始化测试数据
+
+   架构：执行 `backend/sql/` 目录下对应主键模式的脚本
+
+   插件：执行 `backend/plugin/sql/` 目录下对应主键模式的脚本
+
+   ```shell:no-line-numbers
+   fba --sql xxx.sql
+   ```
    :::
 
 9. 启动
 
-   在 `根目录` 打开终端，执行以下命令启动 FastAPI 服务
+   在 `根目录` 打开终端，执行以下命令
 
    ```shell:no-line-numbers
    fba run
@@ -130,17 +143,7 @@ fba 仅适用于资深 Python 后端开发人员，如果您是非资深用户
     beat 服务，相关接口将自动恢复正常
     :::
 
-11. 初始化测试数据
-
-    架构：执行 `backend/sql/` 目录下对应主键模式的脚本
-
-    插件：执行 `插件/sql/` 目录下对应主键模式的脚本
-
-    ::: info
-    你也可以选择通过 [CLI](../reference/cli.md) 快速执行这些脚本
-    :::
-
-12. 打开浏览器访问：[http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
+11. 打开浏览器访问：[http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
 
 ::::