使用指南
从一句话开始。
准备一台运行 macOS 15 或更新版本的 Mac，以及你自己的阿里云百炼 Qwen API Key。
1. 连接语音服务
在阿里云百炼北京控制台或新加坡控制台创建并管理 API Key。选择与 Key 对应的地域，在 SayKuku 的首次设置中填入。不同地域的 Key 和服务不能混用。模型调用可能产生费用，价格与额度以阿里云当时的页面为准。
如果你使用业务空间，请按应用设置填写对应空间 ID；它会影响实时听写的连接方式。API Key 存放在系统钥匙串中。
2. 授予必要权限
在 macOS 系统设置中允许 SayKuku 使用麦克风和辅助功能。麦克风用于你主动启动的语音输入、Voice Agent 与本机音量测试；辅助功能用于识别 Fn 手势、读取选区和将文字写回当前 App。SayKuku 不申请输入监控权限。
Fn 手势若与系统「按下 fn 键时」的动作冲突，请按 App 引导调整，或在设置里配置普通全局快捷键。权限变更后可能需要重新打开 App。
3. 在当前光标处听写
把光标放进输入框，按 Fn 说话。可以在设置中选择按住说，或单击开始、再次单击结束。识别结果会尝试写回原光标位置；具体文本控件的写回行为可能有差异，请在正式内容发送前检查。
4. 用语音改写选中文字
选中一段文字，连按两次 Fn，然后说「改得更简洁」或「翻成英文」。SayKuku 会结合选区及你允许的上下文处理请求。写回前会检查目标；涉及离开当前 App 的外部动作会要求确认。
5. 管理记忆与历史
在记忆页加入常用人名、项目和术语。听写后的错词可以在浮层里确认后记住。历史、记忆与可选录音保存在本机；如果不想保存新历史，可在「设置 → 历史」中选择「不保存」。本地 JSON 与 WAV 文件没有额外加密。