v2.4.0 patch2

patch
v2.4.0 patch release
2026-08-11 20:27:11 +08:00 · 2026-08-11 18:41:30 +08:00 · 2026-08-11 17:59:26 +08:00 · 2026-08-11 17:58:17 +08:00 · 2026-08-11 17:37:26 +08:00 · 2026-08-11 17:36:59 +08:00
85 changed files with 10639 additions and 769 deletions
@@ -2,6 +2,13 @@
 ASPNETCORE_ENVIRONMENT=Production
 ASPNETCORE_URLS=http://0.0.0.0:8080
 # 反向代理必须在转发请求时设置 X-Forwarded-For 和 X-Forwarded-Proto。
 # 仅填写实际直接连接 API 的代理 IP；多个代理依次使用 __0、__1……。
 # 使用 Docker 时通常是宿主机/代理容器在 Docker 网络中的 IP，而非访客 IP。
 # 默认仅信任 127.0.0.1 和 ::1。
 # ReverseProxy__TrustedProxies__0=127.0.0.1
 # ReverseProxy__TrustedProxies__1=::1
 Database__Provider=MySql
 Database__ApplyMigrationsOnStartup=false
 Database__CommandTimeoutSeconds=30
@@ -37,15 +44,15 @@ Cache__AnalyticsExpirationMinutes=3
 Cache__AnalyticsLocalExpirationSeconds=30
 Cache__MaximumPayloadKilobytes=2048
-# OpenTelemetry 默认收集 HTTP、运行时和数据库指标；配置 OTLP 地址后才会外发。
+# 应用日志建立接口与慢 SQL 基线；日志系统可按 DurationMs、RequestId、QueryName 聚合。
 Observability__Enabled=true
 Observability__ServiceName=jiaowu-api
 Observability__LogAllApiRequests=true
 Observability__SlowRequestThresholdMilliseconds=1000
 Observability__SlowQueryThresholdMilliseconds=500
 # 默认不记录完整 SQL，避免日志或追踪系统接触业务数据。
 Observability__IncludeSqlText=false
 Observability__MaximumSqlTextLength=2000
 # OTEL_EXPORTER_OTLP_ENDPOINT=https://otel-collector.example.edu.cn:4317
 # OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer%20REPLACE_WITH_TOKEN
 # 系统内“运维与审计 → 系统性能”从 Prometheus 只读查询汇总指标。
 PerformanceReporting__Enabled=false
@@ -73,7 +73,7 @@ jobs:
          echo "version=$version" >> "$GITHUB_OUTPUT"
          echo "profile=$profile" >> "$GITHUB_OUTPUT"
-      - name: Build self-contained platform packages
+      - name: Build framework-dependent platform packages
        shell: bash
        run: |
          bash ./scripts/publish-platform-packages.sh \
@@ -155,7 +155,7 @@ jobs:
            - Windows x64：`.zip`
            - Linux x64 / ARM64：`.tar.gz`
            - `SHA256SUMS`：发布包校验值
-            - 自包含程序包无需预装 .NET 或 ASP.NET Core Runtime
+            - 二进制程序包不包含 .NET 或 ASP.NET Core Runtime；请先安装匹配版本的 ASP.NET Core Runtime
            Windows ARM64 与 macOS Intel / Apple Silicon 包可通过手动运行工作流并启用扩展平台生成。
@@ -2,6 +2,7 @@
 FROM --platform=$BUILDPLATFORM node:24-alpine AS frontend
 WORKDIR /source
 COPY versions.props ./
 COPY web/package.json web/package-lock.json ./web/
 RUN npm --prefix web ci
 COPY web/ ./web/
@@ -11,6 +12,7 @@ FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:10.0-alpine AS build
 ARG TARGETARCH
 WORKDIR /source
 COPY global.json ./
 COPY versions.props ./
 COPY .env.example ./
 COPY src/Jiaowu.Api/Jiaowu.Api.csproj ./src/Jiaowu.Api/
 RUN dotnet restore ./src/Jiaowu.Api/Jiaowu.Api.csproj --arch "$TARGETARCH"