Skip to content

fix(knowledge-graph): 修复 Force Graph 放大时节点标签消失的问题 - #533

Merged
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/force-graph-label-always-visible
May 13, 2026
Merged

fix(knowledge-graph): 修复 Force Graph 放大时节点标签消失的问题#533
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/force-graph-label-always-visible

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

  • 本次变更要解决的问题:Force Graph 引擎中,当图谱放大到一定程度(globalScale >= 2.5)后,节点名称文字完全消失。根因是标签渲染逻辑中 fontSize = Math.max(10/globalScale, 4) 在放大时被钳制为 4,无法满足 fontSize > 4 的条件判断。

核心变更

  • 移除 fontSize > 4 硬阈值条件,改为仅保留缩放下限 globalScale > 0.3
  • 调整字号参数:基础从 10 提至 12,下限从 4 降至 3.5,确保各缩放级别可读
  • 放宽缩小隐藏阈值从 0.5 至 0.3,缩小状态下仍能显示标签

风险与回滚

  • 主要风险:极小缩放比例下标签可能略显拥挤
  • 回滚方式:git revert

验证证据

  • 单元测试:无(Canvas 渲染逻辑)
  • 集成测试:无
  • E2E/Workflow:需浏览器实机验证放大/缩小下标签始终可见
  • 覆盖率/关键截图:待补充

影响范围

  • 前端:ForceGraphCanvas.tsx 标签渲染逻辑
  • 后端:无
  • GitHub Actions / 文档:无

Next Best Action

  • 浏览器实机验证各缩放级别标签可见性

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ThreeFish-AI
ThreeFish-AI merged commit 18bf921 into feature/1.x.x May 13, 2026
11 checks passed
@ThreeFish-AI
ThreeFish-AI deleted the ThreeFish-AI/force-graph-label-always-visible branch May 13, 2026 03:26
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.

1 participant