WPS365

ruoyi-system/src/main/java/com/ruoyi/jarvis/service/impl/WPS365OAuthServiceImpl.java

@@ -94,22 +94,26 @@ public class WPS365OAuthServiceImpl implements IWPS365OAuthService {
         // scope参数（必需，根据WPS365官方文档）
         // 优先使用配置文件中指定的scope，如果没有配置则使用默认值
         // 重要：WPS365官方文档明确要求使用英文逗号分隔，且权限名称必须与后台注册的完全一致
+        // 根据官方文档：https://open.wps.cn/documents/app-integration-dev/wps365/server/
+        // 权限名称格式为：kso.xxx.read 或 kso.xxx.readwrite（不是 file.read）
         String scope = wps365Config.getScope();
         if (scope == null || scope.trim().isEmpty()) {
             // 默认scope，根据WPS365官方文档：
             // 1. 必须使用英文逗号分隔（不是空格）
-            // 2. 权限名称必须与WPS365平台后台"权限管理"中显示的完全一致
-            // 3. 常见权限名称可能是：
+            // 2. 权限名称必须以 kso. 开头，格式如：kso.file.read, kso.file.readwrite
+            // 3. 常见权限名称（根据官方文档）：
+            //    - kso.file.read (文件读取)
+            //    - kso.file.readwrite (文件读写)
             //    - kso.doclib.readwrite (文档库读写)
-            //    - kso.doclib.read (文档库读取)
-            //    - 或其他在平台后台显示的实际权限名称
+            //    - kso.wiki.readwrite (知识库读写)
+            //    - 对于在线表格（AirSheet/KSheet），可能需要 kso.file.readwrite
             // 
             // 如果报错invalid_scope，请：
-            // 1. 登录WPS365开放平台
+            // 1. 登录WPS365开放平台：https://open.wps.cn/
             // 2. 进入"开发配置" > "权限管理"
-            // 3. 查看已申请权限的准确名称（注意大小写、分隔符等）
+            // 3. 查看已申请权限的准确名称（必须以 kso. 开头）
             // 4. 在application.yml中配置scope参数，使用逗号分隔
-            scope = "kso.doclib.readwrite";  // 默认使用文档库读写权限
+            scope = "kso.file.readwrite";  // 默认使用文件读写权限（支持在线表格操作）
         }
         scope = scope.trim();