开发者用本地 Gemma 做宿舍球场仲裁 AI

这是为以下活动提交的作品Hacktoberfest 周末挑战赛：为朋友而构建

我构建了什么

🏸 我的宿舍室友们把羽毛球报名表当成了死亡笔记，所以我构建了一个 AI 独裁者来阻止这场血雨腥风

如果你曾踏入过大学宿舍，你就会知道羽毛球场的那张实体报名表与其说是日程表，不如说是一部心理惊悚片。有人写下“晚上 7 点 - 我，”另一个人气势汹汹地把它划掉，涂上三层修正液，于是一场随意的对打瞬间演变成一场全面的走廊地盘争夺战。

我这一层楼正陷入彻底的无政府状态。有人在伪造签名，有人在藏笔，还有人为了一个场地时段差点动手。纸笔辜负了我们。民主辜负了我们。

所以，与其被石墨球拍不小心砸到脸，我构建了Hostel Nexus——一个铁面无私、由 AI 驱动的宿舍管理员，把绝对的、毫无感情的司法暴政带回校园生活。

---

Hostel Nexus 实际做什么：

• 校园运动的最高法院：与其让室友们在午夜时分在走廊里互相尖叫，他们直接把戏剧性的申诉提交给一个由本地Gemma驱动的 AI 管理员。
• 零戏剧性裁决：AI 不在乎你的室友“先占了位”，也不在乎他们昨天跟你分享了零食。它权衡数据，下达具有约束力的最终判决，并永久终结这场争论。
• 防末日级可靠性：即使云端部署的无服务器函数试图耍脾气，我们优雅的离线回退逻辑也确保 AI 管理员像冷酷无情的数字霸主一样持续下达判决。

演示 -

视频演示 -

代码

我如何构建它

使用的开源 AI 与架构：
开源权重模型：Gemma（通过 Ollama 在本地运行）。

推理与执行：通过 Ollama 进行本地推理，让学生和宿舍管理员可以直接在本地硬件上查询模型，而无需承担云端 token 成本或延迟。

框架与技术栈：使用 Next.js 前端和后端 API 路由构建，部署在 Vercel 上，并搭配自定义设计的优雅降级架构。

项目如何围绕它构建：
Hostel Nexus 完全围绕 Gemma 作为公正的 AI 宿管来构建。

自主争议仲裁：不再依赖会导致走廊争吵和羽毛球场时段被划掉的手动登记表，学生将他们的日程冲突直接输入到 Web 应用中。

面向校园生活的本地智能：该应用利用 Gemma 分析时间限制、审查相互冲突的诉求，并输出严格、不带感情且具有约束力的裁决。

稳健的生产环境降级方案：由于本地模型（Ollama）运行在 localhost:11434 上，像 Vercel 无服务器函数这样的云端托管环境无法直接查询本地端点。为解决这个问题，我们构建了一个智能降级层，在离线时无缝切换到预置的演示状态，确保 AI 宿管的判断始终可供评估而不会崩溃。

为什么开放创新很重要？

为什么开放创新对 Hostel Nexus 很重要：
开放创新和像 Gemma 这样的开源权重模型是 Hostel Nexus 的绝对支柱。没有它们，使用闭源的企业 API 构建一个去中心化、学生优先的校园仲裁者几乎是不可能的。

以下是开放式创新所能实现、而封闭 API 根本无法做到的事情：

学生预算零成本：闭源 API（如 OpenAI 或 Anthropic）按 token 收费。在大学生宿舍环境中，学生们本就囊中羞涩，每当两个室友为羽毛球场地名额争吵时都要收取订阅费或按查询收费，这完全不可行。开放式创新让 AI 100% 免费，并可在学生自己的硬件上本地运行。

极致的隐私与数据主权：将敏感的校园日程、房间号和个人学生纠纷发送到第三方闭源服务器会引发重大隐私问题。在本地运行 Gemma 意味着学生数据留在它该在的地方——处于本地控制之下，不会被企业巨头收割。

零速率限制与供应商锁定：闭源 API 带有严格的速率限制、突然的定价变化和不可预测的停机。通过 Ollama 利用开源权重模型，我们拥有完全的自由来定制 AI Warden 严格、公正的人设，在黑客松冲刺期间快速迭代，并在不触及企业付费墙或 API 封锁的情况下进行实验。

借助 AI 协作构建（最佳使用 Entire）
为了在这次黑客松期间以创纪录的速度构建 Hostel Nexus，我并非独自闭门编码——我与一个 AI 智能体作为副驾驶紧密协作，从零开始架构、调试并完善整个应用。

以下是我们与智能体的会话以及交互式问题解决如何塑造了最终项目：

解决云端与本地两难困境：在将我们的 Next.js 前端部署到 Vercel 时，我们撞上了一堵重大工程墙：云端无服务器函数无法查询本地机器端点（Ollama/Gemma 的 localhost:11434）。通过与智能体的会话，我们设计并实现了一种优雅降级架构，可自动检测无法访问的端点并切换到预置的演示状态，确保评委看到零停机。

打磨叙事与语气：智能体帮助我们将项目定位从枯燥乏味的技术功能列表，转变为以人为中心的故事，聚焦于现实世界中大学宿舍室友因羽毛球场地预订而产生的纠纷。

简化密钥处理：我们使用智能体辅助调试会话，将敏感的 API 凭据——例如我们的 ElevenLabs 语音合成密钥——与源代码干净地分离，并通过 Vercel 环境变量妥善保护它们。

通过依赖透明、迭代式的智能体协作，我们将一个复杂的离线到云端架构挑战，变成了一个顺畅、可投入生产的提交作品！

奖项类别

最佳 Gemma 使用奖——因为你的应用完全围绕本地 Gemma 构建，通过 Ollama 充当公正的 AI Warden。

最佳 Entire 使用奖——因为你利用透明的智能体会话和 AI 协作工作流来架构、构建和调试该应用。