Skip to content

feat: 支持插件管理 --story=139209730 - #1027

Merged
Mianhuatang8 merged 2 commits into
TencentBlueKing:feat/plugin_managefrom
Mianhuatang8:latest_plugin_manage_joint_debugging
Nov 17, 2026
Merged

Mianhuatang8 merged 2 commits into
TencentBlueKing:feat/plugin_managefrom
Mianhuatang8:latest_plugin_manage_joint_debugging

Conversation

@Mianhuatang8

Copy link
Copy Markdown
Collaborator

No description provided.

@github-actions

Copy link
Copy Markdown

🔎 AI 代码审查

📌 c59f0ea8bc15 · 🧪 未执行测试

Warning

⚠️ 有 7 项问题需要处理或确认

请优先查看下方待处理问题。

🆕 新增 🔴 仍存在 ✅ 已修复 ❔ 待确认
7 0 0 0

🚩 待处理问题

🔴 P1 · 插件状态词汇与后端不一致,列表/计数/状态流转全失效

📍 frontend/src/views/admin/Space/PluginManage/shared.js:31 · 🏷️ F-77340748892d · 🆕 新增

前端本次把状态改写为 enable / pending_review / not_enable / expired(shared.js 的 getStatusMap、getStatusTabs、normalizePluginStatus),但后端 bkflow/plugin_catalog/models.py 的 PluginCatalogStatus.CHOICES 仍是 review / visible / disabled / offline / invalid / not_enabled,且全仓后端无任何 pending_review、not_enable、enable 状态值。触发链:PluginList 默认 activeTab='enable',queryParams 生成 status='enable' 传给 EntryListQuerySerializer 后按 status__in=['enable'] 过滤 → 列表恒为空;getStatusTabs 读 counts.enable/pending_review/not_enable 而后端 get_status_counts 返回 visible/review/... 键 → 各 Tab 计数恒为 0;状态流转发送 status='enable'/'pending_review' 不在 EntryStatusSerializer 的 ChoiceField 可选值内 → 400。影响:插件管理列表、状态 Tab、启用/审核/停用全部不可用。修复:前端统一改用后端六态(或同步改后端),并把 normalizePluginStatus 的 expired→invalid、not_enable→not_enabled 对齐。

🔴 P1 · updateDisableConfig 请求到不存在的 /reason/ 端点

📍 frontend/src/store/modules/pluginManage.js:50 · 🏷️ F-0abbafbe98aa · 🆕 新增

store 里 updateDisableConfig 向 `api/plugin_catalog/plugins/${pluginId}/reason/` POST,但 bkflow/plugin_catalog/urls.py 只注册了 `plugins/<pk>/disable_config/`,没有 /reason/ 路由。调用链:PluginList.openDisabledConfigDialog → handleEditSave(isDisabledConfigMode) → updateDisableConfig({space_id, disable_reason, replace_plugin_id})。触发条件:在「未启用」Tab 对 status===&#x27;disabled&#x27; 的行点「停用配置」保存。影响:请求 404,停用配置保存必失败。且 payload 字段也与 DisableConfigSerializer(space_id + disable_config 字典) 不匹配(前端传 disable_reason/replace_plugin_id)。修复:改为 POST `plugins/${pluginId}/disable_config/`,并发送 `{space_id, disable_config}`。

🔴 P1 · 删除目录发送 directory_ids 串,后端要求单值 directory_id 且不支持多选删除

📍 frontend/src/views/admin/Space/PluginManage/CategoryManage/index.vue:1607 · 🏷️ F-2fa40d9ca0f7 · 🆕 新增

handleDeleteChecked/confirmDeleteChecked 将勾选的多个目录 join 成逗号串以 `directory_ids` 提交,但后端 PreviewDeleteSerializer 与 ExecuteDeleteSerializer 都只定义单值 `directory_id = IntegerField()`。触发条件:目录批量管理勾选目录点删除(删除影响评估与确认执行两步)。影响:后端因缺 directory_id 报 400,删除功能整体不可用;即便传单个目录,一级目录删除还需 strategy/target_directory_id,前端也未传。响应侧同样错配:前端读 impact.items 与 item.children_count/children_effect/plugin_count/plugin_effect,后端 preview_delete 返回的是单个目录对象(children/total_plugin_count/... 等)。修复:按后端契约逐目录调用 preview_delete/execute_delete(或后端改支持批量),并传 directory_id 与一级目录删除所需 strategy。

🟠 P2 · AI 分类请求漏传 scope,后端默认 free 会忽略勾选的 plugin_ids

📍 frontend/src/views/admin/Space/PluginManage/CategoryManage/index.vue:1561 · 🏷️ F-d5dd181ef35e · 🆕 新增

fetchMoveAiRecommend 调 aiClassify({space_id, plugin_ids}) 未传 scope。后端 AiClassifySerializer 中 scope 默认 &#x27;free&#x27;,DirectoryService.ai_classify 在 scope=&#x27;free&#x27; 时查询 directory__isnull=True 的全量未分类插件,忽略 plugin_ids;只有 scope=&#x27;selected&#x27; 才按 plugin_ids 过滤。触发条件:目录批量管理「移动至」面板点 AI 推荐、或 PluginList 的批量/快捷 AI 推荐。影响:对勾选插件的 AI 建议实际返回全量未分类插件的分类建议,推荐结果与用户选择不符。修复:调用时补 `scope: &#x27;selected&#x27;`(PluginList.fetchAiRecommendIds 同处一并修复)。

🟠 P2 · 停用原因用 disable_reason 提交,后端要求 disable_config 导致停用必失败

📍 frontend/src/views/admin/Space/PluginManage/index.vue:236 · 🏷️ F-562d66b58c0d · 🆕 新增

handleStatusChange 在 status=&#x27;disabled&#x27; 时提交 disable_reason 与 replace_plugin_id。后端 EntryStatusSerializer 没有 disable_reason 字段(被静默丢弃),且 catalog_service.transition_status 对 DISABLED 目标执行 `if not disable_config: raise ValidationError(&#x27;停用插件需要填写停用提示配置 disable_config&#x27;)`,而前端未传 disable_config。触发条件:可用 Tab 点「停用」→ 确认(PluginList.handleDisabledConfirm → statusChange)。影响:停用操作必然报错,用户填写的停用原因与替换插件均不生效。修复:停用请求改传后端期望的 `disable_config`(并去掉 replace_plugin_id,其仅下架 OFFLINE 使用),或按后端语义区分停用/下架两个动作。

🟠 P2 · 目录批量管理保存丢 bindings,导致来源绑定被清空

📍 frontend/src/views/admin/Space/PluginManage/CategoryManage/index.vue:811 · 🏷️ F-7f29c0ee4c9b · 🆕 新增

directoriesToTree 的 clean(811-815)只保留 id/name/children,treeToDirectories(822-827)重建目录文档时也不带 bindings。保存时 handleSave 提交 directories 后,后端 _upsert_directories 对已有一级目录执行 `directory.bindings = item.get(&#x27;bindings&#x27;) or []`,等于把所有一级目录的来源绑定清空。触发条件:进入「目录批量管理」页点保存(即使未改动任何目录)。影响:space 下各一级目录的 source_key 绑定被静默清空,依赖 bindings 的来源自动归类/来源绑定展示失效,属数据丢失。修复:fetchData 保留每个目录的 bindings,treeToDirectories 回写原 bindings(或后端对未提供的 bindings 保持原值)。

🟠 P2 · summary 返回结构无 count/total_count/uncategorized_count,侧栏计数恒为 0

📍 frontend/src/views/admin/Space/PluginManage/index.vue:146 · 🏷️ F-f1efaf933db6 · 🆕 新增

loadSummary 读取 node.count 写入 treeCounts,并读 summary.total_count/uncategorized_count。后端 PluginCatalogQueryService.get_summary 的 directory_tree 节点只有 {id,name,order,children}(无 count),summary 也没有 total_count 与 uncategorized_count 字段。触发条件:进入插件管理页加载概要。影响:侧栏各分类计数 tree 全为 0、未分类计数为 0、全部计数退化为 page_size=200 的截断值(>200 插件时不准确)。修复:后端 summary 补充 count/total_count/uncategorized_count(或前端改用 status_counts/directory 聚合),避免用 200 上限的列表长度冒充总数。

📎 审查边界

未运行任何测试、lint 或构建;仅静态比对 head 前端快照与同 head 的 bkflow/plugin_catalog 后端源码。前端依赖锁文件 package-lock.json 与 assets/js/flow.js 被过滤,无法验证依赖解析与画布 SDK 相关行为。状态词汇、字段名、路由/序列化器契约均基于读取的后端源码快照推断,未经真实 HTTP/浏览器验证;后端接口的完整返回结构与 ajax.js 拦截器行为(data 包装)未逐条核对。发现 7 项,未报告处不代表无风险。

📋 审查范围与验证说明

仅辅助人工审查;未执行测试,也不代表已满足合入或发布条件。

快照过滤了 13 个大文件、链接或工具配置文件;diff 仍包含其修改。


💡 本报告辅助人工审查,结论绑定上述提交。

@Mianhuatang8
Mianhuatang8 merged commit 7e85b82 into TencentBlueKing:feat/plugin_manage Nov 17, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants