AvianVisitors 界面全功能速览：Collage 拼贴、Stats 统计与 Atlas 图鉴的 10 分钟上手教程

AvianVisitors 是一个基于树莓派（Raspberry Pi）的实时鸟类拼贴（Bird Collage）开源项目：一只架在窗边的麦克风会持续聆听，BirdNET-Pi 语音识别模型把听到的每一种鸟，变成一幅手绘风格的插画拼进Collage页面。这篇文章带你 10 分钟速览它的三大核心界面 ——Collage 拼贴、Stats 统计、Atlas 图鉴，外加可选的 Educators 课堂模式和右上角管理菜单，看完即可上手。

🐦 认识 AvianVisitors：窗边的"活的鸟拼贴"

想象一下：你什么都没做，打开浏览器，窗边今天"到访"的鸟已经以插画形式排好了队。这就是 AvianVisitors 的主页 —— 一张会随时间增长的活拼贴画：

• 鸟的大小 = 出现频率：听得多的大鸟居前，罕见的客串小鸟排在后面
• 插画即识别结果：每种鸟对应一幅手绘插画（默认是日式浮世绘风格，可换其他画风）
• 点击任意一只鸟，会弹出一张"明信片"（Postcard）：中文名、学名、累计听到次数、首次听到时间、最近录音列表，还能跳转 Wikipedia 与 eBird 查资料

⏱️ 30 秒上手：找到三个关键控件

安装完成后，浏览器打开http://birdnet.local/（安装方法见 README.md，全程只需刷一张 SD 卡再跑一条安装命令），你会看到页面上只需要认识三处：

时间窗口对三个视图同时生效：想看"今天来了哪些鸟"就选24H，想看全部历史就选ALL。视图切换器、时间窗口的实现分别在 avian/frontend/index.html 与 avian/frontend/index.html。

🎨 Collage 拼贴：一眼看懂谁在窗外最活跃

Collage 是默认视图，标题是Heard Recently（最近听到）。它的"信息密度"非常高：

1. 位置即排名：被听到次数最多的鸟占据拼贴中心，且形象最大
2. 换画风：在Settings → Bird bundle里可浏览官方插画包（Illustration Bundle），例如亮色写意风的 Evolutionary Impressionist；SSH 登录后用一条sudo avian-bundle use '<BUNDLE_ID>'命令即可在本地站点换装，整站插画原子化切换，失败会自动回滚
3. 明信片详情：点击任意图鉴，可切换"栖枝 / 飞行"两种姿态的插画，还能试听该鸟的历史录音、查看识别置信度

Collage 画布的核心代码见 avian/frontend/index.html。

📊 Stats 统计：把"听到过"变成"听得懂"

切到底部stats标签，页面会从"画面"变成"数据"，围绕同一个时间窗口提供三种读法：

• Timeline（时间线）：一列一列的鸟，黑块高低直接编码该时段的检测次数
• By hour（按小时热力图）：先选一个日期（可翻页、可点"latest heard / today"），再按"鸟 × 小时"看它的作息
• Today's Rhythm（今日节奏）：当天每小时的检测量，叠加上周平均曲线做对比

右侧边栏还有三个排行榜，是观鸟人最关心的数据：

• By Period：按时效分组的检测数
• Top Species：当前窗口听到最多的鸟
• First Detections：生命清单（Life List）里最新入册的鸟 —— 发现新鸟种的那一刻最有成就感

Stats 视图结构（日期导航、双图表、边栏、节奏曲线）定义在 avian/frontend/index.html。

🗺️ Atlas 图鉴：你的终身鸟类清单

切到底部atlas标签，就进入了你的私人鸟类图鉴（Life List）。左上角有四种排序：

• Life list：按首次听到时间，新鸟在前
• By family：按分类学"家族"分组，适合系统学习鸟类分类
• a → z：按字母顺序
• Most heard：按听到总次数

图鉴默认是"邮票"（Stamp）风格卡片，也可以在Settings里切回 v1.1 恢复的经典插画卡片风格。点击任意一张卡片，弹出的同样是 Collage 里那张明信片：描述文字、科/属/种、稀有度（Rarity）、录音列表一应俱全（明信片模态框见 avian/frontend/index.html）。

🔭 拼贴之外：原版 BirdNET-Pi 页面仍然可用

AvianVisitors 是架在 BirdNET-Pi 之上的"皮肤层"，原站功能并没有被覆盖，访问/index.php即可进入原版界面：Overview 总览、Today's Detections、Spectrogram 声谱图、Best Recordings、Species Stats、Recordings 等标签一应俱全，适合想深挖原始检测数据的用户：

声谱图（Spectrogram）页面则把每 3 秒的音频变成一幅"声音的图"，识别到的鸟（如 Boat-tailed Grackle、American Crow）会直接标注在对应时间段上，是核对识别结果最直观的工具：

🛠️ 右上角 Menu：Settings、System、Logs、Tools

右上角menu按钮是管理员入口（菜单项由 avian/api/menu.php 生成），包含四个页面：

• Settings：主题（跟随系统 / 浅色 / 深色）、站点名称、Bird bundle 画风、BirdWeather 分享开关、Drive 夜间备份、本地管理密码
• System：服务启停等系统操作
• Logs：查看运行日志
• Tools：Pull latest（一键更新）、下载检测 CSV / 录音归档、Export bundle（导出自己的插画集供他人使用）

如果启用了本地管理密码，未解锁时这里只会显示一个密码框，而 Collage、Stats、Atlas 与明信片等公开页面不受影响。

🎓 Educators 模式（可选）：一堂开在教室外的鸟课

老师、自然课社团可以启用 Educators 模式（SSH 执行sudo /usr/local/sbin/avian-educators enable），菜单里会多出一个Educators页面：

1. 给一次"聆听时段"起个名字（如Biology 2）并启动
2. 期间 Collage、Stats、Atlas 自动只统计这节课听到的鸟
3. 可随时 Pause / Resume / Stop；Live audio行展开后可直接听麦克风原始音频并看声谱图
4. 课程结束后自动存为"saved view"，支持文件夹归档、生成只读分享链接，还能开启Display mode把整页投到教室大屏上

完整的教学流程与隐私细节见 docs/educators.md。

📦 小结与延伸资料

10 分钟回顾：左上角换时间窗口 → 底部三标签逛 Collage / Stats / Atlas → 右上角 menu 管设置。三个界面共享同一份检测数据，只是三种"读法"：画面、数据、清单。

想继续深入，推荐这几个入口：

• 安装与硬件清单：README.md（硬件 BOM、SD 卡刷写、一键安装脚本，另可git clone https://gitcode.com/gh_mirrors/avi/AvianVisitors获取全部源码）
• 教育模式指南：docs/educators.md
• 墨水分屏墙装：拼贴还能装进 e-ink 相框挂在窗边，见 frame/README.md
• 局域网外访问 / Home Assistant / MQTT 推送：avian/forwarding/README.md

窗外的小鸟不知道你在看它们，但 AvianVisitors 已经替你把每一声鸟鸣，都画成了留得住的风景。🐦