From 8bd7b6f2d45b528d5db364841156e3f2312298dc Mon Sep 17 00:00:00 2001
From: click33 <2393584716@qq.com>
Date: Mon, 29 Aug 2022 20:48:32 +0800
Subject: [PATCH] =?UTF-8?q?v1.31.0.RC=20=E5=8F=91=E5=B8=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     |  2 +-
 pom.xml                                       |  2 +-
 .../cn/dev33/satoken/util/SaTokenConsts.java  |  2 +-
 .../sa-token-demo-alone-redis/pom.xml         |  2 +-
 .../sa-token-demo-dubbo-consumer/pom.xml      |  2 +-
 .../sa-token-demo-dubbo-provider/pom.xml      |  2 +-
 sa-token-demo/sa-token-demo-grpc/pom.xml      |  4 +--
 sa-token-demo/sa-token-demo-jwt/pom.xml       |  2 +-
 .../sa-token-demo-oauth2-client/pom.xml       |  2 +-
 .../sa-token-demo-oauth2-server/pom.xml       |  2 +-
 .../sa-token-demo-quick-login/pom.xml         |  2 +-
 sa-token-demo/sa-token-demo-solon/pom.xml     |  2 +-
 .../sa-token-demo-springboot-redis/pom.xml    |  2 +-
 .../sa-token-demo-springboot/pom.xml          |  2 +-
 .../sa-token-demo-sso-server/pom.xml          |  2 +-
 .../sa-token-demo-sso1-client/pom.xml         |  2 +-
 .../sa-token-demo-sso2-client/pom.xml         |  2 +-
 .../sa-token-demo-sso3-client/pom.xml         |  2 +-
 sa-token-demo/sa-token-demo-thymeleaf/pom.xml |  2 +-
 sa-token-demo/sa-token-demo-webflux/pom.xml   |  2 +-
 .../sa-token-demo-websocket-spring/pom.xml    |  2 +-
 sa-token-demo/sa-token-demo-websocket/pom.xml |  2 +-
 sa-token-doc/doc/README.md                    |  2 +-
 sa-token-doc/doc/index-backup.html            | 12 +++++--
 sa-token-doc/doc/index.html                   | 13 ++++++--
 sa-token-doc/doc/more/update-log.md           | 33 +++++++++++++++++++
 sa-token-doc/index.html                       | 12 +++++--
 .../grpc/constants/GrpcContextConstants.java  |  7 ++--
 .../grpc/context/SaTokenGrpcContext.java      |  2 +-
 .../SaTokenContextGrpcServerInterceptor.java  |  5 +--
 .../SaTokenGrpcClientInterceptor.java         |  5 +--
 .../SaTokenGrpcServerInterceptor.java         |  5 +--
 32 files changed, 102 insertions(+), 40 deletions(-)

diff --git a/README.md b/README.md
index 0e79fb17..6237bef0 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <p align="center">
 	<img alt="logo" src="https://sa-token.dev33.cn/doc/logo.png" width="150" height="150">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.30.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</h1>
 <h4 align="center">一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！</h4>
 <p align="center">
 	<a href="https://gitee.com/dromara/sa-token/stargazers"><img src="https://gitee.com/dromara/sa-token/badge/star.svg?theme=gvp"></a>
diff --git a/pom.xml b/pom.xml
index d982dc28..2bfae51d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -37,7 +37,7 @@
 	
 	<!-- 一些属性 -->
 	<properties>
-		<revision>1.30.0</revision>
+		<revision>1.31.0.RC</revision>
         <jdk.version>1.8</jdk.version>
 		<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>utf-8</project.reporting.outputEncoding>
diff --git a/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java b/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java
index 7eace922..1cc1f63e 100644
--- a/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java
+++ b/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java
@@ -13,7 +13,7 @@ public class SaTokenConsts {
 	/**
 	 * Sa-Token 当前版本号 
 	 */
-	public static final String VERSION_NO = "v1.30.0";
+	public static final String VERSION_NO = "v1.31.0.RC";
 
 	/**
 	 * Sa-Token 开源地址 Gitee 
diff --git a/sa-token-demo/sa-token-demo-alone-redis/pom.xml b/sa-token-demo/sa-token-demo-alone-redis/pom.xml
index 6886e9d2..5f545eb6 100644
--- a/sa-token-demo/sa-token-demo-alone-redis/pom.xml
+++ b/sa-token-demo/sa-token-demo-alone-redis/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml b/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml
index 8a941bc5..a86d1b2d 100644
--- a/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml
+++ b/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml
@@ -16,7 +16,7 @@
 	<properties> 
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 	
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml b/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml
index c9292252..2dc64ec6 100644
--- a/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml
+++ b/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml
@@ -16,7 +16,7 @@
 	<properties> 
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 	
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-grpc/pom.xml b/sa-token-demo/sa-token-demo-grpc/pom.xml
index 4302cb71..5286d54b 100644
--- a/sa-token-demo/sa-token-demo-grpc/pom.xml
+++ b/sa-token-demo/sa-token-demo-grpc/pom.xml
@@ -27,7 +27,7 @@
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <lombok.version>1.18.10</lombok.version>
-        <sa-token-version>1.30.0</sa-token-version>
+        <sa-token-version>1.31.0.RC</sa-token-version>
     </properties>
 
     <dependencies>
@@ -48,7 +48,7 @@
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-data-redis</artifactId>
-            <version>2.7.2</version>
+            <!-- <version>2.7.2</version> -->
         </dependency>
 
         <dependency>
diff --git a/sa-token-demo/sa-token-demo-jwt/pom.xml b/sa-token-demo/sa-token-demo-jwt/pom.xml
index 6e348ac0..828f2025 100644
--- a/sa-token-demo/sa-token-demo-jwt/pom.xml
+++ b/sa-token-demo/sa-token-demo-jwt/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-oauth2-client/pom.xml b/sa-token-demo/sa-token-demo-oauth2-client/pom.xml
index 2617edcc..9405f878 100644
--- a/sa-token-demo/sa-token-demo-oauth2-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-oauth2-client/pom.xml
@@ -17,7 +17,7 @@
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
 		<!-- 定义sa-token版本号 -->
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 	
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-oauth2-server/pom.xml b/sa-token-demo/sa-token-demo-oauth2-server/pom.xml
index ff5ce390..26870148 100644
--- a/sa-token-demo/sa-token-demo-oauth2-server/pom.xml
+++ b/sa-token-demo/sa-token-demo-oauth2-server/pom.xml
@@ -17,7 +17,7 @@
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
 		<!-- 定义sa-token版本号 -->
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 	
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-quick-login/pom.xml b/sa-token-demo/sa-token-demo-quick-login/pom.xml
index cf0f7218..a67e2766 100644
--- a/sa-token-demo/sa-token-demo-quick-login/pom.xml
+++ b/sa-token-demo/sa-token-demo-quick-login/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-solon/pom.xml b/sa-token-demo/sa-token-demo-solon/pom.xml
index 83c70593..c29ec4fa 100644
--- a/sa-token-demo/sa-token-demo-solon/pom.xml
+++ b/sa-token-demo/sa-token-demo-solon/pom.xml
@@ -9,7 +9,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-springboot-redis/pom.xml b/sa-token-demo/sa-token-demo-springboot-redis/pom.xml
index 0dc8aa5e..2394ae3e 100644
--- a/sa-token-demo/sa-token-demo-springboot-redis/pom.xml
+++ b/sa-token-demo/sa-token-demo-springboot-redis/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-springboot/pom.xml b/sa-token-demo/sa-token-demo-springboot/pom.xml
index afaf8993..db478fb6 100644
--- a/sa-token-demo/sa-token-demo-springboot/pom.xml
+++ b/sa-token-demo/sa-token-demo-springboot/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-sso-server/pom.xml b/sa-token-demo/sa-token-demo-sso-server/pom.xml
index 18cdd8d9..ca1ce2cb 100644
--- a/sa-token-demo/sa-token-demo-sso-server/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso-server/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-sso1-client/pom.xml b/sa-token-demo/sa-token-demo-sso1-client/pom.xml
index c21a3263..a1156b39 100644
--- a/sa-token-demo/sa-token-demo-sso1-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso1-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-sso2-client/pom.xml b/sa-token-demo/sa-token-demo-sso2-client/pom.xml
index da44a372..217ca4e5 100644
--- a/sa-token-demo/sa-token-demo-sso2-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso2-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-sso3-client/pom.xml b/sa-token-demo/sa-token-demo-sso3-client/pom.xml
index 9af2f62c..582b5619 100644
--- a/sa-token-demo/sa-token-demo-sso3-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso3-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-thymeleaf/pom.xml b/sa-token-demo/sa-token-demo-thymeleaf/pom.xml
index 3227b68d..01f25c41 100644
--- a/sa-token-demo/sa-token-demo-thymeleaf/pom.xml
+++ b/sa-token-demo/sa-token-demo-thymeleaf/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-webflux/pom.xml b/sa-token-demo/sa-token-demo-webflux/pom.xml
index d71464d7..6761b05e 100644
--- a/sa-token-demo/sa-token-demo-webflux/pom.xml
+++ b/sa-token-demo/sa-token-demo-webflux/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-websocket-spring/pom.xml b/sa-token-demo/sa-token-demo-websocket-spring/pom.xml
index e0a4b2a7..79d42352 100644
--- a/sa-token-demo/sa-token-demo-websocket-spring/pom.xml
+++ b/sa-token-demo/sa-token-demo-websocket-spring/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-demo/sa-token-demo-websocket/pom.xml b/sa-token-demo/sa-token-demo-websocket/pom.xml
index b18f7b89..f6c7c345 100644
--- a/sa-token-demo/sa-token-demo-websocket/pom.xml
+++ b/sa-token-demo/sa-token-demo-websocket/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>
diff --git a/sa-token-doc/doc/README.md b/sa-token-doc/doc/README.md
index 7022c5bd..01cdd07f 100644
--- a/sa-token-doc/doc/README.md
+++ b/sa-token-doc/doc/README.md
@@ -1,7 +1,7 @@
 <p align="center">
 	<img alt="logo" src="https://sa-token.dev33.cn/doc/logo.png" width="150" height="150">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.30.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</h1>
 <h5 align="center">一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！</h5>
 <p align="center" class="badge-box">
 	<a href="https://gitee.com/dromara/sa-token/stargazers"><img src="https://gitee.com/dromara/sa-token/badge/star.svg?theme=gvp"></a>
diff --git a/sa-token-doc/doc/index-backup.html b/sa-token-doc/doc/index-backup.html
index f4687a7a..0e171bb0 100644
--- a/sa-token-doc/doc/index-backup.html
+++ b/sa-token-doc/doc/index-backup.html
@@ -19,7 +19,7 @@
 					<div class="logo-box">
 						<img src="logo.png" title="logo" />
 						<h1 class="logo-text">Sa-Token</h1>
-						<sub>v1.30.0</sub>
+						<sub>v1.31.0.RC</sub>
 					</div>
 				</a>
 			</div>
@@ -114,7 +114,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.30.0';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0.RC';	// Sa-Token最新版本 
 			var name = '<img style="width: 60px; height: 60px; vertical-align: middle;" src="logo.png" alt="logo" /> ';
 			name += '<b style="font-size: 28px; vertical-align: middle;">Sa-Token</b> <sub>v' + saTokenTopVersion + '</sub>';
 			window.$docsify = {
@@ -167,6 +167,7 @@
 
 		<!-- jqeury -->
 		<script src="https://unpkg.com/jquery@3.4.1/dist/jquery.min.js"></script>
+		<script src="https://www.layuicdn.com/layer-v3.1.1/layer.js"></script>
 		
 		<script>
 			if(window.jQuery === undefined || window.Docsify === undefined) {
@@ -205,5 +206,12 @@
 			})();
 		</script>
 		
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
 	</body>
 </html>
diff --git a/sa-token-doc/doc/index.html b/sa-token-doc/doc/index.html
index 557be353..cc53569e 100644
--- a/sa-token-doc/doc/index.html
+++ b/sa-token-doc/doc/index.html
@@ -20,7 +20,7 @@
 					<div class="logo-box">
 						<img src="logo.png" title="logo" />
 						<h1 class="logo-text">Sa-Token</h1>
-						<sub>v1.30.0</sub>
+						<sub>v1.31.0.RC</sub>
 					</div>
 				</a>
 			</div>
@@ -30,6 +30,7 @@
 				</div>
 				<select class="p-none" onchange="location.href=this.value">
 					<option value="http://sa-token.dev33.cn/doc/index.html">最新版</option>
+					<option value="http://sa-token.dev33.cn/v/v1.30.0/doc/index.html">v1.30.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.29.0/doc/index.html">v1.29.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.28.0/doc/index.html">v1.28.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.27.0/doc/index.html">v1.27.0</option>
@@ -115,7 +116,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.30.0';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0.RC';	// Sa-Token最新版本 
 			var name = '<img style="width: 60px; height: 60px; vertical-align: middle;" src="logo.png" alt="logo" /> ';
 			name += '<b style="font-size: 28px; vertical-align: middle;">Sa-Token</b> <sub>v' + saTokenTopVersion + '</sub>';
 			window.$docsify = {
@@ -168,6 +169,7 @@
 
 		<!-- jqeury -->
 		<script src="https://unpkg.zhimg.com/jquery@3.4.1/dist/jquery.min.js"></script>
+		<script src="https://www.layuicdn.com/layer-v3.1.1/layer.js"></script>
 		
 		<script>
 			if(window.jQuery === undefined || window.Docsify === undefined) {
@@ -206,5 +208,12 @@
 			})();
 		</script>
 		
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
 	</body>
 </html>
diff --git a/sa-token-doc/doc/more/update-log.md b/sa-token-doc/doc/more/update-log.md
index 87661a7e..f1c8b20c 100644
--- a/sa-token-doc/doc/more/update-log.md
+++ b/sa-token-doc/doc/more/update-log.md
@@ -1,6 +1,39 @@
 # 更新日志 
 
 
+### 2022-8-29 @v1.31.0
+- 文档：新增优秀开源案例展示。
+- 文档：新增博客展示，欢迎大家投稿。 
+- 新增：新增 `SaInterceptor` 综合拦截器。   **[重要]**  **[不向下兼容]**
+- 新增：新增 新增 `@SaIgnore` 忽略鉴权注解。   **[重要]** 
+- 新增：新增插件 `sa-token-dao-redis-fastjson`，感谢 `@sikadai` 提交的pr。  **[重要]**
+- 新增：新增插件 `sa-token-context-grpc`，感谢 `@LiYiMing666` 提交的pr。  **[重要]**
+- 重构：SaSession 取消 `tokenSignList` 的 final 修饰符。
+- 新增：SaSession 添加 `setTokenSignList` 方法。
+- 重构：TokenSign 新增 `setValue` 和 `setDevice` 方法。
+- 修复：修复多账号模式下不能正确重置 `StpLogic` 的问题。
+- 修复：修复 SaSession 对象中 TokenSign 判断有可能空指针的问题。 
+- 修复：解决当权限码为 null 时可能带来的空指针问题。
+- 新增：新增 `StpUtil.getExtra(tokenValue, key)` 方法，用于获取任意 token 的扩展参数。 
+- 优化：优化 `StpLogic#logoutByTokenValue` 方法逻辑，精简代码。
+- 修复：修复部分场景下踢人下线会抛出异常 `非Web上下文无法获取Request` 的问题。 
+- 新增：新增方法 `StpLogic#getAnonTokenSession`，可在未登录情况下安全的获取 Token-Session。  **[重要]** 
+- 新增：新增 `SaApplication` 对象，用于全局作用域存取值。   **[重要]** 
+- 重构：将 `SaTokenListener` 改为事件发布订阅模式，允许同时注册多个侦听器。  **[重要]**  **[不向下兼容]**
+- 新增：会话查询API增加反序获取会话方式。
+- 新增：SSO模块增加 server-url 属性，用于简化各种 url 配置。  **[重要]**
+- 修复：修复单点登录模块 `ssoLogoutCall` 配置项无效的问题。 
+- 优化：优化 `SaSsoHandle.checkTicket(ticket, currUri);` 方法，使其不提供 currUri 参数时将不再注册单点注销回调。
+- 修复：修复 `SaOAuth2Handle` 类中 `doLogin` 方法没有使用 `Param.pwd` 常量的问题。 
+- 新增：新增 `SaOAuth2Util.checkClientTokenScope(clientToken, scopes)` 方法，校验 Client-Token 是否含有指定 Scope。
+- 删除：删除 `sa-token-jwt` 模块过期 class。
+- 重构：`sa-token-jwt` 模块依赖改为 `hutool-jwt`，并升级版本为 5.8.5。
+- 重构：`sa-token-jwt` 模块改为 `Util + Template` 形式，方便针对部分代码重写。  **[重要]** 
+- 新增：在线文档添加API手册。
+- 重构：`sa-token-oauth2` 模块密码模式新增 `client_secret` 参数校验。**[不向下兼容]** 
+- 优化：开源案例分离专属仓库：[Awesome-Sa-Token](https://gitee.com/sa-token/awesome-sa-token)
+
+
 ### 2022-05-9 @v1.30.0
 - 新增：新增集成 Web-Socket 鉴权示例。 **[重要]**
 - 新增：新增集成 Web-Socket（Spring封装版） 鉴权示例。
diff --git a/sa-token-doc/index.html b/sa-token-doc/index.html
index 42f144a3..df130d9d 100644
--- a/sa-token-doc/index.html
+++ b/sa-token-doc/index.html
@@ -23,7 +23,7 @@
 							<img src="./doc/logo.png" title="logo" />
 							<span class="logo-text">Sa-Token</span>
 							<!-- <h1 class="logo-text">Sa-Token</h1> -->
-							<!-- <sub>v1.30.0</sub> -->
+							<!-- <sub>v1.31.0.RC</sub> -->
 						</div>
 					</a>
 				</div>
@@ -70,7 +70,7 @@
 			<div class="main-box">
 				<div class="content-box">
 					<!-- <div class="fenge"></div> -->
-					<h1>Sa-Token<small>v1.30.0</small></h1>
+					<h1>Sa-Token<small>v1.31.0.RC</small></h1>
 					<div class="sub-title">一个轻量级 java 权限认证框架，让鉴权变得简单、优雅！</div>
 					<div class="btn-box">
 						<a class="abtn" href="https://github.com/dromara/sa-token" target="_blank">GitHub</a>
@@ -630,5 +630,13 @@
 			
 		</script>
 
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
+
 	</body>
 </html>
diff --git a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/constants/GrpcContextConstants.java b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/constants/GrpcContextConstants.java
index 2193c62d..62ec93f7 100644
--- a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/constants/GrpcContextConstants.java
+++ b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/constants/GrpcContextConstants.java
@@ -5,10 +5,11 @@ import cn.dev33.satoken.util.SaTokenConsts;
 import io.grpc.Metadata;
 
 /**
+ * 常量 
+ * 
  * @author lym
- * @description
- * @date 2022/8/26 14:27
- **/
+ * @since: 2022/8/26 14:27
+ */
 public class GrpcContextConstants {
     public static final Metadata.Key<String> SA_ID_TOKEN =
             Metadata.Key.of(SaIdUtil.ID_TOKEN, Metadata.ASCII_STRING_MARSHALLER);
diff --git a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/context/SaTokenGrpcContext.java b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/context/SaTokenGrpcContext.java
index 353061f4..41ed7bd5 100644
--- a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/context/SaTokenGrpcContext.java
+++ b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/context/SaTokenGrpcContext.java
@@ -7,7 +7,7 @@ import java.util.Map;
 
 /**
  * @author lym
- * @date 2022/8/25 11:02
+ * @since 2022/8/25 11:02
  **/
 public class SaTokenGrpcContext {
     /**
diff --git a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenContextGrpcServerInterceptor.java b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenContextGrpcServerInterceptor.java
index b5acf793..805a1b29 100644
--- a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenContextGrpcServerInterceptor.java
+++ b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenContextGrpcServerInterceptor.java
@@ -6,9 +6,10 @@ import net.devh.boot.grpc.server.interceptor.GrpcGlobalServerInterceptor;
 import org.springframework.core.Ordered;
 
 /**
+ * 处理请求前，创建上下文
+ * 
  * @author lym
- * @date 2022/8/24 10:09
- * @description 处理请求前，创建上下文
+ * @since 2022/8/24 10:09
  */
 @GrpcGlobalServerInterceptor
 public class SaTokenContextGrpcServerInterceptor implements ServerInterceptor, Ordered {
diff --git a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcClientInterceptor.java b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcClientInterceptor.java
index 44db31d6..9983832e 100644
--- a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcClientInterceptor.java
+++ b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcClientInterceptor.java
@@ -12,9 +12,10 @@ import org.springframework.core.Ordered;
 
 
 /**
+ * 客户端请求的时候，带上token
+ * 
  * @author lym
- * @date 2022/8/24 15:45
- * @description 客户端请求的时候，带上token
+ * @since 2022/8/24 15:45
  */
 @GrpcGlobalClientInterceptor
 public class SaTokenGrpcClientInterceptor implements ClientInterceptor, Ordered {
diff --git a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcServerInterceptor.java b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcServerInterceptor.java
index 6bfd9511..b0e81ac9 100644
--- a/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcServerInterceptor.java
+++ b/sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcServerInterceptor.java
@@ -9,9 +9,10 @@ import io.grpc.*;
 import net.devh.boot.grpc.server.interceptor.GrpcGlobalServerInterceptor;
 
 /**
+ * 鉴权，设置token
+ * 
  * @author lym
- * @description 鉴权，设置token
- * @date 2022/8/25 11:33
+ * @since 2022/8/25 11:33
  **/
 @GrpcGlobalServerInterceptor
 public class SaTokenGrpcServerInterceptor implements ServerInterceptor {