# ext-VoiceSnap-Live

**Repository Path**: mind-plus/ext-voice-snap-live

## Basic Information

- **Project Name**: ext-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**: None

## README

# 语音识别 (VoiceSnap) — Mind+ V1 实时模式

基于 Mind+ V1 官方构建模板的独立源码工程。库作者 `wyh`，版本 `0.1.0`。V1 发布包标识：`wyh-voicesnap-live-thirdex`（文件名全小写）。

## 快速开始

建议使用 Node.js 16（更高版本需设置 `NODE_OPTIONS=--openssl-legacy-provider`）；在仓库根目录运行：

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

构建产物在 `build/template/`（`config.json` + `javascript/main.js` + 图标）。将该目录打包为 ZIP（根目录直接是 `config.json` 和 `javascript/`，扩展名改为 `.mpext`），即可在 Mind+ V1 实时模式的扩展库中导入。

## 工程目录

`src/index.js`（积木逻辑）、`src/extension-support/`（V1 模板接口）、`template/config.json`（库身份）、`template/javascript/`（图标和语言资源）；`scripts/` 与 `webpack.config.js` 来自 V1 构建模板。`build/` 为本地构建产物，已被 Git 忽略。

## 积木

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

## 使用条件（第三方工具）

- 需自行获取并启动 **VoiceSnap 桌面程序**（含 SenseVoice 识别模型）；因体积与授权原因，本仓库不附带程序和模型。
- **必须从纯英文路径启动**：中文路径会导致模型初始化失败（日志报 `tokens.txt does not exist`，实际文件存在，属程序中文路径兼容问题）。
- 启动后确认日志出现 `ASR engine ready`，并在 VoiceSnap 中选择正确的输入设备；默认服务地址 `http://127.0.0.1:8080`。

## 开发参考

- 开发文档：https://mindplus.dfrobot.com.cn/ext-js
- V1 构建模板：`DFRobot/MindPlusOnlineExtensionDevelopPackage`
- 对应 V2 仓库的 `compatibilityId`（`wyh-voicesnap-live-thirdex`）与本库发布包标识一致；两版 `config.json` 不要混用。