Wave 平台帮助技能用于解答与 Wave 平台相关的问题，涵盖录音设置、API 集成、Webhook、导出分享、套餐选择与故障排查等场景。
用途 该技能面向使用 Wave 进行通话、会议或讲座记录的用户，帮助其完成录音配置、将转录与摘要接入其他系统、接收会话完成的实时通知、把笔记导出到 Notion、Google Docs、OneNote 等工具，以及选择合适的套餐和排查常见问题。
主要能力 技能首先收集上下文：若存在 references/learnings.md 会先读取其中积累的平台知识，然后根据用户需求区分录音设置、API 集成、Webhook、导出分享、套餐选择、故障排查等方向，并进一步区分录音方式（移动应用、桌面应用、会议机器人、Chrome 扩展、Apple Watch 或多种方式）。若用户提示已包含足够上下文，则跳过收集步骤直接进入下一步。
技能会根据问题领域进行路由：在 Wave 与其他笔记工具之间选择时路由到 /sales-note-taker；复盘某次通话用于辅导时路由到 /sales-call-review；基于通话数据构建辅导计划时路由到 /sales-coaching；通用 CRM/工具集成（Zapier、iPaaS）时路由到 /sales-integration；否则直接回答。
技能可读取 references/platform-guide.md 获取完整平台参考（录音方式、定价、集成、Voice ID、导出选项和常见工作流），读取 references/wave-api-reference.md 获取 API 端点、认证、Webhook、速率限制和 OpenAPI 规范，并只使用相关章节回答，不倾倒完整参考。
使用方式 录音可靠性检查清单包括：确认录音方式与用例匹配（面对面用移动麦克风、系统音频用桌面端、预定虚拟会议用机器人）；iPhone 电话通话需确认 Phone Bridge 已启用且正常；会议机器人需确认日历集成已连接并开启自动加入；在重要通话前先用短录音测试。
API 集成模式包括：在 app.wave.co/settings/integrations/api 创建具有所需权限范围的令牌；注册 session.completed 事件的 Webhook 以获取实时通知；Webhook 触发后调用 GET /v1/sessions/{id}/transcript 获取带说话人分段的完整转录；存储原始 JSON 后归一化为通用模式。若发现参考中未覆盖的坑、变通方法或技巧，可追加到 references/learnings.md。
适用场景 包括销售团队为 Zoom 通话设置自动录音、将转录自动推送到 HubSpot、排查录音中途停止等问题。示例中，技能会引导完成会议机器人自动加入的日历集成、推荐 Teams 套餐（$7.50/用户/月）、说明团队共享工作区以及 Voice ID 训练；或说明 session.completed 的 Webhook 设置、获取转录的 API 调用，以及通过 Zapier 或自定义中间件推送到 HubSpot 通话活动，并提示速率限制和令牌范围。
限制与注意事项 以下内容为基于研究的尽力整理，可能已过时，尤其是套餐限制功能和集成相关的坑。移动端来电会终止正在进行的录音，且无恢复/追加能力，重要录音时应使用勿扰模式。免费层每月仅 30 分钟，Pro（年付 $11.67/月）实际是入门选择。API 令牌 1 年后过期，需设置提醒轮换，否则认证失败会静默中断管道。媒体 URL 1 小时后过期，需在获取签名 URL 后立即下载，不要缓存 URL 本身。速率限制为每令牌每分钟 60 次请求、每天 10,000 次（生产集成可申请更高），回填时使用 POST /v1/sessions/bulk（最多 50 个会话）。Voice ID 需要训练，说话人标注会随使用改善，早期录音可能未标注或标注错误。“卡在保存”是已知问题，可强制关闭后重开，录音通常已保存但处理可能延迟。导出到 OneNote 时格式会退化，应使用原生 OneNote 集成而非剪贴板。
故障排查 录音停止或只捕获几分钟：最常见原因是来电中断录音，也可能是电池优化杀死后台应用、存储已满或长录音时应用崩溃；建议重要录音前开启勿扰模式，Android 上将 Wave 排除电池优化，检查可用存储，超过 1 小时的通话先做短录音测试可靠性。
应用卡在“保存录音”或转录挂起：大录音处理需要时间、上传时网络中断或已知间歇性 bug；可等待 5-10 分钟，仍卡住则强制关闭重开，录音通常已保存在服务端，检查网络连接，若录音丢失联系 support@wave.co。
Webhook 触发但转录没有说话人标签：Voice ID 尚未针对这些说话人训练，或录音质量太低无法做说话人分离；Voice ID 会随使用改善，可在最初几次录音中手动标注说话人以训练模型，虚拟会议的会议机器人录音比移动麦克风录音有更好的说话人分离。
相关技能 /sales-note-taker 用于比较 AI 笔记工具或构建跨供应商的转录管道；/sales-call-review 用于复盘某次通话；/sales-coaching 用于构建消费通话数据的辅导计划；/sales-integration 用于通用 CRM/工具集成模式；/sales-do 是路由器，可将任何销售目标匹配到合适技能，安装命令为 npx skills add sales-skills/sales --skill sales-do。