release v25.39.0

docs/developers/concepts/2-auth-models.md

@@ -23,11 +23,16 @@ coScene 根据上述的权限体系和原则，在系统内为所有的资源预
 1. 组织管理员：可以管理组织内的所有资源和权限
 2. 成员：可以管理所有组织内成员有权限的数据
 3. 只读成员：可以读取所有组织内成员有权限的数据
+4. 外部人员：不是组织内的实际用户，可以通过邀请加入组织，访问被添加的项目
 
 ### 项目
 
 1. 项目管理员：可以管理项目内所有资源和权限
 2. 成员：可以管理项目内所有的数据
 3. 只读成员：可以读取项目内所有的数据
 
-当一个用户拥有项目的角色时，该用户项目内的角色会被优先使用。唯一的例外是组织管理员，组织管理员目前拥有最高的系统权限，能访问所有的项目，并且会忽略项目内的角色设置（如果有）。
+当一个用户拥有项目的角色时，该用户项目内的角色会被优先使用。唯一的例外是组织管理员，组织管理员目前拥有最高的系统权限，能访问所有的项目。
+
+各角色的操作权限如下：
+
+![auth.png](./img/auth.png)

docs/developers/s3/1-s3-authentication.md

@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+---
+
+# S3 身份验证
+
+了解如何使用 S3 进行身份验证，从而对组织内有权限的项目执行 S3 操作。
+
+1. 进入项目概览-S3 连接页面，获取 Endpoint、Region、Bucket 等信息。
+
+    ![pro-s3_1](./img/pro-s3_1.png)
+
+2. 点击【我的访问秘钥】，前往个人设置-安全页面，管理个人的 S3 访问秘钥。
+
+    ![pro-s3_2](./img/pro-s3_2.png)
+
+3. 点击【创建访问秘钥】，输入备注信息后，创建 S3 访问秘钥。
+
+    ![pro-s3_3](./img/pro-s3_3.png)
+
+4. 复制访问秘钥 ID 和访问秘钥，用于后续 S3 操作。例如，使用 [AIStor Client(mc)](https://docs.min.io/enterprise/aistor-object-store/reference/cli/) 工具进行 S3 身份验证：
+
+    ```bash
+    mc alias set coscene <endpoint> <access-key-id> <secret-access-key>
+    ```
+
+注意：**个人的 S3 访问秘钥可对组织内有权限的所有项目执行操作，仅用于个人使用，不建议分享给他人。**

docs/developers/s3/2-s3-operations.md

@@ -0,0 +1,70 @@
+---
+sidebar_position: 2
+---
+
+# S3 操作
+
+在项目中，通过 S3 可对记录、资源进行上传、下载等操作。
+
+## 存储路径
+
+1. **记录**
+
+    记录中的文件在 S3 对应 Bucket 中的路径为 `records/<record-id>/files/<file-name>`。
+
+    例如，记录的 ID 为 `123456`，文件名为 `example.txt`，则文件的路径为 `records/123456/files/example.txt`。
+
+    ![s3-record](./img/s3-record.png)
+
+2. **资源**
+
+    资源中的文件在 S3 对应 Bucket 中的路径为 `files/<file-name>`。
+
+    例如，资源中文件名为 `example.txt`，则文件的路径为 `files/example.txt`。
+
+    ![s3-resource](./img/s3-resource.png)
+
+## 操作示例
+以 [AIStor Client(mc)](https://docs.min.io/enterprise/aistor-object-store/reference/cli/) 工具为例。假设项目 Bucket 为 `coscene.01`，记录的 ID 为 `123456`，文件名为 `example.txt`，S3 配置的别名为 `coscene`。
+
+### 列出文件
+
+1. 列出记录中的文件
+
+    ```bash
+    mc ls coscene/coscene.01/records/123456/files/
+    ```
+
+2. 列出资源中的文件
+
+    ```bash
+    mc ls coscene/coscene.01/files/
+    ```
+
+### 上传文件
+
+1. 上传文件到记录中：
+
+    ```bash
+    mc put example.txt coscene/coscene.01/records/123456/files/
+    ```
+
+2. 上传文件到资源中：
+
+    ```bash
+    mc put example.txt coscene/coscene.01/files/
+    ```
+
+### 下载文件
+
+1. 从记录中下载文件
+
+    ```bash
+    mc get coscene/coscene.01/records/123456/files/example.txt .
+    ```
+
+2. 从资源中下载文件
+
+    ```bash
+    mc get coscene/coscene.01/files/example.txt .
+    ```

docs/developers/s3/_category_.json

@@ -0,0 +1,9 @@
+{
+  "label": "S3 存储",
+  "position": 4,
+  "collapsible": true,
+  "link": {
+    "type": "generated-index",
+    "slug": "/category/s3"
+  }
+}

docs/viz/1-about-viz.md

@@ -8,7 +8,7 @@ sidebar_position: 1
 
 ## 如何进行进入可视化界面
 
-在记录中，点击【播放记录】或直接点击文件进入可视化界面
+在记录中，点击【播放记录】进入可视化界面
 
 ![viz-1-1.png](./img/viz-1-1.png)
 
@@ -96,14 +96,15 @@ sidebar_position: 1
  ![viz-1-12.png](./img/viz-1-12.png)
 
 以下是该区域的功能介绍：
-1. 【创建一刻】按钮，用于选择「一刻」的起止点
+1. 创建一刻：在关键时间段创建「一刻」，用于快速定位和回放该时间段的内容
 2. 显示文件播放的开始时间、结束时间和持续时间
-3. 当前进度时间戳
+3. 当前播放的时间点
 4. 暂停及前进后退按钮
-5. 循环播放按钮
-6. 倍速播放按钮
-7. 播放画质选项按钮
-8. 绝对相对时间切换按钮
+5. 播放步长：调整暂停时的前进/后退时长
+6. 循环播放按钮
+7. 倍速播放按钮
+8. 一刻：一刻在时间轴上以蓝色矩形表示
+9. 可播时间段：可播时间段是指在时间轴上可以播放的时间段，以浅蓝色矩形表示
 
 ---