docs: synced via GitHub Actions

Author: nop-cao

src/dev-guide/vfs/vfs.md

@@ -53,6 +53,56 @@ data名字空间下的路径根据`nop.core.resource.store.data-root-dir`配置
 
 |名称|缺省值|说明|
 |---|---|---|
-|nop.core.vfs.delta-layer-ids|default|指定差量文件系统的Delta层,例如\_platform,product,app。对应/\_delta/product等虚拟路径|
-||||
+|nop.core.vfs.delta-layer-ids|default|指定差量文件系统的Delta层,例如_platform,product,app。对应/_delta/product等虚拟路径|
+|nop.core.vfs.lib-paths|无|指定差量文件系统的Delta层所在的目录或者jar文件,其中_vfs子目录为虚拟文件目录|
+|||
+
+## nop.core.vfs.lib-paths 配置详解
+
+`nop.core.vfs.lib-paths` 参数用于指定额外的资源库路径，这些路径中的 `_vfs` 目录下的文件会被合并到虚拟文件系统中。
+
+### 参数格式
+- **类型**: 字符串列表，多个路径用逗号分隔
+- **示例**: `/path/to/lib1.jar,/path/to/lib2/dir`
+
+### 功能说明
+
+1. **支持JAR文件**: 如果指定的是JAR文件，系统会扫描JAR包中的 `_vfs` 目录，将其内容添加到虚拟文件系统
+   - 示例：`nop.core.vfs.lib-paths=/home/user/lib/nop-auth.jar`
+   - 系统会扫描 `nop-auth.jar` 中的 `_vfs` 目录
+
+2. **支持目录**: 如果指定的是目录，系统会检查该目录下的 `_vfs` 子目录
+   - 示例：`nop.core.vfs.lib-paths=/home/user/lib`
+   - 系统会扫描 `/home/user/lib/_vfs` 目录
+
+3. **优先级规则**: 排在前面的路径优先级更高，会覆盖后续路径中的同名文件
+   - 示例：`nop.core.vfs.lib-paths=/path/lib1.jar,/path/lib2.jar`
+   - `lib1.jar` 中的文件会覆盖 `lib2.jar` 中的同名文件
+
+### 使用场景
+
+1. **模块化部署**: 可以将不同的功能模块打包成独立的JAR文件，通过 `lib-paths` 配置动态加载
+2. **热更新**: 通过修改 `lib-paths` 配置，可以动态添加或替换资源文件，实现热更新功能
+3. **环境隔离**: 不同环境可以使用不同的资源库路径，实现配置隔离
+
+### 配置示例
+
+```yaml
+# bootstrap.yaml 配置示例
+nop:
+  core:
+    vfs:
+      lib-paths: /opt/nop/libs/nop-auth.jar,/opt/nop/libs/nop-wf.jar
+```
+
+```properties
+# application.properties 配置示例
+nop.core.vfs.lib-paths=/opt/nop/libs/nop-auth.jar,/opt/nop/libs/nop-wf.jar
+```
+
+### 注意事项
+
+- 路径必须是绝对路径
+- JAR文件必须包含有效的 `_vfs` 目录结构
+- 配置变更后需要重启应用或调用 `VirtualFileSystem.instance().refresh(true)` 刷新缓存|
 ||||