qingran

清然是一个语音聊天工具，主要围绕 Rosie 的交互场景设计。它提供按住说话和电话免提两种语音输入方式，并支持 Eve 朗读回复。项目包含长期记忆功能，记忆数据存储于用户自己的 Neon 数据库，不依赖 GitHub 仓库。用户可以在设置中编辑 system prompt，以调整助手行为。 项目提供本地运行方式，通过 npm install 和 npm run dev 即可启动，默认监听 0.0.0.0:8080。线上部署使用 APP_PASSWORD 作为全站密码，并通过 HMAC cookie（qr_session）进行会话验证；本地开发环境不启用该认证层。设置中提供备份导出与导入功能，便于在更换域名时迁移记忆数据。 听力引擎可在设置中配置，标注模式开启后每一句语音都会保存为 clip，标注页面位于 /lab。项目使用 xAI 的语音转文字接口，显式指定 model=grok-voice-transcribe-2.0，并配置固定关键词、filler_words 和可调 vad_threshold。README 指出 xAI STT 官方不支持中文，因此语言列表不包含 zh。 项目还提供自部署 GPU 方案，相关说明位于 deploy/README.md。评测脚本 scripts/eval-hearing.mjs 可用于对导出的听力数据按测试集生成 CSV 评测结果。