FAQ · 05

常见问题与排错

约 2 分钟阅读 Apache-2.0 本文基于 v0.1.0（2026-11-01）

用起来最常撞的问题。按「它为什么不出卡」→「参数怎么调」→「数据安全」的顺序排。

01为什么它一句话都不提示

按可能性从高到低查：

1. 强度没达标：客套式疑问（「方便说一下吗」）会被负例抑制，静默不出卡——这是设计，不是故障。拿 examples/meeting_demo_input.txt 里标了预期的台词对照试。 2. 冷却闸在起作用：全局冷却 60 秒 / 同型冷却 180 秒内，同型疑问不再出卡。 3. 单场上限到了：默认一场最多 12 张。 4. 话术库没命中：命中规则但库里没有对应话术时，不出卡——没有出处的话术不硬编。注入你的知识库（kb 参数或 QUICKCUE_KB_FILE）后这类会出卡。 5. 工具没挂上：以宿主工具列表里真看到 cue.analyze 为唯一验收；配置文件绿灯不算。

02出卡太频繁 / 出得不对

现象	改哪
提示得太频繁	`global_cooldown_sec` 调大（60 → 120）
总量太多	`max_per_meeting` 调小（12 → 8）
提示得不对	疑问词表按行业增删；`banned` 黑名单加禁用词
改完怕改错	先跑宿主里的 `rules.validate` 校验结构

冷却时间调短会怎样？ 卡变多、噪音变多，通常第二次会议你就会把它关掉。默认值刻意保守，建议只往更严的方向调。

03支持哪些会议软件

QuickCue 不接音频、不依赖特定会议软件：它是 stdio MCP 工具，任何支持 MCP 的宿主（Claude Desktop、VS Code 等）都能挂。转写文本从哪来它不管——人工贴、ASR 引擎输出、会议软件导出都行。自动接会议软件音频属于后续路线，当前版本半自动（把台词喂给 cue.analyze）。

04数据存在哪、会不会联网

存哪：本地 .quickcue/ 目录（位置可用环境变量覆盖）。删除该目录即清除全部派生数据；不写系统目录、不留注册表项。
联网吗：判定全程零联网、零大模型调用、零 API key。
会上传吗：匿名分享默认关闭。开启后只上行三态评价、规则结构（不含内容）与可选的脱敏失败样例；对话原文、录音、转写文本、人名、公司、金额永不上行，脱敏先在你本机完成。随时可关，可查上行记录。

05能商用吗

能。Apache-2.0（附多租户服务限制附注）：自由使用、修改、分发，包括商业产品内使用；唯一限制是不得将本引擎作为多租户托管服务对外提供（见仓库 LICENSE 文件尾附注）。需要接入弈枢工作台或私有化部署，见官网「联系我们」。