Skip to content

feat(settings): 设置项悬停显示功能说明,降低 Less Computer / 录音胶囊等的理解门槛#777

Merged
H-Chris233 merged 3 commits into
Open-Less:betafrom
bigsongeth:feat/settings-hover-hints
Jul 12, 2026
Merged

feat(settings): 设置项悬停显示功能说明,降低 Less Computer / 录音胶囊等的理解门槛#777
H-Chris233 merged 3 commits into
Open-Less:betafrom
bigsongeth:feat/settings-hover-hints

Conversation

@bigsongeth

@bigsongeth bigsongeth commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

User description

问题

设置页「瘦身」后描述小字全部隐藏,Less Computer、录音胶囊这类光看名字猜不出用途的功能只剩一个标签,新用户理解成本高。

方案

把已有的 desc 文案以悬停 Tooltip 的形式挂回标签文字上——布局保持紧凑,可理解性回来了:

  • Tooltip 新增 wrap 模式:整句说明允许换行(默认 nowrap 行为不变,侧栏菜单提示不受影响)
  • SettingRowdesc 恢复生效:悬停标签文字弹出说明;带说明的文字加虚线下划线 + cursor: help,暗示「悬停可看解释」
  • SectionTitle 新增 hint:Less Computer、Claude 控制台、录音与输入三个板块标题接上已有的 desc
  • 「录音与输入」里录音胶囊 / 录音方式 / 首选麦克风 / 录音时静音 / 插入剪贴板等行补传现成的 i18n desc;其他 section 里已传 desc 的行(如快捷键页的 Less Computer 按住说话键)自动获得提示

文案全部复用现有 i18n key,五种语言无需新增翻译。

效果

  • 悬停「Less Computer」标题 → 「按住一个键说话,Claude 帮你操作电脑。仅 macOS。」
  • 悬停「录音胶囊」→ 「录音 / 转写时显示屏幕底部胶囊。」

首次悬停 600ms 后出现,沿用 Tooltip 既有的「预热」行为,连续查看多项说明时即时切换。

验证

  • tsc + vite build 通过
  • 浏览器里实际打开设置页验证:通用 → 录音胶囊、高级 → Less Computer 的悬停提示均正常弹出、正常换行;无说明的标签(如调试工具行)不带下划线、无提示

PR Type

Enhancement, Bug fix


Description

  • 为设置项添加悬停提示,复用已有说明文案

  • Tooltip 新增 wrap/focusable 模式及视口安全定位

  • SettingRow/SectionTitle 集成悬停说明,降理解门槛

  • 更新多语言快捷键提示文本,指向高级设置页


Diagram Walkthrough

flowchart LR
  Tooltip["Tooltip 组件<br/>wrap / focusable / 视口安全"] --> SettingRow["SettingRow<br/>desc → Tooltip 提示"]
  Tooltip --> SectionTitle["SectionTitle<br/>hint 属性 → Tooltip"]
  SettingRow --> RecordingInputSection["录音与输入<br/>5 行补传 desc"]
  SectionTitle --> CodingAgentSection["Less Computer<br/>标题悬停说明"]
  SectionTitle --> ClaudeConsoleSection["Claude 控制台<br/>标题悬停说明"]
Loading

File Walkthrough

Relevant files
Enhancement
5 files
Tooltip.tsx
增强 Tooltip:wrap/focusable/视口安全                                                     
+204/-45
ClaudeConsoleSection.tsx
标题包裹 Tooltip 显示说明                                                                               
+5/-2     
CodingAgentSection.tsx
标题添加 hint 悬停说明                                                                                     
+1/-1     
RecordingInputSection.tsx
多行补传 desc 实现悬停提示                                                                                 
+10/-12 
shared.tsx
SettingRow/SectionTitle 集成 Tooltip                                             
+46/-22 
Documentation
5 files
en.ts
英文 voiceHotkeyDesc 补充说明                                                                   
+1/-1     
ja.ts
日文 voiceHotkeyDesc 补充说明                                                                   
+1/-1     
ko.ts
韩文 voiceHotkeyDesc 补充说明                                                                   
+1/-1     
zh-CN.ts
中文 voiceHotkeyDesc 补充说明                                                                   
+1/-1     
zh-TW.ts
繁体中文 voiceHotkeyDesc 补充说明                                                               
+1/-1     

页面瘦身后设置页描述小字全部隐藏,Less Computer、录音胶囊这类光看名字
猜不出用途的功能只剩一个标签,理解成本高。本次把已有的 desc 文案以
Tooltip 形式挂回标签文字上:

- Tooltip 新增 wrap 模式,整句说明允许换行(默认 nowrap 不变)
- SettingRow 的 desc 恢复生效:悬停标签文字弹出说明,虚线下划线 +
  help 光标做「可悬停」暗示,布局保持紧凑
- SectionTitle 新增 hint,Less Computer / Claude 控制台 / 录音与输入
  三个板块标题接上已有的 desc 文案
- 录音与输入里录音胶囊 / 录音方式 / 首选麦克风 / 录音时静音 /
  插入剪贴板等行补传现成的 i18n desc

文案全部复用现有 i18n key,五种语言无需新增翻译。
@github-actions

github-actions Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

PR Reviewer Guide 🔍

(Review updated until commit 9e2462e)

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ No major issues detected

通用页 Less Computer 那行原提示只讲快捷键用法,补一句指向「高级」设置页
的功能说明入口,降低理解门槛。5 语言同步。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Persistent review updated to latest commit 85e1137

@github-actions

Copy link
Copy Markdown
Contributor

Persistent review updated to latest commit 9e2462e

@H-Chris233 H-Chris233 merged commit 414acf0 into Open-Less:beta Jul 12, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants