常见问题

常见问题

配置门槛和数据边界都在这里。

Fn 和 Fn Fn 有什么区别?

Fn 是 Voice Input,把说的话写到当前光标。Fn Fn 唤起 Voice Agent,按语音要求处理请求。不选文字也能提问、起草内容或继续对话;选中文字可改写或翻译。

使用 Voice Agent 必须先选中文字吗?

不需要。直接连按两次 Fn 就能提问、起草内容或继续对话,在桌面、没有输入光标时也能启动。要改写或翻译已有文字时,再选中它。提问的结果显示在回答卡片;起草内容会尝试写入原输入位置,没有可写目标时保留结果供复制。选区及其他上下文是否发送,由 App 的隐私设置控制。

SayKuku 支持什么系统?

需要 macOS 14 或更新版本。它是原生 Mac 应用,不是 iPhone 或 Windows 输入法。

要自己的 API Key 吗?会收费吗?

SayKuku App 免费;使用时需配置自己的阿里云百炼 Qwen API Key,模型调用由你的账号计费。按当前北京地域单价,默认实时模型 1 小时音频输入约 0.15 元,输出文字和其他请求另计;地域、模型及免费额度会影响实际费用。以阿里云模型价格和账单为准。

会开源吗?

源代码已在 GitHub 公开,采用 Apache-2.0 许可。

必须联网吗?

语音识别和 Agent 处理都调用 Qwen 云端服务,需要网络。麦克风测试只检测本机音量。

Fn 按了没反应怎么办?

检查麦克风和辅助功能权限,以及 macOS「按下 fn 键时」的系统动作是否与 SayKuku 冲突。也可以在 App 设置中配置普通全局快捷键。权限刚变更时尝试重新打开 App。

所有 App 都能写回吗?

SayKuku 会尽量写入原输入位置并核对目标,但不同 App 的文本控件行为不完全相同。请在发送重要内容前检查结果;若写回失败,记录 App、macOS 版本及复现步骤有助于排查。

我的录音和历史保存在哪里?

历史、记忆和纠正建议保存在这台 Mac 的 Application Support/SayKuku 目录;开启保存后的录音保存在其中的 Audio 文件夹。API Key 保存在本机钥匙串。详情见隐私说明。

会读取整个屏幕或密码吗?

Voice Agent 可按设置读取当前窗口可见文字,最多 2000 字;语音输入不读取。密码框与已知密码管理器受保护;无痕窗口不单独识别。详情见上下文与权限说明。

可以不保存新历史吗?

可以,在「设置 → 历史」选择「不保存」。这不会自动清除此前保存的内容。

官网现在能下载吗?

可以。请从官网下载页获取经过签名和公证的 DMG,核对版本号,不要转发来历不明的安装包。