用途
custom-sounds 用于列出或校验 Pushover 通知声音，包括 Pushover 内置声音以及当前账号自定义上传的声音。它通过 Pushover 的 /1/sounds.json API 完成查询，适合在需要选择或依赖某个自定义声音之前进行确认。
主要能力
该技能通过 TypeScript 核心 pushover_core.ts 的 sounds 子命令提供以下操作：
sounds list：列出声音，输出格式为 名称<TAB>标签。sounds has <name>：判断指定声音是否存在，若存在则退出码为 0。sounds resolve <name...>：按给定顺序返回第一个存在的声音。
示例命令：
env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" sounds list # name<TAB>label
env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" sounds has piano # exit 0 if present
env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" sounds resolve piano pianobar # echo first that exists
使用方式与注意事项
资料中标注的已验证要点（2026-05-30）包括：
- Pushover 会静默接受无效的声音名称，不会返回 API 错误。因此在依赖某个自定义声音之前，应始终先使用 resolve 或 has 进行校验；否则拼写错误会静默回退到用户的默认声音。
- 示例中 piano 是该账号上的自定义声音，pianobar 是内置声音。
- 自定义声音按应用令牌区分，因此需要传入
--app main|test来查询正确的应用。
适用场景
适用于需要在发送 Pushover 通知前确认声音名称有效、在多个候选声音中选择第一个可用项，或枚举当前账号可用声音（内置与自定义）的场景。
限制
- 由于 Pushover 对无效声音名不报错，必须依赖本技能的校验结果，不能仅凭 API 调用成功判断声音有效。
- 自定义声音与具体应用令牌绑定，查询时需指定正确的应用。
- 该技能被描述为自我进化型：使用中若发现说明有误、参数漂移或需要变通方案，会立即修正文件；但仅针对真实、可复现的问题更新，不针对推测性问题。
执行后反思
技能完成后需检查：声音上传是否成功，并且能在真实通知中被选择；若报告成功但声音缺失，说明校验有误。同时需确认响度与格式约束是否被遵守；若设备拒绝了该声音，应修正来源处理流程。仅在问题真实且可复现时才更新。