mkbk
58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# Owner 语音桌宠
|
||
|
||
这是 `add-voice-pet-pipeline` OpenSpec 变更交付的 Python 桌宠语音 Pipeline。
|
||
|
||
当前实现覆盖：
|
||
|
||
- “小杰小杰”唤醒词入口
|
||
- 本机音频 Transport 抽象和文件/内存回放测试通道
|
||
- VAD 人声端点检测
|
||
- 本地 STT Provider 边界和测试 Provider
|
||
- OpenAI/NewAPI 兼容 LLM Provider
|
||
- 本地 TTS Provider 边界和测试 TTS
|
||
- 桌宠状态映射、无 GUI fallback、透明 PNG 状态资产
|
||
- OpenSpec 主规范、自动化测试、CLI 验收和安全扫描
|
||
|
||
## 配置
|
||
|
||
密钥不得写入仓库。运行时默认读取项目根目录的 `.env` 文件：
|
||
|
||
- `OWNER_LLM_BASE_URL`
|
||
- `OWNER_LLM_API_KEY`
|
||
- `OWNER_LLM_MODEL`
|
||
- `OWNER_LLM_API_STYLE`
|
||
|
||
默认配置面向当前 NewAPI：
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
# 然后编辑 .env，填入 OWNER_LLM_API_KEY
|
||
OWNER_LLM_BASE_URL=https://newapi.mkbk.shop
|
||
OWNER_LLM_MODEL=gpt-5.4-mini
|
||
OWNER_LLM_API_STYLE=chat_completions
|
||
```
|
||
|
||
## 验收命令
|
||
|
||
```bash
|
||
PYTHONPATH=src python3.11 -m compileall src tests scripts
|
||
PYTHONPATH=src python3.11 -m unittest discover -s tests
|
||
PYTHONPATH=src python3.11 -m owner_voice_pet acceptance
|
||
PYTHONPATH=src python3.11 -m owner_voice_pet validate-assets
|
||
PYTHONPATH=src python3.11 -m owner_voice_pet security-check
|
||
openspec validate --all --strict
|
||
```
|
||
|
||
真实 NewAPI smoke 测试示例：
|
||
|
||
```bash
|
||
PYTHONPATH=src python3.11 -m owner_voice_pet llm-smoke --no-stream --message '用一句中文回复：小杰在线。'
|
||
```
|
||
|
||
## 安全约束
|
||
|
||
- API key 只从环境变量读取。
|
||
- 仓库内不保存真实密钥。
|
||
- 默认不持久化原始麦克风音频。
|
||
- `security-check` 会扫描已跟踪文本文件中的 `sk-...` 形式密钥。
|