# 急先锋南院新生答疑站

这是一个适合先过渡使用的校园答疑网页。普通内容页仍是静态的；校园 AI 使用一个只在你电脑上运行的小服务，所以 API Key 不会出现在网页里。它不会收集新生的姓名、学号或手机号；网页外的微信沟通由对方自愿发起。

## 怎么打开

不使用 AI 时，直接双击项目文件夹里的 `index.html`，浏览器就能看到网页。

## 电脑本机测试校园 AI（现在用这个）

1. 保持密钥文件在 `/Users/air/Desktop/未命名文件夹/密钥.txt`。文件中只能有一行 API Key，千万不要把密钥发给别人或放进网页代码。
2. 双击项目文件夹里的 `启动本地AI测试.command`。
3. 浏览器会自动打开 `http://localhost:8787`。点击右下角“问校园 AI”，即可像聊天一样测试。
4. 测试结束后，关闭启动时出现的终端窗口，AI 服务就会停止。

> 不要在 `file://` 方式打开的网页里测试 AI；那种打开方式只能看静态页面，不能安全调用 API。

### AI 的工作方式

- 浏览器把问题发给你电脑上的本机服务；本机服务读取桌面的密钥，再调用通义千问。密钥不会进入 HTML、JavaScript 或访客浏览器。
- 当前知识库位于 `data/knowledge-base.js`，已放入本次整理的双人实测内容和“未核验则转人工”的规则。
- 单个访问者 30 分钟内默认最多提问 25 次；超过后会提示找学长答疑。这个数字可在 `server.js` 中后续调整。
- 现在只能在你的电脑本机测试。要让新生扫码也能使用，需要后续把本机服务部署到带后端的服务器；不能只上传到静态网页托管。

## 最重要：发布前替换这 4 类内容

1. **示例答案**：打开对应 .html 文件，搜索“示例”或“请替换”，把宿舍、饭堂、快递站、报到时间等改成已核实的真实信息。
2. **微信二维码**：服务器更新到管理页版本后，访问 `http://你的网址/admin.html`，登录后直接上传真实二维码；不需要再修改代码。
3. **群聊信息**：管理页可上传 4 个群二维码及修改入群提示。不要公开未经群主许可的群码。
4. **一次免费代领规则**：在 contact.html 中把服务范围、快递站、时间和重量限制写成你确实能做到的规则。
5. **图文照片**：管理页可上传四个分类页各预留的 3 张图片。优先使用自己拍摄或已获得授权的图片。
6. **AI 知识库**：在 `data/knowledge-base.js` 里仿照已有条目添加问题关键词、答案、资料等级和核验日期。生活经验保留“双人实测，仅供参考”；校历、收费、校规等没有当期官方来源时不要写成确定事实。

## 安全与合规

- 本站已经写明“非学校官方平台”，请不要加入校徽、官方名称、官方地图或暗示官方背书的文案。
- 不要收集身份证号、银行卡号、取件码、密码等敏感信息。
- 不要承诺无法保证的福利；代领不接贵重物品、冷链件、到付件和需要本人验收的快递。
- 所有学校通知、缴费、宿舍安排等信息，均提示新生以学校正式通知为准。

## 文件说明

- index.html：首页
- life.html：住宿、饭堂、快递
- guide.html：报到流程、校园地图
- community.html：社群与安全提示
- nanning.html：南宁打卡灵感
- contact.html：加学长微信、福利与代领规则
- assets/styles.css：所有样式
- assets/app.js：弹出的校园 AI 聊天窗口
- admin.html：密码保护的内容管理页（不在前台导航展示）
- assets/admin.js：管理页的上传与保存逻辑
- data/knowledge-base.js：校园 AI 可使用的知识库（公开信息，不含密钥）
- server.js：保护 API Key 的本机 AI 服务
- 启动本地AI测试.command：双击启动本机测试

## 后续可以加什么

以后有真实资料后，可以增加地图导航按钮、在线问答表单、后台编辑、公告栏和活动报名。第一版保持静态，最容易维护。