From c36ec22618636e67f956e4a13fc20fa92d7ea3c6 Mon Sep 17 00:00:00 2001 From: baiqing Date: Tue, 28 Apr 2026 13:28:50 +0800 Subject: [PATCH] fix(help): correct GitHub URL + clean up FAQ / link layout MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - HelpTab GitHub 链接 baiqing → appergb，老地址 404 - helpLink 不再把整段 URL 当 label（中间截断 + 和标题挤一行）， 改成右侧「打开 ↗」按钮，hover tooltip 显示完整 URL - helpFAQ Q/A 间距 4 → 8、加 lineSpacing 2、行 padding 9 → 11， 提升可读性 --- .../OpenLessApp/Settings/Tabs/HelpTab.swift | 48 +++++++++++++------ docs/release-notes/1.0.05.md | 21 ++++++++ 2 files changed, 55 insertions(+), 14 deletions(-) create mode 100644 docs/release-notes/1.0.05.md diff --git a/Sources/OpenLessApp/Settings/Tabs/HelpTab.swift b/Sources/OpenLessApp/Settings/Tabs/HelpTab.swift index 87d71ade..b46ba9bd 100644 --- a/Sources/OpenLessApp/Settings/Tabs/HelpTab.swift +++ b/Sources/OpenLessApp/Settings/Tabs/HelpTab.swift @@ -27,17 +27,26 @@ struct HelpTab: View { } GlassSection(title: "常见问题", symbol: "questionmark.bubble") { - helpFAQ(q: "全局快捷键没反应？", a: "确认「系统设置 → 隐私与安全 → 辅助功能」里 OpenLess 已勾选；首次授权之后必须完全退出再重启 App。") + helpFAQ( + q: "全局快捷键没反应？", + a: "到「系统设置 → 隐私与安全 → 辅助功能」勾选 OpenLess。首次授权后必须完全退出再重启 App，全局快捷键才会生效。" + ) DividerLine() - helpFAQ(q: "胶囊一直显示「演示」？", a: "缺少火山 ASR 凭据。到「设置」里填入 APP ID + Access Token 即可。") + helpFAQ( + q: "胶囊一直显示「演示」？", + a: "缺少火山 ASR 凭据。到「设置」里填入 APP ID 和 Access Token 即可。" + ) DividerLine() - helpFAQ(q: "插入失败 / 只复制到剪贴板？", a: "目标 App 不支持 AX 写入或粘贴模拟。OpenLess 会自动降级为复制到剪贴板，按 ⌘V 粘贴即可。") + helpFAQ( + q: "插入失败 / 只复制到剪贴板？", + a: "目标 App 不支持 AX 写入或粘贴模拟。OpenLess 会自动降级为复制到剪贴板，按 ⌘V 粘贴即可。" + ) } GlassSection(title: "更多", symbol: "link") { - helpLink(title: "GitHub 仓库", url: "https://github.com/baiqing/openless") + helpLink(title: "GitHub 仓库", url: "https://github.com/appergb/openless") DividerLine() - helpLink(title: "提交问题或建议", url: "https://github.com/baiqing/openless/issues") + helpLink(title: "提交问题或建议", url: "https://github.com/appergb/openless/issues") } } } @@ -73,26 +82,37 @@ struct HelpTab: View { } private func helpFAQ(q: String, a: String) -> some View { - VStack(alignment: .leading, spacing: 4) { - Text(q).font(.system(size: 14, weight: .semibold)) - Text(a).font(.callout).foregroundStyle(.secondary) + VStack(alignment: .leading, spacing: 8) { + Text(q) + .font(.system(size: 14, weight: .semibold)) + .foregroundStyle(.primary) + Text(a) + .font(.callout) + .foregroundStyle(.secondary) .fixedSize(horizontal: false, vertical: true) + .lineSpacing(2) } - .padding(.vertical, 9) + .frame(maxWidth: .infinity, alignment: .leading) + .padding(.vertical, 11) } + /// 链接行：左标题、右图标按钮。 + /// 之前把整段 URL 作为 label 渲染会被中间截断、和标题挤在一行，视觉很乱。 private func helpLink(title: String, url: String) -> some View { HStack { Text(title) Spacer() if let parsed = URL(string: url) { Link(destination: parsed) { - Label(url, systemImage: "arrow.up.right.square") - .font(.callout) - .foregroundStyle(.blue) - .lineLimit(1) - .truncationMode(.middle) + HStack(spacing: 5) { + Text("打开") + .font(.callout) + Image(systemName: "arrow.up.right.square") + .font(.system(size: 12)) + } + .foregroundStyle(.blue) } + .help(url) } } .padding(.vertical, 9) diff --git a/docs/release-notes/1.0.05.md b/docs/release-notes/1.0.05.md new file mode 100644 index 00000000..9f849eb5 --- /dev/null +++ b/docs/release-notes/1.0.05.md @@ -0,0 +1,21 @@ +# OpenLess 1.0.05 + +build B1004 — 帮助中心整理。 + +## 修复 + +- **帮助中心 GitHub 链接 404**。「更多」分组里的"GitHub 仓库"和"提交问题或建议"原指向 `github.com/baiqing/openless`，仓库其实在 `github.com/appergb/openless`，老链接点进去打不开。已改回正确地址。 +- **帮助中心链接行布局乱**。之前把整段 URL 当作链接 label 渲染，"标题"和"被中间截断的长 URL"挤在一行。现在改成右侧一个简洁的「打开 ↗」按钮，hover 时 tooltip 显示完整 URL。 +- **常见问题 Q/A 太挤**。粗体问题和灰色答案之间只有 4pt 间距，密度过高。间距加到 8pt + lineSpacing 2，每条整体 padding 9 → 11，可读性提升。 + +## 安装 + +**老用户**：什么都不用做。下次启动 OpenLess 会自动检查更新。 + +**新用户**：到 [Releases](https://github.com/appergb/openless/releases) 下载 zip，解压拖到 `/Applications`，跑一次： + +```bash +xattr -dr com.apple.quarantine /Applications/OpenLess.app +``` + +之后双击启动。