diff --git a/docs/plans/2026-03-08-merge-aiflow-branch-design.md b/docs/plans/2026-03-08-merge-aiflow-branch-design.md deleted file mode 100644 index 999904d58..000000000 --- a/docs/plans/2026-03-08-merge-aiflow-branch-design.md +++ /dev/null @@ -1,179 +0,0 @@ -# aiflow-params-refactor-backend 分支合并到 dev 分支设计方案 - -## 背景 - -将 `aiflow-params-refactor-backend` 分支自 2026-01-01 至 2026-03-08 的非 AI 功能合并到 `dev` 分支。 - -## 核心约束 - -**排除所有 AI 相关代码**，具体排除路径： -- `pigx-aigc/` (AI 模块) -- `pigx-knowledge/` (旧 AI 模块) -- `pigx-common/pigx-common-milvus/` (Milvus 向量库) -- `pigx-common/pigx-common-seekdb/` (SeekDB 向量库) -- `pigx-common/pigx-common-mcp/` (MCP 协议) -- `pigx-common/pigx-common-neo4j/` (Neo4j 图库) -- `db/9pigxx_ai.sql` (AI 专属 SQL) -- `db/ai_skills.sql` (AI 技能 SQL) - -**保留合并**的模块：`pigx-common-sse` (通用 SSE 模块) - -## 提交分类汇总 - -| 类别 | 数量 | 处理方式 | -|------|------|---------| -| 可直接 cherry-pick | 45 | 按时间顺序逐个合并 | -| 跨模块需部分合并 | 22 | cherry-pick --no-commit + 排除 AI 文件 | -| 完全排除 | 45 | 不合并 | - -## 合并策略：三阶段 Cherry-pick - -### 阶段一：直接 cherry-pick 纯非 AI 提交 (45 个) - -按时间从旧到新依次 cherry-pick： - -``` -7b7aab886 fix(ai-prompt): 跳过外部 AI 注册短信验证 (注意：虽然涉及 ai 但文件在 upms) -dce71af84 fix(ai-register-user): 跳过外部 AI 注册短信验证 -462335246 feat(i18n): set default locale to China for message sources -de04594c4 feat(pigx-upms-biz): 增强区域树查询功能 -9db9ff1d1 feat(pigx-upms-api): 为 SysDictItem 添加 listClass 字段 -2f112a4a3 fix: 修复 sys_dict_item 表数据中新增的 NULL 字段 -339062b24 fix(pigx-common-datasource): 修正动态数据源查询中的 del_flag 参数值 -7711b26b9 fix(pigx-common-datasource): 修正动态数据源查询中的 del_flag 参数值 -eed66c0aa fix(pigx-common-security): 修复用户密码修改时间处理逻辑 -f6abe9852 feat(upms): 重构连接器导入功能，支持钉钉和企业微信Excel导入 -b3b392a05 fix(pigx-common-security): 添加token过期错误提示 -27895cb73 fix(pigx-common-bom): 更新MyBatis-Plus版本至3.5.16 -e2ccea22b fix(pigx-common-core): #7229 登录时租户上下文菜单查询错误 -7b4f672c4 fix(pigx-common-bom): 更新依赖版本 -a5f2a28fd fix: 修复当不同租户appid重复时导致的mpservice初始化失败 -792bd6c44 feat(pigx-mp-platform): 重构 WxMpInitConfigRunner 类 -ae6e80d55 fix: 更新 spring-boot 版本至 3.5.10，修正 spring-boot-admin 版本至 3.5.7 -cca898141 feat(pigx-knowledge): 移除知识库路由配置 (仅改 db/2pigxx.sql) -63a1bc0fd fix(pigx-upms-biz): 修复租户用户移除时的租户切换问题 -553a5fd9d feat(pigx-boot): 在 Dockerfile 中添加中文字体支持 -45eeadf0d feat(pigx-upms-api): 新增站内消息/公告发送功能 -d95348df5 feat(pigx-common-core): 增强Web配置支持异步任务处理 -c28670b68 feat(pigx-flow-biz): 条件表达式新增角色和岗位选择器条件处理功能 -2f8c6e37c feat(pigx-flow-api): 新增流程状态事件发布订阅机制 -7e55cdf39 feat(pigx-common-core): 优化WebCommonConfiguration配置类 -00494dd23 feat(pigx-flow-api): 新增流程状态事件注册与校验功能 -096b092c8 feat(WebCommonConfiguration): 更新异步任务执行器配置 -6947407d3 refactor(pigx-common-core): 重命名异步任务执行器方法 -d1a334aa3 fix(codegen): 修复生成模板导出参数的queryForm污染 -b2f8b60f0 refactor(pigx-upms-biz): 简化文件上传逻辑 -65c0842a4 refactor: 升级 Spring Boot 版本至 3.5.11 -babe57f1e feat(pigx-flow-api): 为 BizFlowBaseDto 添加 ExcelIgnore 注解 -9d9d3294e feat(pigx-boot): 添加可选模块依赖支持 -4f237a926 feat: 优化文件上传配置，统一使用 undertow 服务器设置 -0737e2943 feat(pigx-flow-biz): 扩展抄送任务支持角色和岗位类型 -f2903a89f feat(pigx-codegen): 优化数据源密码更新逻辑 -21c83813f feat(pigx-flow-biz): 优化流程创建逻辑 -628c50b2a feat(pigx-flow-api): 新增延时器节点支持 -8553a1f5c feat(pigx-flow-biz): 实现触发器节点功能 -07ad3ff51 feat(pigx-flow-biz): 实现触发器节点功能 -480ae63a8 feat(pigx-flow-biz): 新增流程打印模板功能 -29ea56eee feat(pigx-boot): 优化模块依赖配置 1.12.1 -7d1cac266 feat(pigx-flow-biz): 优化任务服务参数传递 -b61f13d61 feat(pigx-flow-biz): 增加触发器异常终止处理 -``` - -### 阶段二：处理跨模块提交 (22 个) - -对每个提交执行： -```bash -git cherry-pick --no-commit -git reset HEAD -- pigx-aigc/ pigx-knowledge/ \ - pigx-common/pigx-common-milvus/ pigx-common/pigx-common-seekdb/ \ - pigx-common/pigx-common-mcp/ pigx-common/pigx-common-neo4j/ \ - db/9pigxx_ai.sql db/ai_skills.sql -git checkout -- pigx-aigc/ pigx-knowledge/ \ - pigx-common/pigx-common-milvus/ pigx-common/pigx-common-seekdb/ \ - pigx-common/pigx-common-mcp/ pigx-common/pigx-common-neo4j/ \ - db/9pigxx_ai.sql db/ai_skills.sql -git commit -m "原始提交信息" -``` - -#### 高风险提交 (手动处理) - -以下提交非 AI 部分极少，建议手动 checkout 单文件而非 cherry-pick： - -1. **`b63758c9f`** feat(aigc): 添加 AIGC 服务常量 - - 仅需: `pigx-common/pigx-common-core/.../ServiceNameConstants.java` - -2. **`051f319ff`** refactor(aigc): rename pigx-knowledge to pigx-aigc - - 仅需: `docs/plans/` 文档和少量构建配置 - -3. **`60b4aca0f`** feat: Enhance tenant context handling - - 仅需: `db/0pigxx_boot.sql`, `pigx-boot/pom.xml` - -4. **`799188b31`** chore: upgrade version to 5.12.0 - - 全量 pom.xml 版本升级，需手动排除 AI 模块 pom - -#### 普通跨模块提交 - -以下提交大部分变更在 AI 模块中，非 AI 部分主要是 `db/0pigxx_boot.sql`： - -| Commit | 描述 | 需保留的非 AI 文件 | -|--------|------|-------------------| -| `05486d814` | 重构MCP聊天规则 | `db/0pigxx_boot.sql` | -| `19b3e3ba3` | PaddleOCR 异步解析 | `SysTenantServiceImpl.java` | -| `021139e55` | AI Skills 数据库表 | `db/0pigxx_boot.sql` | -| `a1225ed2c` | 调整AI菜单结构 | `db/0pigxx_boot.sql` | -| `6d240904a` | embedding 调用记录 | `db/0pigxx_boot.sql` | -| `eb3a334cb` | PgVector 依赖升级 | `pom.xml` (根) | -| `4f45c986d` | 移除模型代码 | `db/0pigxx_boot.sql` | -| `a25144a79` | AI代码评审功能 | `db/0pigxx_boot.sql` | -| `2bb41b75f` | 向量库默认配置 | `.gitignore`, `db/0pigxx_boot.sql`, `application-dev.yml` | -| `32544acd0` | SeekDB 重构 | `db/0pigxx_boot.sql`, `application-dev.yml` | -| `2e965fd55` | seekdb 混合搜索 | `db/0pigxx_boot.sql`, `pigx-common-bom/pom.xml` | -| `c9842d0c9` | AI海报默认模板 | `db/0pigxx_boot.sql` | -| `01a501165` | 海报二维码上传 | `db/0pigxx_boot.sql` | -| `8aaacc73b` | 信息图生成功能 | `db/0pigxx_boot.sql` | -| `40b9e3df1` | 视觉分析更新 | `db/0pigxx_boot.sql` | -| `d34cfbd1b` | knowledge 拆分 | 需确认非 AI 文件 | -| `5647dc701` | 智能巡检 | 需确认非 AI 文件 | -| `0a091418b` | 文档解析配置 | 需确认非 AI 文件 | - -### 阶段三：验证和清理 - -1. **编译验证** - ```bash - mvn -T 1C clean compile -DskipTests -pl '!pigx-aigc' - ``` - -2. **依赖检查** - - 确认 pom.xml 无对 pigx-aigc 的引用 - - 确认无 import 引用 `com.pig4cloud.pigx.aigc` 包 - -3. **数据库脚本审查** - - `db/0pigxx_boot.sql` 中 AI 相关菜单项需人工确认 - -## 涉及的模块和主要功能 - -### 非 AI 功能总览 (合并目标) - -| 模块 | 主要功能 | -|------|---------| -| **pigx-flow** | 触发器节点、延时器节点、打印模板、流程状态事件、条件表达式增强 | -| **pigx-upms** | 站内消息/公告、连接器导入(钉钉/企微)、区域树增强、SysDictItem listClass | -| **pigx-common-core** | WebCommonConfiguration、异步任务执行器、MessageSource、SecurityConstants | -| **pigx-common-bom** | MyBatis-Plus 3.5.16、Spring Boot 3.5.11 升级 | -| **pigx-common-security** | token 过期提示、密码修改时间修复 | -| **pigx-common-datasource** | del_flag 参数修复 | -| **pigx-common-sse** | Redis 分发配置优化 | -| **pigx-visual/codegen** | 数据源密码更新、模板导出修复、AI扩展Controller | -| **pigx-boot** | Dockerfile 字体支持、模块依赖优化 | -| **pigx-app-server** | App 功能增强 | -| **pigx-mp-platform** | 微信公众号配置重构 | -| **pigx-auth/gateway/register** | 认证和网关更新 | -| **db/** | 非 AI 数据库表结构更新 | -| **根 pom.xml** | Spring Boot 3.5.11、版本管理更新 | - -## 风险和注意事项 - -1. **db/0pigxx_boot.sql 混合内容**: 该文件同时包含 AI 和非 AI 表的变更，需人工审查每次合并 -2. **版本升级提交 (799188b31)**: 涉及几乎所有 pom.xml，需逐一排除 AI 模块 -3. **编译依赖**: 某些非 AI 代码可能间接引用了 AI 模块的类型，需编译验证 -4. **pigx-boot 模块**: 作为单体模式入口，其 pom.xml 中可能引用了 AI 模块依赖 diff --git a/docs/plans/2026-03-08-merge-aiflow-non-ai-plan.md b/docs/plans/2026-03-08-merge-aiflow-non-ai-plan.md deleted file mode 100644 index 366de5c59..000000000 --- a/docs/plans/2026-03-08-merge-aiflow-non-ai-plan.md +++ /dev/null @@ -1,774 +0,0 @@ -# 合并 aiflow-params-refactor-backend 非 AI 代码到 dev 分支 — 实施计划 - -> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. - -**Goal:** 将 `aiflow-params-refactor-backend` 分支 2026-01-01 至 2026-03-08 期间的非 AI 功能代码合并到 `dev` 分支 - -**Architecture:** 三阶段 cherry-pick 策略。阶段一批量合并 45 个纯非 AI 提交；阶段二对 22 个跨模块提交进行选择性文件提取；阶段三编译验证和清理。 - -**Tech Stack:** Git, Maven, Spring Boot 3.5.11 - ---- - -## AI 排除路径清单 (全局引用) - -以下路径在所有 cherry-pick 操作中必须排除： - -``` -pigx-aigc/ -pigx-knowledge/ -pigx-common/pigx-common-milvus/ -pigx-common/pigx-common-seekdb/ -pigx-common/pigx-common-mcp/ -pigx-common/pigx-common-neo4j/ -db/9pigxx_ai.sql -db/ai_skills.sql -``` - -排除命令模板（后续简称 `EXCLUDE_PATHS`）： -```bash -EXCLUDE_PATHS="pigx-aigc/ pigx-knowledge/ pigx-common/pigx-common-milvus/ pigx-common/pigx-common-seekdb/ pigx-common/pigx-common-mcp/ pigx-common/pigx-common-neo4j/ db/9pigxx_ai.sql db/ai_skills.sql" -``` - ---- - -## Task 1: 创建工作分支并备份 - -**Files:** -- 无文件修改，仅 Git 操作 - -**Step 1: 确认当前在 dev 分支** - -```bash -cd /Users/lengleng/work/dev1227/pigx -git branch --show-current -``` -Expected: `dev` - -**Step 2: 确保工作区干净** - -```bash -git status -``` -Expected: `working tree clean` - -**Step 3: 创建备份分支** - -```bash -git branch dev-backup-before-merge -``` - -**Step 4: 创建合并工作分支** - -```bash -git checkout -b merge/aiflow-non-ai-to-dev -``` - -**Step 5: 验证** - -```bash -git branch --show-current -``` -Expected: `merge/aiflow-non-ai-to-dev` - ---- - -## Task 2: 阶段一 — 批量 Cherry-pick 纯非 AI 提交 (第 1 批: 最早期提交) - -**Files:** -- 涉及 pigx-upms, pigx-common-datasource, pigx-common-security, pigx-common-bom 等模块 - -按时间正序（从旧到新）执行 cherry-pick。如遇冲突，手动解决后 `git add` 并 `git cherry-pick --continue`。 - -**Step 1: Cherry-pick 第 1-15 个提交** - -逐个执行，每个成功后继续下一个： - -```bash -# 1. fix(ai-prompt): 优化提示词模板保存报错 (文件在 upms，非 AI) -git cherry-pick 7b7aab886 - -# 2. fix(ai-register-user): 跳过外部 AI 注册短信验证 -git cherry-pick dce71af84 - -# 3. feat(i18n): set default locale to China -git cherry-pick 462335246 - -# 4. feat(pigx-upms-biz): 增强区域树查询功能 -git cherry-pick de04594c4 - -# 5. feat(pigx-upms-api): SysDictItem 添加 listClass 字段 -git cherry-pick 9db9ff1d1 - -# 6. fix: 修复 sys_dict_item 表数据中新增的 NULL 字段 -git cherry-pick 2f112a4a3 - -# 7. fix(pigx-common-datasource): 修正 del_flag 参数值 -git cherry-pick 339062b24 - -# 8. fix(pigx-common-datasource): 修正 del_flag 参数值 (第二个) -git cherry-pick 7711b26b9 - -# 9. fix(pigx-common-security): 修复用户密码修改时间处理逻辑 -git cherry-pick eed66c0aa - -# 10. feat(upms): 重构连接器导入功能，钉钉/企微 -git cherry-pick f6abe9852 - -# 11. fix(pigx-common-security): 添加token过期错误提示 -git cherry-pick b3b392a05 - -# 12. fix(pigx-common-bom): 更新MyBatis-Plus至3.5.16 -git cherry-pick 27895cb73 - -# 13. fix(pigx-common-core): #7229 租户上下文菜单查询错误 -git cherry-pick e2ccea22b - -# 14. fix(pigx-common-bom): 更新依赖版本 -git cherry-pick 7b4f672c4 - -# 15. fix: 修复租户appid重复导致mpservice初始化失败 -git cherry-pick a5f2a28fd -``` - -**Step 2: 验证 cherry-pick 状态** - -```bash -git log --oneline -15 -``` -Expected: 看到 15 个新提交 - ---- - -## Task 3: 阶段一 — 批量 Cherry-pick (第 2 批: 中期提交) - -**Step 1: Cherry-pick 第 16-30 个提交** - -```bash -# 16. feat(pigx-mp-platform): 重构 WxMpInitConfigRunner -git cherry-pick 792bd6c44 - -# 17. fix: 更新 spring-boot 版本至 3.5.10 -git cherry-pick ae6e80d55 - -# 18. feat(pigx-knowledge): 移除知识库路由配置 (仅改 db/2pigxx.sql) -git cherry-pick cca898141 - -# 19. fix(pigx-upms-biz): 修复租户用户移除时的租户切换问题 -git cherry-pick 63a1bc0fd - -# 20. feat(pigx-boot): Dockerfile 添加中文字体支持 -git cherry-pick 553a5fd9d - -# 21. feat(pigx-upms-api): 新增站内消息/公告发送功能 -git cherry-pick 45eeadf0d - -# 22. feat(pigx-common-core): 增强Web配置支持异步任务处理 -git cherry-pick d95348df5 - -# 23. feat(pigx-flow-biz): 条件表达式新增角色和岗位选择器 -git cherry-pick c28670b68 - -# 24. feat(pigx-flow-api): 新增流程状态事件发布订阅机制 -git cherry-pick 2f8c6e37c - -# 25. feat(pigx-common-core): 优化WebCommonConfiguration配置类 -git cherry-pick 7e55cdf39 - -# 26. feat(pigx-flow-api): 新增流程状态事件注册与校验功能 -git cherry-pick 00494dd23 - -# 27. feat(WebCommonConfiguration): 更新异步任务执行器配置 -git cherry-pick 096b092c8 - -# 28. refactor(pigx-common-core): 重命名异步任务执行器方法 -git cherry-pick 6947407d3 - -# 29. fix(codegen): 修复生成模板导出参数的queryForm污染 -git cherry-pick d1a334aa3 - -# 30. refactor(pigx-upms-biz): 简化文件上传逻辑 -git cherry-pick b2f8b60f0 -``` - -**Step 2: 验证** - -```bash -git log --oneline -30 -``` - ---- - -## Task 4: 阶段一 — 批量 Cherry-pick (第 3 批: 后期提交) - -**Step 1: Cherry-pick 第 31-45 个提交** - -```bash -# 31. refactor: 升级 Spring Boot 版本至 3.5.11 -git cherry-pick 65c0842a4 - -# 32. feat(pigx-flow-api): BizFlowBaseDto 添加 ExcelIgnore 注解 -git cherry-pick babe57f1e - -# 33. feat(pigx-boot): 添加可选模块依赖支持 -git cherry-pick 9d9d3294e - -# 34. feat: 优化文件上传配置，统一使用 undertow -git cherry-pick 4f237a926 - -# 35. feat(pigx-flow-biz): 扩展抄送任务支持角色和岗位 -git cherry-pick 0737e2943 - -# 36. feat(pigx-codegen): 优化数据源密码更新逻辑 -git cherry-pick f2903a89f - -# 37. feat(pigx-flow-biz): 优化流程创建逻辑 -git cherry-pick 21c83813f - -# 38. feat(pigx-flow-api): 新增延时器节点支持 -git cherry-pick 628c50b2a - -# 39. feat(pigx-flow-biz): 实现触发器节点功能 -git cherry-pick 8553a1f5c - -# 40. feat(pigx-flow-biz): 实现触发器节点功能 (续) -git cherry-pick 07ad3ff51 - -# 41. feat(pigx-flow-biz): 新增流程打印模板功能 -git cherry-pick 480ae63a8 - -# 42. feat(pigx-boot): 优化模块依赖配置 1.12.1 -git cherry-pick 29ea56eee - -# 43. feat(pigx-flow-biz): 优化任务服务参数传递 -git cherry-pick 7d1cac266 - -# 44. feat(pigx-flow-biz): 增加触发器异常终止处理 -git cherry-pick b61f13d61 -``` - -**Step 2: 验证阶段一完成** - -```bash -git log --oneline HEAD~45..HEAD -``` -Expected: 约 44-45 个新提交（可能有一两个因冲突合并） - ---- - -## Task 5: 阶段二 — 跨模块提交 · 版本升级 (799188b31) - -这是最大的跨模块提交 — 全量版本升级到 5.12.0，涉及几乎所有模块的 pom.xml。 - -**Files:** -- 修改: 约 50 个 pom.xml 文件 -- 修改: `docker-compose.yml` -- 修改: `pigx-boot/src/main/resources/application-dev.yml` - -**Step 1: Cherry-pick 但不提交** - -```bash -git cherry-pick --no-commit 799188b31 -``` - -**Step 2: 排除 AI 模块文件** - -```bash -# 撤销 AI 模块的 pom.xml 变更 -git restore --staged --worktree -- pigx-aigc/ || true -git restore --staged --worktree -- pigx-common/pigx-common-milvus/pom.xml || true -git restore --staged --worktree -- pigx-common/pigx-common-seekdb/pom.xml || true -git restore --staged --worktree -- pigx-common/pigx-common-mcp/pom.xml || true -git restore --staged --worktree -- pigx-common/pigx-common-neo4j/pom.xml || true -git restore --staged --worktree -- db/9pigxx_ai.sql || true -``` - -**Step 3: 检查暂存区，确认只剩非 AI 文件** - -```bash -git diff --cached --name-only | grep -E '(aigc|knowledge|milvus|seekdb|mcp|neo4j|9pigxx_ai)' || echo "OK: 无 AI 文件" -``` -Expected: `OK: 无 AI 文件` - -**Step 4: 提交** - -```bash -git commit -m "$(cat <<'EOF' -chore: upgrade version to 5.12.0 (non-AI modules only) - -Cherry-picked from 799188b31, excluding pigx-aigc and AI-related common modules. -EOF -)" -``` - ---- - -## Task 6: 阶段二 — 跨模块提交 · ServiceNameConstants (b63758c9f) - -这个提交改了约 200 个 AI 文件，但非 AI 部分仅 `ServiceNameConstants.java`。 - -**Files:** -- 修改: `pigx-common/pigx-common-core/src/main/java/com/pig4cloud/pigx/common/core/constant/ServiceNameConstants.java` - -**Step 1: 直接从源分支提取单个文件** - -```bash -git checkout aiflow-params-refactor-backend -- pigx-common/pigx-common-core/src/main/java/com/pig4cloud/pigx/common/core/constant/ServiceNameConstants.java -``` - -**Step 2: 检查 diff 确认变更合理** - -```bash -git diff --cached -- pigx-common/pigx-common-core/src/main/java/com/pig4cloud/pigx/common/core/constant/ServiceNameConstants.java -``` - -**Step 3: 确认没有引入对 aigc 包的依赖** - -```bash -git diff --cached | grep -i 'aigc\|knowledge' || echo "OK: 无 AI 引用" -``` - -**Step 4: 提交** - -```bash -git commit -m "$(cat <<'EOF' -feat(pigx-common-core): 更新 ServiceNameConstants 添加 AIGC 服务常量 - -从 b63758c9f 提取非 AI 文件部分。 -EOF -)" -``` - ---- - -## Task 7: 阶段二 — 跨模块提交 · 租户上下文增强 (60b4aca0f) - -非 AI 部分仅 `db/0pigxx_boot.sql` 和 `pigx-boot/pom.xml`。 - -**Files:** -- 修改: `pigx-boot/pom.xml` - -**Step 1: Cherry-pick 但不提交** - -```bash -git cherry-pick --no-commit 60b4aca0f -``` - -**Step 2: 排除 AI 文件** - -```bash -git restore --staged --worktree -- pigx-aigc/ || true -git restore --staged --worktree -- db/9pigxx_ai.sql || true -``` - -**Step 3: 审查 db/0pigxx_boot.sql 变更** - -```bash -git diff --cached -- db/0pigxx_boot.sql | head -100 -``` - -人工审查：确认 SQL 变更中不含纯 AI 功能表（如 `ai_flow`, `ai_model`, `ai_dataset` 等），仅保留通用业务表变更。如果 SQL 中混有 AI 表定义，需手动编辑移除。 - -**Step 4: 检查无 AI 残留** - -```bash -git diff --cached --name-only | grep -E '(aigc|knowledge|milvus|seekdb|mcp|neo4j|9pigxx_ai)' || echo "OK" -``` - -**Step 5: 提交** - -```bash -git commit -m "$(cat <<'EOF' -feat: 增强租户上下文处理 (非 AI 部分) - -从 60b4aca0f 提取 db/0pigxx_boot.sql 和 pigx-boot/pom.xml 变更。 -EOF -)" -``` - ---- - -## Task 8: 阶段二 — 跨模块提交 · PgVector 依赖升级 (eb3a334cb) - -非 AI 部分仅根 `pom.xml`。 - -**Files:** -- 修改: `pom.xml` - -**Step 1: 直接从源分支提取** - -```bash -git checkout aiflow-params-refactor-backend -- pom.xml -``` - -**Step 2: 审查根 pom.xml 变更** - -```bash -git diff --cached -- pom.xml -``` - -确认：是否有引入 AI 专属依赖（如 langchain4j, spring-ai 等），如有需手动移除。 - -**Step 3: 提交** - -```bash -git commit -m "$(cat <<'EOF' -refactor: 更新根 pom.xml 依赖版本 - -从 eb3a334cb 提取根 pom.xml 变更。 -EOF -)" -``` - ---- - -## Task 9: 阶段二 — 跨模块提交 · PaddleOCR 中的 upms 变更 (19b3e3ba3) - -非 AI 部分仅 `SysTenantServiceImpl.java`。 - -**Files:** -- 修改: `pigx-upms/pigx-upms-biz/src/main/java/.../SysTenantServiceImpl.java` - -**Step 1: 提取单文件** - -```bash -git checkout aiflow-params-refactor-backend -- pigx-upms/pigx-upms-biz/src/main/java/com/pig4cloud/pigx/admin/service/impl/SysTenantServiceImpl.java -``` - -**Step 2: 审查变更** - -```bash -git diff --cached -- pigx-upms/ -``` - -**Step 3: 提交** - -```bash -git commit -m "$(cat <<'EOF' -feat(pigx-upms-biz): 优化 SysTenantServiceImpl 租户处理逻辑 - -从 19b3e3ba3 提取非 AI 部分。 -EOF -)" -``` - ---- - -## Task 10: 阶段二 — 跨模块提交 · seekdb 混合搜索中的 BOM 变更 (2e965fd55) - -非 AI 部分：`pigx-common/pigx-common-bom/pom.xml` 和 `pigx-common/pom.xml`。 - -**Files:** -- 修改: `pigx-common/pigx-common-bom/pom.xml` -- 修改: `pigx-common/pom.xml` - -**Step 1: 提取文件** - -```bash -git checkout aiflow-params-refactor-backend -- pigx-common/pigx-common-bom/pom.xml pigx-common/pom.xml -``` - -**Step 2: 审查变更** - -```bash -git diff --cached -- pigx-common/pigx-common-bom/pom.xml pigx-common/pom.xml -``` - -确认：`pigx-common/pom.xml` 中是否新增了 AI 相关子模块引用（如 `pigx-common-milvus` 等），如有需手动移除。 - -**Step 3: 提交** - -```bash -git commit -m "$(cat <<'EOF' -refactor(pigx-common): 更新 BOM 依赖版本 - -从 2e965fd55 提取非 AI 部分。 -EOF -)" -``` - ---- - -## Task 11: 阶段二 — 跨模块提交 · 向量库默认配置中的通用文件 (2bb41b75f) - -非 AI 部分：`.gitignore`、`pigx-boot/src/main/resources/application-dev.yml`。 - -**Files:** -- 修改: `.gitignore` -- 修改: `pigx-boot/src/main/resources/application-dev.yml` - -**Step 1: 提取文件** - -```bash -git checkout aiflow-params-refactor-backend -- .gitignore -git checkout aiflow-params-refactor-backend -- pigx-boot/src/main/resources/application-dev.yml -``` - -**Step 2: 审查变更** - -```bash -git diff --cached -- .gitignore pigx-boot/src/main/resources/application-dev.yml -``` - -确认 `application-dev.yml` 中无 AI 专属配置（如 `langchain4j`, `spring-ai`, `milvus` 配置项等），如有需移除。 - -**Step 3: 提交** - -```bash -git commit -m "$(cat <<'EOF' -chore: 更新 .gitignore 和 boot 开发配置 - -从 2bb41b75f 提取非 AI 部分。 -EOF -)" -``` - ---- - -## Task 12: 阶段二 — 跨模块提交 · AI Skills 数据库表 (021139e55) - -非 AI 部分仅 `db/0pigxx_boot.sql`（菜单/权限数据）。 - -**Files:** -- 修改: `db/0pigxx_boot.sql` - -**Step 1: Cherry-pick 但不提交** - -```bash -git cherry-pick --no-commit 021139e55 -``` - -**Step 2: 排除 AI 文件** - -```bash -git restore --staged --worktree -- db/9pigxx_ai.sql || true -git restore --staged --worktree -- db/ai_skills.sql || true -``` - -**Step 3: 审查 SQL 变更** - -```bash -git diff --cached -- db/0pigxx_boot.sql | head -60 -``` - -人工审查：确认是否只是菜单权限数据，是否需要保留。 - -**Step 4: 提交（或放弃）** - -如果 SQL 变更合理： -```bash -git commit -m "$(cat <<'EOF' -feat: 新增 AI Skills 菜单权限数据 (db/0pigxx_boot.sql) - -从 021139e55 提取非 AI SQL 部分。 -EOF -)" -``` - -如果 SQL 变更全是 AI 相关的，放弃： -```bash -git restore --staged --worktree -- . -``` - ---- - -## Task 13: 阶段二 — 批量处理剩余 db/0pigxx_boot.sql 跨模块提交 - -以下提交的非 AI 部分都只有 `db/0pigxx_boot.sql`，逐一审查决定是否保留。 - -**提交列表：** -- `05486d814` 重构MCP聊天规则 -- `a1225ed2c` 调整AI菜单结构 -- `6d240904a` embedding 调用记录 -- `4f45c986d` 移除模型代码 -- `a25144a79` AI代码评审功能 -- `c9842d0c9` AI海报默认模板 -- `01a501165` 海报二维码上传 -- `8aaacc73b` 信息图生成功能 -- `40b9e3df1` 视觉分析更新 -- `32544acd0` SeekDB 重构 -- `5647dc701` 智能巡检 (`db/0pigxx_boot.sql` + `db/6pigxx_config.sql`) -- `0a091418b` 文档解析配置 - -**Step 1: 对每个提交执行统一流程** - -对列表中的每个 ``： - -```bash -# a) cherry-pick 不提交 -git cherry-pick --no-commit - -# b) 排除所有 AI 文件 -git restore --staged --worktree -- pigx-aigc/ pigx-knowledge/ \ - pigx-common/pigx-common-milvus/ pigx-common/pigx-common-seekdb/ \ - pigx-common/pigx-common-mcp/ pigx-common/pigx-common-neo4j/ \ - db/9pigxx_ai.sql db/ai_skills.sql 2>/dev/null || true - -# c) 检查剩余变更 -git diff --cached --stat - -# d) 如果有合理的非 AI 变更，提交 -git commit -m "从 提取非 AI 数据库变更" - -# e) 如果无有效变更或全是 AI 相关 -git restore --staged --worktree -- . -``` - -**Step 2: 审查决策原则** - -- `db/0pigxx_boot.sql` 中的 `sys_menu` 插入如果是 AI 菜单项 → 排除 -- `db/0pigxx_boot.sql` 中的通用业务表变更 → 保留 -- `db/6pigxx_config.sql` 变更 → 保留 - ---- - -## Task 14: 阶段二 — 跨模块提交 · knowledge 拆分和重命名 (d34cfbd1b, 051f319ff) - -这两个大型重构提交几乎全是 AI 文件，非 AI 部分极少。 - -**Step 1: d34cfbd1b — 仅提取 BOM pom.xml** - -```bash -git checkout aiflow-params-refactor-backend -- pigx-common/pigx-common-bom/pom.xml -git diff --cached -- pigx-common/pigx-common-bom/pom.xml -``` - -如果变更已在 Task 10 中包含（来自 2e965fd55），则跳过： -```bash -git restore --staged -- pigx-common/pigx-common-bom/pom.xml -``` - -**Step 2: 051f319ff — 无需提取** - -该提交的 `docs/plans/` 文件是旧的设计文档，可忽略。所有其他文件都是 pigx-aigc 重命名，全部排除。 - ---- - -## Task 15: 阶段三 — 编译验证 - -**Step 1: 执行编译（排除 pigx-aigc）** - -```bash -cd /Users/lengleng/work/dev1227/pigx -mvn -T 1C clean compile -DskipTests -pl '!pigx-aigc/pigx-aigc-api,!pigx-aigc/pigx-aigc-biz' -``` - -Expected: `BUILD SUCCESS` - -如果编译失败，分析错误： -- 如果是缺少 AI 模块依赖 → 检查 pom.xml 是否误引入了 pigx-aigc 依赖 -- 如果是 import 错误 → 移除对 `com.pig4cloud.pigx.aigc` 包的引用 - -**Step 2: 如果编译失败，修复后重新编译** - -```bash -# 查找是否有对 aigc 包的引用 -grep -r "com.pig4cloud.pigx.aigc" --include="*.java" \ - pigx-upms/ pigx-flow/ pigx-boot/ pigx-common/ pigx-visual/ pigx-app-server/ pigx-auth/ pigx-gateway/ -``` - -Expected: 无匹配（或仅在排除模块中） - ---- - -## Task 16: 阶段三 — 依赖和配置检查 - -**Step 1: 检查根 pom.xml 模块列表** - -```bash -grep '' pom.xml -``` - -确认不会强制编译 pigx-aigc（`pigx-aigc` 应在 `` 列表中，但不影响排除编译）。 - -**Step 2: 检查 pigx-boot pom.xml 依赖** - -```bash -grep -A2 'pigx-aigc\|pigx-knowledge' pigx-boot/pom.xml -``` - -如果存在对 pigx-aigc 的依赖且 `true` 或有 profile 控制 → OK -如果是硬依赖 → 需确认 pigx-boot 是否能在不加载 AI 模块的情况下启动 - -**Step 3: 检查 pigx-common pom.xml 子模块列表** - -```bash -grep '' pigx-common/pom.xml -``` - -确认 AI 相关子模块（milvus, seekdb, mcp, neo4j）在列表中的存在不影响编译。 - ---- - -## Task 17: 阶段三 — 最终审查和合并到 dev - -**Step 1: 查看完整变更统计** - -```bash -git log --oneline merge/aiflow-non-ai-to-dev ^dev | wc -l -git diff dev...merge/aiflow-non-ai-to-dev --stat | tail -5 -``` - -**Step 2: 确认无 AI 模块文件被合并** - -```bash -git diff dev...merge/aiflow-non-ai-to-dev --name-only | grep -E '(pigx-aigc/|pigx-knowledge/|pigx-common-milvus/|pigx-common-seekdb/|pigx-common-mcp/|pigx-common-neo4j/|db/9pigxx_ai|db/ai_skills)' || echo "OK: 无 AI 文件被合并" -``` -Expected: `OK: 无 AI 文件被合并` - -**Step 3: 合并到 dev 分支** - -```bash -git checkout dev -git merge merge/aiflow-non-ai-to-dev --no-ff -m "$(cat <<'EOF' -merge: 合并 aiflow-params-refactor-backend 非 AI 功能到 dev - -合并范围: 2026-01-01 至 2026-03-08 -排除模块: pigx-aigc, pigx-common-milvus/seekdb/mcp/neo4j -包含功能: -- pigx-flow: 触发器、延时器、打印模板、流程状态事件 -- pigx-upms: 站内消息、连接器导入、区域树增强 -- pigx-common: BOM升级、core优化、security修复 -- pigx-visual/codegen: 数据源密码、模板导出修复 -- pigx-boot: Dockerfile字体支持、模块依赖 -- pigx-app-server: App功能增强 -- 版本升级: Spring Boot 3.5.11, MyBatis-Plus 3.5.16 -EOF -)" -``` - -**Step 4: 最终编译验证** - -```bash -mvn -T 1C clean compile -DskipTests -pl '!pigx-aigc/pigx-aigc-api,!pigx-aigc/pigx-aigc-biz' -``` -Expected: `BUILD SUCCESS` - -**Step 5: 提交完成，保留备份分支** - -```bash -echo "合并完成。备份分支: dev-backup-before-merge" -echo "如需回滚: git checkout dev && git reset --hard dev-backup-before-merge" -``` - ---- - -## 冲突处理指南 - -cherry-pick 过程中遇到冲突时： - -1. `git status` 查看冲突文件 -2. 如果冲突文件在 AI 排除路径中 → `git restore --staged --worktree -- ` -3. 如果冲突文件在非 AI 模块中 → 手动编辑解决冲突，选择源分支（aiflow）的版本 -4. 解决后 `git add ` 然后 `git cherry-pick --continue` -5. 如果某个提交冲突太多无法合理解决 → `git cherry-pick --abort` 并跳过 - -## 回滚方案 - -如果整个合并过程出现严重问题： - -```bash -git checkout dev -git reset --hard dev-backup-before-merge -git branch -D merge/aiflow-non-ai-to-dev -```