Ningyao Voice Launcher
Install the bundled launcher into a user-chosen folder, then configure .env and run it.
Workflow
- 1. Copy
assets/voice-chat-local into the target folder. - Install dependencies with
npm install in the copied folder. - Copy
.env.example to .env and fill in OPENAI_API_KEY. - Start with
start-voice-chat.cmd or start-voice-chat-bg.cmd.
Bundled Files
- -
assets/voice-chat-local: Browser voice chat app template. - INLINECODE9 : Windows installer/copy helper.
Windows Install
Run:
CODEBLOCK0
The installer copies the template, skips .env, and can optionally run npm install.
Configuration
Set these in .env:
- -
OPENAI_API_KEY: required - INLINECODE14 : optional API-compatible endpoint
- INLINECODE15 : text + vision capable model if screen analysis is needed
- INLINECODE16 : request timeout
- INLINECODE17 : local port
- INLINECODE18 : persona prompt
Notes
- - Prefer Chrome or Edge for browser speech recognition and speech synthesis.
- The terminal panel is intentionally restricted to a small whitelist.
- If screen analysis is enabled, choose a model that supports image input.
Ningyao 语音启动器
将捆绑的启动器安装到用户选择的文件夹中,然后配置 .env 文件并运行。
工作流程
- 1. 将 assets/voice-chat-local 复制到目标文件夹。
- 在复制的文件夹中运行 npm install 安装依赖。
- 将 .env.example 复制为 .env 并填写 OPENAIAPIKEY。
- 通过 start-voice-chat.cmd 或 start-voice-chat-bg.cmd 启动。
捆绑文件
- - assets/voice-chat-local:浏览器语音聊天应用模板。
- scripts/install-launcher.ps1:Windows 安装/复制辅助脚本。
Windows 安装
运行:
powershell
powershell -ExecutionPolicy Bypass -File scripts/install-launcher.ps1 -Destination $env:USERPROFILE\Desktop\ningyao-voice-chat
安装程序会复制模板,跳过 .env 文件,并可选择运行 npm install。
配置
在 .env 中设置以下内容:
- - OPENAIAPIKEY:必填
- OPENAIBASEURL:可选的 API 兼容端点
- OPENAIMODEL:如需屏幕分析,需使用支持文本和视觉的模型
- OPENAITIMEOUTMS:请求超时时间
- PORT:本地端口
- SYSTEMPROMPT:角色提示词
注意事项
- - 建议使用 Chrome 或 Edge 浏览器以获得语音识别和语音合成支持。
- 终端面板被有意限制为较小的白名单。
- 如果启用屏幕分析,请选择支持图像输入的模型。