add tooltip instructions#99
Merged
keting merged 2 commits intoketing:mainfrom May 9, 2026
Merged
Conversation
keting
requested changes
May 8, 2026
Owner
keting
left a comment
There was a problem hiding this comment.
整体方向 OK,组件抽象和接入范围都比较清晰,前端测试与构建也通过。合并前请先修一个真实交互问题:
当前 HelpTooltip 渲染在 内部,点击 ? 会触发 label 的默认行为,导致“同服务器”checkbox 被误切换。新用户最可能点击 ? 查看说明,这会直接影响他们正在理解的配置项。建议把 trigger 改成
并阻止 label 默认激活行为,或把 Tooltip 移到 label 外部。
另外建议顺手检查 Tooltip 气泡在项目页右侧卡片和窄屏下的显示。现在气泡固定向右弹出且宽度 240px,有被裁切或溢出视口的风险。
keting
approved these changes
May 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
新增了前端可复用的悬浮提示组件(Tooltip),优化了“同服务器”相关表单项的交互体验。
具体修改:
HelpTooltip基础组件(含index.css样式调整)。CoLocatedFieldLabel组合组件,将原有的纯文本复选框替换为“文案 + ? 提示图标”的形式。ProjectNewPage.tsx(创建/编辑项目页面)AgentsPage.tsx(新增/编辑智能体页面)Closes # 77
Testing
cd src/backend && uv run python -m pytest tests/ -vcd src/frontend && npm testcd src/frontend && npm run buildProjectNewPage和AgentsPage的渲染,确认 Tooltip 触发灵敏,文案无误,且不影响原有表单的逻辑。Checklist