style(header): 统一核心契约缓存和测试文件格式

- 按 PHP-CS-Fixer 规则补齐核心契约、异常、缓存和 XML 工具文件头。

- 规范导入、PHPDoc 类型顺序与注释格式，保持项目头信息不丢失。

- 同步整理缓存键、缓存实现、XML 编解码相关测试和 bootstrap 格式。

Author: zoujingli

src/Contract/ConfigInterface.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 平台配置契约。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Contract;

src/Contract/StoreCacheInterface.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * SDK 运行态缓存契约。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Contract;

src/Contract/StoreTokenInterface.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 微信服务平台授权方 Token 存储契约。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Contract;

src/Exception/ApiException.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 平台接口请求异常。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Exception;

src/Exception/SignatureException.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 签名与验签异常。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Exception;

src/Exception/WechatException.php

@@ -1,22 +1,21 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * SDK 基础异常。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Exception;
 
-use RuntimeException;
-use Throwable;
-
 /**
  * SDK 基础异常。
  *
  * 通过 context() 暴露平台响应、验签明细等上下文，便于业务侧记录日志和排查问题。
  */
-class WechatException extends RuntimeException
+class WechatException extends \RuntimeException
 {
     /**
      * 创建 SDK 异常并保存可选上下文。
@@ -26,7 +25,7 @@ class WechatException extends RuntimeException
     public function __construct(
         string $message,
         int $code = 0,
-        ?Throwable $previous = null,
+        ?\Throwable $previous = null,
         private readonly array $context = []
     ) {
         parent::__construct($message, $code, $previous);

src/Support/CacheKey.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 缓存键生成工具。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Support;
@@ -18,9 +20,9 @@ final class CacheKey
     /**
      * 组合缓存完整键。
      *
-     * @param string $prefix 根 Client 通用命名段，不得为空，用于区分部署、租户或应用。
+     * @param string $prefix 根 Client 通用命名段，不得为空，用于区分部署、租户或应用
      * @param string $channel 通道段，如 `wechat.platform`，必须与 Client 通道标识一致。
-     * @param string $logicalKey 业务逻辑键，如 TokenCacheKey 生成的 access_token 键。
+     * @param string $logicalKey 业务逻辑键，如 TokenCacheKey 生成的 access_token 键
      */
     public static function compose(string $prefix, string $channel, string $logicalKey): string
     {

src/Support/FileCacheStore.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 本地文件缓存实现。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Support;
@@ -60,7 +62,7 @@ public function get(string $key, mixed $default = null): mixed
             return $default;
         }
 
-        /** @var array{expires_at?:int,value?:mixed}|null $payload */
+        /** @var null|array{expires_at?:int,value?:mixed} $payload */
         $payload = json_decode($raw, true);
         if (!is_array($payload) || !array_key_exists('expires_at', $payload) || !array_key_exists('value', $payload)) {
             return $default;

src/Support/NullCacheStore.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * 空缓存实现。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Support;

src/Support/PsrSimpleCacheStore.php

@@ -1,9 +1,11 @@
 <?php
 
 declare(strict_types=1);
-
 /**
- * PSR-16 缓存适配器。
+ * This file is part of HyperfAdmin.
+ *
+ * @Link https://thinkadmin.top
+ * @Author Anyon<zoujingli@qq.com>
  */
 
 namespace We\Support;