译听 HearLingo · 支持与帮助
常见问题、安装指引与故障排查。
三步开始
① 安装扩展——推荐从 Chrome 应用商店 / Edge 加载项安装（自动更新）；离线包则打开 chrome://extensions（Edge 为 edge://extensions），开启「开发者模式」， 选择「加载已解压的扩展程序」指向解压目录。
② 运行伴侣程序——下载解压后双击 HearLingoService.exe（Windows）或运行 HearLingoService.app（macOS）。服务在后台静默运行，无窗口无弹窗，扩展会自动连接。
③ 打开支持的视频网站——悬浮球变绿即连接成功，字幕自动翻译并朗读。
安装问题
Windows 提示「已保护你的电脑」
首次下载、无长期安装记录的应用都会出现该提示，并非发现病毒。点击「更多信息」→「仍要运行」即可。
macOS 提示「无法打开 / 已损坏」
未签名应用的 Gatekeeper 提示。右键点 App →「打开」→「打开」；若提示「已损坏」， 在解压目录的终端中执行一次：xattr -cr HearLingoService.app
防火墙提示
允许即可——服务只在本机 127.0.0.1 上监听，外界无法访问。
常见问题
悬浮球是红色，「服务未连接」
伴侣程序未运行。重新双击 HearLingoService.exe / 运行 HearLingoService.app——不会弹出任何窗口（设计如此），几秒内悬浮球变绿。日志位于 %LOCALAPPDATA%\HearLingo\logs（Windows）或 ~/Library/Application Support/HearLingo/logs（macOS）。
没有声音 / 不开始朗读
浏览器自动播放策略要求页面有过交互才允许出声——在页面任意位置点击一次即可。 另外检查悬浮球面板与 popup 里的「总开关」是否打开。
为什么有的网站没反应？
YouTube / B站走字幕轨（可控制开关）；其余站点自动识别画面硬字幕（OCR，100% 本地）。 部分平台需登录后才能播放或提供字幕（Netflix 需订阅、小红书需登录播放、B站 AI 字幕需登录） ——属平台要求，非插件故障。
语速太快 / 太慢
队列落后时自适应语速会自动加速追赶（上限 2 倍）。可在 popup 里设置固定语速（0.5–2 倍） 或关闭自适应语速。
如何停止 / 升级伴侣程序
停止：popup 绿色状态旁的「停止」按钮。升级：先停止服务（运行中文件被锁定）， 再用新压缩包覆盖解压到原目录后重新运行——设置会保留。
端口冲突（8790）
端口 8790 被其他程序占用时服务无法启动——关闭占用程序，或修改 local-service/config.json 中的端口。
支持的站点
YouTube（含 Shorts）· B站（含番剧）· TED · X/Twitter · 小红书 · 红果短剧 · TikTok · Instagram · 抖音网页版 · Netflix（个别平台需登录/订阅）
问题反馈
问题与建议请通过 联系我们 反馈。
下载页：hq-i.com/tools/hearlingo · 隐私政策：hq-i.com/privacy