docs: Clarify JS engine init; use switches in settings (#73)

Author: HowieHz

README.md

@@ -666,7 +666,7 @@ extraApiJsRenderFinder.highlightCodeInHtml(htmlContent)
         - 文章内容 (`post`)
         - 页面内容 (`page`)
 - 性能说明：
-    - 命中缓存时响应速度极快（微秒级），首次渲染需要 1-3 秒初始化 JS 环境
+    - 命中缓存时响应速度极快（微秒级），首次实际调用 JS 渲染时需要 1-3 秒初始化 JS 环境
     - 批量处理策略：
         - 智能分组：根据 V8 引擎池大小动态分配任务（例如 14 个任务 + 5 个引擎 → 5 组，每组 2-3 个任务）
         - 并行执行：多个任务组并行处理，充分利用多核性能
@@ -759,7 +759,13 @@ extraApiJsRenderFinder.highlightCodeInHtml(htmlContent)
 
 ## 全量版使用须知
 
-⏱️ **首次使用提示**: 全量版的 JavaScript 功能（如 Shiki 代码高亮）在首次调用时需要 1~3 秒进行环境初始化。这是正常现象，之后的调用速度会非常快。
+⏱️ **首次使用提示**: 全量版的 JavaScript 功能（如 Shiki 代码高亮）在首次实际调用时需要 1~3 秒进行环境初始化。这是正常现象，之后的调用速度会非常快。
+
+补充说明：
+
+- 全量版启动时会初始化 JS 引擎池服务对象。
+- 但不会在启动时立即创建 V8/Node 引擎实例。
+- 真正的引擎实例会在首次实际调用 JS 功能时按需创建；如果未调用相关功能，则不会创建这些引擎实例。
 
 > ⚠️ **重要**: 全量版依赖 Javet 加载 Node.js 原生库（基于 JNI），受 Halo 插件架构限制，存在[已知问题](#全量版已知问题)。
 

src/main/resources/extensions/settings.yaml

@@ -7,7 +7,7 @@ spec:
     - group: pangu
       label: 中英文混排格式化
       formSchema:
-        - $formkit: checkbox
+        - $formkit: switch
           name: enabledPanguRender
           id: enabledPanguRender
           key: enabledPanguRender
@@ -25,7 +25,7 @@ spec:
           value: 1
           min: 1
           validation: required
-          help: JS 引擎池的最小大小。每个引擎会预加载所需的 JS 模块。
+          help: JS 引擎池最少保留的空闲引擎数量。引擎按需创建，创建后会预加载所需的 JS 模块；该值不能设为 0。
         - $formkit: number
           name: poolMaxSize
           id: poolMaxSize
@@ -34,11 +34,11 @@ spec:
           value: 2
           min: 1
           validation: required
-          help: JS 引擎池的最大大小。设置过大可能导致内存溢出。每个引擎会预加载所需的 JS 模块。
+          help: JS 引擎池允许扩容到的最大引擎数量。设置过大可能导致内存占用过高甚至内存溢出。
     - group: shiki
       label: 代码高亮（仅全量版可用）
       formSchema:
-        - $formkit: checkbox
+        - $formkit: switch
           name: enabledShikiRender
           id: enabledShikiRender
           key: enabledShikiRender
@@ -259,7 +259,7 @@ spec:
               value: vitesse-dark
             - label: Vitesse Light（light）
               value: vitesse-light
-        - $formkit: checkbox
+        - $formkit: switch
           label: 明暗双倍渲染模式
           name: enabledDoubleRenderMode
           key: enabledDoubleRenderMode