Skip to content

Releases

1.4.0 —— 语音交互与状态卡整轮打磨

Choose a tag to compare

@slinxiaosun-blip slinxiaosun-blip released this 10 Nov 12:07

1.4.0 —— 语音交互与状态卡整轮打磨

语音

  • 语音识别改走 DSH 自带语音输入(ctx.speechToText,官方 voice-input bundle),优先 host-local / SenseVoice;未启用时在挂件与面板给出可操作提示;插件不再自带 ASR。
  • 追问「其他」交互重做:单击提交、长按录音。
  • 识别结果改为独立结果页:单击填入 / 长按提交 / 上键重录 / 下键翻页(最后一页再按回首页)。
  • 语音页只显示录音/识别状态,不回显识别文字。
  • 空闲录音页与「其他」语音页统一视觉(空心双环 + 卡框文字)。

状态卡与设置

  • 按用户要求不再单独显示「待审批 / 待回答」,统一显示「运行中」(内部仍用于亮屏、优先级与不休眠)。
  • 运行计时移到任务提示下方居中;任务完成后在该位置静态显示最终用时。
  • 追问默认不再超时(questions.timeoutMs=0),审批仍默认不超时。
  • 设置页新增「按键音」开关(音量沿用「提示音量」);长选项选中行跑马灯滚动。

蓝牙

  • 断开连接时复位 hello 标志;hello.ack 同时携带固件/电量,修复重连后面板固件与电量一直显示「—」。

其他

  • 固件 1.4.0 同步(v1.4.0-dsh-passport),BLE 协议 v1 不变。
  • 插件测试 223 条:222 通过 / 1 跳过(需真宿主 schema 环境变量)。

v1.3.1 —— 运行计时、状态条时钟

Choose a tag to compare

@slinxiaosun-blip slinxiaosun-blip released this 31 Oct 14:59

dsh-ai-passport 1.3.1

这一版把设备端界面缺的两块信息补上:运行计时与状态条时钟,并修掉两个一直存在的
宿主侧缺陷。插件代码的改动全部在 1.3.0;1.3.1 只把版本号与固件 1.3.1 对齐,行为与 1.3.0 相同。

新增:任务运行计时

task.state 增加两个可选字段,PROTOCOL_VERSION 仍是 v1(可选字段,四象限兼容):

  • elapsedMs:该轮忙碌已运行的毫秒数,主机在发送时刻算好
  • sinceReliable:起点是否来自真实的 turn/start

设备拿它做种子,再用自己的单调时钟走秒 —— 不是开始时间戳(设备没有 RTC,
时间戳对不上)。多会话并行时取最早的那个;重连、插件重启都会重新播种,计时不归零。

起点不可靠就不下发(插件中途启动、只看到 status(true)):设备按设计稿只印纯
MM:SS,没有位置标注「这是近似值」,而一个精确到秒却系统性偏小的数字
比不显示更容易误导。缺字段时设备就不显示。

新增:状态条时钟

同一个 task.state 里再带 hostEpochSec(UTC 秒)+ hostTzOffsetMin(时区偏移分钟)。

为什么发种子而不是格式化好的 20:17:设备要自己走秒,推一次字符串过几分钟就是错的。
也不发毫秒 —— 固件侧 long 只有 32 位,秒级够用且 2038 前不溢出。

结果:状态条上常驻当前时间(--:-- 表示还没收到种子),而运行计时只在「运行中」出现。

修复:任务数 1 → 2 时界面不刷新

推送去重键原先只比较 state。于是「1 个任务执行中」→「2 个任务执行中」这次推送
被当成重复丢掉,设备上的标题一直停在「1 个任务执行中」。

现在键是 状态|标题|已运行秒数:标题变了要推,秒数变了也要推(否则计时会停住)。

修复:dispose() 永不返回

桥进程里那个 50ms 的 sleep() 用了 unref —— await 一个 unref 过的定时器,当事件循环
里没有其它待办时它会立刻空转,Promise 永远不 settle,dispose() / disconnect()
就再也不返回。node --test 下的表现是 11 条用例全部 cancelled(不是 fail,
更不容易被发现)。50ms 的定时器不可能拖住进程退出,ref 着才是对的。

与固件的关系

与固件 1.3.1 同步发布,
但可以各自单独升级:新插件 + 旧固件时,计时与时钟字段被忽略,界面仍是旧版式。
要看到新的状态卡(信息居中 + 28px 计时),需要同时刷固件 1.3.1。

v1.2.0 —— 修复长录音静默失败

Choose a tag to compare

@slinxiaosun-blip slinxiaosun-blip released this 10 Oct 11:49

dsh-ai-passport 1.2.0

本仓的首个 release。修掉一个会导致长录音静默失败的缺陷,并让 voice.maxSeconds 真正生效。

主要修复:长录音不再静默失败

现象:设备按住说话超过约 10 秒后,自己停了 —— 但既不出识别结果,也不报错,
设备端没有任何提示。归档目录没有文件,插件日志也没有新记录。

根因:插件里用来清理"孤儿录音会话"的时间窗口被写死成 10 秒,但它分不清
"没等到结束信号"和"还在录"
。录音进行到 10 秒时,当前会话被判成孤儿丢弃;随后到达的
结束信号找不到会话,走静默丢弃分支直接返回 —— 不归档、不识别、也不给设备错误反馈。

也就是说:任何超过 10 秒的录音都会必然失败。这不是新问题 —— 旧固件 15 秒上限同样
超过 10 秒,只是此前所有真机验证用的都是 2~4 秒的短录音,从没人说过一句超过 10 秒的话。

修复:该窗口改为由录音上限派生(上限 + 30 秒余量),从结构上保证"会话存活期 > 录音上限"。

新增:voice.maxSeconds 真正生效

此前这个配置项只在配置加载里定义,运行时从未被读取 —— 写 1 或写 120 没有任何区别,
是个死配置。现在:

  • 默认 15 → 30,与固件录音上限对齐
  • 音频超出上限时,在解码后的 PCM 上截断尾部再送识别,并记 warn 日志说明原始时长
  • 截断而非丢弃 —— 你已经说了一长段,整段丢掉等于白说

调小它 = 进一步压短单次识别长度;调大不会让设备录更久(那是固件里写死的)。

与固件的配合

录音上限 30s、取消静音自动结束,这些行为在固件侧。本插件 1.2.0 + 固件 1.2.0 及以上
即可获得完整体验;协议 v1 未变,两侧可独立升级。

固件见 ai-passport-dsh releases。

已知限制

  • 调 voice.maxSeconds 只能调短,不能让设备录更久 —— 录音时长上限写在固件里
    (AP_AUDIO_MAX_SECONDS)。这是有意的:主机会话生命周期必须知道设备最多能录多久。
  • 在 macOS 上用 pyserial 打开 ESP32-C3 串口会触发 rst:0x15 USB_UART_CHIP_RESET
    把设备复位,DTR/RTS 怎么设都绕不过。真机取证请用归档 WAV 与 state.json,
    详见 docs/03。

验证状态

项 状态
插件单元测试 PASS(168 项,新增 3 条回归钉子)
固件静态检查 + 主机测试 PASS
真机:30 秒录音正常识别 PASS(WAV 恰好 30.000s,seqGaps: 0)
真机:说话中途停顿不被切断 PASS(WAV 5.60s,静音段 2.7–3.7s 完整保留,停顿前后两段均识别)
真机:短录音回归 PASS(固件 1.2.1 上连续 10 次录音,seqGaps 全为 0,短录音 3~5s 均正常出结果)

安装

git clone https://github.com/slinxiaosun-blip/dsh-ai-passport-plugin.git
cd dsh-ai-passport-plugin && npm install && npm run install-plugin

macOS / Windows 同一命令。详见 README。