AvianVisitors 是一款架在树莓派上的"窗外鸟类实时拼贴"项目：麦克风 + BirdNET 识别鸟鸣，检测到的每种鸟都会以插画形式出现在你的网页拼贴墙上。装好它只是开始，真正日常使用靠的是右上角的menu 管理面板——Settings 站点设置、System 系统状态、Logs 日志、Tools 工具四个页面，几乎涵盖了观鸟站的方方面面。本文带你 10 分钟走完整个管理面板，从修改站点名称、调整识别灵敏度，到导出全部数据、开启云端备份，一篇搞定。

打开管理面板：右上角的 menu 按钮

观鸟站主页右上角有一枚menu按钮（源码见 avian/frontend/index.html），点击后展开侧边抽屉，列出settings / system / logs / tools四个入口，开启 Educators 模式后还会出现第五个入口。菜单项由 avian/api/menu.php 动态生成，其中 settings 条目上的小圆点表示"有待升级的即时抠图"。

两个安全细节值得先知道：

• 管理员密码：在 Settings 里可为本地管理功能开启密码保护。开启后，公开鸟页（拼贴、统计、图鉴）仍然无需登录，但实时音频会关闭。
• 锁定按钮：抽屉底部有lock admin controls，可随时锁住管理会话；系统还会做空闲自动锁定。

万一忘记密码，通过 SSH 执行sudo /usr/local/sbin/avian-admin-control password-reset即可私密地重置密码。

Settings：站点设置核心页

Settings 是管理面板的心脏，所有改动即时生效并写入鸟站配置（前端渲染逻辑见 avian/frontend/apt.js，后端接口为 avian/api/config.php）。整页分四个区域：

1️⃣ 外观与名称

2️⃣ 识别调优（最重要的四个滑杆）

• Confidence threshold（置信度阈值）：低于该分数的鸣声不会记录，默认 0.7；鸟声混杂可往上调，宁缺毋滥。
• Range filter：本周该物种出现在本地的最低可能性，过滤掉"不可能出现在你这儿"的物种。
• Sensitivity：分类器输出曲线的斜率，越大越"激进"。
• Chunk overlap：每段音频重叠重分析的秒数，调大可减少漏检。
• Reset at midnight：时间窗口是否每天零点自动归零。

3️⃣ 位置与 API Key

点击坐标行可在地图选点，保存经纬度后，"刷新本地鸟"功能只下载你所在地区全年会出现的鸟，而不是全量插画。这里还可以填入Gemini API key（按需生成插画）和eBird API key（按地区过滤物种）。

鸟站默认使用内置的日式木版画插画包（覆盖北美西部）。想换风格就在 Settings →Bird bundle里选择，或浏览官方 bundle 目录：

4️⃣ 数据留存

这一区集中管理"数据去哪儿了"：本地管理员密码、BirdWeather 共享、Nightly Drive 备份、是否保留全部录音、磁盘满时keep（停止录制）还是purge（自动清除）。

Nightly Drive backup提供可选的 Google Drive 夜间备份；注意：验证过至少一次归档任务成功后，才会开放本地数据清理选项。

System：一张仪表盘看清鸟站健康

System 页每 6 秒自动刷新（接口 avian/api/birdnet-status.php），顶部是 8 张状态卡片：

• recording pipeline：录制/分析/日志三大服务是否全部存活；
• newest live audio：最新音频块距今多久（超过 10 分钟亮黄警）；
• birds.db updated：识别数据库多久没更新；
• uptime / cpu temp / memory / disk：系统运行时长、CPU 温度、内存与录音盘占用；
• audio device：正确识别 USB 麦克风，没插麦克风时会明确提示而不是误报 HDMI。

下方是完整的服务表（状态 / 是否开机自启 / 启动时间），带restart按钮的服务可直接一键重启；再往下展示birdnet.conf当前值和最近的 journal 日志。判断"鸟站是不是哑了"，看这里最快。

Logs：免 SSH 查看服务日志

Logs 页把常用服务的journalctl搬进了浏览器，4 秒自动刷新：

• unit 下拉：birdnet_recording、birdnet_analysis、birdnet_log、birdnet_stats、spectrogram_viewer、livestream、icecast2、caddy以及当前系统的 php-fpm；
• lines 输入：20～500 行可调，默认 120。

排查"为什么刚才那阵鸟叫没记录"时，切到birdnet_analysis拉 200 行，通常直接能看到原因。

Tools：服务重启、更新与数据导出

Tools 页是运维工具箱，三组卡片（实现见 renderAdminTools）：

① services——六个服务卡片：recording（采集音频）、analysis（跑模型）、log（写库）、spectrogram（旧版频谱视图）、livestream（直播音源）、icecast（给浏览器推流）。整张卡片就是按钮，点击确认后直接重启该服务，徽标实时显示 running / stopped / error。

② update——

• pull latest：拉取最新代码（对应./scripts/update_birdnet.sh），保留自定义插画与凭据；
• reinstall services：刷新软链与 systemd 单元文件。

③ your data——观鸟站的数据出口：

• Export bundle：审阅本地插画后打包下载，用于分享你自己的插画集（站点绝不会自动上传）；
• detections：全部检测记录的 CSV（日期、物种、置信度、文件）；
• recordings：按日期和物种打包的全部录音 tar，注意可能有好几个 GB。

可选第五页：Educators 模式

在 SSH 中执行sudo /usr/local/sbin/avian-educators enable后，菜单会多出educators入口：管理课堂"听声时段"的启动、暂停与归档，配合 Display 模式把观鸟站变成教室展示屏。完整工作流见 docs/educators.md。

常见问题速查

Q：menu 点了提示需要密码 / 状态异常？A：说明管理员凭据缺失或失效，SSH 执行sudo /usr/local/sbin/avian-admin-control password-reset重置后回到 Settings。

Q：改完设置要重启吗？A：不需要，Settings 的滑杆、开关和站点名称保存即时生效。

Q：如何确认麦克风没掉线？A：看 System 页audio device卡片与newest live audio时间，前者没识别到 USB 设备会直接标黄。

Q：数据怎么迁走？A：Tools → your data，detections 导 CSV、recordings 导录音包，两步带走全部观测数据。

一个 menu 按钮，四个页面，外加一个可选的 Educators——这就是 AvianVisitors 管理面板的全部。收藏这一页，下次调参、排障、导出数据时照着做就行。