# ext2-ul-VoiceSnap-Live

**Repository Path**: mind-plus/ext2-ul-voice-snap-live

## Basic Information

- **Project Name**: ext2-ul-VoiceSnap-Live
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-13
- **Last Updated**: 2026-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# 语音识别 (VoiceSnap)

![cover](extension/public/cover.png)

`VoiceSnapLive` 是一个适用于 Mind+ V2 实时模式的扩展（通过 HTTP 接口调用本机 VoiceSnap 桌面程序，实现录音与离线语音识别）。
该扩展共提供 4 个积木，运行环境要求见下方“运行环境”。

## 源码仓库

V1 原始仓库：（与 V2 一同发布，发布后补充链接）

## 运行环境

- VoiceSnap 桌面程序及 SenseVoice 识别模型：需自行获取，本仓库不附带（体积与授权原因）。
- **必须从纯英文路径启动**：中文路径会导致模型初始化失败（日志报 `tokens.txt does not exist`，实际文件存在，属程序中文路径兼容问题）。
- 启动后请确认程序日志出现 `ASR engine ready`，并在 VoiceSnap 中选择正确的输入设备（麦克风或虚拟声卡）。

## 积木

| 类型 | 积木功能 |
|---|---|
| 命令 | 设置服务器地址 [URLADR] |
| 命令 | 开始录音 |
| 命令 | 停止录音 |
| 数值 | 最近识别文字 |

## 示例程序

1. 启动 VoiceSnap 桌面程序，等待引擎就绪（日志出现 `ASR engine ready`）。
2. 在 Mind+ V2 实时模式的扩展库中加载本扩展，点击扩展卡片启用分类。
3. 程序按「设置服务器地址 → 开始录音 → 停止录音」顺序拼接积木，再用「最近识别文字」读取结果。
4. 说话在「开始录音」与「停止录音」之间进行；识别文字会保存在扩展内，可随时用报告积木读取。

> 注意：以上步骤基于积木定义与 VoiceSnap HTTP 接口整理，端到端录音识别尚未实测，仅供参考。

## 本地构建

```bash
npm ci
npm run build
```

构建产物在 `build/ext-wyh-VoiceSnapLive@2.0.0/`，可在 Mind+ V2 开发者模式直接加载其中的 `config.json`。

## 更新日志

### V2.0.0

- 迁移到 Mind+ V2 实时模式，积木 opcode、参数与默认值与 V1 保持一致。
- 补充 `compatibilityId` 兼容字段，统一积木配色。

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`wyh-voicesnap-live-thirdex`
- 原作者：wyh
- 原始仓库：https://gitee.com/mind-plus/ext-voice-snap-live