From 1540081ef9cfaa86a12cdcd532c52d63ad1b8edb Mon Sep 17 00:00:00 2001 From: "Calvin W." Date: Tue, 23 Sep 2025 13:07:06 +0800 Subject: [PATCH] docs: restore the cloud drive related topics and lines (#1847) * docs: restore the cloud drive related topics and lines * Apply suggestions from code review Co-authored-by: Meow33 --------- Co-authored-by: Meow33 --- docs/.vitepress/en.ts | 7 ++-- docs/.vitepress/zh.ts | 10 +++--- docs/manual/larepass/integrations.md | 7 ++-- docs/manual/olares/files/index.md | 11 +++++-- docs/manual/olares/settings/integrations.md | 32 ++++++++++--------- docs/zh/manual/larepass/integrations.md | 10 +++--- docs/zh/manual/olares/files/index.md | 12 ++++--- docs/zh/manual/olares/files/mount-SMB.md | 6 ++-- .../zh/manual/olares/settings/integrations.md | 2 ++ 9 files changed, 55 insertions(+), 42 deletions(-) diff --git a/docs/.vitepress/en.ts b/docs/.vitepress/en.ts index 25296bb8b..5dc58bd6f 100644 --- a/docs/.vitepress/en.ts +++ b/docs/.vitepress/en.ts @@ -113,9 +113,10 @@ const side = { text: "Mount SMB", link: "/manual/olares/files/mount-SMB", }, - // {text: "Mount cloud storage", - // link: "/manual/olares/files/mount-cloud-storage", - // }, + { + text: "Mount cloud storage", + link: "/manual/olares/files/mount-cloud-storage", + }, ], }, { diff --git a/docs/.vitepress/zh.ts b/docs/.vitepress/zh.ts index 64ac262d3..ab12d167b 100644 --- a/docs/.vitepress/zh.ts +++ b/docs/.vitepress/zh.ts @@ -115,11 +115,11 @@ const side = { "text": "挂载 SMB", "link": "/zh/manual/olares/files/mount-SMB" }, - // { - // "text": "挂载云存储", - // "link": "/zh/manual/olares/files/mount-cloud-storage" - // } - ] + { + "text": "挂载云存储", + "link": "/zh/manual/olares/files/mount-cloud-storage" + }, + ], }, { "text": "Vault", diff --git a/docs/manual/larepass/integrations.md b/docs/manual/larepass/integrations.md index 8515ea9b7..1cddc2598 100644 --- a/docs/manual/larepass/integrations.md +++ b/docs/manual/larepass/integrations.md @@ -56,7 +56,7 @@ OAuth-based integrations like Google Drive and Dropbox require initial setup via 4. Follow the login prompts to authorize your account. -Once authorized, you'll see the connected account in the integration list. You can select the storage for [Olares backup](../olares/settings/backup.md) +Once authorized, you'll see the connected account in the integration list. You can select the storage for [Olares backup](../olares/settings/backup.md) or access the storage in **Files** > **Cloud Storage** in Olares. ## Add a cloud storage using API-keys @@ -69,12 +69,11 @@ Services like AWS S3 and Tencent Cloud COS require setup using API keys (Access Alternatively, you can configure these integrations directly within [Olares Settings](/manual/olares/settings/integrations.md). -Once authorized, you'll see the connected account in the integration list. You can select the storage for [Olares backup](../olares/settings/backup.md) +Once authorized, you'll see the connected account in the integration list. You can select the storage for [Olares backup](../olares/settings/backup.md) or access the storage in **Files** > **Cloud Storage** in Olares. ## Disconnect integrations ::: warning -Disconnecting Olares Space may affect your ability to manage devices, and access cloud backups through the Olares Space interface. -You can always reconnect later if needed. +Disconnecting an integration may affect the ability to manage devices and cloud backups. You can always reconnect later if needed. ::: To disconnect an integration from LarePass: diff --git a/docs/manual/olares/files/index.md b/docs/manual/olares/files/index.md index a4bfed0d7..fc91d7989 100644 --- a/docs/manual/olares/files/index.md +++ b/docs/manual/olares/files/index.md @@ -12,12 +12,13 @@ Olares's built-in Files app offers users a secure and efficient solution for fil ## Understand the interface The interface is similar to Windows Explorer or macOS Finder, allowing you to organize and access documents, images, videos, or any other files you own. -![Files](/images/manual/olares/files-1.png#bordered) +![Files](/images/manual/olares/files.png#bordered) It consists of three main components: -* **Drive**: For storing files that don't require frequent synchronization or modifications. -* **Application**: For development and debugging purposes only. +* **Drive**: Stores personal files that don’t require constant synchronization or frequent edits. Each user has a Home directory with default folders such as Documents, Pictures, Videos, and Downloads. External storage (e.g., USB drives or SMB shares) appears under External. +* **Application**: Reserved for application-specific data. Primarily for development and debugging, not general file storage. +* **Cloud storage**: Connected through [Integrations](../../larepass/integrations.md), including Google Drive, AWS S3, and Tencent Cloud Object Storage (COS). These allow you to link, access, and manage remote files directly from Olares. ---
@@ -30,4 +31,8 @@ Learn the fundamentals of file management in Olares. Learn how to mount and access SMB shared folders from NAS devices or network servers in Olares.
+
+

Mount cloud storage

+Learn how to mount and access third party cloud storage services in Olares. +
diff --git a/docs/manual/olares/settings/integrations.md b/docs/manual/olares/settings/integrations.md index 1a80076da..3902335ad 100644 --- a/docs/manual/olares/settings/integrations.md +++ b/docs/manual/olares/settings/integrations.md @@ -10,6 +10,23 @@ The Integration section in **Settings** provides a centralized view of all third OAuth-based integrations and Olares Space must be connected via the LarePass app. See the [Integration guide of LarePass](../../larepass/integrations.md) for details. +## Add cloud object storage via API keys + +Olares supports manual configuration of AWS S3 and Tencent Cloud COS using API credentials: + +1. Navigate to **Settings** > **Integration** and click the **+ Add Account** button in the top-right corner. +2. Select **AWS S3** or **Tencent COS**, then click **Confirm**. +3. In the mount dialog box, fill in the required details: + - Access Key + - Secret Key + - Region + - Bucket name +4. Click **Next**. You will see a success message if the credentials are valid. + +Your connected cloud storage will now appear under the **Cloud storage** section in Files. + +Alternatively, you can configure this direction directly within [LarePass](../../larepass/integrations.md#add-a-cloud-storage-using-api-keys). + ## View and manage existing integrations 1. Open **Settings** from the Dock or Launchpad. @@ -17,21 +34,6 @@ OAuth-based integrations and Olares Space must be connected via the LarePass app 3. Click an integration card to show its connection status and available actions. 4. In the **Account settings** page, click **Delete** to remove the integration. -## Add cloud object storage via API keys - -Olares supports manual configuration of AWS S3 and Tencent Cloud COS using API credentials: - -1. Navigate to **Settings** > **Integration** and click the **+ Add Account** button in the top-right corner. -2. Select **AWS S3** or **Tencent COS**, then click **Confirm**. -3. In the mount dialog box, fill in the required details: - - Access Key - - Secret Key - - Region - - Bucket name -4. Click **Next**. You will see a success message if the credentials are valid. - -Alternatively, you can configure this direction directly within [LarePass](../../larepass/integrations.md#add-a-cloud-storage-using-api-keys). - diff --git a/docs/zh/manual/larepass/integrations.md b/docs/zh/manual/larepass/integrations.md index 2b1af5afd..d57150695 100644 --- a/docs/zh/manual/larepass/integrations.md +++ b/docs/zh/manual/larepass/integrations.md @@ -50,7 +50,7 @@ Google Drive、Dropbox 等通过 OAuth 登录的服务集成需在 LarePass 移 3. 选择 **Google Drive** 或 **Dropbox**。 4. 按提示登录并授权。 -配置成功后，服务将显示在集成列表，可用于 [Olares 备份](../olares/settings/backup.md)。 +配置成功后，服务将显示在集成列表，可用于 [Olares 备份](../olares/settings/backup.md)。你可以在 Olares 的**文件管理器** > **云存储**中访问添加的云盘。 ## 通过 API 密钥添加云盘 @@ -61,16 +61,16 @@ AWS S3、腾讯云 COS 等服务需使用 Access Key & Secret Key 手动配置 3. 选择 **AWS S3** 或 **Tencent COS**。 4. 输入 Access Key、Secret Key 及其他必要信息，点击**确认**。 -配置成功后，服务将显示在集成列表，可用于 [Olares 备份](../olares/settings/backup.md)。 +配置成功后，服务将显示在集成列表，可用于 [Olares 备份](../olares/settings/backup.md)。你可以在 Olares 的**文件管理器** > **云存储**中访问添加的云盘。 -你也可以在 [Olares 设置](/zh/manual/olares/settings/integrations.md) 中直接配置。 +你也可以在 [Olares 设置](/zh/manual/olares/settings/integrations.md) 的集成管理页面添加此类服务。 ## 断开集成 :::warning -断开 Olares Space 可能影响设备管理及云备份访问，你可在需要时重新连接。 +断开集成的服务可能影响设备管理及云备份访问，你可在需要时重新连接。 ::: -1. 打开 LarePass，进入**设置** > **集成**。 +1. 打开 LarePass 应用，进入**设置** > **LarePass 设置** > **集成**。 2. 点击要移除的集成。 3. 点击右上角 more_horiz，选择**删除**。 diff --git a/docs/zh/manual/olares/files/index.md b/docs/zh/manual/olares/files/index.md index a6a9c90cd..25807f791 100644 --- a/docs/zh/manual/olares/files/index.md +++ b/docs/zh/manual/olares/files/index.md @@ -14,10 +14,11 @@ Olares 内置的文件应用为用户提供了安全高效的文件存储与同 文件管理器的界面类似于 Windows 资源管理器或 macOS 的访达，允许你整理和访问文档、图片、视频或其他文件。主要由以下三个部分组成： -![Files](/images/zh/manual/olares/files-1.png#bordered) +![Files](/images/zh/manual/olares/files.png#bordered) -* **存储盘**（Drive）：用于存储不需要频繁同步或修改的文件。 -* **应用盘**（Application）：存储应用与缓存数据，仅用于开发和调试目的。 +* **存储**（Drive）：用于存储个人文件，适合那些不需要频繁同步或修改的内容。每个用户都有一个首页目录，默认包含文档、图片、影视、下载等文件夹。外部存储（如 USB 驱动器或 SMB 共享）会显示在**外部设备**下。 +* **应用**（Application）：存储应用与缓存数据，主要用于开发和调试目的。 +* **云存储** （Cloud Drive）通过[**集成**](../../larepass/integrations.md)功能连接的外部云存储服务，包括 Google Drive、AWS S3 和 腾讯云 COS。可直接在 Olares 中挂载、访问和管理远程文件。 ---
@@ -30,7 +31,10 @@ Olares 内置的文件应用为用户提供了安全高效的文件存储与同 了解如何在 Olares 中挂载并访问 NAS 设备或网络服务器上的 SMB 共享文件夹。
- +
+

挂载云存储

+ 了解如何在 Olares 中挂载并访问第三方云存储服务。 +
diff --git a/docs/zh/manual/olares/files/mount-SMB.md b/docs/zh/manual/olares/files/mount-SMB.md index 154842cfb..36d93968c 100644 --- a/docs/zh/manual/olares/files/mount-SMB.md +++ b/docs/zh/manual/olares/files/mount-SMB.md @@ -11,7 +11,7 @@ SMB（Server Message Block，服务器消息块）是一种用于在网络上共 - **用户名和密码**：用于访问 SMB 共享的登录凭据。 ## 将 SMB 共享文件夹挂载到 Olares -1. 打开**文件管理器**，进入**存储** > **外部存储**。 +1. 打开**文件管理器**，进入**存储** > **外部设备**。 2. 点击右上角的**连接服务器**。 3. 在**服务器地址**栏中输入 SMB 共享路径（例如：`\\192.168.1.100\Documents`），然后点击**确定**。 :::tip 保存常用服务器地址 @@ -21,11 +21,11 @@ SMB（Server Message Block，服务器消息块）是一种用于在网络上共 ![添加 SMB 共享路径](/images/manual/olares/add-SMB-share-path.png#bordered) 4. 输入**用户名**和**密码**，然后点击**确定**。 -连接成功后，SMB 共享将显示在**外部存储**目录中，你就可以方便地访问共享文件和文件夹了。 +连接成功后，SMB 共享将显示在**外部设备**目录中，你就可以方便地访问共享文件和文件夹了。 ## 卸载 SMB 共享 要卸载 SMB 共享： -1. 打开**文件管理器**，进入**存储** > **外部存储**。 +1. 打开**文件管理器**，进入**存储** > **外部设备**。 2. 右键选择已挂载的 SMB 共享文件夹，从上下文菜单中选择**卸载**。 完成后，Olares 将与 SMB 文件夹安全断开连接。 \ No newline at end of file diff --git a/docs/zh/manual/olares/settings/integrations.md b/docs/zh/manual/olares/settings/integrations.md index 864939197..aa1f567c2 100644 --- a/docs/zh/manual/olares/settings/integrations.md +++ b/docs/zh/manual/olares/settings/integrations.md @@ -30,4 +30,6 @@ Olares 支持手动配置 **AWS S3** 和**腾讯云 COS**： - **Bucket name** 4. 点击**下一步**。凭证验证通过后将显示成功提示。 +配置完成后，挂载的存储服务将出现在**文件管理器** > **云存储**下。 + 你也可以在 [LarePass](../../larepass/integrations.md#通过-api-密钥添加云盘) 中完成同样的配置。