picgo-plugin-gitee 2.1.0 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "picgo-plugin-gitee",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "picgo uploader for gitee",
   "main": "src/index.js",
   "files": [

package/readme.md

@@ -46,6 +46,7 @@ git push -u origin master
 ### Feature
 - support sync gitee file delete
 - 上传/删除结束均会弹出系统通知（PicGo 消息中心）
+- GUI 菜单提供「从 Gitee 同步远程文件到相册」按钮（递归仓库所有图片，自动跳过非图片文件）
 
 ### Todo
 

package/src/index.js

@@ -18,6 +18,170 @@ module.exports = (ctx) => {
     ctx.on("remove", onRemove);
   };
 
+  // GUI 菜单项：手动触发"从 Gitee 拉取远程文件到相册"
+  const guiMenu = (ctx) => {
+    return [
+      {
+        label: "从 Gitee 同步远程文件到相册",
+        async handle(ctx, guiApi) {
+          await syncRemoteToGallery(ctx, guiApi);
+        },
+      },
+    ];
+  };
+
+  // 相册里只保留图片文件，避免把 README/配置文件等也拉进来
+  const IMAGE_EXTS = new Set([
+    "jpg", "jpeg", "png", "gif", "webp", "bmp", "svg",
+    "tif", "tiff", "ico", "avif", "heic",
+  ]);
+
+  // 递归列出 Gitee 仓库所有图片文件（含子目录）。
+  // 返回 [{ fileName, imgUrl, sha, size }]
+  const listAllRemoteFiles = async function (userConfig) {
+    const headers = getHeaders();
+    const listUrl =
+      userConfig.baseUrl + "/contents" + formatConfigPath(userConfig);
+    const out = [];
+    await walkContents(listUrl, userConfig, headers, out);
+    return out
+      .filter((it) => {
+        const ext = (it.name || "").split(".").pop().toLowerCase();
+        return IMAGE_EXTS.has(ext);
+      })
+      .map((it) => ({
+        fileName: it.path,
+        imgUrl: userConfig.previewUrl + "/" + it.path,
+        sha: it.sha,
+        size: it.size,
+      }));
+  };
+
+  const walkContents = async function (url, userConfig, headers, out) {
+    const fullUrl = url + "?access_token=" + userConfig.token;
+    let res;
+    try {
+      res = await ctx.Request.request({
+        method: "GET",
+        url: fullUrl,
+        headers: headers,
+      });
+    } catch (err) {
+      throw new Error("获取 Gitee 目录失败：" + err.message);
+    }
+    // 兼容 picgo-core（字符串）和 picgo GUI（对象）
+    const items = typeof res === "string" ? JSON.parse(res) : res;
+    if (!Array.isArray(items)) {
+      // 单文件（理论上 listAllRemoteFiles 不会传单文件路径，兜底）
+      if (items && items.type === "file") {
+        out.push(items);
+      }
+      return;
+    }
+    for (const item of items) {
+      if (item.type === "file") {
+        out.push(item);
+      } else if (item.type === "dir") {
+        // 递归子目录
+        await walkContents(url + "/" + item.path, userConfig, headers, out);
+      }
+    }
+  };
+
+  // 把 Gitee 远程文件写入 PicGo GUI 相册。
+  // 关键点：每条记录带 type="gitee"，这样从相册删除时会触发 onRemove 真正删除 gitee 上的文件。
+  const syncRemoteToGallery = async function (ctx, guiApi) {
+    if (!guiApi || !guiApi.galleryDB) {
+      ctx.log.info(
+        "[同步操作]失败当前：当前不在 PicGo GUI 环境（galleryDB 不可用）"
+      );
+      return;
+    }
+    let userConfig;
+    try {
+      userConfig = getUserConfig();
+    } catch (err) {
+      guiApi.showNotification &&
+        guiApi.showNotification({
+          title: "Gitee 同步失败",
+          body: "请先在插件设置中填写 owner / repo / token",
+        });
+      return;
+    }
+    if (
+      !userConfig.owner ||
+      !userConfig.repo ||
+      !userConfig.token
+    ) {
+      guiApi.showNotification &&
+        guiApi.showNotification({
+          title: "Gitee 同步失败",
+          body: "请先在插件设置中填写 owner / repo / token",
+        });
+      return;
+    }
+
+    guiApi.showNotification &&
+      guiApi.showNotification({
+        title: "正在同步",
+        body: "正在从 Gitee 拉取远程文件...",
+      });
+
+    let remoteFiles;
+    try {
+      remoteFiles = await listAllRemoteFiles(userConfig);
+    } catch (err) {
+      guiApi.showNotification &&
+        guiApi.showNotification({
+          title: "Gitee 同步失败",
+          body: err.message,
+        });
+      return;
+    }
+
+    if (remoteFiles.length === 0) {
+      guiApi.showNotification &&
+        guiApi.showNotification({
+          title: "Gitee 同步完成",
+          body: "仓库里没有任何文件",
+        });
+      return;
+    }
+
+    // 相册里已有的就不重复插入
+    const existing = (await guiApi.galleryDB.get()) || [];
+    const existingUrls = new Set(existing.map((x) => x.imgUrl));
+    const newItems = remoteFiles
+      .filter((f) => !existingUrls.has(f.imgUrl))
+      .map((f) => ({
+        fileName: f.fileName,
+        imgUrl: f.imgUrl,
+        type: uploadedName,
+        sha: f.sha,
+        // picgo 相册的可选字段
+        extname: f.fileName.split(".").pop(),
+      }));
+
+    if (newItems.length === 0) {
+      guiApi.showNotification &&
+        guiApi.showNotification({
+          title: "Gitee 同步完成",
+          body: "没有新增文件，相册已是最新",
+        });
+      return;
+    }
+
+    await guiApi.galleryDB.insertMany(newItems);
+    guiApi.showNotification &&
+      guiApi.showNotification({
+        title: "Gitee 同步完成",
+        body: `新增 ${newItems.length} 个文件到相册（共发现 ${remoteFiles.length} 个）`,
+      });
+    ctx.log.info(
+      `[同步操作]完成：共 ${remoteFiles.length} 个，新增 ${newItems.length} 个`
+    );
+  };
+
   const getHeaders = function () {
     return {
       "Content-Type": "application/json;charset=UTF-8",
@@ -327,5 +491,6 @@ module.exports = (ctx) => {
   return {
     uploader: "gitee",
     register,
+    guiMenu,
   };
 };