隐私与安全
无中转服务器
设备只建立到 generativelanguage.googleapis.com 的 TLS 连接,中间没有任何东西。没有 Bắp 云、没有账号、没有统计分析。
什么数据、何时离开设备
- 声音只在对话期间发送给 Gemini:在唤醒词、按下滚轮或双击之后。安静 30 秒后会话关闭。
- 图像只在助手调用摄像头工具(
self.camera.take_photo)时发送。有人感知在摄像头自带的 AI 芯片上运行,从不发送图像。 - 工具请求直接发往公开数据源(Open-Meteo、VnExpress、Vietcombank、PNJ、CafeF、ESPN、Zing MP3、电台)。 你的城市用于天气查询,除此之外不发送任何关于你的信息。
- 你自己添加的 Webhook 会收到你发给它的请求文字。
API 密钥
密钥保存在设备的 NVS 中,或在编译时从 secrets/GEMINI_API_KEY 嵌入固件。浏览器只能看到遮盖后的密钥
(AIza••••••••xxxx)。拿到设备本身、或拿到你带密钥编译的 xiaozhi.bin 的人都能提取密钥:请使用设有额度上限的
专用密钥,不要分享编译好的 .bin。
建议:用免费层密钥作为主密钥,另一个开通结算的密钥只作备用。设备总是先用免费密钥。
设置页
- 仅限局域网。不要把 80 端口暴露到互联网;远程访问请用 VPN。
- 可选密码(HTTP Basic,NVS 中保存加盐迭代的 SHA-256)。
- 每个
POST都需要X-Bap请求头,可防御来自其他网站的跨站表单攻击。
闪存与出厂密钥
nvsfactory(0x9000)从不写入。firmware/restore_stock.sh 在校验 SHA-256 后写回完整备份。
致贡献者
切勿提交 secrets/、backup/、vendor/、firmware/build/、编译日志或编译好的 .bin。CI 每次推送都运行
gitleaks。第三方代码在编译或刷写前都会先阅读。
Last updated on