# 2026-06-02 开发日志

## 1. SeaweedFS 附件路径去除 `buckets/` 前缀

- 动作：调整附件返回路径的拼接方式，将原先 `diskFileName` 中的 `buckets/{bucketName}/{remotePath}` 修改为 `{bucketName}/{remotePath}`，去掉了 `buckets/` 前缀。
- 原因：当前附件访问已切换为基于 SeaweedFS S3 协议的方式，不再需要依赖旧的 `buckets/` 路径前缀；保留前缀反而会影响实际访问路径的统一性。
- 结果：返回给前端或后续处理逻辑的文件路径更加简洁，和 SeaweedFS S3 的实际访问方式保持一致，也便于后续统一处理附件地址。

## 2. `DatabaseHealthCheckService` 配置加载优先级调整

- 动作：调整启动前数据库健康检查的配置读取逻辑，优先从外部 `./config/application.yml` 及 profile 配置中读取，并在命中第一个有效配置后立即停止继续向下读取。
- 原因：jar 包部署时，外部 `config/` 下的配置应该优先生效，避免后续读取到别处的配置后覆盖外部配置，导致实际生效配置与预期不一致。
- 结果：健康检查会按优先级顺序读取配置，命中后不再继续加载后续来源，保证外部部署配置优先生效，减少配置被覆盖的问题。

## 3. 验证码值可选返回前端

- 动作：在验证码生成逻辑中增加配置判断，当 `rzth.captcha.return-value` 开启时，将验证码明文值写入返回结果的 `yzm` 字段。
- 原因：部分前端场景需要根据接口是否返回验证码值来决定是否自动填充，以便提升调试效率或特定环境下的登录体验。
- 结果：验证码接口现在支持按配置控制是否返回验证码值，前端可以通过 `yzm` 是否存在来判断并自动处理。