更新若干功能

app/Service/common/oss/OssStorageInterface.php

@@ -38,7 +38,7 @@ interface OssStorageInterface
      * 素材库靠 marker 一页一页往回补：bucket 上万对象时一次拉全量必然打穿
      * PHP 的执行时限，所以约定「调用方拿着 next_marker 继续要下一页」。
      *
-     * @param string $prefix 只列举该前缀，留空时退回配置里的 path_prefix
+     * @param string $prefix 只列举该前缀，留空表示整个 Bucket（不套 path_prefix）
      * @param string $marker 上一页返回的 next_marker，首页传空串
      * @param int $limit 单页条数
      * @return array{items: array<int, array{key:string,size:int,hash:string,last_modified:int,url:string}>, next_marker: string, finished: bool}
@@ -48,7 +48,7 @@ interface OssStorageInterface
     /**
      * 删除对象
      *
-     * @param string $key 对象键（缺 path_prefix 时由实现补齐）
+     * @param string $key 对象键（素材库存的是列举/上传后的真实路径，不再补 path_prefix）
      */
     public function deleteObject(string $key): bool;
 }