通话 Bot 需求文档
v2.2 · 简版开发规格 · 2026-10-22
通话页面11
既有业务页面8
异常界面23
EX01未登录 / 登录过期
EX02账户无通话权限
EX03设备离线 / 未绑定
EX04麦克风权限被拒绝
EX05麦克风被占用 / 无输入设备
EX06当前宿主不支持语音
EX07其他窗口已有通话
EX08开始时无网络
EX09连接超时
EX10语音服务繁忙 / 额度不足
EX11通话中短暂断网
EX12通话中设备拔出
EX13通话中登录失效
EX14服务异常 / 超过通话时限
EX15持续无声 / 无有效转写
EX16扬声器不可用 / 播放受限
EX17证券同音 / 市场不明确
EX18不支持的指令 / 识别不完整
EX19页面无权限 / 路由加载失败
EX20添加自选明确失败
EX21自选请求超时,结果未知
EX22复合指令部分成功
EX23通话记录保存失败
01 范围与主流程
单击设备麦克风键 → 进入通话 → 说出指令 → 复用原有页面跳转或自选股工具 → 挂断后在当前聊天留下记录。
本期做桌面工作台通话;手机业务沿用小程序,仅预留通话页。证券交易、任意桌面代操作、录音回放不在本期。
02 设备按键
仅红框麦克风键用于唤起,旁边的斜箭头键保持原功能。

| 当前状态 | 单击后的行为 |
|---|---|
| 未通话且条件满足 | 激活原窗口,进入连接;保留业务页与草稿。 |
| 正在连接 / 通话中 / 已收起 | 展示或展开同一通话,不新建、不挂断、不改变静音。 |
| 登录、权限或设备条件不满足 | 显示对应恢复入口;条件恢复后重新检查。 |
| 通话已结束 | 在当前聊天发起新通话,旧记录保留。 |
| 后台 / 托盘 / 完全退出 | 由硬件与宿主实现窗口激活;完全退出唤起须真机确认。 |
03 逐页内容
| 页面 | 名称 | 页面保留什么 | 点击后 / 核心规则 |
|---|---|---|---|
| P01 | 通话入口 | 开始按钮、设备麦克风键、少量指令示例 | 一次点击进入连接;不跳业务页,不发送或清空草稿。 |
| P02 | 连接中 | 连接状态、取消按钮 | 连接成功才开始计时;重复按键不新建连接;15秒超时可重试。 |
| P03 | 通话主面板 | 状态、时长、静音、打断、结束、指令和回执 | 一次处理一条业务指令;页面成功与否以实际执行结果为准。 |
| P04 | 收起通话 | 状态、时长、展开、静音、结束 | 收起或切换页面不挂断;设备再次按键展开同一通话。 |
| P05 | 业务页面 | 复用现有资讯、自选等8个模块 | 只有通过白名单与权限校验的导航可执行;查看历史页面不重放指令。 |
| P06 | 自选操作 | 股票简称、完整代码、市场、分组、操作状态 | 既有工具只写一次;原已存在不重复添加;超时先核对。 |
| P07 | 证券澄清 | 有效候选的简称、代码与市场;取消按钮 | 未确认前不写入;不支持的候选禁用;挂断或30秒无选择则取消。 |
| P08 | 通话记录 | 起止时间、时长、结束原因、实际结果摘要 | 成功、失败、取消、待核对分别统计;下一通重新计时。 |
| P09 | 记录详情 | 原始指令、助手回复、每项操作回执 | 点击展开自动露出内容;只读查看,不重试历史写入。 |
| P10 | 异常恢复 | 一个错误标题、原因、主恢复按钮、必要替代入口 | 不重复放相同按钮;未恢复外部条件不能假装恢复通话。 |
| P11 | 小程序预留 | 保留未来入口位置与设计说明 | 手机业务仍在原小程序,本期不开发手机H5或小程序通话。 |
这些是页面或面板状态,不要求新增11个路由。P05、P06继续复用现有导航、自选接口和store。
04 异常恢复
每个异常只保留原因、一个主恢复动作和必要替代入口。外部条件恢复后再检查;恢复通话和重试业务是两回事。
接通前:登录、权限、设备、窗口冲突 · 7
| 条件 | 页面标题 | 主按钮 |
|---|---|---|
| 未登录 / 登录过期 | 请先登录 | 重新检查 |
| 账户无通话权限 | 当前账户暂不能通话 | 重新检查 |
| 设备离线 / 未绑定 | 未连接通话设备 | 重新检查 |
| 麦克风权限被拒绝 | 无法使用麦克风 | 重新检查 |
| 麦克风被占用 / 无输入设备 | 麦克风不可用 | 重新检查 |
| 当前宿主不支持语音 | 当前环境无法通话 | 改用文字 |
| 其他窗口已有通话 | 另一窗口正在通话 | 重新检查 |
连接中:无网络、超时、服务不可用 · 3
| 条件 | 页面标题 | 主按钮 |
|---|---|---|
| 开始时无网络 | 网络未连接 | 重试连接 |
| 连接超时 | 连接超时 | 重试连接 |
| 语音服务繁忙 / 额度不足 | 通话服务暂不可用 | 重试连接 |
通话中:断网、设备断开、无声或播放失败 · 6
| 条件 | 页面标题 | 主按钮 |
|---|---|---|
| 通话中短暂断网 | 连接中断,正在重连 | 立即重连 |
| 通话中设备拔出 | 设备已断开 | 重新连接 |
| 通话中登录失效 | 登录已过期,通话已结束 | 重新检查 |
| 服务异常 / 超过通话时限 | 通话已中断 | 再次通话 |
| 持续无声 / 无有效转写 | 没有听清 | 继续通话 |
| 扬声器不可用 / 播放受限 | 暂时无法播放声音 | 重试播放 |
操作中:目标不明、失败、未知与部分成功 · 6
| 条件 | 页面标题 | 主按钮 |
|---|---|---|
| 证券同音 / 市场不明确 | 请确认证券 | 取消本次指令 |
| 不支持的指令 / 识别不完整 | 这条指令暂不能执行 | 重新说 |
| 页面无权限 / 路由加载失败 | 页面未打开 | 继续通话 |
| 添加自选明确失败 | 添加自选失败 | 继续通话 |
| 自选请求超时,结果未知 | 添加结果未确认 | 核对自选列表 |
| 复合指令部分成功 | 已加入自选,页面未打开 | 打开自选股 |
结束后:记录保存失败 · 1
| 条件 | 页面标题 | 主按钮 |
|---|---|---|
| 通话记录保存失败 | 通话记录尚未保存 | 重试保存 |
| 不能省略的规则 | 处理方式 |
|---|---|
| 连接/重连 | 连接超时15秒;断线恢复最多15秒。恢复保留原静音与计时,超时结束。 |
| 提交前/提交后 | 未提交可取消;已提交不能承诺撤销。超时是结果未知,不是明确失败。 |
| 未知结果 | 先查询operation_id权威状态,再刷新自选;查询失败或仍未知时不重发。 |
| 部分成功 | 保留已完成步骤,只补未完成步骤;查看页面不重复添加自选。 |
| 页面刷新/异常关闭 | 补中断记录,不重连、不重放。正式版由后端心跳和历史服务兜底。 |
| 保存失败 | 保留当前记录,允许重试或导出;未保存不能显示已保存。 |
05 逐页建议与处理结果
| 页面 | 建议 | 本轮结果 | 接入时仍需落实 |
|---|---|---|---|
| P01 通话入口 | 保留单一开始入口与示例;草稿不因按键或挂断被清空。 | 已修复 | 正式版复用原Chatbot草稿与所属对话。 |
| P02 连接中 | 取消后屏蔽晚到成功,不留成功通话记录。 | 已验证 | 真机验证首次系统授权及连接15秒超时。 |
| P03 通话主面板 | 只显示一个主状态;成功以回执为主;去掉第二处“正在执行”。 | 已精简 | 临时转写与最终指令分开;原自选hook为通话增加可选silent通知参数,其他调用保留默认提示。 |
| P04 紧凑通话 | 异常时收起并隐藏不可用输入,完整露出回执与结束入口;重连保留静音及计时。 | 已修复 | 宿主跨业务路由持有同一媒体会话。 |
| P05 业务页面 | 移除“已打开某页”的重复标题;原导航与自选store继续复用。 | 已修复 | 实际加载失败与权限拒绝要分开;原页面不在本轮重做。 |
| P06 自选结果 | 查询失败不能拿缓存判断成功;未知结果先核对;部分成功只补失败步骤。 | 已修复 | 原后端补operation_id状态查询与幂等,前端不得二次写入。 |
| P07 证券澄清 | 不支持的候选禁用;取消后不再显示理解中;异步返回不能复活已挂断指令。 | 已修复 | 候选必须来自既有证券搜索,不用模型猜市场。 |
| P08 通话摘要 | 取消和失败分开;刷新中断补一条记录,已提交写入晚到结果更新原记录。 | 已修复 | 正式记录归属账户和聊天,按原历史保留/删除规则落库。 |
| P09 展开详情 | 展开时滚动露出内容;未知回执使用问号,不显示失败叉号。 | 已修复 | 真机读屏、长记录、分页与跨账户隔离仍需验收。 |
| P10 异常面板 | 删除重复“改用文字”和结束按钮;核对失败给出明确下一步。 | 已修复 | 登录、权限和设备条件需读取真实结果,不能用前端开关代替。 |
| P11 小程序预留 | 明确预留范围,避免将响应式网页视为手机交付。 | 已明确 | 后续单独评审平台能力和页面,不纳入本期。 |
| 场景验证面板 | 只供评审;业务页面不放实现说明;条件恢复后仍由用户检查。 | 已保留边界 | 生产构建移除本面板、固定指令与模拟API。 |
| PRD阅读页 | 默认仅显示42项页面名称;单项或全部展开后显示配图卡片;顶部可体验原型、下载PDF与MD包。 | 已简化 | 研发以简版规则及完整验收清单为准,v2.0仅作参考。 |
06 验收与开发交接
| 必验项 | 通过标准 |
|---|---|
| 设备入口 | 只绑定图中麦克风键;连按只展开;其他按键不变。 |
| 必要拦截 | 未登录、无权限或无设备时不录音、不显示正在听。 |
| 连接取消 | 取消后旧回调无效;未接通不生成成功通话。 |
| 正常控制 | 静音、打断、结束有效;收起与跳页保持同一通话。 |
| 页面跳转 | 复用8个白名单目标,权限/加载失败不报成功。 |
| 加入自选 | 同一指令只写一次;原有分组不被静默更改。 |
| 目标澄清 | 代码与市场未明确不写;取消/挂断使旧确认失效。 |
| 断线恢复 | 15秒窗口内恢复原通话与静音;超时结束并记原因。 |
| 写入未知 | 先核对权威结果;查询失败保留未知,不重复写入。 |
| 部分成功 | 已成功步骤保留,只重试失败步骤。 |
| 结束与刷新 | 新通话不累加旧计时;刷新补中断记录,不重放。 |
| 历史与安全 | 原账户保存、迟到更新、保存失败重试/导出;清理音频资源。 |
| 负责方 | 交付要求 |
|---|---|
| 硬件 / 宿主 | 真实键事件去重、窗口唤回、旧播音互斥、输入输出设备状态。 |
| 网页前端 | 通话状态与回执展示;复用原Chatbot、路由和自选store;上线移除场景面板与固定示例。 |
| 语音 / 业务后端 | 火山短期鉴权与音频链路;final转写交原Chatbot;原工具单一写入与operation_id核对。 |
| 历史 / QA | 记录归原账户与原聊天,幂等保存、迟到更新;实体键、权限、音频释放与断电真机验收。 |
56项测试验证的是预览及复用代码路径,不能代替真实硬件、音频和生产账户验收。默认阈值与详细数据契约见技术参考,接入前对齐供应商协议。









































