WPS365

doc/WPS365授权错误排查指南.md

@@ -98,9 +98,9 @@
 1. 登录WPS365开放平台
 2. 进入"开发配置" > "权限管理"
 3. 查看已申请的权限列表，**注意权限的格式**：
-   - 可能是 `file.read`（点分隔）
-   - 可能是 `file:read`（冒号分隔）
-   - 可能是其他格式
+   - 必须以 `kso.` 开头，如：`kso.file.read`、`kso.file.readwrite`
+   - 不是 `file.read` 或 `ksheet.read`（这些格式不存在）
+   - 根据官方文档：https://open.wps.cn/documents/app-integration-dev/wps365/server/
 
 #### 5.2 检查scope分隔符
 
@@ -108,9 +108,9 @@
 
 | 分隔符 | 示例 | 说明 |
 |--------|------|------|
-| **逗号（正确）** | `kso.doclib.readwrite,ksheet.read` | ✅ WPS365官方要求 |
-| **空格（错误）** | `kso.doclib.readwrite ksheet.read` | ❌ 会导致invalid_scope |
-| **逗号+空格** | `kso.doclib.readwrite, ksheet.read` | ⚠️ 可能支持，但不推荐 |
+| **逗号（正确）** | `kso.file.readwrite,kso.doclib.readwrite` | ✅ WPS365官方要求 |
+| **空格（错误）** | `kso.file.readwrite kso.doclib.readwrite` | ❌ 会导致invalid_scope |
+| **逗号+空格** | `kso.file.readwrite, kso.doclib.readwrite` | ⚠️ 可能支持，但不推荐 |
 
 **重要**：WPS365官方文档明确要求使用英文逗号 `,` 分隔，不能使用空格。
 
@@ -122,7 +122,8 @@
 wps365:
   # 根据WPS365平台后台"权限管理"中显示的实际权限名称配置
   # 使用英文逗号分隔（WPS365官方要求）
-  scope: kso.doclib.readwrite
+  # 权限名称必须以 kso. 开头
+  scope: kso.file.readwrite
 ```
 
 多个权限示例：
@@ -130,7 +131,8 @@ wps365:
 ```yaml
 wps365:
   # 多个权限用英文逗号分隔，不能有空格
-  scope: kso.doclib.readwrite,ksheet.read
+  # 权限名称必须以 kso. 开头
+  scope: kso.file.read,kso.file.readwrite
 ```
 
 #### 5.4 确认权限已申请且名称正确