音述AI曲风加载失败时需三步修复:先清除本地缓存(含IndexedDB等),再强制刷新声线注册服务(访问/reload接口并确认返回成功),最后通过桌面版高级调试指令/reset_style_map重建曲风-声线映射,完成后曲风菜单恢复19种风格并标注声线ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

音述AI曲风列表加载失败时,声线参数根本无法读取,界面卡在“正在加载曲风…”状态,所有生成按钮灰显,连基础普通话人声都调不出来——这说明本地缓存已损坏或远程风格索引服务异常,必须手动重置配置并强制刷新声线注册表。
清除损坏的本地缓存
打开音述AI客户端,按 Ctrl+Shift+I(Windows)或 Cmd+Option+I(macOS)调出开发者工具 → 切换到 Application 标签页 → 左侧选中 Clear storage → 点击右侧“Clear site data”按钮。
这一步会清空包括 IndexedDB、Cache Storage 和 LocalStorage 在内的全部本地数据,【务必确认当前未保存任何未导出的草稿】,否则将永久丢失。
强制重载声线注册服务
关闭当前窗口,在浏览器地址栏直接输入:https://api.yinshu.ai/v3/speaker/reload?force=1 → 回车访问 → 页面返回 {"status":"ok","reloaded":true,"count":27} 即表示成功。
如果返回 403 或空白页,说明你当前登录态已过期,需先退出账号重新登录再试。该接口仅对已认证用户开放,未登录状态下直接访问无效。
重建曲风-声线映射关系
第一步:启动音述AI桌面版(网页版不支持此操作);
第二步:在主界面右上角点击头像 → 选择「高级调试」→ 输入指令:/reset_style_map → 按回车;
第三步:等待终端输出 [✓] Style-speaker mapping rebuilt in 1.2s 后,关闭并重启客户端。
这三步完成后,曲风下拉菜单将重新加载全部19个可用风格,每个风格后缀自动标注对应声线ID(如“流行|女声_03”“古风|男声_17”),点击即可实时预听音色样本。


















