‹ 项目列表通话 Bot
体验原型 下载 PDF下载 MD 包

通话 Bot 需求文档

v2.2 · 简版开发规格 · 2026-10-22

页面列表 42

通话页面11

既有业务页面8

异常界面23

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秒窗口内恢复原通话与静音;超时结束并记原因。
写入未知先核对权威结果;查询失败保留未知,不重复写入。
部分成功已成功步骤保留,只重试失败步骤。
结束与刷新新通话不累加旧计时;刷新补中断记录,不重放。
历史与安全原账户保存、迟到更新、保存失败重试/导出;清理音频资源。

完整验收清单 · 58条 ↗ 技术参考存档 ↗

负责方交付要求
硬件 / 宿主真实键事件去重、窗口唤回、旧播音互斥、输入输出设备状态。
网页前端通话状态与回执展示;复用原Chatbot、路由和自选store;上线移除场景面板与固定示例。
语音 / 业务后端火山短期鉴权与音频链路;final转写交原Chatbot;原工具单一写入与operation_id核对。
历史 / QA记录归原账户与原聊天,幂等保存、迟到更新;实体键、权限、音频释放与断电真机验收。

56项测试验证的是预览及复用代码路径,不能代替真实硬件、音频和生产账户验收。默认阈值与详细数据契约见技术参考,接入前对齐供应商协议。