fix(#850): 修复 gitea 无法备份的问题

Author: codexu

src/app/core/setting/sync/gitea-sync.tsx

@@ -138,7 +138,9 @@ export function GiteaSync() {
 
   // 自定义 URL 变化处理
   async function customUrlChangeHandler(e: React.ChangeEvent<HTMLInputElement>) {
-    const value = e.target.value
+    let value = e.target.value
+    // 自动移除末尾的斜杠
+    value = value.replace(/\/+$/, '')
     await setGiteaCustomUrl(value)
     // 如果是自建实例且有 token，重新检查仓库状态
     if (giteaInstanceType === GiteaInstanceType.SELF_HOSTED && giteaAccessToken.trim() && value.trim()) {

src/lib/sync/gitea.ts

@@ -15,16 +15,18 @@ import {
   GiteaFileContent
 } from './gitea.types';
 
-// 获取 Gitea 实例的 API 基础 URL 
+// 获取 Gitea 实例的 API 基础 URL
 async function getGiteaApiBaseUrl(): Promise<string> {
   const store = await Store.load('store.json');
   const instanceType = await store.get<GiteaInstanceType>('giteaInstanceType') || GiteaInstanceType.OFFICIAL;
-  
+
   if (instanceType === GiteaInstanceType.SELF_HOSTED) {
-    const customUrl = await store.get<string>('giteaCustomUrl') || '';
+    let customUrl = await store.get<string>('giteaCustomUrl') || '';
+    // 移除末尾的斜杠，避免双斜杠问题
+    customUrl = customUrl.replace(/\/+$/, '');
     return `${customUrl}/api/v1`;
   }
-  
+
   const instance = GITEA_INSTANCES[instanceType];
   return `${instance.baseUrl}/api/v1`;
 }
@@ -110,6 +112,7 @@ export async function uploadFile({
     }
 
     const url = `${baseUrl}/repos/${giteaUsername}/${repo}/contents/${_path}`;
+    // Gitea API: POST 创建新文件，PUT 更新现有文件
     const method = sha ? 'PUT' : 'POST';
 
     const response = await fetch(url, {
@@ -153,16 +156,18 @@ export async function getFiles({ path, repo }: { path: string; repo: string }) {
   try {
     const store = await Store.load('store.json');
     const giteaUsername = await store.get<string>('giteaUsername');
-    
+
     if (!giteaUsername) {
-      throw new Error('用户名未配置');
+      return null;
     }
 
     const baseUrl = await getGiteaApiBaseUrl();
     const headers = await getCommonHeaders();
     const proxy = await getProxyConfig();
 
-    const url = `${baseUrl}/repos/${giteaUsername}/${repo}/contents/${path}`;
+    // 对路径进行 URL 编码，处理特殊字符
+    const encodedPath = path.replace(/\s/g, '_').split('/').map(encodeURIComponent).join('/');
+    const url = `${baseUrl}/repos/${giteaUsername}/${repo}/contents/${encodedPath}`;
 
     const response = await fetch(url, {
       method: 'GET',
@@ -172,7 +177,7 @@ export async function getFiles({ path, repo }: { path: string; repo: string }) {
 
     if (response.status >= 200 && response.status < 300) {
       const data = await response.json();
-      
+
       // 如果是单个文件，返回文件信息（包含 content）
       if (!Array.isArray(data)) {
         return {
@@ -183,7 +188,7 @@ export async function getFiles({ path, repo }: { path: string; repo: string }) {
           content: data.content || '', // 文件内容（base64）
         };
       }
-      
+
       // 如果是目录，返回文件列表
       return data.map((item: GiteaDirectoryItem) => {
         return {
@@ -195,24 +200,17 @@ export async function getFiles({ path, repo }: { path: string; repo: string }) {
       })
     }
 
+    // 文件或目录不存在，返回 null
     if (response.status >= 400 && response.status < 500) {
       return null
     }
 
-    const errorData = await response.json();
-    throw {
-      status: response.status,
-      message: errorData.message || '获取文件列表失败'
-    } as GiteaError;
+    return null;
 
   } catch (error) {
     console.error('Gitea 获取文件列表失败:', error);
-    toast({
-      title: '获取文件列表失败',
-      description: (error as GiteaError).message || '获取文件列表时发生错误',
-      variant: 'destructive',
-    });
-    throw error;
+    // 静默处理错误，返回 null
+    return null;
   }
 }
 

src/stores/article.ts

@@ -1,8 +1,10 @@
 import { getFiles as getGithubFiles } from '@/lib/sync/github'
 import { GithubContent } from '@/lib/sync/github.types'
 import { getFiles as getGiteeFiles } from '@/lib/sync/gitee'
+import { getFiles as getGiteaFiles } from '@/lib/sync/gitea'
 import { getFiles as getGitlabFiles } from '@/lib/sync/gitlab'
 import { GiteeFile } from '@/lib/sync/gitee'
+import { GiteaDirectoryItem } from '@/lib/sync/gitea.types'
 import { getSyncRepoName } from '@/lib/sync/repo-utils'
 import { autoSyncIfNeeded, hasNetworkConnection, ensureDirectoryExists } from '@/lib/sync/auto-sync'
 import { sanitizeFilePath, hasInvalidFileNameChars } from '@/lib/sync/filename-utils'
@@ -488,6 +490,11 @@ const useArticleStore = create<NoteState>((set, get) => ({
         if (!gitlabAccessToken) {
           return
         }
+      } else if (primaryBackupMethod === 'gitea') {
+        const giteaAccessToken = await store.get<string>('giteaAccessToken')
+        if (!giteaAccessToken) {
+          return
+        }
       }
 
     // 只为根目录和本地存在的已展开文件夹加载远程文件
@@ -536,11 +543,15 @@ const useArticleStore = create<NoteState>((set, get) => ({
             const gitlabRepo = await getSyncRepoName('gitlab');
             files = await getGitlabFiles({ path, repo: gitlabRepo });
             break;
+          case 'gitea':
+            const giteaRepo = await getSyncRepoName('gitea');
+            files = await getGiteaFiles({ path, repo: giteaRepo });
+            break;
         }
 
         if (files) {
           const dirs = get().fileTree
-          files.forEach((file: GithubContent | GiteeFile) => {
+          files.forEach((file: GithubContent | GiteeFile | GiteaDirectoryItem) => {
             // 过滤以"."开头的文件和文件夹
             if (file.name.startsWith('.')) {
               return;
@@ -641,6 +652,9 @@ const useArticleStore = create<NoteState>((set, get) => ({
     } else if (primaryBackupMethod === 'gitlab') {
       const gitlabAccessToken = await store.get<string>('gitlabAccessToken')
       hasCloudSync = !!gitlabAccessToken
+    } else if (primaryBackupMethod === 'gitea') {
+      const giteaAccessToken = await store.get<string>('giteaAccessToken')
+      hasCloudSync = !!giteaAccessToken
     }
 
     // 只有在配置了云同步时才设置加载状态
@@ -731,6 +745,9 @@ const useArticleStore = create<NoteState>((set, get) => ({
     } else if (primaryBackupMethod === 'gitlab') {
       const gitlabAccessToken = await store.get<string>('gitlabAccessToken')
       if (!gitlabAccessToken) return
+    } else if (primaryBackupMethod === 'gitea') {
+      const giteaAccessToken = await store.get<string>('giteaAccessToken')
+      if (!giteaAccessToken) return
     }
 
     try {
@@ -748,14 +765,18 @@ const useArticleStore = create<NoteState>((set, get) => ({
           const gitlabRepo1 = await getSyncRepoName('gitlab');
           files = await getGitlabFiles({ path: fullpath, repo: gitlabRepo1 });
           break;
+        case 'gitea':
+          const giteaRepo1 = await getSyncRepoName('gitea');
+          files = await getGiteaFiles({ path: fullpath, repo: giteaRepo1 });
+          break;
       }
 
       if (files) {
         const cacheTree = get().fileTree
         const currentFolder = getCurrentFolder(fullpath, cacheTree)
 
         if (currentFolder) {
-          files.forEach((file: GithubContent | GiteeFile) => {
+          files.forEach((file: GithubContent | GiteeFile | GiteaDirectoryItem) => {
             // 过滤以"."开头的文件和文件夹
             if (file.name.startsWith('.')) {
               return;