Merge branch 'refs/heads/main' into feature/kingbase_opt

# Conflicts:
#	.github/workflows/test-build-all-platforms.yml
#	internal/db/query_value.go
#	internal/db/query_value_test.go

.github/release.yaml

@@ -0,0 +1,26 @@
+changelog:
+  categories:
+    - title: 新功能
+      labels:
+        - feature
+        - enhancement
+        - feat
+    - title: 问题修复
+      labels:
+        - bug
+        - fix
+    - title: 文档与流程
+      labels:
+        - docs
+        - documentation
+        - ci
+        - workflow
+        - chore
+    - title: 重构与优化
+      labels:
+        - refactor
+        - perf
+        - optimization
+    - title: 其他更新
+      labels:
+        - '*'

.github/workflows/release.yml

@@ -550,5 +550,6 @@ jobs:
           files: release-assets/*
           draft: true
           make_latest: true
+          generate_release_notes: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/sync-main-to-dev.yml

@@ -49,6 +49,7 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
+          echo "permission_blocked=false" >> "$GITHUB_OUTPUT"
           existing_number="$(gh pr list --base dev --head main --state open --json number --jq '.[0].number // empty')"
 
           if [ -n "${existing_number}" ]; then
@@ -58,6 +59,7 @@ jobs:
             echo "created=false" >> "$GITHUB_OUTPUT"
           else
             body_file="$(mktemp)"
+            error_file="$(mktemp)"
             {
               echo "## 自动回灌：\`main -> dev\`"
               echo
@@ -68,14 +70,28 @@ jobs:
               echo "- 无冲突：直接合并该 PR（建议 \`Merge commit\`）"
               echo "- 有冲突：在该 PR 内解决冲突后再合并"
             } > "${body_file}"
-            pr_url="$(gh pr create \
+
+            if pr_url="$(gh pr create \
               --base dev \
               --head main \
               --title "🔁 chore(sync): 回灌 main 到 dev" \
-              --body-file "${body_file}")"
-            pr_number="${pr_url##*/}"
-            echo "已创建同步 PR：#${pr_number}"
-            echo "created=true" >> "$GITHUB_OUTPUT"
+              --body-file "${body_file}" 2>"${error_file}")"; then
+              pr_number="${pr_url##*/}"
+              echo "已创建同步 PR：#${pr_number}"
+              echo "created=true" >> "$GITHUB_OUTPUT"
+            else
+              error_message="$(tr '\n' ' ' < "${error_file}")"
+              if printf '%s' "${error_message}" | grep -Fq "GitHub Actions is not permitted to create or approve pull requests"; then
+                echo "::warning::仓库未开启“Allow GitHub Actions to create and approve pull requests”，已跳过自动创建同步 PR。"
+                echo "permission_blocked=true" >> "$GITHUB_OUTPUT"
+                echo "created=false" >> "$GITHUB_OUTPUT"
+                echo "pr_number=" >> "$GITHUB_OUTPUT"
+                echo "pr_url=" >> "$GITHUB_OUTPUT"
+                exit 0
+              fi
+              echo "::error::创建同步 PR 失败：${error_message}"
+              exit 1
+            fi
           fi
 
           echo "pr_number=${pr_number}" >> "$GITHUB_OUTPUT"
@@ -83,7 +99,7 @@ jobs:
 
       - name: 检查合并状态
         id: merge_state
-        if: steps.diff_check.outputs.has_changes == 'true'
+        if: steps.diff_check.outputs.has_changes == 'true' && steps.sync_pr.outputs.permission_blocked != 'true'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
@@ -98,7 +114,7 @@ jobs:
 
       - name: 可合并时开启自动合并
         id: auto_merge
-        if: steps.diff_check.outputs.has_changes == 'true' && steps.merge_state.outputs.mergeable == 'MERGEABLE'
+        if: steps.diff_check.outputs.has_changes == 'true' && steps.sync_pr.outputs.permission_blocked != 'true' && steps.merge_state.outputs.mergeable == 'MERGEABLE'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
@@ -123,6 +139,13 @@ jobs:
               echo "- 状态：无需同步（dev 已包含 main 最新提交）"
               exit 0
             fi
+            if [ "${{ steps.sync_pr.outputs.permission_blocked }}" = "true" ]; then
+              echo "- 状态：已跳过自动创建同步 PR"
+              echo "- 原因：仓库未开启 GitHub Actions 创建与审批 Pull Request 权限"
+              echo "- 处理：前往 Settings -> Actions -> General -> Workflow permissions，开启 Allow GitHub Actions to create and approve pull requests"
+              echo "- 兜底：由维护者手动执行 main 到 dev 合并，或开启该设置后重新运行 workflow"
+              exit 0
+            fi
             echo "- PR：${{ steps.sync_pr.outputs.pr_url }}"
             echo "- 可合并状态：${{ steps.merge_state.outputs.mergeable }}"
             echo "- 合并状态详情：${{ steps.merge_state.outputs.merge_state_status }}"

CONTRIBUTING.md

@@ -84,6 +84,7 @@ This repository provides automatic sync via GitHub Actions workflow:
 - `.github/workflows/sync-main-to-dev.yml`
 - Trigger: every push to `main`
 - Behavior: create/reuse a PR from `main` to `dev`; if mergeable, it tries to enable auto-merge
+- Prerequisite: in `Settings -> Actions -> General -> Workflow permissions`, enable `Allow GitHub Actions to create and approve pull requests`; otherwise the workflow will skip PR creation and only emit a warning summary
 
 Manual fallback (when conflicts or automation is unavailable):
 

CONTRIBUTING.zh-CN.md

@@ -84,6 +84,7 @@ feature/* / fix/* -> dev -> release/* -> main -> tag(vX.Y.Z)
 - `.github/workflows/sync-main-to-dev.yml`
 - 触发时机：每次 `main` 分支有新的 push
 - 行为：自动创建或复用 `main` 到 `dev` 的同步 PR；若可合并，则尝试开启自动合并
+- 前置条件：需在 `Settings -> Actions -> General -> Workflow permissions` 中开启 `Allow GitHub Actions to create and approve pull requests`，否则 workflow 只会输出告警摘要并跳过建 PR
 
 当出现冲突，或自动化暂不可用时，使用以下手动兜底方式：
 

README.md

@@ -154,6 +154,7 @@ Artifacts are generated in `build/bin`.
 
 The repository includes a release workflow.
 Push a `v*` tag to trigger automated build and release.
+Release notes are generated automatically from merged pull requests and categorized by `.github/release.yaml`.
 
 Target artifacts include:
 - macOS (AMD64 / ARM64)

README.zh-CN.md

@@ -147,6 +147,7 @@ wails build -clean
 ### 跨平台发布（GitHub Actions）
 
 仓库内置发布流水线，推送 `v*` Tag 可自动构建并发布 Release。
+Release 更新说明会基于已合并 Pull Request 自动生成，并按 `.github/release.yaml` 分类。
 
 支持目标：
 - macOS (AMD64 / ARM64)

internal/db/query_value.go

@@ -129,6 +129,16 @@ func normalizeCompositeQueryValue(v interface{}) interface{} {
 			return stringer.String()
 		}
 		return fmt.Sprintf("%v", v)
+	case reflect.Struct:
+		// 部分驱动（如 Kingbase）会返回复杂结构体值，直接透传会导致前端渲染和比较开销激增。
+		// 统一降级为可读字符串，避免对象深层序列化触发 UI 卡顿。
+		if tm, ok := v.(time.Time); ok {
+			return tm.Format(time.RFC3339Nano)
+		}
+		if stringer, ok := v.(fmt.Stringer); ok {
+			return stringer.String()
+		}
+		return fmt.Sprintf("%v", v)
 	default:
 		return normalizeUnsafeIntegerForJS(rv, v)
 	}