v1.3.2-beta（20260116）

1. 代码生成器：新增窗口展示方式配置

本次升级，代码生成器支持灵活切换窗口的展示方式。可根据业务需求，在【弹窗 Dialog】和【抽屉 Drawer】之间自由选择，实现页面弹出的交互优化。

• 支持两种展示模式：弹窗（Dialog）与抽屉（Drawer）。
• 切换后可让表单、详情等界面以不同形态呈现，提升页面可用性与美观度。

窗口展示方式切换示例：

弹窗模式：

抽屉模式：

---

2. （前端）参数管理与 OSS 组件私有/公有访问能力升级

TIP

本次“资源访问模式”与 OSS 组件私有/公有访问能力的升级为兼容性增强，不会对当前数据库中已存储的资源地址数据造成任何影响，请放心升级。

本次升级在参数管理中引入“资源访问模式”参数，并全面支持 OSS 资源的私有化访问场景，涉及全部主流文件与图片加载组件适配。

一、新增“资源访问模式”参数及实时同步

• 在参数表单中增加“是否否前端加载”选项（是/否）。
• 可通过该属性切换前端关键资源（如 Minio OSS 文件）的访问方式：
  • 选择 public 时，前端直接使用数据库中存储的完整资源 URL 进行加载，适用于公开资源；
  • 选择 private 时，前端通过 Minio 获取临时授权地址访问资源，适用于需鉴权保护的私有资源。

“是否前端加载”为“是”时，参数将自动加载到前端缓存中。可通过 configStore 快速获取相关参数：

const configStore = useConfigStore();
const accessMode = configStore.getConfigOption('oss.accessMode');

二、参数加载与实时同步机制

• 参数加载时机

  • 页面首次加载（或 F5 刷新）时会自动拉取参数，保证使用最新配置；

    

  • 【全新支持】已集成 WebSocket 实时同步：当系统参数发生变更并通过 WebSocket 推送后，前端将第一时间自动接收并完成参数的热更新（无需刷新页面）。

  • 使用此能力需确保已开启并正确配置 WebSocket，如下图所示为加载触发效果：

  

三、OSS 私有访问地址支持组件列表

为了更好地支持 private 权限的 Minio 资源访问，系统已同步对以下组件进行适配升级：

• Avatar 头像组件：实现头像图片 OSS 私有访问地址的获取与展示。
• FileDownloadList 文件回显展示组件：支持私有文件回显通过临时授权地址动态加载。
• Img 单图组件：支持加载和回显私有图片资源。
• Imgs 多图片组件：支持批量回显私有授权图片资源。
• 账户管理 - 添加/编辑用户页面：头像字段支持私有 OSS 地址加载。

上述组件均会按资源访问模式自动判断并加载私有或公有预览地址，无需手动切换。

四、富文本 OSS 空间独立配置

富文本场景默认面向公共展示，现已支持独立 bucket 空间配置：

• JoditEditor 富文本组件：通过 oss.richtextBucketName 指定专用 bucket，始终以 public 方式访问，避免私有临时地址失效困扰。

五、自定义获取 OSS 预览地址的通用方法

为方便自定义组件或业务逻辑中按需获取私有 OSS 资源临时访问地址，系统提供了统一的公共方法：

// oss.ts 文件
// 使用方式
await getOssPreviewUrl(data.url)

调用该方法即可自动判断资源访问模式，按需获取对应的预览地址，大幅简化自定义集成流程。

---

3. WebSocket 实时同步能力扩展

本次升级扩展了 WebSocket 实时推送机制，除了支持前端参数的同步（如资源访问模式等），现已全面支持字典数据与权限数据的实时同步。 当后端发生字典、权限变更时，前端无需刷新页面即可自动接收最新配置，显著优化系统的数据时效性和一致性体验。

• 支持同步数据范围：全局参数、字典枚举、权限配置等主干数据。
• 无需用户手动操作，WebSocket 推送实现秒级感知和更新。

注：如需启用该能力，请确保后端已正确开启并配置 WebSocket 服务。

---

4. oss.yml 配置参数同步变更说明

本次升级对 OSS 相关配置文件 oss.yml 进行了调整和补充，以更好地适配不同业务场景下的资源访问需求，尤其新增了富文本专用存储桶参数，便于公用文件的管理和访问。请根据实际情况及时同步更新配置文件。

oss.yml

oss:
  # 支持S3协议的厂商
  provider: MINIO
  endpoint: 192.168.56.101:9000
  accessKey: a4jtJvgEmk4ead5dzac6
  secretKey: UW6kxTGRetIAahV759rFkgoQ8ilXLRUMW0ULdIoo
  # 全局存储桶，偏私有存储
  bucketName: test
  domain: http://192.168.56.101:9000
  richtextBucketName: static # 富文本专用存储桶，偏公用存储
  # 命名方式: UUID、ORIGINAL原文件名偏好，冲突会补充时间
  naming: original
  scheme: http

• 新增配置项说明：
  • richtextBucketName：用于富文本内容专属的 OSS 存储桶，通常为公开访问，建议独立于主业务存储桶，以便权限与内容分离管理。
  • 其余参数与原有版本一致，可继续沿用。

---