feat: add macOS audio setup and mic recovery in FAQs#16
Open
WhatDamon wants to merge 3 commits into
Open
Conversation
审阅者指南在 FAQ 中新增了 macOS 专用的疑难解答和音频设置说明，与现有的 Windows 内容并列，包括 BlackHole 驱动安装指引，以及在简体中文、英文和繁体中文文档中关于手动选择麦克风/输入设备的说明。 FAQ 中 macOS 音频疑难解答步骤流程图flowchart TD
A[macOS 用户：无声音或麦克风问题] --> B{问题类型？}
B --> C[连接后没有声音]
B --> H[退出后内建麦克风无法使用]
C --> D{是否已安装 BlackHole 驱动？}
D -->|否| E[安装 BlackHole 驱动]
E --> F[打开 系统设置/系统偏好设置 > 声音 > 输入]
D -->|是| F
F --> G[将输入设备设置为 BlackHole]
H --> I{是否已安装 switchaudio_osx？}
I -->|未安装或应用异常退出| J[打开 系统设置/系统偏好设置 > 声音 > 输入]
J --> K[将输入设备设置为内建或设备麦克风]
I -->|已安装| L[正常退出后麦克风应自动恢复]
文件级变更
技巧与命令与 Sourcery 交互
自定义使用体验访问你的 控制台 以：
获取帮助Original review guide in EnglishReviewer's GuideAdds macOS-specific troubleshooting and audio setup instructions alongside existing Windows content in the FAQ, including guidance for BlackHole driver setup and manual microphone/input selection across Simplified Chinese, English, and Traditional Chinese documentation. Flow diagram for macOS audio troubleshooting steps in FAQflowchart TD
A[macOS user: No audio or mic issue] --> B{Issue type?}
B --> C[No audio after connecting]
B --> H[Builtin mic not working after exit]
C --> D{BlackHole driver installed?}
D -->|No| E[Install BlackHole driver]
E --> F[Open System Settings/System Preferences > Sound > Input]
D -->|Yes| F
F --> G[Set input device to BlackHole]
H --> I{switchaudio_osx installed?}
I -->|No or app exited abnormally| J[Open System Settings/System Preferences > Sound > Input]
J --> K[Set input device to builtin or device microphone]
I -->|Yes| L[Mic should auto revert after normal exit]
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
There was a problem hiding this comment.
Hey - 我发现了 3 个问题
面向 AI 代理的提示
Please address the comments from this code review:
## Individual Comments
### Comment 1
<location path="src/docs/faq.md" line_range="83" />
<code_context>
+
+请确保 BlackHole 驱动已正确安装！
+
+若未安装 `switchaudio-osx` 您需要手动在 「系统设置」/「系统偏好设置」>「声音」>「输入」改为 BlackHole
+
+
</code_context>
<issue_to_address>
**suggestion (typo):** 建议在条件从句后添加一个逗号，使中文语句更加通顺自然。
在“若未安装 `switchaudio-osx`”后添加逗号（即“若未安装 `switchaudio-osx`，您需要手动在……”），会更符合标准书面中文的习惯，也能提升可读性。
```suggestion
若未安装 `switchaudio-osx`，您需要手动在 「系统设置」/「系统偏好设置」>「声音」>「输入」改为 BlackHole
```
</issue_to_address>
### Comment 2
<location path="src/zh-TW/docs/faq.md" line_range="81" />
<code_context>
+
+請確保 BlackHole 驅動已正確安裝！
+
+若未安裝 `switchaudio-osx` 您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
+
+
</code_context>
<issue_to_address>
**suggestion (typo):** 建議在條件子句後加上一個逗號，以改善中文語句的語法與流暢度。
建議在「若未安裝 `switchaudio-osx`」後加逗號：「若未安裝 `switchaudio-osx`，您需要手動在……」，更符合書面中文的自然語氣。
```suggestion
若未安裝 `switchaudio-osx`，您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
```
</issue_to_address>
### Comment 3
<location path="src/zh-TW/docs/faq.md" line_range="83" />
<code_context>
+
+若未安裝 `switchaudio-osx` 您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
+
+
+
+## 退出軟體後裝置自備麥克風無法使用
</code_context>
<issue_to_address>
**suggestion (typo):** 「設備」一詞與前面相關標籤中使用的「裝置」不一致。
前面的標籤是「輸入裝置」/「輸出裝置」，這裡也建議改成「輸入裝置」，以維持術語的一致性。
```suggestion
```
</issue_to_address>幫助我變得更有用！請在每條評論上點擊 👍 或 👎，我會根據你的回饋持續改進之後的審查品質。
Original comment in English
Hey - I've found 3 issues
Prompt for AI Agents
Please address the comments from this code review:
## Individual Comments
### Comment 1
<location path="src/docs/faq.md" line_range="83" />
<code_context>
+
+请确保 BlackHole 驱动已正确安装！
+
+若未安装 `switchaudio-osx` 您需要手动在 「系统设置」/「系统偏好设置」>「声音」>「输入」改为 BlackHole
+
+
</code_context>
<issue_to_address>
**suggestion (typo):** Consider adding a comma after the conditional clause for smoother Chinese grammar.
Adding a comma after “若未安装 `switchaudio-osx`” (i.e., “若未安装 `switchaudio-osx`，您需要手动在……”) would better align with standard written Chinese and improve readability.
```suggestion
若未安装 `switchaudio-osx`，您需要手动在 「系统设置」/「系统偏好设置」>「声音」>「输入」改为 BlackHole
```
</issue_to_address>
### Comment 2
<location path="src/zh-TW/docs/faq.md" line_range="81" />
<code_context>
+
+請確保 BlackHole 驅動已正確安裝！
+
+若未安裝 `switchaudio-osx` 您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
+
+
</code_context>
<issue_to_address>
**suggestion (typo):** Add a comma after the conditional phrase to improve Chinese grammar.
建議在「若未安裝 `switchaudio-osx`」後加逗號：「若未安裝 `switchaudio-osx`，您需要手動在……」，更符合書面中文的自然語氣。
```suggestion
若未安裝 `switchaudio-osx`，您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
```
</issue_to_address>
### Comment 3
<location path="src/zh-TW/docs/faq.md" line_range="83" />
<code_context>
+
+若未安裝 `switchaudio-osx` 您需要手動在 “系統設定”/“系統偏好設定”>“聲音”>“輸入”改為 BlackHole
+
+
+
+## 退出軟體後裝置自備麥克風無法使用
</code_context>
<issue_to_address>
**suggestion (typo):** “設備” is inconsistent with earlier use of “裝置” in related labels.
前面標籤是「輸入裝置」/「輸出裝置」，這裡也建議改成「輸入裝置」，以維持術語一致。
```suggestion
```
</issue_to_address>Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.
Contributor
Author
|
繁体中文可能需要更多检查：当前繁中翻译使用的是机翻，AI Review 不一定全面 |
Contributor
Author
|
@sourcery-ai title |
sourcery-ai
Bot
changed the title
WhatDamon
changed the title
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
1 participant
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.
Description
Brief description of changes
Type of Change
Checklist
Summary by Sourcery
在所有常见问题（FAQ）语言版本中，补充与现有 Windows 指南配套的 macOS 专用音频配置与故障排除步骤。
文档：
Original summary in English
Summary by Sourcery
Document macOS-specific audio configuration and troubleshooting steps alongside existing Windows guidance in all FAQ language versions.
Documentation: