chore(release): 1.0.0-beta.12

feat(exception): 新增业务错误处理和 API 迁移支持
- 新增业务错误类型和相关错误码 - 实现 API 迁移异常处理 - 增加未实现功能异常处理 - 更新错误处理逻辑，支持新错误类型 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>
2026-01-15 07:35:08 +08:00 · 2025-08-08 14:33:07 +08:00 · 2025-08-02 18:35:31 +08:00 · 2025-07-11 16:36:06 +08:00 · 2025-07-11 16:34:10 +08:00 · 2025-07-09 14:36:33 +08:00
53 changed files with 16476 additions and 12070 deletions
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,49 @@
+{
+    "name": "Hyperf Development Kit Core Dev Container",
+    "image": "harbor.luxcreo.cn/library/hyperf:8.1-swoole",
+    // 基础配置
+    "workspaceFolder": "/srv/www", // 对应 --workdir
+    "workspaceMount": "source=${localWorkspaceFolder},target=/srv/www,type=bind", // 主工作区挂载
+    // 附加挂载
+    "mounts": [
+        "source=${env:HOME}/.ssh,target=/root/.ssh,type=bind", // SSH 密钥挂载
+        "source=${env:HOME}/.gitconfig,target=/root/.gitconfig,type=bind" // SSH 密钥挂载
+    ],
+    // 容器生命周期
+    "shutdownAction": "stopContainer", // 类似 --rm 的清理行为
+    "updateRemoteUserUID": true, // 确保用户 ID 同步
+    // 保留的必要 runArgs
+    "runArgs": [
+        "--pull=always", // 强制拉取最新镜像
+        "--name=hdk-core" // 容器命名（需保持唯一性）
+    ],
+    // 初始化命令
+    "postCreateCommand": "echo 'Container initialized!'",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "rid9.datetime",
+                "MS-CEINTL.vscode-language-pack-zh-hans",
+                "ms-azuretools.vscode-docker",
+                "janisdd.vscode-edit-csv",
+                "onecentlin.laravel-blade",
+                "DavidWang.ini-for-vscode",
+                "bmewburn.vscode-intelephense-client",
+                "mechatroner.rainbow-csv",
+                "Alibaba-Cloud.tongyi-lingma",
+                "atommaterial.a-file-icon-vscode",
+                "ParthR2031.colorful-comments",
+                "vincaslt.highlight-matching-tag",
+                "xabikos.JavaScriptSnippets",
+                "shufo.vscode-blade-formatter",
+                "dansysanalyst.pest-snippets",
+                "m1guelpf.better-pest",
+                "xoronic.pestfile",
+                "xdebug.php-debug",
+                "golang.go",
+                "cweijan.vscode-typora",
+                "ciceroisback.loam"
+            ]
+        }
+    }
+}
--- a/.gitea/workflows/publish_on_tagged.yml
+++ b/.gitea/workflows/publish_on_tagged.yml
@@ -0,0 +1,28 @@
+name: Release development version to registry
+on:
+  push:
+    tags:
+      - '**.**'
+
+jobs:
+  Publish on Tagged:
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "🔎 The name of your branch is ${{ gitea.ref }} and your repository is ${{ gitea.repository }}."
+      - name: Check out repository code
+        uses: actions/checkout@v4
+      - run: echo "💡 The ${{ gitea.repository }} repository has been cloned to the runner."
+      - name: List files in the repository
+        run: |
+          ls ${{ gitea.workspace }}
+      - name: Zip files in the repository
+        run: |
+          apt-get update
+          apt-get install zip
+          zip -r hdk-core.dist.zip *
+      - name: Publish to registry
+        run: |
+          curl --user ch4o5:4fd300672472e666014314c1c94c604c634165a9 \
+               --upload-file ./hdk-core.dist.zip \
+               https://nest.doylee.cn/api/packages/HDK/composer?version=${{ gitea.ref_name }}-alpha
+      - run: echo "🍏 This job's status is ${{ job.status }}."
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 vendor/
 .phpunit.result.cache
-.php-cs-fixer.cache
+.php-cs-fixer.cache
+runtime/
--- a/.idea/HDK-Core.iml
+++ b/.idea/HDK-Core.iml
@@ -3,161 +3,193 @@
  <component name="NewModuleRootManager">
    <content url="file://$MODULE_DIR$">
      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" packagePrefix="Singularity\HDK\Core\" />
-      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" />
      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" packagePrefix="Singularity\HDK\Test\Core\" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/recursion-context" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/lines-of-code" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/type" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/version" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/cli-parser" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/environment" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/exporter" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/resource-operations" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/promises" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/psr7" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/guzzle" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/tea-xml" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <excludeFolder url="file://$MODULE_DIR$/runtime" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/adbario/php-dot-notation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/credentials" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/darabonba-openapi" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/dysmsapi-20170525" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/endpoint-util" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/gateway-spi" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/openapi-util" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/tea" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/tea-utils" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/gateway-spi" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/endpoint-util" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/dysmsapi-20170525" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/credentials" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/justinrainbow/json-schema" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/graham-campbell/result-type" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/alibabacloud/tea-xml" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/composer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/fig/http-message-util" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/lmc/http-constants" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/cache" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-server-handler" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/event-dispatcher" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-server-middleware" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-message" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/container" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-client" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/log" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-factory" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/phar-utils" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/jsonlint" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/signal-handler" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/php-parser" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/fast-route" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/react/promise" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/roave/dont" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/database" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/contract" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/di" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/context" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/logger" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/http-server" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/translation" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/framework" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/config" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/redis" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/constants" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/dispatcher" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/server" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/utils" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/http-message" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/exception-handler" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/macroable" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/pool" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/event" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/validation" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/session" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/nesbot/carbon" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/php-di/phpdoc-reader" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/teapot/status-code" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/vlucas/phpdotenv" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/adbario/php-dot-notation" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/egulias/email-validator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/laminas/laminas-mime" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/laminas/laminas-stdlib" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/monolog/monolog" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/php-enum" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/deep-copy" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/manifest" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/version" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-timer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-text-template" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-code-coverage" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-invoker" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-file-iterator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php73" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php80" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-ctype" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php81" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php72" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mailer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/filesystem" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-idn" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-normalizer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/finder" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mime" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/string" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/deprecation-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/service-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/process" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/console" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-mbstring" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-grapheme" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/theseer/tokenizer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/lexer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/inflector" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/annotations" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/instantiator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/ergebnis/http-method" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/firebase/php-jwt" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/jetbrains/phpstorm-attributes" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/lizhichao/one-sm" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpoption/phpoption" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/ralouphie/getallheaders" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/comparator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/global-state" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-enumerator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-reflector" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/complexity" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/diff" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/swoole/ide-helper" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/options-resolver" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/nunomaduro/collision" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/pestphp/pest" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/stopwatch" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpstan/phpstan" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/pestphp/pest-plugin" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofphp/php-cs-fixer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/filp/whoops" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/deprecations" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/phpunit" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/engine" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/spatie/pest-plugin-test-time" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/spatie/test-time" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/coordinator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/engine-contract" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/resource" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/paginator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/guzzle" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-foundation" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/collection" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/db" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/pipeline" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/tappable" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/serializer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/inflector" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/instantiator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/lexer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/egulias/email-validator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/ergebnis/http-method" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/fig/http-message-util" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/filp/whoops" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/firebase/php-jwt" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofphp/php-cs-fixer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/graham-campbell/result-type" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/guzzle" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/promises" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/psr7" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/code-parser" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/codec" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/collection" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/conditionable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/config" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/constants" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/context" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/contract" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/coordinator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/coroutine" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/crontab" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/database" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/db" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/di" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/dispatcher" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/engine" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/engine-contract" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/event" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/exception-handler" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/framework" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/guzzle" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/http-message" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/http-server" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/logger" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/macroable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/paginator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/pipeline" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/pool" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/redis" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/resource" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/serializer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/server" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/session" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/stringable" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/support" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/tappable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/translation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/utils" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/validation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/jetbrains/phpstorm-attributes" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/justinrainbow/json-schema" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/laminas/laminas-mime" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/laminas/laminas-stdlib" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/lizhichao/one-sm" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/lmc/http-constants" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/monolog/monolog" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/deep-copy" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/php-enum" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nesbot/carbon" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/fast-route" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/php-parser" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nunomaduro/collision" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/pestphp/pest" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/pestphp/pest-plugin" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/manifest" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/version" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/php-di/phpdoc-reader" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpoption/phpoption" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpstan/phpstan" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-code-coverage" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-file-iterator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-invoker" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-text-template" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-timer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/phpunit" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/clock" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/container" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/event-dispatcher" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-client" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-factory" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-message" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-server-handler" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-server-middleware" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/log" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/ralouphie/getallheaders" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/promise" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/roave/dont" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/cli-parser" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/comparator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/complexity" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/diff" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/environment" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/exporter" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/global-state" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/lines-of-code" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-enumerator" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-reflector" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/recursion-context" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/type" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/version" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/jsonlint" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/phar-utils" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/seld/signal-handler" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/spatie/pest-plugin-test-time" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/spatie/test-time" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/swoole/ide-helper" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/console" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/deprecation-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/filesystem" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/finder" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-foundation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mailer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mime" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/options-resolver" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-ctype" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-grapheme" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-idn" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-normalizer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-mbstring" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php73" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php80" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php81" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php83" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/process" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/serializer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/service-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/stopwatch" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/string" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/teapot/status-code" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/theseer/tokenizer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/vlucas/phpdotenv" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/brianium/paratest" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/fidry/cpu-core-counter" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofhyperf/pest-plugin-hyperf" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofhyperf/rector" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/stdlib" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/testing" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/jean85/pretty-package-versions" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nunomaduro/termwind" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/pestphp/pest-plugin-arch" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-common" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-docblock" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/type-resolver" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpstan/phpdoc-parser" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/rector/rector" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/swow/psr7-plus" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/ta-tikoma/phpunit-architecture-test" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/webmozart/assert" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/carbonphp/carbon-doctrine-types" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php82" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/clue/ndjson-react" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/evenement/evenement" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/cache" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/child-process" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/dns" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/event-loop" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/socket" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/react/stream" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpspec/php-diff" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpspec/phpspec" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/phpspec/prophecy" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php84" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/yaml" />
    </content>
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
--- a/.idea/codeception.xml
+++ b/.idea/codeception.xml
@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Codeception">
-    <option name="configurations">
-      <list>
-        <Configuration>
-          <option name="path" value="$PROJECT_DIR$/tests" />
-        </Configuration>
-      </list>
-    </option>
-  </component>
-</project>
--- a/.idea/jsonSchemas.xml
+++ b/.idea/jsonSchemas.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JsonSchemaMappingsProjectConfiguration">
+    <state>
+      <map>
+        <entry key="composer.json">
+          <value>
+            <SchemaInfo>
+              <option name="name" value="composer.json" />
+              <option name="relativePathToSchema" value="https://getcomposer.org/schema.json" />
+              <option name="applicationDefined" value="true" />
+              <option name="patterns">
+                <list>
+                  <Item>
+                    <option name="path" value="composer.json" />
+                  </Item>
+                </list>
+              </option>
+            </SchemaInfo>
+          </value>
+        </entry>
+      </map>
+    </state>
+  </component>
+</project>
--- a/.idea/pest.xml
+++ b/.idea/pest.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PestSettings">
+    <option name="preferredTestFlavor" value="TEST" />
+  </component>
+</project>
--- a/.idea/php-docker-settings.xml
+++ b/.idea/php-docker-settings.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PhpDockerContainerSettings">
+    <list>
+      <map>
+        <entry key="9fb85f67-19fd-423f-9358-1b155a12eb7d">
+          <value>
+            <DockerContainerSettings>
+              <option name="version" value="1" />
+              <option name="volumeBindings">
+                <list>
+                  <DockerVolumeBindingImpl>
+                    <option name="containerPath" value="/srv/www" />
+                    <option name="hostPath" value="$PROJECT_DIR$" />
+                  </DockerVolumeBindingImpl>
+                </list>
+              </option>
+            </DockerContainerSettings>
+          </value>
+        </entry>
+      </map>
+    </list>
+  </component>
+</project>
--- a/.idea/php-test-framework.xml
+++ b/.idea/php-test-framework.xml
@@ -2,6 +2,13 @@
 <project version="4">
  <component name="PhpTestFrameworkSettings">
    <test_tools>
+      <tool tool_name="PHPSpec">
+        <settings>
+          <configurations>
+            <local_configuration executable_path="$PROJECT_DIR$/vendor/phpspec/phpspec/bin/phpspec" />
+          </configurations>
+        </settings>
+      </tool>
      <tool tool_name="Pest">
        <settings>
          <configurations>
--- a/.idea/php.xml
+++ b/.idea/php.xml
@@ -15,38 +15,103 @@
      <PhpCSFixerConfiguration standards="PSR1;PSR2;Symfony;DoctrineAnnotation;PHP70Migration;PHP71Migration" tool_path="$PROJECT_DIR$/vendor/friendsofphp/php-cs-fixer/php-cs-fixer" />
    </phpcsfixer_settings>
  </component>
-  <component name="PhpExternalFormatter">
-    <option name="externalFormatter" value="PHP_CBF" />
-  </component>
  <component name="PhpIncludePathManager">
    <include_path>
+      <path value="$PROJECT_DIR$/vendor/hyperf/pool" />
+      <path value="$PROJECT_DIR$/vendor/doctrine/inflector" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/event" />
+      <path value="$PROJECT_DIR$/vendor/doctrine/instantiator" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/validation" />
+      <path value="$PROJECT_DIR$/vendor/doctrine/deprecations" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/guzzle" />
+      <path value="$PROJECT_DIR$/vendor/ergebnis/http-method" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/session" />
+      <path value="$PROJECT_DIR$/vendor/firebase/php-jwt" />
+      <path value="$PROJECT_DIR$/vendor/nesbot/carbon" />
+      <path value="$PROJECT_DIR$/vendor/jetbrains/phpstorm-attributes" />
+      <path value="$PROJECT_DIR$/vendor/php-di/phpdoc-reader" />
+      <path value="$PROJECT_DIR$/vendor/lizhichao/one-sm" />
+      <path value="$PROJECT_DIR$/vendor/phpoption/phpoption" />
+      <path value="$PROJECT_DIR$/vendor/ralouphie/getallheaders" />
+      <path value="$PROJECT_DIR$/vendor/swoole/ide-helper" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/comparator" />
+      <path value="$PROJECT_DIR$/vendor/teapot/status-code" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/global-state" />
+      <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/object-enumerator" />
+      <path value="$PROJECT_DIR$/vendor/adbario/php-dot-notation" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/object-reflector" />
+      <path value="$PROJECT_DIR$/vendor/egulias/email-validator" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/complexity" />
+      <path value="$PROJECT_DIR$/vendor/laminas/laminas-mime" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
+      <path value="$PROJECT_DIR$/vendor/laminas/laminas-stdlib" />
+      <path value="$PROJECT_DIR$/vendor/sebastian/diff" />
+      <path value="$PROJECT_DIR$/vendor/monolog/monolog" />
      <path value="$PROJECT_DIR$/vendor/sebastian/recursion-context" />
+      <path value="$PROJECT_DIR$/vendor/myclabs/php-enum" />
      <path value="$PROJECT_DIR$/vendor/sebastian/lines-of-code" />
+      <path value="$PROJECT_DIR$/vendor/myclabs/deep-copy" />
      <path value="$PROJECT_DIR$/vendor/sebastian/type" />
      <path value="$PROJECT_DIR$/vendor/sebastian/version" />
      <path value="$PROJECT_DIR$/vendor/sebastian/cli-parser" />
+      <path value="$PROJECT_DIR$/vendor/phar-io/manifest" />
      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit" />
+      <path value="$PROJECT_DIR$/vendor/phar-io/version" />
      <path value="$PROJECT_DIR$/vendor/sebastian/environment" />
+      <path value="$PROJECT_DIR$/vendor/phpstan/phpstan" />
      <path value="$PROJECT_DIR$/vendor/sebastian/exporter" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/resource-operations" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/php-timer" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/phpunit" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/promises" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/php-text-template" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/psr7" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/php-code-coverage" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/guzzle" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/php-invoker" />
+      <path value="$PROJECT_DIR$/vendor/phpunit/php-file-iterator" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/tea-xml" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php73" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/darabonba-openapi" />
+      <path value="$PROJECT_DIR$/vendor/symfony/serializer" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/openapi-util" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php80" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/tea" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-ctype" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/tea-utils" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php81" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/gateway-spi" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/endpoint-util" />
+      <path value="$PROJECT_DIR$/vendor/symfony/translation" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/dysmsapi-20170525" />
+      <path value="$PROJECT_DIR$/vendor/symfony/translation-contracts" />
      <path value="$PROJECT_DIR$/vendor/alibabacloud/credentials" />
+      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher" />
+      <path value="$PROJECT_DIR$/vendor/friendsofphp/php-cs-fixer" />
+      <path value="$PROJECT_DIR$/vendor/symfony/mailer" />
      <path value="$PROJECT_DIR$/vendor/justinrainbow/json-schema" />
+      <path value="$PROJECT_DIR$/vendor/symfony/filesystem" />
      <path value="$PROJECT_DIR$/vendor/graham-campbell/result-type" />
+      <path value="$PROJECT_DIR$/vendor/symfony/options-resolver" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-idn" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-normalizer" />
+      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher-contracts" />
+      <path value="$PROJECT_DIR$/vendor/symfony/finder" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php83" />
+      <path value="$PROJECT_DIR$/vendor/symfony/stopwatch" />
+      <path value="$PROJECT_DIR$/vendor/symfony/mime" />
+      <path value="$PROJECT_DIR$/vendor/symfony/string" />
+      <path value="$PROJECT_DIR$/vendor/symfony/deprecation-contracts" />
+      <path value="$PROJECT_DIR$/vendor/symfony/service-contracts" />
+      <path value="$PROJECT_DIR$/vendor/symfony/http-foundation" />
+      <path value="$PROJECT_DIR$/vendor/symfony/process" />
+      <path value="$PROJECT_DIR$/vendor/symfony/console" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-mbstring" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-grapheme" />
+      <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
      <path value="$PROJECT_DIR$/vendor/composer" />
      <path value="$PROJECT_DIR$/vendor/fig/http-message-util" />
      <path value="$PROJECT_DIR$/vendor/lmc/http-constants" />
-      <path value="$PROJECT_DIR$/vendor/psr/cache" />
      <path value="$PROJECT_DIR$/vendor/psr/http-server-handler" />
      <path value="$PROJECT_DIR$/vendor/psr/event-dispatcher" />
      <path value="$PROJECT_DIR$/vendor/psr/http-server-middleware" />
@@ -54,6 +119,7 @@
      <path value="$PROJECT_DIR$/vendor/psr/container" />
      <path value="$PROJECT_DIR$/vendor/psr/http-client" />
      <path value="$PROJECT_DIR$/vendor/psr/log" />
+      <path value="$PROJECT_DIR$/vendor/psr/clock" />
      <path value="$PROJECT_DIR$/vendor/psr/http-factory" />
      <path value="$PROJECT_DIR$/vendor/seld/phar-utils" />
      <path value="$PROJECT_DIR$/vendor/seld/jsonlint" />
@@ -63,121 +129,83 @@
      <path value="$PROJECT_DIR$/vendor/react/promise" />
      <path value="$PROJECT_DIR$/vendor/roave/dont" />
      <path value="$PROJECT_DIR$/vendor/hyperf/database" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/pipeline" />
      <path value="$PROJECT_DIR$/vendor/hyperf/contract" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/collection" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/coordinator" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/serializer" />
      <path value="$PROJECT_DIR$/vendor/hyperf/di" />
      <path value="$PROJECT_DIR$/vendor/hyperf/context" />
      <path value="$PROJECT_DIR$/vendor/hyperf/logger" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/tappable" />
      <path value="$PROJECT_DIR$/vendor/hyperf/http-server" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/coroutine" />
      <path value="$PROJECT_DIR$/vendor/hyperf/translation" />
      <path value="$PROJECT_DIR$/vendor/hyperf/framework" />
      <path value="$PROJECT_DIR$/vendor/hyperf/config" />
      <path value="$PROJECT_DIR$/vendor/hyperf/redis" />
      <path value="$PROJECT_DIR$/vendor/hyperf/constants" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/codec" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/crontab" />
      <path value="$PROJECT_DIR$/vendor/hyperf/dispatcher" />
      <path value="$PROJECT_DIR$/vendor/hyperf/server" />
      <path value="$PROJECT_DIR$/vendor/hyperf/utils" />
      <path value="$PROJECT_DIR$/vendor/hyperf/http-message" />
      <path value="$PROJECT_DIR$/vendor/hyperf/exception-handler" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/code-parser" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/conditionable" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/engine-contract" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/support" />
      <path value="$PROJECT_DIR$/vendor/hyperf/macroable" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/db" />
      <path value="$PROJECT_DIR$/vendor/hyperf/resource" />
      <path value="$PROJECT_DIR$/vendor/hyperf/paginator" />
      <path value="$PROJECT_DIR$/vendor/hyperf/engine" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/pool" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/event" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/validation" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/session" />
-      <path value="$PROJECT_DIR$/vendor/nesbot/carbon" />
-      <path value="$PROJECT_DIR$/vendor/php-di/phpdoc-reader" />
-      <path value="$PROJECT_DIR$/vendor/teapot/status-code" />
-      <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
-      <path value="$PROJECT_DIR$/vendor/adbario/php-dot-notation" />
-      <path value="$PROJECT_DIR$/vendor/egulias/email-validator" />
-      <path value="$PROJECT_DIR$/vendor/laminas/laminas-mime" />
-      <path value="$PROJECT_DIR$/vendor/laminas/laminas-stdlib" />
-      <path value="$PROJECT_DIR$/vendor/monolog/monolog" />
-      <path value="$PROJECT_DIR$/vendor/myclabs/php-enum" />
-      <path value="$PROJECT_DIR$/vendor/myclabs/deep-copy" />
-      <path value="$PROJECT_DIR$/vendor/phar-io/manifest" />
-      <path value="$PROJECT_DIR$/vendor/phar-io/version" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-timer" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/phpunit" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-text-template" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-code-coverage" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-invoker" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-file-iterator" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php73" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php80" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-ctype" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php81" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php72" />
-      <path value="$PROJECT_DIR$/vendor/symfony/translation" />
-      <path value="$PROJECT_DIR$/vendor/symfony/translation-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher" />
-      <path value="$PROJECT_DIR$/vendor/symfony/mailer" />
-      <path value="$PROJECT_DIR$/vendor/symfony/filesystem" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-idn" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-normalizer" />
-      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/finder" />
-      <path value="$PROJECT_DIR$/vendor/symfony/mime" />
-      <path value="$PROJECT_DIR$/vendor/symfony/string" />
-      <path value="$PROJECT_DIR$/vendor/symfony/deprecation-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/service-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/process" />
-      <path value="$PROJECT_DIR$/vendor/symfony/console" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-mbstring" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-grapheme" />
-      <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/stringable" />
      <path value="$PROJECT_DIR$/vendor/doctrine/lexer" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/inflector" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/annotations" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/instantiator" />
-      <path value="$PROJECT_DIR$/vendor/ergebnis/http-method" />
-      <path value="$PROJECT_DIR$/vendor/firebase/php-jwt" />
-      <path value="$PROJECT_DIR$/vendor/jetbrains/phpstorm-attributes" />
-      <path value="$PROJECT_DIR$/vendor/lizhichao/one-sm" />
-      <path value="$PROJECT_DIR$/vendor/phpoption/phpoption" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/comparator" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/global-state" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/object-enumerator" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/object-reflector" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/complexity" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/diff" />
-      <path value="$PROJECT_DIR$/vendor/swoole/ide-helper" />
-      <path value="$PROJECT_DIR$/vendor/pestphp/pest" />
+      <path value="$PROJECT_DIR$/vendor/swow/psr7-plus" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/stdlib" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/testing" />
      <path value="$PROJECT_DIR$/vendor/pestphp/pest-plugin" />
-      <path value="$PROJECT_DIR$/vendor/filp/whoops" />
+      <path value="$PROJECT_DIR$/vendor/pestphp/pest" />
+      <path value="$PROJECT_DIR$/vendor/pestphp/pest-plugin-arch" />
+      <path value="$PROJECT_DIR$/vendor/phpstan/phpdoc-parser" />
+      <path value="$PROJECT_DIR$/vendor/webmozart/assert" />
+      <path value="$PROJECT_DIR$/vendor/brianium/paratest" />
+      <path value="$PROJECT_DIR$/vendor/fidry/cpu-core-counter" />
+      <path value="$PROJECT_DIR$/vendor/nunomaduro/termwind" />
      <path value="$PROJECT_DIR$/vendor/nunomaduro/collision" />
+      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-common" />
+      <path value="$PROJECT_DIR$/vendor/phpdocumentor/type-resolver" />
+      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-docblock" />
+      <path value="$PROJECT_DIR$/vendor/filp/whoops" />
+      <path value="$PROJECT_DIR$/vendor/ta-tikoma/phpunit-architecture-test" />
+      <path value="$PROJECT_DIR$/vendor/jean85/pretty-package-versions" />
+      <path value="$PROJECT_DIR$/vendor/friendsofhyperf/pest-plugin-hyperf" />
+      <path value="$PROJECT_DIR$/vendor/rector/rector" />
+      <path value="$PROJECT_DIR$/vendor/friendsofhyperf/rector" />
      <path value="$PROJECT_DIR$/vendor/spatie/test-time" />
      <path value="$PROJECT_DIR$/vendor/spatie/pest-plugin-test-time" />
-      <path value="$PROJECT_DIR$/vendor/friendsofphp/php-cs-fixer" />
-      <path value="$PROJECT_DIR$/vendor/symfony/options-resolver" />
-      <path value="$PROJECT_DIR$/vendor/symfony/stopwatch" />
-      <path value="$PROJECT_DIR$/vendor/phpstan/phpstan" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/deprecations" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/coordinator" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/guzzle" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/engine-contract" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/crontab" />
-      <path value="$PROJECT_DIR$/vendor/symfony/http-foundation" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/pipeline" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/collection" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/tappable" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/db" />
-      <path value="$PROJECT_DIR$/vendor/symfony/serializer" />
-      <path value="$PROJECT_DIR$/vendor/facade/ignition-contracts" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/serializer" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/code-parser" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/coroutine" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/conditionable" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/codec" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/stringable" />
-      <path value="$PROJECT_DIR$/vendor/hyperf/support" />
-      <path value="$PROJECT_DIR$/vendor/ralouphie/getallheaders" />
+      <path value="$PROJECT_DIR$/vendor/carbonphp/carbon-doctrine-types" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php82" />
+      <path value="$PROJECT_DIR$/vendor/cooper/hyperf-pest" />
+      <path value="$PROJECT_DIR$/vendor/clue/ndjson-react" />
+      <path value="$PROJECT_DIR$/vendor/evenement/evenement" />
+      <path value="$PROJECT_DIR$/vendor/react/child-process" />
+      <path value="$PROJECT_DIR$/vendor/react/cache" />
+      <path value="$PROJECT_DIR$/vendor/react/dns" />
+      <path value="$PROJECT_DIR$/vendor/react/stream" />
+      <path value="$PROJECT_DIR$/vendor/react/event-loop" />
+      <path value="$PROJECT_DIR$/vendor/react/socket" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php72" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php84" />
+      <path value="$PROJECT_DIR$/vendor/symfony/yaml" />
+      <path value="$PROJECT_DIR$/vendor/phpspec/phpspec" />
+      <path value="$PROJECT_DIR$/vendor/phpspec/php-diff" />
+      <path value="$PROJECT_DIR$/vendor/phpspec/prophecy" />
    </include_path>
  </component>
-  <component name="PhpProjectSharedConfiguration" php_language_level="8.0" />
+  <component name="PhpProjectSharedConfiguration" php_language_level="8.1" />
  <component name="PhpStan">
    <PhpStan_settings>
      <PhpStanConfiguration tool_path="$PROJECT_DIR$/vendor/bin/phpstan" />
--- a/.idea/phpspec.xml
+++ b/.idea/phpspec.xml
@@ -5,24 +5,6 @@
      <PhpSpecSuiteConfiguration>
        <option name="myPath" value="$PROJECT_DIR$" />
      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
    </suites>
  </component>
 </project>
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,294 @@
 # 版本更新日志
+## [1.0.0-beta.12](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.11...v1.0.0-beta.12) (2025-08-08)
+
+
+### ✨ Features | 新功能
+
+* **exception:** 新增业务错误处理和 API 迁移支持 ([55da020](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/55da02080efa5bd6978b7d0a0e3bbcb1cde41027))
+
+## [1.0.0-beta.11](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.10...v1.0.0-beta.11) (2025-07-11)
+
+
+### ✨ Features | 新功能
+
+* 新增SP相关配置的枚举 ([bf40c6e](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/bf40c6e681cb1ff37a8fc331a3cd0cdb495e6ff1))
+
+## [1.0.0-beta.10](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.9...v1.0.0-beta.10) (2025-07-09)
+
+
+### ✨ Features | 新功能
+
+* **core:** 添加 X-SP-ID 解析中间件 ([c6ab9db](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/c6ab9db69810bcd395c52cc304dffa54978d6e84))
+
+## [1.0.0-beta.9](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.8...v1.0.0-beta.9) (2025-07-07)
+
+
+### 📦‍ Build System | 打包构建
+
+* **deps:** 更新依赖并添加 PHPSpec 支持 ([c8b4545](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/c8b454540d2c4371c72f6cb79b5f65b97e7b92f2))
+
+## [1.0.0-beta.8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.7...v1.0.0-beta.8) (2025-03-04)
+
+
+### ✨ Features | 新功能
+
+* **email:** 添加邮件附件功能 ([3b3502f](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/3b3502f7634b48c31c3e7689cdcfe1f4b504b968))
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** Update Dependencies ([b4dcd01](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/b4dcd01e8d1fcd2c1fa211ef2a54512593500780))
+
+## [1.0.0-beta.7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.6...v1.0.0-beta.7) (2025-03-03)
+
+
+### 📦‍ Build System | 打包构建
+
+* **devcontainer:** 添加 Hyperf 开发套件核心配置文件 ([aaa4382](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/aaa4382ff2c5105bc362777f62156b8383b67ed8))
+
+
+### ✨ Features | 新功能
+
+* **EmailService:** 添加邮件附件功能并更新单元测试 ([225bded](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/225bdedd23b1655d5fb7260838fc8c60db5d8f9f))
+
+## [1.0.0-beta.6](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.5...v1.0.0-beta.6) (2024-12-06)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **exceptions:** 处理 HTTP 客户端和服务器异常 ([2dace65](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/2dace65933d7361c1124f8c5c125a507894584fb))
+
+## [1.0.0-beta.5](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.4...v1.0.0-beta.5) (2024-09-12)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([0283c72](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/0283c7286a58104c0ea649820fdab2dc781053c9))
+
+
+### ✨ Features | 新功能
+
+* **email:** 对发送邮件增加密送，增加单独定制发件人的方法 ([b6dd7dd](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/b6dd7dd4ace2623a4631d22fc4e6394e9d2ddda7))
+
+## [1.0.0-beta.4](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.3...v1.0.0-beta.4) (2024-06-23)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **core-middleware:** 修复 JsonResource 不走响应格式化的问题 ([d524fb4](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/d524fb4e890dd06da8c4fe2f0853e34944cd0e28))
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([d20718d](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/d20718db32a9dc05535ff66598475186e8016167))
+
+## [1.0.0-beta.3](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.2...v1.0.0-beta.3) (2024-05-17)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **i18n:** 在没有配置项目默认语言，且传入意料之外的语言时，默认为英文 ([44c26b6](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/44c26b64918702062f28499d566eaa54d8aff491))
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([bac22a8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/bac22a8ea683c42f597e070e1395881b46b2bd83))
+
+## [1.0.0-beta.2](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.1...v1.0.0-beta.2) (2024-01-18)
+
+
+### ⚡ Performance Improvements | 性能优化
+
+* **exception:** 取消了必须是 apifox/postman 的设计 ([2167fd2](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/2167fd209a3cc46ea77fc64909ff8adf71ec6ef0))
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **CoreMiddleware:** 修复如果直接输出 ResponseInterface 实例会报错的问题 ([762acbb](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/762acbb368d6a901478fe3d6b2a3e30793f2c57c))
+
+## [1.0.0-beta.1](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-beta.0...v1.0.0-beta.1) (2023-12-15)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **bin:** 更新了迁移脚本的目录 ([da51879](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/da518799b3b4301302217af1faa452adbcacf02b))
+
+## [1.0.0-beta.0](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.19...v1.0.0-beta.0) (2023-12-15)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **bin:** 更新了迁移脚本的目录 ([01aa833](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/01aa8335371fce4f7663eb1c16e4ef7f108e2bc5))
+
+
+### 📦‍ Build System | 打包构建
+
+* **release:** 将版本号改为 beta ([cfbb770](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/cfbb770559e748c77d52e7d913398b1d2a1d8edd))
+
+## [1.0.0-alpha.19](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.18...v1.0.0-alpha.19) (2023-12-15)
+
+
+### ✨ Features | 新功能
+
+* **bin:** 增加了迁移到最新版本的脚本 ([a84b812](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/a84b812dd0577186379e2df19493cb0fcf9b4fd9))
+
+## [1.0.0-alpha.18](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.17...v1.0.0-alpha.18) (2023-12-14)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 清理 composer 配置 ([08d00a7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/08d00a785f3be1846333777edae94e0ae237c8a2))
+
+
+### ♻️ Code Refactoring | 代码重构
+
+* 迁移到 hyperf3.1 的写法 ([97131d2](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/97131d224cfb601ba075ff1af1c4ca333680b459))
+
+
+### ✨ Features | 新功能
+
+* **bin:** 增加了迁移到最新版本的脚本 ([7d6dc7f](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/7d6dc7fe9f9bc637755768852518420e98176d56))
+
+## [1.0.0-alpha.17](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.16...v1.0.0-alpha.17) (2023-12-14)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **CoreMiddleware:** 修复参数类型过少的问题 ([14d28de](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/14d28deee2ec97991b7effe99a37cc03b19a291c))
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖，增加 php8.2/8.3的 polyfill ([b89b218](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/b89b218eaa211d0262e2f1dff4d61f2a79eacda6))
+* **ide:** 增加了docker 映射 ([cbc59cc](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/cbc59ccf74dafcedca1e4369e647ba1c003efe39))
+
+## [1.0.0-alpha.16](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.15...v1.0.0-alpha.16) (2023-12-04)
+
+
+### ♻️ Code Refactoring | 代码重构
+
+* 迁移到 hyperf3.1和 pestphp2 ([eee68ca](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/eee68cab8a06833114ae19dc2c746dcd50206cb4))
+
+## [1.0.0-alpha.15](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.14...v1.0.0-alpha.15) (2023-10-30)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([26b55f1](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/26b55f1ca5acb8b1bac3d4c23c7154a33ba1b5e6))
+
+
+### ✅ Tests | 测试
+
+* **request:** 修复了无法使用的测试用例 ([b7d0dd8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/b7d0dd87c5ef110c581df74ff9e1e8987a3fdc6b))
+* **utils:** 增加了无极分类的测试用例 ([97848a5](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/97848a5e2299d33b46ded328ea03ac76e19c5cd0))
+
+## [1.0.0-alpha.14](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.13...v1.0.0-alpha.14) (2023-10-23)
+
+
+### 👷 Continuous Integration | CI 配置
+
+* **GiteaActions:** 修复没有内容的问题 ([8e4f4d0](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/8e4f4d0d290212174d153cea7f97bc886e7194da))
+
+## [1.0.0-alpha.13](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.12...v1.0.0-alpha.13) (2023-10-23)
+
+
+### 👷 Continuous Integration | CI 配置
+
+* **GiteaActions:** 现在只会根据 tag确定是否发布 ([43c820c](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/43c820c711f09425a57097e36d01199007e3ed8f))
+
+## [1.0.0-alpha.12](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.11...v1.0.0-alpha.12) (2023-10-23)
+
+
+### 👷 Continuous Integration | CI 配置
+
+* **GiteaActions:** 不切换分支 ([4cc1473](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/4cc1473d386cf92bead68b59b123f34b25cc875b))
+* **GiteaActions:** 使用密钥推送包 ([82d9a95](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/82d9a956915f2d66c5c531bab8cebb7e49e1e3fe))
+* **GiteaActions:** 修复推送的组织名错误问题 ([635804e](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/635804e1176565e56e34b5ceb05225e7b4d5f318))
+* **GiteaActions:** 修复错误的action 写法 ([9cdbd6a](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/9cdbd6a2c8859d20740df949bff208331887d3f6))
+* **GiteaActions:** 修复镜像不包含 zip 的问题 ([895b028](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/895b0280174f96e00404bc3a0278bc318f0c119a))
+* **GiteaActions:** 修复镜像不包含 zip 的问题 ([094589b](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/094589b87e52f716485b21bb737cecadcad33c12))
+* **GiteaActions:** 修复镜像不包含 zip 的问题 ([85ae11e](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/85ae11e295326bbe39150cc7578cd47662b8de35))
+* **GiteaActions:** 修复镜像不包含 zip 的问题 ([118f0b7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/118f0b789f2932503af8e3e7810be805308f5429))
+* **GiteaActions:** 修改触发条件 ([6cb24a8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/6cb24a84b2dc23b3d5cc5e2682e81bc7a992140e))
+* **GiteaActions:** 增加了 actions ([b32afe3](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/b32afe38b4b26660581f7ab91039ce64bff6eb60))
+* **GiteaActions:** 安装 zip ([063c1d7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/063c1d7ea190676d02d099fb9e3445982be3d4e8))
+* **GiteaActions:** 尝试增加推送触发的 actions ([7dfb393](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/7dfb3933f600558f71ce295b23d950058ece5e73))
+* **GiteaActions:** 现在只会根据 tag确定是否发布 ([418f4c4](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/418f4c47c9e027eb806e4321f3ec23eb04de8c0f))
+
+## [1.0.0-alpha.11](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.10...v1.0.0-alpha.11) (2023-10-17)
+
+
+### 👷 Continuous Integration | CI 配置
+
+* **docker:** 兼容 ext-redis:6.0 ([f80da66](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/f80da661859333acff005241d2abcfd7c9f09c71))
+
+## [1.0.0-alpha.10](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2023-10-16)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([37d42c1](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/37d42c17cc8707b17f1dd0fd8e0df5b8f4048bd2))
+* **script:** root 用户可以使用 composer ([12e9960](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/12e99604c99fee38aa82aa1fbc865201be09127f))
+
+
+### ✨ Features | 新功能
+
+* **rest:** 增加多表关联的兼容 ([17c0518](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/17c051868026981031abf3e88e86f7475ce06807))
+
+## [1.0.0-alpha.9](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2023-10-13)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([e9927fa](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/e9927fafb1630e759d3a55c0143b48db91ffdcae))
+* **config:** 更新了默认的发件邮箱 ([359b13e](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/359b13e71803c87854ec6e54b119cb3bbd65ef3f))
+
+## [1.0.0-alpha.8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2023-10-08)
+
+
+### ✨ Features | 新功能
+
+* **email:** 增加了对邮件优先级的兼容 ([9f7d4ef](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/9f7d4effb7e39500d0f65d35788551cc4e7a91f1))
+
+## [1.0.0-alpha.7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2023-09-28)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **rest:** 修复不存在的具名参数 ([1106794](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/110679448f310e1d4e25f370b74f2901ca9425d0))
+
+## [1.0.0-alpha.6](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2023-09-28)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **i18n:** 修复了无法正确无视大小写导致无法识别的问题 ([cff919a](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/cff919a21e6d50e396a0d5ceaeefbe3b7c0e3095))
+* **rest:** 修复没有返回值的问题 ([2afc3ad](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/2afc3ad45b97e3df97827efdd9d16d6dedb3238a))
+
+## [1.0.0-alpha.5](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2023-09-26)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **i18n:** 修复了无法正确无视大小写导致无法识别的问题 ([7342015](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/73420153d3791bff38ddd57b5a17120a4ed3cd08))
+
+## [1.0.0-alpha.4](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2023-09-26)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 引入 pest 并升级到 php8.1 ([dbbe278](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/dbbe278aa6c96634ed5792b5782825770c5cabe8))
+
+
+### ✨ Features | 新功能
+
+* **i18n:** 增加枚举值，更新中间件调用方式 ([4032d67](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/4032d67f1e56b8ce29fbfa5bd77ead2636a6ffd3))
+
+
+### ✅ Tests | 测试
+
+* **http:** 完成并通过了 http 请求的测试 ([7a209e8](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/7a209e876f8b4301b7bc78f05b68798eb65e77f7))
+
 ## [1.0.0-alpha.3](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2023-08-30)


--- a/VERSION_TRACKER.txt
+++ b/VERSION_TRACKER.txt
@@ -1 +1 @@
-1.0.0-alpha.3
+1.0.0-beta.12
--- a/bin/hdk-migrate-core.sh
+++ b/bin/hdk-migrate-core.sh
@@ -0,0 +1,19 @@
+#!/bin/sh
+# shellcheck disable=SC2039
+
+LIB_HOME_DIR="$(pwd)/vendor/singularity/hdk-core"
+LATEST_VERSION=$(cat "${LIB_HOME_DIR}/VERSION_TRACKER.txt")
+
+echo -e '\033[44;34;5m=============================\033[0m'
+echo ''
+
+$(pwd)/vendor/bin/rector \
+  process \
+  --autoload-file=vendor/autoload.php \
+  --config="${LIB_HOME_DIR}/hyperf31_rector.php"
+
+echo ''
+echo -e '\033[44;34;5m=============================\033[0m'
+echo -e '\033[;31;1m🎉Congratulations!\033[0m'
+echo "Now you have been migrated to HDK-Core v${LATEST_VERSION}!"
+echo ''
--- a/composer.json
+++ b/composer.json
@@ -14,65 +14,74 @@
      "email": "dongyun.li@luxcreo.ai"
    }
  ],
+  "bin": [
+    "bin/hdk-migrate-core.sh"
+  ],
  "require": {
-    "php": "^8.0",
-    "ext-redis": "^5.3",
+    "php": ">=8.1",
+    "ext-dom": "*",
+    "ext-libxml": "*",
+    "ext-redis": "^5.3|^6.0",
    "ext-swoole": "*",
    "composer/composer": ">=2.0",
-    "ergebnis/http-method": "^2.2",
-    "hyperf/config": "^3.0.18",
-    "hyperf/constants": "^3.0.18",
-    "hyperf/context": "^3.0.18",
-    "hyperf/di": "^3.0.18",
-    "hyperf/framework": "^3.0.18",
-    "hyperf/logger": "^3.0.18",
-    "hyperf/redis": "^3.0.18",
-    "hyperf/resource": "^3.0.18",
-    "hyperf/translation": "^3.0.18",
+    "ergebnis/http-method": "^2.5",
+    "friendsofhyperf/rector": "^0.1.5",
+    "hyperf/config": "3.1.*",
+    "hyperf/constants": "3.1.*",
+    "hyperf/context": "3.1.*",
+    "hyperf/di": "3.1.*",
+    "hyperf/framework": "3.1.*",
+    "hyperf/logger": "3.1.*",
+    "hyperf/redis": "3.1.*",
+    "hyperf/resource": "3.1.*",
+    "hyperf/translation": "3.1.*",
    "jetbrains/phpstorm-attributes": "^1.0",
-    "lmc/http-constants": "^1.2",
-    "myclabs/php-enum": "^1.8",
-    "roave/dont": "^1.5",
-    "symfony/http-foundation": "^6.0",
-    "symfony/polyfill-php81": "^1.26",
-    "teapot/status-code": "^1.1",
-    "ext-libxml": "*",
-    "ext-dom": "*"
+    "lmc/http-constants": "^1.2.0",
+    "myclabs/php-enum": "^1.8.4",
+    "roave/dont": "^1.6.0",
+    "symfony/http-foundation": "^6.4",
+    "symfony/polyfill-php81": "^1.28",
+    "symfony/polyfill-php82": "^1.28",
+    "symfony/polyfill-php83": "^1.28",
+    "symfony/polyfill-php84": "^1.28",
+    "teapot/status-code": "^1.1.2"
  },
  "require-dev": {
    "alibabacloud/dysmsapi-20170525": "^2.0",
-    "firebase/php-jwt": "^6.1",
-    "friendsofphp/php-cs-fixer": "^3.13",
-    "guzzlehttp/guzzle": "^7.5",
-    "hyperf/crontab": "^3.0.18",
-    "hyperf/database": "^3.0.18",
-    "hyperf/db": "^3.0.18",
-    "hyperf/guzzle": "^3.0.18",
-    "hyperf/session": "^3.0.18",
-    "hyperf/validation": "^3.0.18",
-    "pestphp/pest": "^1.22",
-    "phpstan/phpstan": "^1.9",
-    "phpunit/phpunit": "^9.5",
+    "firebase/php-jwt": "^6.9",
+    "friendsofhyperf/pest-plugin-hyperf": "3.1.*",
+    "friendsofphp/php-cs-fixer": "^3.41.1",
+    "guzzlehttp/guzzle": "^7.8",
+    "hyperf/crontab": "3.1.*",
+    "hyperf/database": "3.1.*",
+    "hyperf/db": "3.1.*",
+    "hyperf/guzzle": "3.1.*",
+    "hyperf/session": "3.1.*",
+    "hyperf/testing": "^3.1",
+    "hyperf/validation": "3.1.*",
+    "pestphp/pest": "^2.23",
+    "phpspec/phpspec": "^7.5",
+    "phpstan/phpstan": "^1.10.49",
+    "rector/rector": "*",
    "roave/security-advisories": "dev-latest",
-    "spatie/pest-plugin-test-time": "^1.1",
+    "spatie/pest-plugin-test-time": "^2.0",
    "swoole/ide-helper": "*",
-    "symfony/mailer": "^6.0",
-    "symfony/serializer": "^6.0"
+    "symfony/mailer": "^6.4.0",
+    "symfony/serializer": "^6.4.1"
  },
  "suggest": {
    "firebase/php-jwt": "JWT 鉴权必需",
-    "hyperf/session": "^3.0.18",
+    "hyperf/session": "3.1.*",
    "symfony/mailer": "用于发送电子邮件",
    "symfony/serializer": "处理 XML 必需",
    "ext-dom": "处理 XML 必需",
    "ext-libxml": "处理 XML 必需",
-    "hyperf/guzzle": "^3.0.18",
+    "hyperf/guzzle": "3.1.*",
    "alibabacloud/dysmsapi-20170525": "阿里云短信服务必需"
  },
  "config": {
    "optimize-autoloader": true,
    "sort-packages": true,
-    "secure-http": false,
    "allow-plugins": {
      "pestphp/pest-plugin": true
    }
@@ -87,29 +96,45 @@
      "Singularity\\HDK\\Test\\Core\\": "tests/"
    }
  },
-  "minimum-stability": "dev",
+  "archive": {
+    "exclude": [
+      ".idea",
+      "tests",
+      "scripts",
+      "Dockerfile",
+      ".gitignore",
+      ".php-cs-fixer.*",
+      ".phpunit.result.cache",
+      "phpstan.dist.neon",
+      "phpunit.xml"
+    ]
+  },
+  "minimum-stability": "beta",
  "prefer-stable": true,
  "scripts": {
    "post-root-package-install": [],
-    "test": "vendor/bin/pest $1",
+    "test": [
+      "rm -rf runtime",
+      "pest --coroutine --prepend tests/bootstrap.php --colors=always"
+    ],
    "cs-fix": "vendor/bin/php-cs-fixer fix $1 --rules=@PSR12 --allow-risky=yes",
    "analyse": "vendor/bin/phpstan analyse $1",
    "ci": [
      "@analyse publish/ src/ tests/",
      "@cs-fix",
-      "@test --ci",
+      "@test",
      "echo CI Success"
    ]
  },
  "repositories": {
-    "lux-map": {
+    "nest": {
      "type": "composer",
-      "url": "https://satis.luxcreo.cn/"
+      "url": "https://nest.doylee.cn/api/packages/HDK/composer"
    },
    "packagist": {
      "type": "composer",
      "url": "https://mirrors.aliyun.com/composer/"
    }
  },
-  "version": "1.0.0-alpha.3"
+  "version": "1.0.0-beta.12"
 }
--- a/composer.lock
+++ b/composer.lock
--- a/hyperf31_rector.php
+++ b/hyperf31_rector.php
@@ -0,0 +1,198 @@
+<?php
+
+/**
+ * hyperf31_rector.php@LuxLink
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2023/12/14
+ */
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\Renaming\Rector\FuncCall\RenameFunctionRector;
+use Rector\Renaming\Rector\MethodCall\RenameMethodRector;
+use Rector\Renaming\Rector\Name\RenameClassRector;
+use Rector\Renaming\ValueObject\MethodCallRename;
+
+return static function (RectorConfig $rectorConfig): void {
+    defined('BASE_PATH') || define('BASE_PATH', dirname(__DIR__, 3));
+    $rectorConfig->importNames(true, false);
+
+    $rectorConfig->paths([
+        BASE_PATH . '/app',
+        BASE_PATH . '/config',
+        BASE_PATH . '/tests',
+    ]);
+
+    $rectorConfig
+        ->ruleWithConfiguration(RenameClassRector::class, [
+            // AsyncQueue
+            'Hyperf\AsyncQueue\Message' => 'Hyperf\AsyncQueue\JobMessage',
+
+            // DbConnection
+            'Hyperf\DbConnection\Listener\CreatingListener' => 'Hyperf\DbConnection\Listener\InitUidOnCreatingListener',
+
+            // HttpMessage
+            'Hyperf\HttpMessage\Server\ConnectionInterface' => 'Hyperf\Engine\Contract\Http\Writable',
+            'Hyperf\HttpMessage\Server\Connection\SwooleConnection' => 'Hyperf\Engine\Http\WritableConnection',
+
+            // Redis
+            'Hyperf\Redis\ScanCaller' => 'Hyperf\Redis\Traits\ScanCaller',
+
+            // Channel
+            'Hyperf\Utils\Channel\Caller' => 'Hyperf\Coroutine\Channel\Caller',
+            'Hyperf\Utils\Channel\ChannelManager' => 'Hyperf\Coroutine\Channel\Manager',
+
+            // Codec
+            'Hyperf\Utils\Codec\Base62' => 'Hyperf\Codec\Base62',
+            'Hyperf\Utils\Codec\Json' => 'Hyperf\Codec\Json',
+            'Hyperf\Utils\Codec\Xml' => 'Hyperf\Codec\Xml',
+
+            // CodeGen
+            'Hyperf\Utils\CodeGen\Package' => 'Hyperf\CodeParser\Package',
+            'Hyperf\Utils\CodeGen\PhpDocReader' => 'Hyperf\CodeParser\PhpDocReader',
+            'Hyperf\Utils\CodeGen\PhpDocReaderManager' => 'Hyperf\CodeParser\PhpDocReaderManager',
+            'Hyperf\Utils\CodeGen\PhpParser' => 'Hyperf\CodeParser\PhpParser',
+            'Hyperf\Utils\CodeGen\Project' => 'Hyperf\CodeParser\Project',
+
+            // Command
+            'Hyperf\Command\ConfirmableTrait' => 'Hyperf\Command\Concerns\Confirmable',
+            'Hyperf\Command\DisableEventDispatcher' => 'Hyperf\Command\Concerns\DisableEventDispatcher',
+            'Hyperf\Command\NullDisableEventDispatcher' => 'Hyperf\Command\Concerns\NullDisableEventDispatcher',
+
+            // Contracts
+            'Hyperf\Utils\Contracts\Arrayable' => 'Hyperf\Contract\Arrayable',
+            'Hyperf\Utils\Contracts\Jsonable' => 'Hyperf\Contract\Jsonable',
+            'Hyperf\Utils\Contracts\MessageBag' => 'Hyperf\Contract\MessageBag',
+            'Hyperf\Utils\Contracts\MessageProvider' => 'Hyperf\Contract\MessageProvider',
+            'Hyperf\Utils\Contracts\Xmlable' => 'Hyperf\Contract\Xmlable',
+
+            // Coordinator
+            'Hyperf\Utils\Coordinator\Constants' => 'Hyperf\Coordinator\Constants',
+            'Hyperf\Utils\Coordinator\Coordinator' => 'Hyperf\Coordinator\Coordinator',
+            'Hyperf\Utils\Coordinator\CoordinatorManager' => 'Hyperf\Coordinator\CoordinatorManager',
+
+            // Coroutine
+            'Hyperf\Utils\Coroutine\Concurrent' => 'Hyperf\Coroutine\Concurrent',
+            'Hyperf\Utils\Coroutine\Locker' => 'Hyperf\Coroutine\Locker',
+
+            // Exception
+            'Hyperf\Utils\Exception\ChannelClosedException' => 'Hyperf\Coroutine\Exception\ChannelClosedException',
+            'Hyperf\Utils\Exception\ExceptionThrower' => 'Hyperf\Support\Exception\ExceptionThrower',
+            'Hyperf\Utils\Exception\InvalidArgumentException' => 'Hyperf\Support\Exception\InvalidArgumentException',
+            'Hyperf\Utils\Exception\IPReadFailedException' => 'Hyperf\Support\Exception\IPReadFailedException',
+            'Hyperf\Utils\Exception\ParallelExecutionException' => 'Hyperf\Coroutine\Exception\ParallelExecutionException',
+            'Hyperf\Utils\Exception\TimeoutException' => 'Hyperf\Coroutine\Exception\TimeoutException',
+            'Hyperf\Utils\Exception\WaitTimeoutException' => 'Hyperf\Coroutine\Exception\WaitTimeoutException',
+
+            // Filesystem
+            'Hyperf\Utils\Filesystem\FileNotFoundException' => 'Hyperf\Support\Filesystem\FileNotFoundException',
+            'Hyperf\Utils\Filesystem\Filesystem' => 'Hyperf\Support\Filesystem\Filesystem',
+
+            // Packer
+            'Hyperf\Utils\Packer\JsonPacker' => 'Hyperf\Codec\Packer\JsonPacker',
+            'Hyperf\Utils\Packer\PhpSerializerPacker' => 'Hyperf\Codec\Packer\PhpSerializerPacker',
+
+            // Reflection
+            'Hyperf\Utils\Reflection\ClassInvoker' => 'Hyperf\Support\Reflection\ClassInvoker',
+
+            // Serializer
+            'Hyperf\Utils\Serializer\ExceptionNormalizer' => 'Hyperf\Serializer\ExceptionNormalizer',
+            'Hyperf\Utils\Serializer\JsonDeNormalizer' => 'Hyperf\Serializer\JsonDeNormalizer',
+            'Hyperf\Utils\Serializer\ScalarNormalizer' => 'Hyperf\Serializer\ScalarNormalizer',
+            'Hyperf\Utils\Serializer\Serializer' => 'Hyperf\Serializer\Serializer',
+            'Hyperf\Utils\Serializer\SerializerFactory' => 'Hyperf\Serializer\SerializerFactory',
+            'Hyperf\Utils\Serializer\SimpleNormalizer' => 'Hyperf\Serializer\SimpleNormalizer',
+            'Hyperf\Utils\Serializer\SymfonyNormalizer' => 'Hyperf\Serializer\SymfonyNormalizer',
+
+            // Traits
+            'Hyperf\Utils\Traits\Conditionable' => 'Hyperf\Conditionable\Conditionable',
+            'Hyperf\Utils\Traits\Container' => 'Hyperf\Support\Traits\Container',
+            'Hyperf\Utils\Traits\CoroutineProxy' => 'Hyperf\Context\Traits\CoroutineProxy',
+            'Hyperf\Utils\Traits\ForwardsCalls' => 'Hyperf\Support\Traits\ForwardsCalls',
+            'Hyperf\Utils\Traits\StaticInstance' => 'Hyperf\Support\Traits\StaticInstance',
+            'Hyperf\Utils\Traits\Tappable' => 'Hyperf\Tappable\Tappable',
+
+            // Utils
+            'Hyperf\Utils\ApplicationContext' => 'Hyperf\Context\ApplicationContext',
+            'Hyperf\Utils\Arr' => 'Hyperf\Collection\Arr',
+            'Hyperf\Utils\Backoff' => 'Hyperf\Support\Backoff',
+            'Hyperf\Utils\ChannelPool' => 'Hyperf\Coroutine\Channel\Pool',
+            'Hyperf\Utils\ClearStatCache' => 'Hyperf\Support\ClearStatCache',
+            'Hyperf\Utils\Collection' => 'Hyperf\Collection\Collection',
+            'Hyperf\Utils\Composer' => 'Hyperf\Support\Composer',
+            'Hyperf\Utils\Coroutine' => 'Hyperf\Coroutine\Coroutine',
+            'Hyperf\Utils\Fluent' => 'Hyperf\Support\Fluent',
+            'Hyperf\Utils\HigherOrderCollectionProxy' => 'Hyperf\Collection\HigherOrderCollectionProxy',
+            'Hyperf\Utils\HigherOrderTapProxy' => 'Hyperf\Tappable\HigherOrderTapProxy',
+            'Hyperf\Utils\InteractsWithTime' => 'Hyperf\Support\Traits\InteractsWithTime',
+            'Hyperf\Utils\IPReader' => 'Hyperf\Support\IPReader',
+            'Hyperf\Utils\MessageBag' => 'Hyperf\Support\MessageBag',
+            'Hyperf\Utils\MimeTypeExtensionGuesser' => 'Hyperf\Support\MimeTypeExtensionGuesser',
+            'Hyperf\Utils\Network' => 'Hyperf\Support\Network',
+            'Hyperf\Utils\Optional' => 'Hyperf\Support\Optional',
+            'Hyperf\Utils\Parallel' => 'Hyperf\Coroutine\Parallel',
+            'Hyperf\Utils\Pipeline' => 'Hyperf\Pipeline\Pipeline',
+            'Hyperf\Utils\Pluralizer' => 'Hyperf\Support\Pluralizer',
+            'Hyperf\Utils\ResourceGenerator' => 'Hyperf\Support\ResourceGenerator',
+            'Hyperf\Utils\SafeCaller' => 'Hyperf\Support\SafeCaller',
+            'Hyperf\Utils\Str' => 'Hyperf\Stringable\Str',
+            'Hyperf\Utils\Stringable' => 'Hyperf\Stringable\Stringable',
+            'Hyperf\Utils\System' => 'Hyperf\Support\System',
+            'Hyperf\Utils\Waiter' => 'Hyperf\Coroutine\Waiter',
+            'Hyperf\Utils\WaitGroup' => 'Hyperf\Coroutine\WaitGroup',
+        ]);
+
+    $rectorConfig
+        ->ruleWithConfiguration(RenameFunctionRector::class, [
+            // hyperf/config
+            'config' => 'Hyperf\Config\config',
+
+            // hyperf/collection
+            'collect' => 'Hyperf\Collection\collect',
+            'data_fill' => 'Hyperf\Collection\data_fill',
+            'data_get' => 'Hyperf\Collection\data_get',
+            'data_set' => 'Hyperf\Collection\data_set',
+            'head' => 'Hyperf\Collection\head',
+            'last' => 'Hyperf\Collection\last',
+
+            // hyperf/continue
+            'co' => 'Hyperf\Coroutine\co',
+            'defer' => 'Hyperf\Coroutine\defer',
+            'go' => 'Hyperf\Coroutine\go',
+            'parallel' => 'Hyperf\Coroutine\parallel',
+            'run' => 'Hyperf\Coroutine\run',
+            'wait' => 'Hyperf\Coroutine\wait',
+
+            // hyperf/tappable
+            'tap' => 'Hyperf\Tappable\tap',
+
+            // hyperf/translation
+            '__' => 'Hyperf\Translation\__',
+            'trans' => 'Hyperf\Translation\trans',
+            'trans_choice' => 'Hyperf\Translation\trans_choice',
+
+            // hyperf/utils
+            'value' => 'Hyperf\Support\value',
+            'env' => 'Hyperf\Support\env',
+            'retry' => 'Hyperf\Support\retry',
+            'with' => 'Hyperf\Support\with',
+            'call' => 'Hyperf\Support\call',
+            'class_basename' => 'Hyperf\Support\class_basename',
+            'trait_uses_recursive' => 'Hyperf\Support\trait_uses_recursive',
+            'class_uses_recursive' => 'Hyperf\Support\class_uses_recursive',
+            'setter' => 'Hyperf\Support\setter',
+            'getter' => 'Hyperf\Support\getter',
+            'make' => 'Hyperf\Support\make',
+            'swoole_hook_flags' => 'Hyperf\Support\swoole_hook_flags',
+            'optional' => 'Hyperf\Support\optional',
+        ]);
+
+    $rectorConfig->ruleWithConfiguration(RenameMethodRector::class, [
+        new MethodCallRename('Hyperf\Dag\Dag', 'checkCircularDependences', 'checkCircularDependencies'),
+        // new MethodCallRename('Hyperf\DbConnection\Connection', 'isTransaction', 'transactionLevel'),
+        new MethodCallRename('Hyperf\Testing\Client', 'init', 'initRequest'),
+        new MethodCallRename('Hyperf\Cache\CacheListenerCollector', 'getListner', 'getListener'),
+    ]);
+};
--- a/phpstan.dist.neon
+++ b/phpstan.dist.neon
@@ -8,6 +8,7 @@ parameters:
        - tests
    ignoreErrors:
        - '#Constant BASE_PATH not found#'
+        - '#Unknown parameter \$[a-zA-Z0-9]+ in call to callable Closure\.#'
        - '#Property [a-zA-Z0-9\\_]+::\$[a-zA-Z0-9]+ is never written, only read\.#'
        - '#Method [a-zA-Z0-9\\_]+::[a-zA-Z0-9]+\(\) is unused\.#'
        - '#Method [a-zA-Z0-9\\_]+::[a-zA-Z0-9]+\(\) has parameter \$response with no value type specified in iterable type array\.#'
--- a/phpunit.xml
+++ b/phpunit.xml
@@ -1,10 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" bootstrap="vendor/autoload.php"
-         colors="true" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd">
+<phpunit
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        bootstrap="./tests/bootstrap.php"
+        colors="true"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.4/phpunit.xsd"
+        cacheDirectory=".phpunit.cache"
+>
    <coverage/>
    <testsuites>
-        <testsuite name="Unit">
-            <directory>./tests/Unit/</directory>
+        <testsuite name="Tests">
+            <directory>./tests</directory>
        </testsuite>
    </testsuites>
+    <source>
+        <include>
+            <directory>./app</directory>
+        </include>
+    </source>
 </phpunit>
--- a/publish/common.php
+++ b/publish/common.php
@@ -62,8 +62,8 @@ return [
    // 第三方服务
    'third_party' => [
        'email' => [
-            'dsn' => 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465',
-            'mailer_sender' => 'account@luxcreo.ai',    // 发件邮箱
+            'dsn' => 'smtp://noreply@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465',
+            'mailer_sender' => 'noreply@luxcreo.ai',    // 发件邮箱
            'mailer_sender_name' => 'LuxCreo',          // 发件人名称
        ],
        'sms' => [
--- a/publish/languages/en/common_error.php
+++ b/publish/languages/en/common_error.php
@@ -163,4 +163,11 @@ return [
            'default' => 'DOC deleted',
        ],
    ],
+
+    // 业务错误
+    'business' => [
+        'default' => 'Business Error',
+        'old_version' => 'This feature is not available in the current version.',
+        'not_implemented' => 'This feature is not implemented yet.',
+    ],
 ];
--- a/publish/languages/zh_CN/common_error.php
+++ b/publish/languages/zh_CN/common_error.php
@@ -172,4 +172,11 @@ return [
            'default' => '文档已删除',
        ],
    ],
+
+    // 业务错误
+    'business' => [
+        'default' => '业务错误',
+        'old_version' => '当前版本过低，请升级到最新版本',
+        'not_implemented' => '该功能尚未实现',
+    ],
 ];
--- a/scripts/docker-env.sh
+++ b/scripts/docker-env.sh
@@ -2,9 +2,9 @@

 docker run \
    --pull always \
-    -ti --rm --name "hyperf-development-kit" \
+    -ti --rm --name "hdk-core" \
    -w "/srv/www" \
    -v "$(pwd)":/srv/www \
    -v ~/.ssh:/root/.ssh \
    -v ~/.gitconfig:/root/.gitconfig \
-   harbor.luxcreo.cn/library/hyperf:8.0-swoole /bin/ash
+   harbor.luxcreo.cn/library/hyperf:8.1-swoole /bin/ash
--- a/scripts/release.sh
+++ b/scripts/release.sh
@@ -2,4 +2,4 @@

 docker run --rm -it \
    -v $(pwd):/app -e "GIT_AUTHOR_NAME=$(git config user.name)" -e "EMAIL=$(git config user.email)" \
-    detouched/standard-version:latest -p=alpha $1
+    detouched/standard-version:latest -p=beta $1
--- a/src/ConfigProvider.php
+++ b/src/ConfigProvider.php
@@ -24,7 +24,6 @@ class ConfigProvider
    /** @phpstan-ignore-next-line  */
    public function __invoke(): array
    {
-        /** @noinspection PhpUndefinedConstantInspection */
        return [
            // 合并到  config/autoload/dependencies.php 文件
            'dependencies' => [
--- a/src/Constants/CommonErrorCode.php
+++ b/src/Constants/CommonErrorCode.php
@@ -12,6 +12,7 @@ namespace Singularity\HDK\Core\Constants;

 use Hyperf\Constants\AbstractConstants;
 use Hyperf\Constants\Annotation\Constants;
+use Hyperf\Constants\Annotation\Message;

 /**
 * Singularity\HyperfDevelopmentKit\Utils\Constants\CommonErrorCode@hyperf-development-kit
@@ -319,4 +320,15 @@ class CommonErrorCode extends AbstractConstants
     * @Message("common_error.model.document.default")
     */
    public const DOCUMENT_NOT_EXISTS = 4020201;
+
+    // 500 业务错误
+
+    #[Message('common_error.business.defaul')]
+    public const BUSINESS_ERROR = 500001;
+    // 501 版本问题
+    #[Message('common_error.business.old_version')]
+    public const BUSINESS_FLAT_OLD_VERSION = 501001;
+
+    #[Message('common_error.business.not_implemented')]
+    public const BUSINESS_NOT_IMPLEMENTED = 501002;
 }
--- a/src/Enumerations/Sp/EnvConfiguration.php
+++ b/src/Enumerations/Sp/EnvConfiguration.php
@@ -0,0 +1,16 @@
+<?php
+/**
+ * EnvConfiguration.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/7/11
+ */
+
+namespace Singularity\HDK\Core\Enumerations\Sp;
+
+interface EnvConfiguration
+{
+    public const DEVELOPMENT = 'development';
+    public const PRODUCTION = 'production';
+}
--- a/src/Enumerations/Sp/ServiceProviderConfiguration.php
+++ b/src/Enumerations/Sp/ServiceProviderConfiguration.php
@@ -0,0 +1,12 @@
+<?php
+/**
+ * ServiceProviderConfiguration.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/7/11
+ */
+
+namespace Singularity\HDK\Core\Enumerations\Sp;
+
+interface ServiceProviderConfiguration extends EnvConfiguration, SiteConfiguration {}
--- a/src/Enumerations/Sp/SiteConfiguration.php
+++ b/src/Enumerations/Sp/SiteConfiguration.php
@@ -0,0 +1,16 @@
+<?php
+/**
+ * SiteConfigration.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/7/11
+ */
+
+namespace Singularity\HDK\Core\Enumerations\Sp;
+
+interface SiteConfiguration
+{
+    public const CN = 'CN';
+    public const NA = 'NA';
+}
--- a/src/Events/EmailWillSent.php
+++ b/src/Events/EmailWillSent.php
@@ -1,4 +1,5 @@
 <?php
+
 /**
 * EmailWillSent.php@HDK-Core
 *
@@ -9,6 +10,10 @@

 namespace Singularity\HDK\Core\Events;

+use Singularity\HDK\Core\Service\EmailService;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\Email;
+
 /**
 * Singularity\HDK\Core\Events\EmailWillSent@HDK-Core
 *
@@ -22,9 +27,9 @@ class EmailWillSent
 {
    public function __construct(
        /**
-         * @var string|string[] $target
+         * @var Address|string|string[]|Address[] $target
         */
-        public string|array $target,
+        public Address|string|array $target,

        /**
         * @var non-empty-string $subject
@@ -37,14 +42,45 @@ class EmailWillSent
        public string $content,

        /**
+         * 抄送
+         *
         * @var string[] $cc
         */
        public array $cc = [],

+        /**
+         * 密送
+         *
+         * @var string[] $bcc
+         */
+        public array $bcc = [],
+
        /**
         * @var 'text'|'html' $type
         */
-        public string $type = 'text'
-    ) {
-    }
+        public string $type = 'text',
+
+        /**
+         * @var int
+         * @see Email::priority()
+         */
+        public int $priority = Email::PRIORITY_NORMAL,
+
+        /**
+         * @var EmailService|null
+         */
+        public ?EmailService $sender = null,
+
+        /**
+         * 附件路径集合、含附件路径、文件名、文件类型的数组集合
+         * @var string[]|array{'path': string, 'name': string, 'mimeType': string}[] $attachmentPaths
+         */
+        public array $attachmentPaths = [],
+
+        /**
+         * 附件内容集合、含附件内容、文件名、文件类型的数组集合
+         * @var string[]|array{'content': string, 'name': string, 'mimeType': string}[] $attachments
+         */
+        public array $attachments = [],
+    ) {}
 }
--- a/src/Exceptions/ApiMigrated.php
+++ b/src/Exceptions/ApiMigrated.php
@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * DomainOrderNotSupportException.php@LuxDesign
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/1
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Core\Exceptions;
+
+use Hyperf\HttpMessage\Exception\HttpException;
+use Singularity\HDK\Core\Constants\CommonErrorCode;
+use Teapot\StatusCode\RFC\RFC7231;
+use Throwable;
+
+final class ApiMigrated extends HttpException
+{
+    public function __construct(
+        public string $apiPath,
+        int $code = CommonErrorCode::BUSINESS_FLAT_OLD_VERSION,
+        ?string $message = null,
+        Throwable $previous = null,
+    ) {
+        parent::__construct(RFC7231::SEE_OTHER, $message, $code, $previous);
+    }
+
+    public function getNewPath(): string
+    {
+        return $this->apiPath;
+    }
+}
--- a/src/Exceptions/Handler/CommonHandler.php
+++ b/src/Exceptions/Handler/CommonHandler.php
@@ -13,6 +13,8 @@ declare(strict_types=1);
 namespace Singularity\HDK\Core\Exceptions\Handler;

 use Carbon\Carbon;
+use GuzzleHttp\Exception\ClientException;
+use GuzzleHttp\Exception\ServerException;
 use Hyperf\Codec\Json;
 use Hyperf\Database\Exception\QueryException;
 use Hyperf\Database\Model\ModelNotFoundException;
@@ -30,6 +32,8 @@ use Lmc\HttpConstants\Header;
 use Psr\Http\Message\ResponseInterface;
 use RedisException;
 use Singularity\HDK\Core\Constants\CommonErrorCode;
+use Singularity\HDK\Core\Exceptions\ApiMigrated;
+use Singularity\HDK\Core\Exceptions\NotImplementedException;
 use Singularity\HDK\Core\Exceptions\ValidateException;
 use Singularity\HDK\Core\Service\ApiStyleService;
 use Symfony\Component\Mailer\Exception\TransportException;
@@ -72,10 +76,8 @@ class CommonHandler extends ExceptionHandler
        $message_name = config('common.response.message_name');
        $is_testing = config('app_status') === true;
        $this->request?->url();
-        $is_debug = $this->request?->hasHeader('Postman-Token') || str_starts_with(
-                $this->request?->header('User-Agent', ''),
-                'apifox'
-            );
+
+        $is_debug = $is_testing;
        $error_type = $throwable::class;
        $request_time = Carbon::now()->toDateTimeString();
        $request_data = Json::encode($this->request?->getParsedBody());
@@ -95,6 +97,26 @@ class CommonHandler extends ExceptionHandler
                $data['details'] = ['sql' => $throwable->getSql(), 'error' => $throwable->getMessage()];
            }
        }
+        if ($throwable instanceof ClientException) {
+            $content = $throwable->getResponse()->getBody()->getContents();
+
+            ['errorCode' => $code, 'errorMsg' => $msg] = Json::decode($content);
+            $data = [
+                $code_name => $code,
+                $message_name => $msg,
+            ];
+            $status_code = 400;
+        }
+        if ($throwable instanceof ServerException) {
+            $content = $throwable->getResponse()->getBody()->getContents();
+
+            ['errorCode' => $code, 'errorMsg' => $msg] = Json::decode($content);
+            $data = [
+                $code_name => $code,
+                $message_name => $msg,
+            ];
+            $status_code = 500;
+        }
        // 101 请求方式错误
        if ($throwable instanceof MethodNotAllowedHttpException) {
            $message = explode(': ', $throwable->getMessage());
@@ -113,7 +135,7 @@ class CommonHandler extends ExceptionHandler
            $data = [
                $code_name => CommonErrorCode::REQUEST_PARAMS_ERROR,
                $message_name => $is_testing ? $throwable->getMessage() : CommonErrorCode::getMessage(
-                    CommonErrorCode::SERVER_ERROR
+                    CommonErrorCode::SERVER_ERROR,
                ),
            ];
            $status_code = RFC4918::UNPROCESSABLE_ENTITY;
@@ -138,7 +160,7 @@ class CommonHandler extends ExceptionHandler
                        $code,
                        [
                            'param' => $throwable->getFieldName(),
-                        ]
+                        ],
                    )
                    : $message,
            ];
@@ -156,7 +178,9 @@ class CommonHandler extends ExceptionHandler
        // 模型不存在
        if ($throwable instanceof ModelNotFoundException) {
            $code = empty($throwable->getCode()) ? CommonErrorCode::MODEL_NOT_FOUND : $throwable->getCode();
-            $message = empty($throwable->getCode()) ? CommonErrorCode::getMessage($code, ['resource' => '资源']
+            $message = empty($throwable->getCode()) ? CommonErrorCode::getMessage(
+                $code,
+                ['resource' => '资源'],
            ) : $throwable->getMessage();
            $data = [$code_name => $code, $message_name => $message];
            $status_code = RFC7231::NOT_FOUND;
@@ -171,7 +195,7 @@ class CommonHandler extends ExceptionHandler
            $data = [
                $code_name => $code,
                $message_name => CommonErrorCode::getMessage(
-                    $is_testing ? $code : CommonErrorCode::SERVER_CACHE_REDIS_ERROR
+                    $is_testing ? $code : CommonErrorCode::SERVER_CACHE_REDIS_ERROR,
                ),
            ];
        }
@@ -185,17 +209,39 @@ class CommonHandler extends ExceptionHandler
            $data = [
                $code_name => $code,
                $message_name => CommonErrorCode::getMessage(
-                    $is_testing ? $code : CommonErrorCode::SERVER_MESSAGE_EMAIL_ERROR
+                    $is_testing ? $code : CommonErrorCode::SERVER_MESSAGE_EMAIL_ERROR,
                ),
            ];
        }
+        // 500 业务错误
+        if ($throwable instanceof ApiMigrated) {
+            $code = $throwable->getCode();
+            $data = [
+                $code_name => $code,
+                $message_name => $throwable->getMessage(),
+            ];
+            $headers = [
+                'Location' => $throwable->getNewPath(),
+            ];
+        }
+        if ($throwable instanceof NotImplementedException || $throwable instanceof \Hyperf\Framework\Exception\NotImplementedException) {
+            $code = $throwable->getCode();
+            if ($code === 0) {
+                $code = CommonErrorCode::BUSINESS_NOT_IMPLEMENTED;
+            }
+            $message = $throwable->getMessage() ?? CommonErrorCode::getMessage($code);
+            $data = [
+                $code_name => $code,
+                $message_name => $message,
+            ];
+        }
        if (empty($data)) {
            // 其他情况
            $data = [
                $code_name => $is_testing ? $throwable->getCode(
                ) == 0 ? CommonErrorCode::SERVER_ERROR : $throwable->getCode() : CommonErrorCode::SERVER_ERROR,
                $message_name => $is_testing ? $throwable->getMessage() : __(
-                    CommonErrorCode::getMessage(CommonErrorCode::SERVER_ERROR)
+                    CommonErrorCode::getMessage(CommonErrorCode::SERVER_ERROR),
                ),
            ];
            // 其他错误
@@ -241,15 +287,17 @@ REQUEST_DATA:
 TRACE:
 {$throwable->getTraceAsString()}
 ===============================
-
-ERROR_LOG
+ERROR_LOG,
        );
        $data = Json::encode($data);
        if ($restful === ApiStyleService::RESTFUL) {
            $response = $response->withStatus(
-                $status_code ?? $throwable->status ?? $throwable->statusCode ?? RFC7231::INTERNAL_SERVER_ERROR
+                $status_code ?? $throwable->status ?? $throwable->statusCode ?? RFC7231::INTERNAL_SERVER_ERROR,
            );
        }
+        foreach ($headers ?? [] as $header => $value) {
+            $response->withHeader($header, $value);
+        }
        return $response->withBody(new SwooleStream($data));
    }

--- a/src/Exceptions/NotImplementedException.php
+++ b/src/Exceptions/NotImplementedException.php
@@ -0,0 +1,29 @@
+<?php
+
+/**
+ * NotImplementedException.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/2
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Core\Exceptions;
+
+use Hyperf\HttpMessage\Exception\HttpException;
+use Singularity\HDK\Core\Constants\CommonErrorCode;
+use Teapot\StatusCode\RFC\RFC7231;
+use Throwable;
+
+final class NotImplementedException extends HttpException
+{
+    public function __construct(
+        int $code = CommonErrorCode::BUSINESS_NOT_IMPLEMENTED,
+        ?string $message = null,
+        Throwable $previous = null,
+    ) {
+        $message ??= CommonErrorCode::getMessage($code);
+        parent::__construct(RFC7231::NOT_IMPLEMENTED, $message, $code, $previous);
+    }
+}
--- a/src/Http/RequestService.php
+++ b/src/Http/RequestService.php
@@ -4,17 +4,19 @@ declare(strict_types=1);

 namespace Singularity\HDK\Core\Http;

-use Ergebnis\Http\Method;
+use Ergebnis\Http\Method\Rfc\Rfc5789;
+use Ergebnis\Http\Method\Rfc\Rfc7231;
 use GuzzleHttp\Client;
 use GuzzleHttp\Exception\GuzzleException;
 use GuzzleHttp\Psr7\Request;
 use GuzzleHttp\Psr7\Utils;
 use Hyperf\Codec\Json;
-use Hyperf\Di\Annotation\Inject;
 use Hyperf\Guzzle\ClientFactory;
 use Psr\Http\Message\ResponseInterface;
 use Singularity\HDK\Core\Service\AbstractSingleton;

+use function Hyperf\Support\make;
+
 /**
 * Singularity\HDK\Core\Service\Http\RequestService@Core
 *
@@ -28,7 +30,6 @@ final class RequestService extends AbstractSingleton
 {
    // public const TIMEOUT = 20;

-    #[Inject]
    private ClientFactory $client;

    /**
@@ -42,11 +43,16 @@ final class RequestService extends AbstractSingleton
    public function __construct(array $options = [])
    {
        $this->setOptions($options);
+        /** @var ClientFactory $client */
+        $client = make(ClientFactory::class);
+        $this->client = $client;
    }

    /**
     * 定制 options
+     *
     * @param Options $options
+     *
     * @return $this
     */
    public function setOptions(array $options): self
@@ -56,10 +62,11 @@ final class RequestService extends AbstractSingleton
    }

    /**
-     * @param string $url
+     * @param string                    $url
     * @param array<string, string|int> $params
-     * @param array $data
-     * @param Options $options
+     * @param array<string, mixed>      $data
+     * @param Options                   $options
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -70,14 +77,17 @@ final class RequestService extends AbstractSingleton
        array $options = []
    ): ResponseInterface {
        $request = new Request(
-            method: Method\Rfc\Rfc7231::GET, uri: $url
+            method: Rfc7231::GET,
+            uri: $url
        );
        return $this->getClient($options)->send($request, ['query' => $params, 'json' => $data,]);
    }

    /**
     *  工厂模式初始化请求
+     *
     * @param Options $options
+     *
     * @return Client
     */
    private function getClient(array $options): Client
@@ -87,10 +97,11 @@ final class RequestService extends AbstractSingleton
    }

    /**
-     * @param string $url
+     * @param string                    $url
     * @param array<string, string|int> $params
-     * @param array<string, mixed> $data
-     * @param Options $options
+     * @param array<string, mixed>      $data
+     * @param Options                   $options
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -102,7 +113,7 @@ final class RequestService extends AbstractSingleton
    ): ResponseInterface {
        $data = Json::encode($data);
        $request = new Request(
-            method: Method\Rfc\Rfc7231::POST,
+            method: Rfc7231::POST,
            uri: $url,
            headers: ['Content-Type' => 'application/json'],
            body: Utils::streamFor($data),
@@ -111,10 +122,11 @@ final class RequestService extends AbstractSingleton
    }

    /**
-     * @param string $url
-     * @param array<string, mixed> $data
+     * @param string                    $url
+     * @param array<string, mixed>      $data
     * @param array<string, string|int> $params
-     * @param Options $options
+     * @param Options                   $options
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -126,21 +138,23 @@ final class RequestService extends AbstractSingleton
    ): ResponseInterface {
        $data = Json::encode($data);
        $request = new Request(
-            method: Method\Rfc\Rfc7231::PUT,
+            method: Rfc7231::PUT,
            uri: $url,
            headers: ['Content-Type' => 'application/json'],
            body: Utils::streamFor($data)
        );
        return $this->getClient($options)->send(
-            $request, ['query' => $params,]
+            $request,
+            ['query' => $params,]
        );
    }

    /**
-     * @param string $url
-     * @param array<string, mixed> $data
+     * @param string                    $url
+     * @param array<string, mixed>      $data
     * @param array<string, string|int> $params
-     * @param Options $options
+     * @param Options                   $options
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -152,21 +166,23 @@ final class RequestService extends AbstractSingleton
    ): ResponseInterface {
        $data = Json::encode($data);
        $request = new Request(
-            method: Method\Rfc\Rfc5789::PATCH,
+            method: Rfc5789::PATCH,
            uri: $url,
            headers: ['Content-Type' => 'application/json'],
            body: Utils::streamFor($data)
        );
        return $this->getClient($options)->send(
-            $request, ['query' => $params,]
+            $request,
+            ['query' => $params,]
        );
    }

    /**
-     * @param string $url
-     * @param array<string, mixed> $data
+     * @param string                    $url
+     * @param array<string, mixed>      $data
     * @param array<string, string|int> $params
-     * @param Options $options
+     * @param Options                   $options
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -178,13 +194,14 @@ final class RequestService extends AbstractSingleton
    ): ResponseInterface {
        $data = Json::encode($data);
        $request = new Request(
-            method: Method\Rfc\Rfc7231::DELETE,
+            method: Rfc7231::DELETE,
            uri: $url,
            headers: ['Content-Type' => 'application/json'],
            body: Utils::streamFor($data)
        );
        return $this->getClient($options)->send(
-            $request, ['query' => $params,]
+            $request,
+            ['query' => $params,]
        );
    }
 }
--- a/src/Http/RequestServiceFactory.php
+++ b/src/Http/RequestServiceFactory.php
@@ -15,8 +15,13 @@ use Singularity\HDK\Core\Service\AbstractFactory;

 final class RequestServiceFactory extends AbstractFactory
 {
+    /**
+     * @param array<string,mixed> $options
+     *
+     * @return RequestService
+     */
    public static function make(array $options = []): RequestService
    {
        return new RequestService($options);
    }
-}
+}
--- a/src/I18n/Enum/Languages.php
+++ b/src/I18n/Enum/Languages.php
@@ -0,0 +1,28 @@
+<?php
+/**
+ * Languages.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2023/9/26
+ */
+
+namespace Singularity\HDK\Core\I18n\Enum;
+
+use function Hyperf\Config\config;
+
+enum Languages: string
+{
+    case ZH_CN = 'zh_CN';
+
+    case EN = 'en';
+
+    public static function getLanguage(string $language): Languages
+    {
+        return match (mb_strtolower($language)) {
+            'en', 'en_us', 'en-us', 'en-uk', 'en_uk' => self::EN,
+            'zh', 'zh_cn', 'zh-cn' => self::ZH_CN,
+            default => self::from(config('translation.locale') ?? 'en'),
+        };
+    }
+}
--- a/src/Listener/EmailWillSentListener.php
+++ b/src/Listener/EmailWillSentListener.php
@@ -1,4 +1,5 @@
 <?php
+
 /**
 * EmailWillSentListener.php@HDK-Core
 *
@@ -55,25 +56,35 @@ class EmailWillSentListener implements ListenerInterface
    public function process(object $event): void
    {
        $stdoutLogger = $this->container->get(StdoutLoggerInterface::class);
-        $emailService = $this->container->get(EmailService::class);
+        // $emailService = $this->container->get(EmailService::class);
+        $emailService = $event->sender ?? EmailService::make();
        try {
            $event->type === 'html'
                ? $emailService->sendHtml(
                    target: $event->target,
                    subject: $event->subject,
                    html: $event->content,
-                    cc: $event->cc
+                    cc: $event->cc,
+                    bcc: $event->bcc,
+                    attachmentPaths: $event->attachmentPaths,
+                    attachments: $event->attachments,
+                    priority: $event->priority
                )
                : $emailService->sendText(
                    target: $event->target,
                    subject: $event->subject,
                    text: $event->content,
-                    cc: $event->cc
+                    cc: $event->cc,
+                    bcc: $event->bcc,
+                    attachmentPaths: $event->attachmentPaths,
+                    attachments: $event->attachments,
+                    priority: $event->priority
                );

            $stdoutLogger->info('邮件发送成功！');
            $stdoutLogger->info("To: $event->target");
            $stdoutLogger->info("Subject: $event->subject");
+            $stdoutLogger->info("Priority: $event->priority");
            $stdoutLogger->debug('Content: ');
            $stdoutLogger->debug($event->content);
        } catch (TransportExceptionInterface $e) {
--- a/src/Middleware/ClassicCoreMiddleware.php
+++ b/src/Middleware/ClassicCoreMiddleware.php
@@ -15,12 +15,13 @@ use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Di\Annotation\Inject;
+use Hyperf\HttpMessage\Server\ResponsePlusProxy;
 use Hyperf\HttpMessage\Stream\SwooleStream;
 use Hyperf\HttpServer\CoreMiddleware;
 use Lmc\HttpConstants\Header;
-use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Singularity\HDK\Core\Service\UtilsService;
+use Swow\Psr7\Message\ResponsePlusInterface;

 use function Hyperf\Config\config;

@@ -32,7 +33,7 @@ use function Hyperf\Config\config;
 * Created on 2022/4/29
 *
 * @deprecated
- * @see CommonCoreMiddleware
+ * @see    CommonCoreMiddleware
 */
 class ClassicCoreMiddleware extends CoreMiddleware
 {
@@ -43,24 +44,41 @@ class ClassicCoreMiddleware extends CoreMiddleware
     * Transfer the non-standard response content to a standard response object.
     * @template TKey of array-key
     * @template TValue
+     *
     * @param null|array<TKey, TValue>|Arrayable<TKey, TValue>|Jsonable|string $response
     */
-    protected function transferToResponse($response, ServerRequestInterface $request): ResponseInterface
-    {
+    protected function transferToResponse(
+        $response,
+        ServerRequestInterface $request
+    ): ResponsePlusInterface {
        $code_name = config('common.response.code_name');
        $message_name = config('common.response.message_name');
        $data_name = config('common.response.data_name');
        // 分页数据
        if ($response instanceof LengthAwarePaginatorInterface) {
            $paginator = $response;
-            $fact_response = $this->response()->withHeader('Per-Page', (string)$paginator->perPage())->withHeader(
-                'Total',
-                (string)$paginator->total()
-            )->withHeader('Current-Page', (string)$paginator->currentPage())->withHeader(
-                'Total-Pages',
-                (string)$paginator->hasPages()
+            $fact_response = $this->response()
+                ->withHeader(
+                    'Per-Page',
+                    (string)$paginator->perPage()
+                )
+                ->withHeader(
+                    'Total',
+                    (string)$paginator->total()
+                )
+                ->withHeader(
+                    'Current-Page',
+                    (string)$paginator->currentPage()
+                )
+                ->withHeader(
+                    'Total-Pages',
+                    (string)$paginator->hasPages()
+                );
+            $fact_response = $this->utilsService->extendLinkToHeader(
+                $fact_response,
+                $paginator->nextPageUrl(),
+                'next'
            );
-            $fact_response = $this->utilsService->extendLinkToHeader($fact_response, $paginator->nextPageUrl(), 'next');
            $fact_response = $this->utilsService->extendLinkToHeader(
                $fact_response,
                $paginator->url($paginator->lastPage()),
@@ -72,23 +90,27 @@ class ClassicCoreMiddleware extends CoreMiddleware
                $paginator->previousPageUrl(),
                'prev'
            );
-            return $fact_response->withAddedHeader(Header::CONTENT_TYPE, 'application/json')->withBody(
-                new SwooleStream(
-                    Json::encode(
-                        [
-                            $code_name => 200,
-                            $message_name => 'ok',
-                            $data_name => $response->items(),
-                            'meta' => [
-                                'currentPage' => $paginator->currentPage(),
-                                'lastPage' => $paginator->lastPage(),
-                                'perPage' => $paginator->perPage(),
-                                'total' => $paginator->total(),
-                            ],
-                        ]
+            $resp = $fact_response
+                ->withAddedHeader(Header::CONTENT_TYPE, 'application/json')
+                ->withBody(
+                    new SwooleStream(
+                        Json::encode(
+                            [
+                                $code_name => 200,
+                                $message_name => 'ok',
+                                $data_name => $response->items(),
+                                'meta' => [
+                                    'currentPage' => $paginator->currentPage(),
+                                    'lastPage' => $paginator->lastPage(),
+                                    'perPage' => $paginator->perPage(),
+                                    'total' => $paginator->total(),
+                                ],
+                            ]
+                        )
                    )
-                )
-            );
+                );
+
+            return new ResponsePlusProxy($resp);
        }
        // 普通数组
        if (is_array($response) || $response instanceof Arrayable) {
--- a/src/Middleware/CommonCoreMiddleware.php
+++ b/src/Middleware/CommonCoreMiddleware.php
@@ -15,13 +15,16 @@ use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Di\Annotation\Inject;
+use Hyperf\HttpMessage\Server\ResponsePlusProxy;
 use Hyperf\HttpMessage\Stream\SwooleStream;
 use Hyperf\HttpServer\CoreMiddleware;
+use Hyperf\Resource\Json\JsonResource;
 use Lmc\HttpConstants\Header;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Singularity\HDK\Core\Service\ApiStyleService;
 use Singularity\HDK\Core\Service\UtilsService;
+use Swow\Psr7\Message\ResponsePlusInterface;

 use function Hyperf\Config\config;

@@ -43,24 +46,31 @@ class CommonCoreMiddleware extends CoreMiddleware
    /**
     * @inheritDoc
     */
-    protected function transferToResponse($response, ServerRequestInterface $request): ResponseInterface
-    {
+    protected function transferToResponse(
+        $response,
+        ServerRequestInterface $request,
+    ): ResponsePlusInterface {
        $style = $this->apiStyleService->get();

-        if ($style === ApiStyleService::RESTFUL) {
-            return $this->transferToRestfulResponse($response, $request);
-        } else {
-            return $this->transferToClassicResponse($response, $request);
+        if (!($response instanceof ResponseInterface) || $response instanceof JsonResource) {
+            $response = $style === ApiStyleService::RESTFUL
+                ? $this->transferToRestfulResponse($response, $request)
+                : $this->transferToClassicResponse($response, $request);
        }
+
+        return new ResponsePlusProxy($response);
    }

    /**
-     * @param array|string|Arrayable|Jsonable|null $response
-     * @param ServerRequestInterface $request
+     * @param null|array|Arrayable|Jsonable|ResponseInterface|string $response
+     * @param ServerRequestInterface                                 $request
+     *
     * @return ResponseInterface
     */
-    protected function transferToRestfulResponse(Arrayable|Jsonable|array|string|null $response, ServerRequestInterface $request): ResponseInterface
-    {
+    protected function transferToRestfulResponse(
+        null|array|Arrayable|Jsonable|ResponseInterface|string $response,
+        ServerRequestInterface $request,
+    ): ResponseInterface {
        // 分页数据
        if ($response instanceof LengthAwarePaginatorInterface) {
            $fact_response = $this->response()
@@ -87,13 +97,14 @@ class CommonCoreMiddleware extends CoreMiddleware
    }

    /**
-     * @param array|string|Arrayable|Jsonable|null $response
-     * @param ServerRequestInterface $request
+     * @param null|array|Arrayable|Jsonable|ResponseInterface|string $response
+     * @param ServerRequestInterface                                 $request
+     *
     * @return ResponseInterface
     */
    protected function transferToClassicResponse(
-        Arrayable|Jsonable|array|string|null $response,
-        ServerRequestInterface $request
+        null|array|Arrayable|Jsonable|ResponseInterface|string $response,
+        ServerRequestInterface $request,
    ): ResponseInterface {
        $code_name = config('common.response.code_name');
        $message_name = config('common.response.message_name');
@@ -152,6 +163,9 @@ class CommonCoreMiddleware extends CoreMiddleware
                new SwooleStream(Json::encode($response))
            );
        }
+        if ($response instanceof ResponseInterface) {
+            return $response;
+        }
        // 其他默认按字符串处理
        return $this->response()->withAddedHeader(Header::CONTENT_TYPE, 'text/plain')->withBody(
            new SwooleStream((string)$response)
--- a/src/Middleware/InternationalizationMiddleware.php
+++ b/src/Middleware/InternationalizationMiddleware.php
@@ -12,10 +12,9 @@ use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Psr\Http\Server\MiddlewareInterface;
 use Psr\Http\Server\RequestHandlerInterface;
+use Singularity\HDK\Core\I18n\Enum\Languages;
 use Symfony\Component\HttpFoundation\Request;

-use function Hyperf\Config\config;
-
 /**
 * Singularity\HDK\Utils\Middleware\InternationalizationMiddleware@HDK
 *
@@ -41,12 +40,8 @@ class InternationalizationMiddleware implements MiddlewareInterface

        $language = $req->getPreferredLanguage();
        if (!empty($language)) {
-            $language = match (strtolower($language)) {
-                'en', 'en_us', 'en-us', 'en-uk', 'en_uk' => 'en',
-                'zh', 'zh_cn', 'zh-cn' => 'zh_CN',
-                default => config('translation.locale'),
-            };
-            $this->translator->setLocale($language);
+            $language = Languages::getLanguage($language);
+            $this->translator->setLocale($language->value);
        }
        $response = Context::get(ResponseInterface::class);
        $response = $response->withAddedHeader(
--- a/src/Middleware/RestfulCoreMiddleware.php
+++ b/src/Middleware/RestfulCoreMiddleware.php
@@ -13,10 +13,11 @@ use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Di\Annotation\Inject;
+use Hyperf\HttpMessage\Server\ResponsePlusProxy;
 use Hyperf\HttpServer\CoreMiddleware;
-use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Singularity\HDK\Core\Service\UtilsService;
+use Swow\Psr7\Message\ResponsePlusInterface;

 /**
 * Singularity\HDK\Core\Middleware\RestfulCoreMiddleware@HDK-Core
@@ -26,7 +27,7 @@ use Singularity\HDK\Core\Service\UtilsService;
 * Created on 2023/1/14
 *
 * @deprecated
- * @see CommonCoreMiddleware
+ * @see    CommonCoreMiddleware
 */
 class RestfulCoreMiddleware extends CoreMiddleware
 {
@@ -37,11 +38,14 @@ class RestfulCoreMiddleware extends CoreMiddleware
     * @template TKey of array-key
     * @template TValue
     * @param null|array<TKey, TValue>|Arrayable<TKey, TValue>|Jsonable|string $response
-     * @param ServerRequestInterface $request
-     * @return ResponseInterface
+     * @param ServerRequestInterface                                           $request
+     *
+     * @return ResponsePlusInterface
     */
-    protected function transferToResponse($response, ServerRequestInterface $request): ResponseInterface
-    {
+    protected function transferToResponse(
+        $response,
+        ServerRequestInterface $request
+    ): ResponsePlusInterface {
        // 分页数据
        if ($response instanceof LengthAwarePaginatorInterface) {
            $fact_response = $this->response()
@@ -56,11 +60,12 @@ class RestfulCoreMiddleware extends CoreMiddleware
                'last'
            );
            $fact_response = $this->utilsService->extendLinkToHeader($fact_response, $response->url(1), 'first');
-            return $this->utilsService->extendLinkToHeader(
+            $resp = $this->utilsService->extendLinkToHeader(
                $fact_response,
                $response->previousPageUrl(),
                'prev'
            );
+            return new ResponsePlusProxy($resp);
        }

        return parent::transferToResponse($response, $request);
--- a/src/Middleware/SessionMiddleware.php
+++ b/src/Middleware/SessionMiddleware.php
@@ -86,7 +86,7 @@ class SessionMiddleware implements MiddlewareInterface
    /**
     * Store the current URL for the request if necessary.
     */
-    private function storeCurrentUrl(RequestInterface $request, SessionInterface $session)
+    private function storeCurrentUrl(RequestInterface $request, SessionInterface $session): void
    {
        if ($request->getMethod() === 'GET') {
            $session->setPreviousUrl($this->fullUrl($request));
@@ -155,7 +155,7 @@ class SessionMiddleware implements MiddlewareInterface
        return rtrim(preg_replace('/\?.*/', '', (string)$request->getUri()));
    }

-    private function auth(SessionInterface $session)
+    private function auth(SessionInterface $session): bool
    {
        return $session->has('userInfo');
    }
--- a/src/Middleware/SpParseMiddleware.php
+++ b/src/Middleware/SpParseMiddleware.php
@@ -0,0 +1,32 @@
+<?php
+
+/**
+ * SpParseMiddleware.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/7/9
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Core\Middleware;
+
+use Hyperf\Context\Context;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\MiddlewareInterface;
+use Psr\Http\Server\RequestHandlerInterface;
+
+final class SpParseMiddleware implements MiddlewareInterface
+{
+
+    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
+    {
+        $sp = $request->getHeaderLine('X-SP-ID');
+        if (!empty($sp)) {
+            Context::set('sp', $sp);
+        }
+
+        return $handler->handle($request);
+    }
+}
--- a/src/Service/AbstractFactory.php
+++ b/src/Service/AbstractFactory.php
@@ -13,6 +13,7 @@ namespace Singularity\HDK\Core\Service;

 use Dont\DontCall;
 use Dont\DontInstantiate;
+use Singularity\HDK\Core\Http\RequestService;

 /**
 * Singularity\HDK\Core\Service\AbstractFactory@Core
@@ -26,5 +27,5 @@ abstract class AbstractFactory
    use DontInstantiate;
    use DontCall;

-    abstract static function make();
-}
+    abstract public static function make(): RequestService;
+}
--- a/src/Service/AbstractSingleton.php
+++ b/src/Service/AbstractSingleton.php
@@ -23,4 +23,4 @@ abstract class AbstractSingleton
 {
    use DontCallStatic;
    use DontClone;
-}
+}
--- a/src/Service/EmailService.php
+++ b/src/Service/EmailService.php
@@ -45,6 +45,18 @@ class EmailService
        );
    }

+    public static function make(
+        ?string $dsn = null,
+        ?string $mailSenderName = null,
+        ?string $mailSender = null,
+    ): static {
+        return new static(
+            dsn: $dsn,
+            mailSenderName: $mailSenderName,
+            mailSender: $mailSender,
+        );
+    }
+
    /**
     * 发送邮件
     *
@@ -67,27 +79,51 @@ class EmailService
    }

    /**
-     * @param string|array<string> $target
-     * @param string $subject
-     * @param string $text
+     * @param Address|string|array<string|Address> $target
+     * @param string        $subject
+     * @param string        $text
     * @param array<string> $cc
+     * @param array         $bcc
+     * @param int           $priority
     *
     * @return bool
     * @throws TransportExceptionInterface
     */
    public function sendText(
-        string|array $target,
+        Address|string|array $target,
        string $subject,
        string $text,
-        array $cc = []
+        array $cc = [],
+        array $bcc = [],
+        array $attachmentPaths = [],
+        array $attachments = [],
+        int $priority = Email::PRIORITY_NORMAL
    ): bool {
        $email = (new Email())
            ->from(Address::create($this->from))
            ->to(...(is_array($target) ? $target : [$target]))
            ->cc(...$cc)
+            ->bcc(...$bcc)
+            ->priority($priority)
            ->subject($subject)
            ->text($text);

+        foreach ($attachmentPaths as $attachmentPath) {
+            if (is_string($attachmentPath)) {
+                $email = $email->attachFromPath($attachmentPath);
+            } else {
+                $email = $email->attachFromPath($attachmentPath['path'], $attachmentPath['name'] ?? null, $attachmentPath['mimeType'] ?? null);
+            }
+        }
+
+        foreach ($attachments as $attachment) {
+            if (is_string($attachment)) {
+                $email = $email->attach($attachment);
+            } else {
+                $email = $email->attach($attachment['content'], $attachment['name'] ?? null, $attachment['mimeType'] ?? null);
+            }
+        }
+
        $this->mailer->send($email);

        return true;
@@ -96,27 +132,51 @@ class EmailService
    /**
     * 以 HTML 格式发送邮件
     *
-     * @param string|array<string> $target
-     * @param string $subject
-     * @param string $html
+     * @param Address|string|array<string|Address> $target
+     * @param string        $subject
+     * @param string        $html
     * @param array<string> $cc
+     * @param array         $bcc
+     * @param int           $priority
     *
     * @return bool
     * @throws TransportExceptionInterface
     */
    public function sendHtml(
-        string|array $target,
+        Address|string|array $target,
        string $subject,
        string $html,
-        array $cc = []
+        array $cc = [],
+        array $bcc = [],
+        array $attachmentPaths = [],
+        array $attachments = [],
+        int $priority = Email::PRIORITY_NORMAL
    ): bool {
        $email = (new Email())
            ->from(Address::create($this->from))
            ->to(...(is_array($target) ? $target : [$target]))
            ->cc(...$cc)
+            ->bcc(...$bcc)
+            ->priority($priority)
            ->subject($subject)
            ->html($html);

+        foreach ($attachmentPaths as $attachmentPath) {
+            if (is_string($attachmentPath)) {
+                $email = $email->attachFromPath($attachmentPath);
+            } else {
+                $email = $email->attachFromPath($attachmentPath['path'], $attachmentPath['name'] ?? null, $attachmentPath['mimeType'] ?? null);
+            }
+        }
+
+        foreach ($attachments as $attachment) {
+            if (is_string($attachment)) {
+                $email = $email->attach($attachment);
+            } else {
+                $email = $email->attach($attachment['content'], $attachment['name'] ?? null, $attachment['mimeType'] ?? null);
+            }
+        }
+
        $this->mailer->send($email);

        return true;
--- a/src/Service/HttpRequestService.php
+++ b/src/Service/HttpRequestService.php
@@ -4,7 +4,7 @@ declare(strict_types=1);

 namespace Singularity\HDK\Core\Service;

-use Ergebnis\Http\Method;
+use Ergebnis\Http\Method\Rfc\Rfc7231;
 use GuzzleHttp\Client;
 use GuzzleHttp\Exception\GuzzleException;
 use GuzzleHttp\Psr7\Request;
@@ -16,6 +16,7 @@ use Psr\Http\Message\ResponseInterface;

 /**
 * 发起 Http 请求的类
+ *
 * @deprecated since version 1.0-alpha.3, to be removed in 1.0
 */
 class HttpRequestService
@@ -31,15 +32,16 @@ class HttpRequestService
    private array $options = [];

    /**
-     * @param string $url
+     * @param string                    $url
     * @param array<string, string|int> $params
-     * @param array $data
+     * @param array<string, mixed>      $data
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
    public function requestGet(string $url, array $params = [], array $data = []): ResponseInterface
    {
-        $request = new Request(Method\Rfc\Rfc7231::GET, $url);
+        $request = new Request(Rfc7231::GET, $url);
        return $this->getClient()->send($request, [
            'query' => $params,
            'json' => $data,
@@ -52,9 +54,10 @@ class HttpRequestService
    }

    /**
-     * @param string $url
-     * @param array<string, mixed> $data
+     * @param string                    $url
+     * @param array<string, mixed>      $data
     * @param array<string, string|int> $params
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -74,9 +77,10 @@ class HttpRequestService


    /**
-     * @param string $url
-     * @param array<string, mixed> $data
+     * @param string                    $url
+     * @param array<string, mixed>      $data
     * @param array<string, string|int> $params
+     *
     * @return ResponseInterface
     * @throws GuzzleException
     */
@@ -91,7 +95,9 @@ class HttpRequestService

    /**
     * 定制 options
+     *
     * @param array<string, mixed> $options
+     *
     * @return $this
     */
    public function setOptions(array $options): HttpRequestService
--- a/src/Traits/RestfulList.php
+++ b/src/Traits/RestfulList.php
@@ -10,10 +10,11 @@
 namespace Singularity\HDK\Core\Traits;

 use Closure;
-use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Database\Model\Builder;
+use Hyperf\Database\Model\Relations\Relation;
 use Hyperf\Di\Annotation\Inject;
 use Hyperf\HttpServer\Contract\RequestInterface;
+use Hyperf\Paginator\AbstractPaginator;
 use Hyperf\Stringable\Str;
 use Singularity\HDK\Core\Service\ExtendService;

@@ -24,14 +25,16 @@ trait RestfulList
    #[Inject]
    protected RequestInterface $request;

-    protected function restSelect(Closure $callback, ?Closure $filter = null)
+    protected function restSelect(Closure $callback, ?Closure $filter = null): mixed
    {
-        $options = [];
-        $result = $this->parseParameters(function ($query, $parsedOptions) use ($callback, &$options) {
-            $options = $parsedOptions;
-            $callback($query, $parsedOptions);
-        });
-        return $this->responseFormatter($options, $result, $filter);
+        $parsed_options = [];
+        $result = $this->parseParameters(
+            callback: function ($query, $options) use ($callback, &$parsed_options) {
+                $parsed_options = $options;
+                return $callback($query, $options);
+            }
+        );
+        return $this->responseFormatter($parsed_options, $result, $filter);
    }

    protected function parseParameters(Closure $callback): mixed
@@ -49,11 +52,18 @@ trait RestfulList
        return $callback(query: $query, options: $options);
    }

+    /**
+     * @param array<string, mixed> $options
+     * @param Builder|Relation     $builder
+     * @param Closure|null         $filter
+     *
+     * @return mixed
+     */
    protected function responseFormatter(
        array $options,
-        Builder $builder,
+        Builder|Relation $builder,
        ?Closure $filter = null
-    ) {
+    ): mixed {
        $perPage = $options['size'] ?? null;
        $order = $options['order'] ?? 'created_at';
        $sort = $options['sort'] ?? 'desc';
@@ -67,7 +77,7 @@ trait RestfulList
            return $result;
        }

-        if ($result instanceof LengthAwarePaginatorInterface) {
+        if ($result instanceof AbstractPaginator) {
            $collection = $result->getCollection();
            $collection = $filter($collection);

@@ -75,4 +85,4 @@ trait RestfulList
        }
        return $filter($result);
    }
-}
+}
--- a/tests/Unit/EmailServiceTest.php
+++ b/tests/Unit/EmailServiceTest.php
@@ -1,4 +1,5 @@
 <?php
+
 /**
 * EmailServiceTest.php@HDK-Core
 *
@@ -9,15 +10,19 @@

 namespace Singularity\HDK\Test\Core\Service;

+use PharIo\Manifest\Email;
 use Singularity\HDK\Core\Service\EmailService;
 use Symfony\Component\Mailer\Exception\TransportException;

-$dsn = 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465';
-$mail_sender_name = 'LuxCreo';
-$mail_sender = 'account@luxcreo.ai';
-$email = new EmailService($dsn, $mail_sender_name, $mail_sender);
+use function Hyperf\Support\make;

-it('assertions that send HTML is available', function () use ($email) {
+
+it('assertions that send HTML is available', function () {
+    $dsn = 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465';
+    $mail_sender_name = 'LuxCreo';
+    $mail_sender = 'account@luxcreo.ai';
+    // $email = new EmailService($dsn, $mail_sender_name, $mail_sender);
+    $email = make(EmailService::class, ['dsn' => $dsn, 'mailSenderName' => $mail_sender_name, 'mailSender' => $mail_sender]);
    $result = $email->sendHtml(
        'dongyun.li@luxcreo.ai',
        'HDK Unit Test HTML',
@@ -28,7 +33,13 @@ HTML
    expect($result)->toBeTrue();
 });

-it('assertions that send Text is available', function () use ($email) {
+it('assertions that send Text is available', function () {
+    $dsn = 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465';
+    $mail_sender_name = 'LuxCreo';
+    $mail_sender = 'account@luxcreo.ai';
+    // $email = new EmailService($dsn, $mail_sender_name, $mail_sender);
+    $email = make(EmailService::class, ['dsn' => $dsn, 'mailSenderName' => $mail_sender_name, 'mailSender' => $mail_sender]);
+
    $result = $email->sendText(
        'dongyun.li@luxcreo.ai',
        'HDK Unit Test Text',
@@ -39,7 +50,13 @@ Text
    expect($result)->toBeTrue();
 });

-it('assertions Error Receiver can be catch', function () use ($email) {
+it('assertions Error Receiver can be catch', function () {
+    $dsn = 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465';
+    $mail_sender_name = 'LuxCreo';
+    $mail_sender = 'account@luxcreo.ai';
+    // $email = new EmailService($dsn, $mail_sender_name, $mail_sender);
+    $email = make(EmailService::class, ['dsn' => $dsn, 'mailSenderName' => $mail_sender_name, 'mailSender' => $mail_sender]);
+
    try {
        $email->sendHtml(
            'unknown@luxcreo.ai',
@@ -63,3 +80,29 @@ Text
        expect($t->getCode())->toBe(554);
    }
 });
+
+it('should can contain attachment', function () {
+    $dsn = 'smtp://account@luxcreo.ai:Qfsd8866@smtp.qiye.aliyun.com:465';
+    $mail_sender_name = 'LuxCreo';
+    $mail_sender = 'account@luxcreo.ai';
+    // $email = new EmailService($dsn, $mail_sender_name, $mail_sender);
+    $email = make(EmailService::class, ['dsn' => $dsn, 'mailSenderName' => $mail_sender_name, 'mailSender' => $mail_sender]);
+
+    $email->sendHtml(
+        'dongyun.li@luxcreo.ai',
+        'HDK Unit Test HTML',
+        <<<HTML
+<h1>Hello, World!</h1>
+HTML,
+        [],
+        [],
+        [
+            [
+                'path' => __DIR__ . '/../../README.md',
+                'name' => 'README.md',
+                'mimeType' => 'text/markdown',
+            ],
+        ],
+        []
+    );
+})->only();
--- a/tests/Unit/ExtendServiceTest.php
+++ b/tests/Unit/ExtendServiceTest.php
@@ -13,6 +13,8 @@ use Hyperf\Context\Context;
 use Singularity\HDK\Core\Service\ExtendService;
 use Singularity\HDK\Core\Service\UtilsService;

+use function Hyperf\Support\make;
+
 /** @var ExtendService $service */
 $service = make(ExtendService::class, ['utils' => new UtilsService()]);
 it('asserts no parameters can be parsed.', function (ExtendService $service, $params) {
--- a/tests/Unit/RequestServiceTest.php
+++ b/tests/Unit/RequestServiceTest.php
@@ -0,0 +1,41 @@
+<?php
+
+/**
+ * RequestServiceTest.php@Core
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2023/9/20
+ */
+
+namespace Singularity\HDK\Test\Core\Unit;
+
+use Singularity\HDK\Core\Http\RequestService;
+use Singularity\HDK\Core\Http\RequestServiceFactory;
+use Teapot\StatusCode\RFC\RFC7231;
+
+use function Hyperf\Support\make;
+
+class RequestServiceTest
+{
+    private RequestService $service;
+
+    public function __construct()
+    {
+        $this->service = RequestServiceFactory::make();
+    }
+
+    public function getInstance(): RequestService
+    {
+        return $this->service;
+    }
+}
+
+test('Http 请求服务可以正常使用', function () {
+    /** @var RequestServiceTest $class */
+    $class = make(RequestServiceTest::class);
+    $response = $class->getInstance()->setOptions([
+        'allow_redirects' => false,
+    ])->requestGet('https://www.baidu.com');
+    expect($response->getStatusCode())->toBe(RFC7231::OK);
+});
--- a/tests/Unit/UtilsServiceTest.php
+++ b/tests/Unit/UtilsServiceTest.php
@@ -7,14 +7,172 @@
 * Created on 2023/1/12
 */

+use Hyperf\Codec\Json;
 use Singularity\HDK\Core\Service\UtilsService;

-$utils = new UtilsService();
+use function Hyperf\Support\make;

+$utils = new UtilsService();
+dataset('categories', [
+    [
+        'source' => <<<JSON
+[
+  {
+    "id": 200002538,
+    "name": "空心菜类",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,空心菜类"
+  },
+  {
+    "id": 200002537,
+    "name": "香菜类",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,葱姜蒜椒/调味菜,香菜类"
+  },
+  {
+    "id": 200002536,
+    "name": "紫苏/苏子叶",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,紫苏/苏子叶"
+  },
+  {
+    "id": 200002543,
+    "name": "乌塌菜/塌菜/乌菜",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,乌塌菜/塌菜/乌菜"
+  },
+  {
+    "id": 200002542,
+    "name": "菜心/菜苔类",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,菜心/菜苔类"
+  },
+  {
+    "id": 200002540,
+    "name": "马兰头/马兰/红梗菜",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,马兰头/马兰/红梗菜"
+  },
+  {
+    "id": 200002531,
+    "name": "苋菜类",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,苋菜类"
+  },
+  {
+    "id": 200002528,
+    "name": "其他叶菜类",
+    "level": 3,
+    "namePath": "蔬菜/豆制品,叶菜类,其他叶菜类"
+  }
+]
+JSON,
+        'expected' => <<<JSON
+[
+  {
+    "id": "e485b0bb87",
+    "id_path": ",e485b0bb87,",
+    "level": 1,
+    "name": "蔬菜/豆制品",
+    "name_path": "蔬菜/豆制品",
+    "parent_id": 0,
+    "children": [
+      {
+        "id": "bf1753faa2",
+        "id_path": ",e485b0bb87,bf1753faa2,",
+        "level": 2,
+        "name": "叶菜类",
+        "name_path": "蔬菜/豆制品,叶菜类",
+        "parent_id": "e485b0bb87",
+        "children": [
+          {
+            "id": "b8c8b14630",
+            "id_path": ",e485b0bb87,bf1753faa2,b8c8b14630,",
+            "level": 3,
+            "name": "空心菜类",
+            "name_path": "蔬菜/豆制品,叶菜类,空心菜类",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "78c941ae91",
+            "id_path": ",e485b0bb87,bf1753faa2,78c941ae91,",
+            "level": 3,
+            "name": "紫苏/苏子叶",
+            "name_path": "蔬菜/豆制品,叶菜类,紫苏/苏子叶",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "eccbf542f9",
+            "id_path": ",e485b0bb87,bf1753faa2,eccbf542f9,",
+            "level": 3,
+            "name": "乌塌菜/塌菜/乌菜",
+            "name_path": "蔬菜/豆制品,叶菜类,乌塌菜/塌菜/乌菜",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "3621a8c3dc",
+            "id_path": ",e485b0bb87,bf1753faa2,3621a8c3dc,",
+            "level": 3,
+            "name": "菜心/菜苔类",
+            "name_path": "蔬菜/豆制品,叶菜类,菜心/菜苔类",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "aad334b5a0",
+            "id_path": ",e485b0bb87,bf1753faa2,aad334b5a0,",
+            "level": 3,
+            "name": "马兰头/马兰/红梗菜",
+            "name_path": "蔬菜/豆制品,叶菜类,马兰头/马兰/红梗菜",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "70d40b44f2",
+            "id_path": ",e485b0bb87,bf1753faa2,70d40b44f2,",
+            "level": 3,
+            "name": "苋菜类",
+            "name_path": "蔬菜/豆制品,叶菜类,苋菜类",
+            "parent_id": "bf1753faa2"
+          },
+          {
+            "id": "45623d0c88",
+            "id_path": ",e485b0bb87,bf1753faa2,45623d0c88,",
+            "level": 3,
+            "name": "其他叶菜类",
+            "name_path": "蔬菜/豆制品,叶菜类,其他叶菜类",
+            "parent_id": "bf1753faa2"
+          }
+        ]
+      },
+      {
+        "id": "188ae68906",
+        "id_path": ",e485b0bb87,188ae68906,",
+        "level": 2,
+        "name": "葱姜蒜椒/调味菜",
+        "name_path": "蔬菜/豆制品,葱姜蒜椒/调味菜",
+        "parent_id": "e485b0bb87",
+        "children": [
+          {
+            "id": "4c64873413",
+            "id_path": ",e485b0bb87,188ae68906,4c64873413,",
+            "level": 3,
+            "name": "香菜类",
+            "name_path": "蔬菜/豆制品,葱姜蒜椒/调味菜,香菜类",
+            "parent_id": "188ae68906"
+          }
+        ]
+      }
+    ]
+  }
+]
+JSON
+    ],
+]);
 $length_data = [];
 for ($i = 0; $i < 5; $i++) {
    try {
-        $length_data[] = random_int(1, 9);
+        $length_data[(string)$i] = [
+            'length' => random_int(1, 9)
+        ];
    } catch (Exception $e) {
        continue;
    }
@@ -58,7 +216,7 @@ test('断言可以根据参数构建 URL', function (string $url, array $params,
        ['c' => 'd'],
        true,
        'http://username:password@127.0.0.1/git/resp?id=1#/page?a=b&c=d',
-    ]
+    ],
 ])->group('pure', 'utils');

 test('断言可以判断是否是数组中的元素', function (
@@ -79,3 +237,42 @@ test('断言可以判断是否是数组中的元素', function (
    ['1', ['1', 2, 3], true, false],
    [[1, 2, 3], ['1', 2, 3], false, true],
 ])->group('pure', 'utils');
+
+test('无极分类', function (string $source, string $expected) {
+    $tree = [];
+
+    foreach (Json::decode($source) as $item) {
+        $path_array = explode(',', $item['namePath']);
+        $parent_id = 0;
+
+        $name_path = [];
+        $id_path = ',';
+
+        foreach ($path_array as $i => $name) {
+            $name_path[] = $name;
+            $level = $i + 1;
+            $id = substr(md5($level . $name), 0, 10);
+            $id_path .= $id . ',';
+            $new_item = [
+                'id' => $id,
+                'id_path' => $id_path,
+                'level' => $level,
+                'name' => $name,
+                'name_path' => join(',', $name_path + [$name]),
+                'parent_id' => $parent_id,
+            ];
+
+            $tree[$id] = $new_item;
+            $parent_id = $id;
+        }
+    }
+
+    /** @var UtilsService $utils */
+    $utils = make(UtilsService::class);
+    usort($tree, fn ($prevent, $current) => $current['level'] <=> $prevent['level']);
+
+    $tree = array_column($tree, null, 'id');
+    $utils->unlimitedSubCategoriesQuicklyWithLevel(list: $tree);
+
+    expect($tree)->toBe(Json::decode($expected));
+})->with('categories');
--- a/tests/bootstrap.php
+++ b/tests/bootstrap.php
@@ -1,16 +1,31 @@
 <?php

 declare(strict_types=1);
-/**
- * This file is part of Hyperf.
- *
- * @link     https://www.hyperf.io
- * @document https://hyperf.wiki
- * @contact  group@hyperf.io
- * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
- */
+
+use Hyperf\Context\ApplicationContext;
+use Hyperf\Di\ClassLoader;
+use Hyperf\Di\Container;
+use Hyperf\Di\Definition\DefinitionSource;
+use Psr\Container\ContainerInterface;
+use Swoole\Runtime;
+
 ini_set('display_errors', 'on');
 ini_set('display_startup_errors', 'on');

 error_reporting(E_ALL);
 date_default_timezone_set('Asia/Shanghai');
+
+
+!defined('BASE_PATH') && define('BASE_PATH', dirname(__DIR__, 1));
+!defined('SWOOLE_HOOK_FLAGS') && define('SWOOLE_HOOK_FLAGS', SWOOLE_HOOK_ALL);
+
+Runtime::enableCoroutine(true);
+
+require BASE_PATH . '/vendor/autoload.php';
+ClassLoader::init();
+
+$container = new Container(new DefinitionSource([]));
+if (!$container instanceof ContainerInterface) {
+    throw new RuntimeException('The dependency injection container is invalid.');
+}
+$container = ApplicationContext::setContainer($container);
Author	SHA1	Message	Date
李东云	68451820b0	chore(release): 1.0.0-beta.12	2025-08-08 14:33:07 +08:00
李东云	55da02080e	feat(exception): 新增业务错误处理和 API 迁移支持 - 新增业务错误类型和相关错误码 - 实现 API 迁移异常处理 - 增加未实现功能异常处理 - 更新错误处理逻辑，支持新错误类型 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2025-08-02 18:35:31 +08:00
李东云	0f7b9464c9	chore(release): 1.0.0-beta.11	2025-07-11 16:36:06 +08:00
李东云	bf40c6e681	feat: 新增SP相关配置的枚举 - 添加 EnvConfiguration 接口，定义开发和生产环境常量 - 添加 ServiceProviderConfiguration 接口，继承环境和站点配置接口 - 添加 SiteConfiguration接口，定义中国和北美站点常量 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2025-07-11 16:34:10 +08:00
李东云	9a8575b382	chore(release): 1.0.0-beta.10	2025-07-09 14:36:33 +08:00
李东云	c6ab9db698	feat(core): 添加 X-SP-ID 解析中间件 - 新增 SpParseMiddleware 类，用于解析请求中的 X-SP-ID 头- 将解析后的 SP ID存入 Hyperf 上下文中，供后续使用 - 此中间件适用于需要根据 SP ID 进行权限控制或日志记录的场景 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2025-07-09 14:36:11 +08:00
李东云	2e0e4feaa5	chore(release): 1.0.0-beta.9	2025-07-07 13:28:26 +08:00
李东云	c8b454540d	build(deps): 更新依赖并添加 PHPSpec 支持 - 添加 Symfony polyfill-php84依赖 - 更新 rector/rector 至最新版本 - 添加 PHPSpec 相关配置和依赖 - 更新 composer.json 配置 - 调整项目结构，添加 spec 目录作为测试源 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2025-07-07 13:27:25 +08:00
李东云	bb11a1d8f4	chore(release): 1.0.0-beta.8	2025-03-04 02:34:32 +00:00
李东云	b4dcd01e8d	build(composer): Update Dependencies	2025-03-04 02:33:58 +00:00
李东云	3b3502f763	feat(email): 添加邮件附件功能 - 在 EmailWillSent 事件中添加 attachmentPaths 和 attachments 属性 - 在 EmailService 中添加处理附件的逻辑 - 更新 EmailWillSentListener 以支持附件发送	2025-03-04 02:33:24 +00:00
李东云	768f2d79c0	chore(release): 1.0.0-beta.7	2025-03-03 09:59:24 +00:00
李东云	225bdedd23	feat(EmailService): 添加邮件附件功能并更新单元测试 - 在 EmailService 类的 sendHtml 方法中添加了附件处理逻辑 - 更新了 EmailServiceTest 单元测试，增加了附件发送的测试用例 - 优化了测试用例的结构，提高了可读性和可维护性	2025-03-03 09:57:04 +00:00
李东云	aaa4382ff2	build(devcontainer): 添加 Hyperf 开发套件核心配置文件 - 新增 devcontainer.json 配置文件，用于 Hyperf 框架的开发环境 - 配置了基础设置、挂载点、容器生命周期管理等 - 集成了多个 Visual Studio Code 扩展，提升开发效率	2025-03-03 09:32:35 +00:00
李东云	9a296c56e9	chore(release): 1.0.0-beta.6	2024-12-06 02:10:13 +00:00
李东云	2dace65933	fix(exceptions): 处理 HTTP 客户端和服务器异常 - 在 CommonHandler 中添加了对 GuzzleHttp 客户端和服务器异常的处理 - 解析异常响应内容，提取错误代码和消息 - 根据异常类型设置相应的状态码 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-12-06 10:07:42 +08:00
李东云	e8596c9d30	chore(release): 1.0.0-beta.5	2024-09-12 11:47:31 +00:00
李东云	b6dd7dd4ac	feat(email): 对发送邮件增加密送，增加单独定制发件人的方法 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-09-12 19:47:14 +08:00
李东云	0283c7286a	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-09-12 19:23:28 +08:00
李东云	e4105a285f	chore(release): 1.0.0-beta.4	2024-06-23 12:55:58 +00:00
李东云	d20718db32	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-06-23 18:16:31 +08:00
李东云	d524fb4e89	fix(core-middleware): 修复 JsonResource 不走响应格式化的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-06-23 18:13:41 +08:00
李东云	eeab8a258d	chore(release): 1.0.0-beta.3	2024-05-17 06:05:09 +00:00
李东云	bac22a8ea6	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-05-17 14:04:48 +08:00
李东云	44c26b6491	fix(i18n): 在没有配置项目默认语言，且传入意料之外的语言时，默认为英文 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-05-17 14:04:09 +08:00
李东云	f422fb6b31	chore(release): 1.0.0-beta.2	2024-01-18 05:52:26 +00:00
李东云	762acbb368	fix(CoreMiddleware): 修复如果直接输出 ResponseInterface 实例会报错的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-01-18 13:52:16 +08:00
李东云	2167fd209a	perf(exception): 取消了必须是 apifox/postman 的设计 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2024-01-03 20:20:31 +08:00
李东云	fc9b41ef78	chore(release): 1.0.0-beta.1	2023-12-15 08:08:11 +00:00
李东云	da518799b3	fix(bin): 更新了迁移脚本的目录 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-15 16:08:00 +08:00
李东云	4d8a918898	chore(release): 1.0.0-beta.0	2023-12-15 08:00:49 +00:00
李东云	cfbb770559	build(release): 将版本号改为 beta Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-15 16:00:08 +08:00
李东云	01aa833537	fix(bin): 更新了迁移脚本的目录 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-15 15:58:23 +08:00
李东云	c02a08ca6b	chore(release): 1.0.0-alpha.19	2023-12-15 07:13:15 +00:00
李东云	a84b812dd0	feat(bin): 增加了迁移到最新版本的脚本 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-15 15:13:07 +08:00
李东云	6eacde9970	chore(release): 1.0.0-alpha.18	2023-12-14 08:29:17 +00:00
李东云	7d6dc7fe9f	feat(bin): 增加了迁移到最新版本的脚本 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 16:28:59 +08:00
李东云	97131d224c	refactor: 迁移到 hyperf3.1 的写法 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 16:03:23 +08:00
李东云	08d00a785f	build(composer): 清理 composer 配置移除了多余的 composer 包仓库 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 15:48:30 +08:00
李东云	16f69c193c	chore(release): 1.0.0-alpha.17	2023-12-14 07:38:35 +00:00
李东云	b89b218eaa	build(composer): 更新依赖，增加 php8.2/8.3的 polyfill Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 15:38:14 +08:00
李东云	14d28deee2	fix(CoreMiddleware): 修复参数类型过少的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 15:24:22 +08:00
李东云	cbc59ccf74	build(ide): 增加了docker 映射 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-14 15:23:46 +08:00
李东云	f34b2c9e21	chore(release): 1.0.0-alpha.16	2023-12-04 09:13:05 +00:00
李东云	eee68cab8a	refactor: 迁移到 hyperf3.1和 pestphp2 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-12-04 17:12:12 +08:00
李东云	c93ed73f10	chore(release): 1.0.0-alpha.15	2023-10-30 06:30:51 +00:00
李东云	97848a5e22	test(utils): 增加了无极分类的测试用例 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-30 14:30:31 +08:00
李东云	b7d0dd87c5	test(request): 修复了无法使用的测试用例 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-30 14:30:13 +08:00
李东云	26b55f1ca5	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-29 23:45:37 +08:00
李东云	6ca5462195	chore(release): 1.0.0-alpha.14	2023-10-23 12:48:06 +00:00
李东云	8e4f4d0d29	ci(GiteaActions): 修复没有内容的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 20:47:45 +08:00
李东云	df94317fcf	chore(release): 1.0.0-alpha.13	2023-10-23 11:42:50 +00:00
李东云	43c820c711	ci(GiteaActions): 现在只会根据 tag确定是否发布 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:42:38 +08:00
李东云	f1957b5156	chore(release): 1.0.0-alpha.12	2023-10-23 11:38:04 +00:00
李东云	418f4c47c9	ci(GiteaActions): 现在只会根据 tag确定是否发布 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:37:19 +08:00
李东云	635804e117	ci(GiteaActions): 修复推送的组织名错误问题 All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Successful in 21s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:21:33 +08:00
李东云	82d9a95691	ci(GiteaActions): 使用密钥推送包 All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Successful in 22s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:19:58 +08:00
李东云	063c1d7ea1	ci(GiteaActions): 安装 zip All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Successful in 22s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:11:07 +08:00
李东云	9cdbd6a2c8	ci(GiteaActions): 修复错误的action 写法 Some checks failed Publish when Pushed / Explore-Gitea-Actions (push) Failing after 22s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:09:59 +08:00
李东云	4cc1473d38	ci(GiteaActions): 不切换分支 Some checks failed Publish when Pushed / Explore-Gitea-Actions (push) Failing after 4s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:07:56 +08:00
李东云	895b028017	ci(GiteaActions): 修复镜像不包含 zip 的问题 Some checks failed Publish when Pushed / Explore-Gitea-Actions (push) Failing after 3s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 19:02:36 +08:00
李东云	094589b87e	ci(GiteaActions): 修复镜像不包含 zip 的问题 All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Has been cancelled Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 18:59:33 +08:00
李东云	85ae11e295	ci(GiteaActions): 修复镜像不包含 zip 的问题 All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Has been cancelled Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 18:58:34 +08:00
李东云	6cb24a84b2	ci(GiteaActions): 修改触发条件 All checks were successful Publish when Pushed / Explore-Gitea-Actions (push) Has been cancelled Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 18:50:21 +08:00
李东云	118f0b789f	ci(GiteaActions): 修复镜像不包含 zip 的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 18:49:54 +08:00
李东云	7dfb3933f6	ci(GiteaActions): 尝试增加推送触发的 actions Some checks failed Publish when Released / Explore-Gitea-Actions (push) Has been cancelled Details Publish when Pushed / Explore-Gitea-Actions (push) Failing after 1m5s Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 18:33:10 +08:00
李东云	b32afe38b4	ci(GiteaActions): 增加了 actions All checks were successful Gitea Actions Demo / Explore-Gitea-Actions (push) Has been cancelled Details Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-23 17:36:28 +08:00
李东云	a46659f62b	chore(release): 1.0.0-alpha.11	2023-10-17 02:55:37 +00:00
李东云	f80da66185	ci(docker): 兼容 ext-redis:6.0 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-17 10:55:26 +08:00
李东云	4e5b0fdbb4	chore(release): 1.0.0-alpha.10	2023-10-16 09:36:18 +00:00
李东云	17c0518680	feat(rest): 增加多表关联的兼容 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-16 17:35:30 +08:00
李东云	37d42c17cc	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-16 17:34:24 +08:00
李东云	12e99604c9	build(script): root 用户可以使用 composer Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-16 17:31:24 +08:00
李东云	217178003a	chore(release): 1.0.0-alpha.9	2023-10-13 07:40:37 +00:00
李东云	359b13e718	build(config): 更新了默认的发件邮箱 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-13 15:40:06 +08:00
李东云	e9927fafb1	build(composer): 更新依赖 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-08 15:45:44 +08:00
李东云	02655228ae	chore(release): 1.0.0-alpha.8	2023-10-08 07:44:10 +00:00
李东云	9f7d4effb7	feat(email): 增加了对邮件优先级的兼容 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-10-08 15:43:47 +08:00
李东云	5980ea773b	chore(release): 1.0.0-alpha.7	2023-09-28 08:06:29 +00:00
李东云	110679448f	fix(rest): 修复不存在的具名参数 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-28 15:50:47 +08:00
李东云	64f936ab36	chore(release): 1.0.0-alpha.6	2023-09-28 06:59:13 +00:00
李东云	2afc3ad45b	fix(rest): 修复没有返回值的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-28 14:59:01 +08:00
李东云	cff919a21e	fix(i18n): 修复了无法正确无视大小写导致无法识别的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-26 16:23:52 +08:00
李东云	2d6d12e1c3	chore(release): 1.0.0-alpha.5	2023-09-26 08:23:29 +00:00
李东云	73420153d3	fix(i18n): 修复了无法正确无视大小写导致无法识别的问题 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-26 16:23:16 +08:00
李东云	fcb0cd8852	chore(release): 1.0.0-alpha.4	2023-09-26 02:55:03 +00:00
李东云	7a209e876f	test(http): 完成并通过了 http 请求的测试 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-26 10:54:44 +08:00
李东云	4032d67f1e	feat(i18n): 增加枚举值，更新中间件调用方式 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-26 10:44:00 +08:00
李东云	dbbe278aa6	build(composer): 引入 pest 并升级到 php8.1 Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>	2023-09-26 10:43:20 +08:00