使用指南
从一句话开始。
SayKuku App 免费，安装包 5.5 MB。准备一台运行 macOS 14 或更新版本的 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，说出你的要求
无需选中文字，连按两次 Fn 就能启动 Voice Agent。可以直接问「Swift 是什么」，或在输入框里说「帮我写一句回复，说明周四上午可以」。也可以继续上一轮对话；在桌面、没有输入光标时同样能启动。
要修改已有内容时，选中一段文字，再连按两次 Fn，说「改得更简洁」或「翻成英文」。SayKuku 会结合选区及你允许的上下文处理请求。提问的结果显示在回答卡片；起草内容会尝试写入原输入位置，没有可写目标时保留结果供复制。写回前会检查目标；运行快捷指令需确认，打开链接或搜索网页时，若用到了不可信上下文，也需确认。
5. 管理记忆与历史
在记忆页加入常用人名、项目和术语。听写后的错词可以在浮层里确认后记住。历史、记忆和纠正建议保存在本机的应用数据目录（Application Support/SayKuku），可选录音保存在其中的 Audio 文件夹。如果不想保存新历史，可在「设置 → 历史」中选择「不保存」。
6. 查看使用统计
从侧栏「使用统计」或 ⌘4 打开，按日、周、月查看听写字数、次数、说话时长、活跃日、每日趋势、常用应用和 Voice Agent 用途。只有确认写入的听写计入输入量，确认撤销会调整总量。
统计只保存本地汇总，不包含文字或音频，也不回填旧历史。可在「设置 → 隐私」独立暂停或清除；删除历史不会影响统计。
7. 找到对应设置
- 通用：语言、启动与自动更新。
- 快捷键：Fn 手势、全局快捷键与触发状态。
- 音频：麦克风测试与录音提示音。
- 语音输入与语音 Agent：各自的输出偏好和行为。
- 记忆：常用词、领域提示与纠正学习；历史：保存期限和录音保存。
- 隐私：系统权限、Agent 上下文与使用统计；Qwen：API Key、地域与模型配置。
- 关于：版本信息、检查更新、官网与源代码入口。