v2.0 技术参考存档。当前交互、页面建议与验收以 v2.1 简版 PRD 为准。
FinSights 需求文档
交互原型 ↗
PRD / v2.0 / 2026-10-22

FinSights 通话 Bot
产品需求与业务流程

硬件麦克风图标实体键 · 网页通话 · 复用现有业务能力

10 个本期页面 / 状态 + 23 类异常 + 1 个小程序预留页8 个既有导航目标48 条验收用例
本次确认单击硬件麦克风图标实体键,直接进入通话功能。

01 业务目标与交付范围

用户单击设备上的「麦克风图标实体键」,直接进入 FinSights 通话。说出指令后,由现有 Chatbot 完成页面跳转或自选股操作;挂断后,在同一对话中留下通话时长、操作摘要和可展开的通话内容。

项目本版定义
文档状态v2.0 开发评审稿;确认需求与建议默认行为分开标注。
适用终端本期:FinSights 硬件终端配套的桌面 / Electron 网页工作台。手机业务沿用现有小程序,通话页面仅预留,不新增手机 H5 交付。
目标用户正在查看行情、资讯或自选股,希望用语音代替寻找入口和点击操作的已登录用户。
首期能力硬件键唤起、实时通话控制、模块导航、单只股票加入自选、执行回执、通话记录。
不纳入本期证券交易、资金操作、任意桌面自动点击、全站表单代填、录音回放、重做现有业务页面。
交付组成本网页 PRD、逐页规格、硬件按键状态表、接口复用清单、建议数据契约、验收用例和已完成交互原型。
当前实现边界原型使用模拟语音与业务数据,未连接实体按键、麦克风或火山实时语音;通话记录仅保存在当前浏览器。
单击硬件键→直达通话→说出指令→复用现有工具→反馈结果→挂断留记录

02 已确认要求与评审默认值

编号要求 / 决策状态开发含义
D01单击硬件麦克风图标实体键,直接进入通话用户已确认不先进入录音、朗读、模式选择或介绍页面。
D02通话中再次单击实体键,只唤回 / 展开当前通话本版建议默认值避免重复建连和误挂断;评审可修改,不能当作用户已确认的二次按键行为。
D03结束通话使用明确的网页「结束通话」按钮本版建议默认值不将单击、双击或长按实体键绑定为挂断,除非另行确定。
D04已登录、已有权限且应用运行时,一次按键即可开始连接P0 验收要求首次系统权限和登录拦截是必要例外,不应额外加业务确认弹窗。
D05已提交业务动作按实际结果收尾;未提交动作在挂断后取消沿用当前原型规则挂断不等于撤销已生效的自选写入,不允许旧事件启动下一通。
D06本期先复用既有单指令;复合指令列为联调扩展建议范围 / P1原型能演示「加入自选再打开页面」,真实后端顺序编排尚需验证。
D07正式通话记录绑定账户与原有对话正式版需求,尚未实现浏览器 localStorage 仅是原型验证手段,不能直接视为正式历史服务。

03 硬件麦克风图标实体键联动

以用户提供的设备图为准:绑定红框内的灰色方形麦克风图标实体键。该键位于中心显示屏右侧、右侧黑色扬声器开孔的右边,右侧相邻键为斜向上箭头图标。本期单击该键直接唤起通话;其他键不新增通话绑定。点击这里验证设备唤起 ↗按键只作为统一入口,不另建语音识别、意图识别或业务执行逻辑。

设备按键定位图:红框内的麦克风图标实体键用于单击唤起通话
点击红框麦克风键进入交互预览。用户提供的设备布局图。唯一绑定目标为红框内麦克风图标键;右侧相邻的斜箭头键保持原功能。
按键定位确定要求
绑定目标用户设备图红框内的麦克风图标灰色方键。
已确认动作单击该实体键,直接唤起通话功能;不先打开录音、朗读或模式选择。
非目标键右侧相邻斜箭头键及其余按键保持既有功能,不新增通话映射。
联调边界设备实际键码 / 驱动事件尚未提供;应用层 VOICE_CALL 名称仅为逻辑规范,不是已核实的固件事件。
当前状态单击硬件键后的页面与行为语音 / 业务规则
应用运行、未通话、已登录将工作台置前,展开 Chatbot 通话面板,进入连接中保留右侧正在看的业务页面;已有权限时立即连接。
通话面板被收起展开当前通话面板,保留计时和对话不生成新 call_id,不重新获取会话。
正在连接显示同一连接进度重复按键不并发创建连接,不重置超时计时。
正在听 / 静音中聚焦同一通话面板不切换静音状态;麦克风仍以页面按钮状态为准。
正在执行 / 正在回复聚焦并展示当前执行或播报状态不重复提交上一条指令,不暗中打断正在播报的内容。
通话已结束 / 浏览历史在当前对话发起新通话旧记录保留;新通话重新计时,使用新的 call_id。
未登录 / 会话失效将应用置前并进入现有登录流程,保留进入通话的意图认证恢复后进入通话准备;若系统要求新的用户手势,提供「继续通话」,不绕过权限。
没有麦克风权限显示系统授权或 P10 权限引导不显示「正在听」;未取得权限不上传音频。
应用后台 / 托盘中由桌面宿主激活现有窗口,再执行同一进入通话意图不得新建多个工作台窗口或通话实例。
应用完全退出取决于硬件 / 宿主是否支持启动应用列为 HW01 联调确认项;未验收前不承诺完全退出也能单击唤起。

应用层接入约束

04 页面清单与逐页规格

以下“页”同时包括页面、浮层和内嵌状态。P02 / P03 / P04 / P08 / P09 不应据此各建一个新业务 URL。P11 为小程序设计预留,不属于本期手机 H5 或小程序通话开发范围。

页面 / 状态类型优先级开发动作
P01 Chatbot 通话入口复用现有页面,新增通话入口P0见下方规格与关联验收
P02 通话准备与连接中Chatbot 内的面板状态,不新增业务路由P0见下方规格与关联验收
P03 实时通话主面板新增通话界面,承载于现有 ChatbotP0见下方规格与关联验收
P04 收起通话与悬浮控件全局持续控件,不是独立页面P0见下方规格与关联验收
P05 业务页面联动8 个既有目标模块,全部复用P0见下方规格与关联验收
P06 加入自选与操作结果复用自选页面与接口,新增语音回执联动P0见下方规格与关联验收
P07 股票与意图澄清复用现有澄清能力的界面适配P0见下方规格与关联验收
P08 挂断后的通话记录摘要现有聊天消息流中的新增记录类型P0见下方规格与关联验收
P09 展开通话内容记录内部展开区域,不新建独立路由P0见下方规格与关联验收
P10 权限、失败与恢复现有登录 / 权限页及通话错误面板P0见下方规格与关联验收
P11 小程序通话预留页设计预留;手机业务仍在既有小程序预留,不在本期实现见下方规格与关联验收
P01

Chatbot 通话入口

复用现有页面,新增通话入口 · P0

进入条件:网页「开始通话」;或用户设备图红框内的麦克风图标实体键从任意业务页唤起。

页面内容

区域 / 字段页面要求
标题区沿用现有 Chatbot 标题与历史入口;新增电话图标 /「开始通话」。保留原输入框、模式、附件与历史功能。
首次空态简短标题「和 FinSights 通话」、开始按钮与少量指令示例,不重复列能力说明。正式版不显示「模拟说话」。
右侧业务区保留用户当前页面和未提交编辑;通话唤起本身不切换资讯 / 自选等业务路由。
权限状态由现有鉴权 / 设备绑定 / 会员能力决定入口可用性;系统麦克风状态在实际发起时核对。

操作与去向

操作行为与去向
开始通话 / 硬件单击统一发出进入通话意图 → P02;已有通话则转 P03 / P04。
历史通话在所属对话中定位 P08,查看记录不启动麦克风。

核心规则:同一用户在一个工作台实例中仅允许一条活跃通话。物理键是主入口,网页电话按钮是同等能力的备用入口。

对应验收:AC01、AC02、AC03、AC04、AC35

现有交互原型参考,尚未接入硬件键与真实语音
现有交互原型参考,尚未接入硬件键与真实语音 · 点击看大图
P02

通话准备与连接中

Chatbot 内的面板状态,不新增业务路由 · P0

进入条件:P01 或硬件键,且没有活跃通话。

页面内容

区域 / 字段页面要求
身份与状态FinSights 名称 / 头像,「正在连接」,加载状态;连接就绪前不显示「正在听」。
操作区「取消连接」始终可点;静音与打断按钮在连接期间禁用。
必要引导第一次由系统请求麦克风授权;登录失效、设备不支持或权限被拒进入 P10。
音频就绪确认上行采集、下行播放路径以及服务会话可用;系统自动播放受限时显示一次「启用声音」。

操作与去向

操作行为与去向
连接成功以服务端确认建立的时刻开始计时 → P03。
取消连接停止准备、释放已申请资源;回到原页面;不生成成功通话记录。
重复物理按键只展示当前进度,不重复申请资源。

核心规则:连接总超时建议 15 秒(评审阈值,非供应商保证),超时进入可重试错误。旧连接回调必须带代次 / call_id 核对,不能在取消后重新进入通话。

对应验收:AC03、AC05、AC06、AC07

P03

实时通话主面板

新增通话界面,承载于现有 Chatbot · P0

进入条件:连接成功;从 P04 展开;通话中单击硬件键。

页面内容

区域 / 字段页面要求
面板头部通话名称、真实连接状态、时长 mm:ss,以及收起按钮。
主状态正在听 / 正在操作 / 正在回复 / 已静音 / 正在恢复连接。文本与真实状态一致,不只依赖颜色。
实时对话区分用户语音最终转写与助手回复。临时转写用独立暂存样式,不作为已提交指令或最终记录。
操作回执每个动作显示目标、处理中 / 成功 / 失败 / 结果未确认;与当前指令关联。
控制区静音 / 取消静音、结束通话、打断回复、收起。结束按钮始终可见。
辅助文字输入复用现有 Chatbot 输入;发送规则仍按当前处理状态。原型的示例按钮只保留于演示版。

操作与去向

操作行为与去向
静音停止新的音频上传,清理未提交临时转写;不挂断、不撤销已提交业务操作。
取消静音恢复采集,回到可听取状态。
打断回复立即停止当前语音播放,保留完整文字和执行结果;不重复执行工具。
结束通话停止音频交互,进入 P08;尚未提交的动作取消,已提交动作继续确认结果。
新的用户指令只有语音最终结果满足提交条件时,生成一次 client_request_id 并进入既有 Chatbot。

核心规则:首期同一时刻只处理一条业务指令;正在执行时提示「正在处理,请稍后再说」,不得静默丢弃后又延迟执行。播报阶段可打断后继续提问。当前股票 / 当前页面作为上下文传递,不替代用户明确意图。

对应验收:AC08、AC09、AC10、AC11、AC12

现有交互原型参考,尚未接入硬件键与真实语音
现有交互原型参考,尚未接入硬件键与真实语音 · 点击看大图
P04

收起通话与悬浮控件

全局持续控件,不是独立页面 · P0

进入条件:P03 收起;在业务区切换页面。

页面内容

区域 / 字段页面要求
紧凑通话条FinSights 标识、状态、时长、展开入口。
可用控制保留静音、结束;回复中可打断。不能只留一个不可操作的通话标记。
位置桌面位于 Chatbot 底部 / 宿主约定全局位置,不能挡住发送、列表操作或系统导航。
页面关联业务路由改变时维持同一个媒体连接与 call_id;应用壳层统一管理。

操作与去向

操作行为与去向
点击通话条 / 再次按实体键展开同一通话 → P03。
切换业务页面只切换右侧工作区,不重新开始通话。
点击结束与主面板结束行为完全一致 → P08。

核心规则:收起不是结束;切换业务页不是重连。桌面最小化 / 后台策略由宿主测试确认,不依赖页面组件存活维持通话。

对应验收:AC02、AC13、AC14

现有交互原型参考,尚未接入硬件键与真实语音
现有交互原型参考,尚未接入硬件键与真实语音 · 点击看大图
P05

业务页面联动

8 个既有目标模块,全部复用 · P0

进入条件:用户明确说「打开 / 跳转到 X」;现有导航事件通过校验。

页面内容

区域 / 字段页面要求
Chatbot 区保留用户指令、目标模块和跳转回执,不用语音文字假装页面已经打开。
业务区域加载既有页面;沿用当前账户、权限、筛选和页签规则;不重做页面内容。
导航反馈实际路由确认成功后再显示「页面已打开」并播报结果;失败显示原因和可点击的导航入口。
边界P0 为模块入口导航,不承诺任意详情页、筛选条件、表单字段或任意网页点击。

操作与去向

操作行为与去向
命令式导航现有 navigation_jump → 既有白名单 → navigateToModule。
询问入口位置如「资讯在哪里」沿用现有可点击导航回复,不强制跳转。
已经在目标页面直接显示该页 / 展开被收起的面板,不重复建页。

核心规则:必须保留 source=web、nav_jump 能力协商、当前会话及请求 ID 绑定和重放去重。research 是前端壳层入口,不在已核实的后端导航白名单中。

对应验收:AC15、AC16、AC17、AC18

P06

加入自选与操作结果

复用自选页面与接口,新增语音回执联动 · P0

进入条件:用户明确要求将某只股票加入自选;经过现有证券识别与必要澄清。

页面内容

区域 / 字段页面要求
操作目标股票简称、完整证券代码 / 市场、目标分组。不得仅凭同音词或模型猜测展示确定标的。
回执区添加中、已添加、原已存在、失败、部分成功或结果未确认。
自选页刷新原列表、数量与分组归属;实际新增股票可短暂高亮,状态以业务接口为准。
重复结果已存在时说明原归属,不新增重复记录,不静默把它移动到另一个分组。

操作与去向

操作行为与去向
确认有效标的复用现有 Chatbot 自选工具或原有前端添加流程;同一指令只能选择一个写入执行方。
添加成功刷新当前业务列表;可以点「查看」进入自选页。
添加失败允许明确重试,但重试前核对真实自选状态;不得盲目重发写请求。
目标不明确转 P07;未选择之前不修改自选。

核心规则:正式通话识别文本进入既有后端工具后,前端收到结果只刷新与展示,不能再调用 addStock 写第二次。默认分组和已存在语义沿用既有业务规则。

对应验收:AC19、AC20、AC21、AC22、AC23

P07

股票与意图澄清

复用现有澄清能力的界面适配 · P0

进入条件:识别到同名 / 同音股票、缺少市场、目标不明确或用户一句话有冲突动作。

页面内容

区域 / 字段页面要求
待确认问题如「你指的是哪只股票?」;引用识别结果但不显示为已执行。
候选项现有证券搜索 / 识别返回的简称、代码、市场;可通过语音或点击明确选择。
操作状态显示「等待确认」,本轮不进入写入阶段;无候选时提示重新说名称或代码。

操作与去向

操作行为与去向
选择一个标的沿用现有澄清票据 / 会话,完成本次指令,不重新建一轮无关任务。
取消 / 挂断未提交的动作取消,记录说明未完成。
服务不支持该澄清交互停止执行并请求重说,不能在前端补一个猜测性关键词匹配器。

核心规则:当前后端澄清交互的实际可用性需联调核验;如果现有分支未开放,P0 的可接受降级是「请说完整名称和代码」,绝不自动选第一项。

对应验收:AC22、AC24

P08

挂断后的通话记录摘要

现有聊天消息流中的新增记录类型 · P0

进入条件:已连接的通话被用户结束、异常断开或服务端结束。

页面内容

区域 / 字段页面要求
通话结束标记电话图标、通话已结束、实际连接时长;连接等待时间不计入通话时长。
记录元信息所属对话、开始 / 结束时间;显示采用 Asia/Shanghai,存储使用统一时间戳。
操作摘要已完成数量和真实动作名称;未完成 / 结果未确认单独列出;没有指令时明确「未执行操作」。
内容入口「查看通话内容」展开 P09;默认收起逐句内容,保留聊天流的简洁性。
继续操作「再次通话」建立新 call_id;历史记录不被清空或累加到新通话时长。

操作与去向

操作行为与去向
结束通话收起大面板,立即形成记录骨架;结果仍在返回时显示确认中并后续更新。
再次通话沿用同一聊天上下文,新计时、新轮次;旧记录保持独立。
刷新或重新进入会话正式版读取该账户、该对话的历史,不再次执行已完成操作。

核心规则:未接通取消不生成「已完成通话」记录。摘要依据工具回执,不能把正在执行算成完成。已提交操作迟到结果只能更新原 call_id;未知结果不得自动重试或伪装失败已撤销。

对应验收:AC25、AC26、AC27、AC28

现有交互原型参考,尚未接入硬件键与真实语音
现有交互原型参考,尚未接入硬件键与真实语音 · 点击看大图
P09

展开通话内容

记录内部展开区域,不新建独立路由 · P0

进入条件:P08 点击「查看通话内容」。

页面内容

区域 / 字段页面要求
头部开始 / 结束时间、通话时长、收起入口。
对话正文本通最终用户转写、助手最终文本,标明说话方;临时识别片段不重复保存。
操作明细每个动作的目标、执行结果、必要失败原因和已有业务页面的「查看」链接。
音频范围首期提供文字记录,不新增录音播放、音频下载、全文搜索或导出功能。

操作与去向

操作行为与去向
展开 / 收起只改变当前记录呈现;多次通话不能混在一个详情中。
查看关联页面仅导航到既有页面,不重复添加自选,不恢复麦克风。
历史目标已不可用 / 无权限沿用现有错误提示,记录正文仍保留可读状态。

核心规则:历史记录是只读证据,不能保留会再次执行写入的旧「重试」按钮。重新发起操作需要新的用户指令和请求 ID。

对应验收:AC27、AC29、AC30

现有交互原型参考,尚未接入硬件键与真实语音
现有交互原型参考,尚未接入硬件键与真实语音 · 点击看大图
P10

权限、失败与恢复

现有登录 / 权限页及通话错误面板 · P0

进入条件:登录、麦克风、连接、播放、业务执行或历史保存出现错误。

页面内容

区域 / 字段页面要求
麦克风拒绝「无法使用麦克风」与设置指引、重试、取消。拒绝时不能出现绿色正在听状态。
连接失败 / 超时「通话未连接」与重试、返回;没有可用语音时仍保留文字聊天。
网络中断显示正在恢复;暂停新的业务指令,记录断开状态,不悄悄重复已提交命令。
播放受限「点击启用声音」;文字内容可见,不能持续显示正在播报却没有声音。
业务失败 / 结果未知区分明确失败和结果未确认;后者先查询实际状态,再决定是否允许重试。
记录保存失败本地暂存 +「记录待同步」;恢复后按 call_id 幂等提交,不能显示虚假的「已保存」。

操作与去向

操作行为与去向
重试连接确认旧资源释放后重建;保留业务页面和已保存内容。
恢复业务状态复用现有查询接口;不靠再次执行写入来探测结果。
账号切换 / 登出停止通话、隔离临时音频和缓存,旧请求结果不得进入新账号。

核心规则:不申请摄像头、屏幕共享或其他无关权限;在关闭、断开或放弃时释放采集与播放资源。连接超时15秒、断线恢复窗口15秒(详见第15章),仅为待真机确认的产品阈值。

对应验收:AC05、AC06、AC21、AC28、AC31、AC32

P11

小程序通话预留页

设计预留;手机业务仍在既有小程序 · 预留,不在本期实现

进入条件:当前手机业务入口为现有小程序。本轮仅保留未来通话页面的位置与设计方向,不新增手机 H5 入口。

页面内容

区域 / 字段页面要求
现有小程序保留当前业务导航、登录及终端绑定流程;不因桌面通话需求重做小程序业务。
未来通话位置仅作为设计占位,不要求本期增加可点击的通话入口或对外展示一个空页面。
复用方向后续小程序如启动通话项目,再评审账户、终端绑定、通话记录及音频能力的衔接。
原型边界现有小屏响应式预览只用于讨论布局,不代表小程序页面已实现,也不构成手机 H5 开发范围。

操作与去向

操作行为与去向
当前手机操作继续进入现有小程序业务。
本期交付只保留设计占位和边界说明;不新增手机通话、录音或业务页切换能力。
后续评审小程序通话需单独确认平台接口、权限和页面流程,不直接照搬网页音频 API。

核心规则:本期不新增手机 H5,不对小程序通话功能排期或验收;预留页不能标注为已开发、已接入或可上线。PRD 网页可在手机阅读,与业务端是否交付是两回事。

对应验收:AC33

05 既有业务页面内容与导航映射

页面 / key现有路径打开后沿用的页面内容本期联动与边界
首页 / 自选股 home/自选股列表、当前分组、行情与已有看板模块「打开我的自选股」按现有映射到首页看板;不能另造一套自选列表。
资讯 news/news现有资讯分类、列表与阅读内容只打开现有资讯入口;具体筛选、某篇文章和已读状态仍按现有业务规则。
机会 opportunity/opportunity热点板块、资金流向、机会与异动入口只切换到模块;不把语音导航当作重新运行选股。
产业链 industryChain/industryChain现有产业链工作区、图谱及已支持的数据视图「打开产业链」可以导航;指定某公司或具体链条属于内容请求,不能被入口匹配误吞。
知识库 knowledge/knowledge现有概览、知识流、周报及文件能力沿用账户授权范围;不因语音入口默认开放所有私有文档。
回测实验室 backtest/backtest现有策略广场内的回测页签「打开回测」只导航;「帮我回测策略」走既有工具与授权,不能只导航后就说完成。
策略广场 strategySquare/strategy-square现有发现策略、回测实验室、我的策略按当前路由重定向和页面能力处理。
定时任务 scheduledTasks/scheduled-tasks现有任务列表、状态、报告及管理入口打开页面可复用;新建 / 修改任务另受现有能力开关与授权控制,不因通话自动放开。

06 业务流程与状态转移

F01 硬件键直接进入通话

步骤前端 / 宿主服务端 / 结果
1 单击实体键宿主去重事件、激活现有窗口,调用唯一 enter_voice_call 入口无需业务请求;不先进入录音或朗读。
2 检查前置条件沿用登录、设备、能力与系统麦克风权限使用现有身份;不接受客户端自报 user_id 作为权限依据。
3 连接与准备展示 P02;保持右侧业务页面;可取消取得短期语音会话授权并确认可用。
4 连接确认显示 P03、开始计时和采集call_id 与已有 conversation_id 绑定。
5 用户发言临时转写单独展示;只提交最终可执行语句生成一次请求 ID,复用现有 Chatbot。

F02 语音打开页面

最终语句 → 原 Chatbot 导航判断 → 专用 navigation_jump → 当前会话 / 请求校验 → 既有 navigateToModule → 路由成功回执 → 播报结果。不能从回复文本里抓取一个路径就执行。

F03 语音加入自选

最终语句 → 原证券识别 / 澄清 → 原自选工具 → 鉴权写入 → 读取真实结果 / 既有刷新链路 → 展示简称、代码、分组与结果 → 播报。重复存在不重复添加;结果未知先核对实际列表。

F04 挂断与记录

停止上行音频与下行播报 → 取消未提交轮次 → 保存通话骨架 → 汇总已有回执 → 显示 P08 → 已提交动作的迟到结果回写原记录 → 允许展开 P09 / 再次通话。摘要默认不重新执行任何业务工具。

状态可接受事件下一状态 / 约束
idle / ended网页发起、硬件键connecting;如已有活跃实例只展开。
connecting服务就绪、取消、超时、权限拒绝listening / idle / error;取消前未接通不生成成功通话。
listening最终转写、静音、结束processing / muted / ended;临时转写不执行。
processing成功、失败、待澄清、结束speaking / clarifying / ended;同轮只执行一次。
speaking播报结束、打断、静音、结束listening / muted / ended;打断不回滚已完成操作。
muted取消静音、结束、硬件键listening / ended / 展开;按实体键本身不切换静音。
clarifying选择、重说、取消、结束processing / listening / ended;目标未明确不写入。
reconnecting / error恢复、重试、放弃先核对会话与请求状态;不得盲目重放操作。

07 复用清单与新增开发边界

能力已核实代码 / 协议开发要求
用户与设备权限现有登录、JWT、设备绑定与会员能力复用;硬件键不能绕过。
Chatbot 请求frontend: src/stores/chatbot.ts → sendDataToChatbot;src/apis/chatbot.ts → general_query最终语音文本走现有入口;保留 conversation / client_request_id。
导航意图unified-api: utils/navigation_intent.py;core/moe_llm.py复用判定;不新建一套前端关键词路由。
导航中继api-main: root/dynamic_chatbot/general_chatbot_views.py → navigation_jump沿用专用事件及可信请求 ID 绑定;非普通文本命令。
导航执行frontend: src/utils/navModules.ts;src/composables/useNavLinks.ts;src/stores/navJump.ts复用白名单、路由守卫、面板展开和重放去重。
自选工具unified-api: routers/nodes/api_main_node.py → list_self_selected_stocks / add_to_favourite_stocks / delete_from_favourite_stocksP0 语音开放查询 / 添加;删除是既有能力,但不由本PRD自动扩展为新增语音范围。
自选业务接口POST /api/stock_info/add_to_user_favourite_stocks;GET /api/stock_info/get_user_favourite_stocks复用鉴权、去重、默认分组及查询结果。
前端自选刷新useAddToWatchlist.ts;selectedStock.ts;stockGroups.ts沿用现有页面状态与刷新;后端已写入时仅刷新,不能再次调用写入流程。
视觉与工作台现有 MainLayout、ChatBot、FsBrandLogo、tokens.css复用现有主题和布局;通话媒体状态上提到稳定壳层。
新增:硬件桥接尚未拿到已核实麦克风键协议宿主事件适配、去重、窗口激活、旧行为互斥与真机验收。
新增:语音会话现有核心 GitHub 仓库未发现完整火山实时双向通话链路服务鉴权、音频接入、转写 / 播报、打断、释放与恢复。
新增:通话记录原型已有本地记录,正式账户历史未接入扩展现有对话消息 / 元数据,绑定账户和对话;不另起孤立历史系统。

语音技术方案的约束

优先保留既有 Chatbot 为业务决策与工具执行方。火山侧提供实时语音采集 / 识别与播报所需能力;若选择端到端语音模型,也必须把业务动作交回现有受控工具链,不让语音模型自行宣告已执行。具体产品、区域、协议、音色、授权资源和计费由研发接入前核实,本 PRD 不伪造供应商接口。

08 数据与事件契约(拟定,待技术评审)

以下是实现所需的应用层字段,不代表既有 API 已经支持,也不是火山 SDK 或硬件厂商的真实事件名。优先扩展现有会话 / 消息契约;路径与表结构由研发评审后确定。

对象建议字段规则
硬件输入event_id / press_id、device_id、key=VOICE_CALL、action=click、occurred_at、source=hardware设备身份来自已有绑定;按一次产生一个消费意图。web 电话按钮只改变 source。
通话call_id、conversation_id、authenticated_user_id、entry_source、connected_at、ended_at、duration_ms、end_reasoncall_id 在连接 / 记录 / 回执间一致;duration 不含连接等待。身份从服务端认证解析。
语音轮次call_id、turn_id、utterance_id、client_request_id、final_transcript、assistant_text、created_at临时识别不写成多个用户消息;同一 final 重放不产生第二个业务请求。
操作回执operation_id、client_request_id、kind、target、status、result_ref、error_code、updated_atstatus 建议区分 pending / succeeded / failed / cancelled / unconfirmed;预览已区分 unknown;正式版仍须完整状态、稳定操作 ID 与服务端事实。
通话摘要消息message_id、type=voice_call、call_id、summary、success_count、pending_count、unconfirmed_count嵌入原对话;统计按操作 ID 去重;摘要有版本 / 更新时间,允许迟到结果更新。
历史正文call_id、turns、receipts、storage_status按当前登录账户及 conversation_id 校验归属;恢复只展示,不执行。
页面导航完成call_id、client_request_id、target_key、succeeded、reason先由真实路由结果确认,再播报「已打开」;不能仅用模型文字判断成功。

结果隔离与恢复

09 异常、权限与质量要求

场景用户可见内容处理与验收
实体键事件重复维持当前通话或连接状态不重复建连、不重复生成摘要、不重复写入;真机验证按下 / 抬起 / 长按 / 抖动。
客户端未登录 / 用户切换现有登录引导;恢复后可继续进入通话旧 token 的结果不进入新账户,麦克风及时停止。
麦克风被占用 / 权限拒绝具体错误、设置指引、重试 / 取消没有权限不采集,不伪装在线。
音频播放失败保留文字;显示点击启用声音或设备选择指引不得因为播放失败重复执行业务动作。
股票识别不明确重说名称 / 代码,或选择真实候选不凭同音猜测和第一候选直接加自选。
后端写入超时结果未确认,正在核对先查询原状态;不凭超时宣告失败并自动再次添加。
挂断时仍有写入返回结束标记已出现;对应操作继续确认已生效结果如实保留;未提交动作取消。
语音服务异常通话失败 / 断开,保留原有文字能力释放资源,允许重新连接,不影响其余业务页面。
历史保存失败记录待同步 / 本次暂存按 call_id 幂等补写;禁止错误显示已成功保存。
浏览器不支持 / 目标硬件离线无法进入通话及可采取的下一步不将硬件不可达伪装为麦克风静音。

建议验收指标(评审目标,不是现有实测成绩)

指标建议门槛统计边界
物理按键到界面反馈P95 ≤ 300ms应用已运行且已登录;测从宿主收到实际按键事件至可见连接态。
准备到可对话P95 ≤ 5s;15s 进入超时提示排除用户等待授权的时间;须在目标设备与目标网络实测。
打断与结束后的本地停止≤ 300ms 停止当前播放 / 新采集服务端完整释放另计,不用播放停止代替资源释放证明。
普通导航反馈执行确认后 ≤ 500ms 显示回执不包括既有页面的数据加载耗时;实际路由失败不得报成功。
通话记录骨架结束后 ≤ 1s 可见耗时业务结果可晚到,记录展示确认中;不得伪造完成。
并发和连续使用每个工作台实例最多 1 条活跃通话;至少 30 分钟连续真机验证跨多个标签页 / 宿主窗口的账号级并发策略需列入技术评审。

10 开发与测试验收清单

编号验收输入 / 场景必须观察到的结果
AC01已登录、已有音频权限,在业务页单击硬件麦克风键直接展开通话并进入连接,不出现模式选择、朗读或录音中间页。
AC02通话收起后再次单击实体键展开同一 call_id,计时连续,没有第二条连接。
AC03在连接中连续按键 / OS 长按 repeat只创建一次会话;取消后旧回调不能重新启动通话。
AC04文字输入框已有未发送草稿时按实体键草稿保留且不自动发送。
AC05首次授权拒绝 / 麦克风不可用不显示正在听,提供正确恢复入口。
AC06连接超时后重试旧资源释放后重试;没有重复会话与成功记录。
AC07未接通时点击取消显示未接通取消,不生成完成通话记录。
AC08接通后说出一条有效指令最终转写仅产生一次现有 Chatbot 请求。
AC09流式识别多次 partial / 重复 final临时内容不执行,重复 final 不导致重复写入。
AC10通话静音 / 取消静音音频上传随状态改变,已提交操作不被当成撤销。
AC11回复中点击打断声音及时停止,文字和已完成结果保留。
AC12操作进行中再次发言清楚反馈正在处理,不悄悄并发或延迟执行额外指令。
AC13执行导航或手动切换业务页媒体连接与 call_id 保持,结束按钮仍可用。
AC14展开、收起通话多次无重复监听、重复计时器或丢失回执。
AC15逐一打开 8 个白名单模块映射到现有路径,遵守权限与守卫。
AC16询问入口位置而非明确命令按现有规则给链接,不擅自切页。
AC17收到伪造 / 非白名单 / 非当前请求导航事件不执行导航,不通过普通文本绕过。
AC18路由被拒绝或数据页加载失败不能播报已经打开;保留可恢复入口。
AC19加入一只明确的新股票现有业务接口仅写一次;刷新原有列表、数量与分组。
AC20加入已在其他分组的股票不重复添加,不静默改组,反馈原有归属。
AC21添加请求超时 / 断网后重试先核对实际列表 / 结果;未知不能算成功或盲目重发。
AC22同音、同名或缺少市场目标未明确之前没有自选写入。
AC23后端已执行添加且前端收到结果前端仅刷新,不第二次调用 addStock 写入。
AC24澄清期间挂断未提交动作取消,记录保留未完成原因。
AC25接通后挂断聊天中出现时长标记、实际操作摘要与展开入口。
AC26再次开始第二通新 call_id / 新计时;上一通时长、内容和操作统计不累加。
AC27刷新 / 重新打开所属聊天只恢复该账户记录;不再次调用历史操作。
AC28挂断时仍有结果晚到只更新原记录;未知状态有明确说明,不永久显示处理中。
AC29展开 / 收起多个通话记录内容按 call_id 隔离,真实说话方和操作结果可查。
AC30点击历史中的查看仅导航;没有自选写入、麦克风启动或旧重试。
AC31通话中登出或切换账户采集停止、缓存隔离;旧事件不污染新账户。
AC32关闭通话、取消连接、异常断开本地音轨 / 播放器 / 监听和服务端资源均按规定释放。
AC33桌面 1024px / 1280px / 1440px 与小程序预留边界桌面通话控制、记录和业务入口可操作;P11 仅标为预留,不增加手机 H5 或小程序通话上线验收。
AC34目标宿主的后台 / 托盘 / 音频设备切换完成约定支持范围真机验收,不用纯浏览器截图代替。
AC35分别单击设备图红框麦克风键、相邻斜箭头键和其余功能键仅红框麦克风键新增通话唤起;相邻键与其他键保持原功能,不误触发或重复建连。
AC36麦克风拒绝后连续按设备键只显示权限引导;不进入正在听、不重复请求系统权限。
AC37原窗口已有通话,在其他窗口或设备唤起遵循账户单活,不强占原通话、不产生第二个媒体连接。
AC38断网后恢复 / 超过15秒窗口内恢复原call_id;超时结束且仅生成一条记录,晚到事件不得复活。
AC39设备断开、静音重连、系统睡眠后恢复不自动切到其他输入设备;恢复仍保持静音;睡眠后重新校验连接与账户。
AC40扬声器失败,用户点击重试播放仅重播该条回复;自选写入和页面跳转次数不增加。
AC41结果未知后挂断、刷新、再次开始原操作仍待核对;新旧通话都不盲目重发;结果按原call_id更新。
AC42澄清候选后取消 / 挂断 / 超时未提交添加;陈旧候选点击无效;实际候选来自原证券搜索。
AC43添加成功但导航失败只重试导航;不重复添加、不错误回滚已生效自选。
AC44记录服务离线、浏览器存储不可写记录保留当前页,重试同一message_id,提供导出;不显示已保存。
AC45关闭窗口、完全退出、系统锁屏或设备断电按宿主策略释放音频、标记异常结束;未确认操作在重开后对账。
AC46重复final转写、重复工具事件、旧代际事件乱序以client_request_id/operation_id去重,旧代际媒体事件丢弃。
AC47通话到达时限或长期无有效输入按阈值提示并结束,不将思考/执行/播报时间误判为用户无声。
AC48正常与异常界面复查提示文案仅一个主状态、一个帮助入口;结果未知等必要文字不删除。

11 分工、依赖与上线顺序

角色 / 工作包具体交付依赖与完成条件
硬件 / 桌面宿主麦克风键事件协议、窗口激活、旧播音互斥、监听注册与释放HW01–HW05 确认后,前端只消费统一逻辑事件。
网页前端P01–P10 页面状态、全局通话控件、原工具回执渲染、账户记录展示复用现有路由 / store / 主题;移除生产构建中的示例语句匹配与本地模拟 API。
语音服务接入服务端短期授权、音频链路、最终转写、播报与打断、资源回收确定火山产品与协议;不把长期密钥下发到前端。
Chatbot / 业务后端语音最终文本接入原请求、请求幂等、原自选工具和导航事件同一指令单一写入方;目标 / 权限未明确不执行。
聊天历史后端call_id 与对话消息扩展、账户隔离、迟到结果更新复用既有历史服务;明确保留与删除规则。
QA物理键全状态、跨页保持、错误恢复、真实业务与记录对账按 AC01–AC48 输出截图、状态日志与必要网络证据;日志不含密钥和音频正文。
  1. 先冻结入口和旧键行为。 验证一次物理按压能到达应用壳层且不会同时朗读。
  2. 接入唯一通话会话。 完成权限、连接、静音、打断、结束与释放。
  3. 挂接原有业务链路。 先完成单条导航和单只股票添加,再验证重放去重与错误状态。
  4. 完成账户记录闭环。 挂断标记、摘要、展开内容、迟到结果和刷新恢复。
  5. 在目标硬件验收。 达到约定性能和连续使用门槛后,按评审推进复合指令;小程序通话页继续作为预留,不纳入本期上线。
待确认项确认方上线影响
硬件实际事件与完全退出唤起能力硬件 / 宿主阻塞真实硬件入口验收,不能用模拟键代替。
通话中再次按键是否采纳「仅展开」默认值产品 / 硬件需在按键验收前冻结;本版未将挂断绑定到物理键。
火山语音产品、资源、音色、区域与鉴权协议语音研发阻塞真实通话接入;当前页面不代表云端已开通。
一条语音指令的权威写入方和请求幂等策略后端 / 前端阻塞真实自选写入验收,避免重复添加或重放。
正式历史保留 / 删除规则及多标签并发规则后端 / 产品阻塞正式账户历史上线;原型 localStorage 不作为替代。
复合指令、长时间断线恢复产品 / QAP1 扩展,不能因原型可点击而默认列为已完成。

12 依据、原型与版本说明

文档日期:2026-10-22;代码核查基线:2026-10-21 的 5 个仓库快照。核心导航、自选和语音入口文件已与当时 UAT 分支比对。该结论不等于所有组织仓库、所有分支或当前线上配置均已审计;开工时需核对与最新主分支的差异。

仓库核查提交用于本 PRD 的依据
finsights-frontend6c727e63ae6fdba2be94c980b92e69e487317a24网页 UI、路由、自选 store、Chatbot 请求与导航消费
finsights-unified-api84a5df42b6f2c96afd2fd13f33fc1ce950b5629a导航意图、46 项工具目录、自选工具与门控
finsights-api-main75836cbda0a86166ce7087ecea94a6b301b2d715聊天中继、自选业务、历史及手机文本中转
finsights-mobile-connect9e659d91ec2e38726e0cf21fa939e585ce77ccfe小程序语音输入与既有连接能力
langgraph-chatbot1a0dd4299fa4902d7fd33130828d100304b614d7辅助参考;本期不新增第二条 Agent 执行主链路

原型使用方式

打开已完成的通话交互原型 ↗。可体验通话、示例指令、页面跳转、自选结果、挂断记录和展开内容。小屏界面仅为原型响应式预览,不能作为小程序已交付页面或新增手机 H5 需求。已加入设备图麦克风热区、23类异常界面及恢复流程。真实实体键、语音链路、系统权限窗口与正式账户历史仍须按第15章接入和真机验收。

原型中的示例证券、价格和资讯均为模拟;截图日期为原型制作时的日期,不代表当前实时行情。附件参考图仅包含标题「分析 GetStaked 产品与业务流程」,因此本网页仅参考其简洁文档式标题呈现,不推断其未提供的正文结构。

13 提示文案精简结果

范围:通话入口 → 正在听 → 打开资讯成功 → 挂断并展开记录 → 帮助弹窗。以下保留前次审查证据。v2.0 已落实 C01–C08:全局保留一次方案边界、一个帮助入口;删除同义状态、重复成功句、静态面包屑与逐条样例尾注。下列旧图用于追溯问题,当前方案见第14章及交互预览。

编号 / 优先级画面中的重复内容建议处理
C01 / P2入口、通话页同时出现「交互原型 · 模拟语音与数据」「本地交互原型」「不会使用麦克风或修改真实账户」及通话底部的模拟说明。保留一个全局模拟标识;完整边界留在按需打开的说明中。删除重复的常驻脚注和侧栏原型备注,不能把模拟边界全部隐藏。
C02 / P2主状态「正在听」下又写「继续说,我在听」;首次连接后又同时出现「点击下方示例,模拟说话」「模拟说话」和底部同义引导。保留主状态;移除同义解释行。示例区统一用「示例指令」,输入框若只支持固定示例,须在相应入口明确范围。
C03 / P2成功回执已写「打开资讯 / 页面已打开」,助手又显示「资讯已打开。还想看什么?」。屏幕以执行回执为主要反馈,省去再次显示的同义成功句和泛化追问;语音确认与历史原始回复可以保留,不改变业务执行或录入证据。
C04 / P3右侧有「首页 / 我的自选股」再写「我的自选股」,资讯页有「资讯中心」再写「资讯」;面包屑是静态文本。保留功能标题;删除没有导航作用的同义面包屑。若保留层级,应提供实际返回操作。
C05 / P3资讯页每一条都标「原型示例资讯」,同时已有全局模拟说明和「演示数据」标识。在列表区域统一说明一次,去掉每条资讯的相同尾注;真实来源、时间和实际文章内容仍保留。
C06 / P3入口已给「打开资讯」「把宁德时代加入自选」两个例子,前面又写「打开页面、管理自选股。」。例子已解释用途,可删除同义能力说明,保留标题、主按钮与示例。
C07 / P3展开按钮写「收起通话内容」,展开区紧接着再写「通话内容」,重复识别同一区域。保留展开 / 收起按钮与起止时间;删去展开区重复标题。不要删除真实用户指令、助手回复或操作结果。
C08 / P3侧栏「使用说明」、侧栏底部问号、聊天头问号、横幅「说明」、导航轨问号,共 5 个入口打开同一说明。保留一个全局帮助入口,按布局复用;说明内容可继续按需展开,不必常驻在各处。
步骤审查结论证据
1 通话入口主入口清楚;模拟说明与能力说明重复。audit-01-entry.png
2 正在听状态和按钮可理解;同义引导过多。audit-02-listening.png
3 操作成功结果可见;回执、助手文字与资讯尾注有重复。audit-03-success.png
4 通话记录结构基本合理;展开区标题可以减少。audit-04-record.png
5 说明弹窗按需说明可保留;入口数量过多。audit-05-help.png

截图可观察到辅助灰字较小;关键信息不应仅放在低对比的小字里。本次为文案与视觉审查,未宣称完成读屏、键盘、色彩对比或小程序平台的完整无障碍验证。

步骤 1:通话入口
步骤 1:通话入口 · 点击看大图
步骤 2:通话中
步骤 2:通话中 · 点击看大图
步骤 3:执行成功
步骤 3:执行成功 · 点击看大图
步骤 4:挂断后的记录
步骤 4:挂断后的记录 · 点击看大图
步骤 5:按需说明
步骤 5:按需说明 · 点击看大图

14 异常界面与恢复流程

本章是开发规格:每个状态含实际页面文案、操作入口、音频处置与记录规则。点击交互链接后,在场景面板触发对应条件。外部条件恢复与页面重试分开,不能用一次点击假装权限、登录或设备自动恢复。

EX01

未登录 / 登录过期

P0

请先登录

登录当前账户后重新检查。尚未启动录音或提交操作。

重新检查 · 查看交互 ↗
触发与音频处理
登录前未启动采集;鉴权失败禁止业务执行。
恢复、业务与记录
接通前不生成通话记录;复用原登录弹窗 / 返回路径,登录成功后提供继续入口,不能自动发送草稿。
EX02

账户无通话权限

P0

当前账户暂不能通话

请联系管理员开通通话权限,或继续使用文字对话。

重新检查 · 查看交互 ↗
触发与音频处理
服务端再次校验套餐或授权;前端不能仅凭界面开关放行。
恢复、业务与记录
无通话记录;授权错误需稳定错误码,不混同设备故障。
EX03

设备离线 / 未绑定

P0

未连接通话设备

检查设备电源和连接,并确认设备已绑定当前账户。

重新检查 · 查看交互 ↗
触发与音频处理
输入输出设备均不可用时不创建媒体会话;绑定关系按账户验证。
恢复、业务与记录
无记录;不自动抢占其他账户设备,也不擅自切电脑麦克风。
EX04

麦克风权限被拒绝

P0

无法使用麦克风

在系统或浏览器设置中允许麦克风访问,然后重新检查。

重新检查 · 查看交互 ↗
触发与音频处理
只在用户点击后申请麦克风;拒绝时立即停止采集,不循环申请。
恢复、业务与记录
无记录;普通拒绝与系统永久限制区分设置方法;恢复后手动重新检查。
EX05

麦克风被占用 / 无输入设备

P0

麦克风不可用

关闭占用麦克风的应用,或接入可用麦克风。

重新检查 · 查看交互 ↗
触发与音频处理
枚举设备与采集错误分别映射;占用、被移除、无设备均停止采集。
恢复、业务与记录
无记录;更换输入设备需重新获取并确认,首期不自动切麦克风。
EX06

当前宿主不支持语音

P0

当前环境无法通话

请在支持通话的桌面客户端使用此功能。

改用文字 · 查看交互 ↗
触发与音频处理
能力检测早于申请权限;不要在不支持环境循环连接。
恢复、业务与记录
无记录;返回既有文字 Chatbot,不能把手机网页列为正式支持端。
EX07

其他窗口已有通话

P0

另一窗口正在通话

请在原窗口继续,或结束原通话后重试。

重新检查 · 查看交互 ↗
触发与音频处理
账户级单活租约;壳层 IPC 协调窗口,不凭 localStorage 锁解决跨设备竞争。
恢复、业务与记录
跳转原窗口由宿主完成;结束旧通话后才允许新建,不提供隐式强制抢占。
EX08

开始时无网络

P0

网络未连接

恢复网络后重试。尚未接通,未生成通话记录。

重试连接 · 查看交互 ↗
触发与音频处理
本地网络检查为提示,实际服务连接结果为准。
恢复、业务与记录
未接通不留通话摘要;恢复网络后点击重试创建新连接尝试。
EX09

连接超时

P0

连接超时

未能接通语音服务,请检查网络后重试。

重试连接 · 查看交互 ↗
触发与音频处理
连接超过15秒取消本次尝试并释放资源;晚到成功事件因 attempt_id 失效被丢弃。
恢复、业务与记录
不留通话记录;重试生成新的 attempt_id,不重复申请未过期的权限。
EX10

语音服务繁忙 / 额度不足

P0

通话服务暂不可用

请稍后重试,或改用文字继续。

重试连接 · 查看交互 ↗
触发与音频处理
区分繁忙、额度不足、维护、鉴权配置错误;用户只看可操作原因。
恢复、业务与记录
无记录;额度耗尽不无限重试,管理后台可查错误码与 trace_id。
EX11

通话中短暂断网

P0

连接中断,正在重连

已暂停接收新指令。已提交操作将核对结果,不会自动重发。

立即重连 · 查看交互 ↗
触发与音频处理
暂停上行与新指令;1/3/7秒退避,合计最多15秒,同一 call_id、递增连接代际。
恢复、业务与记录
恢复后核对已提交动作;未提交片段丢弃并提示重新说。超过15秒结束,记录中标注重连超时。
EX12

通话中设备拔出

P0

设备已断开

已停止采集。接回原设备后重连,或结束通话。

重新连接 · 查看交互 ↗
触发与音频处理
设备被移除立即停止采集与播放;不悄悄切到电脑录音。
恢复、业务与记录
15秒内接回可手动重连原通话;超时结束并保留原因。切换另一设备需明确确认输入输出。
EX13

通话中登录失效

P0

登录已过期,通话已结束

请重新登录。已提交操作保留在本次记录中,未提交内容不会执行。

重新检查 · 查看交互 ↗
触发与音频处理
立即停采集、停播放、失效旧会话授权;旧请求结果按原账户结算。
恢复、业务与记录
保存原账户记录;认证恢复后新建通话,不接着执行未提交内容;新账户不可见旧缓存。
EX14

服务异常 / 超过通话时限

P0

通话已中断

本次记录已保留。请稍后重新发起通话,原指令不会自动执行。

再次通话 · 查看交互 ↗
触发与音频处理
不可恢复服务错误、凭据失效或达到30分钟时限后结束通话。
恢复、业务与记录
显示中断原因与记录;再次发起生成新 call_id,不自动重发历史指令。
EX15

持续无声 / 无有效转写

P0

没有听清

请靠近麦克风重新说一次,或改用文字输入。未执行操作。

继续通话 · 查看交互 ↗
触发与音频处理
12秒无最终有效转写显示轻提示;不提交残缺或低可信证券指令。
恢复、业务与记录
连续90秒无用户有效输入先提示,随后结束;操作处理与播报期间不计入无声计时。
EX16

扬声器不可用 / 播放受限

P0

暂时无法播放声音

文字和操作结果仍可查看。检查输出设备后再试。

重试播放 · 查看交互 ↗
触发与音频处理
停止重试循环;业务执行不依赖播报成功,回执与文字持续显示。
恢复、业务与记录
点击重试只播放当前回复,绝不再次执行工具;真正更换输出设备后重试。
EX17

证券同音 / 市场不明确

P0

请确认证券

“腾讯”可能对应不同市场。选择完整证券后才能添加。

取消本次指令 · 查看交互 ↗
触发与音频处理
只展示既有证券搜索实际返回的候选,简称、完整代码、市场必须同时显示。
恢复、业务与记录
未确认前不写入;取消、挂断、目标变更均失效旧确认;30秒无选择取消该指令。
EX18

不支持的指令 / 识别不完整

P0

这条指令暂不能执行

请明确说出要打开的页面,或股票名称、市场及自选分组。

重新说 · 查看交互 ↗
触发与音频处理
普通闲聊沿用 Chatbot;不支持的操作明确未执行,不能从模型文本拼装路径。
恢复、业务与记录
保留原始指令及未执行原因;清晰说出受支持模块或证券后作为新请求。
EX19

页面无权限 / 路由加载失败

P0

页面未打开

当前账户无权访问目标页面。请确认权限后重新发起指令。

继续通话 · 查看交互 ↗
触发与音频处理
区分权限拒绝和加载失败;权限拒绝不提供盲重试,加载失败可重试同一次导航。
恢复、业务与记录
记录失败原因;不得因为路由地址改变就忽略实际守卫或页面渲染失败。
EX20

添加自选明确失败

P0

添加自选失败

本次未写入。可以重新发起添加,或继续其他指令。

继续通话 · 查看交互 ↗
触发与音频处理
只有权威业务接口明确 failed 才显示失败;不把网络超时当明确未写入。
恢复、业务与记录
允许用户重新提交新的操作请求;记录原失败,成功后独立回执,避免改写历史事实。
EX21

自选请求超时,结果未知

P0

添加结果未确认

请求已提交,请先核对自选列表。确认前不会再次添加,也不会继续下一步。

核对自选列表 · 查看交互 ↗
触发与音频处理
提交后响应丢失设 unconfirmed;写入按钮禁用;先查 operation_id 状态,再核对业务列表。
恢复、业务与记录
确认成功才记成功;确认未写入才允许重试;仍未知保持待核对。跨挂断、刷新、新通话保留锁与账户归属。
EX22

复合指令部分成功

P1

已加入自选,页面未打开

宁德时代 300750.SZ 已在默认分组。只需重新打开页面,无需再次添加。

打开自选股 · 查看交互 ↗
触发与音频处理
顺序执行:写入确认成功后再导航;导航失败不回滚已生效自选。
恢复、业务与记录
只显示重试未完成步骤的按钮;查看页面绝不重放添加。P1复合编排不能作为已上线能力。
EX23

通话记录保存失败

P0

通话记录尚未保存

记录仍在当前页面,关闭页面可能丢失。请重试保存或导出记录。

重试保存 · 查看交互 ↗
触发与音频处理
记录保存独立于通话结束;前端保留待同步队列和唯一 message_id。
恢复、业务与记录
在原账户内1/3/7秒重试,之后用户手动重试;导出文字/JSON作为兜底,不自动上传第三方。账户退出前提示未同步风险。
权限被拒绝:不进入正在听,提供重新检查与文字入口
权限被拒绝:不进入正在听,提供重新检查与文字入口 · 点击看大图
结果未知:核对列表后再恢复操作
结果未知:核对列表后再恢复操作 · 点击看大图
证券澄清:完整代码与市场,确认前不写入
证券澄清:完整代码与市场,确认前不写入 · 点击看大图
通话结束:原因、结果与展开内容
通话结束:原因、结果与展开内容 · 点击看大图

15 正式实现规则与交接门槛

规则正式实现要求预览与上线验收区别
唯一会话管理器应用壳层持有call_id、account_id、conversation_id、attempt_id、generation、phase、muted、input/output device_id及operation集合。所有入口调用同一个enterVoiceCall。预览在单Vue组件验证;正式版放应用级,不能跟随业务页卸载。
硬件适配厂商事件映射voice_call;校验设备绑定与事件id;忽略长按repeat并按300ms起校准;后台激活原窗口。只有图上热区已可点击,真实HID/串口/蓝牙协议待硬件提供;完全退出唤起单独验收。
鉴权与麦克风复用原登录与授权,不新造账户。检查安全上下文、支持能力、权限、音频设备、账户单活,之后服务端签发短期凭据。预览恢复条件在场景面板模拟;页面重新检查不会直接修改系统权限。
火山接入先确定产品与区域、采样率、编码、VAD、AEC、打断、保活、错误码与短期签名。凭据由后端持有;语音final文本交原Chatbot。未核实供应商SDK,不给出虚构接口;禁止另造意图解析与第二套业务Agent。
操作状态机received→validated→submitted→pending→succeeded/failed;提交前可cancelled,提交后超时为unconfirmed。operation_id全生命周期稳定。预览调用原导航、自选composable及store,本地API用于验证界面;生产由原后端工具唯一写入。
迟到与乱序媒体事件校验call_id+generation+attempt_id;业务结果按operation_id归属原记录,可在挂断后结算;新通话不接旧回复。挂断停止采集和未提交指令;已提交写入不能承诺撤销。
核对结果优先按operation_id查原服务权威结果,再刷新既有自选列表;仍未知不自动重发,不能把短暂查无当未写入。预览用既有列表查询走核对;正式需后端支持请求状态和幂等,不新建第二套自选接口。
记录归属复用聊天历史,type=voice_call、message_id幂等;保存起止时间、结束原因、用户final文本、助手回复、操作ID及实际结果。本地预览沿用原存储键,保留既有记录;正式按账户隔离,登出清临时缓存;不默认保存原始音频。
文字降级沿用当前Chatbot文字输入、会话与工具。语音错误不卸载业务页或清除文字草稿。预览文字模式复用同一指令/工具适配;正式挂接已有Chatbot组件,不另造文字聊天服务。
系统生命周期锁屏停止采集与播报;睡眠/退出结束连接,重开校验上次异常记录;页面刷新用生命周期事件尽力收尾,服务端心跳兜底。不能依赖beforeunload一定执行;后端租约过期后按最后心跳补齐异常结束,避免永久通话中。
单活与竞争同账户最多一条有效媒体会话;宿主窗口协调+后端租约;窗口崩溃租约回收,账户切换立即失效旧授权。localStorage仅用于记录预览,不能用它冒充跨窗口/跨设备锁。
可访问性设备热区可键盘聚焦,按钮有动作名;错误可读且不只靠颜色;弹窗焦点进入并返回触发处,Escape关闭。目标宿主需补系统权限窗口、读屏和键盘真机测试,截图不等于通过。
参数本版默认值(产品建议,非厂商事实)超出时的状态与动作
连接尝试15秒停止本次尝试,显示连接超时;丢弃晚到成功。
断线恢复1、3、7秒退避;总窗口15秒超过窗口结束并记原因,不自动新建第二通。
无有效转写12秒轻提示;90秒无有效输入结束执行/播报不计入无声计时;结束前15秒给继续通话入口。
证券澄清等待30秒取消该条未提交指令,恢复可听,不写自选。
单次业务确认10秒后标待确认,30秒仍无权威结果标unconfirmed按operation_id持续核对;服务端终态/用户手动核对前不重发。
最长单通时长30分钟;提前60秒提示到时结束并保存记录;再次通话新call_id。
会话保活10秒心跳;连续30秒无有效心跳视为断连服务端停止资源计费与租约,客户端按异常结束处理;接入时与SDK对齐。
结束资源释放300ms内停止本地录放;3秒内发起服务端close,失败后台回收UI不等网络close才结束;资源未释放进入诊断日志。
历史保存重试1、3、7秒;之后手动重试待同步状态与导出;同message_id避免重复记录。
尚需接入的契约(逻辑名称)输入与结果验收证据
宿主voiceCallRequested / focusExistingWindowdevice_id、press_id、timestamp;仅合法绑定账户消费一次真实按键、长按、连按、后台、托盘、退出与旧播音互斥录像。
原鉴权+voiceSession open/refresh/closecall_id、attempt_id、短期token、expires_at、错误码、服务trace_id无长期密钥下发;401/403/额度/服务中断/释放测试。
原general_query扩展语音来源source=voice,conversation_id、client_request_id、final transcript单次final文本一次请求;partial不触发工具。
原工具执行与状态查询扩展operation_id、target、status、result_ref;导航专用事件仍用白名单超时对账、重复投递、账号切换、挂断迟到及跨页测试。
原聊天历史扩展voice_call消息message_id、call_id、结束原因、转写、实际回执和revision离线保存恢复、跨账户隔离、迟到更新和原保留/删除策略验证。