初始化

缺陷：主题配色需要优化整体的同风格

app/Service/common/oss/OssStorageInterface.php

@@ -31,4 +31,24 @@ interface OssStorageInterface
      * @return array{key:string,url:string}|false
      */
     public function uploadVideo($filePath, string $key): bool|array;
+
+    /**
+     * 分页列举对象
+     *
+     * 素材库靠 marker 一页一页往回补：bucket 上万对象时一次拉全量必然打穿
+     * PHP 的执行时限，所以约定「调用方拿着 next_marker 继续要下一页」。
+     *
+     * @param string $prefix 只列举该前缀，留空时退回配置里的 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}
+     */
+    public function listObjects(string $prefix = '', string $marker = '', int $limit = 100): array;
+
+    /**
+     * 删除对象
+     *
+     * @param string $key 对象键（缺 path_prefix 时由实现补齐）
+     */
+    public function deleteObject(string $key): bool;
 }